STM32L4R9I_EVAL BSP User Manual
|
stm32l4r9i_eval_io.c
Go to the documentation of this file.
00001 /** 00002 ****************************************************************************** 00003 * @file stm32l4r9i_eval_io.c 00004 * @author MCD Application Team 00005 * @brief This file provides a set of functions needed to manage the IO pins 00006 * on STM32L4R9I_EVAL evaluation board. 00007 ****************************************************************************** 00008 * @attention 00009 * 00010 * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2> 00011 * 00012 * Redistribution and use in source and binary forms, with or without modification, 00013 * are permitted provided that the following conditions are met: 00014 * 1. Redistributions of source code must retain the above copyright notice, 00015 * this list of conditions and the following disclaimer. 00016 * 2. Redistributions in binary form must reproduce the above copyright notice, 00017 * this list of conditions and the following disclaimer in the documentation 00018 * and/or other materials provided with the distribution. 00019 * 3. Neither the name of STMicroelectronics nor the names of its contributors 00020 * may be used to endorse or promote products derived from this software 00021 * without specific prior written permission. 00022 * 00023 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00024 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00025 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00026 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 00027 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 00028 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 00029 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 00030 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00031 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00032 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00033 * 00034 ****************************************************************************** 00035 */ 00036 00037 /* File Info : ----------------------------------------------------------------- 00038 User NOTES 00039 1. How To use this driver: 00040 -------------------------- 00041 - This driver is used to drive the IO module of the STM32L4R9I_EVAL evaluation 00042 board. 00043 - The MFXSTM32L152 IO expander device component driver must be included with this 00044 driver in order to run the IO functionalities commanded by the IO expander 00045 device mounted on the evaluation board. 00046 00047 2. Driver description: 00048 --------------------- 00049 + Initialization steps: 00050 o Initialize the IO module using the BSP_IO_Init() function. This 00051 function includes the MSP layer hardware resources initialization and the 00052 communication layer configuration to start the IO functionalities use. 00053 00054 + IO functionalities use 00055 o The IO pin mode is configured when calling the function BSP_IO_ConfigPin(), you 00056 must specify the desired IO mode by choosing the "IO_ModeTypedef" parameter 00057 predefined value. 00058 o If an IO pin is used in interrupt mode, the function BSP_IO_ITGetStatus() is 00059 needed to get the interrupt status. To clear the IT pending bits, you should 00060 call the function BSP_IO_ITClear() with specifying the IO pending bit to clear. 00061 o The IT is handled using the corresponding external interrupt IRQ handler, 00062 the user IT callback treatment is implemented on the same external interrupt 00063 callback. 00064 o To get/set an IO pin combination state you can use the functions 00065 BSP_IO_ReadPin()/BSP_IO_WritePin() or the function BSP_IO_TogglePin() to toggle the pin 00066 state. 00067 00068 ------------------------------------------------------------------------------*/ 00069 00070 /* Includes ------------------------------------------------------------------*/ 00071 #include "stm32l4r9i_eval_io.h" 00072 00073 /** @addtogroup BSP 00074 * @{ 00075 */ 00076 00077 /** @addtogroup STM32L4R9I_EVAL 00078 * @{ 00079 */ 00080 00081 /** @defgroup STM32L4R9I_EVAL_IO STM32L4R9I_EVAL IO 00082 * @{ 00083 */ 00084 00085 /* Private constants ---------------------------------------------------------*/ 00086 /* Private macros ------------------------------------------------------------*/ 00087 /* Private variables ---------------------------------------------------------*/ 00088 00089 /** @defgroup STM32L4R9I_EVAL_IO_Private_Variables Private Variables 00090 * @{ 00091 */ 00092 static IO_DrvTypeDef *io_driver; 00093 00094 /** 00095 * @} 00096 */ 00097 00098 /* Private function prototypes -----------------------------------------------*/ 00099 /* Exported functions --------------------------------------------------------*/ 00100 00101 /** @addtogroup STM32L4R9I_EVAL_IO_Exported_Functions 00102 * @{ 00103 */ 00104 00105 /** 00106 * @brief Initialize and configure the IO functionalities and configures all 00107 * necessary hardware resources (GPIOs, clocks..). 00108 * @note BSP_IO_Init() is using HAL_Delay() function to ensure that stmpe811 00109 * IO Expander is correctly reset. HAL_Delay() function provides accurate 00110 * delay (in milliseconds) based on variable incremented in SysTick ISR. 00111 * This implies that if BSP_IO_Init() is called from a peripheral ISR process, 00112 * then the SysTick interrupt must have higher priority (numerically lower) 00113 * than the peripheral interrupt. Otherwise the caller ISR process will be blocked. 00114 * @retval IO_OK: if all initializations are OK. Other value if error. 00115 */ 00116 uint8_t BSP_IO_Init(void) 00117 { 00118 uint8_t ret = IO_OK; 00119 uint8_t mfxstm32l152_id = 0; 00120 00121 if (io_driver == NULL) /* Checks if MFX initialization has been already done */ 00122 { 00123 mfxstm32l152_idd_drv.WakeUp(IO_I2C_ADDRESS); 00124 00125 HAL_Delay(10); 00126 00127 /* Read ID and verify the IO expander is ready */ 00128 mfxstm32l152_id = mfxstm32l152_io_drv.ReadID(IO_I2C_ADDRESS); 00129 00130 if((mfxstm32l152_id == MFXSTM32L152_ID_1) || (mfxstm32l152_id == MFXSTM32L152_ID_2)) 00131 { 00132 /* Initialize the MFX */ 00133 io_driver = &mfxstm32l152_io_drv; 00134 00135 /* Initialize the MFX IO driver structure */ 00136 if(io_driver->Init != NULL) 00137 { 00138 io_driver->Init(IO_I2C_ADDRESS); 00139 io_driver->Start(IO_I2C_ADDRESS, IO_PIN_ALL); 00140 } 00141 else 00142 { 00143 ret = IO_ERROR; 00144 } 00145 } 00146 else 00147 { 00148 ret = IO_ERROR; 00149 } 00150 } 00151 else 00152 { 00153 /* MFX initialization already done : reinit I2C if needed */ 00154 MFX_IO_Init(); 00155 } 00156 00157 return ret; 00158 } 00159 00160 /** 00161 * @brief DeInitialize the IO to allow Mfx Initialization to be executed again 00162 * @note BSP_IO_Init() has no effect if the io_driver is already initialized 00163 * BSP_IO_DeInit() allows to erase the pointer such to allow init to be effective 00164 * @retval IO_OK 00165 */ 00166 uint8_t BSP_IO_DeInit(void) 00167 { 00168 if (io_driver != NULL) 00169 { 00170 if(io_driver->Reset != NULL) 00171 { 00172 io_driver->Reset(IO_I2C_ADDRESS); 00173 } 00174 00175 io_driver = NULL; 00176 } 00177 return IO_OK; 00178 } 00179 00180 /** 00181 * @brief Get the selected pins IT status. 00182 * @param IO_Pin: Selected pin(s) to check the status. 00183 * This parameter can be any combination of the IO pins. 00184 * @retval Status of the checked IO pin(s). 00185 */ 00186 uint32_t BSP_IO_ITGetStatus(uint32_t IO_Pin) 00187 { 00188 /* Return the IO Pin IT status */ 00189 return (io_driver->ITStatus(IO_I2C_ADDRESS, IO_Pin)); 00190 } 00191 00192 /** 00193 * @brief Clear the selected IO IT pending bit. 00194 * @param IO_Pin: Selected pin(s) to clear the status. 00195 * This parameter can be any combination of the IO pins. 00196 * @retval None 00197 */ 00198 void BSP_IO_ITClear(uint32_t IO_Pin) 00199 { 00200 /* Clear the selected IO IT pending bits */ 00201 io_driver->ClearIT(IO_I2C_ADDRESS, IO_Pin); 00202 } 00203 00204 /** 00205 * @brief Configure the IO pin(s) according to IO mode structure value. 00206 * @param IO_Pin: Output IO pin(s) to be set or reset. 00207 * This parameter can be any combination of the IO pin(s). 00208 * @param IO_Mode: IO pin mode to configure 00209 * This parameter can be one of the following values: 00210 * @arg IO_MODE_INPUT 00211 * @arg IO_MODE_OUTPUT 00212 * @arg IO_MODE_IT_RISING_EDGE 00213 * @arg IO_MODE_IT_FALLING_EDGE 00214 * @arg IO_MODE_IT_LOW_LEVEL 00215 * @arg IO_MODE_IT_HIGH_LEVEL 00216 * @retval IO_OK: if all initializations are OK. Other value if error. 00217 */ 00218 uint8_t BSP_IO_ConfigPin(uint32_t IO_Pin, IO_ModeTypedef IO_Mode) 00219 { 00220 /* Configure the selected IO pin(s) mode */ 00221 io_driver->Config(IO_I2C_ADDRESS, IO_Pin, IO_Mode); 00222 00223 return IO_OK; 00224 } 00225 00226 /** 00227 * @brief Set the selected IO pin(s) state. 00228 * @param IO_Pin: Selected IO pin(s) to write. 00229 * This parameter can be any combination of the IO pin(s). 00230 * @param PinState: New pin state to write 00231 * @retval None 00232 */ 00233 void BSP_IO_WritePin(uint32_t IO_Pin, uint8_t PinState) 00234 { 00235 /* Set the IO pin(s) state */ 00236 io_driver->WritePin(IO_I2C_ADDRESS, IO_Pin, PinState); 00237 } 00238 00239 /** 00240 * @brief Get the selected IO pin(s) current state. 00241 * @param IO_Pin: Selected pin(s) to read. 00242 * This parameter can be any combination of the IO pin(s). 00243 * @retval The current pins state 00244 */ 00245 uint32_t BSP_IO_ReadPin(uint32_t IO_Pin) 00246 { 00247 return(io_driver->ReadPin(IO_I2C_ADDRESS, IO_Pin)); 00248 } 00249 00250 /** 00251 * @brief Toggle the selected IO pin(s) state 00252 * @param IO_Pin: Selected IO pin(s) to toggle. 00253 * This parameter can be any combination of the IO pin(s). 00254 * @retval None 00255 */ 00256 void BSP_IO_TogglePin(uint32_t IO_Pin) 00257 { 00258 /* Toggle the IO selected pin(s) state */ 00259 if(io_driver->ReadPin(IO_I2C_ADDRESS, IO_Pin) != 0) /* Set */ 00260 { 00261 io_driver->WritePin(IO_I2C_ADDRESS, IO_Pin, 0); /* Reset */ 00262 } 00263 else 00264 { 00265 io_driver->WritePin(IO_I2C_ADDRESS, IO_Pin, 1); /* Set */ 00266 } 00267 00268 } 00269 00270 /** 00271 * @} 00272 */ 00273 00274 /** 00275 * @} 00276 */ 00277 00278 /** 00279 * @} 00280 */ 00281 00282 /** 00283 * @} 00284 */ 00285 00286 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Generated on Thu Oct 12 2017 10:53:59 for STM32L4R9I_EVAL BSP User Manual by
![doxygen](doxygen.png)