stm32f0xx_hal_i2c_ex.h 6.9 KB

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