OrgST-Microelectronics
/
STM32CubeF7
mirror of https://github.com/STMicroelectronics/STM32CubeF7.git
1
0
Fork 0
Code Issues Releases Wiki Activity
STM32CubeF7/Drivers/BSP/STM32756G_EVAL/stm32756g_eval_io.c

310 lines
9.2 KiB
C
Raw Blame History

/**
******************************************************************************
* @file stm32756g_eval_io.c
* @author MCD Application Team
* @brief This file provides a set of functions needed to manage the IO pins
* on STM32756G-EVAL and STM32746G-EVAL evaluation board.
*
******************************************************************************
* @attention
*
* Copyright (c) 2016 STMicroelectronics.
* All rights reserved.
*
* This software is licensed under terms that can be found in the LICENSE file
* in the root directory of this software component.
* If no LICENSE file comes with this software, it is provided AS-IS.
*
******************************************************************************
@verbatim
How To use this driver:
-----------------------
- This driver is used to drive the IO module of the STM32756G-EVAL evaluation
board.
- The MFXSTM32L152 IO expander device component driver must be included with this
driver in order to run the IO functionalities commanded by the IO expander (MFX)
device mounted on the evaluation board.
Driver description:
-------------------
+ Initialization steps:
o Initialize the IO module using the BSP_IO_Init() function. This
function includes the MSP layer hardware resources initialization and the
communication layer configuration to start the IO functionalities use.
+ IO functionalities use
o The IO pin mode is configured when calling the function BSP_IO_ConfigPin(), you
must specify the desired IO mode by choosing the "IO_ModeTypedef" parameter
predefined value.
o If an IO pin is used in interrupt mode, the function BSP_IO_ITGetStatus() is
needed to get the interrupt status. To clear the IT pending bits, you should
call the function BSP_IO_ITClear() with specifying the IO pending bit to clear.
o The IT is handled using the corresponding external interrupt IRQ handler,
the user IT callback treatment is implemented on the same external interrupt
callback.
o The IRQ_OUT pin (common for all functionalities: JOY, SD, LEDs, etc) can be
configured using the function BSP_IO_ConfigIrqOutPin()
o To get/set an IO pin combination state you can use the functions
BSP_IO_ReadPin()/BSP_IO_WritePin() or the function BSP_IO_TogglePin() to toggle the pin
state.
@endverbatim
******************************************************************************
*/
/* Dependencies
- stm32756g_eval.h
- mfxstm32l152.c
EndDependencies */
/* Includes ------------------------------------------------------------------*/
#include "stm32756g_eval_io.h"
/** @addtogroup BSP
* @{
*/
/** @addtogroup STM32756G_EVAL
* @{
*/
/** @defgroup STM32756G_EVAL_IO STM32756G_EVAL IO
* @{
*/
/** @defgroup STM32756G_EVAL_IO_Private_Types_Definitions IO Private Types Definitions
* @{
*/
/**
* @}
*/
/** @defgroup STM32756G_EVAL_IO_Private_Defines IO Private Defines
* @{
*/
/**
* @}
*/
/** @defgroup STM32756G_EVAL_IO_Private_Macros IO Private Macros
* @{
*/
/**
* @}
*/
/** @defgroup STM32756G_EVAL_IO_Private_Variables IO Private Variables
* @{
*/
static IO_DrvTypeDef *IoDrv = NULL;
static uint8_t mfxstm32l152Identifier;
/**
* @}
*/
/** @defgroup STM32756G_EVAL_IO_Private_Functions_Prototypes IO Private Functions Prototypes
* @{
*/
/**
* @}
*/
/** @defgroup STM32756G_EVAL_IO_Private_Functions IO Private Functions
* @{
*/
/**
* @brief Initializes and configures the IO functionalities and configures all
* necessary hardware resources (MFX, ...).
* @note BSP_IO_Init() is using HAL_Delay() function to ensure that MFXSTM32L152
* IO Expander is correctly reset. HAL_Delay() function provides accurate
* delay (in milliseconds) based on variable incremented in SysTick ISR.
* This implies that if BSP_IO_Init() is called from a peripheral ISR process,
* then the SysTick interrupt must have higher priority (numerically lower)
* than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
* @retval IO_OK if all initializations are OK. Other value if error.
*/
uint8_t BSP_IO_Init(void)
{
uint8_t ret = IO_OK;
if (IoDrv == NULL) /* Checks if MFX initialization never done */
{
/* Read ID and verify the MFX is ready */
mfxstm32l152Identifier = mfxstm32l152_io_drv.ReadID(IO_I2C_ADDRESS);
if((mfxstm32l152Identifier == MFXSTM32L152_ID_1) || (mfxstm32l152Identifier == MFXSTM32L152_ID_2))
{
/* Initialize the IO driver structure */
IoDrv = &mfxstm32l152_io_drv;
/* Initialize MFX */
IoDrv->Init(IO_I2C_ADDRESS);
IoDrv->Start(IO_I2C_ADDRESS, IO_PIN_ALL);
}
else
{
ret = IO_ERROR;
}
}
else
{
/* MFX initialization already done : do nothing */
}
return ret;
}
/**
* @brief DeInit allows Mfx Initialization to be executed again
* @note BSP_IO_Init() has no effect if the IoDrv is already initialized
* BSP_IO_DeInit() allows to erase the pointer such to allow init to be effective
* @retval IO_OK
*/
uint8_t BSP_IO_DeInit(void)
{
IoDrv = NULL;
return IO_OK;
}
/**
* @brief Gets the selected pins IT status.
* @param IoPin: Selected pins to check the status.
* This parameter can be any combination of the IO pins.
* @retval IO_OK if read status OK. Other value if error.
*/
uint32_t BSP_IO_ITGetStatus(uint32_t IoPin)
{
/* Return the IO Pin IT status */
return (IoDrv->ITStatus(IO_I2C_ADDRESS, IoPin));
}
/**
* @brief Clears all the IO IT pending bits.
* @retval None
*/
void BSP_IO_ITClear(void)
{
/* Clear all IO IT pending bits */
IoDrv->ClearIT(IO_I2C_ADDRESS, MFXSTM32L152_GPIO_PINS_ALL);
}
/**
* @brief Configures the IO pin(s) according to IO mode structure value.
* @param IoPin: IO pin(s) to be configured.
* This parameter can be one of the following values:
* @arg MFXSTM32L152_GPIO_PIN_x: where x can be from 0 to 23.
* @param IoMode: IO pin mode to configure
* This parameter can be one of the following values:
* @arg IO_MODE_INPUT
* @arg IO_MODE_OUTPUT
* @arg IO_MODE_IT_RISING_EDGE
* @arg IO_MODE_IT_FALLING_EDGE
* @arg IO_MODE_IT_LOW_LEVEL
* @arg IO_MODE_IT_HIGH_LEVEL
* @arg IO_MODE_ANALOG
* @arg IO_MODE_OFF
* @arg IO_MODE_INPUT_PU,
* @arg IO_MODE_INPUT_PD,
* @arg IO_MODE_OUTPUT_OD,
* @arg IO_MODE_OUTPUT_OD_PU,
* @arg IO_MODE_OUTPUT_OD_PD,
* @arg IO_MODE_OUTPUT_PP,
* @arg IO_MODE_OUTPUT_PP_PU,
* @arg IO_MODE_OUTPUT_PP_PD,
* @arg IO_MODE_IT_RISING_EDGE_PU
* @arg IO_MODE_IT_FALLING_EDGE_PU
* @arg IO_MODE_IT_LOW_LEVEL_PU
* @arg IO_MODE_IT_HIGH_LEVEL_PU
* @arg IO_MODE_IT_RISING_EDGE_PD
* @arg IO_MODE_IT_FALLING_EDGE_PD
* @arg IO_MODE_IT_LOW_LEVEL_PD
* @arg IO_MODE_IT_HIGH_LEVEL_PD
* @retval IO_OK if all initializations are OK. Other value if error.
*/
uint8_t BSP_IO_ConfigPin(uint32_t IoPin, IO_ModeTypedef IoMode)
{
/* Configure the selected IO pin(s) mode */
IoDrv->Config(IO_I2C_ADDRESS, IoPin, IoMode);
return IO_OK;
}
/**
* @brief Sets the IRQ_OUT pin polarity and type
* @param IoIrqOutPinPolarity: High/Low
* @param IoIrqOutPinType: OpenDrain/PushPull
* @retval OK
*/
uint8_t BSP_IO_ConfigIrqOutPin(uint8_t IoIrqOutPinPolarity, uint8_t IoIrqOutPinType)
{
if((mfxstm32l152Identifier == MFXSTM32L152_ID_1) || (mfxstm32l152Identifier == MFXSTM32L152_ID_2))
{
/* Initialize the IO driver structure */
mfxstm32l152_SetIrqOutPinPolarity(IO_I2C_ADDRESS, IoIrqOutPinPolarity);
mfxstm32l152_SetIrqOutPinType(IO_I2C_ADDRESS, IoIrqOutPinType);
}
return IO_OK;
}
/**
* @brief Sets the selected pins state.
* @param IoPin: Selected pins to write.
* This parameter can be any combination of the IO pins.
* @param PinState: New pins state to write
* @retval None
*/
void BSP_IO_WritePin(uint32_t IoPin, BSP_IO_PinStateTypeDef PinState)
{
/* Set the Pin state */
IoDrv->WritePin(IO_I2C_ADDRESS, IoPin, PinState);
}
/**
* @brief Gets the selected pins current state.
* @param IoPin: Selected pins to read.
* This parameter can be any combination of the IO pins.
* @retval The current pins state
*/
uint32_t BSP_IO_ReadPin(uint32_t IoPin)
{
return(IoDrv->ReadPin(IO_I2C_ADDRESS, IoPin));
}
/**
* @brief Toggles the selected pins state.
* @param IoPin: Selected pins to toggle.
* This parameter can be any combination of the IO pins.
* @note This function is only used to toggle one pin in the same time
* @retval None
*/
void BSP_IO_TogglePin(uint32_t IoPin)
{
/* Toggle the current pin state */
if(IoDrv->ReadPin(IO_I2C_ADDRESS, IoPin) != 0) /* Set */
{
IoDrv->WritePin(IO_I2C_ADDRESS, IoPin, 0); /* Reset */
}
else
{
IoDrv->WritePin(IO_I2C_ADDRESS, IoPin, 1); /* Set */
}
}
/**
* @}
*/
/**
* @}
*/
/**
* @}
*/
/**
* @}
*/
Reference in New Issue View Git Blame Copy Permalink