stm32f7xx_hal_lptim.h 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777
  1. /**
  2. ******************************************************************************
  3. * @file stm32f7xx_hal_lptim.h
  4. * @author MCD Application Team
  5. * @brief Header file of LPTIM HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  10. *
  11. * Redistribution and use in source and binary forms, with or without modification,
  12. * are permitted provided that the following conditions are met:
  13. * 1. Redistributions of source code must retain the above copyright notice,
  14. * this list of conditions and the following disclaimer.
  15. * 2. Redistributions in binary form must reproduce the above copyright notice,
  16. * this list of conditions and the following disclaimer in the documentation
  17. * and/or other materials provided with the distribution.
  18. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  19. * may be used to endorse or promote products derived from this software
  20. * without specific prior written permission.
  21. *
  22. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  23. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  25. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  26. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  28. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  29. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  30. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  31. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32. *
  33. ******************************************************************************
  34. */
  35. /* Define to prevent recursive inclusion -------------------------------------*/
  36. #ifndef __STM32F7xx_HAL_LPTIM_H
  37. #define __STM32F7xx_HAL_LPTIM_H
  38. #ifdef __cplusplus
  39. extern "C" {
  40. #endif
  41. /* Includes ------------------------------------------------------------------*/
  42. #include "stm32f7xx_hal_def.h"
  43. /** @addtogroup STM32F7xx_HAL_Driver
  44. * @{
  45. */
  46. /** @defgroup LPTIM LPTIM
  47. * @brief LPTIM HAL module driver
  48. * @{
  49. */
  50. /* Exported types ------------------------------------------------------------*/
  51. /** @defgroup LPTIM_Exported_Types LPTIM Exported Types
  52. * @{
  53. */
  54. /** @defgroup LPTIM_WAKEUPTIMER_EXTILINE LPTIM WAKEUP Timer EXTI Line
  55. * @{
  56. */
  57. #define LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT ((uint32_t)EXTI_IMR_MR23) /*!< External interrupt line 23 Connected to the LPTIM EXTI Line */
  58. /**
  59. * @}
  60. */
  61. /**
  62. * @brief LPTIM Clock configuration definition
  63. */
  64. typedef struct
  65. {
  66. uint32_t Source; /*!< Selects the clock source.
  67. This parameter can be a value of @ref LPTIM_Clock_Source */
  68. uint32_t Prescaler; /*!< Specifies the counter clock Prescaler.
  69. This parameter can be a value of @ref LPTIM_Clock_Prescaler */
  70. }LPTIM_ClockConfigTypeDef;
  71. /**
  72. * @brief LPTIM Clock configuration definition
  73. */
  74. typedef struct
  75. {
  76. uint32_t Polarity; /*!< Selects the polarity of the active edge for the counter unit
  77. if the ULPTIM input is selected.
  78. Note: This parameter is used only when Ultra low power clock source is used.
  79. Note: If the polarity is configured on 'both edges', an auxiliary clock
  80. (one of the Low power oscillator) must be active.
  81. This parameter can be a value of @ref LPTIM_Clock_Polarity */
  82. uint32_t SampleTime; /*!< Selects the clock sampling time to configure the clock glitch filter.
  83. Note: This parameter is used only when Ultra low power clock source is used.
  84. This parameter can be a value of @ref LPTIM_Clock_Sample_Time */
  85. }LPTIM_ULPClockConfigTypeDef;
  86. /**
  87. * @brief LPTIM Trigger configuration definition
  88. */
  89. typedef struct
  90. {
  91. uint32_t Source; /*!< Selects the Trigger source.
  92. This parameter can be a value of @ref LPTIM_Trigger_Source */
  93. uint32_t ActiveEdge; /*!< Selects the Trigger active edge.
  94. Note: This parameter is used only when an external trigger is used.
  95. This parameter can be a value of @ref LPTIM_External_Trigger_Polarity */
  96. uint32_t SampleTime; /*!< Selects the trigger sampling time to configure the clock glitch filter.
  97. Note: This parameter is used only when an external trigger is used.
  98. This parameter can be a value of @ref LPTIM_Trigger_Sample_Time */
  99. }LPTIM_TriggerConfigTypeDef;
  100. /**
  101. * @brief LPTIM Initialization Structure definition
  102. */
  103. typedef struct
  104. {
  105. LPTIM_ClockConfigTypeDef Clock; /*!< Specifies the clock parameters */
  106. LPTIM_ULPClockConfigTypeDef UltraLowPowerClock; /*!< Specifies the Ultra Low Power clock parameters */
  107. LPTIM_TriggerConfigTypeDef Trigger; /*!< Specifies the Trigger parameters */
  108. uint32_t OutputPolarity; /*!< Specifies the Output polarity.
  109. This parameter can be a value of @ref LPTIM_Output_Polarity */
  110. uint32_t UpdateMode; /*!< Specifies whether the update of the autorelaod and the compare
  111. values is done immediately or after the end of current period.
  112. This parameter can be a value of @ref LPTIM_Updating_Mode */
  113. uint32_t CounterSource; /*!< Specifies whether the counter is incremented each internal event
  114. or each external event.
  115. This parameter can be a value of @ref LPTIM_Counter_Source */
  116. }LPTIM_InitTypeDef;
  117. /**
  118. * @brief HAL LPTIM State structure definition
  119. */
  120. typedef enum __HAL_LPTIM_StateTypeDef
  121. {
  122. HAL_LPTIM_STATE_RESET = 0x00U, /*!< Peripheral not yet initialized or disabled */
  123. HAL_LPTIM_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */
  124. HAL_LPTIM_STATE_BUSY = 0x02U, /*!< An internal process is ongoing */
  125. HAL_LPTIM_STATE_TIMEOUT = 0x03U, /*!< Timeout state */
  126. HAL_LPTIM_STATE_ERROR = 0x04U /*!< Internal Process is ongoing */
  127. }HAL_LPTIM_StateTypeDef;
  128. /**
  129. * @brief LPTIM handle Structure definition
  130. */
  131. typedef struct __LPTIM_HandleTypeDef
  132. {
  133. LPTIM_TypeDef *Instance; /*!< Register base address */
  134. LPTIM_InitTypeDef Init; /*!< LPTIM required parameters */
  135. HAL_StatusTypeDef Status; /*!< LPTIM peripheral status */
  136. HAL_LockTypeDef Lock; /*!< LPTIM locking object */
  137. __IO HAL_LPTIM_StateTypeDef State; /*!< LPTIM peripheral state */
  138. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  139. void (* MspInitCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Msp Init Callback */
  140. void (* MspDeInitCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Msp DeInit Callback */
  141. void (* CompareMatchCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Compare Match Callback */
  142. void (* AutoReloadMatchCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Auto Reload Match Callback */
  143. void (* TriggerCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Trigger Callback */
  144. void (* CompareWriteCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Compare Write Callback */
  145. void (* AutoReloadWriteCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Auto Reload Write Callback */
  146. void (* DirectionUpCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Direction Up Callback */
  147. void (* DirectionDownCallback) (struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Direction Down Callback */
  148. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  149. }LPTIM_HandleTypeDef;
  150. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  151. /**
  152. * @brief HAL LPTIM Callback ID enumeration definition
  153. */
  154. typedef enum
  155. {
  156. HAL_LPTIM_MSPINIT_CB_ID = 0x00U, /*!< LPTIM MspInit Callback ID */
  157. HAL_LPTIM_MSPDEINIT_CB_ID = 0x01U, /*!< LPTIM MspDeInit Callback ID */
  158. HAL_LPTIM_COMPARE_MATCH_CB_ID = 0x02U, /*!< LPTIM Compare Match Callback ID */
  159. HAL_LPTIM_AUTO_RELOAD_MATCH_CB_ID = 0x03U, /*!< LPTIM Auto Reload Match Callback ID */
  160. HAL_LPTIM_TRIGGER_CB_ID = 0x04U, /*!< LPTIM Trigger Callback ID */
  161. HAL_LPTIM_COMPARE_WRITE_CB_ID = 0x05U, /*!< LPTIM Compare Write Callback ID */
  162. HAL_LPTIM_AUTO_RELOAD_WRITE_CB_ID = 0x06U, /*!< LPTIM Auto Reload Write Callback ID */
  163. HAL_LPTIM_DIRECTION_UP_CB_ID = 0x07U, /*!< LPTIM Direction Up Callback ID */
  164. HAL_LPTIM_DIRECTION_DOWN_CB_ID = 0x08U, /*!< LPTIM Direction Down Callback ID */
  165. }HAL_LPTIM_CallbackIDTypeDef;
  166. /**
  167. * @brief HAL LPTIM Callback pointer definition
  168. */
  169. typedef void (*pLPTIM_CallbackTypeDef)(LPTIM_HandleTypeDef * hlptim); /*!< pointer to the LPTIM callback function */
  170. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  171. /**
  172. * @}
  173. */
  174. /* Exported constants --------------------------------------------------------*/
  175. /** @defgroup LPTIM_Exported_Constants LPTIM Exported Constants
  176. * @{
  177. */
  178. /** @defgroup LPTIM_Clock_Source LPTIM Clock Source
  179. * @{
  180. */
  181. #define LPTIM_CLOCKSOURCE_APBCLOCK_LPOSC ((uint32_t)0x00U)
  182. #define LPTIM_CLOCKSOURCE_ULPTIM LPTIM_CFGR_CKSEL
  183. /**
  184. * @}
  185. */
  186. /** @defgroup LPTIM_Clock_Prescaler LPTIM Clock Prescaler
  187. * @{
  188. */
  189. #define LPTIM_PRESCALER_DIV1 ((uint32_t)0x000000U)
  190. #define LPTIM_PRESCALER_DIV2 LPTIM_CFGR_PRESC_0
  191. #define LPTIM_PRESCALER_DIV4 LPTIM_CFGR_PRESC_1
  192. #define LPTIM_PRESCALER_DIV8 ((uint32_t)(LPTIM_CFGR_PRESC_0 | LPTIM_CFGR_PRESC_1))
  193. #define LPTIM_PRESCALER_DIV16 LPTIM_CFGR_PRESC_2
  194. #define LPTIM_PRESCALER_DIV32 ((uint32_t)(LPTIM_CFGR_PRESC_0 | LPTIM_CFGR_PRESC_2))
  195. #define LPTIM_PRESCALER_DIV64 ((uint32_t)(LPTIM_CFGR_PRESC_1 | LPTIM_CFGR_PRESC_2))
  196. #define LPTIM_PRESCALER_DIV128 ((uint32_t)LPTIM_CFGR_PRESC)
  197. /**
  198. * @}
  199. */
  200. /** @defgroup LPTIM_Output_Polarity LPTIM Output Polarity
  201. * @{
  202. */
  203. #define LPTIM_OUTPUTPOLARITY_HIGH ((uint32_t)0x00000000U)
  204. #define LPTIM_OUTPUTPOLARITY_LOW (LPTIM_CFGR_WAVPOL)
  205. /**
  206. * @}
  207. */
  208. /** @defgroup LPTIM_Clock_Sample_Time LPTIM Clock Sample Time
  209. * @{
  210. */
  211. #define LPTIM_CLOCKSAMPLETIME_DIRECTTRANSITION ((uint32_t)0x00000000U)
  212. #define LPTIM_CLOCKSAMPLETIME_2TRANSITIONS LPTIM_CFGR_CKFLT_0
  213. #define LPTIM_CLOCKSAMPLETIME_4TRANSITIONS LPTIM_CFGR_CKFLT_1
  214. #define LPTIM_CLOCKSAMPLETIME_8TRANSITIONS LPTIM_CFGR_CKFLT
  215. /**
  216. * @}
  217. */
  218. /** @defgroup LPTIM_Clock_Polarity LPTIM Clock Polarity
  219. * @{
  220. */
  221. #define LPTIM_CLOCKPOLARITY_RISING ((uint32_t)0x00000000U)
  222. #define LPTIM_CLOCKPOLARITY_FALLING LPTIM_CFGR_CKPOL_0
  223. #define LPTIM_CLOCKPOLARITY_RISING_FALLING LPTIM_CFGR_CKPOL_1
  224. /**
  225. * @}
  226. */
  227. /** @defgroup LPTIM_Trigger_Source LPTIM Trigger Source
  228. * @{
  229. */
  230. #define LPTIM_TRIGSOURCE_SOFTWARE ((uint32_t)0x0000FFFFU)
  231. #define LPTIM_TRIGSOURCE_0 ((uint32_t)0x00000000U)
  232. #define LPTIM_TRIGSOURCE_1 ((uint32_t)LPTIM_CFGR_TRIGSEL_0)
  233. #define LPTIM_TRIGSOURCE_2 LPTIM_CFGR_TRIGSEL_1
  234. #define LPTIM_TRIGSOURCE_3 ((uint32_t)LPTIM_CFGR_TRIGSEL_0 | LPTIM_CFGR_TRIGSEL_1)
  235. #define LPTIM_TRIGSOURCE_4 LPTIM_CFGR_TRIGSEL_2
  236. #define LPTIM_TRIGSOURCE_5 ((uint32_t)LPTIM_CFGR_TRIGSEL_0 | LPTIM_CFGR_TRIGSEL_2)
  237. /**
  238. * @}
  239. */
  240. /** @defgroup LPTIM_External_Trigger_Polarity LPTIM External Trigger Polarity
  241. * @{
  242. */
  243. #define LPTIM_ACTIVEEDGE_RISING LPTIM_CFGR_TRIGEN_0
  244. #define LPTIM_ACTIVEEDGE_FALLING LPTIM_CFGR_TRIGEN_1
  245. #define LPTIM_ACTIVEEDGE_RISING_FALLING LPTIM_CFGR_TRIGEN
  246. /**
  247. * @}
  248. */
  249. /** @defgroup LPTIM_Trigger_Sample_Time LPTIM Trigger Sample Time
  250. * @{
  251. */
  252. #define LPTIM_TRIGSAMPLETIME_DIRECTTRANSITION ((uint32_t)0x00000000U)
  253. #define LPTIM_TRIGSAMPLETIME_2TRANSITIONS LPTIM_CFGR_TRGFLT_0
  254. #define LPTIM_TRIGSAMPLETIME_4TRANSITIONS LPTIM_CFGR_TRGFLT_1
  255. #define LPTIM_TRIGSAMPLETIME_8TRANSITIONS LPTIM_CFGR_TRGFLT
  256. /**
  257. * @}
  258. */
  259. /** @defgroup LPTIM_Updating_Mode LPTIM Updating Mode
  260. * @{
  261. */
  262. #define LPTIM_UPDATE_IMMEDIATE ((uint32_t)0x00000000U)
  263. #define LPTIM_UPDATE_ENDOFPERIOD LPTIM_CFGR_PRELOAD
  264. /**
  265. * @}
  266. */
  267. /** @defgroup LPTIM_Counter_Source LPTIM Counter Source
  268. * @{
  269. */
  270. #define LPTIM_COUNTERSOURCE_INTERNAL ((uint32_t)0x00000000U)
  271. #define LPTIM_COUNTERSOURCE_EXTERNAL LPTIM_CFGR_COUNTMODE
  272. /**
  273. * @}
  274. */
  275. /** @defgroup LPTIM_Flag_Definition LPTIM Flag Definition
  276. * @{
  277. */
  278. #define LPTIM_FLAG_DOWN LPTIM_ISR_DOWN
  279. #define LPTIM_FLAG_UP LPTIM_ISR_UP
  280. #define LPTIM_FLAG_ARROK LPTIM_ISR_ARROK
  281. #define LPTIM_FLAG_CMPOK LPTIM_ISR_CMPOK
  282. #define LPTIM_FLAG_EXTTRIG LPTIM_ISR_EXTTRIG
  283. #define LPTIM_FLAG_ARRM LPTIM_ISR_ARRM
  284. #define LPTIM_FLAG_CMPM LPTIM_ISR_CMPM
  285. /**
  286. * @}
  287. */
  288. /** @defgroup LPTIM_Interrupts_Definition LPTIM Interrupts Definition
  289. * @{
  290. */
  291. #define LPTIM_IT_DOWN LPTIM_IER_DOWNIE
  292. #define LPTIM_IT_UP LPTIM_IER_UPIE
  293. #define LPTIM_IT_ARROK LPTIM_IER_ARROKIE
  294. #define LPTIM_IT_CMPOK LPTIM_IER_CMPOKIE
  295. #define LPTIM_IT_EXTTRIG LPTIM_IER_EXTTRIGIE
  296. #define LPTIM_IT_ARRM LPTIM_IER_ARRMIE
  297. #define LPTIM_IT_CMPM LPTIM_IER_CMPMIE
  298. /**
  299. * @}
  300. */
  301. /**
  302. * @}
  303. */
  304. /* Exported macro ------------------------------------------------------------*/
  305. /** @defgroup LPTIM_Exported_Macros LPTIM Exported Macros
  306. * @{
  307. */
  308. /** @brief Reset LPTIM handle state
  309. * @param __HANDLE__ LPTIM handle
  310. * @retval None
  311. */
  312. #define __HAL_LPTIM_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_LPTIM_STATE_RESET)
  313. /**
  314. * @brief Enable/Disable the LPTIM peripheral.
  315. * @param __HANDLE__ LPTIM handle
  316. * @retval None
  317. */
  318. #define __HAL_LPTIM_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (LPTIM_CR_ENABLE))
  319. #define __HAL_LPTIM_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(LPTIM_CR_ENABLE))
  320. /**
  321. * @brief Starts the LPTIM peripheral in Continuous or in single mode.
  322. * @param __HANDLE__ DMA handle
  323. * @retval None
  324. */
  325. #define __HAL_LPTIM_START_CONTINUOUS(__HANDLE__) ((__HANDLE__)->Instance->CR |= LPTIM_CR_CNTSTRT)
  326. #define __HAL_LPTIM_START_SINGLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= LPTIM_CR_SNGSTRT)
  327. /**
  328. * @brief Writes the passed parameter in the Autoreload register.
  329. * @param __HANDLE__ LPTIM handle
  330. * @param __VALUE__ Autoreload value
  331. * @retval None
  332. */
  333. #define __HAL_LPTIM_AUTORELOAD_SET(__HANDLE__ , __VALUE__) ((__HANDLE__)->Instance->ARR = (__VALUE__))
  334. /**
  335. * @brief Writes the passed parameter in the Compare register.
  336. * @param __HANDLE__ LPTIM handle
  337. * @param __VALUE__ Compare value
  338. * @retval None
  339. */
  340. #define __HAL_LPTIM_COMPARE_SET(__HANDLE__ , __VALUE__) ((__HANDLE__)->Instance->CMP = (__VALUE__))
  341. /**
  342. * @brief Checks whether the specified LPTIM flag is set or not.
  343. * @param __HANDLE__ LPTIM handle
  344. * @param __FLAG__ LPTIM flag to check
  345. * This parameter can be a value of:
  346. * @arg LPTIM_FLAG_DOWN : Counter direction change up Flag.
  347. * @arg LPTIM_FLAG_UP : Counter direction change down to up Flag.
  348. * @arg LPTIM_FLAG_ARROK : Autoreload register update OK Flag.
  349. * @arg LPTIM_FLAG_CMPOK : Compare register update OK Flag.
  350. * @arg LPTIM_FLAG_EXTTRIG : External trigger edge event Flag.
  351. * @arg LPTIM_FLAG_ARRM : Autoreload match Flag.
  352. * @arg LPTIM_FLAG_CMPM : Compare match Flag.
  353. * @retval The state of the specified flag (SET or RESET).
  354. */
  355. #define __HAL_LPTIM_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->ISR &(__FLAG__)) == (__FLAG__))
  356. /**
  357. * @brief Clears the specified LPTIM flag.
  358. * @param __HANDLE__ LPTIM handle.
  359. * @param __FLAG__ LPTIM flag to clear.
  360. * This parameter can be a value of:
  361. * @arg LPTIM_FLAG_DOWN : Counter direction change up Flag.
  362. * @arg LPTIM_FLAG_UP : Counter direction change down to up Flag.
  363. * @arg LPTIM_FLAG_ARROK : Autoreload register update OK Flag.
  364. * @arg LPTIM_FLAG_CMPOK : Compare register update OK Flag.
  365. * @arg LPTIM_FLAG_EXTTRIG : External trigger edge event Flag.
  366. * @arg LPTIM_FLAG_ARRM : Autoreload match Flag.
  367. * @arg LPTIM_FLAG_CMPM : Compare match Flag.
  368. * @retval None.
  369. */
  370. #define __HAL_LPTIM_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))
  371. /**
  372. * @brief Enable the specified LPTIM interrupt.
  373. * @param __HANDLE__ LPTIM handle.
  374. * @param __INTERRUPT__ LPTIM interrupt to set.
  375. * This parameter can be a value of:
  376. * @arg LPTIM_IT_DOWN : Counter direction change up Interrupt.
  377. * @arg LPTIM_IT_UP : Counter direction change down to up Interrupt.
  378. * @arg LPTIM_IT_ARROK : Autoreload register update OK Interrupt.
  379. * @arg LPTIM_IT_CMPOK : Compare register update OK Interrupt.
  380. * @arg LPTIM_IT_EXTTRIG : External trigger edge event Interrupt.
  381. * @arg LPTIM_IT_ARRM : Autoreload match Interrupt.
  382. * @arg LPTIM_IT_CMPM : Compare match Interrupt.
  383. * @retval None.
  384. */
  385. #define __HAL_LPTIM_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER |= (__INTERRUPT__))
  386. /**
  387. * @brief Disable the specified LPTIM interrupt.
  388. * @param __HANDLE__ LPTIM handle.
  389. * @param __INTERRUPT__ LPTIM interrupt to set.
  390. * This parameter can be a value of:
  391. * @arg LPTIM_IT_DOWN : Counter direction change up Interrupt.
  392. * @arg LPTIM_IT_UP : Counter direction change down to up Interrupt.
  393. * @arg LPTIM_IT_ARROK : Autoreload register update OK Interrupt.
  394. * @arg LPTIM_IT_CMPOK : Compare register update OK Interrupt.
  395. * @arg LPTIM_IT_EXTTRIG : External trigger edge event Interrupt.
  396. * @arg LPTIM_IT_ARRM : Autoreload match Interrupt.
  397. * @arg LPTIM_IT_CMPM : Compare match Interrupt.
  398. * @retval None.
  399. */
  400. #define __HAL_LPTIM_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER &= (~(__INTERRUPT__)))
  401. /**
  402. * @brief Checks whether the specified LPTIM interrupt is set or not.
  403. * @param __HANDLE__ LPTIM handle.
  404. * @param __INTERRUPT__ LPTIM interrupt to check.
  405. * This parameter can be a value of:
  406. * @arg LPTIM_IT_DOWN : Counter direction change up Interrupt.
  407. * @arg LPTIM_IT_UP : Counter direction change down to up Interrupt.
  408. * @arg LPTIM_IT_ARROK : Autoreload register update OK Interrupt.
  409. * @arg LPTIM_IT_CMPOK : Compare register update OK Interrupt.
  410. * @arg LPTIM_IT_EXTTRIG : External trigger edge event Interrupt.
  411. * @arg LPTIM_IT_ARRM : Autoreload match Interrupt.
  412. * @arg LPTIM_IT_CMPM : Compare match Interrupt.
  413. * @retval Interrupt status.
  414. */
  415. #define __HAL_LPTIM_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->IER & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
  416. /**
  417. * @brief Enable interrupt on the LPTIM Wake-up Timer associated Exti line.
  418. * @retval None
  419. */
  420. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_IT() (EXTI->IMR |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  421. /**
  422. * @brief Disable interrupt on the LPTIM Wake-up Timer associated Exti line.
  423. * @retval None
  424. */
  425. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_IT() (EXTI->IMR &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  426. /**
  427. * @brief Enable event on the LPTIM Wake-up Timer associated Exti line.
  428. * @retval None.
  429. */
  430. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_EVENT() (EXTI->EMR |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  431. /**
  432. * @brief Disable event on the LPTIM Wake-up Timer associated Exti line.
  433. * @retval None.
  434. */
  435. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_EVENT() (EXTI->EMR &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  436. /**
  437. * @brief Enable falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  438. * @retval None.
  439. */
  440. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_FALLING_EDGE() (EXTI->FTSR |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  441. /**
  442. * @brief Disable falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  443. * @retval None.
  444. */
  445. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_FALLING_EDGE() (EXTI->FTSR &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  446. /**
  447. * @brief Enable rising edge trigger on the LPTIM Wake-up Timer associated Exti line.
  448. * @retval None.
  449. */
  450. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_RISING_EDGE() (EXTI->RTSR |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  451. /**
  452. * @brief Disable rising edge trigger on the LPTIM Wake-up Timer associated Exti line.
  453. * @retval None.
  454. */
  455. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_RISING_EDGE() (EXTI->RTSR &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  456. /**
  457. * @brief Enable rising & falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  458. * @retval None.
  459. */
  460. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_RISING_FALLING_EDGE() do{__HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_RISING_EDGE();\
  461. __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_FALLING_EDGE();\
  462. }while(0)
  463. /**
  464. * @brief Disable rising & falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  465. * This parameter can be:
  466. * @retval None.
  467. */
  468. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_RISING_FALLING_EDGE() do{__HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_RISING_EDGE();\
  469. __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_FALLING_EDGE();\
  470. }while(0)
  471. /**
  472. * @brief Check whether the LPTIM Wake-up Timer associated Exti line interrupt flag is set or not.
  473. * @retval Line Status.
  474. */
  475. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_GET_FLAG() (EXTI->PR & LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  476. /**
  477. * @brief Clear the LPTIM Wake-up Timer associated Exti line flag.
  478. * @retval None.
  479. */
  480. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_CLEAR_FLAG() (EXTI->PR = LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  481. /**
  482. * @brief Generate a Software interrupt on the LPTIM Wake-up Timer associated Exti line.
  483. * @retval None.
  484. */
  485. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_GENERATE_SWIT() (EXTI->SWIER |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  486. /**
  487. * @}
  488. */
  489. /* Exported functions --------------------------------------------------------*/
  490. /** @defgroup LPTIM_Exported_Functions LPTIM Exported Functions
  491. * @{
  492. */
  493. /* Initialization/de-initialization functions ********************************/
  494. HAL_StatusTypeDef HAL_LPTIM_Init(LPTIM_HandleTypeDef *hlptim);
  495. HAL_StatusTypeDef HAL_LPTIM_DeInit(LPTIM_HandleTypeDef *hlptim);
  496. /* MSP functions *************************************************************/
  497. void HAL_LPTIM_MspInit(LPTIM_HandleTypeDef *hlptim);
  498. void HAL_LPTIM_MspDeInit(LPTIM_HandleTypeDef *hlptim);
  499. /* Start/Stop operation functions *********************************************/
  500. /* ################################# PWM Mode ################################*/
  501. /* Blocking mode: Polling */
  502. HAL_StatusTypeDef HAL_LPTIM_PWM_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  503. HAL_StatusTypeDef HAL_LPTIM_PWM_Stop(LPTIM_HandleTypeDef *hlptim);
  504. /* Non-Blocking mode: Interrupt */
  505. HAL_StatusTypeDef HAL_LPTIM_PWM_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  506. HAL_StatusTypeDef HAL_LPTIM_PWM_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  507. /* ############################# One Pulse Mode ##############################*/
  508. /* Blocking mode: Polling */
  509. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  510. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Stop(LPTIM_HandleTypeDef *hlptim);
  511. /* Non-Blocking mode: Interrupt */
  512. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  513. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  514. /* ############################## Set once Mode ##############################*/
  515. /* Blocking mode: Polling */
  516. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  517. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Stop(LPTIM_HandleTypeDef *hlptim);
  518. /* Non-Blocking mode: Interrupt */
  519. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  520. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  521. /* ############################### Encoder Mode ##############################*/
  522. /* Blocking mode: Polling */
  523. HAL_StatusTypeDef HAL_LPTIM_Encoder_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  524. HAL_StatusTypeDef HAL_LPTIM_Encoder_Stop(LPTIM_HandleTypeDef *hlptim);
  525. /* Non-Blocking mode: Interrupt */
  526. HAL_StatusTypeDef HAL_LPTIM_Encoder_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  527. HAL_StatusTypeDef HAL_LPTIM_Encoder_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  528. /* ############################# Time out Mode ##############################*/
  529. /* Blocking mode: Polling */
  530. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Timeout);
  531. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Stop(LPTIM_HandleTypeDef *hlptim);
  532. /* Non-Blocking mode: Interrupt */
  533. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Timeout);
  534. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  535. /* ############################## Counter Mode ###############################*/
  536. /* Blocking mode: Polling */
  537. HAL_StatusTypeDef HAL_LPTIM_Counter_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  538. HAL_StatusTypeDef HAL_LPTIM_Counter_Stop(LPTIM_HandleTypeDef *hlptim);
  539. /* Non-Blocking mode: Interrupt */
  540. HAL_StatusTypeDef HAL_LPTIM_Counter_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  541. HAL_StatusTypeDef HAL_LPTIM_Counter_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  542. /* Reading operation functions ************************************************/
  543. uint32_t HAL_LPTIM_ReadCounter(LPTIM_HandleTypeDef *hlptim);
  544. uint32_t HAL_LPTIM_ReadAutoReload(LPTIM_HandleTypeDef *hlptim);
  545. uint32_t HAL_LPTIM_ReadCompare(LPTIM_HandleTypeDef *hlptim);
  546. /* LPTIM IRQ functions *******************************************************/
  547. void HAL_LPTIM_IRQHandler(LPTIM_HandleTypeDef *hlptim);
  548. /* CallBack functions ********************************************************/
  549. void HAL_LPTIM_CompareMatchCallback(LPTIM_HandleTypeDef *hlptim);
  550. void HAL_LPTIM_AutoReloadMatchCallback(LPTIM_HandleTypeDef *hlptim);
  551. void HAL_LPTIM_TriggerCallback(LPTIM_HandleTypeDef *hlptim);
  552. void HAL_LPTIM_CompareWriteCallback(LPTIM_HandleTypeDef *hlptim);
  553. void HAL_LPTIM_AutoReloadWriteCallback(LPTIM_HandleTypeDef *hlptim);
  554. void HAL_LPTIM_DirectionUpCallback(LPTIM_HandleTypeDef *hlptim);
  555. void HAL_LPTIM_DirectionDownCallback(LPTIM_HandleTypeDef *hlptim);
  556. /* Callbacks Register/UnRegister functions ***********************************/
  557. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  558. HAL_StatusTypeDef HAL_LPTIM_RegisterCallback(LPTIM_HandleTypeDef *hlptim, HAL_LPTIM_CallbackIDTypeDef CallbackID, pLPTIM_CallbackTypeDef pCallback);
  559. HAL_StatusTypeDef HAL_LPTIM_UnRegisterCallback(LPTIM_HandleTypeDef *hlptim, HAL_LPTIM_CallbackIDTypeDef CallbackID);
  560. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  561. /* Peripheral State functions ************************************************/
  562. HAL_LPTIM_StateTypeDef HAL_LPTIM_GetState(LPTIM_HandleTypeDef *hlptim);
  563. /**
  564. * @}
  565. */
  566. /* Private types -------------------------------------------------------------*/
  567. /** @defgroup LPTIM_Private_Types LPTIM Private Types
  568. * @{
  569. */
  570. /**
  571. * @}
  572. */
  573. /* Private variables ---------------------------------------------------------*/
  574. /** @defgroup LPTIM_Private_Variables LPTIM Private Variables
  575. * @{
  576. */
  577. /**
  578. * @}
  579. */
  580. /* Private constants ---------------------------------------------------------*/
  581. /** @defgroup LPTIM_Private_Constants LPTIM Private Constants
  582. * @{
  583. */
  584. /**
  585. * @}
  586. */
  587. /* Private macros ------------------------------------------------------------*/
  588. /** @defgroup LPTIM_Private_Macros LPTIM Private Macros
  589. * @{
  590. */
  591. #define IS_LPTIM_CLOCK_SOURCE(__SOURCE__) (((__SOURCE__) == LPTIM_CLOCKSOURCE_ULPTIM) || \
  592. ((__SOURCE__) == LPTIM_CLOCKSOURCE_APBCLOCK_LPOSC))
  593. #define IS_LPTIM_CLOCK_PRESCALER(__PRESCALER__) (((__PRESCALER__) == LPTIM_PRESCALER_DIV1 ) || \
  594. ((__PRESCALER__) == LPTIM_PRESCALER_DIV2 ) || \
  595. ((__PRESCALER__) == LPTIM_PRESCALER_DIV4 ) || \
  596. ((__PRESCALER__) == LPTIM_PRESCALER_DIV8 ) || \
  597. ((__PRESCALER__) == LPTIM_PRESCALER_DIV16 ) || \
  598. ((__PRESCALER__) == LPTIM_PRESCALER_DIV32 ) || \
  599. ((__PRESCALER__) == LPTIM_PRESCALER_DIV64 ) || \
  600. ((__PRESCALER__) == LPTIM_PRESCALER_DIV128))
  601. #define IS_LPTIM_CLOCK_PRESCALERDIV1(__PRESCALER__) ((__PRESCALER__) == LPTIM_PRESCALER_DIV1)
  602. #define IS_LPTIM_OUTPUT_POLARITY(__POLARITY__) (((__POLARITY__) == LPTIM_OUTPUTPOLARITY_LOW ) || \
  603. ((__POLARITY__) == LPTIM_OUTPUTPOLARITY_HIGH))
  604. #define IS_LPTIM_CLOCK_SAMPLE_TIME(__SAMPLETIME__) (((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_DIRECTTRANSITION) || \
  605. ((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_2TRANSITIONS) || \
  606. ((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_4TRANSITIONS) || \
  607. ((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_8TRANSITIONS))
  608. #define IS_LPTIM_CLOCK_POLARITY(__POLARITY__) (((__POLARITY__) == LPTIM_CLOCKPOLARITY_RISING) || \
  609. ((__POLARITY__) == LPTIM_CLOCKPOLARITY_FALLING) || \
  610. ((__POLARITY__) == LPTIM_CLOCKPOLARITY_RISING_FALLING))
  611. #define IS_LPTIM_TRG_SOURCE(__TRIG__) (((__TRIG__) == LPTIM_TRIGSOURCE_SOFTWARE) || \
  612. ((__TRIG__) == LPTIM_TRIGSOURCE_0) || \
  613. ((__TRIG__) == LPTIM_TRIGSOURCE_1) || \
  614. ((__TRIG__) == LPTIM_TRIGSOURCE_2) || \
  615. ((__TRIG__) == LPTIM_TRIGSOURCE_3) || \
  616. ((__TRIG__) == LPTIM_TRIGSOURCE_4) || \
  617. ((__TRIG__) == LPTIM_TRIGSOURCE_5))
  618. #define IS_LPTIM_EXT_TRG_POLARITY(__POLAR__) (((__POLAR__) == LPTIM_ACTIVEEDGE_RISING ) || \
  619. ((__POLAR__) == LPTIM_ACTIVEEDGE_FALLING ) || \
  620. ((__POLAR__) == LPTIM_ACTIVEEDGE_RISING_FALLING ))
  621. #define IS_LPTIM_TRIG_SAMPLE_TIME(__SAMPLETIME__) (((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_DIRECTTRANSITION) || \
  622. ((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_2TRANSITIONS ) || \
  623. ((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_4TRANSITIONS ) || \
  624. ((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_8TRANSITIONS ))
  625. #define IS_LPTIM_UPDATE_MODE(__MODE__) (((__MODE__) == LPTIM_UPDATE_IMMEDIATE) || \
  626. ((__MODE__) == LPTIM_UPDATE_ENDOFPERIOD))
  627. #define IS_LPTIM_COUNTER_SOURCE(__SOURCE__) (((__SOURCE__) == LPTIM_COUNTERSOURCE_INTERNAL) || \
  628. ((__SOURCE__) == LPTIM_COUNTERSOURCE_EXTERNAL))
  629. #define IS_LPTIM_AUTORELOAD(__AUTORELOAD__) ((__AUTORELOAD__) <= 0x0000FFFFU)
  630. #define IS_LPTIM_COMPARE(__COMPARE__) ((__COMPARE__) <= 0x0000FFFFU)
  631. #define IS_LPTIM_PERIOD(PERIOD) ((PERIOD) <= 0x0000FFFFU)
  632. #define IS_LPTIM_PULSE(PULSE) ((PULSE) <= 0x0000FFFFU)
  633. /**
  634. * @}
  635. */
  636. /* Private functions ---------------------------------------------------------*/
  637. /** @defgroup LPTIM_Private_Functions LPTIM Private Functions
  638. * @{
  639. */
  640. /**
  641. * @}
  642. */
  643. /**
  644. * @}
  645. */
  646. /**
  647. * @}
  648. */
  649. #ifdef __cplusplus
  650. }
  651. #endif
  652. #endif /* __STM32F7xx_HAL_LPTIM_H */
  653. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/