|
STM32H735xx HAL User Manual
|
00001 /** 00002 ****************************************************************************** 00003 * @file stm32h7xx_hal_i2c.h 00004 * @author MCD Application Team 00005 * @brief Header file of I2C HAL module. 00006 ****************************************************************************** 00007 * @attention 00008 * 00009 * Copyright (c) 2017 STMicroelectronics. 00010 * All rights reserved. 00011 * 00012 * This software is licensed under terms that can be found in the LICENSE file 00013 * in the root directory of this software component. 00014 * If no LICENSE file comes with this software, it is provided AS-IS. 00015 * 00016 ****************************************************************************** 00017 */ 00018 00019 /* Define to prevent recursive inclusion -------------------------------------*/ 00020 #ifndef STM32H7xx_HAL_I2C_H 00021 #define STM32H7xx_HAL_I2C_H 00022 00023 #ifdef __cplusplus 00024 extern "C" { 00025 #endif 00026 00027 /* Includes ------------------------------------------------------------------*/ 00028 #include "stm32h7xx_hal_def.h" 00029 00030 /** @addtogroup STM32H7xx_HAL_Driver 00031 * @{ 00032 */ 00033 00034 /** @addtogroup I2C 00035 * @{ 00036 */ 00037 00038 /* Exported types ------------------------------------------------------------*/ 00039 /** @defgroup I2C_Exported_Types I2C Exported Types 00040 * @{ 00041 */ 00042 00043 /** @defgroup I2C_Configuration_Structure_definition I2C Configuration Structure definition 00044 * @brief I2C Configuration Structure definition 00045 * @{ 00046 */ 00047 typedef struct 00048 { 00049 uint32_t Timing; /*!< Specifies the I2C_TIMINGR_register value. 00050 This parameter calculated by referring to I2C initialization section 00051 in Reference manual */ 00052 00053 uint32_t OwnAddress1; /*!< Specifies the first device own address. 00054 This parameter can be a 7-bit or 10-bit address. */ 00055 00056 uint32_t AddressingMode; /*!< Specifies if 7-bit or 10-bit addressing mode is selected. 00057 This parameter can be a value of @ref I2C_ADDRESSING_MODE */ 00058 00059 uint32_t DualAddressMode; /*!< Specifies if dual addressing mode is selected. 00060 This parameter can be a value of @ref I2C_DUAL_ADDRESSING_MODE */ 00061 00062 uint32_t OwnAddress2; /*!< Specifies the second device own address if dual addressing mode is selected 00063 This parameter can be a 7-bit address. */ 00064 00065 uint32_t OwnAddress2Masks; /*!< Specifies the acknowledge mask address second device own address if dual addressing 00066 mode is selected. 00067 This parameter can be a value of @ref I2C_OWN_ADDRESS2_MASKS */ 00068 00069 uint32_t GeneralCallMode; /*!< Specifies if general call mode is selected. 00070 This parameter can be a value of @ref I2C_GENERAL_CALL_ADDRESSING_MODE */ 00071 00072 uint32_t NoStretchMode; /*!< Specifies if nostretch mode is selected. 00073 This parameter can be a value of @ref I2C_NOSTRETCH_MODE */ 00074 00075 } I2C_InitTypeDef; 00076 00077 /** 00078 * @} 00079 */ 00080 00081 /** @defgroup HAL_state_structure_definition HAL state structure definition 00082 * @brief HAL State structure definition 00083 * @note HAL I2C State value coding follow below described bitmap :\n 00084 * b7-b6 Error information\n 00085 * 00 : No Error\n 00086 * 01 : Abort (Abort user request on going)\n 00087 * 10 : Timeout\n 00088 * 11 : Error\n 00089 * b5 Peripheral initialization status\n 00090 * 0 : Reset (peripheral not initialized)\n 00091 * 1 : Init done (peripheral initialized and ready to use. HAL I2C Init function called)\n 00092 * b4 (not used)\n 00093 * x : Should be set to 0\n 00094 * b3\n 00095 * 0 : Ready or Busy (No Listen mode ongoing)\n 00096 * 1 : Listen (peripheral in Address Listen Mode)\n 00097 * b2 Intrinsic process state\n 00098 * 0 : Ready\n 00099 * 1 : Busy (peripheral busy with some configuration or internal operations)\n 00100 * b1 Rx state\n 00101 * 0 : Ready (no Rx operation ongoing)\n 00102 * 1 : Busy (Rx operation ongoing)\n 00103 * b0 Tx state\n 00104 * 0 : Ready (no Tx operation ongoing)\n 00105 * 1 : Busy (Tx operation ongoing) 00106 * @{ 00107 */ 00108 typedef enum 00109 { 00110 HAL_I2C_STATE_RESET = 0x00U, /*!< Peripheral is not yet Initialized */ 00111 HAL_I2C_STATE_READY = 0x20U, /*!< Peripheral Initialized and ready for use */ 00112 HAL_I2C_STATE_BUSY = 0x24U, /*!< An internal process is ongoing */ 00113 HAL_I2C_STATE_BUSY_TX = 0x21U, /*!< Data Transmission process is ongoing */ 00114 HAL_I2C_STATE_BUSY_RX = 0x22U, /*!< Data Reception process is ongoing */ 00115 HAL_I2C_STATE_LISTEN = 0x28U, /*!< Address Listen Mode is ongoing */ 00116 HAL_I2C_STATE_BUSY_TX_LISTEN = 0x29U, /*!< Address Listen Mode and Data Transmission 00117 process is ongoing */ 00118 HAL_I2C_STATE_BUSY_RX_LISTEN = 0x2AU, /*!< Address Listen Mode and Data Reception 00119 process is ongoing */ 00120 HAL_I2C_STATE_ABORT = 0x60U, /*!< Abort user request ongoing */ 00121 HAL_I2C_STATE_TIMEOUT = 0xA0U, /*!< Timeout state */ 00122 HAL_I2C_STATE_ERROR = 0xE0U /*!< Error */ 00123 00124 } HAL_I2C_StateTypeDef; 00125 00126 /** 00127 * @} 00128 */ 00129 00130 /** @defgroup HAL_mode_structure_definition HAL mode structure definition 00131 * @brief HAL Mode structure definition 00132 * @note HAL I2C Mode value coding follow below described bitmap :\n 00133 * b7 (not used)\n 00134 * x : Should be set to 0\n 00135 * b6\n 00136 * 0 : None\n 00137 * 1 : Memory (HAL I2C communication is in Memory Mode)\n 00138 * b5\n 00139 * 0 : None\n 00140 * 1 : Slave (HAL I2C communication is in Slave Mode)\n 00141 * b4\n 00142 * 0 : None\n 00143 * 1 : Master (HAL I2C communication is in Master Mode)\n 00144 * b3-b2-b1-b0 (not used)\n 00145 * xxxx : Should be set to 0000 00146 * @{ 00147 */ 00148 typedef enum 00149 { 00150 HAL_I2C_MODE_NONE = 0x00U, /*!< No I2C communication on going */ 00151 HAL_I2C_MODE_MASTER = 0x10U, /*!< I2C communication is in Master Mode */ 00152 HAL_I2C_MODE_SLAVE = 0x20U, /*!< I2C communication is in Slave Mode */ 00153 HAL_I2C_MODE_MEM = 0x40U /*!< I2C communication is in Memory Mode */ 00154 00155 } HAL_I2C_ModeTypeDef; 00156 00157 /** 00158 * @} 00159 */ 00160 00161 /** @defgroup I2C_Error_Code_definition I2C Error Code definition 00162 * @brief I2C Error Code definition 00163 * @{ 00164 */ 00165 #define HAL_I2C_ERROR_NONE (0x00000000U) /*!< No error */ 00166 #define HAL_I2C_ERROR_BERR (0x00000001U) /*!< BERR error */ 00167 #define HAL_I2C_ERROR_ARLO (0x00000002U) /*!< ARLO error */ 00168 #define HAL_I2C_ERROR_AF (0x00000004U) /*!< ACKF error */ 00169 #define HAL_I2C_ERROR_OVR (0x00000008U) /*!< OVR error */ 00170 #define HAL_I2C_ERROR_DMA (0x00000010U) /*!< DMA transfer error */ 00171 #define HAL_I2C_ERROR_TIMEOUT (0x00000020U) /*!< Timeout error */ 00172 #define HAL_I2C_ERROR_SIZE (0x00000040U) /*!< Size Management error */ 00173 #define HAL_I2C_ERROR_DMA_PARAM (0x00000080U) /*!< DMA Parameter Error */ 00174 #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1) 00175 #define HAL_I2C_ERROR_INVALID_CALLBACK (0x00000100U) /*!< Invalid Callback error */ 00176 #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */ 00177 #define HAL_I2C_ERROR_INVALID_PARAM (0x00000200U) /*!< Invalid Parameters error */ 00178 /** 00179 * @} 00180 */ 00181 00182 /** @defgroup I2C_handle_Structure_definition I2C handle Structure definition 00183 * @brief I2C handle Structure definition 00184 * @{ 00185 */ 00186 typedef struct __I2C_HandleTypeDef 00187 { 00188 I2C_TypeDef *Instance; /*!< I2C registers base address */ 00189 00190 I2C_InitTypeDef Init; /*!< I2C communication parameters */ 00191 00192 uint8_t *pBuffPtr; /*!< Pointer to I2C transfer buffer */ 00193 00194 uint16_t XferSize; /*!< I2C transfer size */ 00195 00196 __IO uint16_t XferCount; /*!< I2C transfer counter */ 00197 00198 __IO uint32_t XferOptions; /*!< I2C sequantial transfer options, this parameter can 00199 be a value of @ref I2C_XFEROPTIONS */ 00200 00201 __IO uint32_t PreviousState; /*!< I2C communication Previous state */ 00202 00203 HAL_StatusTypeDef(*XferISR)(struct __I2C_HandleTypeDef *hi2c, uint32_t ITFlags, uint32_t ITSources); 00204 /*!< I2C transfer IRQ handler function pointer */ 00205 00206 DMA_HandleTypeDef *hdmatx; /*!< I2C Tx DMA handle parameters */ 00207 00208 DMA_HandleTypeDef *hdmarx; /*!< I2C Rx DMA handle parameters */ 00209 00210 HAL_LockTypeDef Lock; /*!< I2C locking object */ 00211 00212 __IO HAL_I2C_StateTypeDef State; /*!< I2C communication state */ 00213 00214 __IO HAL_I2C_ModeTypeDef Mode; /*!< I2C communication mode */ 00215 00216 __IO uint32_t ErrorCode; /*!< I2C Error code */ 00217 00218 __IO uint32_t AddrEventCount; /*!< I2C Address Event counter */ 00219 00220 #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1) 00221 void (* MasterTxCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00222 /*!< I2C Master Tx Transfer completed callback */ 00223 void (* MasterRxCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00224 /*!< I2C Master Rx Transfer completed callback */ 00225 void (* SlaveTxCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00226 /*!< I2C Slave Tx Transfer completed callback */ 00227 void (* SlaveRxCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00228 /*!< I2C Slave Rx Transfer completed callback */ 00229 void (* ListenCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00230 /*!< I2C Listen Complete callback */ 00231 void (* MemTxCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00232 /*!< I2C Memory Tx Transfer completed callback */ 00233 void (* MemRxCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00234 /*!< I2C Memory Rx Transfer completed callback */ 00235 void (* ErrorCallback)(struct __I2C_HandleTypeDef *hi2c); 00236 /*!< I2C Error callback */ 00237 void (* AbortCpltCallback)(struct __I2C_HandleTypeDef *hi2c); 00238 /*!< I2C Abort callback */ 00239 00240 void (* AddrCallback)(struct __I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode); 00241 /*!< I2C Slave Address Match callback */ 00242 00243 void (* MspInitCallback)(struct __I2C_HandleTypeDef *hi2c); 00244 /*!< I2C Msp Init callback */ 00245 void (* MspDeInitCallback)(struct __I2C_HandleTypeDef *hi2c); 00246 /*!< I2C Msp DeInit callback */ 00247 00248 #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */ 00249 } I2C_HandleTypeDef; 00250 00251 #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1) 00252 /** 00253 * @brief HAL I2C Callback ID enumeration definition 00254 */ 00255 typedef enum 00256 { 00257 HAL_I2C_MASTER_TX_COMPLETE_CB_ID = 0x00U, /*!< I2C Master Tx Transfer completed callback ID */ 00258 HAL_I2C_MASTER_RX_COMPLETE_CB_ID = 0x01U, /*!< I2C Master Rx Transfer completed callback ID */ 00259 HAL_I2C_SLAVE_TX_COMPLETE_CB_ID = 0x02U, /*!< I2C Slave Tx Transfer completed callback ID */ 00260 HAL_I2C_SLAVE_RX_COMPLETE_CB_ID = 0x03U, /*!< I2C Slave Rx Transfer completed callback ID */ 00261 HAL_I2C_LISTEN_COMPLETE_CB_ID = 0x04U, /*!< I2C Listen Complete callback ID */ 00262 HAL_I2C_MEM_TX_COMPLETE_CB_ID = 0x05U, /*!< I2C Memory Tx Transfer callback ID */ 00263 HAL_I2C_MEM_RX_COMPLETE_CB_ID = 0x06U, /*!< I2C Memory Rx Transfer completed callback ID */ 00264 HAL_I2C_ERROR_CB_ID = 0x07U, /*!< I2C Error callback ID */ 00265 HAL_I2C_ABORT_CB_ID = 0x08U, /*!< I2C Abort callback ID */ 00266 00267 HAL_I2C_MSPINIT_CB_ID = 0x09U, /*!< I2C Msp Init callback ID */ 00268 HAL_I2C_MSPDEINIT_CB_ID = 0x0AU /*!< I2C Msp DeInit callback ID */ 00269 00270 } HAL_I2C_CallbackIDTypeDef; 00271 00272 /** 00273 * @brief HAL I2C Callback pointer definition 00274 */ 00275 typedef void (*pI2C_CallbackTypeDef)(I2C_HandleTypeDef *hi2c); 00276 /*!< pointer to an I2C callback function */ 00277 typedef void (*pI2C_AddrCallbackTypeDef)(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, 00278 uint16_t AddrMatchCode); 00279 /*!< pointer to an I2C Address Match callback function */ 00280 00281 #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */ 00282 /** 00283 * @} 00284 */ 00285 00286 /** 00287 * @} 00288 */ 00289 /* Exported constants --------------------------------------------------------*/ 00290 00291 /** @defgroup I2C_Exported_Constants I2C Exported Constants 00292 * @{ 00293 */ 00294 00295 /** @defgroup I2C_XFEROPTIONS I2C Sequential Transfer Options 00296 * @{ 00297 */ 00298 #define I2C_FIRST_FRAME ((uint32_t)I2C_SOFTEND_MODE) 00299 #define I2C_FIRST_AND_NEXT_FRAME ((uint32_t)(I2C_RELOAD_MODE | I2C_SOFTEND_MODE)) 00300 #define I2C_NEXT_FRAME ((uint32_t)(I2C_RELOAD_MODE | I2C_SOFTEND_MODE)) 00301 #define I2C_FIRST_AND_LAST_FRAME ((uint32_t)I2C_AUTOEND_MODE) 00302 #define I2C_LAST_FRAME ((uint32_t)I2C_AUTOEND_MODE) 00303 #define I2C_LAST_FRAME_NO_STOP ((uint32_t)I2C_SOFTEND_MODE) 00304 00305 /* List of XferOptions in usage of : 00306 * 1- Restart condition in all use cases (direction change or not) 00307 */ 00308 #define I2C_OTHER_FRAME (0x000000AAU) 00309 #define I2C_OTHER_AND_LAST_FRAME (0x0000AA00U) 00310 /** 00311 * @} 00312 */ 00313 00314 /** @defgroup I2C_ADDRESSING_MODE I2C Addressing Mode 00315 * @{ 00316 */ 00317 #define I2C_ADDRESSINGMODE_7BIT (0x00000001U) 00318 #define I2C_ADDRESSINGMODE_10BIT (0x00000002U) 00319 /** 00320 * @} 00321 */ 00322 00323 /** @defgroup I2C_DUAL_ADDRESSING_MODE I2C Dual Addressing Mode 00324 * @{ 00325 */ 00326 #define I2C_DUALADDRESS_DISABLE (0x00000000U) 00327 #define I2C_DUALADDRESS_ENABLE I2C_OAR2_OA2EN 00328 /** 00329 * @} 00330 */ 00331 00332 /** @defgroup I2C_OWN_ADDRESS2_MASKS I2C Own Address2 Masks 00333 * @{ 00334 */ 00335 #define I2C_OA2_NOMASK ((uint8_t)0x00U) 00336 #define I2C_OA2_MASK01 ((uint8_t)0x01U) 00337 #define I2C_OA2_MASK02 ((uint8_t)0x02U) 00338 #define I2C_OA2_MASK03 ((uint8_t)0x03U) 00339 #define I2C_OA2_MASK04 ((uint8_t)0x04U) 00340 #define I2C_OA2_MASK05 ((uint8_t)0x05U) 00341 #define I2C_OA2_MASK06 ((uint8_t)0x06U) 00342 #define I2C_OA2_MASK07 ((uint8_t)0x07U) 00343 /** 00344 * @} 00345 */ 00346 00347 /** @defgroup I2C_GENERAL_CALL_ADDRESSING_MODE I2C General Call Addressing Mode 00348 * @{ 00349 */ 00350 #define I2C_GENERALCALL_DISABLE (0x00000000U) 00351 #define I2C_GENERALCALL_ENABLE I2C_CR1_GCEN 00352 /** 00353 * @} 00354 */ 00355 00356 /** @defgroup I2C_NOSTRETCH_MODE I2C No-Stretch Mode 00357 * @{ 00358 */ 00359 #define I2C_NOSTRETCH_DISABLE (0x00000000U) 00360 #define I2C_NOSTRETCH_ENABLE I2C_CR1_NOSTRETCH 00361 /** 00362 * @} 00363 */ 00364 00365 /** @defgroup I2C_MEMORY_ADDRESS_SIZE I2C Memory Address Size 00366 * @{ 00367 */ 00368 #define I2C_MEMADD_SIZE_8BIT (0x00000001U) 00369 #define I2C_MEMADD_SIZE_16BIT (0x00000002U) 00370 /** 00371 * @} 00372 */ 00373 00374 /** @defgroup I2C_XFERDIRECTION I2C Transfer Direction Master Point of View 00375 * @{ 00376 */ 00377 #define I2C_DIRECTION_TRANSMIT (0x00000000U) 00378 #define I2C_DIRECTION_RECEIVE (0x00000001U) 00379 /** 00380 * @} 00381 */ 00382 00383 /** @defgroup I2C_RELOAD_END_MODE I2C Reload End Mode 00384 * @{ 00385 */ 00386 #define I2C_RELOAD_MODE I2C_CR2_RELOAD 00387 #define I2C_AUTOEND_MODE I2C_CR2_AUTOEND 00388 #define I2C_SOFTEND_MODE (0x00000000U) 00389 /** 00390 * @} 00391 */ 00392 00393 /** @defgroup I2C_START_STOP_MODE I2C Start or Stop Mode 00394 * @{ 00395 */ 00396 #define I2C_NO_STARTSTOP (0x00000000U) 00397 #define I2C_GENERATE_STOP (uint32_t)(0x80000000U | I2C_CR2_STOP) 00398 #define I2C_GENERATE_START_READ (uint32_t)(0x80000000U | I2C_CR2_START | I2C_CR2_RD_WRN) 00399 #define I2C_GENERATE_START_WRITE (uint32_t)(0x80000000U | I2C_CR2_START) 00400 /** 00401 * @} 00402 */ 00403 00404 /** @defgroup I2C_Interrupt_configuration_definition I2C Interrupt configuration definition 00405 * @brief I2C Interrupt definition 00406 * Elements values convention: 0xXXXXXXXX 00407 * - XXXXXXXX : Interrupt control mask 00408 * @{ 00409 */ 00410 #define I2C_IT_ERRI I2C_CR1_ERRIE 00411 #define I2C_IT_TCI I2C_CR1_TCIE 00412 #define I2C_IT_STOPI I2C_CR1_STOPIE 00413 #define I2C_IT_NACKI I2C_CR1_NACKIE 00414 #define I2C_IT_ADDRI I2C_CR1_ADDRIE 00415 #define I2C_IT_RXI I2C_CR1_RXIE 00416 #define I2C_IT_TXI I2C_CR1_TXIE 00417 /** 00418 * @} 00419 */ 00420 00421 /** @defgroup I2C_Flag_definition I2C Flag definition 00422 * @{ 00423 */ 00424 #define I2C_FLAG_TXE I2C_ISR_TXE 00425 #define I2C_FLAG_TXIS I2C_ISR_TXIS 00426 #define I2C_FLAG_RXNE I2C_ISR_RXNE 00427 #define I2C_FLAG_ADDR I2C_ISR_ADDR 00428 #define I2C_FLAG_AF I2C_ISR_NACKF 00429 #define I2C_FLAG_STOPF I2C_ISR_STOPF 00430 #define I2C_FLAG_TC I2C_ISR_TC 00431 #define I2C_FLAG_TCR I2C_ISR_TCR 00432 #define I2C_FLAG_BERR I2C_ISR_BERR 00433 #define I2C_FLAG_ARLO I2C_ISR_ARLO 00434 #define I2C_FLAG_OVR I2C_ISR_OVR 00435 #define I2C_FLAG_PECERR I2C_ISR_PECERR 00436 #define I2C_FLAG_TIMEOUT I2C_ISR_TIMEOUT 00437 #define I2C_FLAG_ALERT I2C_ISR_ALERT 00438 #define I2C_FLAG_BUSY I2C_ISR_BUSY 00439 #define I2C_FLAG_DIR I2C_ISR_DIR 00440 /** 00441 * @} 00442 */ 00443 00444 /** 00445 * @} 00446 */ 00447 00448 /* Exported macros -----------------------------------------------------------*/ 00449 00450 /** @defgroup I2C_Exported_Macros I2C Exported Macros 00451 * @{ 00452 */ 00453 00454 /** @brief Reset I2C handle state. 00455 * @param __HANDLE__ specifies the I2C Handle. 00456 * @retval None 00457 */ 00458 #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1) 00459 #define __HAL_I2C_RESET_HANDLE_STATE(__HANDLE__) do{ \ 00460 (__HANDLE__)->State = HAL_I2C_STATE_RESET; \ 00461 (__HANDLE__)->MspInitCallback = NULL; \ 00462 (__HANDLE__)->MspDeInitCallback = NULL; \ 00463 } while(0) 00464 #else 00465 #define __HAL_I2C_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_I2C_STATE_RESET) 00466 #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */ 00467 00468 /** @brief Enable the specified I2C interrupt. 00469 * @param __HANDLE__ specifies the I2C Handle. 00470 * @param __INTERRUPT__ specifies the interrupt source to enable. 00471 * This parameter can be one of the following values: 00472 * @arg @ref I2C_IT_ERRI Errors interrupt enable 00473 * @arg @ref I2C_IT_TCI Transfer complete interrupt enable 00474 * @arg @ref I2C_IT_STOPI STOP detection interrupt enable 00475 * @arg @ref I2C_IT_NACKI NACK received interrupt enable 00476 * @arg @ref I2C_IT_ADDRI Address match interrupt enable 00477 * @arg @ref I2C_IT_RXI RX interrupt enable 00478 * @arg @ref I2C_IT_TXI TX interrupt enable 00479 * 00480 * @retval None 00481 */ 00482 #define __HAL_I2C_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR1 |= (__INTERRUPT__)) 00483 00484 /** @brief Disable the specified I2C interrupt. 00485 * @param __HANDLE__ specifies the I2C Handle. 00486 * @param __INTERRUPT__ specifies the interrupt source to disable. 00487 * This parameter can be one of the following values: 00488 * @arg @ref I2C_IT_ERRI Errors interrupt enable 00489 * @arg @ref I2C_IT_TCI Transfer complete interrupt enable 00490 * @arg @ref I2C_IT_STOPI STOP detection interrupt enable 00491 * @arg @ref I2C_IT_NACKI NACK received interrupt enable 00492 * @arg @ref I2C_IT_ADDRI Address match interrupt enable 00493 * @arg @ref I2C_IT_RXI RX interrupt enable 00494 * @arg @ref I2C_IT_TXI TX interrupt enable 00495 * 00496 * @retval None 00497 */ 00498 #define __HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR1 &= (~(__INTERRUPT__))) 00499 00500 /** @brief Check whether the specified I2C interrupt source is enabled or not. 00501 * @param __HANDLE__ specifies the I2C Handle. 00502 * @param __INTERRUPT__ specifies the I2C interrupt source to check. 00503 * This parameter can be one of the following values: 00504 * @arg @ref I2C_IT_ERRI Errors interrupt enable 00505 * @arg @ref I2C_IT_TCI Transfer complete interrupt enable 00506 * @arg @ref I2C_IT_STOPI STOP detection interrupt enable 00507 * @arg @ref I2C_IT_NACKI NACK received interrupt enable 00508 * @arg @ref I2C_IT_ADDRI Address match interrupt enable 00509 * @arg @ref I2C_IT_RXI RX interrupt enable 00510 * @arg @ref I2C_IT_TXI TX interrupt enable 00511 * 00512 * @retval The new state of __INTERRUPT__ (SET or RESET). 00513 */ 00514 #define __HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->CR1 & \ 00515 (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET) 00516 00517 /** @brief Check whether the specified I2C flag is set or not. 00518 * @param __HANDLE__ specifies the I2C Handle. 00519 * @param __FLAG__ specifies the flag to check. 00520 * This parameter can be one of the following values: 00521 * @arg @ref I2C_FLAG_TXE Transmit data register empty 00522 * @arg @ref I2C_FLAG_TXIS Transmit interrupt status 00523 * @arg @ref I2C_FLAG_RXNE Receive data register not empty 00524 * @arg @ref I2C_FLAG_ADDR Address matched (slave mode) 00525 * @arg @ref I2C_FLAG_AF Acknowledge failure received flag 00526 * @arg @ref I2C_FLAG_STOPF STOP detection flag 00527 * @arg @ref I2C_FLAG_TC Transfer complete (master mode) 00528 * @arg @ref I2C_FLAG_TCR Transfer complete reload 00529 * @arg @ref I2C_FLAG_BERR Bus error 00530 * @arg @ref I2C_FLAG_ARLO Arbitration lost 00531 * @arg @ref I2C_FLAG_OVR Overrun/Underrun 00532 * @arg @ref I2C_FLAG_PECERR PEC error in reception 00533 * @arg @ref I2C_FLAG_TIMEOUT Timeout or Tlow detection flag 00534 * @arg @ref I2C_FLAG_ALERT SMBus alert 00535 * @arg @ref I2C_FLAG_BUSY Bus busy 00536 * @arg @ref I2C_FLAG_DIR Transfer direction (slave mode) 00537 * 00538 * @retval The new state of __FLAG__ (SET or RESET). 00539 */ 00540 #define I2C_FLAG_MASK (0x0001FFFFU) 00541 #define __HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & \ 00542 (__FLAG__)) == (__FLAG__)) ? SET : RESET) 00543 00544 /** @brief Clear the I2C pending flags which are cleared by writing 1 in a specific bit. 00545 * @param __HANDLE__ specifies the I2C Handle. 00546 * @param __FLAG__ specifies the flag to clear. 00547 * This parameter can be any combination of the following values: 00548 * @arg @ref I2C_FLAG_TXE Transmit data register empty 00549 * @arg @ref I2C_FLAG_ADDR Address matched (slave mode) 00550 * @arg @ref I2C_FLAG_AF Acknowledge failure received flag 00551 * @arg @ref I2C_FLAG_STOPF STOP detection flag 00552 * @arg @ref I2C_FLAG_BERR Bus error 00553 * @arg @ref I2C_FLAG_ARLO Arbitration lost 00554 * @arg @ref I2C_FLAG_OVR Overrun/Underrun 00555 * @arg @ref I2C_FLAG_PECERR PEC error in reception 00556 * @arg @ref I2C_FLAG_TIMEOUT Timeout or Tlow detection flag 00557 * @arg @ref I2C_FLAG_ALERT SMBus alert 00558 * 00559 * @retval None 00560 */ 00561 #define __HAL_I2C_CLEAR_FLAG(__HANDLE__, __FLAG__) (((__FLAG__) == I2C_FLAG_TXE) ? \ 00562 ((__HANDLE__)->Instance->ISR |= (__FLAG__)) : \ 00563 ((__HANDLE__)->Instance->ICR = (__FLAG__))) 00564 00565 /** @brief Enable the specified I2C peripheral. 00566 * @param __HANDLE__ specifies the I2C Handle. 00567 * @retval None 00568 */ 00569 #define __HAL_I2C_ENABLE(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE)) 00570 00571 /** @brief Disable the specified I2C peripheral. 00572 * @param __HANDLE__ specifies the I2C Handle. 00573 * @retval None 00574 */ 00575 #define __HAL_I2C_DISABLE(__HANDLE__) (CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE)) 00576 00577 /** @brief Generate a Non-Acknowledge I2C peripheral in Slave mode. 00578 * @param __HANDLE__ specifies the I2C Handle. 00579 * @retval None 00580 */ 00581 #define __HAL_I2C_GENERATE_NACK(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR2, I2C_CR2_NACK)) 00582 /** 00583 * @} 00584 */ 00585 00586 /* Include I2C HAL Extended module */ 00587 #include "stm32h7xx_hal_i2c_ex.h" 00588 00589 /* Exported functions --------------------------------------------------------*/ 00590 /** @addtogroup I2C_Exported_Functions 00591 * @{ 00592 */ 00593 00594 /** @addtogroup I2C_Exported_Functions_Group1 Initialization and de-initialization functions 00595 * @{ 00596 */ 00597 /* Initialization and de-initialization functions******************************/ 00598 HAL_StatusTypeDef HAL_I2C_Init(I2C_HandleTypeDef *hi2c); 00599 HAL_StatusTypeDef HAL_I2C_DeInit(I2C_HandleTypeDef *hi2c); 00600 void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c); 00601 void HAL_I2C_MspDeInit(I2C_HandleTypeDef *hi2c); 00602 00603 /* Callbacks Register/UnRegister functions ***********************************/ 00604 #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1) 00605 HAL_StatusTypeDef HAL_I2C_RegisterCallback(I2C_HandleTypeDef *hi2c, HAL_I2C_CallbackIDTypeDef CallbackID, 00606 pI2C_CallbackTypeDef pCallback); 00607 HAL_StatusTypeDef HAL_I2C_UnRegisterCallback(I2C_HandleTypeDef *hi2c, HAL_I2C_CallbackIDTypeDef CallbackID); 00608 00609 HAL_StatusTypeDef HAL_I2C_RegisterAddrCallback(I2C_HandleTypeDef *hi2c, pI2C_AddrCallbackTypeDef pCallback); 00610 HAL_StatusTypeDef HAL_I2C_UnRegisterAddrCallback(I2C_HandleTypeDef *hi2c); 00611 #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */ 00612 /** 00613 * @} 00614 */ 00615 00616 /** @addtogroup I2C_Exported_Functions_Group2 Input and Output operation functions 00617 * @{ 00618 */ 00619 /* IO operation functions ****************************************************/ 00620 /******* Blocking mode: Polling */ 00621 HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00622 uint16_t Size, uint32_t Timeout); 00623 HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00624 uint16_t Size, uint32_t Timeout); 00625 HAL_StatusTypeDef HAL_I2C_Slave_Transmit(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, 00626 uint32_t Timeout); 00627 HAL_StatusTypeDef HAL_I2C_Slave_Receive(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, 00628 uint32_t Timeout); 00629 HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, 00630 uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout); 00631 HAL_StatusTypeDef HAL_I2C_Mem_Read(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, 00632 uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout); 00633 HAL_StatusTypeDef HAL_I2C_IsDeviceReady(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Trials, 00634 uint32_t Timeout); 00635 00636 /******* Non-Blocking mode: Interrupt */ 00637 HAL_StatusTypeDef HAL_I2C_Master_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00638 uint16_t Size); 00639 HAL_StatusTypeDef HAL_I2C_Master_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00640 uint16_t Size); 00641 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size); 00642 HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size); 00643 HAL_StatusTypeDef HAL_I2C_Mem_Write_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, 00644 uint16_t MemAddSize, uint8_t *pData, uint16_t Size); 00645 HAL_StatusTypeDef HAL_I2C_Mem_Read_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, 00646 uint16_t MemAddSize, uint8_t *pData, uint16_t Size); 00647 00648 HAL_StatusTypeDef HAL_I2C_Master_Seq_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00649 uint16_t Size, uint32_t XferOptions); 00650 HAL_StatusTypeDef HAL_I2C_Master_Seq_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00651 uint16_t Size, uint32_t XferOptions); 00652 HAL_StatusTypeDef HAL_I2C_Slave_Seq_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, 00653 uint32_t XferOptions); 00654 HAL_StatusTypeDef HAL_I2C_Slave_Seq_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, 00655 uint32_t XferOptions); 00656 HAL_StatusTypeDef HAL_I2C_EnableListen_IT(I2C_HandleTypeDef *hi2c); 00657 HAL_StatusTypeDef HAL_I2C_DisableListen_IT(I2C_HandleTypeDef *hi2c); 00658 HAL_StatusTypeDef HAL_I2C_Master_Abort_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress); 00659 00660 /******* Non-Blocking mode: DMA */ 00661 HAL_StatusTypeDef HAL_I2C_Master_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00662 uint16_t Size); 00663 HAL_StatusTypeDef HAL_I2C_Master_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00664 uint16_t Size); 00665 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size); 00666 HAL_StatusTypeDef HAL_I2C_Slave_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size); 00667 HAL_StatusTypeDef HAL_I2C_Mem_Write_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, 00668 uint16_t MemAddSize, uint8_t *pData, uint16_t Size); 00669 HAL_StatusTypeDef HAL_I2C_Mem_Read_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, 00670 uint16_t MemAddSize, uint8_t *pData, uint16_t Size); 00671 00672 HAL_StatusTypeDef HAL_I2C_Master_Seq_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00673 uint16_t Size, uint32_t XferOptions); 00674 HAL_StatusTypeDef HAL_I2C_Master_Seq_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, 00675 uint16_t Size, uint32_t XferOptions); 00676 HAL_StatusTypeDef HAL_I2C_Slave_Seq_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, 00677 uint32_t XferOptions); 00678 HAL_StatusTypeDef HAL_I2C_Slave_Seq_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, 00679 uint32_t XferOptions); 00680 /** 00681 * @} 00682 */ 00683 00684 /** @addtogroup I2C_IRQ_Handler_and_Callbacks IRQ Handler and Callbacks 00685 * @{ 00686 */ 00687 /******* I2C IRQHandler and Callbacks used in non blocking modes (Interrupt and DMA) */ 00688 void HAL_I2C_EV_IRQHandler(I2C_HandleTypeDef *hi2c); 00689 void HAL_I2C_ER_IRQHandler(I2C_HandleTypeDef *hi2c); 00690 void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c); 00691 void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c); 00692 void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c); 00693 void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c); 00694 void HAL_I2C_AddrCallback(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode); 00695 void HAL_I2C_ListenCpltCallback(I2C_HandleTypeDef *hi2c); 00696 void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c); 00697 void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c); 00698 void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c); 00699 void HAL_I2C_AbortCpltCallback(I2C_HandleTypeDef *hi2c); 00700 /** 00701 * @} 00702 */ 00703 00704 /** @addtogroup I2C_Exported_Functions_Group3 Peripheral State, Mode and Error functions 00705 * @{ 00706 */ 00707 /* Peripheral State, Mode and Error functions *********************************/ 00708 HAL_I2C_StateTypeDef HAL_I2C_GetState(I2C_HandleTypeDef *hi2c); 00709 HAL_I2C_ModeTypeDef HAL_I2C_GetMode(I2C_HandleTypeDef *hi2c); 00710 uint32_t HAL_I2C_GetError(I2C_HandleTypeDef *hi2c); 00711 00712 /** 00713 * @} 00714 */ 00715 00716 /** 00717 * @} 00718 */ 00719 00720 /* Private constants ---------------------------------------------------------*/ 00721 /** @defgroup I2C_Private_Constants I2C Private Constants 00722 * @{ 00723 */ 00724 00725 /** 00726 * @} 00727 */ 00728 00729 /* Private macros ------------------------------------------------------------*/ 00730 /** @defgroup I2C_Private_Macro I2C Private Macros 00731 * @{ 00732 */ 00733 00734 #define IS_I2C_ADDRESSING_MODE(MODE) (((MODE) == I2C_ADDRESSINGMODE_7BIT) || \ 00735 ((MODE) == I2C_ADDRESSINGMODE_10BIT)) 00736 00737 #define IS_I2C_DUAL_ADDRESS(ADDRESS) (((ADDRESS) == I2C_DUALADDRESS_DISABLE) || \ 00738 ((ADDRESS) == I2C_DUALADDRESS_ENABLE)) 00739 00740 #define IS_I2C_OWN_ADDRESS2_MASK(MASK) (((MASK) == I2C_OA2_NOMASK) || \ 00741 ((MASK) == I2C_OA2_MASK01) || \ 00742 ((MASK) == I2C_OA2_MASK02) || \ 00743 ((MASK) == I2C_OA2_MASK03) || \ 00744 ((MASK) == I2C_OA2_MASK04) || \ 00745 ((MASK) == I2C_OA2_MASK05) || \ 00746 ((MASK) == I2C_OA2_MASK06) || \ 00747 ((MASK) == I2C_OA2_MASK07)) 00748 00749 #define IS_I2C_GENERAL_CALL(CALL) (((CALL) == I2C_GENERALCALL_DISABLE) || \ 00750 ((CALL) == I2C_GENERALCALL_ENABLE)) 00751 00752 #define IS_I2C_NO_STRETCH(STRETCH) (((STRETCH) == I2C_NOSTRETCH_DISABLE) || \ 00753 ((STRETCH) == I2C_NOSTRETCH_ENABLE)) 00754 00755 #define IS_I2C_MEMADD_SIZE(SIZE) (((SIZE) == I2C_MEMADD_SIZE_8BIT) || \ 00756 ((SIZE) == I2C_MEMADD_SIZE_16BIT)) 00757 00758 #define IS_TRANSFER_MODE(MODE) (((MODE) == I2C_RELOAD_MODE) || \ 00759 ((MODE) == I2C_AUTOEND_MODE) || \ 00760 ((MODE) == I2C_SOFTEND_MODE)) 00761 00762 #define IS_TRANSFER_REQUEST(REQUEST) (((REQUEST) == I2C_GENERATE_STOP) || \ 00763 ((REQUEST) == I2C_GENERATE_START_READ) || \ 00764 ((REQUEST) == I2C_GENERATE_START_WRITE) || \ 00765 ((REQUEST) == I2C_NO_STARTSTOP)) 00766 00767 #define IS_I2C_TRANSFER_OPTIONS_REQUEST(REQUEST) (((REQUEST) == I2C_FIRST_FRAME) || \ 00768 ((REQUEST) == I2C_FIRST_AND_NEXT_FRAME) || \ 00769 ((REQUEST) == I2C_NEXT_FRAME) || \ 00770 ((REQUEST) == I2C_FIRST_AND_LAST_FRAME) || \ 00771 ((REQUEST) == I2C_LAST_FRAME) || \ 00772 ((REQUEST) == I2C_LAST_FRAME_NO_STOP) || \ 00773 IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(REQUEST)) 00774 00775 #define IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(REQUEST) (((REQUEST) == I2C_OTHER_FRAME) || \ 00776 ((REQUEST) == I2C_OTHER_AND_LAST_FRAME)) 00777 00778 #define I2C_RESET_CR2(__HANDLE__) ((__HANDLE__)->Instance->CR2 &= \ 00779 (uint32_t)~((uint32_t)(I2C_CR2_SADD | I2C_CR2_HEAD10R | \ 00780 I2C_CR2_NBYTES | I2C_CR2_RELOAD | \ 00781 I2C_CR2_RD_WRN))) 00782 00783 #define I2C_GET_ADDR_MATCH(__HANDLE__) ((uint16_t)(((__HANDLE__)->Instance->ISR & I2C_ISR_ADDCODE) \ 00784 >> 16U)) 00785 #define I2C_GET_DIR(__HANDLE__) ((uint8_t)(((__HANDLE__)->Instance->ISR & I2C_ISR_DIR) \ 00786 >> 16U)) 00787 #define I2C_GET_STOP_MODE(__HANDLE__) ((__HANDLE__)->Instance->CR2 & I2C_CR2_AUTOEND) 00788 #define I2C_GET_OWN_ADDRESS1(__HANDLE__) ((uint16_t)((__HANDLE__)->Instance->OAR1 & I2C_OAR1_OA1)) 00789 #define I2C_GET_OWN_ADDRESS2(__HANDLE__) ((uint16_t)((__HANDLE__)->Instance->OAR2 & I2C_OAR2_OA2)) 00790 00791 #define IS_I2C_OWN_ADDRESS1(ADDRESS1) ((ADDRESS1) <= 0x000003FFU) 00792 #define IS_I2C_OWN_ADDRESS2(ADDRESS2) ((ADDRESS2) <= (uint16_t)0x00FFU) 00793 00794 #define I2C_MEM_ADD_MSB(__ADDRESS__) ((uint8_t)((uint16_t)(((uint16_t)((__ADDRESS__) & \ 00795 (uint16_t)(0xFF00U))) >> 8U))) 00796 #define I2C_MEM_ADD_LSB(__ADDRESS__) ((uint8_t)((uint16_t)((__ADDRESS__) & (uint16_t)(0x00FFU)))) 00797 00798 #define I2C_GENERATE_START(__ADDMODE__,__ADDRESS__) (((__ADDMODE__) == I2C_ADDRESSINGMODE_7BIT) ? \ 00799 (uint32_t)((((uint32_t)(__ADDRESS__) & (I2C_CR2_SADD)) | \ 00800 (I2C_CR2_START) | (I2C_CR2_AUTOEND)) & \ 00801 (~I2C_CR2_RD_WRN)) : \ 00802 (uint32_t)((((uint32_t)(__ADDRESS__) & (I2C_CR2_SADD)) | \ 00803 (I2C_CR2_ADD10) | (I2C_CR2_START)) & \ 00804 (~I2C_CR2_RD_WRN))) 00805 00806 #define I2C_CHECK_FLAG(__ISR__, __FLAG__) ((((__ISR__) & ((__FLAG__) & I2C_FLAG_MASK)) == \ 00807 ((__FLAG__) & I2C_FLAG_MASK)) ? SET : RESET) 00808 #define I2C_CHECK_IT_SOURCE(__CR1__, __IT__) ((((__CR1__) & (__IT__)) == (__IT__)) ? SET : RESET) 00809 /** 00810 * @} 00811 */ 00812 00813 /* Private Functions ---------------------------------------------------------*/ 00814 /** @defgroup I2C_Private_Functions I2C Private Functions 00815 * @{ 00816 */ 00817 /* Private functions are defined in stm32h7xx_hal_i2c.c file */ 00818 /** 00819 * @} 00820 */ 00821 00822 /** 00823 * @} 00824 */ 00825 00826 /** 00827 * @} 00828 */ 00829 00830 #ifdef __cplusplus 00831 } 00832 #endif 00833 00834 00835 #endif /* STM32H7xx_HAL_I2C_H */
1.7.6.1