PageRenderTime 47ms CodeModel.GetById 20ms RepoModel.GetById 0ms app.codeStats 0ms

/hal/targets/cmsis/TARGET_STM/TARGET_STM32F0/stm32f0xx_hal_i2c_ex.h

https://gitlab.com/YaoQ/mbed-for-linknode
C Header | 234 lines | 95 code | 30 blank | 109 comment | 80 complexity | ec32536c6790c6fa3e0e4479609c010c MD5 | raw file
    

  1. /**
    2. 

  2.   ******************************************************************************
    3. 

  3.   * @file    stm32f0xx_hal_i2c_ex.h
    4. 

  4.   * @author  MCD Application Team
    5. 

  5.   * @version V1.4.0
    6. 

  6.   * @date    27-May-2016
    7. 

  7.   * @brief   Header file of I2C HAL Extended module.
    8. 

  8.   ******************************************************************************
    9. 

  9.   * @attention
    10. 

  10.   *
    11. 

  11.   * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
    12. 

  12.   *
    13. 

  13.   * Redistribution and use in source and binary forms, with or without modification,
    14. 

  14.   * are permitted provided that the following conditions are met:
    15. 

  15.   *   1. Redistributions of source code must retain the above copyright notice,
    16. 

  16.   *      this list of conditions and the following disclaimer.
    17. 

  17.   *   2. Redistributions in binary form must reproduce the above copyright notice,
    18. 

  18.   *      this list of conditions and the following disclaimer in the documentation
    19. 

  19.   *      and/or other materials provided with the distribution.
    20. 

  20.   *   3. Neither the name of STMicroelectronics nor the names of its contributors
    21. 

  21.   *      may be used to endorse or promote products derived from this software
    22. 

  22.   *      without specific prior written permission.
    23. 

  23.   *
    24. 

  24.   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    25. 

  25.   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    26. 

  26.   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    27. 

  27.   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
    28. 

  28.   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    29. 

  29.   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
    30. 

  30.   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
    31. 

  31.   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    32. 

  32.   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    33. 

  33.   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    34. 

  34.   *
    35. 

  35.   ******************************************************************************
    36. 

  36.   */ 
    37. 

  37. 

  38. /* Define to prevent recursive inclusion -------------------------------------*/
    39. 

  39. #ifndef __STM32F0xx_HAL_I2C_EX_H
    40. 

  40. #define __STM32F0xx_HAL_I2C_EX_H
    41. 

  41. 

  42. #ifdef __cplusplus
    43. 

  43.  extern "C" {
    44. 

  44. #endif
    45. 

  45. 

  46. /* Includes ------------------------------------------------------------------*/
    47. 

  47. #include "stm32f0xx_hal_def.h"  
    48. 

  48. 

  49. /** @addtogroup STM32F0xx_HAL_Driver
    50. 

  50.   * @{
    51. 

  51.   */
    52. 

  52. 

  53. /** @addtogroup I2CEx
    54. 

  54.   * @{
    55. 

  55.   */ 
    56. 

  56. 

  57. /* Exported types ------------------------------------------------------------*/ 
    58. 

  58. /* Exported constants --------------------------------------------------------*/
    59. 

  59. 

  60. /** @defgroup I2CEx_Exported_Constants I2C Extended Exported Constants
    61. 

  61.   * @{
    62. 

  62.   */
    63. 

  63. 

  64. /** @defgroup I2CEx_Analog_Filter I2C Extended Analog Filter
    65. 

  65.   * @{
    66. 

  66.   */
    67. 

  67. #define I2C_ANALOGFILTER_ENABLE         (0x00000000U)
    68. 

  68. #define I2C_ANALOGFILTER_DISABLE        I2C_CR1_ANFOFF
    69. 

  69. /**
    70. 

  70.   * @}
    71. 

  71.   */
    72. 

  72. 

  73. /** @defgroup I2CEx_FastModePlus I2CEx Fast Mode Plus
    74. 

  74.   * @{
    75. 

  75.   */
    76. 

  76. #if defined(STM32F091xC) || defined(STM32F098xx) || defined(STM32F042x6) || defined(STM32F048xx)
    77. 

  77. #define I2C_FASTMODEPLUS_PA9            SYSCFG_CFGR1_I2C_FMP_PA9  /*!< Enable Fast Mode Plus on PA9       */
    78. 

  78. #define I2C_FASTMODEPLUS_PA10           SYSCFG_CFGR1_I2C_FMP_PA10 /*!< Enable Fast Mode Plus on PA10      */
    79. 

  79. #define I2C_FASTMODEPLUS_PB6            SYSCFG_CFGR1_I2C_FMP_PB6  /*!< Enable Fast Mode Plus on PB6       */
    80. 

  80. #define I2C_FASTMODEPLUS_PB7            SYSCFG_CFGR1_I2C_FMP_PB7  /*!< Enable Fast Mode Plus on PB7       */
    81. 

  81. #define I2C_FASTMODEPLUS_PB8            SYSCFG_CFGR1_I2C_FMP_PB8  /*!< Enable Fast Mode Plus on PB8       */
    82. 

  82. #define I2C_FASTMODEPLUS_PB9            SYSCFG_CFGR1_I2C_FMP_PB9  /*!< Enable Fast Mode Plus on PB9       */
    83. 

  83. #define I2C_FASTMODEPLUS_I2C1           SYSCFG_CFGR1_I2C_FMP_I2C1 /*!< Enable Fast Mode Plus on I2C1 pins */
    84. 

  84. #define I2C_FASTMODEPLUS_I2C2           SYSCFG_CFGR1_I2C_FMP_I2C2 /*!< Enable Fast Mode Plus on I2C2 pins */
    85. 

  85. #elif defined(STM32F071xB) || defined(STM32F072xB) || defined(STM32F078xx)
    86. 

  86. #define I2C_FASTMODEPLUS_PB6            SYSCFG_CFGR1_I2C_FMP_PB6  /*!< Enable Fast Mode Plus on PB6       */
    87. 

  87. #define I2C_FASTMODEPLUS_PB7            SYSCFG_CFGR1_I2C_FMP_PB7  /*!< Enable Fast Mode Plus on PB7       */
    88. 

  88. #define I2C_FASTMODEPLUS_PB8            SYSCFG_CFGR1_I2C_FMP_PB8  /*!< Enable Fast Mode Plus on PB8       */
    89. 

  89. #define I2C_FASTMODEPLUS_PB9            SYSCFG_CFGR1_I2C_FMP_PB9  /*!< Enable Fast Mode Plus on PB9       */
    90. 

  90. #define I2C_FASTMODEPLUS_I2C1           SYSCFG_CFGR1_I2C_FMP_I2C1 /*!< Enable Fast Mode Plus on I2C1 pins */
    91. 

  91. #define I2C_FASTMODEPLUS_I2C2           SYSCFG_CFGR1_I2C_FMP_I2C2 /*!< Enable Fast Mode Plus on I2C2 pins */
    92. 

  92. #elif defined(STM32F030x6) || defined(STM32F031x6) || defined(STM32F038xx) || defined(STM32F070x6) || defined(STM32F030xC)
    93. 

  93. #define I2C_FASTMODEPLUS_PA9            SYSCFG_CFGR1_I2C_FMP_PA9  /*!< Enable Fast Mode Plus on PA9       */
    94. 

  94. #define I2C_FASTMODEPLUS_PA10           SYSCFG_CFGR1_I2C_FMP_PA10 /*!< Enable Fast Mode Plus on PA10      */
    95. 

  95. #define I2C_FASTMODEPLUS_PB6            SYSCFG_CFGR1_I2C_FMP_PB6  /*!< Enable Fast Mode Plus on PB6       */
    96. 

  96. #define I2C_FASTMODEPLUS_PB7            SYSCFG_CFGR1_I2C_FMP_PB7  /*!< Enable Fast Mode Plus on PB7       */
    97. 

  97. #define I2C_FASTMODEPLUS_PB8            SYSCFG_CFGR1_I2C_FMP_PB8  /*!< Enable Fast Mode Plus on PB8       */
    98. 

  98. #define I2C_FASTMODEPLUS_PB9            SYSCFG_CFGR1_I2C_FMP_PB9  /*!< Enable Fast Mode Plus on PB9       */
    99. 

  99. #define I2C_FASTMODEPLUS_I2C1           SYSCFG_CFGR1_I2C_FMP_I2C1 /*!< Enable Fast Mode Plus on I2C1 pins */
    100. 

  100. #elif defined(STM32F070xB)
    101. 

  101. #define I2C_FASTMODEPLUS_PB6            SYSCFG_CFGR1_I2C_FMP_PB6  /*!< Enable Fast Mode Plus on PB6       */
    102. 

  102. #define I2C_FASTMODEPLUS_PB7            SYSCFG_CFGR1_I2C_FMP_PB7  /*!< Enable Fast Mode Plus on PB7       */
    103. 

  103. #define I2C_FASTMODEPLUS_PB8            SYSCFG_CFGR1_I2C_FMP_PB8  /*!< Enable Fast Mode Plus on PB8       */
    104. 

  104. #define I2C_FASTMODEPLUS_PB9            SYSCFG_CFGR1_I2C_FMP_PB9  /*!< Enable Fast Mode Plus on PB9       */
    105. 

  105. #define I2C_FASTMODEPLUS_I2C1           SYSCFG_CFGR1_I2C_FMP_I2C1 /*!< Enable Fast Mode Plus on I2C1 pins */
    106. 

  106. #else /* defined(STM32F030x8) || defined(STM32F051xx) || defined(STM32F058xx) */
    107. 

  107. #define I2C_FASTMODEPLUS_PB6            SYSCFG_CFGR1_I2C_FMP_PB6  /*!< Enable Fast Mode Plus on PB6       */
    108. 

  108. #define I2C_FASTMODEPLUS_PB7            SYSCFG_CFGR1_I2C_FMP_PB7  /*!< Enable Fast Mode Plus on PB7       */
    109. 

  109. #define I2C_FASTMODEPLUS_PB8            SYSCFG_CFGR1_I2C_FMP_PB8  /*!< Enable Fast Mode Plus on PB8       */
    110. 

  110. #define I2C_FASTMODEPLUS_PB9            SYSCFG_CFGR1_I2C_FMP_PB9  /*!< Enable Fast Mode Plus on PB9       */
    111. 

  111. #endif
    112. 

  112. /**
    113. 

  113.   * @}
    114. 

  114.   */
    115. 

  115.     
    116. 

  116. /**
    117. 

  117.   * @}
    118. 

  118.   */ 
    119. 

  119.   
    120. 

  120. /* Exported macro ------------------------------------------------------------*/
    121. 

  121. /* Exported functions --------------------------------------------------------*/
    122. 

  122. 

  123. /** @addtogroup I2CEx_Exported_Functions I2C Extended Exported Functions
    124. 

  124.   * @{
    125. 

  125.   */
    126. 

  126. 

  127. /** @addtogroup I2CEx_Exported_Functions_Group1 Extended features functions
    128. 

  128.   * @brief    Extended features functions
    129. 

  129.   * @{
    130. 

  130.   */
    131. 

  131.   
    132. 

  132. /* Peripheral Control functions  ************************************************/
    133. 

  133. HAL_StatusTypeDef HAL_I2CEx_ConfigAnalogFilter(I2C_HandleTypeDef *hi2c, uint32_t AnalogFilter);
    134. 

  134. HAL_StatusTypeDef HAL_I2CEx_ConfigDigitalFilter(I2C_HandleTypeDef *hi2c, uint32_t DigitalFilter);
    135. 

  135. #if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC) 
    136. 

  136. HAL_StatusTypeDef HAL_I2CEx_EnableWakeUp (I2C_HandleTypeDef *hi2c);
    137. 

  137. HAL_StatusTypeDef HAL_I2CEx_DisableWakeUp (I2C_HandleTypeDef *hi2c);
    138. 

  138. #endif /* !(STM32F030x6) && !(STM32F030x8) && !(STM32F070x6) && !(STM32F070xB) && !(STM32F030xC)  */
    139. 

  139. void HAL_I2CEx_EnableFastModePlus(uint32_t ConfigFastModePlus);
    140. 

  140. void HAL_I2CEx_DisableFastModePlus(uint32_t ConfigFastModePlus);
    141. 

  141. 

  142. /* Private constants ---------------------------------------------------------*/
    143. 

  143. /** @defgroup I2C_Private_Constants I2C Private Constants
    144. 

  144.   * @{
    145. 

  145.   */
    146. 

  146. 

  147. /**
    148. 

  148.   * @}
    149. 

  149.   */ 
    150. 

  150. 

  151. /* Private macros ------------------------------------------------------------*/
    152. 

  152. /** @defgroup I2C_Private_Macro I2C Private Macros
    153. 

  153.   * @{
    154. 

  154.   */
    155. 

  155. #define IS_I2C_ANALOG_FILTER(FILTER)    (((FILTER) == I2C_ANALOGFILTER_ENABLE) || \
    156. 

  156.                                          ((FILTER) == I2C_ANALOGFILTER_DISABLE))
    157. 

  157. 

  158. #define IS_I2C_DIGITAL_FILTER(FILTER)   ((FILTER) <= 0x0000000FU)
    159. 

  159. 

  160. #if defined(STM32F091xC) || defined(STM32F098xx) || defined(STM32F042x6) || defined(STM32F048xx)
    161. 

  161. #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & (I2C_FASTMODEPLUS_PA9)) == I2C_FASTMODEPLUS_PA9)   || \
    162. 

  162.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PA10)) == I2C_FASTMODEPLUS_PA10) || \
    163. 

  163.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB6)) == I2C_FASTMODEPLUS_PB6)   || \
    164. 

  164.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB7)) == I2C_FASTMODEPLUS_PB7)   || \
    165. 

  165.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB8)) == I2C_FASTMODEPLUS_PB8)   || \
    166. 

  166.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB9)) == I2C_FASTMODEPLUS_PB9)   || \
    167. 

  167.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C1)) == I2C_FASTMODEPLUS_I2C1) || \
    168. 

  168.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C2)) == I2C_FASTMODEPLUS_I2C2))
    169. 

  169. #elif defined(STM32F071xB) || defined(STM32F072xB) || defined(STM32F078xx)
    170. 

  170. #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & (I2C_FASTMODEPLUS_PB6)) == I2C_FASTMODEPLUS_PB6)   || \
    171. 

  171.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB7)) == I2C_FASTMODEPLUS_PB7)   || \
    172. 

  172.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB8)) == I2C_FASTMODEPLUS_PB8)   || \
    173. 

  173.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB9)) == I2C_FASTMODEPLUS_PB9)   || \
    174. 

  174.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C1)) == I2C_FASTMODEPLUS_I2C1) || \
    175. 

  175.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C2)) == I2C_FASTMODEPLUS_I2C2))
    176. 

  176. #elif defined(STM32F030x6) || defined(STM32F031x6) || defined(STM32F038xx) || defined(STM32F070x6) || defined(STM32F030xC)
    177. 

  177. #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & (I2C_FASTMODEPLUS_PA9)) == I2C_FASTMODEPLUS_PA9)   || \
    178. 

  178.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PA10)) == I2C_FASTMODEPLUS_PA10) || \
    179. 

  179.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB6)) == I2C_FASTMODEPLUS_PB6)   || \
    180. 

  180.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB7)) == I2C_FASTMODEPLUS_PB7)   || \
    181. 

  181.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB8)) == I2C_FASTMODEPLUS_PB8)   || \
    182. 

  182.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB9)) == I2C_FASTMODEPLUS_PB9)   || \
    183. 

  183.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C1)) == I2C_FASTMODEPLUS_I2C1))
    184. 

  184. #elif defined(STM32F070xB)
    185. 

  185. #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & (I2C_FASTMODEPLUS_PB6)) == I2C_FASTMODEPLUS_PB6)   || \
    186. 

  186.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB7)) == I2C_FASTMODEPLUS_PB7)   || \
    187. 

  187.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB8)) == I2C_FASTMODEPLUS_PB8)   || \
    188. 

  188.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB9)) == I2C_FASTMODEPLUS_PB9)   || \
    189. 

  189.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C1)) == I2C_FASTMODEPLUS_I2C1))
    190. 

  190. #else /* defined(STM32F030x8) || defined(STM32F051xx) || defined(STM32F058xx) */
    191. 

  191. #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & (I2C_FASTMODEPLUS_PB6)) == I2C_FASTMODEPLUS_PB6)   || \
    192. 

  192.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB7)) == I2C_FASTMODEPLUS_PB7)   || \
    193. 

  193.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB8)) == I2C_FASTMODEPLUS_PB8)   || \
    194. 

  194.                                          (((__CONFIG__) & (I2C_FASTMODEPLUS_PB9)) == I2C_FASTMODEPLUS_PB9))
    195. 

  195. #endif
    196. 

  196. /**
    197. 

  197.   * @}
    198. 

  198.   */
    199. 

  199.   
    200. 

  200. /* Private Functions ---------------------------------------------------------*/
    201. 

  201. /** @defgroup I2C_Private_Functions I2C Private Functions
    202. 

  202.   * @{
    203. 

  203.   */ 
    204. 

  204. /* Private functions are defined in stm32f0xx_hal_i2c_ex.c file */
    205. 

  205. /**
    206. 

  206.   * @}
    207. 

  207.   */   
    208. 

  208. 

  209. /**
    210. 

  210.   * @}
    211. 

  211.   */
    212. 

  212. 

  213. /**
    214. 

  214.   * @}
    215. 

  215.   */
    216. 

  216. 

  217. /**
    218. 

  218.   * @}
    219. 

  219.   */
    220. 

  220. 

  221. /**
    222. 

  222.   * @}
    223. 

  223.   */
    224. 

  224. 

  225. 

  226. #ifdef __cplusplus
    227. 

  227. }
    228. 

  228. #endif
    229. 

  229. 

  230. #endif /* __STM32F0xx_HAL_I2C_EX_H */
    231. 

  231. 

  232. 

  233. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
    234. 

  234. 

  235.