stm32f0xx_hal_i2c_ex.h 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190
  1. /**
  2. ******************************************************************************
  3. * @file stm32f0xx_hal_i2c_ex.h
  4. * @author MCD Application Team
  5. * @brief Header file of I2C HAL Extended module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2016 STMicroelectronics.
  10. * All rights reserved.
  11. *
  12. * This software is licensed under terms that can be found in the LICENSE file
  13. * in the root directory of this software component.
  14. * If no LICENSE file comes with this software, it is provided AS-IS.
  15. *
  16. ******************************************************************************
  17. */
  18. /* Define to prevent recursive inclusion -------------------------------------*/
  19. #ifndef STM32F0xx_HAL_I2C_EX_H
  20. #define STM32F0xx_HAL_I2C_EX_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32f0xx_hal_def.h"
  26. /** @addtogroup STM32F0xx_HAL_Driver
  27. * @{
  28. */
  29. /** @addtogroup I2CEx
  30. * @{
  31. */
  32. /* Exported types ------------------------------------------------------------*/
  33. /* Exported constants --------------------------------------------------------*/
  34. /** @defgroup I2CEx_Exported_Constants I2C Extended Exported Constants
  35. * @{
  36. */
  37. /** @defgroup I2CEx_Analog_Filter I2C Extended Analog Filter
  38. * @{
  39. */
  40. #define I2C_ANALOGFILTER_ENABLE 0x00000000U
  41. #define I2C_ANALOGFILTER_DISABLE I2C_CR1_ANFOFF
  42. /**
  43. * @}
  44. */
  45. /** @defgroup I2CEx_FastModePlus I2C Extended Fast Mode Plus
  46. * @{
  47. */
  48. #define I2C_FMP_NOT_SUPPORTED 0xAAAA0000U /*!< Fast Mode Plus not supported */
  49. #if defined(SYSCFG_CFGR1_I2C_FMP_PA9)
  50. #define I2C_FASTMODEPLUS_PA9 SYSCFG_CFGR1_I2C_FMP_PA9 /*!< Enable Fast Mode Plus on PA9 */
  51. #define I2C_FASTMODEPLUS_PA10 SYSCFG_CFGR1_I2C_FMP_PA10 /*!< Enable Fast Mode Plus on PA10 */
  52. #else
  53. #define I2C_FASTMODEPLUS_PA9 (uint32_t)(0x00000001U | I2C_FMP_NOT_SUPPORTED) /*!< Fast Mode Plus PA9 not supported */
  54. #define I2C_FASTMODEPLUS_PA10 (uint32_t)(0x00000002U | I2C_FMP_NOT_SUPPORTED) /*!< Fast Mode Plus PA10 not supported */
  55. #endif /* SYSCFG_CFGR1_I2C_FMP_PA9 */
  56. #define I2C_FASTMODEPLUS_PB6 SYSCFG_CFGR1_I2C_FMP_PB6 /*!< Enable Fast Mode Plus on PB6 */
  57. #define I2C_FASTMODEPLUS_PB7 SYSCFG_CFGR1_I2C_FMP_PB7 /*!< Enable Fast Mode Plus on PB7 */
  58. #define I2C_FASTMODEPLUS_PB8 SYSCFG_CFGR1_I2C_FMP_PB8 /*!< Enable Fast Mode Plus on PB8 */
  59. #define I2C_FASTMODEPLUS_PB9 SYSCFG_CFGR1_I2C_FMP_PB9 /*!< Enable Fast Mode Plus on PB9 */
  60. #if defined(SYSCFG_CFGR1_I2C_FMP_I2C1)
  61. #define I2C_FASTMODEPLUS_I2C1 SYSCFG_CFGR1_I2C_FMP_I2C1 /*!< Enable Fast Mode Plus on I2C1 pins */
  62. #else
  63. #define I2C_FASTMODEPLUS_I2C1 (uint32_t)(0x00000100U | I2C_FMP_NOT_SUPPORTED) /*!< Fast Mode Plus I2C1 not supported */
  64. #endif /* SYSCFG_CFGR1_I2C_FMP_I2C1 */
  65. #if defined(SYSCFG_CFGR1_I2C_FMP_I2C2)
  66. #define I2C_FASTMODEPLUS_I2C2 SYSCFG_CFGR1_I2C_FMP_I2C2 /*!< Enable Fast Mode Plus on I2C2 pins */
  67. #else
  68. #define I2C_FASTMODEPLUS_I2C2 (uint32_t)(0x00000200U | I2C_FMP_NOT_SUPPORTED) /*!< Fast Mode Plus I2C2 not supported */
  69. #endif /* SYSCFG_CFGR1_I2C_FMP_I2C2 */
  70. /**
  71. * @}
  72. */
  73. /**
  74. * @}
  75. */
  76. /* Exported macro ------------------------------------------------------------*/
  77. /* Exported functions --------------------------------------------------------*/
  78. /** @addtogroup I2CEx_Exported_Functions I2C Extended Exported Functions
  79. * @{
  80. */
  81. /** @addtogroup I2CEx_Exported_Functions_Group1 Extended features functions
  82. * @brief Extended features functions
  83. * @{
  84. */
  85. /** @addtogroup I2CEx_Exported_Functions_Group1 Filter Mode Functions
  86. * @{
  87. */
  88. HAL_StatusTypeDef HAL_I2CEx_ConfigAnalogFilter(I2C_HandleTypeDef *hi2c,
  89. uint32_t AnalogFilter);
  90. HAL_StatusTypeDef HAL_I2CEx_ConfigDigitalFilter(I2C_HandleTypeDef *hi2c,
  91. uint32_t DigitalFilter);
  92. /**
  93. * @}
  94. */
  95. #if defined(I2C_CR1_WUPEN)
  96. /** @addtogroup I2CEx_Exported_Functions_Group2 WakeUp Mode Functions
  97. * @{
  98. */
  99. HAL_StatusTypeDef HAL_I2CEx_EnableWakeUp(I2C_HandleTypeDef *hi2c);
  100. HAL_StatusTypeDef HAL_I2CEx_DisableWakeUp(I2C_HandleTypeDef *hi2c);
  101. /**
  102. * @}
  103. */
  104. #endif /* I2C_CR1_WUPEN */
  105. /** @addtogroup I2CEx_Exported_Functions_Group3 Fast Mode Plus Functions
  106. * @{
  107. */
  108. void HAL_I2CEx_EnableFastModePlus(uint32_t ConfigFastModePlus);
  109. void HAL_I2CEx_DisableFastModePlus(uint32_t ConfigFastModePlus);
  110. /**
  111. * @}
  112. */
  113. /* Private constants ---------------------------------------------------------*/
  114. /** @defgroup I2CEx_Private_Constants I2C Extended Private Constants
  115. * @{
  116. */
  117. /**
  118. * @}
  119. */
  120. /* Private macros ------------------------------------------------------------*/
  121. /** @defgroup I2CEx_Private_Macro I2C Extended Private Macros
  122. * @{
  123. */
  124. #define IS_I2C_ANALOG_FILTER(FILTER) (((FILTER) == I2C_ANALOGFILTER_ENABLE) || \
  125. ((FILTER) == I2C_ANALOGFILTER_DISABLE))
  126. #define IS_I2C_DIGITAL_FILTER(FILTER) ((FILTER) <= 0x0000000FU)
  127. #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & I2C_FMP_NOT_SUPPORTED) != I2C_FMP_NOT_SUPPORTED) && \
  128. ((((__CONFIG__) & (I2C_FASTMODEPLUS_PA9)) == I2C_FASTMODEPLUS_PA9) || \
  129. (((__CONFIG__) & (I2C_FASTMODEPLUS_PA10)) == I2C_FASTMODEPLUS_PA10) || \
  130. (((__CONFIG__) & (I2C_FASTMODEPLUS_PB6)) == I2C_FASTMODEPLUS_PB6) || \
  131. (((__CONFIG__) & (I2C_FASTMODEPLUS_PB7)) == I2C_FASTMODEPLUS_PB7) || \
  132. (((__CONFIG__) & (I2C_FASTMODEPLUS_PB8)) == I2C_FASTMODEPLUS_PB8) || \
  133. (((__CONFIG__) & (I2C_FASTMODEPLUS_PB9)) == I2C_FASTMODEPLUS_PB9) || \
  134. (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C1)) == I2C_FASTMODEPLUS_I2C1) || \
  135. (((__CONFIG__) & (I2C_FASTMODEPLUS_I2C2)) == I2C_FASTMODEPLUS_I2C2)))
  136. /**
  137. * @}
  138. */
  139. /* Private Functions ---------------------------------------------------------*/
  140. /** @defgroup I2CEx_Private_Functions I2C Extended Private Functions
  141. * @{
  142. */
  143. /* Private functions are defined in stm32f0xx_hal_i2c_ex.c file */
  144. /**
  145. * @}
  146. */
  147. /**
  148. * @}
  149. */
  150. /**
  151. * @}
  152. */
  153. /**
  154. * @}
  155. */
  156. /**
  157. * @}
  158. */
  159. #ifdef __cplusplus
  160. }
  161. #endif
  162. #endif /* STM32F0xx_HAL_I2C_EX_H */