训练营PLSR题目
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

858 lines
36 KiB

  1. /**
  2. ******************************************************************************
  3. * @file stm32f4xx_hal_lptim.h
  4. * @author MCD Application Team
  5. * @brief Header file of LPTIM HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2016 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 STM32F4xx_HAL_LPTIM_H
  20. #define STM32F4xx_HAL_LPTIM_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32f4xx_hal_def.h"
  26. /** @addtogroup STM32F4xx_HAL_Driver
  27. * @{
  28. */
  29. #if defined (LPTIM1)
  30. /** @addtogroup LPTIM
  31. * @{
  32. */
  33. /* Exported types ------------------------------------------------------------*/
  34. /** @defgroup LPTIM_Exported_Types LPTIM Exported Types
  35. * @{
  36. */
  37. #define LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT EXTI_IMR_MR23 /*!< External interrupt line 23 Connected to the LPTIM EXTI Line */
  38. /**
  39. * @brief LPTIM Clock configuration definition
  40. */
  41. typedef struct
  42. {
  43. uint32_t Source; /*!< Selects the clock source.
  44. This parameter can be a value of @ref LPTIM_Clock_Source */
  45. uint32_t Prescaler; /*!< Specifies the counter clock Prescaler.
  46. This parameter can be a value of @ref LPTIM_Clock_Prescaler */
  47. } LPTIM_ClockConfigTypeDef;
  48. /**
  49. * @brief LPTIM Clock configuration definition
  50. */
  51. typedef struct
  52. {
  53. uint32_t Polarity; /*!< Selects the polarity of the active edge for the counter unit
  54. if the ULPTIM input is selected.
  55. Note: This parameter is used only when Ultra low power clock source is used.
  56. Note: If the polarity is configured on 'both edges', an auxiliary clock
  57. (one of the Low power oscillator) must be active.
  58. This parameter can be a value of @ref LPTIM_Clock_Polarity */
  59. uint32_t SampleTime; /*!< Selects the clock sampling time to configure the clock glitch filter.
  60. Note: This parameter is used only when Ultra low power clock source is used.
  61. This parameter can be a value of @ref LPTIM_Clock_Sample_Time */
  62. } LPTIM_ULPClockConfigTypeDef;
  63. /**
  64. * @brief LPTIM Trigger configuration definition
  65. */
  66. typedef struct
  67. {
  68. uint32_t Source; /*!< Selects the Trigger source.
  69. This parameter can be a value of @ref LPTIM_Trigger_Source */
  70. uint32_t ActiveEdge; /*!< Selects the Trigger active edge.
  71. Note: This parameter is used only when an external trigger is used.
  72. This parameter can be a value of @ref LPTIM_External_Trigger_Polarity */
  73. uint32_t SampleTime; /*!< Selects the trigger sampling time to configure the clock glitch filter.
  74. Note: This parameter is used only when an external trigger is used.
  75. This parameter can be a value of @ref LPTIM_Trigger_Sample_Time */
  76. } LPTIM_TriggerConfigTypeDef;
  77. /**
  78. * @brief LPTIM Initialization Structure definition
  79. */
  80. typedef struct
  81. {
  82. LPTIM_ClockConfigTypeDef Clock; /*!< Specifies the clock parameters */
  83. LPTIM_ULPClockConfigTypeDef UltraLowPowerClock;/*!< Specifies the Ultra Low Power clock parameters */
  84. LPTIM_TriggerConfigTypeDef Trigger; /*!< Specifies the Trigger parameters */
  85. uint32_t OutputPolarity; /*!< Specifies the Output polarity.
  86. This parameter can be a value of @ref LPTIM_Output_Polarity */
  87. uint32_t UpdateMode; /*!< Specifies whether the update of the autoreload and the compare
  88. values is done immediately or after the end of current period.
  89. This parameter can be a value of @ref LPTIM_Updating_Mode */
  90. uint32_t CounterSource; /*!< Specifies whether the counter is incremented each internal event
  91. or each external event.
  92. This parameter can be a value of @ref LPTIM_Counter_Source */
  93. } LPTIM_InitTypeDef;
  94. /**
  95. * @brief HAL LPTIM State structure definition
  96. */
  97. typedef enum
  98. {
  99. HAL_LPTIM_STATE_RESET = 0x00U, /*!< Peripheral not yet initialized or disabled */
  100. HAL_LPTIM_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */
  101. HAL_LPTIM_STATE_BUSY = 0x02U, /*!< An internal process is ongoing */
  102. HAL_LPTIM_STATE_TIMEOUT = 0x03U, /*!< Timeout state */
  103. HAL_LPTIM_STATE_ERROR = 0x04U /*!< Internal Process is ongoing */
  104. } HAL_LPTIM_StateTypeDef;
  105. /**
  106. * @brief LPTIM handle Structure definition
  107. */
  108. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  109. typedef struct __LPTIM_HandleTypeDef
  110. #else
  111. typedef struct
  112. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  113. {
  114. LPTIM_TypeDef *Instance; /*!< Register base address */
  115. LPTIM_InitTypeDef Init; /*!< LPTIM required parameters */
  116. HAL_StatusTypeDef Status; /*!< LPTIM peripheral status */
  117. HAL_LockTypeDef Lock; /*!< LPTIM locking object */
  118. __IO HAL_LPTIM_StateTypeDef State; /*!< LPTIM peripheral state */
  119. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  120. void (* MspInitCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Base Msp Init Callback */
  121. void (* MspDeInitCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< LPTIM Base Msp DeInit Callback */
  122. void (* CompareMatchCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< Compare match Callback */
  123. void (* AutoReloadMatchCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< Auto-reload match Callback */
  124. void (* TriggerCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< External trigger event detection Callback */
  125. void (* CompareWriteCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< Compare register write complete Callback */
  126. void (* AutoReloadWriteCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< Auto-reload register write complete Callback */
  127. void (* DirectionUpCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< Up-counting direction change Callback */
  128. void (* DirectionDownCallback)(struct __LPTIM_HandleTypeDef *hlptim); /*!< Down-counting direction change Callback */
  129. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  130. } LPTIM_HandleTypeDef;
  131. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  132. /**
  133. * @brief HAL LPTIM Callback ID enumeration definition
  134. */
  135. typedef enum
  136. {
  137. HAL_LPTIM_MSPINIT_CB_ID = 0x00U, /*!< LPTIM Base Msp Init Callback ID */
  138. HAL_LPTIM_MSPDEINIT_CB_ID = 0x01U, /*!< LPTIM Base Msp DeInit Callback ID */
  139. HAL_LPTIM_COMPARE_MATCH_CB_ID = 0x02U, /*!< Compare match Callback ID */
  140. HAL_LPTIM_AUTORELOAD_MATCH_CB_ID = 0x03U, /*!< Auto-reload match Callback ID */
  141. HAL_LPTIM_TRIGGER_CB_ID = 0x04U, /*!< External trigger event detection Callback ID */
  142. HAL_LPTIM_COMPARE_WRITE_CB_ID = 0x05U, /*!< Compare register write complete Callback ID */
  143. HAL_LPTIM_AUTORELOAD_WRITE_CB_ID = 0x06U, /*!< Auto-reload register write complete Callback ID */
  144. HAL_LPTIM_DIRECTION_UP_CB_ID = 0x07U, /*!< Up-counting direction change Callback ID */
  145. HAL_LPTIM_DIRECTION_DOWN_CB_ID = 0x08U, /*!< Down-counting direction change Callback ID */
  146. } HAL_LPTIM_CallbackIDTypeDef;
  147. /**
  148. * @brief HAL TIM Callback pointer definition
  149. */
  150. typedef void (*pLPTIM_CallbackTypeDef)(LPTIM_HandleTypeDef *hlptim); /*!< pointer to the LPTIM callback function */
  151. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  152. /**
  153. * @}
  154. */
  155. /* Exported constants --------------------------------------------------------*/
  156. /** @defgroup LPTIM_Exported_Constants LPTIM Exported Constants
  157. * @{
  158. */
  159. /** @defgroup LPTIM_Clock_Source LPTIM Clock Source
  160. * @{
  161. */
  162. #define LPTIM_CLOCKSOURCE_APBCLOCK_LPOSC 0x00000000U
  163. #define LPTIM_CLOCKSOURCE_ULPTIM LPTIM_CFGR_CKSEL
  164. /**
  165. * @}
  166. */
  167. /** @defgroup LPTIM_Clock_Prescaler LPTIM Clock Prescaler
  168. * @{
  169. */
  170. #define LPTIM_PRESCALER_DIV1 0x00000000U
  171. #define LPTIM_PRESCALER_DIV2 LPTIM_CFGR_PRESC_0
  172. #define LPTIM_PRESCALER_DIV4 LPTIM_CFGR_PRESC_1
  173. #define LPTIM_PRESCALER_DIV8 (LPTIM_CFGR_PRESC_0 | LPTIM_CFGR_PRESC_1)
  174. #define LPTIM_PRESCALER_DIV16 LPTIM_CFGR_PRESC_2
  175. #define LPTIM_PRESCALER_DIV32 (LPTIM_CFGR_PRESC_0 | LPTIM_CFGR_PRESC_2)
  176. #define LPTIM_PRESCALER_DIV64 (LPTIM_CFGR_PRESC_1 | LPTIM_CFGR_PRESC_2)
  177. #define LPTIM_PRESCALER_DIV128 LPTIM_CFGR_PRESC
  178. /**
  179. * @}
  180. */
  181. /** @defgroup LPTIM_Output_Polarity LPTIM Output Polarity
  182. * @{
  183. */
  184. #define LPTIM_OUTPUTPOLARITY_HIGH 0x00000000U
  185. #define LPTIM_OUTPUTPOLARITY_LOW LPTIM_CFGR_WAVPOL
  186. /**
  187. * @}
  188. */
  189. /** @defgroup LPTIM_Clock_Sample_Time LPTIM Clock Sample Time
  190. * @{
  191. */
  192. #define LPTIM_CLOCKSAMPLETIME_DIRECTTRANSITION 0x00000000U
  193. #define LPTIM_CLOCKSAMPLETIME_2TRANSITIONS LPTIM_CFGR_CKFLT_0
  194. #define LPTIM_CLOCKSAMPLETIME_4TRANSITIONS LPTIM_CFGR_CKFLT_1
  195. #define LPTIM_CLOCKSAMPLETIME_8TRANSITIONS LPTIM_CFGR_CKFLT
  196. /**
  197. * @}
  198. */
  199. /** @defgroup LPTIM_Clock_Polarity LPTIM Clock Polarity
  200. * @{
  201. */
  202. #define LPTIM_CLOCKPOLARITY_RISING 0x00000000U
  203. #define LPTIM_CLOCKPOLARITY_FALLING LPTIM_CFGR_CKPOL_0
  204. #define LPTIM_CLOCKPOLARITY_RISING_FALLING LPTIM_CFGR_CKPOL_1
  205. /**
  206. * @}
  207. */
  208. /** @defgroup LPTIM_Trigger_Source LPTIM Trigger Source
  209. * @{
  210. */
  211. #define LPTIM_TRIGSOURCE_SOFTWARE 0x0000FFFFU
  212. #define LPTIM_TRIGSOURCE_0 0x00000000U
  213. #define LPTIM_TRIGSOURCE_1 LPTIM_CFGR_TRIGSEL_0
  214. #define LPTIM_TRIGSOURCE_2 LPTIM_CFGR_TRIGSEL_1
  215. #define LPTIM_TRIGSOURCE_3 (LPTIM_CFGR_TRIGSEL_0 | LPTIM_CFGR_TRIGSEL_1)
  216. #define LPTIM_TRIGSOURCE_4 LPTIM_CFGR_TRIGSEL_2
  217. #define LPTIM_TRIGSOURCE_5 (LPTIM_CFGR_TRIGSEL_0 | LPTIM_CFGR_TRIGSEL_2)
  218. /**
  219. * @}
  220. */
  221. /** @defgroup LPTIM_External_Trigger_Polarity LPTIM External Trigger Polarity
  222. * @{
  223. */
  224. #define LPTIM_ACTIVEEDGE_RISING LPTIM_CFGR_TRIGEN_0
  225. #define LPTIM_ACTIVEEDGE_FALLING LPTIM_CFGR_TRIGEN_1
  226. #define LPTIM_ACTIVEEDGE_RISING_FALLING LPTIM_CFGR_TRIGEN
  227. /**
  228. * @}
  229. */
  230. /** @defgroup LPTIM_Trigger_Sample_Time LPTIM Trigger Sample Time
  231. * @{
  232. */
  233. #define LPTIM_TRIGSAMPLETIME_DIRECTTRANSITION 0x00000000U
  234. #define LPTIM_TRIGSAMPLETIME_2TRANSITIONS LPTIM_CFGR_TRGFLT_0
  235. #define LPTIM_TRIGSAMPLETIME_4TRANSITIONS LPTIM_CFGR_TRGFLT_1
  236. #define LPTIM_TRIGSAMPLETIME_8TRANSITIONS LPTIM_CFGR_TRGFLT
  237. /**
  238. * @}
  239. */
  240. /** @defgroup LPTIM_Updating_Mode LPTIM Updating Mode
  241. * @{
  242. */
  243. #define LPTIM_UPDATE_IMMEDIATE 0x00000000U
  244. #define LPTIM_UPDATE_ENDOFPERIOD LPTIM_CFGR_PRELOAD
  245. /**
  246. * @}
  247. */
  248. /** @defgroup LPTIM_Counter_Source LPTIM Counter Source
  249. * @{
  250. */
  251. #define LPTIM_COUNTERSOURCE_INTERNAL 0x00000000U
  252. #define LPTIM_COUNTERSOURCE_EXTERNAL LPTIM_CFGR_COUNTMODE
  253. /**
  254. * @}
  255. */
  256. /** @defgroup LPTIM_Flag_Definition LPTIM Flags Definition
  257. * @{
  258. */
  259. #define LPTIM_FLAG_DOWN LPTIM_ISR_DOWN
  260. #define LPTIM_FLAG_UP LPTIM_ISR_UP
  261. #define LPTIM_FLAG_ARROK LPTIM_ISR_ARROK
  262. #define LPTIM_FLAG_CMPOK LPTIM_ISR_CMPOK
  263. #define LPTIM_FLAG_EXTTRIG LPTIM_ISR_EXTTRIG
  264. #define LPTIM_FLAG_ARRM LPTIM_ISR_ARRM
  265. #define LPTIM_FLAG_CMPM LPTIM_ISR_CMPM
  266. /**
  267. * @}
  268. */
  269. /** @defgroup LPTIM_Interrupts_Definition LPTIM Interrupts Definition
  270. * @{
  271. */
  272. #define LPTIM_IT_DOWN LPTIM_IER_DOWNIE
  273. #define LPTIM_IT_UP LPTIM_IER_UPIE
  274. #define LPTIM_IT_ARROK LPTIM_IER_ARROKIE
  275. #define LPTIM_IT_CMPOK LPTIM_IER_CMPOKIE
  276. #define LPTIM_IT_EXTTRIG LPTIM_IER_EXTTRIGIE
  277. #define LPTIM_IT_ARRM LPTIM_IER_ARRMIE
  278. #define LPTIM_IT_CMPM LPTIM_IER_CMPMIE
  279. /**
  280. * @}
  281. */
  282. /** @defgroup LPTIM_Option Register Definition
  283. * @{
  284. */
  285. #define LPTIM_OP_PAD_AF 0x00000000U
  286. #define LPTIM_OP_PAD_PA4 LPTIM_OR_LPT_IN1_RMP_0
  287. #define LPTIM_OP_PAD_PB9 LPTIM_OR_LPT_IN1_RMP_1
  288. #define LPTIM_OP_TIM_DAC LPTIM_OR_LPT_IN1_RMP
  289. /**
  290. * @}
  291. */
  292. /**
  293. * @}
  294. */
  295. /* Exported macros -----------------------------------------------------------*/
  296. /** @defgroup LPTIM_Exported_Macros LPTIM Exported Macros
  297. * @{
  298. */
  299. /** @brief Reset LPTIM handle state.
  300. * @param __HANDLE__ LPTIM handle
  301. * @retval None
  302. */
  303. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  304. #define __HAL_LPTIM_RESET_HANDLE_STATE(__HANDLE__) do { \
  305. (__HANDLE__)->State = HAL_LPTIM_STATE_RESET; \
  306. (__HANDLE__)->MspInitCallback = NULL; \
  307. (__HANDLE__)->MspDeInitCallback = NULL; \
  308. } while(0)
  309. #else
  310. #define __HAL_LPTIM_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_LPTIM_STATE_RESET)
  311. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  312. /**
  313. * @brief Enable the LPTIM peripheral.
  314. * @param __HANDLE__ LPTIM handle
  315. * @retval None
  316. */
  317. #define __HAL_LPTIM_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (LPTIM_CR_ENABLE))
  318. /**
  319. * @brief Disable the LPTIM peripheral.
  320. * @param __HANDLE__ LPTIM handle
  321. * @note The following sequence is required to solve LPTIM disable HW limitation.
  322. * Please check Errata Sheet ES0335 for more details under "MCU may remain
  323. * stuck in LPTIM interrupt when entering Stop mode" section.
  324. * @note Please call @ref HAL_LPTIM_GetState() after a call to __HAL_LPTIM_DISABLE to
  325. * check for TIMEOUT.
  326. * @retval None
  327. */
  328. #define __HAL_LPTIM_DISABLE(__HANDLE__) LPTIM_Disable(__HANDLE__)
  329. /**
  330. * @brief Start the LPTIM peripheral in Continuous mode.
  331. * @param __HANDLE__ LPTIM handle
  332. * @retval None
  333. */
  334. #define __HAL_LPTIM_START_CONTINUOUS(__HANDLE__) ((__HANDLE__)->Instance->CR |= LPTIM_CR_CNTSTRT)
  335. /**
  336. * @brief Start the LPTIM peripheral in single mode.
  337. * @param __HANDLE__ LPTIM handle
  338. * @retval None
  339. */
  340. #define __HAL_LPTIM_START_SINGLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= LPTIM_CR_SNGSTRT)
  341. /**
  342. * @brief Write the passed parameter in the Autoreload register.
  343. * @param __HANDLE__ LPTIM handle
  344. * @param __VALUE__ Autoreload value
  345. * @retval None
  346. * @note The ARR register can only be modified when the LPTIM instance is enabled.
  347. */
  348. #define __HAL_LPTIM_AUTORELOAD_SET(__HANDLE__ , __VALUE__) ((__HANDLE__)->Instance->ARR = (__VALUE__))
  349. /**
  350. * @brief Write the passed parameter in the Compare register.
  351. * @param __HANDLE__ LPTIM handle
  352. * @param __VALUE__ Compare value
  353. * @retval None
  354. * @note The CMP register can only be modified when the LPTIM instance is enabled.
  355. */
  356. #define __HAL_LPTIM_COMPARE_SET(__HANDLE__ , __VALUE__) ((__HANDLE__)->Instance->CMP = (__VALUE__))
  357. /**
  358. * @brief Check whether the specified LPTIM flag is set or not.
  359. * @param __HANDLE__ LPTIM handle
  360. * @param __FLAG__ LPTIM flag to check
  361. * This parameter can be a value of:
  362. * @arg LPTIM_FLAG_DOWN : Counter direction change up Flag.
  363. * @arg LPTIM_FLAG_UP : Counter direction change down to up Flag.
  364. * @arg LPTIM_FLAG_ARROK : Autoreload register update OK Flag.
  365. * @arg LPTIM_FLAG_CMPOK : Compare register update OK Flag.
  366. * @arg LPTIM_FLAG_EXTTRIG : External trigger edge event Flag.
  367. * @arg LPTIM_FLAG_ARRM : Autoreload match Flag.
  368. * @arg LPTIM_FLAG_CMPM : Compare match Flag.
  369. * @retval The state of the specified flag (SET or RESET).
  370. */
  371. #define __HAL_LPTIM_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->ISR &(__FLAG__)) == (__FLAG__))
  372. /**
  373. * @brief Clear the specified LPTIM flag.
  374. * @param __HANDLE__ LPTIM handle.
  375. * @param __FLAG__ LPTIM flag to clear.
  376. * This parameter can be a value of:
  377. * @arg LPTIM_FLAG_DOWN : Counter direction change up Flag.
  378. * @arg LPTIM_FLAG_UP : Counter direction change down to up Flag.
  379. * @arg LPTIM_FLAG_ARROK : Autoreload register update OK Flag.
  380. * @arg LPTIM_FLAG_CMPOK : Compare register update OK Flag.
  381. * @arg LPTIM_FLAG_EXTTRIG : External trigger edge event Flag.
  382. * @arg LPTIM_FLAG_ARRM : Autoreload match Flag.
  383. * @arg LPTIM_FLAG_CMPM : Compare match Flag.
  384. * @retval None.
  385. */
  386. #define __HAL_LPTIM_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))
  387. /**
  388. * @brief Enable the specified LPTIM interrupt.
  389. * @param __HANDLE__ LPTIM handle.
  390. * @param __INTERRUPT__ LPTIM interrupt to set.
  391. * This parameter can be a value of:
  392. * @arg LPTIM_IT_DOWN : Counter direction change up Interrupt.
  393. * @arg LPTIM_IT_UP : Counter direction change down to up Interrupt.
  394. * @arg LPTIM_IT_ARROK : Autoreload register update OK Interrupt.
  395. * @arg LPTIM_IT_CMPOK : Compare register update OK Interrupt.
  396. * @arg LPTIM_IT_EXTTRIG : External trigger edge event Interrupt.
  397. * @arg LPTIM_IT_ARRM : Autoreload match Interrupt.
  398. * @arg LPTIM_IT_CMPM : Compare match Interrupt.
  399. * @retval None.
  400. * @note The LPTIM interrupts can only be enabled when the LPTIM instance is disabled.
  401. */
  402. #define __HAL_LPTIM_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER |= (__INTERRUPT__))
  403. /**
  404. * @brief Disable the specified LPTIM interrupt.
  405. * @param __HANDLE__ LPTIM handle.
  406. * @param __INTERRUPT__ LPTIM interrupt to set.
  407. * This parameter can be a value of:
  408. * @arg LPTIM_IT_DOWN : Counter direction change up Interrupt.
  409. * @arg LPTIM_IT_UP : Counter direction change down to up Interrupt.
  410. * @arg LPTIM_IT_ARROK : Autoreload register update OK Interrupt.
  411. * @arg LPTIM_IT_CMPOK : Compare register update OK Interrupt.
  412. * @arg LPTIM_IT_EXTTRIG : External trigger edge event Interrupt.
  413. * @arg LPTIM_IT_ARRM : Autoreload match Interrupt.
  414. * @arg LPTIM_IT_CMPM : Compare match Interrupt.
  415. * @retval None.
  416. * @note The LPTIM interrupts can only be disabled when the LPTIM instance is disabled.
  417. */
  418. #define __HAL_LPTIM_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER &= (~(__INTERRUPT__)))
  419. /**
  420. * @brief Check whether the specified LPTIM interrupt source is enabled or not.
  421. * @param __HANDLE__ LPTIM handle.
  422. * @param __INTERRUPT__ LPTIM interrupt to check.
  423. * This parameter can be a value of:
  424. * @arg LPTIM_IT_DOWN : Counter direction change up Interrupt.
  425. * @arg LPTIM_IT_UP : Counter direction change down to up Interrupt.
  426. * @arg LPTIM_IT_ARROK : Autoreload register update OK Interrupt.
  427. * @arg LPTIM_IT_CMPOK : Compare register update OK Interrupt.
  428. * @arg LPTIM_IT_EXTTRIG : External trigger edge event Interrupt.
  429. * @arg LPTIM_IT_ARRM : Autoreload match Interrupt.
  430. * @arg LPTIM_IT_CMPM : Compare match Interrupt.
  431. * @retval Interrupt status.
  432. */
  433. #define __HAL_LPTIM_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->IER\
  434. & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
  435. /** @brief LPTIM Option Register
  436. * @param __HANDLE__ LPTIM handle
  437. * @param __VALUE__ This parameter can be a value of :
  438. * @arg LPTIM_OP_PAD_AF
  439. * @arg LPTIM_OP_PAD_PA4
  440. * @arg LPTIM_OP_PAD_PB9
  441. * @arg LPTIM_OP_TIM_DAC
  442. * @retval None
  443. */
  444. #define __HAL_LPTIM_OPTR_CONFIG(__HANDLE__ , __VALUE__) ((__HANDLE__)->Instance->OR = (__VALUE__))
  445. /**
  446. * @brief Enable interrupt on the LPTIM Wake-up Timer associated Exti line.
  447. * @retval None
  448. */
  449. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_IT() (EXTI->IMR\
  450. |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  451. /**
  452. * @brief Disable interrupt on the LPTIM Wake-up Timer associated Exti line.
  453. * @retval None
  454. */
  455. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_IT() (EXTI->IMR\
  456. &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  457. /**
  458. * @brief Enable event on the LPTIM Wake-up Timer associated Exti line.
  459. * @retval None.
  460. */
  461. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_EVENT() (EXTI->EMR\
  462. |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  463. /**
  464. * @brief Disable event on the LPTIM Wake-up Timer associated Exti line.
  465. * @retval None.
  466. */
  467. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_EVENT() (EXTI->EMR\
  468. &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  469. #if defined(EXTI_IMR_MR23)
  470. /**
  471. * @brief Enable falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  472. * @retval None.
  473. */
  474. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_FALLING_EDGE() (EXTI->FTSR\
  475. |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  476. /**
  477. * @brief Disable falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  478. * @retval None.
  479. */
  480. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_FALLING_EDGE() (EXTI->FTSR\
  481. &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  482. /**
  483. * @brief Enable rising edge trigger on the LPTIM Wake-up Timer associated Exti line.
  484. * @retval None.
  485. */
  486. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_RISING_EDGE() (EXTI->RTSR\
  487. |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  488. /**
  489. * @brief Disable rising edge trigger on the LPTIM Wake-up Timer associated Exti line.
  490. * @retval None.
  491. */
  492. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_RISING_EDGE() (EXTI->RTSR\
  493. &= ~(LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT))
  494. /**
  495. * @brief Enable rising & falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  496. * @retval None.
  497. */
  498. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_RISING_FALLING_EDGE() do{__HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_RISING_EDGE();\
  499. __HAL_LPTIM_WAKEUPTIMER_EXTI_ENABLE_FALLING_EDGE();\
  500. }while(0)
  501. /**
  502. * @brief Disable rising & falling edge trigger on the LPTIM Wake-up Timer associated Exti line.
  503. * @retval None.
  504. */
  505. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_RISING_FALLING_EDGE() do{__HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_RISING_EDGE();\
  506. __HAL_LPTIM_WAKEUPTIMER_EXTI_DISABLE_FALLING_EDGE();\
  507. }while(0)
  508. /**
  509. * @brief Check whether the LPTIM Wake-up Timer associated Exti line interrupt flag is set or not.
  510. * @retval Line Status.
  511. */
  512. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_GET_FLAG() (EXTI->PR\
  513. & LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  514. /**
  515. * @brief Clear the LPTIM Wake-up Timer associated Exti line flag.
  516. * @retval None.
  517. */
  518. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_CLEAR_FLAG() (EXTI->PR\
  519. = LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  520. /**
  521. * @brief Generate a Software interrupt on the LPTIM Wake-up Timer associated Exti line.
  522. * @retval None.
  523. */
  524. #define __HAL_LPTIM_WAKEUPTIMER_EXTI_GENERATE_SWIT() (EXTI->SWIER\
  525. |= LPTIM_EXTI_LINE_WAKEUPTIMER_EVENT)
  526. #endif /* EXTI_IMR_MR23 */
  527. /**
  528. * @}
  529. */
  530. /* Exported functions --------------------------------------------------------*/
  531. /** @defgroup LPTIM_Exported_Functions LPTIM Exported Functions
  532. * @{
  533. */
  534. /** @addtogroup LPTIM_Exported_Functions_Group1
  535. * @brief Initialization and Configuration functions.
  536. * @{
  537. */
  538. /* Initialization/de-initialization functions ********************************/
  539. HAL_StatusTypeDef HAL_LPTIM_Init(LPTIM_HandleTypeDef *hlptim);
  540. HAL_StatusTypeDef HAL_LPTIM_DeInit(LPTIM_HandleTypeDef *hlptim);
  541. /* MSP functions *************************************************************/
  542. void HAL_LPTIM_MspInit(LPTIM_HandleTypeDef *hlptim);
  543. void HAL_LPTIM_MspDeInit(LPTIM_HandleTypeDef *hlptim);
  544. /**
  545. * @}
  546. */
  547. /** @addtogroup LPTIM_Exported_Functions_Group2
  548. * @brief Start-Stop operation functions.
  549. * @{
  550. */
  551. /* Start/Stop operation functions *********************************************/
  552. /* ################################# PWM Mode ################################*/
  553. /* Blocking mode: Polling */
  554. HAL_StatusTypeDef HAL_LPTIM_PWM_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  555. HAL_StatusTypeDef HAL_LPTIM_PWM_Stop(LPTIM_HandleTypeDef *hlptim);
  556. /* Non-Blocking mode: Interrupt */
  557. HAL_StatusTypeDef HAL_LPTIM_PWM_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  558. HAL_StatusTypeDef HAL_LPTIM_PWM_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  559. /* ############################# One Pulse Mode ##############################*/
  560. /* Blocking mode: Polling */
  561. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  562. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Stop(LPTIM_HandleTypeDef *hlptim);
  563. /* Non-Blocking mode: Interrupt */
  564. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  565. HAL_StatusTypeDef HAL_LPTIM_OnePulse_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  566. /* ############################## Set once Mode ##############################*/
  567. /* Blocking mode: Polling */
  568. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  569. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Stop(LPTIM_HandleTypeDef *hlptim);
  570. /* Non-Blocking mode: Interrupt */
  571. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Pulse);
  572. HAL_StatusTypeDef HAL_LPTIM_SetOnce_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  573. /* ############################### Encoder Mode ##############################*/
  574. /* Blocking mode: Polling */
  575. HAL_StatusTypeDef HAL_LPTIM_Encoder_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  576. HAL_StatusTypeDef HAL_LPTIM_Encoder_Stop(LPTIM_HandleTypeDef *hlptim);
  577. /* Non-Blocking mode: Interrupt */
  578. HAL_StatusTypeDef HAL_LPTIM_Encoder_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  579. HAL_StatusTypeDef HAL_LPTIM_Encoder_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  580. /* ############################# Time out Mode ##############################*/
  581. /* Blocking mode: Polling */
  582. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Timeout);
  583. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Stop(LPTIM_HandleTypeDef *hlptim);
  584. /* Non-Blocking mode: Interrupt */
  585. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period, uint32_t Timeout);
  586. HAL_StatusTypeDef HAL_LPTIM_TimeOut_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  587. /* ############################## Counter Mode ###############################*/
  588. /* Blocking mode: Polling */
  589. HAL_StatusTypeDef HAL_LPTIM_Counter_Start(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  590. HAL_StatusTypeDef HAL_LPTIM_Counter_Stop(LPTIM_HandleTypeDef *hlptim);
  591. /* Non-Blocking mode: Interrupt */
  592. HAL_StatusTypeDef HAL_LPTIM_Counter_Start_IT(LPTIM_HandleTypeDef *hlptim, uint32_t Period);
  593. HAL_StatusTypeDef HAL_LPTIM_Counter_Stop_IT(LPTIM_HandleTypeDef *hlptim);
  594. /**
  595. * @}
  596. */
  597. /** @addtogroup LPTIM_Exported_Functions_Group3
  598. * @brief Read operation functions.
  599. * @{
  600. */
  601. /* Reading operation functions ************************************************/
  602. uint32_t HAL_LPTIM_ReadCounter(LPTIM_HandleTypeDef *hlptim);
  603. uint32_t HAL_LPTIM_ReadAutoReload(LPTIM_HandleTypeDef *hlptim);
  604. uint32_t HAL_LPTIM_ReadCompare(LPTIM_HandleTypeDef *hlptim);
  605. /**
  606. * @}
  607. */
  608. /** @addtogroup LPTIM_Exported_Functions_Group4
  609. * @brief LPTIM IRQ handler and callback functions.
  610. * @{
  611. */
  612. /* LPTIM IRQ functions *******************************************************/
  613. void HAL_LPTIM_IRQHandler(LPTIM_HandleTypeDef *hlptim);
  614. /* CallBack functions ********************************************************/
  615. void HAL_LPTIM_CompareMatchCallback(LPTIM_HandleTypeDef *hlptim);
  616. void HAL_LPTIM_AutoReloadMatchCallback(LPTIM_HandleTypeDef *hlptim);
  617. void HAL_LPTIM_TriggerCallback(LPTIM_HandleTypeDef *hlptim);
  618. void HAL_LPTIM_CompareWriteCallback(LPTIM_HandleTypeDef *hlptim);
  619. void HAL_LPTIM_AutoReloadWriteCallback(LPTIM_HandleTypeDef *hlptim);
  620. void HAL_LPTIM_DirectionUpCallback(LPTIM_HandleTypeDef *hlptim);
  621. void HAL_LPTIM_DirectionDownCallback(LPTIM_HandleTypeDef *hlptim);
  622. /* Callbacks Register/UnRegister functions ***********************************/
  623. #if (USE_HAL_LPTIM_REGISTER_CALLBACKS == 1)
  624. HAL_StatusTypeDef HAL_LPTIM_RegisterCallback(LPTIM_HandleTypeDef *lphtim, HAL_LPTIM_CallbackIDTypeDef CallbackID,
  625. pLPTIM_CallbackTypeDef pCallback);
  626. HAL_StatusTypeDef HAL_LPTIM_UnRegisterCallback(LPTIM_HandleTypeDef *lphtim, HAL_LPTIM_CallbackIDTypeDef CallbackID);
  627. #endif /* USE_HAL_LPTIM_REGISTER_CALLBACKS */
  628. /**
  629. * @}
  630. */
  631. /** @addtogroup LPTIM_Group5
  632. * @brief Peripheral State functions.
  633. * @{
  634. */
  635. /* Peripheral State functions ************************************************/
  636. HAL_LPTIM_StateTypeDef HAL_LPTIM_GetState(LPTIM_HandleTypeDef *hlptim);
  637. /**
  638. * @}
  639. */
  640. /**
  641. * @}
  642. */
  643. /* Private types -------------------------------------------------------------*/
  644. /** @defgroup LPTIM_Private_Types LPTIM Private Types
  645. * @{
  646. */
  647. /**
  648. * @}
  649. */
  650. /* Private variables ---------------------------------------------------------*/
  651. /** @defgroup LPTIM_Private_Variables LPTIM Private Variables
  652. * @{
  653. */
  654. /**
  655. * @}
  656. */
  657. /* Private constants ---------------------------------------------------------*/
  658. /** @defgroup LPTIM_Private_Constants LPTIM Private Constants
  659. * @{
  660. */
  661. /**
  662. * @}
  663. */
  664. /* Private macros ------------------------------------------------------------*/
  665. /** @defgroup LPTIM_Private_Macros LPTIM Private Macros
  666. * @{
  667. */
  668. #define IS_LPTIM_CLOCK_SOURCE(__SOURCE__) (((__SOURCE__) == LPTIM_CLOCKSOURCE_ULPTIM) || \
  669. ((__SOURCE__) == LPTIM_CLOCKSOURCE_APBCLOCK_LPOSC))
  670. #define IS_LPTIM_CLOCK_PRESCALER(__PRESCALER__) (((__PRESCALER__) == LPTIM_PRESCALER_DIV1 ) || \
  671. ((__PRESCALER__) == LPTIM_PRESCALER_DIV2 ) || \
  672. ((__PRESCALER__) == LPTIM_PRESCALER_DIV4 ) || \
  673. ((__PRESCALER__) == LPTIM_PRESCALER_DIV8 ) || \
  674. ((__PRESCALER__) == LPTIM_PRESCALER_DIV16 ) || \
  675. ((__PRESCALER__) == LPTIM_PRESCALER_DIV32 ) || \
  676. ((__PRESCALER__) == LPTIM_PRESCALER_DIV64 ) || \
  677. ((__PRESCALER__) == LPTIM_PRESCALER_DIV128))
  678. #define IS_LPTIM_CLOCK_PRESCALERDIV1(__PRESCALER__) ((__PRESCALER__) == LPTIM_PRESCALER_DIV1)
  679. #define IS_LPTIM_OUTPUT_POLARITY(__POLARITY__) (((__POLARITY__) == LPTIM_OUTPUTPOLARITY_LOW ) || \
  680. ((__POLARITY__) == LPTIM_OUTPUTPOLARITY_HIGH))
  681. #define IS_LPTIM_CLOCK_SAMPLE_TIME(__SAMPLETIME__) (((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_DIRECTTRANSITION) || \
  682. ((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_2TRANSITIONS) || \
  683. ((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_4TRANSITIONS) || \
  684. ((__SAMPLETIME__) == LPTIM_CLOCKSAMPLETIME_8TRANSITIONS))
  685. #define IS_LPTIM_CLOCK_POLARITY(__POLARITY__) (((__POLARITY__) == LPTIM_CLOCKPOLARITY_RISING) || \
  686. ((__POLARITY__) == LPTIM_CLOCKPOLARITY_FALLING) || \
  687. ((__POLARITY__) == LPTIM_CLOCKPOLARITY_RISING_FALLING))
  688. #define IS_LPTIM_TRG_SOURCE(__TRIG__) (((__TRIG__) == LPTIM_TRIGSOURCE_SOFTWARE) || \
  689. ((__TRIG__) == LPTIM_TRIGSOURCE_0) || \
  690. ((__TRIG__) == LPTIM_TRIGSOURCE_1) || \
  691. ((__TRIG__) == LPTIM_TRIGSOURCE_2) || \
  692. ((__TRIG__) == LPTIM_TRIGSOURCE_3) || \
  693. ((__TRIG__) == LPTIM_TRIGSOURCE_4) || \
  694. ((__TRIG__) == LPTIM_TRIGSOURCE_5))
  695. #define IS_LPTIM_EXT_TRG_POLARITY(__POLARITY__) (((__POLARITY__) == LPTIM_ACTIVEEDGE_RISING ) || \
  696. ((__POLARITY__) == LPTIM_ACTIVEEDGE_FALLING ) || \
  697. ((__POLARITY__) == LPTIM_ACTIVEEDGE_RISING_FALLING ))
  698. #define IS_LPTIM_TRIG_SAMPLE_TIME(__SAMPLETIME__) (((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_DIRECTTRANSITION) || \
  699. ((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_2TRANSITIONS ) || \
  700. ((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_4TRANSITIONS ) || \
  701. ((__SAMPLETIME__) == LPTIM_TRIGSAMPLETIME_8TRANSITIONS ))
  702. #define IS_LPTIM_UPDATE_MODE(__MODE__) (((__MODE__) == LPTIM_UPDATE_IMMEDIATE) || \
  703. ((__MODE__) == LPTIM_UPDATE_ENDOFPERIOD))
  704. #define IS_LPTIM_COUNTER_SOURCE(__SOURCE__) (((__SOURCE__) == LPTIM_COUNTERSOURCE_INTERNAL) || \
  705. ((__SOURCE__) == LPTIM_COUNTERSOURCE_EXTERNAL))
  706. #define IS_LPTIM_AUTORELOAD(__AUTORELOAD__) ((0x00000001UL <= (__AUTORELOAD__)) &&\
  707. ((__AUTORELOAD__) <= 0x0000FFFFUL))
  708. #define IS_LPTIM_COMPARE(__COMPARE__) ((__COMPARE__) <= 0x0000FFFFUL)
  709. #define IS_LPTIM_PERIOD(__PERIOD__) ((0x00000001UL <= (__PERIOD__)) &&\
  710. ((__PERIOD__) <= 0x0000FFFFUL))
  711. #define IS_LPTIM_PULSE(__PULSE__) ((__PULSE__) <= 0x0000FFFFUL)
  712. /**
  713. * @}
  714. */
  715. /* Private functions ---------------------------------------------------------*/
  716. /** @defgroup LPTIM_Private_Functions LPTIM Private Functions
  717. * @{
  718. */
  719. void LPTIM_Disable(LPTIM_HandleTypeDef *hlptim);
  720. /**
  721. * @}
  722. */
  723. /**
  724. * @}
  725. */
  726. #endif /* LPTIM1 */
  727. /**
  728. * @}
  729. */
  730. #ifdef __cplusplus
  731. }
  732. #endif
  733. #endif /* STM32F4xx_HAL_LPTIM_H */