stm32l4xx_hal_irda_ex.h 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480
  1. /**
  2. ******************************************************************************
  3. * @file stm32l4xx_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) 2017 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 STM32L4xx_HAL_IRDA_EX_H
  20. #define STM32L4xx_HAL_IRDA_EX_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32l4xx_hal_def.h"
  26. /** @addtogroup STM32L4xx_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 (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) \
  61. || defined (STM32L496xx) || defined (STM32L4A6xx) \
  62. || defined (STM32L4P5xx) || defined (STM32L4Q5xx) \
  63. || defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined (STM32L4S9xx)
  64. #define IRDA_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  65. do { \
  66. if((__HANDLE__)->Instance == USART1) \
  67. { \
  68. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  69. { \
  70. case RCC_USART1CLKSOURCE_PCLK2: \
  71. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK2; \
  72. break; \
  73. case RCC_USART1CLKSOURCE_HSI: \
  74. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  75. break; \
  76. case RCC_USART1CLKSOURCE_SYSCLK: \
  77. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  78. break; \
  79. case RCC_USART1CLKSOURCE_LSE: \
  80. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  81. break; \
  82. default: \
  83. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  84. break; \
  85. } \
  86. } \
  87. else if((__HANDLE__)->Instance == USART2) \
  88. { \
  89. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  90. { \
  91. case RCC_USART2CLKSOURCE_PCLK1: \
  92. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  93. break; \
  94. case RCC_USART2CLKSOURCE_HSI: \
  95. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  96. break; \
  97. case RCC_USART2CLKSOURCE_SYSCLK: \
  98. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  99. break; \
  100. case RCC_USART2CLKSOURCE_LSE: \
  101. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  102. break; \
  103. default: \
  104. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  105. break; \
  106. } \
  107. } \
  108. else if((__HANDLE__)->Instance == USART3) \
  109. { \
  110. switch(__HAL_RCC_GET_USART3_SOURCE()) \
  111. { \
  112. case RCC_USART3CLKSOURCE_PCLK1: \
  113. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  114. break; \
  115. case RCC_USART3CLKSOURCE_HSI: \
  116. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  117. break; \
  118. case RCC_USART3CLKSOURCE_SYSCLK: \
  119. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  120. break; \
  121. case RCC_USART3CLKSOURCE_LSE: \
  122. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  123. break; \
  124. default: \
  125. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  126. break; \
  127. } \
  128. } \
  129. else if((__HANDLE__)->Instance == UART4) \
  130. { \
  131. switch(__HAL_RCC_GET_UART4_SOURCE()) \
  132. { \
  133. case RCC_UART4CLKSOURCE_PCLK1: \
  134. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  135. break; \
  136. case RCC_UART4CLKSOURCE_HSI: \
  137. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  138. break; \
  139. case RCC_UART4CLKSOURCE_SYSCLK: \
  140. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  141. break; \
  142. case RCC_UART4CLKSOURCE_LSE: \
  143. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  144. break; \
  145. default: \
  146. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  147. break; \
  148. } \
  149. } \
  150. else if ((__HANDLE__)->Instance == UART5) \
  151. { \
  152. switch(__HAL_RCC_GET_UART5_SOURCE()) \
  153. { \
  154. case RCC_UART5CLKSOURCE_PCLK1: \
  155. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  156. break; \
  157. case RCC_UART5CLKSOURCE_HSI: \
  158. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  159. break; \
  160. case RCC_UART5CLKSOURCE_SYSCLK: \
  161. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  162. break; \
  163. case RCC_UART5CLKSOURCE_LSE: \
  164. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  165. break; \
  166. default: \
  167. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  168. break; \
  169. } \
  170. } \
  171. else \
  172. { \
  173. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  174. } \
  175. } while(0)
  176. #elif defined (STM32L412xx) || defined (STM32L422xx) || defined (STM32L431xx) || defined (STM32L433xx) || defined (STM32L443xx)
  177. #define IRDA_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  178. do { \
  179. if((__HANDLE__)->Instance == USART1) \
  180. { \
  181. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  182. { \
  183. case RCC_USART1CLKSOURCE_PCLK2: \
  184. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK2; \
  185. break; \
  186. case RCC_USART1CLKSOURCE_HSI: \
  187. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  188. break; \
  189. case RCC_USART1CLKSOURCE_SYSCLK: \
  190. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  191. break; \
  192. case RCC_USART1CLKSOURCE_LSE: \
  193. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  194. break; \
  195. default: \
  196. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  197. break; \
  198. } \
  199. } \
  200. else if((__HANDLE__)->Instance == USART2) \
  201. { \
  202. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  203. { \
  204. case RCC_USART2CLKSOURCE_PCLK1: \
  205. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  206. break; \
  207. case RCC_USART2CLKSOURCE_HSI: \
  208. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  209. break; \
  210. case RCC_USART2CLKSOURCE_SYSCLK: \
  211. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  212. break; \
  213. case RCC_USART2CLKSOURCE_LSE: \
  214. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  215. break; \
  216. default: \
  217. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  218. break; \
  219. } \
  220. } \
  221. else if((__HANDLE__)->Instance == USART3) \
  222. { \
  223. switch(__HAL_RCC_GET_USART3_SOURCE()) \
  224. { \
  225. case RCC_USART3CLKSOURCE_PCLK1: \
  226. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  227. break; \
  228. case RCC_USART3CLKSOURCE_HSI: \
  229. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  230. break; \
  231. case RCC_USART3CLKSOURCE_SYSCLK: \
  232. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  233. break; \
  234. case RCC_USART3CLKSOURCE_LSE: \
  235. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  236. break; \
  237. default: \
  238. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  239. break; \
  240. } \
  241. } \
  242. else \
  243. { \
  244. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  245. } \
  246. } while(0)
  247. #elif defined (STM32L432xx) || defined (STM32L442xx)
  248. #define IRDA_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  249. do { \
  250. if((__HANDLE__)->Instance == USART1) \
  251. { \
  252. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  253. { \
  254. case RCC_USART1CLKSOURCE_PCLK2: \
  255. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK2; \
  256. break; \
  257. case RCC_USART1CLKSOURCE_HSI: \
  258. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  259. break; \
  260. case RCC_USART1CLKSOURCE_SYSCLK: \
  261. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  262. break; \
  263. case RCC_USART1CLKSOURCE_LSE: \
  264. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  265. break; \
  266. default: \
  267. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  268. break; \
  269. } \
  270. } \
  271. else if((__HANDLE__)->Instance == USART2) \
  272. { \
  273. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  274. { \
  275. case RCC_USART2CLKSOURCE_PCLK1: \
  276. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  277. break; \
  278. case RCC_USART2CLKSOURCE_HSI: \
  279. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  280. break; \
  281. case RCC_USART2CLKSOURCE_SYSCLK: \
  282. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  283. break; \
  284. case RCC_USART2CLKSOURCE_LSE: \
  285. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  286. break; \
  287. default: \
  288. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  289. break; \
  290. } \
  291. } \
  292. else \
  293. { \
  294. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  295. } \
  296. } while(0)
  297. #elif defined (STM32L451xx) || defined (STM32L452xx) || defined (STM32L462xx)
  298. #define IRDA_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  299. do { \
  300. if((__HANDLE__)->Instance == USART1) \
  301. { \
  302. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  303. { \
  304. case RCC_USART1CLKSOURCE_PCLK2: \
  305. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK2; \
  306. break; \
  307. case RCC_USART1CLKSOURCE_HSI: \
  308. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  309. break; \
  310. case RCC_USART1CLKSOURCE_SYSCLK: \
  311. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  312. break; \
  313. case RCC_USART1CLKSOURCE_LSE: \
  314. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  315. break; \
  316. default: \
  317. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  318. break; \
  319. } \
  320. } \
  321. else if((__HANDLE__)->Instance == USART2) \
  322. { \
  323. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  324. { \
  325. case RCC_USART2CLKSOURCE_PCLK1: \
  326. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  327. break; \
  328. case RCC_USART2CLKSOURCE_HSI: \
  329. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  330. break; \
  331. case RCC_USART2CLKSOURCE_SYSCLK: \
  332. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  333. break; \
  334. case RCC_USART2CLKSOURCE_LSE: \
  335. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  336. break; \
  337. default: \
  338. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  339. break; \
  340. } \
  341. } \
  342. else if((__HANDLE__)->Instance == USART3) \
  343. { \
  344. switch(__HAL_RCC_GET_USART3_SOURCE()) \
  345. { \
  346. case RCC_USART3CLKSOURCE_PCLK1: \
  347. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  348. break; \
  349. case RCC_USART3CLKSOURCE_HSI: \
  350. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  351. break; \
  352. case RCC_USART3CLKSOURCE_SYSCLK: \
  353. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  354. break; \
  355. case RCC_USART3CLKSOURCE_LSE: \
  356. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  357. break; \
  358. default: \
  359. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  360. break; \
  361. } \
  362. } \
  363. else if((__HANDLE__)->Instance == UART4) \
  364. { \
  365. switch(__HAL_RCC_GET_UART4_SOURCE()) \
  366. { \
  367. case RCC_UART4CLKSOURCE_PCLK1: \
  368. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_PCLK1; \
  369. break; \
  370. case RCC_UART4CLKSOURCE_HSI: \
  371. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_HSI; \
  372. break; \
  373. case RCC_UART4CLKSOURCE_SYSCLK: \
  374. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_SYSCLK; \
  375. break; \
  376. case RCC_UART4CLKSOURCE_LSE: \
  377. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_LSE; \
  378. break; \
  379. default: \
  380. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  381. break; \
  382. } \
  383. } \
  384. else \
  385. { \
  386. (__CLOCKSOURCE__) = IRDA_CLOCKSOURCE_UNDEFINED; \
  387. } \
  388. } while(0)
  389. #endif /* STM32L471xx || STM32L475xx || STM32L476xx || STM32L485xx || STM32L486xx ||
  390. * STM32L496xx || STM32L4A6xx ||
  391. * STM32L4P5xx || STM32L4Q5xx ||
  392. * STM32L4R5xx || STM32L4R7xx || STM32L4R9xx || STM32L4S5xx || STM32L4S7xx || STM32L4S9xx
  393. */
  394. /** @brief Compute the mask to apply to retrieve the received data
  395. * according to the word length and to the parity bits activation.
  396. * @param __HANDLE__ specifies the IRDA Handle.
  397. * @retval None, the mask to apply to the associated UART RDR register is stored in (__HANDLE__)->Mask field.
  398. */
  399. #define IRDA_MASK_COMPUTATION(__HANDLE__) \
  400. do { \
  401. if ((__HANDLE__)->Init.WordLength == IRDA_WORDLENGTH_9B) \
  402. { \
  403. if ((__HANDLE__)->Init.Parity == IRDA_PARITY_NONE) \
  404. { \
  405. (__HANDLE__)->Mask = 0x01FFU ; \
  406. } \
  407. else \
  408. { \
  409. (__HANDLE__)->Mask = 0x00FFU ; \
  410. } \
  411. } \
  412. else if ((__HANDLE__)->Init.WordLength == IRDA_WORDLENGTH_8B) \
  413. { \
  414. if ((__HANDLE__)->Init.Parity == IRDA_PARITY_NONE) \
  415. { \
  416. (__HANDLE__)->Mask = 0x00FFU ; \
  417. } \
  418. else \
  419. { \
  420. (__HANDLE__)->Mask = 0x007FU ; \
  421. } \
  422. } \
  423. else if ((__HANDLE__)->Init.WordLength == IRDA_WORDLENGTH_7B) \
  424. { \
  425. if ((__HANDLE__)->Init.Parity == IRDA_PARITY_NONE) \
  426. { \
  427. (__HANDLE__)->Mask = 0x007FU ; \
  428. } \
  429. else \
  430. { \
  431. (__HANDLE__)->Mask = 0x003FU ; \
  432. } \
  433. } \
  434. else \
  435. { \
  436. (__HANDLE__)->Mask = 0x0000U; \
  437. } \
  438. } while(0U)
  439. /** @brief Ensure that IRDA frame length is valid.
  440. * @param __LENGTH__ IRDA frame length.
  441. * @retval SET (__LENGTH__ is valid) or RESET (__LENGTH__ is invalid)
  442. */
  443. #define IS_IRDA_WORD_LENGTH(__LENGTH__) (((__LENGTH__) == IRDA_WORDLENGTH_7B) || \
  444. ((__LENGTH__) == IRDA_WORDLENGTH_8B) || \
  445. ((__LENGTH__) == IRDA_WORDLENGTH_9B))
  446. /**
  447. * @}
  448. */
  449. /* Exported functions --------------------------------------------------------*/
  450. /**
  451. * @}
  452. */
  453. /**
  454. * @}
  455. */
  456. #ifdef __cplusplus
  457. }
  458. #endif
  459. #endif /* STM32L4xx_HAL_IRDA_EX_H */