stm32l1xx_hal.h 44 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962
  1. /**
  2. ******************************************************************************
  3. * @file stm32l1xx_hal.h
  4. * @author MCD Application Team
  5. * @brief This file contains all the functions prototypes for the HAL
  6. * module driver.
  7. ******************************************************************************
  8. * @attention
  9. *
  10. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  11. *
  12. * Redistribution and use in source and binary forms, with or without modification,
  13. * are permitted provided that the following conditions are met:
  14. * 1. Redistributions of source code must retain the above copyright notice,
  15. * this list of conditions and the following disclaimer.
  16. * 2. Redistributions in binary form must reproduce the above copyright notice,
  17. * this list of conditions and the following disclaimer in the documentation
  18. * and/or other materials provided with the distribution.
  19. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  20. * may be used to endorse or promote products derived from this software
  21. * without specific prior written permission.
  22. *
  23. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  24. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  26. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  27. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  28. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  29. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  30. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  31. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  32. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  33. *
  34. ******************************************************************************
  35. */
  36. /* Define to prevent recursive inclusion -------------------------------------*/
  37. #ifndef __STM32L1xx_HAL_H
  38. #define __STM32L1xx_HAL_H
  39. #ifdef __cplusplus
  40. extern "C" {
  41. #endif
  42. /* Includes ------------------------------------------------------------------*/
  43. #include "stm32l1xx_hal_conf.h"
  44. /** @addtogroup STM32L1xx_HAL_Driver
  45. * @{
  46. */
  47. /** @addtogroup HAL
  48. * @{
  49. */
  50. /* Exported types ------------------------------------------------------------*/
  51. /* Exported constants --------------------------------------------------------*/
  52. /** @defgroup HAL_Exported_Constants HAL Exported Constants
  53. * @{
  54. */
  55. /** @defgroup SYSCFG_Constants SYSCFG: SYStem ConFiG
  56. * @{
  57. */
  58. /** @defgroup SYSCFG_BootMode Boot Mode
  59. * @{
  60. */
  61. #define SYSCFG_BOOT_MAINFLASH (0x00000000U)
  62. #define SYSCFG_BOOT_SYSTEMFLASH ((uint32_t)SYSCFG_MEMRMP_BOOT_MODE_0)
  63. #if defined(FSMC_R_BASE)
  64. #define SYSCFG_BOOT_FSMC ((uint32_t)SYSCFG_MEMRMP_BOOT_MODE_1)
  65. #endif /* FSMC_R_BASE */
  66. #define SYSCFG_BOOT_SRAM ((uint32_t)SYSCFG_MEMRMP_BOOT_MODE)
  67. /**
  68. * @}
  69. */
  70. /**
  71. * @}
  72. */
  73. /** @defgroup RI_Constants RI: Routing Interface
  74. * @{
  75. */
  76. /** @defgroup RI_InputCapture Input Capture
  77. * @{
  78. */
  79. #define RI_INPUTCAPTURE_IC1 RI_ICR_IC1 /*!< Input Capture 1 */
  80. #define RI_INPUTCAPTURE_IC2 RI_ICR_IC2 /*!< Input Capture 2 */
  81. #define RI_INPUTCAPTURE_IC3 RI_ICR_IC3 /*!< Input Capture 3 */
  82. #define RI_INPUTCAPTURE_IC4 RI_ICR_IC4 /*!< Input Capture 4 */
  83. /**
  84. * @}
  85. */
  86. /** @defgroup TIM_Select TIM Select
  87. * @{
  88. */
  89. #define TIM_SELECT_NONE (0x00000000U) /*!< None selected */
  90. #define TIM_SELECT_TIM2 ((uint32_t)RI_ICR_TIM_0) /*!< Timer 2 selected */
  91. #define TIM_SELECT_TIM3 ((uint32_t)RI_ICR_TIM_1) /*!< Timer 3 selected */
  92. #define TIM_SELECT_TIM4 ((uint32_t)RI_ICR_TIM) /*!< Timer 4 selected */
  93. #define IS_RI_TIM(__TIM__) (((__TIM__) == TIM_SELECT_NONE) || \
  94. ((__TIM__) == TIM_SELECT_TIM2) || \
  95. ((__TIM__) == TIM_SELECT_TIM3) || \
  96. ((__TIM__) == TIM_SELECT_TIM4))
  97. /**
  98. * @}
  99. */
  100. /** @defgroup RI_InputCaptureRouting Input Capture Routing
  101. * @{
  102. */
  103. /* TIMx_IC1 TIMx_IC2 TIMx_IC3 TIMx_IC4 */
  104. #define RI_INPUTCAPTUREROUTING_0 (0x00000000U) /* PA0 PA1 PA2 PA3 */
  105. #define RI_INPUTCAPTUREROUTING_1 (0x00000001U) /* PA4 PA5 PA6 PA7 */
  106. #define RI_INPUTCAPTUREROUTING_2 (0x00000002U) /* PA8 PA9 PA10 PA11 */
  107. #define RI_INPUTCAPTUREROUTING_3 (0x00000003U) /* PA12 PA13 PA14 PA15 */
  108. #define RI_INPUTCAPTUREROUTING_4 (0x00000004U) /* PC0 PC1 PC2 PC3 */
  109. #define RI_INPUTCAPTUREROUTING_5 (0x00000005U) /* PC4 PC5 PC6 PC7 */
  110. #define RI_INPUTCAPTUREROUTING_6 (0x00000006U) /* PC8 PC9 PC10 PC11 */
  111. #define RI_INPUTCAPTUREROUTING_7 (0x00000007U) /* PC12 PC13 PC14 PC15 */
  112. #define RI_INPUTCAPTUREROUTING_8 (0x00000008U) /* PD0 PD1 PD2 PD3 */
  113. #define RI_INPUTCAPTUREROUTING_9 (0x00000009U) /* PD4 PD5 PD6 PD7 */
  114. #define RI_INPUTCAPTUREROUTING_10 (0x0000000AU) /* PD8 PD9 PD10 PD11 */
  115. #define RI_INPUTCAPTUREROUTING_11 (0x0000000BU) /* PD12 PD13 PD14 PD15 */
  116. #define RI_INPUTCAPTUREROUTING_12 (0x0000000CU) /* PE0 PE1 PE2 PE3 */
  117. #define RI_INPUTCAPTUREROUTING_13 (0x0000000DU) /* PE4 PE5 PE6 PE7 */
  118. #define RI_INPUTCAPTUREROUTING_14 (0x0000000EU) /* PE8 PE9 PE10 PE11 */
  119. #define RI_INPUTCAPTUREROUTING_15 (0x0000000FU) /* PE12 PE13 PE14 PE15 */
  120. #define IS_RI_INPUTCAPTURE_ROUTING(__ROUTING__) (((__ROUTING__) == RI_INPUTCAPTUREROUTING_0) || \
  121. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_1) || \
  122. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_2) || \
  123. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_3) || \
  124. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_4) || \
  125. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_5) || \
  126. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_6) || \
  127. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_7) || \
  128. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_8) || \
  129. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_9) || \
  130. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_10) || \
  131. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_11) || \
  132. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_12) || \
  133. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_13) || \
  134. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_14) || \
  135. ((__ROUTING__) == RI_INPUTCAPTUREROUTING_15))
  136. /**
  137. * @}
  138. */
  139. /** @defgroup RI_IOSwitch IO Switch
  140. * @{
  141. */
  142. #define RI_ASCR1_REGISTER (0x80000000U)
  143. /* ASCR1 I/O switch: bit 31 is set to '1' to indicate that the mask is in ASCR1 register */
  144. #define RI_IOSWITCH_CH0 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_0)
  145. #define RI_IOSWITCH_CH1 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_1)
  146. #define RI_IOSWITCH_CH2 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_2)
  147. #define RI_IOSWITCH_CH3 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_3)
  148. #define RI_IOSWITCH_CH4 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_4)
  149. #define RI_IOSWITCH_CH5 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_5)
  150. #define RI_IOSWITCH_CH6 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_6)
  151. #define RI_IOSWITCH_CH7 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_7)
  152. #define RI_IOSWITCH_CH8 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_8)
  153. #define RI_IOSWITCH_CH9 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_9)
  154. #define RI_IOSWITCH_CH10 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_10)
  155. #define RI_IOSWITCH_CH11 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_11)
  156. #define RI_IOSWITCH_CH12 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_12)
  157. #define RI_IOSWITCH_CH13 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_13)
  158. #define RI_IOSWITCH_CH14 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_14)
  159. #define RI_IOSWITCH_CH15 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_15)
  160. #define RI_IOSWITCH_CH18 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_18)
  161. #define RI_IOSWITCH_CH19 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_19)
  162. #define RI_IOSWITCH_CH20 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_20)
  163. #define RI_IOSWITCH_CH21 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_21)
  164. #define RI_IOSWITCH_CH22 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_22)
  165. #define RI_IOSWITCH_CH23 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_23)
  166. #define RI_IOSWITCH_CH24 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_24)
  167. #define RI_IOSWITCH_CH25 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_25)
  168. #define RI_IOSWITCH_VCOMP ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_VCOMP) /* VCOMP (ADC channel 26) is an internal switch used to connect selected channel to COMP1 non inverting input */
  169. #if defined (RI_ASCR2_CH1b) /* STM32L1 devices category Cat.4 and Cat.5 */
  170. #define RI_IOSWITCH_CH27 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_27)
  171. #define RI_IOSWITCH_CH28 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_28)
  172. #define RI_IOSWITCH_CH29 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_29)
  173. #define RI_IOSWITCH_CH30 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_30)
  174. #define RI_IOSWITCH_CH31 ((uint32_t)RI_ASCR1_REGISTER | RI_ASCR1_CH_31)
  175. #endif /* RI_ASCR2_CH1b */
  176. /* ASCR2 IO switch: bit 31 is set to '0' to indicate that the mask is in ASCR2 register */
  177. #define RI_IOSWITCH_GR10_1 ((uint32_t)RI_ASCR2_GR10_1)
  178. #define RI_IOSWITCH_GR10_2 ((uint32_t)RI_ASCR2_GR10_2)
  179. #define RI_IOSWITCH_GR10_3 ((uint32_t)RI_ASCR2_GR10_3)
  180. #define RI_IOSWITCH_GR10_4 ((uint32_t)RI_ASCR2_GR10_4)
  181. #define RI_IOSWITCH_GR6_1 ((uint32_t)RI_ASCR2_GR6_1)
  182. #define RI_IOSWITCH_GR6_2 ((uint32_t)RI_ASCR2_GR6_2)
  183. #define RI_IOSWITCH_GR5_1 ((uint32_t)RI_ASCR2_GR5_1)
  184. #define RI_IOSWITCH_GR5_2 ((uint32_t)RI_ASCR2_GR5_2)
  185. #define RI_IOSWITCH_GR5_3 ((uint32_t)RI_ASCR2_GR5_3)
  186. #define RI_IOSWITCH_GR4_1 ((uint32_t)RI_ASCR2_GR4_1)
  187. #define RI_IOSWITCH_GR4_2 ((uint32_t)RI_ASCR2_GR4_2)
  188. #define RI_IOSWITCH_GR4_3 ((uint32_t)RI_ASCR2_GR4_3)
  189. #if defined (RI_ASCR2_CH0b) /* STM32L1 devices category Cat.3, Cat.4 and Cat.5 */
  190. #define RI_IOSWITCH_CH0b ((uint32_t)RI_ASCR2_CH0b)
  191. #if defined (RI_ASCR2_CH1b) /* STM32L1 devices category Cat.4 and Cat.5 */
  192. #define RI_IOSWITCH_CH1b ((uint32_t)RI_ASCR2_CH1b)
  193. #define RI_IOSWITCH_CH2b ((uint32_t)RI_ASCR2_CH2b)
  194. #define RI_IOSWITCH_CH3b ((uint32_t)RI_ASCR2_CH3b)
  195. #define RI_IOSWITCH_CH6b ((uint32_t)RI_ASCR2_CH6b)
  196. #define RI_IOSWITCH_CH7b ((uint32_t)RI_ASCR2_CH7b)
  197. #define RI_IOSWITCH_CH8b ((uint32_t)RI_ASCR2_CH8b)
  198. #define RI_IOSWITCH_CH9b ((uint32_t)RI_ASCR2_CH9b)
  199. #define RI_IOSWITCH_CH10b ((uint32_t)RI_ASCR2_CH10b)
  200. #define RI_IOSWITCH_CH11b ((uint32_t)RI_ASCR2_CH11b)
  201. #define RI_IOSWITCH_CH12b ((uint32_t)RI_ASCR2_CH12b)
  202. #endif /* RI_ASCR2_CH1b */
  203. #define RI_IOSWITCH_GR6_3 ((uint32_t)RI_ASCR2_GR6_3)
  204. #define RI_IOSWITCH_GR6_4 ((uint32_t)RI_ASCR2_GR6_4)
  205. #endif /* RI_ASCR2_CH0b */
  206. #if defined (RI_ASCR2_CH1b) /* STM32L1 devices category Cat.4 and Cat.5 */
  207. #define IS_RI_IOSWITCH(__IOSWITCH__) (((__IOSWITCH__) == RI_IOSWITCH_CH0) || ((__IOSWITCH__) == RI_IOSWITCH_CH1) || \
  208. ((__IOSWITCH__) == RI_IOSWITCH_CH2) || ((__IOSWITCH__) == RI_IOSWITCH_CH3) || \
  209. ((__IOSWITCH__) == RI_IOSWITCH_CH4) || ((__IOSWITCH__) == RI_IOSWITCH_CH5) || \
  210. ((__IOSWITCH__) == RI_IOSWITCH_CH6) || ((__IOSWITCH__) == RI_IOSWITCH_CH7) || \
  211. ((__IOSWITCH__) == RI_IOSWITCH_CH8) || ((__IOSWITCH__) == RI_IOSWITCH_CH9) || \
  212. ((__IOSWITCH__) == RI_IOSWITCH_CH10) || ((__IOSWITCH__) == RI_IOSWITCH_CH11) || \
  213. ((__IOSWITCH__) == RI_IOSWITCH_CH12) || ((__IOSWITCH__) == RI_IOSWITCH_CH13) || \
  214. ((__IOSWITCH__) == RI_IOSWITCH_CH14) || ((__IOSWITCH__) == RI_IOSWITCH_CH15) || \
  215. ((__IOSWITCH__) == RI_IOSWITCH_CH18) || ((__IOSWITCH__) == RI_IOSWITCH_CH19) || \
  216. ((__IOSWITCH__) == RI_IOSWITCH_CH20) || ((__IOSWITCH__) == RI_IOSWITCH_CH21) || \
  217. ((__IOSWITCH__) == RI_IOSWITCH_CH22) || ((__IOSWITCH__) == RI_IOSWITCH_CH23) || \
  218. ((__IOSWITCH__) == RI_IOSWITCH_CH24) || ((__IOSWITCH__) == RI_IOSWITCH_CH25) || \
  219. ((__IOSWITCH__) == RI_IOSWITCH_VCOMP) || ((__IOSWITCH__) == RI_IOSWITCH_CH27) || \
  220. ((__IOSWITCH__) == RI_IOSWITCH_CH28) || ((__IOSWITCH__) == RI_IOSWITCH_CH29) || \
  221. ((__IOSWITCH__) == RI_IOSWITCH_CH30) || ((__IOSWITCH__) == RI_IOSWITCH_CH31) || \
  222. ((__IOSWITCH__) == RI_IOSWITCH_GR10_1) || ((__IOSWITCH__) == RI_IOSWITCH_GR10_2) || \
  223. ((__IOSWITCH__) == RI_IOSWITCH_GR10_3) || ((__IOSWITCH__) == RI_IOSWITCH_GR10_4) || \
  224. ((__IOSWITCH__) == RI_IOSWITCH_GR6_1) || ((__IOSWITCH__) == RI_IOSWITCH_GR6_2) || \
  225. ((__IOSWITCH__) == RI_IOSWITCH_GR6_3) || ((__IOSWITCH__) == RI_IOSWITCH_GR6_4) || \
  226. ((__IOSWITCH__) == RI_IOSWITCH_GR5_1) || ((__IOSWITCH__) == RI_IOSWITCH_GR5_2) || \
  227. ((__IOSWITCH__) == RI_IOSWITCH_GR5_3) || ((__IOSWITCH__) == RI_IOSWITCH_GR4_1) || \
  228. ((__IOSWITCH__) == RI_IOSWITCH_GR4_2) || ((__IOSWITCH__) == RI_IOSWITCH_GR4_3) || \
  229. ((__IOSWITCH__) == RI_IOSWITCH_CH0b) || ((__IOSWITCH__) == RI_IOSWITCH_CH1b) || \
  230. ((__IOSWITCH__) == RI_IOSWITCH_CH2b) || ((__IOSWITCH__) == RI_IOSWITCH_CH3b) || \
  231. ((__IOSWITCH__) == RI_IOSWITCH_CH6b) || ((__IOSWITCH__) == RI_IOSWITCH_CH7b) || \
  232. ((__IOSWITCH__) == RI_IOSWITCH_CH8b) || ((__IOSWITCH__) == RI_IOSWITCH_CH9b) || \
  233. ((__IOSWITCH__) == RI_IOSWITCH_CH10b) || ((__IOSWITCH__) == RI_IOSWITCH_CH11b) || \
  234. ((__IOSWITCH__) == RI_IOSWITCH_CH12b))
  235. #else /* !RI_ASCR2_CH1b */
  236. #if defined (RI_ASCR2_CH0b) /* STM32L1 devices category Cat.3 */
  237. #define IS_RI_IOSWITCH(__IOSWITCH__) (((__IOSWITCH__) == RI_IOSWITCH_CH0) || ((__IOSWITCH__) == RI_IOSWITCH_CH1) || \
  238. ((__IOSWITCH__) == RI_IOSWITCH_CH2) || ((__IOSWITCH__) == RI_IOSWITCH_CH3) || \
  239. ((__IOSWITCH__) == RI_IOSWITCH_CH4) || ((__IOSWITCH__) == RI_IOSWITCH_CH5) || \
  240. ((__IOSWITCH__) == RI_IOSWITCH_CH6) || ((__IOSWITCH__) == RI_IOSWITCH_CH7) || \
  241. ((__IOSWITCH__) == RI_IOSWITCH_CH8) || ((__IOSWITCH__) == RI_IOSWITCH_CH9) || \
  242. ((__IOSWITCH__) == RI_IOSWITCH_CH10) || ((__IOSWITCH__) == RI_IOSWITCH_CH11) || \
  243. ((__IOSWITCH__) == RI_IOSWITCH_CH12) || ((__IOSWITCH__) == RI_IOSWITCH_CH13) || \
  244. ((__IOSWITCH__) == RI_IOSWITCH_CH14) || ((__IOSWITCH__) == RI_IOSWITCH_CH15) || \
  245. ((__IOSWITCH__) == RI_IOSWITCH_CH18) || ((__IOSWITCH__) == RI_IOSWITCH_CH19) || \
  246. ((__IOSWITCH__) == RI_IOSWITCH_CH20) || ((__IOSWITCH__) == RI_IOSWITCH_CH21) || \
  247. ((__IOSWITCH__) == RI_IOSWITCH_CH22) || ((__IOSWITCH__) == RI_IOSWITCH_CH23) || \
  248. ((__IOSWITCH__) == RI_IOSWITCH_CH24) || ((__IOSWITCH__) == RI_IOSWITCH_CH25) || \
  249. ((__IOSWITCH__) == RI_IOSWITCH_VCOMP) || ((__IOSWITCH__) == RI_IOSWITCH_GR10_1) || \
  250. ((__IOSWITCH__) == RI_IOSWITCH_GR10_2) || ((__IOSWITCH__) == RI_IOSWITCH_GR10_3) || \
  251. ((__IOSWITCH__) == RI_IOSWITCH_GR10_4) || ((__IOSWITCH__) == RI_IOSWITCH_GR6_1) || \
  252. ((__IOSWITCH__) == RI_IOSWITCH_GR6_2) || ((__IOSWITCH__) == RI_IOSWITCH_GR5_1) || \
  253. ((__IOSWITCH__) == RI_IOSWITCH_GR5_2) || ((__IOSWITCH__) == RI_IOSWITCH_GR5_3) || \
  254. ((__IOSWITCH__) == RI_IOSWITCH_GR4_1) || ((__IOSWITCH__) == RI_IOSWITCH_GR4_2) || \
  255. ((__IOSWITCH__) == RI_IOSWITCH_GR4_3) || ((__IOSWITCH__) == RI_IOSWITCH_CH0b))
  256. #else /* !RI_ASCR2_CH0b */ /* STM32L1 devices category Cat.1 and Cat.2 */
  257. #define IS_RI_IOSWITCH(__IOSWITCH__) (((__IOSWITCH__) == RI_IOSWITCH_CH0) || ((__IOSWITCH__) == RI_IOSWITCH_CH1) || \
  258. ((__IOSWITCH__) == RI_IOSWITCH_CH2) || ((__IOSWITCH__) == RI_IOSWITCH_CH3) || \
  259. ((__IOSWITCH__) == RI_IOSWITCH_CH4) || ((__IOSWITCH__) == RI_IOSWITCH_CH5) || \
  260. ((__IOSWITCH__) == RI_IOSWITCH_CH6) || ((__IOSWITCH__) == RI_IOSWITCH_CH7) || \
  261. ((__IOSWITCH__) == RI_IOSWITCH_CH8) || ((__IOSWITCH__) == RI_IOSWITCH_CH9) || \
  262. ((__IOSWITCH__) == RI_IOSWITCH_CH10) || ((__IOSWITCH__) == RI_IOSWITCH_CH11) || \
  263. ((__IOSWITCH__) == RI_IOSWITCH_CH12) || ((__IOSWITCH__) == RI_IOSWITCH_CH13) || \
  264. ((__IOSWITCH__) == RI_IOSWITCH_CH14) || ((__IOSWITCH__) == RI_IOSWITCH_CH15) || \
  265. ((__IOSWITCH__) == RI_IOSWITCH_CH18) || ((__IOSWITCH__) == RI_IOSWITCH_CH19) || \
  266. ((__IOSWITCH__) == RI_IOSWITCH_CH20) || ((__IOSWITCH__) == RI_IOSWITCH_CH21) || \
  267. ((__IOSWITCH__) == RI_IOSWITCH_CH22) || ((__IOSWITCH__) == RI_IOSWITCH_CH23) || \
  268. ((__IOSWITCH__) == RI_IOSWITCH_CH24) || ((__IOSWITCH__) == RI_IOSWITCH_CH25) || \
  269. ((__IOSWITCH__) == RI_IOSWITCH_VCOMP) || ((__IOSWITCH__) == RI_IOSWITCH_GR10_1) || \
  270. ((__IOSWITCH__) == RI_IOSWITCH_GR10_2) || ((__IOSWITCH__) == RI_IOSWITCH_GR10_3) || \
  271. ((__IOSWITCH__) == RI_IOSWITCH_GR10_4) || ((__IOSWITCH__) == RI_IOSWITCH_GR6_1) || \
  272. ((__IOSWITCH__) == RI_IOSWITCH_GR6_2) || ((__IOSWITCH__) == RI_IOSWITCH_GR5_1) || \
  273. ((__IOSWITCH__) == RI_IOSWITCH_GR5_2) || ((__IOSWITCH__) == RI_IOSWITCH_GR5_3) || \
  274. ((__IOSWITCH__) == RI_IOSWITCH_GR4_1) || ((__IOSWITCH__) == RI_IOSWITCH_GR4_2) || \
  275. ((__IOSWITCH__) == RI_IOSWITCH_GR4_3))
  276. #endif /* RI_ASCR2_CH0b */
  277. #endif /* RI_ASCR2_CH1b */
  278. /**
  279. * @}
  280. */
  281. /** @defgroup RI_Pin PIN define
  282. * @{
  283. */
  284. #define RI_PIN_0 ((uint16_t)0x0001) /*!< Pin 0 selected */
  285. #define RI_PIN_1 ((uint16_t)0x0002) /*!< Pin 1 selected */
  286. #define RI_PIN_2 ((uint16_t)0x0004) /*!< Pin 2 selected */
  287. #define RI_PIN_3 ((uint16_t)0x0008) /*!< Pin 3 selected */
  288. #define RI_PIN_4 ((uint16_t)0x0010) /*!< Pin 4 selected */
  289. #define RI_PIN_5 ((uint16_t)0x0020) /*!< Pin 5 selected */
  290. #define RI_PIN_6 ((uint16_t)0x0040) /*!< Pin 6 selected */
  291. #define RI_PIN_7 ((uint16_t)0x0080) /*!< Pin 7 selected */
  292. #define RI_PIN_8 ((uint16_t)0x0100) /*!< Pin 8 selected */
  293. #define RI_PIN_9 ((uint16_t)0x0200) /*!< Pin 9 selected */
  294. #define RI_PIN_10 ((uint16_t)0x0400) /*!< Pin 10 selected */
  295. #define RI_PIN_11 ((uint16_t)0x0800) /*!< Pin 11 selected */
  296. #define RI_PIN_12 ((uint16_t)0x1000) /*!< Pin 12 selected */
  297. #define RI_PIN_13 ((uint16_t)0x2000) /*!< Pin 13 selected */
  298. #define RI_PIN_14 ((uint16_t)0x4000) /*!< Pin 14 selected */
  299. #define RI_PIN_15 ((uint16_t)0x8000) /*!< Pin 15 selected */
  300. #define RI_PIN_ALL ((uint16_t)0xFFFF) /*!< All pins selected */
  301. #define IS_RI_PIN(__PIN__) ((__PIN__) != (uint16_t)0x00)
  302. /**
  303. * @}
  304. */
  305. /**
  306. * @}
  307. */
  308. /**
  309. * @}
  310. */
  311. /* Exported macro ------------------------------------------------------------*/
  312. /** @defgroup HAL_Exported_Macros HAL Exported Macros
  313. * @{
  314. */
  315. /** @defgroup DBGMCU_Macros DBGMCU: Debug MCU
  316. * @{
  317. */
  318. /** @defgroup DBGMCU_Freeze_Unfreeze Freeze Unfreeze Peripherals in Debug mode
  319. * @brief Freeze/Unfreeze Peripherals in Debug mode
  320. * @{
  321. */
  322. /**
  323. * @brief TIM2 Peripherals Debug mode
  324. */
  325. #if defined (DBGMCU_APB1_FZ_DBG_TIM2_STOP)
  326. #define __HAL_DBGMCU_FREEZE_TIM2() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM2_STOP)
  327. #define __HAL_DBGMCU_UNFREEZE_TIM2() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM2_STOP)
  328. #endif
  329. /**
  330. * @brief TIM3 Peripherals Debug mode
  331. */
  332. #if defined (DBGMCU_APB1_FZ_DBG_TIM3_STOP)
  333. #define __HAL_DBGMCU_FREEZE_TIM3() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM3_STOP)
  334. #define __HAL_DBGMCU_UNFREEZE_TIM3() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM3_STOP)
  335. #endif
  336. /**
  337. * @brief TIM4 Peripherals Debug mode
  338. */
  339. #if defined (DBGMCU_APB1_FZ_DBG_TIM4_STOP)
  340. #define __HAL_DBGMCU_FREEZE_TIM4() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM4_STOP)
  341. #define __HAL_DBGMCU_UNFREEZE_TIM4() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM4_STOP)
  342. #endif
  343. /**
  344. * @brief TIM5 Peripherals Debug mode
  345. */
  346. #if defined (DBGMCU_APB1_FZ_DBG_TIM5_STOP)
  347. #define __HAL_DBGMCU_FREEZE_TIM5() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM5_STOP)
  348. #define __HAL_DBGMCU_UNFREEZE_TIM5() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM5_STOP)
  349. #endif
  350. /**
  351. * @brief TIM6 Peripherals Debug mode
  352. */
  353. #if defined (DBGMCU_APB1_FZ_DBG_TIM6_STOP)
  354. #define __HAL_DBGMCU_FREEZE_TIM6() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM6_STOP)
  355. #define __HAL_DBGMCU_UNFREEZE_TIM6() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM6_STOP)
  356. #endif
  357. /**
  358. * @brief TIM7 Peripherals Debug mode
  359. */
  360. #if defined (DBGMCU_APB1_FZ_DBG_TIM7_STOP)
  361. #define __HAL_DBGMCU_FREEZE_TIM7() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM7_STOP)
  362. #define __HAL_DBGMCU_UNFREEZE_TIM7() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_TIM7_STOP)
  363. #endif
  364. /**
  365. * @brief RTC Peripherals Debug mode
  366. */
  367. #if defined (DBGMCU_APB1_FZ_DBG_RTC_STOP)
  368. #define __HAL_DBGMCU_FREEZE_RTC() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_RTC_STOP)
  369. #define __HAL_DBGMCU_UNFREEZE_RTC() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_RTC_STOP)
  370. #endif
  371. /**
  372. * @brief WWDG Peripherals Debug mode
  373. */
  374. #if defined (DBGMCU_APB1_FZ_DBG_WWDG_STOP)
  375. #define __HAL_DBGMCU_FREEZE_WWDG() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_WWDG_STOP)
  376. #define __HAL_DBGMCU_UNFREEZE_WWDG() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_WWDG_STOP)
  377. #endif
  378. /**
  379. * @brief IWDG Peripherals Debug mode
  380. */
  381. #if defined (DBGMCU_APB1_FZ_DBG_IWDG_STOP)
  382. #define __HAL_DBGMCU_FREEZE_IWDG() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_IWDG_STOP)
  383. #define __HAL_DBGMCU_UNFREEZE_IWDG() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_IWDG_STOP)
  384. #endif
  385. /**
  386. * @brief I2C1 Peripherals Debug mode
  387. */
  388. #if defined (DBGMCU_APB1_FZ_DBG_I2C1_SMBUS_TIMEOUT)
  389. #define __HAL_DBGMCU_FREEZE_I2C1_TIMEOUT() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_I2C1_SMBUS_TIMEOUT)
  390. #define __HAL_DBGMCU_UNFREEZE_I2C1_TIMEOUT() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_I2C1_SMBUS_TIMEOUT)
  391. #endif
  392. /**
  393. * @brief I2C2 Peripherals Debug mode
  394. */
  395. #if defined (DBGMCU_APB1_FZ_DBG_I2C2_SMBUS_TIMEOUT)
  396. #define __HAL_DBGMCU_FREEZE_I2C2_TIMEOUT() SET_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_I2C2_SMBUS_TIMEOUT)
  397. #define __HAL_DBGMCU_UNFREEZE_I2C2_TIMEOUT() CLEAR_BIT(DBGMCU->APB1FZ, DBGMCU_APB1_FZ_DBG_I2C2_SMBUS_TIMEOUT)
  398. #endif
  399. /**
  400. * @brief TIM9 Peripherals Debug mode
  401. */
  402. #if defined (DBGMCU_APB2_FZ_DBG_TIM9_STOP)
  403. #define __HAL_DBGMCU_FREEZE_TIM9() SET_BIT(DBGMCU->APB2FZ, DBGMCU_APB2_FZ_DBG_TIM9_STOP)
  404. #define __HAL_DBGMCU_UNFREEZE_TIM9() CLEAR_BIT(DBGMCU->APB2FZ, DBGMCU_APB2_FZ_DBG_TIM9_STOP)
  405. #endif
  406. /**
  407. * @brief TIM10 Peripherals Debug mode
  408. */
  409. #if defined (DBGMCU_APB2_FZ_DBG_TIM10_STOP)
  410. #define __HAL_DBGMCU_FREEZE_TIM10() SET_BIT(DBGMCU->APB2FZ, DBGMCU_APB2_FZ_DBG_TIM10_STOP)
  411. #define __HAL_DBGMCU_UNFREEZE_TIM10() CLEAR_BIT(DBGMCU->APB2FZ, DBGMCU_APB2_FZ_DBG_TIM10_STOP)
  412. #endif
  413. /**
  414. * @brief TIM11 Peripherals Debug mode
  415. */
  416. #if defined (DBGMCU_APB2_FZ_DBG_TIM11_STOP)
  417. #define __HAL_DBGMCU_FREEZE_TIM11() SET_BIT(DBGMCU->APB2FZ, DBGMCU_APB2_FZ_DBG_TIM11_STOP)
  418. #define __HAL_DBGMCU_UNFREEZE_TIM11() CLEAR_BIT(DBGMCU->APB2FZ, DBGMCU_APB2_FZ_DBG_TIM11_STOP)
  419. #endif
  420. /**
  421. * @}
  422. */
  423. /**
  424. * @}
  425. */
  426. /** @defgroup SYSCFG_Macros SYSCFG: SYStem ConFiG
  427. * @{
  428. */
  429. /** @defgroup SYSCFG_VrefInt VREFINT configuration
  430. * @{
  431. */
  432. /**
  433. * @brief Enables or disables the output of internal reference voltage
  434. * (VREFINT) on I/O pin.
  435. * The VREFINT output can be routed to any I/O in group 3:
  436. * - For Cat.1 and Cat.2 devices: CH8 (PB0) or CH9 (PB1).
  437. * - For Cat.3 devices: CH8 (PB0), CH9 (PB1) or CH0b (PB2).
  438. * - For Cat.4 and Cat.5 devices: CH8 (PB0), CH9 (PB1), CH0b (PB2),
  439. * CH1b (PF11) or CH2b (PF12).
  440. * Note: Comparator peripheral clock must be preliminarility enabled,
  441. * either in COMP user function "HAL_COMP_MspInit()" (should be
  442. * done if comparators are used) or by direct clock enable:
  443. * Refer to macro "__HAL_RCC_COMP_CLK_ENABLE()".
  444. * Note: In addition with this macro, Vrefint output buffer must be
  445. * connected to the selected I/O pin. Refer to macro
  446. * "__HAL_RI_IOSWITCH_CLOSE()".
  447. * @note ENABLE: Internal reference voltage connected to I/O group 3
  448. * @note DISABLE: Internal reference voltage disconnected from I/O group 3
  449. * @retval None
  450. */
  451. #define __HAL_SYSCFG_VREFINT_OUT_ENABLE() SET_BIT(COMP->CSR, COMP_CSR_VREFOUTEN)
  452. #define __HAL_SYSCFG_VREFINT_OUT_DISABLE() CLEAR_BIT(COMP->CSR, COMP_CSR_VREFOUTEN)
  453. /**
  454. * @}
  455. */
  456. /** @defgroup SYSCFG_BootModeConfig Boot Mode Configuration
  457. * @{
  458. */
  459. /**
  460. * @brief Main Flash memory mapped at 0x00000000
  461. */
  462. #define __HAL_SYSCFG_REMAPMEMORY_FLASH() CLEAR_BIT(SYSCFG->MEMRMP, SYSCFG_MEMRMP_MEM_MODE)
  463. /** @brief System Flash memory mapped at 0x00000000
  464. */
  465. #define __HAL_SYSCFG_REMAPMEMORY_SYSTEMFLASH() MODIFY_REG(SYSCFG->MEMRMP, SYSCFG_MEMRMP_MEM_MODE, SYSCFG_MEMRMP_MEM_MODE_0)
  466. /** @brief Embedded SRAM mapped at 0x00000000
  467. */
  468. #define __HAL_SYSCFG_REMAPMEMORY_SRAM() MODIFY_REG(SYSCFG->MEMRMP, SYSCFG_MEMRMP_MEM_MODE, SYSCFG_MEMRMP_MEM_MODE_0 | SYSCFG_MEMRMP_MEM_MODE_1)
  469. #if defined(FSMC_R_BASE)
  470. /** @brief FSMC Bank1 (NOR/PSRAM 1 and 2) mapped at 0x00000000
  471. */
  472. #define __HAL_SYSCFG_REMAPMEMORY_FSMC() MODIFY_REG(SYSCFG->MEMRMP, SYSCFG_MEMRMP_MEM_MODE, SYSCFG_MEMRMP_MEM_MODE_1)
  473. #endif /* FSMC_R_BASE */
  474. /**
  475. * @brief Returns the boot mode as configured by user.
  476. * @retval The boot mode as configured by user. The returned value can be one
  477. * of the following values:
  478. * @arg SYSCFG_BOOT_MAINFLASH
  479. * @arg SYSCFG_BOOT_SYSTEMFLASH
  480. * @arg SYSCFG_BOOT_FSMC (available only for STM32L151xD, STM32L152xD & STM32L162xD)
  481. * @arg SYSCFG_BOOT_SRAM
  482. */
  483. #define __HAL_SYSCFG_GET_BOOT_MODE() READ_BIT(SYSCFG->MEMRMP, SYSCFG_MEMRMP_BOOT_MODE)
  484. /**
  485. * @}
  486. */
  487. /** @defgroup SYSCFG_USBConfig USB DP line Configuration
  488. * @{
  489. */
  490. /**
  491. * @brief Control the internal pull-up on USB DP line.
  492. */
  493. #define __HAL_SYSCFG_USBPULLUP_ENABLE() SET_BIT(SYSCFG->PMC, SYSCFG_PMC_USB_PU)
  494. #define __HAL_SYSCFG_USBPULLUP_DISABLE() CLEAR_BIT(SYSCFG->PMC, SYSCFG_PMC_USB_PU)
  495. /**
  496. * @}
  497. */
  498. /**
  499. * @}
  500. */
  501. /** @defgroup RI_Macris RI: Routing Interface
  502. * @{
  503. */
  504. /** @defgroup RI_InputCaputureConfig Input Capture configuration
  505. * @{
  506. */
  507. /**
  508. * @brief Configures the routing interface to map Input Capture 1 of TIMx to a selected I/O pin.
  509. * @param __TIMSELECT__: Timer select.
  510. * This parameter can be one of the following values:
  511. * @arg TIM_SELECT_NONE: No timer selected and default Timer mapping is enabled.
  512. * @arg TIM_SELECT_TIM2: Timer 2 Input Captures to be routed.
  513. * @arg TIM_SELECT_TIM3: Timer 3 Input Captures to be routed.
  514. * @arg TIM_SELECT_TIM4: Timer 4 Input Captures to be routed.
  515. * @param __INPUT__: selects which pin to be routed to Input Capture.
  516. * This parameter must be a value of @ref RI_InputCaptureRouting
  517. * e.g.
  518. * __HAL_RI_REMAP_INPUTCAPTURE1(TIM_SELECT_TIM2, RI_INPUTCAPTUREROUTING_1)
  519. * allows routing of Input capture IC1 of TIM2 to PA4.
  520. * For details about correspondence between RI_INPUTCAPTUREROUTING_x
  521. * and I/O pins refer to the parameters' description in the header file
  522. * or refer to the product reference manual.
  523. * @note Input capture selection bits are not reset by this function.
  524. * To reset input capture selection bits, use SYSCFG_RIDeInit() function.
  525. * @note The I/O should be configured in alternate function mode (AF14) using
  526. * GPIO_PinAFConfig() function.
  527. * @retval None.
  528. */
  529. #define __HAL_RI_REMAP_INPUTCAPTURE1(__TIMSELECT__, __INPUT__) \
  530. do {assert_param(IS_RI_TIM(__TIMSELECT__)); \
  531. assert_param(IS_RI_INPUTCAPTURE_ROUTING(__INPUT__)); \
  532. MODIFY_REG(RI->ICR, RI_ICR_TIM, (__TIMSELECT__)); \
  533. SET_BIT(RI->ICR, RI_INPUTCAPTURE_IC1); \
  534. MODIFY_REG(RI->ICR, RI_ICR_IC1OS, (__INPUT__) << POSITION_VAL(RI_ICR_IC1OS)); \
  535. }while(0)
  536. /**
  537. * @brief Configures the routing interface to map Input Capture 2 of TIMx to a selected I/O pin.
  538. * @param __TIMSELECT__: Timer select.
  539. * This parameter can be one of the following values:
  540. * @arg TIM_SELECT_NONE: No timer selected and default Timer mapping is enabled.
  541. * @arg TIM_SELECT_TIM2: Timer 2 Input Captures to be routed.
  542. * @arg TIM_SELECT_TIM3: Timer 3 Input Captures to be routed.
  543. * @arg TIM_SELECT_TIM4: Timer 4 Input Captures to be routed.
  544. * @param __INPUT__: selects which pin to be routed to Input Capture.
  545. * This parameter must be a value of @ref RI_InputCaptureRouting
  546. * @retval None.
  547. */
  548. #define __HAL_RI_REMAP_INPUTCAPTURE2(__TIMSELECT__, __INPUT__) \
  549. do {assert_param(IS_RI_TIM(__TIMSELECT__)); \
  550. assert_param(IS_RI_INPUTCAPTURE_ROUTING(__INPUT__)); \
  551. MODIFY_REG(RI->ICR, RI_ICR_TIM, (__TIMSELECT__)); \
  552. SET_BIT(RI->ICR, RI_INPUTCAPTURE_IC2); \
  553. MODIFY_REG(RI->ICR, RI_ICR_IC2OS, (__INPUT__) << POSITION_VAL(RI_ICR_IC2OS)); \
  554. }while(0)
  555. /**
  556. * @brief Configures the routing interface to map Input Capture 3 of TIMx to a selected I/O pin.
  557. * @param __TIMSELECT__: Timer select.
  558. * This parameter can be one of the following values:
  559. * @arg TIM_SELECT_NONE: No timer selected and default Timer mapping is enabled.
  560. * @arg TIM_SELECT_TIM2: Timer 2 Input Captures to be routed.
  561. * @arg TIM_SELECT_TIM3: Timer 3 Input Captures to be routed.
  562. * @arg TIM_SELECT_TIM4: Timer 4 Input Captures to be routed.
  563. * @param __INPUT__: selects which pin to be routed to Input Capture.
  564. * This parameter must be a value of @ref RI_InputCaptureRouting
  565. * @retval None.
  566. */
  567. #define __HAL_RI_REMAP_INPUTCAPTURE3(__TIMSELECT__, __INPUT__) \
  568. do {assert_param(IS_RI_TIM(__TIMSELECT__)); \
  569. assert_param(IS_RI_INPUTCAPTURE_ROUTING(__INPUT__)); \
  570. MODIFY_REG(RI->ICR, RI_ICR_TIM, (__TIMSELECT__)); \
  571. SET_BIT(RI->ICR, RI_INPUTCAPTURE_IC3); \
  572. MODIFY_REG(RI->ICR, RI_ICR_IC3OS, (__INPUT__) << POSITION_VAL(RI_ICR_IC3OS)); \
  573. }while(0)
  574. /**
  575. * @brief Configures the routing interface to map Input Capture 4 of TIMx to a selected I/O pin.
  576. * @param __TIMSELECT__: Timer select.
  577. * This parameter can be one of the following values:
  578. * @arg TIM_SELECT_NONE: No timer selected and default Timer mapping is enabled.
  579. * @arg TIM_SELECT_TIM2: Timer 2 Input Captures to be routed.
  580. * @arg TIM_SELECT_TIM3: Timer 3 Input Captures to be routed.
  581. * @arg TIM_SELECT_TIM4: Timer 4 Input Captures to be routed.
  582. * @param __INPUT__: selects which pin to be routed to Input Capture.
  583. * This parameter must be a value of @ref RI_InputCaptureRouting
  584. * @retval None.
  585. */
  586. #define __HAL_RI_REMAP_INPUTCAPTURE4(__TIMSELECT__, __INPUT__) \
  587. do {assert_param(IS_RI_TIM(__TIMSELECT__)); \
  588. assert_param(IS_RI_INPUTCAPTURE_ROUTING(__INPUT__)); \
  589. MODIFY_REG(RI->ICR, RI_ICR_TIM, (__TIMSELECT__)); \
  590. SET_BIT(RI->ICR, RI_INPUTCAPTURE_IC4); \
  591. MODIFY_REG(RI->ICR, RI_ICR_IC4OS, (__INPUT__) << POSITION_VAL(RI_ICR_IC4OS)); \
  592. }while(0)
  593. /**
  594. * @}
  595. */
  596. /** @defgroup RI_SwitchControlConfig Switch Control configuration
  597. * @{
  598. */
  599. /**
  600. * @brief Enable or disable the switch control mode.
  601. * @note ENABLE: ADC analog switches closed if the corresponding
  602. * I/O switch is also closed.
  603. * When using COMP1, switch control mode must be enabled.
  604. * @note DISABLE: ADC analog switches open or controlled by the ADC interface.
  605. * When using the ADC for acquisition, switch control mode
  606. * must be disabled.
  607. * @note COMP1 comparator and ADC cannot be used at the same time since
  608. * they share the ADC switch matrix.
  609. * @retval None
  610. */
  611. #define __HAL_RI_SWITCHCONTROLMODE_ENABLE() SET_BIT(RI->ASCR1, RI_ASCR1_SCM)
  612. #define __HAL_RI_SWITCHCONTROLMODE_DISABLE() CLEAR_BIT(RI->ASCR1, RI_ASCR1_SCM)
  613. /*
  614. * @brief Close or Open the routing interface Input Output switches.
  615. * @param __IOSWITCH__: selects the I/O analog switch number.
  616. * This parameter must be a value of @ref RI_IOSwitch
  617. * @retval None
  618. */
  619. #define __HAL_RI_IOSWITCH_CLOSE(__IOSWITCH__) do { assert_param(IS_RI_IOSWITCH(__IOSWITCH__)); \
  620. if ((__IOSWITCH__) >> 31 != 0 ) \
  621. { \
  622. SET_BIT(RI->ASCR1, (__IOSWITCH__) & 0x7FFFFFFF); \
  623. } \
  624. else \
  625. { \
  626. SET_BIT(RI->ASCR2, (__IOSWITCH__)); \
  627. } \
  628. }while(0)
  629. #define __HAL_RI_IOSWITCH_OPEN(__IOSWITCH__) do { assert_param(IS_RI_IOSWITCH(__IOSWITCH__)); \
  630. if ((__IOSWITCH__) >> 31 != 0 ) \
  631. { \
  632. CLEAR_BIT(RI->ASCR1, (__IOSWITCH__) & 0x7FFFFFFF); \
  633. } \
  634. else \
  635. { \
  636. CLEAR_BIT(RI->ASCR2, (__IOSWITCH__)); \
  637. } \
  638. }while(0)
  639. #if defined (COMP_CSR_SW1)
  640. /**
  641. * @brief Close or open the internal switch COMP1_SW1.
  642. * This switch connects I/O pin PC3 (can be used as ADC channel 13)
  643. * and OPAMP3 ouput to ADC switch matrix (ADC channel VCOMP, channel
  644. * 26) and COMP1 non-inverting input.
  645. * Pin PC3 connection depends on another switch setting, refer to
  646. * macro "__HAL_ADC_CHANNEL_SPEED_FAST()".
  647. * @retval None.
  648. */
  649. #define __HAL_RI_SWITCH_COMP1_SW1_CLOSE() SET_BIT(COMP->CSR, COMP_CSR_SW1)
  650. #define __HAL_RI_SWITCH_COMP1_SW1_OPEN() CLEAR_BIT(COMP->CSR, COMP_CSR_SW1)
  651. #endif /* COMP_CSR_SW1 */
  652. /**
  653. * @}
  654. */
  655. /** @defgroup RI_HystConfig Hysteresis Activation and Deactivation
  656. * @{
  657. */
  658. /**
  659. * @brief Enable or disable Hysteresis of the input schmitt triger of Ports A
  660. * When the I/Os are programmed in input mode by standard I/O port
  661. * registers, the Schmitt trigger and the hysteresis are enabled by default.
  662. * When hysteresis is disabled, it is possible to read the
  663. * corresponding port with a trigger level of VDDIO/2.
  664. * @param __IOPIN__ : Selects the pin(s) on which to enable or disable hysteresis.
  665. * This parameter must be a value of @ref RI_Pin
  666. * @retval None
  667. */
  668. #define __HAL_RI_HYSTERIS_PORTA_ON(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  669. CLEAR_BIT(RI->HYSCR1, (__IOPIN__)); \
  670. } while(0)
  671. #define __HAL_RI_HYSTERIS_PORTA_OFF(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  672. SET_BIT(RI->HYSCR1, (__IOPIN__)); \
  673. } while(0)
  674. /**
  675. * @brief Enable or disable Hysteresis of the input schmitt triger of Ports B
  676. * When the I/Os are programmed in input mode by standard I/O port
  677. * registers, the Schmitt trigger and the hysteresis are enabled by default.
  678. * When hysteresis is disabled, it is possible to read the
  679. * corresponding port with a trigger level of VDDIO/2.
  680. * @param __IOPIN__ : Selects the pin(s) on which to enable or disable hysteresis.
  681. * This parameter must be a value of @ref RI_Pin
  682. * @retval None
  683. */
  684. #define __HAL_RI_HYSTERIS_PORTB_ON(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  685. CLEAR_BIT(RI->HYSCR1, (__IOPIN__) << 16 ); \
  686. } while(0)
  687. #define __HAL_RI_HYSTERIS_PORTB_OFF(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  688. SET_BIT(RI->HYSCR1, (__IOPIN__) << 16 ); \
  689. } while(0)
  690. /**
  691. * @brief Enable or disable Hysteresis of the input schmitt triger of Ports C
  692. * When the I/Os are programmed in input mode by standard I/O port
  693. * registers, the Schmitt trigger and the hysteresis are enabled by default.
  694. * When hysteresis is disabled, it is possible to read the
  695. * corresponding port with a trigger level of VDDIO/2.
  696. * @param __IOPIN__ : Selects the pin(s) on which to enable or disable hysteresis.
  697. * This parameter must be a value of @ref RI_Pin
  698. * @retval None
  699. */
  700. #define __HAL_RI_HYSTERIS_PORTC_ON(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  701. CLEAR_BIT(RI->HYSCR2, (__IOPIN__)); \
  702. } while(0)
  703. #define __HAL_RI_HYSTERIS_PORTC_OFF(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  704. SET_BIT(RI->HYSCR2, (__IOPIN__)); \
  705. } while(0)
  706. /**
  707. * @brief Enable or disable Hysteresis of the input schmitt triger of Ports D
  708. * When the I/Os are programmed in input mode by standard I/O port
  709. * registers, the Schmitt trigger and the hysteresis are enabled by default.
  710. * When hysteresis is disabled, it is possible to read the
  711. * corresponding port with a trigger level of VDDIO/2.
  712. * @param __IOPIN__ : Selects the pin(s) on which to enable or disable hysteresis.
  713. * This parameter must be a value of @ref RI_Pin
  714. * @retval None
  715. */
  716. #define __HAL_RI_HYSTERIS_PORTD_ON(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  717. CLEAR_BIT(RI->HYSCR2, (__IOPIN__) << 16 ); \
  718. } while(0)
  719. #define __HAL_RI_HYSTERIS_PORTD_OFF(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  720. SET_BIT(RI->HYSCR2, (__IOPIN__) << 16 ); \
  721. } while(0)
  722. #if defined (GPIOE_BASE)
  723. /**
  724. * @brief Enable or disable Hysteresis of the input schmitt triger of Ports E
  725. * When the I/Os are programmed in input mode by standard I/O port
  726. * registers, the Schmitt trigger and the hysteresis are enabled by default.
  727. * When hysteresis is disabled, it is possible to read the
  728. * corresponding port with a trigger level of VDDIO/2.
  729. * @param __IOPIN__ : Selects the pin(s) on which to enable or disable hysteresis.
  730. * This parameter must be a value of @ref RI_Pin
  731. * @retval None
  732. */
  733. #define __HAL_RI_HYSTERIS_PORTE_ON(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  734. CLEAR_BIT(RI->HYSCR3, (__IOPIN__)); \
  735. } while(0)
  736. #define __HAL_RI_HYSTERIS_PORTE_OFF(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  737. SET_BIT(RI->HYSCR3, (__IOPIN__)); \
  738. } while(0)
  739. #endif /* GPIOE_BASE */
  740. #if defined(GPIOF_BASE) || defined(GPIOG_BASE)
  741. /**
  742. * @brief Enable or disable Hysteresis of the input schmitt triger of Ports F
  743. * When the I/Os are programmed in input mode by standard I/O port
  744. * registers, the Schmitt trigger and the hysteresis are enabled by default.
  745. * When hysteresis is disabled, it is possible to read the
  746. * corresponding port with a trigger level of VDDIO/2.
  747. * @param __IOPIN__ : Selects the pin(s) on which to enable or disable hysteresis.
  748. * This parameter must be a value of @ref RI_Pin
  749. * @retval None
  750. */
  751. #define __HAL_RI_HYSTERIS_PORTF_ON(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  752. CLEAR_BIT(RI->HYSCR3, (__IOPIN__) << 16 ); \
  753. } while(0)
  754. #define __HAL_RI_HYSTERIS_PORTF_OFF(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  755. SET_BIT(RI->HYSCR3, (__IOPIN__) << 16 ); \
  756. } while(0)
  757. /**
  758. * @brief Enable or disable Hysteresis of the input schmitt triger of Ports G
  759. * When the I/Os are programmed in input mode by standard I/O port
  760. * registers, the Schmitt trigger and the hysteresis are enabled by default.
  761. * When hysteresis is disabled, it is possible to read the
  762. * corresponding port with a trigger level of VDDIO/2.
  763. * @param __IOPIN__ : Selects the pin(s) on which to enable or disable hysteresis.
  764. * This parameter must be a value of @ref RI_Pin
  765. * @retval None
  766. */
  767. #define __HAL_RI_HYSTERIS_PORTG_ON(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  768. CLEAR_BIT(RI->HYSCR4, (__IOPIN__)); \
  769. } while(0)
  770. #define __HAL_RI_HYSTERIS_PORTG_OFF(__IOPIN__) do {assert_param(IS_RI_PIN(__IOPIN__)); \
  771. SET_BIT(RI->HYSCR4, (__IOPIN__)); \
  772. } while(0)
  773. #endif /* GPIOF_BASE || GPIOG_BASE */
  774. /**
  775. * @}
  776. */
  777. /**
  778. * @}
  779. */
  780. /**
  781. * @}
  782. */
  783. /* Exported functions --------------------------------------------------------*/
  784. /** @addtogroup HAL_Exported_Functions
  785. * @{
  786. */
  787. /** @addtogroup HAL_Exported_Functions_Group1
  788. * @{
  789. */
  790. /* Initialization and de-initialization functions ******************************/
  791. HAL_StatusTypeDef HAL_Init(void);
  792. HAL_StatusTypeDef HAL_DeInit(void);
  793. void HAL_MspInit(void);
  794. void HAL_MspDeInit(void);
  795. HAL_StatusTypeDef HAL_InitTick (uint32_t TickPriority);
  796. /**
  797. * @}
  798. */
  799. /** @addtogroup HAL_Exported_Functions_Group2
  800. * @{
  801. */
  802. /* Peripheral Control functions ************************************************/
  803. void HAL_IncTick(void);
  804. void HAL_Delay(__IO uint32_t Delay);
  805. uint32_t HAL_GetTick(void);
  806. void HAL_SuspendTick(void);
  807. void HAL_ResumeTick(void);
  808. uint32_t HAL_GetHalVersion(void);
  809. uint32_t HAL_GetREVID(void);
  810. uint32_t HAL_GetDEVID(void);
  811. void HAL_DBGMCU_EnableDBGSleepMode(void);
  812. void HAL_DBGMCU_DisableDBGSleepMode(void);
  813. void HAL_DBGMCU_EnableDBGStopMode(void);
  814. void HAL_DBGMCU_DisableDBGStopMode(void);
  815. void HAL_DBGMCU_EnableDBGStandbyMode(void);
  816. void HAL_DBGMCU_DisableDBGStandbyMode(void);
  817. /**
  818. * @}
  819. */
  820. /**
  821. * @}
  822. */
  823. /**
  824. * @}
  825. */
  826. /**
  827. * @}
  828. */
  829. #ifdef __cplusplus
  830. }
  831. #endif
  832. #endif /* __STM32L1xx_HAL_H */
  833. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/