git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_M7_STM32F7_STM32756G-EVAL/ST_Library/include/stm32f7xx_hal_i2c.h

   1 /**\r
   2   ******************************************************************************\r
   3   * @file    stm32f7xx_hal_i2c.h\r
   4   * @author  MCD Application Team\r
   5   * @version V0.3.0\r
   6   * @date    06-March-2015\r
   7   * @brief   Header file of I2C HAL module.\r
   8   ******************************************************************************\r
   9   * @attention\r
  10   *\r
  11   * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>\r
  12   *\r
  13   * Redistribution and use in source and binary forms, with or without modification,\r
  14   * are permitted provided that the following conditions are met:\r
  15   *   1. Redistributions of source code must retain the above copyright notice,\r
  16   *      this list of conditions and the following disclaimer.\r
  17   *   2. Redistributions in binary form must reproduce the above copyright notice,\r
  18   *      this list of conditions and the following disclaimer in the documentation\r
  19   *      and/or other materials provided with the distribution.\r
  20   *   3. Neither the name of STMicroelectronics nor the names of its contributors\r
  21   *      may be used to endorse or promote products derived from this software\r
  22   *      without specific prior written permission.\r
  23   *\r
  24   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"\r
  25   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\r
  26   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\r
  27   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\r
  28   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\r
  29   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\r
  30   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\r
  31   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\r
  32   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\r
  33   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
  34   *\r
  35   ******************************************************************************\r
  36   */ \r
  37 \r
  38 /* Define to prevent recursive inclusion -------------------------------------*/\r
  39 #ifndef __STM32F7xx_HAL_I2C_H\r
  40 #define __STM32F7xx_HAL_I2C_H\r
  41 \r
  42 #ifdef __cplusplus\r
  43  extern "C" {\r
  44 #endif\r
  45 \r
  46 /* Includes ------------------------------------------------------------------*/\r
  47 #include "stm32f7xx_hal_def.h"  \r
  48 \r
  49 /** @addtogroup STM32F7xx_HAL_Driver\r
  50   * @{\r
  51   */\r
  52 \r
  53 /** @addtogroup I2C\r
  54   * @{\r
  55   */ \r
  56 \r
  57 /* Exported types ------------------------------------------------------------*/ \r
  58 /** @defgroup I2C_Exported_Types I2C Exported Types\r
  59   * @{\r
  60   */\r
  61 \r
  62 /** @defgroup I2C_Configuration_Structure_definition I2C Configuration Structure definition\r
  63   * @brief  I2C Configuration Structure definition  \r
  64   * @{\r
  65   */\r
  66 typedef struct\r
  67 {\r
  68   uint32_t Timing;              /*!< Specifies the I2C_TIMINGR_register value.\r
  69                                   This parameter calculated by referring to I2C initialization \r
  70                                          section in Reference manual */\r
  71 \r
  72   uint32_t OwnAddress1;         /*!< Specifies the first device own address.\r
  73                                   This parameter can be a 7-bit or 10-bit address. */\r
  74 \r
  75   uint32_t AddressingMode;      /*!< Specifies if 7-bit or 10-bit addressing mode is selected.\r
  76                                   This parameter can be a value of @ref I2C_addressing_mode */\r
  77 \r
  78   uint32_t DualAddressMode;     /*!< Specifies if dual addressing mode is selected.\r
  79                                   This parameter can be a value of @ref I2C_dual_addressing_mode */\r
  80 \r
  81   uint32_t OwnAddress2;         /*!< Specifies the second device own address if dual addressing mode is selected\r
  82                                   This parameter can be a 7-bit address. */\r
  83 \r
  84   uint32_t OwnAddress2Masks;    /*!< Specifies the acknoledge mask address second device own address if dual addressing mode is selected\r
  85                                   This parameter can be a value of @ref I2C_own_address2_masks */\r
  86 \r
  87   uint32_t GeneralCallMode;     /*!< Specifies if general call mode is selected.\r
  88                                   This parameter can be a value of @ref I2C_general_call_addressing_mode */\r
  89 \r
  90   uint32_t NoStretchMode;       /*!< Specifies if nostretch mode is selected.\r
  91                                   This parameter can be a value of @ref I2C_nostretch_mode */\r
  92 \r
  93 }I2C_InitTypeDef;\r
  94 \r
  95 /** \r
  96   * @}\r
  97   */\r
  98 \r
  99 /** @defgroup HAL_state_structure_definition HAL state structure definition\r
 100   * @brief  HAL State structure definition  \r
 101   * @{\r
 102   */ \r
 103 \r
 104 typedef enum\r
 105 {\r
 106   HAL_I2C_STATE_RESET           = 0x00,  /*!< I2C not yet initialized or disabled         */\r
 107   HAL_I2C_STATE_READY           = 0x01,  /*!< I2C initialized and ready for use           */\r
 108   HAL_I2C_STATE_BUSY            = 0x02,  /*!< I2C internal process is ongoing             */\r
 109   HAL_I2C_STATE_MASTER_BUSY_TX  = 0x12,  /*!< Master Data Transmission process is ongoing */\r
 110   HAL_I2C_STATE_MASTER_BUSY_RX  = 0x22,  /*!< Master Data Reception process is ongoing    */\r
 111   HAL_I2C_STATE_SLAVE_BUSY_TX   = 0x32,  /*!< Slave Data Transmission process is ongoing  */\r
 112   HAL_I2C_STATE_SLAVE_BUSY_RX   = 0x42,  /*!< Slave Data Reception process is ongoing     */\r
 113   HAL_I2C_STATE_MEM_BUSY_TX     = 0x52,  /*!< Memory Data Transmission process is ongoing */\r
 114   HAL_I2C_STATE_MEM_BUSY_RX     = 0x62,  /*!< Memory Data Reception process is ongoing    */\r
 115   HAL_I2C_STATE_TIMEOUT         = 0x03,  /*!< Timeout state                               */\r
 116   HAL_I2C_STATE_ERROR           = 0x04   /*!< Reception process is ongoing                */\r
 117 }HAL_I2C_StateTypeDef;\r
 118 \r
 119 /** \r
 120   * @}\r
 121   */\r
 122 \r
 123 /** @defgroup I2C_Error_Code_definition I2C Error Code definition\r
 124   * @brief  I2C Error Code definition  \r
 125   * @{\r
 126   */ \r
 127 #define HAL_I2C_ERROR_NONE      ((uint32_t)0x00000000)    /*!< No error              */\r
 128 #define HAL_I2C_ERROR_BERR      ((uint32_t)0x00000001)    /*!< BERR error            */\r
 129 #define HAL_I2C_ERROR_ARLO      ((uint32_t)0x00000002)    /*!< ARLO error            */\r
 130 #define HAL_I2C_ERROR_AF        ((uint32_t)0x00000004)    /*!< ACKF error            */\r
 131 #define HAL_I2C_ERROR_OVR       ((uint32_t)0x00000008)    /*!< OVR error             */\r
 132 #define HAL_I2C_ERROR_DMA       ((uint32_t)0x00000010)    /*!< DMA transfer error    */\r
 133 #define HAL_I2C_ERROR_TIMEOUT   ((uint32_t)0x00000020)    /*!< Timeout error         */\r
 134 #define HAL_I2C_ERROR_SIZE      ((uint32_t)0x00000040)    /*!< Size Management error */\r
 135 /** \r
 136   * @}\r
 137   */\r
 138 \r
 139 /** @defgroup I2C_handle_Structure_definition I2C handle Structure definition \r
 140   * @brief  I2C handle Structure definition  \r
 141   * @{\r
 142   */\r
 143 typedef struct\r
 144 {\r
 145   I2C_TypeDef                *Instance;  /*!< I2C registers base address     */\r
 146 \r
 147   I2C_InitTypeDef            Init;       /*!< I2C communication parameters   */\r
 148 \r
 149   uint8_t                    *pBuffPtr;  /*!< Pointer to I2C transfer buffer */\r
 150 \r
 151   uint16_t                   XferSize;   /*!< I2C transfer size              */\r
 152 \r
 153   __IO uint16_t              XferCount;  /*!< I2C transfer counter           */\r
 154 \r
 155   DMA_HandleTypeDef          *hdmatx;    /*!< I2C Tx DMA handle parameters   */\r
 156 \r
 157   DMA_HandleTypeDef          *hdmarx;    /*!< I2C Rx DMA handle parameters   */\r
 158 \r
 159   HAL_LockTypeDef            Lock;       /*!< I2C locking object             */\r
 160 \r
 161   __IO HAL_I2C_StateTypeDef  State;      /*!< I2C communication state        */\r
 162 \r
 163   __IO uint32_t              ErrorCode;  /*!< I2C Error code                   */\r
 164 \r
 165 }I2C_HandleTypeDef;\r
 166 /**\r
 167   * @}\r
 168   */\r
 169 \r
 170 /**\r
 171   * @}\r
 172   */  \r
 173 /* Exported constants --------------------------------------------------------*/\r
 174 \r
 175 /** @defgroup I2C_Exported_Constants I2C Exported Constants\r
 176   * @{\r
 177   */\r
 178 \r
 179 /** @defgroup I2C_addressing_mode I2C addressing mode\r
 180   * @{\r
 181   */\r
 182 #define I2C_ADDRESSINGMODE_7BIT         ((uint32_t)0x00000001)\r
 183 #define I2C_ADDRESSINGMODE_10BIT        ((uint32_t)0x00000002)\r
 184 /**\r
 185   * @}\r
 186   */\r
 187 \r
 188 /** @defgroup I2C_dual_addressing_mode I2C dual addressing mode\r
 189   * @{\r
 190   */\r
 191 #define I2C_DUALADDRESS_DISABLE         ((uint32_t)0x00000000)\r
 192 #define I2C_DUALADDRESS_ENABLE          I2C_OAR2_OA2EN\r
 193 /**\r
 194   * @}\r
 195   */\r
 196 \r
 197 /** @defgroup I2C_own_address2_masks I2C own address2 masks\r
 198   * @{\r
 199   */\r
 200 #define I2C_OA2_NOMASK                  ((uint8_t)0x00)\r
 201 #define I2C_OA2_MASK01                  ((uint8_t)0x01)\r
 202 #define I2C_OA2_MASK02                  ((uint8_t)0x02)\r
 203 #define I2C_OA2_MASK03                  ((uint8_t)0x03)\r
 204 #define I2C_OA2_MASK04                  ((uint8_t)0x04)\r
 205 #define I2C_OA2_MASK05                  ((uint8_t)0x05)\r
 206 #define I2C_OA2_MASK06                  ((uint8_t)0x06)\r
 207 #define I2C_OA2_MASK07                  ((uint8_t)0x07)\r
 208 /**\r
 209   * @}\r
 210   */\r
 211 \r
 212 /** @defgroup I2C_general_call_addressing_mode I2C general call addressing mode\r
 213   * @{\r
 214   */\r
 215 #define I2C_GENERALCALL_DISABLE         ((uint32_t)0x00000000)\r
 216 #define I2C_GENERALCALL_ENABLE          I2C_CR1_GCEN\r
 217 /**\r
 218   * @}\r
 219   */\r
 220 \r
 221 /** @defgroup I2C_nostretch_mode I2C nostretch mode\r
 222   * @{\r
 223   */\r
 224 #define I2C_NOSTRETCH_DISABLE           ((uint32_t)0x00000000)\r
 225 #define I2C_NOSTRETCH_ENABLE            I2C_CR1_NOSTRETCH\r
 226 /**\r
 227   * @}\r
 228   */\r
 229 \r
 230 /** @defgroup I2C_Memory_Address_Size I2C Memory Address Size\r
 231   * @{\r
 232   */\r
 233 #define I2C_MEMADD_SIZE_8BIT            ((uint32_t)0x00000001)\r
 234 #define I2C_MEMADD_SIZE_16BIT           ((uint32_t)0x00000002)\r
 235 /**\r
 236   * @}\r
 237   */  \r
 238   \r
 239 /** @defgroup I2C_ReloadEndMode_definition I2C ReloadEndMode definition\r
 240   * @{\r
 241   */\r
 242 #define  I2C_RELOAD_MODE                I2C_CR2_RELOAD\r
 243 #define  I2C_AUTOEND_MODE               I2C_CR2_AUTOEND\r
 244 #define  I2C_SOFTEND_MODE               ((uint32_t)0x00000000)\r
 245 /**\r
 246   * @}\r
 247   */\r
 248 \r
 249 /** @defgroup I2C_StartStopMode_definition I2C StartStopMode definition\r
 250   * @{\r
 251   */\r
 252 #define  I2C_NO_STARTSTOP               ((uint32_t)0x00000000)\r
 253 #define  I2C_GENERATE_STOP              I2C_CR2_STOP\r
 254 #define  I2C_GENERATE_START_READ        (uint32_t)(I2C_CR2_START | I2C_CR2_RD_WRN)\r
 255 #define  I2C_GENERATE_START_WRITE       I2C_CR2_START\r
 256 /**\r
 257   * @}\r
 258   */\r
 259 \r
 260 /** @defgroup I2C_Interrupt_configuration_definition I2C Interrupt configuration definition\r
 261   * @brief I2C Interrupt definition\r
 262   *        Elements values convention: 0xXXXXXXXX\r
 263   *           - XXXXXXXX  : Interrupt control mask\r
 264   * @{\r
 265   */\r
 266 #define I2C_IT_ERRI                     I2C_CR1_ERRIE\r
 267 #define I2C_IT_TCI                      I2C_CR1_TCIE\r
 268 #define I2C_IT_STOPI                    I2C_CR1_STOPIE\r
 269 #define I2C_IT_NACKI                    I2C_CR1_NACKIE\r
 270 #define I2C_IT_ADDRI                    I2C_CR1_ADDRIE\r
 271 #define I2C_IT_RXI                      I2C_CR1_RXIE\r
 272 #define I2C_IT_TXI                      I2C_CR1_TXIE\r
 273 \r
 274 /**\r
 275   * @}\r
 276   */\r
 277 \r
 278 /** @defgroup I2C_Flag_definition I2C Flag definition\r
 279   * @{\r
 280   */ \r
 281 #define I2C_FLAG_TXE                    I2C_ISR_TXE\r
 282 #define I2C_FLAG_TXIS                   I2C_ISR_TXIS\r
 283 #define I2C_FLAG_RXNE                   I2C_ISR_RXNE\r
 284 #define I2C_FLAG_ADDR                   I2C_ISR_ADDR\r
 285 #define I2C_FLAG_AF                     I2C_ISR_NACKF\r
 286 #define I2C_FLAG_STOPF                  I2C_ISR_STOPF\r
 287 #define I2C_FLAG_TC                     I2C_ISR_TC\r
 288 #define I2C_FLAG_TCR                    I2C_ISR_TCR\r
 289 #define I2C_FLAG_BERR                   I2C_ISR_BERR\r
 290 #define I2C_FLAG_ARLO                   I2C_ISR_ARLO\r
 291 #define I2C_FLAG_OVR                    I2C_ISR_OVR\r
 292 #define I2C_FLAG_PECERR                 I2C_ISR_PECERR\r
 293 #define I2C_FLAG_TIMEOUT                I2C_ISR_TIMEOUT\r
 294 #define I2C_FLAG_ALERT                  I2C_ISR_ALERT\r
 295 #define I2C_FLAG_BUSY                   I2C_ISR_BUSY\r
 296 #define I2C_FLAG_DIR                    I2C_ISR_DIR\r
 297 /**\r
 298   * @}\r
 299   */\r
 300 \r
 301 /**\r
 302   * @}\r
 303   */\r
 304 \r
 305 /* Exported macros -----------------------------------------------------------*/\r
 306   \r
 307 /** @defgroup I2C_Exported_Macros I2C Exported Macros\r
 308   * @{\r
 309   */\r
 310 \r
 311 /** @brief Reset I2C handle state\r
 312   * @param  __HANDLE__: specifies the I2C Handle.\r
 313   * @retval None\r
 314   */\r
 315 #define __HAL_I2C_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_I2C_STATE_RESET)\r
 316 \r
 317 /** @brief  Enable the specified I2C interrupts.\r
 318   * @param  __HANDLE__: specifies the I2C Handle.\r
 319   * @param  __INTERRUPT__: specifies the interrupt source to enable.\r
 320   *        This parameter can be one of the following values:\r
 321   *            @arg I2C_IT_ERRI: Errors interrupt enable\r
 322   *            @arg I2C_IT_TCI: Transfer complete interrupt enable\r
 323   *            @arg I2C_IT_STOPI: STOP detection interrupt enable\r
 324   *            @arg I2C_IT_NACKI: NACK received interrupt enable\r
 325   *            @arg I2C_IT_ADDRI: Address match interrupt enable\r
 326   *            @arg I2C_IT_RXI: RX interrupt enable\r
 327   *            @arg I2C_IT_TXI: TX interrupt enable\r
 328   *   \r
 329   * @retval None\r
 330   */\r
 331   \r
 332 #define __HAL_I2C_ENABLE_IT(__HANDLE__, __INTERRUPT__)   ((__HANDLE__)->Instance->CR1 |= (__INTERRUPT__))\r
 333 \r
 334 /** @brief  Disable the specified I2C interrupts.\r
 335   * @param  __HANDLE__: specifies the I2C Handle.\r
 336   * @param  __INTERRUPT__: specifies the interrupt source to disable.\r
 337   *        This parameter can be one of the following values:\r
 338   *            @arg I2C_IT_ERRI: Errors interrupt enable\r
 339   *            @arg I2C_IT_TCI: Transfer complete interrupt enable\r
 340   *            @arg I2C_IT_STOPI: STOP detection interrupt enable\r
 341   *            @arg I2C_IT_NACKI: NACK received interrupt enable\r
 342   *            @arg I2C_IT_ADDRI: Address match interrupt enable\r
 343   *            @arg I2C_IT_RXI: RX interrupt enable\r
 344   *            @arg I2C_IT_TXI: TX interrupt enable\r
 345   *   \r
 346   * @retval None\r
 347   */\r
 348 #define __HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__)  ((__HANDLE__)->Instance->CR1 &= (~(__INTERRUPT__)))\r
 349  \r
 350 /** @brief  Checks if the specified I2C interrupt source is enabled or disabled.\r
 351   * @param  __HANDLE__: specifies the I2C Handle.\r
 352   * @param  __INTERRUPT__: specifies the I2C interrupt source to check.\r
 353   *          This parameter can be one of the following values:\r
 354   *            @arg I2C_IT_ERRI: Errors interrupt enable\r
 355   *            @arg I2C_IT_TCI: Transfer complete interrupt enable\r
 356   *            @arg I2C_IT_STOPI: STOP detection interrupt enable\r
 357   *            @arg I2C_IT_NACKI: NACK received interrupt enable\r
 358   *            @arg I2C_IT_ADDRI: Address match interrupt enable\r
 359   *            @arg I2C_IT_RXI: RX interrupt enable\r
 360   *            @arg I2C_IT_TXI: TX interrupt enable\r
 361   *   \r
 362   * @retval The new state of __INTERRUPT__ (TRUE or FALSE).\r
 363   */\r
 364 #define __HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->CR1 & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)\r
 365 \r
 366 /** @brief  Checks whether the specified I2C flag is set or not.\r
 367   * @param  __HANDLE__: specifies the I2C Handle.\r
 368   * @param  __FLAG__: specifies the flag to check.\r
 369   *        This parameter can be one of the following values:\r
 370   *            @arg I2C_FLAG_TXE:      Transmit data register empty\r
 371   *            @arg I2C_FLAG_TXIS:     Transmit interrupt status\r
 372   *            @arg I2C_FLAG_RXNE:     Receive data register not empty\r
 373   *            @arg I2C_FLAG_ADDR:     Address matched (slave mode)\r
 374   *            @arg I2C_FLAG_AF:       Acknowledge failure received flag\r
 375   *            @arg I2C_FLAG_STOPF:    STOP detection flag\r
 376   *            @arg I2C_FLAG_TC:       Transfer complete (master mode)\r
 377   *            @arg I2C_FLAG_TCR:      Transfer complete reload\r
 378   *            @arg I2C_FLAG_BERR:     Bus error\r
 379   *            @arg I2C_FLAG_ARLO:     Arbitration lost\r
 380   *            @arg I2C_FLAG_OVR:      Overrun/Underrun\r
 381   *            @arg I2C_FLAG_PECERR:   PEC error in reception\r
 382   *            @arg I2C_FLAG_TIMEOUT:  Timeout or Tlow detection flag \r
 383   *            @arg I2C_FLAG_ALERT:    SMBus alert\r
 384   *            @arg I2C_FLAG_BUSY:     Bus busy\r
 385   *            @arg I2C_FLAG_DIR:      Transfer direction (slave mode)\r
 386   *\r
 387   * @retval The new state of __FLAG__ (TRUE or FALSE).\r
 388   */\r
 389 #define I2C_FLAG_MASK  ((uint32_t)0x0001FFFF)\r
 390 #define __HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & ((__FLAG__) & I2C_FLAG_MASK)) == ((__FLAG__) & I2C_FLAG_MASK)))\r
 391 \r
 392 /** @brief  Clears the I2C pending flags which are cleared by writing 1 in a specific bit.\r
 393   * @param  __HANDLE__: specifies the I2C Handle.\r
 394   * @param  __FLAG__: specifies the flag to clear.\r
 395   *          This parameter can be any combination of the following values:\r
 396   *            @arg I2C_FLAG_ADDR:    Address matched (slave mode)\r
 397   *            @arg I2C_FLAG_AF:      Acknowledge failure received flag\r
 398   *            @arg I2C_FLAG_STOPF:   STOP detection flag\r
 399   *            @arg I2C_FLAG_BERR:    Bus error\r
 400   *            @arg I2C_FLAG_ARLO:    Arbitration lost\r
 401   *            @arg I2C_FLAG_OVR:     Overrun/Underrun            \r
 402   *            @arg I2C_FLAG_PECERR:  PEC error in reception\r
 403   *            @arg I2C_FLAG_TIMEOUT: Timeout or Tlow detection flag \r
 404   *            @arg I2C_FLAG_ALERT:   SMBus alert\r
 405   *   \r
 406   * @retval None\r
 407   */\r
 408 #define __HAL_I2C_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = ((__FLAG__) & I2C_FLAG_MASK))\r
 409  \r
 410 /** @brief  Enable the specified I2C peripheral.\r
 411   * @param  __HANDLE__: specifies the I2C Handle. \r
 412   * @retval None\r
 413   */\r
 414 #define __HAL_I2C_ENABLE(__HANDLE__)                            (SET_BIT((__HANDLE__)->Instance->CR1,  I2C_CR1_PE))\r
 415 \r
 416 /** @brief  Disable the specified I2C peripheral.\r
 417   * @param  __HANDLE__: specifies the I2C Handle. \r
 418   * @retval None\r
 419   */\r
 420 #define __HAL_I2C_DISABLE(__HANDLE__)                           (CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))\r
 421 \r
 422 /**\r
 423   * @}\r
 424   */ \r
 425 \r
 426 /* Include I2C HAL Extension module */\r
 427 #include "stm32f7xx_hal_i2c_ex.h"\r
 428 \r
 429 /* Exported functions --------------------------------------------------------*/\r
 430 /** @addtogroup I2C_Exported_Functions\r
 431   * @{\r
 432   */\r
 433 \r
 434 /** @addtogroup I2C_Exported_Functions_Group1 Initialization and de-initialization functions\r
 435   * @{\r
 436   */\r
 437 /* Initialization and de-initialization functions******************************/\r
 438 HAL_StatusTypeDef HAL_I2C_Init(I2C_HandleTypeDef *hi2c);\r
 439 HAL_StatusTypeDef HAL_I2C_DeInit (I2C_HandleTypeDef *hi2c);\r
 440 void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c);\r
 441 void HAL_I2C_MspDeInit(I2C_HandleTypeDef *hi2c);\r
 442 /**\r
 443   * @}\r
 444   */ \r
 445 \r
 446 /** @addtogroup I2C_Exported_Functions_Group2 Input and Output operation functions\r
 447   * @{\r
 448   */\r
 449 /* IO operation functions  ****************************************************/\r
 450  /******* Blocking mode: Polling */\r
 451 HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);\r
 452 HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);\r
 453 HAL_StatusTypeDef HAL_I2C_Slave_Transmit(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);\r
 454 HAL_StatusTypeDef HAL_I2C_Slave_Receive(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);\r
 455 HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);\r
 456 HAL_StatusTypeDef HAL_I2C_Mem_Read(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);\r
 457 HAL_StatusTypeDef HAL_I2C_IsDeviceReady(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Trials, uint32_t Timeout);\r
 458 \r
 459  /******* Non-Blocking mode: Interrupt */\r
 460 HAL_StatusTypeDef HAL_I2C_Master_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);\r
 461 HAL_StatusTypeDef HAL_I2C_Master_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);\r
 462 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);\r
 463 HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);\r
 464 HAL_StatusTypeDef HAL_I2C_Mem_Write_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);\r
 465 HAL_StatusTypeDef HAL_I2C_Mem_Read_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);\r
 466 \r
 467  /******* Non-Blocking mode: DMA */\r
 468 HAL_StatusTypeDef HAL_I2C_Master_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);\r
 469 HAL_StatusTypeDef HAL_I2C_Master_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);\r
 470 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);\r
 471 HAL_StatusTypeDef HAL_I2C_Slave_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);\r
 472 HAL_StatusTypeDef HAL_I2C_Mem_Write_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);\r
 473 HAL_StatusTypeDef HAL_I2C_Mem_Read_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);\r
 474 /**\r
 475   * @}\r
 476   */ \r
 477 \r
 478 /** @addtogroup IRQ_Handler_and_Callbacks IRQ Handler and Callbacks\r
 479  * @{\r
 480  */   \r
 481 /******* I2C IRQHandler and Callbacks used in non blocking modes (Interrupt and DMA) */\r
 482 void HAL_I2C_EV_IRQHandler(I2C_HandleTypeDef *hi2c);\r
 483 void HAL_I2C_ER_IRQHandler(I2C_HandleTypeDef *hi2c);\r
 484 void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c);\r
 485 void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c);\r
 486 void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c);\r
 487 void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c);\r
 488 void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c);\r
 489 void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c);\r
 490 void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c);\r
 491 /**\r
 492   * @}\r
 493   */ \r
 494 \r
 495 /** @addtogroup I2C_Exported_Functions_Group3 Peripheral State and Errors functions\r
 496   * @{\r
 497   */\r
 498 /* Peripheral State and Errors functions  *************************************/\r
 499 HAL_I2C_StateTypeDef HAL_I2C_GetState(I2C_HandleTypeDef *hi2c);\r
 500 uint32_t             HAL_I2C_GetError(I2C_HandleTypeDef *hi2c);\r
 501 \r
 502 /**\r
 503   * @}\r
 504   */ \r
 505 \r
 506 /**\r
 507   * @}\r
 508   */ \r
 509   \r
 510 /* Private constants ---------------------------------------------------------*/\r
 511 /** @defgroup I2C_Private_Constants I2C Private Constants\r
 512   * @{\r
 513   */\r
 514 \r
 515 /**\r
 516   * @}\r
 517   */ \r
 518 \r
 519 /* Private macros ------------------------------------------------------------*/\r
 520 /** @defgroup I2C_Private_Macro I2C Private Macros\r
 521   * @{\r
 522   */\r
 523 \r
 524 #define IS_I2C_ADDRESSING_MODE(MODE)    (((MODE) == I2C_ADDRESSINGMODE_7BIT) || \\r
 525                                           ((MODE) == I2C_ADDRESSINGMODE_10BIT))\r
 526 \r
 527 #define IS_I2C_DUAL_ADDRESS(ADDRESS)    (((ADDRESS) == I2C_DUALADDRESS_DISABLE) || \\r
 528                                           ((ADDRESS) == I2C_DUALADDRESS_ENABLE))\r
 529 \r
 530 #define IS_I2C_OWN_ADDRESS2_MASK(MASK)  (((MASK) == I2C_OA2_NOMASK)  || \\r
 531                                           ((MASK) == I2C_OA2_MASK01) || \\r
 532                                           ((MASK) == I2C_OA2_MASK02) || \\r
 533                                           ((MASK) == I2C_OA2_MASK03) || \\r
 534                                           ((MASK) == I2C_OA2_MASK04) || \\r
 535                                           ((MASK) == I2C_OA2_MASK05) || \\r
 536                                           ((MASK) == I2C_OA2_MASK06) || \\r
 537                                           ((MASK) == I2C_OA2_MASK07))  \r
 538 \r
 539 #define IS_I2C_GENERAL_CALL(CALL)       (((CALL) == I2C_GENERALCALL_DISABLE) || \\r
 540                                           ((CALL) == I2C_GENERALCALL_ENABLE))\r
 541 \r
 542 #define IS_I2C_NO_STRETCH(STRETCH)      (((STRETCH) == I2C_NOSTRETCH_DISABLE) || \\r
 543                                           ((STRETCH) == I2C_NOSTRETCH_ENABLE))\r
 544 \r
 545 #define IS_I2C_MEMADD_SIZE(SIZE)        (((SIZE) == I2C_MEMADD_SIZE_8BIT) || \\r
 546                                           ((SIZE) == I2C_MEMADD_SIZE_16BIT))\r
 547                               \r
 548 \r
 549 #define IS_TRANSFER_MODE(MODE)          (((MODE) == I2C_RELOAD_MODE)   || \\r
 550                                           ((MODE) == I2C_AUTOEND_MODE) || \\r
 551                                           ((MODE) == I2C_SOFTEND_MODE))\r
 552 \r
 553 #define IS_TRANSFER_REQUEST(REQUEST)    (((REQUEST) == I2C_GENERATE_STOP)         || \\r
 554                                           ((REQUEST) == I2C_GENERATE_START_READ)  || \\r
 555                                           ((REQUEST) == I2C_GENERATE_START_WRITE) || \\r
 556                                           ((REQUEST) == I2C_NO_STARTSTOP))\r
 557                                \r
 558 \r
 559 #define I2C_RESET_CR2(__HANDLE__)       ((__HANDLE__)->Instance->CR2 &= (uint32_t)~((uint32_t)(I2C_CR2_SADD | I2C_CR2_HEAD10R | I2C_CR2_NBYTES | I2C_CR2_RELOAD | I2C_CR2_RD_WRN)))\r
 560 \r
 561 #define IS_I2C_OWN_ADDRESS1(ADDRESS1)   ((ADDRESS1) <= (uint32_t)0x000003FF)\r
 562 #define IS_I2C_OWN_ADDRESS2(ADDRESS2)   ((ADDRESS2) <= (uint16_t)0x00FF)\r
 563 \r
 564 #define I2C_MEM_ADD_MSB(__ADDRESS__)    ((uint8_t)((uint16_t)(((uint16_t)((__ADDRESS__) & (uint16_t)(0xFF00))) >> 8)))\r
 565 #define I2C_MEM_ADD_LSB(__ADDRESS__)    ((uint8_t)((uint16_t)((__ADDRESS__) & (uint16_t)(0x00FF))))\r
 566 \r
 567 #define I2C_GENERATE_START(__ADDMODE__,__ADDRESS__)   (((__ADDMODE__) == I2C_ADDRESSINGMODE_7BIT) ? (uint32_t)((((uint32_t)(__ADDRESS__) & (I2C_CR2_SADD)) | (I2C_CR2_START) | (I2C_CR2_AUTOEND)) & (~I2C_CR2_RD_WRN)) : \\r
 568                                                           (uint32_t)((((uint32_t)(__ADDRESS__) & (I2C_CR2_SADD)) | (I2C_CR2_ADD10) | (I2C_CR2_START)) & (~I2C_CR2_RD_WRN)))\r
 569 /**\r
 570   * @}\r
 571   */ \r
 572 \r
 573 /* Private Functions ---------------------------------------------------------*/\r
 574 /** @defgroup I2C_Private_Functions I2C Private Functions\r
 575   * @{\r
 576   */\r
 577 /* Private functions are defined in stm32f7xx_hal_i2c.c file */\r
 578 /**\r
 579   * @}\r
 580   */ \r
 581 \r
 582 /**\r
 583   * @}\r
 584   */ \r
 585 \r
 586 /**\r
 587   * @}\r
 588   */ \r
 589   \r
 590 #ifdef __cplusplus\r
 591 }\r
 592 #endif\r
 593 \r
 594 \r
 595 #endif /* __STM32F7xx_HAL_I2C_H */\r
 596 \r
 597 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/\r
 598 \r