stm32g0xx_hal_irda_ex.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296
  1. /**
  2. ******************************************************************************
  3. * @file stm32g0xx_hal_irda_ex.h
  4. * @author MCD Application Team
  5. * @brief Header file of IRDA HAL Extended module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2018 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 STM32G0xx_HAL_IRDA_EX_H
  20. #define STM32G0xx_HAL_IRDA_EX_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32g0xx_hal_def.h"
  26. /** @addtogroup STM32G0xx_HAL_Driver
  27. * @{
  28. */
  29. /** @defgroup IRDAEx IRDAEx
  30. * @brief IRDA Extended HAL module driver
  31. * @{
  32. */
  33. /* Exported types ------------------------------------------------------------*/
  34. /* Exported constants --------------------------------------------------------*/
  35. /** @defgroup IRDAEx_Extended_Exported_Constants IRDAEx Extended Exported Constants
  36. * @{
  37. */
  38. /** @defgroup IRDAEx_Word_Length IRDAEx Word Length
  39. * @{
  40. */
  41. #define IRDA_WORDLENGTH_7B USART_CR1_M1 /*!< 7-bit long frame */
  42. #define IRDA_WORDLENGTH_8B 0x00000000U /*!< 8-bit long frame */
  43. #define IRDA_WORDLENGTH_9B USART_CR1_M0 /*!< 9-bit long frame */
  44. /**
  45. * @}
  46. */
  47. /**
  48. * @}
  49. */
  50. /* Exported macros -----------------------------------------------------------*/
  51. /* Private macros ------------------------------------------------------------*/
  52. /** @defgroup IRDAEx_Private_Macros IRDAEx Private Macros
  53. * @{
  54. */
  55. /** @brief Report the IRDA clock source.
  56. * @param __HANDLE__ specifies the IRDA Handle.
  57. * @param __CLOCKSOURCE__ output variable.
  58. * @retval IRDA clocking source, written in __CLOCKSOURCE__.
  59. */
  60. #if defined(STM32G0C1xx) || defined(STM32G0B1xx) || defined(STM32G0B0xx)
  61. #define IRDA_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  62. do { \
  63. if((__HANDLE__)->Instance == USART1) \
  64. { \
  65. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  66. { \
  67. case RCC_USART1CLKSOURCE_PCLK1: \
  68. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  69. break; \
  70. case RCC_USART1CLKSOURCE_HSI: \
  71. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  72. break; \
  73. case RCC_USART1CLKSOURCE_SYSCLK: \
  74. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  75. break; \
  76. case RCC_USART1CLKSOURCE_LSE: \
  77. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  78. break; \
  79. default: \
  80. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  81. break; \
  82. } \
  83. } \
  84. else if((__HANDLE__)->Instance == USART2) \
  85. { \
  86. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  87. { \
  88. case RCC_USART2CLKSOURCE_PCLK1: \
  89. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  90. break; \
  91. case RCC_USART2CLKSOURCE_HSI: \
  92. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  93. break; \
  94. case RCC_USART2CLKSOURCE_SYSCLK: \
  95. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  96. break; \
  97. case RCC_USART2CLKSOURCE_LSE: \
  98. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  99. break; \
  100. default: \
  101. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  102. break; \
  103. } \
  104. } \
  105. else if((__HANDLE__)->Instance == USART3) \
  106. { \
  107. switch(__HAL_RCC_GET_USART3_SOURCE()) \
  108. { \
  109. case RCC_USART3CLKSOURCE_PCLK1: \
  110. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  111. break; \
  112. case RCC_USART3CLKSOURCE_HSI: \
  113. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  114. break; \
  115. case RCC_USART3CLKSOURCE_SYSCLK: \
  116. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  117. break; \
  118. case RCC_USART3CLKSOURCE_LSE: \
  119. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  120. break; \
  121. default: \
  122. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  123. break; \
  124. } \
  125. } \
  126. else \
  127. { \
  128. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  129. } \
  130. } while(0U)
  131. #elif defined(STM32G081xx) || defined(STM32G071xx) || defined(STM32G070xx)
  132. #define IRDA_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  133. do { \
  134. if((__HANDLE__)->Instance == USART1) \
  135. { \
  136. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  137. { \
  138. case RCC_USART1CLKSOURCE_PCLK1: \
  139. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  140. break; \
  141. case RCC_USART1CLKSOURCE_HSI: \
  142. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  143. break; \
  144. case RCC_USART1CLKSOURCE_SYSCLK: \
  145. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  146. break; \
  147. case RCC_USART1CLKSOURCE_LSE: \
  148. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  149. break; \
  150. default: \
  151. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  152. break; \
  153. } \
  154. } \
  155. else if((__HANDLE__)->Instance == USART2) \
  156. { \
  157. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  158. { \
  159. case RCC_USART2CLKSOURCE_PCLK1: \
  160. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  161. break; \
  162. case RCC_USART2CLKSOURCE_HSI: \
  163. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  164. break; \
  165. case RCC_USART2CLKSOURCE_SYSCLK: \
  166. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  167. break; \
  168. case RCC_USART2CLKSOURCE_LSE: \
  169. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  170. break; \
  171. default: \
  172. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  173. break; \
  174. } \
  175. } \
  176. else \
  177. { \
  178. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  179. } \
  180. } while(0U)
  181. #else
  182. #define IRDA_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  183. do { \
  184. if((__HANDLE__)->Instance == USART1) \
  185. { \
  186. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  187. { \
  188. case RCC_USART1CLKSOURCE_PCLK1: \
  189. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  190. break; \
  191. case RCC_USART1CLKSOURCE_HSI: \
  192. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  193. break; \
  194. case RCC_USART1CLKSOURCE_SYSCLK: \
  195. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  196. break; \
  197. case RCC_USART1CLKSOURCE_LSE: \
  198. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  199. break; \
  200. default: \
  201. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  202. break; \
  203. } \
  204. } \
  205. else \
  206. { \
  207. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  208. } \
  209. } while(0U)
  210. #endif /* STM32G0C1xx || STM32G0B1xx || STM32G0B0xx */
  211. /** @brief Compute the mask to apply to retrieve the received data
  212. * according to the word length and to the parity bits activation.
  213. * @param __HANDLE__ specifies the IRDA Handle.
  214. * @retval None, the mask to apply to the associated UART RDR register is stored in (__HANDLE__)->Mask field.
  215. */
  216. #define IRDA_MASK_COMPUTATION(__HANDLE__) \
  217. do { \
  218. if ((__HANDLE__)->Init.WordLength == IRDA_WORDLENGTH_9B) \
  219. { \
  220. if ((__HANDLE__)->Init.Parity == IRDA_PARITY_NONE) \
  221. { \
  222. (__HANDLE__)->Mask = 0x01FFU ; \
  223. } \
  224. else \
  225. { \
  226. (__HANDLE__)->Mask = 0x00FFU ; \
  227. } \
  228. } \
  229. else if ((__HANDLE__)->Init.WordLength == IRDA_WORDLENGTH_8B) \
  230. { \
  231. if ((__HANDLE__)->Init.Parity == IRDA_PARITY_NONE) \
  232. { \
  233. (__HANDLE__)->Mask = 0x00FFU ; \
  234. } \
  235. else \
  236. { \
  237. (__HANDLE__)->Mask = 0x007FU ; \
  238. } \
  239. } \
  240. else if ((__HANDLE__)->Init.WordLength == IRDA_WORDLENGTH_7B) \
  241. { \
  242. if ((__HANDLE__)->Init.Parity == IRDA_PARITY_NONE) \
  243. { \
  244. (__HANDLE__)->Mask = 0x007FU ; \
  245. } \
  246. else \
  247. { \
  248. (__HANDLE__)->Mask = 0x003FU ; \
  249. } \
  250. } \
  251. else \
  252. { \
  253. (__HANDLE__)->Mask = 0x0000U; \
  254. } \
  255. } while(0U)
  256. /** @brief Ensure that IRDA frame length is valid.
  257. * @param __LENGTH__ IRDA frame length.
  258. * @retval SET (__LENGTH__ is valid) or RESET (__LENGTH__ is invalid)
  259. */
  260. #define IS_IRDA_WORD_LENGTH(__LENGTH__) (((__LENGTH__) == IRDA_WORDLENGTH_7B) || \
  261. ((__LENGTH__) == IRDA_WORDLENGTH_8B) || \
  262. ((__LENGTH__) == IRDA_WORDLENGTH_9B))
  263. /**
  264. * @}
  265. */
  266. /* Exported functions --------------------------------------------------------*/
  267. /**
  268. * @}
  269. */
  270. /**
  271. * @}
  272. */
  273. #ifdef __cplusplus
  274. }
  275. #endif
  276. #endif /* STM32G0xx_HAL_IRDA_EX_H */