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.
 
 
 

1564 lines
71 KiB

  1. /**
  2. ******************************************************************************
  3. * @file stm32f7xx_hal_tim.h
  4. * @author MCD Application Team
  5. * @version V1.2.2
  6. * @date 14-April-2017
  7. * @brief Header file of TIM HAL module.
  8. ******************************************************************************
  9. * @attention
  10. *
  11. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  12. *
  13. * Redistribution and use in source and binary forms, with or without modification,
  14. * are permitted provided that the following conditions are met:
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. * 2. Redistributions in binary form must reproduce the above copyright notice,
  18. * this list of conditions and the following disclaimer in the documentation
  19. * and/or other materials provided with the distribution.
  20. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  21. * may be used to endorse or promote products derived from this software
  22. * without specific prior written permission.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  27. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  28. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  31. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  32. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  33. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. ******************************************************************************
  36. */
  37. /* Define to prevent recursive inclusion -------------------------------------*/
  38. #ifndef __STM32F7xx_HAL_TIM_H
  39. #define __STM32F7xx_HAL_TIM_H
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43. /* Includes ------------------------------------------------------------------*/
  44. #include "stm32f7xx_hal_def.h"
  45. /** @addtogroup STM32F7xx_HAL_Driver
  46. * @{
  47. */
  48. /** @addtogroup TIM
  49. * @{
  50. */
  51. /* Exported types ------------------------------------------------------------*/
  52. /** @defgroup TIM_Exported_Types TIM Exported Types
  53. * @{
  54. */
  55. /**
  56. * @brief TIM Time base Configuration Structure definition
  57. */
  58. typedef struct
  59. {
  60. uint32_t Prescaler; /*!< Specifies the prescaler value used to divide the TIM clock.
  61. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF */
  62. uint32_t CounterMode; /*!< Specifies the counter mode.
  63. This parameter can be a value of @ref TIM_Counter_Mode */
  64. uint32_t Period; /*!< Specifies the period value to be loaded into the active
  65. Auto-Reload Register at the next update event.
  66. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF. */
  67. uint32_t ClockDivision; /*!< Specifies the clock division.
  68. This parameter can be a value of @ref TIM_ClockDivision */
  69. uint32_t RepetitionCounter; /*!< Specifies the repetition counter value. Each time the RCR down-counter
  70. reaches zero, an update event is generated and counting restarts
  71. from the RCR value (N).
  72. This means in PWM mode that (N+1) corresponds to:
  73. - the number of PWM periods in edge-aligned mode
  74. - the number of half PWM period in center-aligned mode
  75. This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF.
  76. @note This parameter is valid only for TIM1 and TIM8. */
  77. uint32_t AutoReloadPreload; /*!< Specifies the auto-reload preload.
  78. This parameter can be a value of @ref TIM_AutoReloadPreload */
  79. } TIM_Base_InitTypeDef;
  80. /**
  81. * @brief TIM Output Compare Configuration Structure definition
  82. */
  83. typedef struct
  84. {
  85. uint32_t OCMode; /*!< Specifies the TIM mode.
  86. This parameter can be a value of @ref TIMEx_Output_Compare_and_PWM_modes */
  87. uint32_t Pulse; /*!< Specifies the pulse value to be loaded into the Capture Compare Register.
  88. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF */
  89. uint32_t OCPolarity; /*!< Specifies the output polarity.
  90. This parameter can be a value of @ref TIM_Output_Compare_Polarity */
  91. uint32_t OCNPolarity; /*!< Specifies the complementary output polarity.
  92. This parameter can be a value of @ref TIM_Output_Compare_N_Polarity
  93. @note This parameter is valid only for TIM1 and TIM8. */
  94. uint32_t OCFastMode; /*!< Specifies the Fast mode state.
  95. This parameter can be a value of @ref TIM_Output_Fast_State
  96. @note This parameter is valid only in PWM1 and PWM2 mode. */
  97. uint32_t OCIdleState; /*!< Specifies the TIM Output Compare pin state during Idle state.
  98. This parameter can be a value of @ref TIM_Output_Compare_Idle_State
  99. @note This parameter is valid only for TIM1 and TIM8. */
  100. uint32_t OCNIdleState; /*!< Specifies the TIM Output Compare pin state during Idle state.
  101. This parameter can be a value of @ref TIM_Output_Compare_N_Idle_State
  102. @note This parameter is valid only for TIM1 and TIM8. */
  103. } TIM_OC_InitTypeDef;
  104. /**
  105. * @brief TIM One Pulse Mode Configuration Structure definition
  106. */
  107. typedef struct
  108. {
  109. uint32_t OCMode; /*!< Specifies the TIM mode.
  110. This parameter can be a value of @ref TIMEx_Output_Compare_and_PWM_modes */
  111. uint32_t Pulse; /*!< Specifies the pulse value to be loaded into the Capture Compare Register.
  112. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF */
  113. uint32_t OCPolarity; /*!< Specifies the output polarity.
  114. This parameter can be a value of @ref TIM_Output_Compare_Polarity */
  115. uint32_t OCNPolarity; /*!< Specifies the complementary output polarity.
  116. This parameter can be a value of @ref TIM_Output_Compare_N_Polarity
  117. @note This parameter is valid only for TIM1 and TIM8. */
  118. uint32_t OCIdleState; /*!< Specifies the TIM Output Compare pin state during Idle state.
  119. This parameter can be a value of @ref TIM_Output_Compare_Idle_State
  120. @note This parameter is valid only for TIM1 and TIM8. */
  121. uint32_t OCNIdleState; /*!< Specifies the TIM Output Compare pin state during Idle state.
  122. This parameter can be a value of @ref TIM_Output_Compare_N_Idle_State
  123. @note This parameter is valid only for TIM1 and TIM8. */
  124. uint32_t ICPolarity; /*!< Specifies the active edge of the input signal.
  125. This parameter can be a value of @ref TIM_Input_Capture_Polarity */
  126. uint32_t ICSelection; /*!< Specifies the input.
  127. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  128. uint32_t ICFilter; /*!< Specifies the input capture filter.
  129. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  130. } TIM_OnePulse_InitTypeDef;
  131. /**
  132. * @brief TIM Input Capture Configuration Structure definition
  133. */
  134. typedef struct
  135. {
  136. uint32_t ICPolarity; /*!< Specifies the active edge of the input signal.
  137. This parameter can be a value of @ref TIM_Input_Capture_Polarity */
  138. uint32_t ICSelection; /*!< Specifies the input.
  139. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  140. uint32_t ICPrescaler; /*!< Specifies the Input Capture Prescaler.
  141. This parameter can be a value of @ref TIM_Input_Capture_Prescaler */
  142. uint32_t ICFilter; /*!< Specifies the input capture filter.
  143. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  144. } TIM_IC_InitTypeDef;
  145. /**
  146. * @brief TIM Encoder Configuration Structure definition
  147. */
  148. typedef struct
  149. {
  150. uint32_t EncoderMode; /*!< Specifies the active edge of the input signal.
  151. This parameter can be a value of @ref TIM_Encoder_Mode */
  152. uint32_t IC1Polarity; /*!< Specifies the active edge of the input signal.
  153. This parameter can be a value of @ref TIM_Input_Capture_Polarity */
  154. uint32_t IC1Selection; /*!< Specifies the input.
  155. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  156. uint32_t IC1Prescaler; /*!< Specifies the Input Capture Prescaler.
  157. This parameter can be a value of @ref TIM_Input_Capture_Prescaler */
  158. uint32_t IC1Filter; /*!< Specifies the input capture filter.
  159. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  160. uint32_t IC2Polarity; /*!< Specifies the active edge of the input signal.
  161. This parameter can be a value of @ref TIM_Input_Capture_Polarity */
  162. uint32_t IC2Selection; /*!< Specifies the input.
  163. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  164. uint32_t IC2Prescaler; /*!< Specifies the Input Capture Prescaler.
  165. This parameter can be a value of @ref TIM_Input_Capture_Prescaler */
  166. uint32_t IC2Filter; /*!< Specifies the input capture filter.
  167. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  168. } TIM_Encoder_InitTypeDef;
  169. /**
  170. * @brief Clock Configuration Handle Structure definition
  171. */
  172. typedef struct
  173. {
  174. uint32_t ClockSource; /*!< TIM clock sources.
  175. This parameter can be a value of @ref TIM_Clock_Source */
  176. uint32_t ClockPolarity; /*!< TIM clock polarity.
  177. This parameter can be a value of @ref TIM_Clock_Polarity */
  178. uint32_t ClockPrescaler; /*!< TIM clock prescaler.
  179. This parameter can be a value of @ref TIM_Clock_Prescaler */
  180. uint32_t ClockFilter; /*!< TIM clock filter.
  181. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  182. }TIM_ClockConfigTypeDef;
  183. /**
  184. * @brief Clear Input Configuration Handle Structure definition
  185. */
  186. typedef struct
  187. {
  188. uint32_t ClearInputState; /*!< TIM clear Input state.
  189. This parameter can be ENABLE or DISABLE */
  190. uint32_t ClearInputSource; /*!< TIM clear Input sources.
  191. This parameter can be a value of @ref TIMEx_ClearInput_Source */
  192. uint32_t ClearInputPolarity; /*!< TIM Clear Input polarity.
  193. This parameter can be a value of @ref TIM_ClearInput_Polarity */
  194. uint32_t ClearInputPrescaler; /*!< TIM Clear Input prescaler.
  195. This parameter can be a value of @ref TIM_ClearInput_Prescaler */
  196. uint32_t ClearInputFilter; /*!< TIM Clear Input filter.
  197. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  198. }TIM_ClearInputConfigTypeDef;
  199. /**
  200. * @brief TIM Slave configuration Structure definition
  201. */
  202. typedef struct {
  203. uint32_t SlaveMode; /*!< Slave mode selection
  204. This parameter can be a value of @ref TIMEx_Slave_Mode */
  205. uint32_t InputTrigger; /*!< Input Trigger source
  206. This parameter can be a value of @ref TIM_Trigger_Selection */
  207. uint32_t TriggerPolarity; /*!< Input Trigger polarity
  208. This parameter can be a value of @ref TIM_Trigger_Polarity */
  209. uint32_t TriggerPrescaler; /*!< Input trigger prescaler
  210. This parameter can be a value of @ref TIM_Trigger_Prescaler */
  211. uint32_t TriggerFilter; /*!< Input trigger filter
  212. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  213. }TIM_SlaveConfigTypeDef;
  214. /**
  215. * @brief HAL State structures definition
  216. */
  217. typedef enum
  218. {
  219. HAL_TIM_STATE_RESET = 0x00U, /*!< Peripheral not yet initialized or disabled */
  220. HAL_TIM_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */
  221. HAL_TIM_STATE_BUSY = 0x02U, /*!< An internal process is ongoing */
  222. HAL_TIM_STATE_TIMEOUT = 0x03U, /*!< Timeout state */
  223. HAL_TIM_STATE_ERROR = 0x04U /*!< Reception process is ongoing */
  224. }HAL_TIM_StateTypeDef;
  225. /**
  226. * @brief HAL Active channel structures definition
  227. */
  228. typedef enum
  229. {
  230. HAL_TIM_ACTIVE_CHANNEL_1 = 0x01U, /*!< The active channel is 1 */
  231. HAL_TIM_ACTIVE_CHANNEL_2 = 0x02U, /*!< The active channel is 2 */
  232. HAL_TIM_ACTIVE_CHANNEL_3 = 0x04U, /*!< The active channel is 3 */
  233. HAL_TIM_ACTIVE_CHANNEL_4 = 0x08U, /*!< The active channel is 4 */
  234. HAL_TIM_ACTIVE_CHANNEL_CLEARED = 0x00U /*!< All active channels cleared */
  235. }HAL_TIM_ActiveChannel;
  236. /**
  237. * @brief TIM Time Base Handle Structure definition
  238. */
  239. typedef struct
  240. {
  241. TIM_TypeDef *Instance; /*!< Register base address */
  242. TIM_Base_InitTypeDef Init; /*!< TIM Time Base required parameters */
  243. HAL_TIM_ActiveChannel Channel; /*!< Active channel */
  244. DMA_HandleTypeDef *hdma[7]; /*!< DMA Handlers array
  245. This array is accessed by a @ref DMA_Handle_index */
  246. HAL_LockTypeDef Lock; /*!< Locking object */
  247. __IO HAL_TIM_StateTypeDef State; /*!< TIM operation state */
  248. }TIM_HandleTypeDef;
  249. /**
  250. * @}
  251. */
  252. /* Exported constants --------------------------------------------------------*/
  253. /** @defgroup TIM_Exported_Constants TIM Exported Constants
  254. * @{
  255. */
  256. /** @defgroup TIM_Input_Channel_Polarity TIM Input Channel Polarity
  257. * @{
  258. */
  259. #define TIM_INPUTCHANNELPOLARITY_RISING ((uint32_t)0x00000000U) /*!< Polarity for TIx source */
  260. #define TIM_INPUTCHANNELPOLARITY_FALLING (TIM_CCER_CC1P) /*!< Polarity for TIx source */
  261. #define TIM_INPUTCHANNELPOLARITY_BOTHEDGE (TIM_CCER_CC1P | TIM_CCER_CC1NP) /*!< Polarity for TIx source */
  262. /**
  263. * @}
  264. */
  265. /** @defgroup TIM_ETR_Polarity TIM ETR Polarity
  266. * @{
  267. */
  268. #define TIM_ETRPOLARITY_INVERTED (TIM_SMCR_ETP) /*!< Polarity for ETR source */
  269. #define TIM_ETRPOLARITY_NONINVERTED ((uint32_t)0x0000U) /*!< Polarity for ETR source */
  270. /**
  271. * @}
  272. */
  273. /** @defgroup TIM_ETR_Prescaler TIM ETR Prescaler
  274. * @{
  275. */
  276. #define TIM_ETRPRESCALER_DIV1 ((uint32_t)0x0000U) /*!< No prescaler is used */
  277. #define TIM_ETRPRESCALER_DIV2 (TIM_SMCR_ETPS_0) /*!< ETR input source is divided by 2 */
  278. #define TIM_ETRPRESCALER_DIV4 (TIM_SMCR_ETPS_1) /*!< ETR input source is divided by 4 */
  279. #define TIM_ETRPRESCALER_DIV8 (TIM_SMCR_ETPS) /*!< ETR input source is divided by 8 */
  280. /**
  281. * @}
  282. */
  283. /** @defgroup TIM_Counter_Mode TIM Counter Mode
  284. * @{
  285. */
  286. #define TIM_COUNTERMODE_UP ((uint32_t)0x0000U)
  287. #define TIM_COUNTERMODE_DOWN TIM_CR1_DIR
  288. #define TIM_COUNTERMODE_CENTERALIGNED1 TIM_CR1_CMS_0
  289. #define TIM_COUNTERMODE_CENTERALIGNED2 TIM_CR1_CMS_1
  290. #define TIM_COUNTERMODE_CENTERALIGNED3 TIM_CR1_CMS
  291. /**
  292. * @}
  293. */
  294. /** @defgroup TIM_ClockDivision TIM Clock Division
  295. * @{
  296. */
  297. #define TIM_CLOCKDIVISION_DIV1 ((uint32_t)0x0000U)
  298. #define TIM_CLOCKDIVISION_DIV2 (TIM_CR1_CKD_0)
  299. #define TIM_CLOCKDIVISION_DIV4 (TIM_CR1_CKD_1)
  300. /**
  301. * @}
  302. */
  303. /** @defgroup TIM_Output_Compare_State TIM Output Compare State
  304. * @{
  305. */
  306. #define TIM_OUTPUTSTATE_DISABLE ((uint32_t)0x0000U)
  307. #define TIM_OUTPUTSTATE_ENABLE (TIM_CCER_CC1E)
  308. /**
  309. * @}
  310. */
  311. /** @defgroup TIM_AutoReloadPreload TIM Auto-Reload Preload
  312. * @{
  313. */
  314. #define TIM_AUTORELOAD_PRELOAD_DISABLE ((uint32_t)0x0000) /*!< TIMx_ARR register is not buffered */
  315. #define TIM_AUTORELOAD_PRELOAD_ENABLE (TIM_CR1_ARPE) /*!< TIMx_ARR register is buffered */
  316. /**
  317. * @}
  318. */
  319. /** @defgroup TIM_Output_Fast_State TIM Output Fast State
  320. * @{
  321. */
  322. #define TIM_OCFAST_DISABLE ((uint32_t)0x0000U)
  323. #define TIM_OCFAST_ENABLE (TIM_CCMR1_OC1FE)
  324. /**
  325. * @}
  326. */
  327. /** @defgroup TIM_Output_Compare_N_State TIM Complementary Output Compare State
  328. * @{
  329. */
  330. #define TIM_OUTPUTNSTATE_DISABLE ((uint32_t)0x0000U)
  331. #define TIM_OUTPUTNSTATE_ENABLE (TIM_CCER_CC1NE)
  332. /**
  333. * @}
  334. */
  335. /** @defgroup TIM_Output_Compare_Polarity TIM Output Compare Polarity
  336. * @{
  337. */
  338. #define TIM_OCPOLARITY_HIGH ((uint32_t)0x0000U)
  339. #define TIM_OCPOLARITY_LOW (TIM_CCER_CC1P)
  340. /**
  341. * @}
  342. */
  343. /** @defgroup TIM_Output_Compare_N_Polarity TIM Complementary Output Compare Polarity
  344. * @{
  345. */
  346. #define TIM_OCNPOLARITY_HIGH ((uint32_t)0x0000U)
  347. #define TIM_OCNPOLARITY_LOW (TIM_CCER_CC1NP)
  348. /**
  349. * @}
  350. */
  351. /** @defgroup TIM_Output_Compare_Idle_State TIM Output Compare Idle State
  352. * @{
  353. */
  354. #define TIM_OCIDLESTATE_SET (TIM_CR2_OIS1)
  355. #define TIM_OCIDLESTATE_RESET ((uint32_t)0x0000U)
  356. /**
  357. * @}
  358. */
  359. /** @defgroup TIM_Output_Compare_N_Idle_State TIM Output Compare N Idle State
  360. * @{
  361. */
  362. #define TIM_OCNIDLESTATE_SET (TIM_CR2_OIS1N)
  363. #define TIM_OCNIDLESTATE_RESET ((uint32_t)0x0000U)
  364. /**
  365. * @}
  366. */
  367. /** @defgroup TIM_Input_Capture_Polarity TIM Input Capture Polarity
  368. * @{
  369. */
  370. #define TIM_ICPOLARITY_RISING TIM_INPUTCHANNELPOLARITY_RISING
  371. #define TIM_ICPOLARITY_FALLING TIM_INPUTCHANNELPOLARITY_FALLING
  372. #define TIM_ICPOLARITY_BOTHEDGE TIM_INPUTCHANNELPOLARITY_BOTHEDGE
  373. /**
  374. * @}
  375. */
  376. /** @defgroup TIM_Input_Capture_Selection TIM Input Capture Selection
  377. * @{
  378. */
  379. #define TIM_ICSELECTION_DIRECTTI (TIM_CCMR1_CC1S_0) /*!< TIM Input 1, 2, 3 or 4 is selected to be
  380. connected to IC1, IC2, IC3 or IC4, respectively */
  381. #define TIM_ICSELECTION_INDIRECTTI (TIM_CCMR1_CC1S_1) /*!< TIM Input 1, 2, 3 or 4 is selected to be
  382. connected to IC2, IC1, IC4 or IC3, respectively */
  383. #define TIM_ICSELECTION_TRC (TIM_CCMR1_CC1S) /*!< TIM Input 1, 2, 3 or 4 is selected to be connected to TRC */
  384. /**
  385. * @}
  386. */
  387. /** @defgroup TIM_Input_Capture_Prescaler TIM Input Capture Prescaler
  388. * @{
  389. */
  390. #define TIM_ICPSC_DIV1 ((uint32_t)0x0000U) /*!< Capture performed each time an edge is detected on the capture input */
  391. #define TIM_ICPSC_DIV2 (TIM_CCMR1_IC1PSC_0) /*!< Capture performed once every 2 events */
  392. #define TIM_ICPSC_DIV4 (TIM_CCMR1_IC1PSC_1) /*!< Capture performed once every 4 events */
  393. #define TIM_ICPSC_DIV8 (TIM_CCMR1_IC1PSC) /*!< Capture performed once every 8 events */
  394. /**
  395. * @}
  396. */
  397. /** @defgroup TIM_One_Pulse_Mode TIM One Pulse Mode
  398. * @{
  399. */
  400. #define TIM_OPMODE_SINGLE (TIM_CR1_OPM)
  401. #define TIM_OPMODE_REPETITIVE ((uint32_t)0x0000U)
  402. /**
  403. * @}
  404. */
  405. /** @defgroup TIM_Encoder_Mode TIM Encoder Mode
  406. * @{
  407. */
  408. #define TIM_ENCODERMODE_TI1 (TIM_SMCR_SMS_0)
  409. #define TIM_ENCODERMODE_TI2 (TIM_SMCR_SMS_1)
  410. #define TIM_ENCODERMODE_TI12 (TIM_SMCR_SMS_1 | TIM_SMCR_SMS_0)
  411. /**
  412. * @}
  413. */
  414. /** @defgroup TIM_Interrupt_definition TIM Interrupt definition
  415. * @{
  416. */
  417. #define TIM_IT_UPDATE (TIM_DIER_UIE)
  418. #define TIM_IT_CC1 (TIM_DIER_CC1IE)
  419. #define TIM_IT_CC2 (TIM_DIER_CC2IE)
  420. #define TIM_IT_CC3 (TIM_DIER_CC3IE)
  421. #define TIM_IT_CC4 (TIM_DIER_CC4IE)
  422. #define TIM_IT_COM (TIM_DIER_COMIE)
  423. #define TIM_IT_TRIGGER (TIM_DIER_TIE)
  424. #define TIM_IT_BREAK (TIM_DIER_BIE)
  425. /**
  426. * @}
  427. */
  428. /** @defgroup TIM_Commutation_Source TIM Commutation Source
  429. * @{
  430. */
  431. #define TIM_COMMUTATION_TRGI (TIM_CR2_CCUS)
  432. #define TIM_COMMUTATION_SOFTWARE ((uint32_t)0x0000U)
  433. /**
  434. * @}
  435. */
  436. /** @defgroup TIM_DMA_sources TIM DMA sources
  437. * @{
  438. */
  439. #define TIM_DMA_UPDATE (TIM_DIER_UDE)
  440. #define TIM_DMA_CC1 (TIM_DIER_CC1DE)
  441. #define TIM_DMA_CC2 (TIM_DIER_CC2DE)
  442. #define TIM_DMA_CC3 (TIM_DIER_CC3DE)
  443. #define TIM_DMA_CC4 (TIM_DIER_CC4DE)
  444. #define TIM_DMA_COM (TIM_DIER_COMDE)
  445. #define TIM_DMA_TRIGGER (TIM_DIER_TDE)
  446. /**
  447. * @}
  448. */
  449. /** @defgroup TIM_Event_Source TIM Event Source
  450. * @{
  451. */
  452. #define TIM_EVENTSOURCE_UPDATE TIM_EGR_UG
  453. #define TIM_EVENTSOURCE_CC1 TIM_EGR_CC1G
  454. #define TIM_EVENTSOURCE_CC2 TIM_EGR_CC2G
  455. #define TIM_EVENTSOURCE_CC3 TIM_EGR_CC3G
  456. #define TIM_EVENTSOURCE_CC4 TIM_EGR_CC4G
  457. #define TIM_EVENTSOURCE_COM TIM_EGR_COMG
  458. #define TIM_EVENTSOURCE_TRIGGER TIM_EGR_TG
  459. #define TIM_EVENTSOURCE_BREAK TIM_EGR_BG
  460. #define TIM_EVENTSOURCE_BREAK2 TIM_EGR_B2G
  461. /**
  462. * @}
  463. */
  464. /** @defgroup TIM_Flag_definition TIM Flag definition
  465. * @{
  466. */
  467. #define TIM_FLAG_UPDATE (TIM_SR_UIF)
  468. #define TIM_FLAG_CC1 (TIM_SR_CC1IF)
  469. #define TIM_FLAG_CC2 (TIM_SR_CC2IF)
  470. #define TIM_FLAG_CC3 (TIM_SR_CC3IF)
  471. #define TIM_FLAG_CC4 (TIM_SR_CC4IF)
  472. #define TIM_FLAG_COM (TIM_SR_COMIF)
  473. #define TIM_FLAG_TRIGGER (TIM_SR_TIF)
  474. #define TIM_FLAG_BREAK (TIM_SR_BIF)
  475. #define TIM_FLAG_BREAK2 (TIM_SR_B2IF)
  476. #define TIM_FLAG_CC1OF (TIM_SR_CC1OF)
  477. #define TIM_FLAG_CC2OF (TIM_SR_CC2OF)
  478. #define TIM_FLAG_CC3OF (TIM_SR_CC3OF)
  479. #define TIM_FLAG_CC4OF (TIM_SR_CC4OF)
  480. /**
  481. * @}
  482. */
  483. /** @defgroup TIM_Clock_Source TIM Clock Source
  484. * @{
  485. */
  486. #define TIM_CLOCKSOURCE_ETRMODE2 (TIM_SMCR_ETPS_1)
  487. #define TIM_CLOCKSOURCE_INTERNAL (TIM_SMCR_ETPS_0)
  488. #define TIM_CLOCKSOURCE_ITR0 ((uint32_t)0x0000U)
  489. #define TIM_CLOCKSOURCE_ITR1 (TIM_SMCR_TS_0)
  490. #define TIM_CLOCKSOURCE_ITR2 (TIM_SMCR_TS_1)
  491. #define TIM_CLOCKSOURCE_ITR3 (TIM_SMCR_TS_0 | TIM_SMCR_TS_1)
  492. #define TIM_CLOCKSOURCE_TI1ED (TIM_SMCR_TS_2)
  493. #define TIM_CLOCKSOURCE_TI1 (TIM_SMCR_TS_0 | TIM_SMCR_TS_2)
  494. #define TIM_CLOCKSOURCE_TI2 (TIM_SMCR_TS_1 | TIM_SMCR_TS_2)
  495. #define TIM_CLOCKSOURCE_ETRMODE1 (TIM_SMCR_TS)
  496. /**
  497. * @}
  498. */
  499. /** @defgroup TIM_Clock_Polarity TIM Clock Polarity
  500. * @{
  501. */
  502. #define TIM_CLOCKPOLARITY_INVERTED TIM_ETRPOLARITY_INVERTED /*!< Polarity for ETRx clock sources */
  503. #define TIM_CLOCKPOLARITY_NONINVERTED TIM_ETRPOLARITY_NONINVERTED /*!< Polarity for ETRx clock sources */
  504. #define TIM_CLOCKPOLARITY_RISING TIM_INPUTCHANNELPOLARITY_RISING /*!< Polarity for TIx clock sources */
  505. #define TIM_CLOCKPOLARITY_FALLING TIM_INPUTCHANNELPOLARITY_FALLING /*!< Polarity for TIx clock sources */
  506. #define TIM_CLOCKPOLARITY_BOTHEDGE TIM_INPUTCHANNELPOLARITY_BOTHEDGE /*!< Polarity for TIx clock sources */
  507. /**
  508. * @}
  509. */
  510. /** @defgroup TIM_Clock_Prescaler TIM Clock Prescaler
  511. * @{
  512. */
  513. #define TIM_CLOCKPRESCALER_DIV1 TIM_ETRPRESCALER_DIV1 /*!< No prescaler is used */
  514. #define TIM_CLOCKPRESCALER_DIV2 TIM_ETRPRESCALER_DIV2 /*!< Prescaler for External ETR Clock: Capture performed once every 2 events. */
  515. #define TIM_CLOCKPRESCALER_DIV4 TIM_ETRPRESCALER_DIV4 /*!< Prescaler for External ETR Clock: Capture performed once every 4 events. */
  516. #define TIM_CLOCKPRESCALER_DIV8 TIM_ETRPRESCALER_DIV8 /*!< Prescaler for External ETR Clock: Capture performed once every 8 events. */
  517. /**
  518. * @}
  519. */
  520. /** @defgroup TIM_ClearInput_Polarity TIM Clear Input Polarity
  521. * @{
  522. */
  523. #define TIM_CLEARINPUTPOLARITY_INVERTED TIM_ETRPOLARITY_INVERTED /*!< Polarity for ETRx pin */
  524. #define TIM_CLEARINPUTPOLARITY_NONINVERTED TIM_ETRPOLARITY_NONINVERTED /*!< Polarity for ETRx pin */
  525. /**
  526. * @}
  527. */
  528. /** @defgroup TIM_ClearInput_Prescaler TIM Clear Input Prescaler
  529. * @{
  530. */
  531. #define TIM_CLEARINPUTPRESCALER_DIV1 TIM_ETRPRESCALER_DIV1 /*!< No prescaler is used */
  532. #define TIM_CLEARINPUTPRESCALER_DIV2 TIM_ETRPRESCALER_DIV2 /*!< Prescaler for External ETR pin: Capture performed once every 2 events. */
  533. #define TIM_CLEARINPUTPRESCALER_DIV4 TIM_ETRPRESCALER_DIV4 /*!< Prescaler for External ETR pin: Capture performed once every 4 events. */
  534. #define TIM_CLEARINPUTPRESCALER_DIV8 TIM_ETRPRESCALER_DIV8 /*!< Prescaler for External ETR pin: Capture performed once every 8 events. */
  535. /**
  536. * @}
  537. */
  538. /** @defgroup TIM_OSSR_Off_State_Selection_for_Run_mode_state TIM OSSR OffState Selection for Run mode state
  539. * @{
  540. */
  541. #define TIM_OSSR_ENABLE (TIM_BDTR_OSSR)
  542. #define TIM_OSSR_DISABLE ((uint32_t)0x0000U)
  543. /**
  544. * @}
  545. */
  546. /** @defgroup TIM_OSSI_Off_State_Selection_for_Idle_mode_state TIM OSSI OffState Selection for Idle mode state
  547. * @{
  548. */
  549. #define TIM_OSSI_ENABLE (TIM_BDTR_OSSI)
  550. #define TIM_OSSI_DISABLE ((uint32_t)0x0000U)
  551. /**
  552. * @}
  553. */
  554. /** @defgroup TIM_Lock_level TIM Lock level
  555. * @{
  556. */
  557. #define TIM_LOCKLEVEL_OFF ((uint32_t)0x0000U)
  558. #define TIM_LOCKLEVEL_1 (TIM_BDTR_LOCK_0)
  559. #define TIM_LOCKLEVEL_2 (TIM_BDTR_LOCK_1)
  560. #define TIM_LOCKLEVEL_3 (TIM_BDTR_LOCK)
  561. /**
  562. * @}
  563. */
  564. /** @defgroup TIM_Break_Input_enable_disable TIM Break Input State
  565. * @{
  566. */
  567. #define TIM_BREAK_ENABLE (TIM_BDTR_BKE)
  568. #define TIM_BREAK_DISABLE ((uint32_t)0x0000U)
  569. /**
  570. * @}
  571. */
  572. /** @defgroup TIM_Break_Polarity TIM Break Polarity
  573. * @{
  574. */
  575. #define TIM_BREAKPOLARITY_LOW ((uint32_t)0x0000U)
  576. #define TIM_BREAKPOLARITY_HIGH (TIM_BDTR_BKP)
  577. /**
  578. * @}
  579. */
  580. /** @defgroup TIM_AOE_Bit_Set_Reset TIM AOE Bit State
  581. * @{
  582. */
  583. #define TIM_AUTOMATICOUTPUT_ENABLE (TIM_BDTR_AOE)
  584. #define TIM_AUTOMATICOUTPUT_DISABLE ((uint32_t)0x0000U)
  585. /**
  586. * @}
  587. */
  588. /** @defgroup TIM_Master_Mode_Selection TIM Master Mode Selection
  589. * @{
  590. */
  591. #define TIM_TRGO_RESET ((uint32_t)0x0000U)
  592. #define TIM_TRGO_ENABLE (TIM_CR2_MMS_0)
  593. #define TIM_TRGO_UPDATE (TIM_CR2_MMS_1)
  594. #define TIM_TRGO_OC1 ((TIM_CR2_MMS_1 | TIM_CR2_MMS_0))
  595. #define TIM_TRGO_OC1REF (TIM_CR2_MMS_2)
  596. #define TIM_TRGO_OC2REF ((TIM_CR2_MMS_2 | TIM_CR2_MMS_0))
  597. #define TIM_TRGO_OC3REF ((TIM_CR2_MMS_2 | TIM_CR2_MMS_1))
  598. #define TIM_TRGO_OC4REF ((TIM_CR2_MMS_2 | TIM_CR2_MMS_1 | TIM_CR2_MMS_0))
  599. /**
  600. * @}
  601. */
  602. /** @defgroup TIM_Master_Slave_Mode TIM Master Slave Mode
  603. * @{
  604. */
  605. #define TIM_MASTERSLAVEMODE_ENABLE ((uint32_t)0x0080)
  606. #define TIM_MASTERSLAVEMODE_DISABLE ((uint32_t)0x0000U)
  607. /**
  608. * @}
  609. */
  610. /** @defgroup TIM_Trigger_Selection TIM Trigger Selection
  611. * @{
  612. */
  613. #define TIM_TS_ITR0 ((uint32_t)0x0000U)
  614. #define TIM_TS_ITR1 ((uint32_t)0x0010U)
  615. #define TIM_TS_ITR2 ((uint32_t)0x0020U)
  616. #define TIM_TS_ITR3 ((uint32_t)0x0030U)
  617. #define TIM_TS_TI1F_ED ((uint32_t)0x0040U)
  618. #define TIM_TS_TI1FP1 ((uint32_t)0x0050U)
  619. #define TIM_TS_TI2FP2 ((uint32_t)0x0060U)
  620. #define TIM_TS_ETRF ((uint32_t)0x0070U)
  621. #define TIM_TS_NONE ((uint32_t)0xFFFFU)
  622. /**
  623. * @}
  624. */
  625. /** @defgroup TIM_Trigger_Polarity TIM Trigger Polarity
  626. * @{
  627. */
  628. #define TIM_TRIGGERPOLARITY_INVERTED TIM_ETRPOLARITY_INVERTED /*!< Polarity for ETRx trigger sources */
  629. #define TIM_TRIGGERPOLARITY_NONINVERTED TIM_ETRPOLARITY_NONINVERTED /*!< Polarity for ETRx trigger sources */
  630. #define TIM_TRIGGERPOLARITY_RISING TIM_INPUTCHANNELPOLARITY_RISING /*!< Polarity for TIxFPx or TI1_ED trigger sources */
  631. #define TIM_TRIGGERPOLARITY_FALLING TIM_INPUTCHANNELPOLARITY_FALLING /*!< Polarity for TIxFPx or TI1_ED trigger sources */
  632. #define TIM_TRIGGERPOLARITY_BOTHEDGE TIM_INPUTCHANNELPOLARITY_BOTHEDGE /*!< Polarity for TIxFPx or TI1_ED trigger sources */
  633. /**
  634. * @}
  635. */
  636. /** @defgroup TIM_Trigger_Prescaler TIM Trigger Prescaler
  637. * @{
  638. */
  639. #define TIM_TRIGGERPRESCALER_DIV1 TIM_ETRPRESCALER_DIV1 /*!< No prescaler is used */
  640. #define TIM_TRIGGERPRESCALER_DIV2 TIM_ETRPRESCALER_DIV2 /*!< Prescaler for External ETR Trigger: Capture performed once every 2 events. */
  641. #define TIM_TRIGGERPRESCALER_DIV4 TIM_ETRPRESCALER_DIV4 /*!< Prescaler for External ETR Trigger: Capture performed once every 4 events. */
  642. #define TIM_TRIGGERPRESCALER_DIV8 TIM_ETRPRESCALER_DIV8 /*!< Prescaler for External ETR Trigger: Capture performed once every 8 events. */
  643. /**
  644. * @}
  645. */
  646. /** @defgroup TIM_TI1_Selection TIM TI1 Selection
  647. * @{
  648. */
  649. #define TIM_TI1SELECTION_CH1 ((uint32_t)0x0000U)
  650. #define TIM_TI1SELECTION_XORCOMBINATION (TIM_CR2_TI1S)
  651. /**
  652. * @}
  653. */
  654. /** @defgroup TIM_DMA_Base_address TIM DMA Base address
  655. * @{
  656. */
  657. #define TIM_DMABASE_CR1 (0x00000000U)
  658. #define TIM_DMABASE_CR2 (0x00000001U)
  659. #define TIM_DMABASE_SMCR (0x00000002U)
  660. #define TIM_DMABASE_DIER (0x00000003U)
  661. #define TIM_DMABASE_SR (0x00000004U)
  662. #define TIM_DMABASE_EGR (0x00000005U)
  663. #define TIM_DMABASE_CCMR1 (0x00000006U)
  664. #define TIM_DMABASE_CCMR2 (0x00000007U)
  665. #define TIM_DMABASE_CCER (0x00000008U)
  666. #define TIM_DMABASE_CNT (0x00000009U)
  667. #define TIM_DMABASE_PSC (0x0000000AU)
  668. #define TIM_DMABASE_ARR (0x0000000BU)
  669. #define TIM_DMABASE_RCR (0x0000000CU)
  670. #define TIM_DMABASE_CCR1 (0x0000000DU)
  671. #define TIM_DMABASE_CCR2 (0x0000000EU)
  672. #define TIM_DMABASE_CCR3 (0x0000000FU)
  673. #define TIM_DMABASE_CCR4 (0x00000010U)
  674. #define TIM_DMABASE_BDTR (0x00000011U)
  675. #define TIM_DMABASE_DCR (0x00000012U)
  676. #define TIM_DMABASE_OR (0x00000013U)
  677. /**
  678. * @}
  679. */
  680. /** @defgroup TIM_DMA_Burst_Length TIM DMA Burst Length
  681. * @{
  682. */
  683. #define TIM_DMABURSTLENGTH_1TRANSFER (0x00000000U)
  684. #define TIM_DMABURSTLENGTH_2TRANSFERS (0x00000100U)
  685. #define TIM_DMABURSTLENGTH_3TRANSFERS (0x00000200U)
  686. #define TIM_DMABURSTLENGTH_4TRANSFERS (0x00000300U)
  687. #define TIM_DMABURSTLENGTH_5TRANSFERS (0x00000400U)
  688. #define TIM_DMABURSTLENGTH_6TRANSFERS (0x00000500U)
  689. #define TIM_DMABURSTLENGTH_7TRANSFERS (0x00000600U)
  690. #define TIM_DMABURSTLENGTH_8TRANSFERS (0x00000700U)
  691. #define TIM_DMABURSTLENGTH_9TRANSFERS (0x00000800U)
  692. #define TIM_DMABURSTLENGTH_10TRANSFERS (0x00000900U)
  693. #define TIM_DMABURSTLENGTH_11TRANSFERS (0x00000A00U)
  694. #define TIM_DMABURSTLENGTH_12TRANSFERS (0x00000B00U)
  695. #define TIM_DMABURSTLENGTH_13TRANSFERS (0x00000C00U)
  696. #define TIM_DMABURSTLENGTH_14TRANSFERS (0x00000D00U)
  697. #define TIM_DMABURSTLENGTH_15TRANSFERS (0x00000E00U)
  698. #define TIM_DMABURSTLENGTH_16TRANSFERS (0x00000F00U)
  699. #define TIM_DMABURSTLENGTH_17TRANSFERS (0x00001000U)
  700. #define TIM_DMABURSTLENGTH_18TRANSFERS (0x00001100U)
  701. /**
  702. * @}
  703. */
  704. /** @defgroup DMA_Handle_index DMA Handle index
  705. * @{
  706. */
  707. #define TIM_DMA_ID_UPDATE ((uint16_t) 0x0U) /*!< Index of the DMA handle used for Update DMA requests */
  708. #define TIM_DMA_ID_CC1 ((uint16_t) 0x1U) /*!< Index of the DMA handle used for Capture/Compare 1 DMA requests */
  709. #define TIM_DMA_ID_CC2 ((uint16_t) 0x2U) /*!< Index of the DMA handle used for Capture/Compare 2 DMA requests */
  710. #define TIM_DMA_ID_CC3 ((uint16_t) 0x3U) /*!< Index of the DMA handle used for Capture/Compare 3 DMA requests */
  711. #define TIM_DMA_ID_CC4 ((uint16_t) 0x4U) /*!< Index of the DMA handle used for Capture/Compare 4 DMA requests */
  712. #define TIM_DMA_ID_COMMUTATION ((uint16_t) 0x5U) /*!< Index of the DMA handle used for Commutation DMA requests */
  713. #define TIM_DMA_ID_TRIGGER ((uint16_t) 0x6U) /*!< Index of the DMA handle used for Trigger DMA requests */
  714. /**
  715. * @}
  716. */
  717. /** @defgroup Channel_CC_State Channel CC State
  718. * @{
  719. */
  720. #define TIM_CCx_ENABLE ((uint32_t)0x0001U)
  721. #define TIM_CCx_DISABLE ((uint32_t)0x0000U)
  722. #define TIM_CCxN_ENABLE ((uint32_t)0x0004U)
  723. #define TIM_CCxN_DISABLE ((uint32_t)0x0000U)
  724. /**
  725. * @}
  726. */
  727. /**
  728. * @}
  729. */
  730. /* Exported macro ------------------------------------------------------------*/
  731. /** @defgroup TIM_Exported_Macros TIM Exported Macros
  732. * @{
  733. */
  734. /** @brief Reset TIM handle state
  735. * @param __HANDLE__: TIM handle
  736. * @retval None
  737. */
  738. #define __HAL_TIM_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_TIM_STATE_RESET)
  739. /**
  740. * @brief Enable the TIM peripheral.
  741. * @param __HANDLE__: TIM handle
  742. * @retval None
  743. */
  744. #define __HAL_TIM_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1|=(TIM_CR1_CEN))
  745. /**
  746. * @brief Enable the TIM update source request.
  747. * @param __HANDLE__: TIM handle
  748. * @retval None
  749. */
  750. #define __HAL_TIM_URS_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1|=(TIM_CR1_URS))
  751. /**
  752. * @brief Enable the TIM main Output.
  753. * @param __HANDLE__: TIM handle
  754. * @retval None
  755. */
  756. #define __HAL_TIM_MOE_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->BDTR|=(TIM_BDTR_MOE))
  757. /* The counter of a timer instance is disabled only if all the CCx and CCxN
  758. channels have been disabled */
  759. #define TIM_CCER_CCxE_MASK ((uint32_t)(TIM_CCER_CC1E | TIM_CCER_CC2E | TIM_CCER_CC3E | TIM_CCER_CC4E))
  760. #define TIM_CCER_CCxNE_MASK ((uint32_t)(TIM_CCER_CC1NE | TIM_CCER_CC2NE | TIM_CCER_CC3NE))
  761. /**
  762. * @brief Disable the TIM peripheral.
  763. * @param __HANDLE__: TIM handle
  764. * @retval None
  765. */
  766. #define __HAL_TIM_DISABLE(__HANDLE__) \
  767. do { \
  768. if (((__HANDLE__)->Instance->CCER & TIM_CCER_CCxE_MASK) == 0) \
  769. { \
  770. if(((__HANDLE__)->Instance->CCER & TIM_CCER_CCxNE_MASK) == 0) \
  771. { \
  772. (__HANDLE__)->Instance->CR1 &= ~(TIM_CR1_CEN); \
  773. } \
  774. } \
  775. } while(0)
  776. /**
  777. * @brief Disable the TIM update source request.
  778. * @param __HANDLE__: TIM handle
  779. * @retval None
  780. */
  781. #define __HAL_TIM_URS_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1&=~(TIM_CR1_URS))
  782. /* The Main Output of a timer instance is disabled only if all the CCx and CCxN
  783. channels have been disabled */
  784. /**
  785. * @brief Disable the TIM main Output.
  786. * @param __HANDLE__: TIM handle
  787. * @retval None
  788. */
  789. #define __HAL_TIM_MOE_DISABLE(__HANDLE__) \
  790. do { \
  791. if (((__HANDLE__)->Instance->CCER & TIM_CCER_CCxE_MASK) == 0) \
  792. { \
  793. if(((__HANDLE__)->Instance->CCER & TIM_CCER_CCxNE_MASK) == 0) \
  794. { \
  795. (__HANDLE__)->Instance->BDTR &= ~(TIM_BDTR_MOE); \
  796. } \
  797. } \
  798. } while(0)
  799. #define __HAL_TIM_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->DIER |= (__INTERRUPT__))
  800. #define __HAL_TIM_ENABLE_DMA(__HANDLE__, __DMA__) ((__HANDLE__)->Instance->DIER |= (__DMA__))
  801. #define __HAL_TIM_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->DIER &= ~(__INTERRUPT__))
  802. #define __HAL_TIM_DISABLE_DMA(__HANDLE__, __DMA__) ((__HANDLE__)->Instance->DIER &= ~(__DMA__))
  803. #define __HAL_TIM_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->SR &(__FLAG__)) == (__FLAG__))
  804. #define __HAL_TIM_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->SR = ~(__FLAG__))
  805. #define __HAL_TIM_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->DIER & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
  806. #define __HAL_TIM_CLEAR_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->SR = ~(__INTERRUPT__))
  807. #define __HAL_TIM_IS_TIM_COUNTING_DOWN(__HANDLE__) (((__HANDLE__)->Instance->CR1 &(TIM_CR1_DIR)) == (TIM_CR1_DIR))
  808. #define __HAL_TIM_SET_PRESCALER (__HANDLE__, __PRESC__) ((__HANDLE__)->Instance->PSC = (__PRESC__))
  809. #define TIM_SET_ICPRESCALERVALUE(__HANDLE__, __CHANNEL__, __ICPSC__) \
  810. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 |= (__ICPSC__)) :\
  811. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 |= ((__ICPSC__) << 8)) :\
  812. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 |= (__ICPSC__)) :\
  813. ((__HANDLE__)->Instance->CCMR2 |= ((__ICPSC__) << 8)))
  814. #define TIM_RESET_ICPRESCALERVALUE(__HANDLE__, __CHANNEL__) \
  815. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 &= (uint16_t)~TIM_CCMR1_IC1PSC) :\
  816. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 &= (uint16_t)~TIM_CCMR1_IC2PSC) :\
  817. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 &= (uint16_t)~TIM_CCMR2_IC3PSC) :\
  818. ((__HANDLE__)->Instance->CCMR2 &= (uint16_t)~TIM_CCMR2_IC4PSC))
  819. #define TIM_SET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__, __POLARITY__) \
  820. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCER |= (__POLARITY__)) :\
  821. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCER |= ((__POLARITY__) << 4)) :\
  822. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCER |= ((__POLARITY__) << 8)) :\
  823. ((__HANDLE__)->Instance->CCER |= (((__POLARITY__) << 12) & TIM_CCER_CC4P)))
  824. #define TIM_RESET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__) \
  825. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCER &= (uint16_t)~(TIM_CCER_CC1P | TIM_CCER_CC1NP)) :\
  826. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCER &= (uint16_t)~(TIM_CCER_CC2P | TIM_CCER_CC2NP)) :\
  827. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCER &= (uint16_t)~(TIM_CCER_CC3P | TIM_CCER_CC3NP)) :\
  828. ((__HANDLE__)->Instance->CCER &= (uint16_t)~TIM_CCER_CC4P))
  829. /**
  830. * @brief Sets the TIM Counter Register value on runtime.
  831. * @param __HANDLE__: TIM handle.
  832. * @param __COUNTER__: specifies the Counter register new value.
  833. * @retval None
  834. */
  835. #define __HAL_TIM_SET_COUNTER(__HANDLE__, __COUNTER__) ((__HANDLE__)->Instance->CNT = (__COUNTER__))
  836. /**
  837. * @brief Gets the TIM Counter Register value on runtime.
  838. * @param __HANDLE__: TIM handle.
  839. * @retval None
  840. */
  841. #define __HAL_TIM_GET_COUNTER(__HANDLE__) ((__HANDLE__)->Instance->CNT)
  842. /**
  843. * @brief Sets the TIM Autoreload Register value on runtime without calling
  844. * another time any Init function.
  845. * @param __HANDLE__: TIM handle.
  846. * @param __AUTORELOAD__: specifies the Counter register new value.
  847. * @retval None
  848. */
  849. #define __HAL_TIM_SET_AUTORELOAD(__HANDLE__, __AUTORELOAD__) \
  850. do{ \
  851. (__HANDLE__)->Instance->ARR = (__AUTORELOAD__); \
  852. (__HANDLE__)->Init.Period = (__AUTORELOAD__); \
  853. } while(0)
  854. /**
  855. * @brief Gets the TIM Autoreload Register value on runtime
  856. * @param __HANDLE__: TIM handle.
  857. * @retval None
  858. */
  859. #define __HAL_TIM_GET_AUTORELOAD(__HANDLE__) ((__HANDLE__)->Instance->ARR)
  860. /**
  861. * @brief Sets the TIM Clock Division value on runtime without calling
  862. * another time any Init function.
  863. * @param __HANDLE__: TIM handle.
  864. * @param __CKD__: specifies the clock division value.
  865. * This parameter can be one of the following value:
  866. * @arg TIM_CLOCKDIVISION_DIV1
  867. * @arg TIM_CLOCKDIVISION_DIV2
  868. * @arg TIM_CLOCKDIVISION_DIV4
  869. * @retval None
  870. */
  871. #define __HAL_TIM_SET_CLOCKDIVISION(__HANDLE__, __CKD__) \
  872. do{ \
  873. (__HANDLE__)->Instance->CR1 &= (uint16_t)(~TIM_CR1_CKD); \
  874. (__HANDLE__)->Instance->CR1 |= (__CKD__); \
  875. (__HANDLE__)->Init.ClockDivision = (__CKD__); \
  876. } while(0)
  877. /**
  878. * @brief Gets the TIM Clock Division value on runtime
  879. * @param __HANDLE__: TIM handle.
  880. * @retval None
  881. */
  882. #define __HAL_TIM_GET_CLOCKDIVISION(__HANDLE__) ((__HANDLE__)->Instance->CR1 & TIM_CR1_CKD)
  883. /**
  884. * @brief Sets the TIM Input Capture prescaler on runtime without calling
  885. * another time HAL_TIM_IC_ConfigChannel() function.
  886. * @param __HANDLE__: TIM handle.
  887. * @param __CHANNEL__ : TIM Channels to be configured.
  888. * This parameter can be one of the following values:
  889. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  890. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  891. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  892. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  893. * @param __ICPSC__: specifies the Input Capture4 prescaler new value.
  894. * This parameter can be one of the following values:
  895. * @arg TIM_ICPSC_DIV1: no prescaler
  896. * @arg TIM_ICPSC_DIV2: capture is done once every 2 events
  897. * @arg TIM_ICPSC_DIV4: capture is done once every 4 events
  898. * @arg TIM_ICPSC_DIV8: capture is done once every 8 events
  899. * @retval None
  900. */
  901. #define __HAL_TIM_SET_ICPRESCALER(__HANDLE__, __CHANNEL__, __ICPSC__) \
  902. do{ \
  903. TIM_RESET_ICPRESCALERVALUE((__HANDLE__), (__CHANNEL__)); \
  904. TIM_SET_ICPRESCALERVALUE((__HANDLE__), (__CHANNEL__), (__ICPSC__)); \
  905. } while(0)
  906. /**
  907. * @brief Gets the TIM Input Capture prescaler on runtime
  908. * @param __HANDLE__: TIM handle.
  909. * @param __CHANNEL__ : TIM Channels to be configured.
  910. * This parameter can be one of the following values:
  911. * @arg TIM_CHANNEL_1: get input capture 1 prescaler value
  912. * @arg TIM_CHANNEL_2: get input capture 2 prescaler value
  913. * @arg TIM_CHANNEL_3: get input capture 3 prescaler value
  914. * @arg TIM_CHANNEL_4: get input capture 4 prescaler value
  915. * @retval None
  916. */
  917. #define __HAL_TIM_GET_ICPRESCALER(__HANDLE__, __CHANNEL__) \
  918. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 & TIM_CCMR1_IC1PSC) :\
  919. ((__CHANNEL__) == TIM_CHANNEL_2) ? (((__HANDLE__)->Instance->CCMR1 & TIM_CCMR1_IC2PSC) >> 8) :\
  920. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 & TIM_CCMR2_IC3PSC) :\
  921. (((__HANDLE__)->Instance->CCMR2 & TIM_CCMR2_IC4PSC)) >> 8)
  922. /**
  923. * @brief Sets the TIM Capture x input polarity on runtime.
  924. * @param __HANDLE__: TIM handle.
  925. * @param __CHANNEL__: TIM Channels to be configured.
  926. * This parameter can be one of the following values:
  927. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  928. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  929. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  930. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  931. * @param __POLARITY__: Polarity for TIx source
  932. * @arg TIM_INPUTCHANNELPOLARITY_RISING: Rising Edge
  933. * @arg TIM_INPUTCHANNELPOLARITY_FALLING: Falling Edge
  934. * @arg TIM_INPUTCHANNELPOLARITY_BOTHEDGE: Rising and Falling Edge
  935. * @note The polarity TIM_INPUTCHANNELPOLARITY_BOTHEDGE is not authorized for TIM Channel 4.
  936. * @retval None
  937. */
  938. #define __HAL_TIM_SET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__, __POLARITY__) \
  939. do{ \
  940. TIM_RESET_CAPTUREPOLARITY((__HANDLE__), (__CHANNEL__)); \
  941. TIM_SET_CAPTUREPOLARITY((__HANDLE__), (__CHANNEL__), (__POLARITY__)); \
  942. }while(0)
  943. /**
  944. * @}
  945. */
  946. /* Include TIM HAL Extension module */
  947. #include "stm32f7xx_hal_tim_ex.h"
  948. /* Exported functions --------------------------------------------------------*/
  949. /** @addtogroup TIM_Exported_Functions
  950. * @{
  951. */
  952. /** @addtogroup TIM_Exported_Functions_Group1
  953. * @{
  954. */
  955. /* Time Base functions ********************************************************/
  956. HAL_StatusTypeDef HAL_TIM_Base_Init(TIM_HandleTypeDef *htim);
  957. HAL_StatusTypeDef HAL_TIM_Base_DeInit(TIM_HandleTypeDef *htim);
  958. void HAL_TIM_Base_MspInit(TIM_HandleTypeDef *htim);
  959. void HAL_TIM_Base_MspDeInit(TIM_HandleTypeDef *htim);
  960. /* Blocking mode: Polling */
  961. HAL_StatusTypeDef HAL_TIM_Base_Start(TIM_HandleTypeDef *htim);
  962. HAL_StatusTypeDef HAL_TIM_Base_Stop(TIM_HandleTypeDef *htim);
  963. /* Non-Blocking mode: Interrupt */
  964. HAL_StatusTypeDef HAL_TIM_Base_Start_IT(TIM_HandleTypeDef *htim);
  965. HAL_StatusTypeDef HAL_TIM_Base_Stop_IT(TIM_HandleTypeDef *htim);
  966. /* Non-Blocking mode: DMA */
  967. HAL_StatusTypeDef HAL_TIM_Base_Start_DMA(TIM_HandleTypeDef *htim, uint32_t *pData, uint16_t Length);
  968. HAL_StatusTypeDef HAL_TIM_Base_Stop_DMA(TIM_HandleTypeDef *htim);
  969. /**
  970. * @}
  971. */
  972. /** @addtogroup TIM_Exported_Functions_Group2
  973. * @{
  974. */
  975. /* Timer Output Compare functions **********************************************/
  976. HAL_StatusTypeDef HAL_TIM_OC_Init(TIM_HandleTypeDef *htim);
  977. HAL_StatusTypeDef HAL_TIM_OC_DeInit(TIM_HandleTypeDef *htim);
  978. void HAL_TIM_OC_MspInit(TIM_HandleTypeDef *htim);
  979. void HAL_TIM_OC_MspDeInit(TIM_HandleTypeDef *htim);
  980. /* Blocking mode: Polling */
  981. HAL_StatusTypeDef HAL_TIM_OC_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  982. HAL_StatusTypeDef HAL_TIM_OC_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  983. /* Non-Blocking mode: Interrupt */
  984. HAL_StatusTypeDef HAL_TIM_OC_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  985. HAL_StatusTypeDef HAL_TIM_OC_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  986. /* Non-Blocking mode: DMA */
  987. HAL_StatusTypeDef HAL_TIM_OC_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, uint32_t *pData, uint16_t Length);
  988. HAL_StatusTypeDef HAL_TIM_OC_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  989. /**
  990. * @}
  991. */
  992. /** @addtogroup TIM_Exported_Functions_Group3
  993. * @{
  994. */
  995. /* Timer PWM functions *********************************************************/
  996. HAL_StatusTypeDef HAL_TIM_PWM_Init(TIM_HandleTypeDef *htim);
  997. HAL_StatusTypeDef HAL_TIM_PWM_DeInit(TIM_HandleTypeDef *htim);
  998. void HAL_TIM_PWM_MspInit(TIM_HandleTypeDef *htim);
  999. void HAL_TIM_PWM_MspDeInit(TIM_HandleTypeDef *htim);
  1000. /* Blocking mode: Polling */
  1001. HAL_StatusTypeDef HAL_TIM_PWM_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  1002. HAL_StatusTypeDef HAL_TIM_PWM_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  1003. /* Non-Blocking mode: Interrupt */
  1004. HAL_StatusTypeDef HAL_TIM_PWM_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1005. HAL_StatusTypeDef HAL_TIM_PWM_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1006. /* Non-Blocking mode: DMA */
  1007. HAL_StatusTypeDef HAL_TIM_PWM_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, uint32_t *pData, uint16_t Length);
  1008. HAL_StatusTypeDef HAL_TIM_PWM_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  1009. /**
  1010. * @}
  1011. */
  1012. /** @addtogroup TIM_Exported_Functions_Group4
  1013. * @{
  1014. */
  1015. /* Timer Input Capture functions ***********************************************/
  1016. HAL_StatusTypeDef HAL_TIM_IC_Init(TIM_HandleTypeDef *htim);
  1017. HAL_StatusTypeDef HAL_TIM_IC_DeInit(TIM_HandleTypeDef *htim);
  1018. void HAL_TIM_IC_MspInit(TIM_HandleTypeDef *htim);
  1019. void HAL_TIM_IC_MspDeInit(TIM_HandleTypeDef *htim);
  1020. /* Blocking mode: Polling */
  1021. HAL_StatusTypeDef HAL_TIM_IC_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  1022. HAL_StatusTypeDef HAL_TIM_IC_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  1023. /* Non-Blocking mode: Interrupt */
  1024. HAL_StatusTypeDef HAL_TIM_IC_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1025. HAL_StatusTypeDef HAL_TIM_IC_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1026. /* Non-Blocking mode: DMA */
  1027. HAL_StatusTypeDef HAL_TIM_IC_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, uint32_t *pData, uint16_t Length);
  1028. HAL_StatusTypeDef HAL_TIM_IC_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  1029. /**
  1030. * @}
  1031. */
  1032. /** @addtogroup TIM_Exported_Functions_Group5
  1033. * @{
  1034. */
  1035. /* Timer One Pulse functions ***************************************************/
  1036. HAL_StatusTypeDef HAL_TIM_OnePulse_Init(TIM_HandleTypeDef *htim, uint32_t OnePulseMode);
  1037. HAL_StatusTypeDef HAL_TIM_OnePulse_DeInit(TIM_HandleTypeDef *htim);
  1038. void HAL_TIM_OnePulse_MspInit(TIM_HandleTypeDef *htim);
  1039. void HAL_TIM_OnePulse_MspDeInit(TIM_HandleTypeDef *htim);
  1040. /* Blocking mode: Polling */
  1041. HAL_StatusTypeDef HAL_TIM_OnePulse_Start(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1042. HAL_StatusTypeDef HAL_TIM_OnePulse_Stop(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1043. /* Non-Blocking mode: Interrupt */
  1044. HAL_StatusTypeDef HAL_TIM_OnePulse_Start_IT(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1045. HAL_StatusTypeDef HAL_TIM_OnePulse_Stop_IT(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1046. /**
  1047. * @}
  1048. */
  1049. /** @addtogroup TIM_Exported_Functions_Group6
  1050. * @{
  1051. */
  1052. /* Timer Encoder functions *****************************************************/
  1053. HAL_StatusTypeDef HAL_TIM_Encoder_Init(TIM_HandleTypeDef *htim, TIM_Encoder_InitTypeDef* sConfig);
  1054. HAL_StatusTypeDef HAL_TIM_Encoder_DeInit(TIM_HandleTypeDef *htim);
  1055. void HAL_TIM_Encoder_MspInit(TIM_HandleTypeDef *htim);
  1056. void HAL_TIM_Encoder_MspDeInit(TIM_HandleTypeDef *htim);
  1057. /* Blocking mode: Polling */
  1058. HAL_StatusTypeDef HAL_TIM_Encoder_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  1059. HAL_StatusTypeDef HAL_TIM_Encoder_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  1060. /* Non-Blocking mode: Interrupt */
  1061. HAL_StatusTypeDef HAL_TIM_Encoder_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1062. HAL_StatusTypeDef HAL_TIM_Encoder_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1063. /* Non-Blocking mode: DMA */
  1064. HAL_StatusTypeDef HAL_TIM_Encoder_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, uint32_t *pData1, uint32_t *pData2, uint16_t Length);
  1065. HAL_StatusTypeDef HAL_TIM_Encoder_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  1066. /**
  1067. * @}
  1068. */
  1069. /** @addtogroup TIM_Exported_Functions_Group7
  1070. * @{
  1071. */
  1072. /* Interrupt Handler functions **********************************************/
  1073. void HAL_TIM_IRQHandler(TIM_HandleTypeDef *htim);
  1074. /**
  1075. * @}
  1076. */
  1077. /** @addtogroup TIM_Exported_Functions_Group8
  1078. * @{
  1079. */
  1080. /* Control functions *********************************************************/
  1081. HAL_StatusTypeDef HAL_TIM_OC_ConfigChannel(TIM_HandleTypeDef *htim, TIM_OC_InitTypeDef* sConfig, uint32_t Channel);
  1082. HAL_StatusTypeDef HAL_TIM_PWM_ConfigChannel(TIM_HandleTypeDef *htim, TIM_OC_InitTypeDef* sConfig, uint32_t Channel);
  1083. HAL_StatusTypeDef HAL_TIM_IC_ConfigChannel(TIM_HandleTypeDef *htim, TIM_IC_InitTypeDef* sConfig, uint32_t Channel);
  1084. HAL_StatusTypeDef HAL_TIM_OnePulse_ConfigChannel(TIM_HandleTypeDef *htim, TIM_OnePulse_InitTypeDef* sConfig, uint32_t OutputChannel, uint32_t InputChannel);
  1085. HAL_StatusTypeDef HAL_TIM_ConfigOCrefClear(TIM_HandleTypeDef *htim, TIM_ClearInputConfigTypeDef * sClearInputConfig, uint32_t Channel);
  1086. HAL_StatusTypeDef HAL_TIM_ConfigClockSource(TIM_HandleTypeDef *htim, TIM_ClockConfigTypeDef * sClockSourceConfig);
  1087. HAL_StatusTypeDef HAL_TIM_ConfigTI1Input(TIM_HandleTypeDef *htim, uint32_t TI1_Selection);
  1088. HAL_StatusTypeDef HAL_TIM_SlaveConfigSynchronization(TIM_HandleTypeDef *htim, TIM_SlaveConfigTypeDef * sSlaveConfig);
  1089. HAL_StatusTypeDef HAL_TIM_SlaveConfigSynchronization_IT(TIM_HandleTypeDef *htim, TIM_SlaveConfigTypeDef * sSlaveConfig);
  1090. HAL_StatusTypeDef HAL_TIM_DMABurst_WriteStart(TIM_HandleTypeDef *htim, uint32_t BurstBaseAddress, uint32_t BurstRequestSrc, \
  1091. uint32_t *BurstBuffer, uint32_t BurstLength);
  1092. HAL_StatusTypeDef HAL_TIM_DMABurst_WriteStop(TIM_HandleTypeDef *htim, uint32_t BurstRequestSrc);
  1093. HAL_StatusTypeDef HAL_TIM_DMABurst_ReadStart(TIM_HandleTypeDef *htim, uint32_t BurstBaseAddress, uint32_t BurstRequestSrc, \
  1094. uint32_t *BurstBuffer, uint32_t BurstLength);
  1095. HAL_StatusTypeDef HAL_TIM_DMABurst_ReadStop(TIM_HandleTypeDef *htim, uint32_t BurstRequestSrc);
  1096. HAL_StatusTypeDef HAL_TIM_GenerateEvent(TIM_HandleTypeDef *htim, uint32_t EventSource);
  1097. uint32_t HAL_TIM_ReadCapturedValue(TIM_HandleTypeDef *htim, uint32_t Channel);
  1098. /**
  1099. * @}
  1100. */
  1101. /** @addtogroup TIM_Exported_Functions_Group9
  1102. * @{
  1103. */
  1104. /* Callback in non blocking modes (Interrupt and DMA) *************************/
  1105. void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim);
  1106. void HAL_TIM_OC_DelayElapsedCallback(TIM_HandleTypeDef *htim);
  1107. void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim);
  1108. void HAL_TIM_PWM_PulseFinishedCallback(TIM_HandleTypeDef *htim);
  1109. void HAL_TIM_TriggerCallback(TIM_HandleTypeDef *htim);
  1110. void HAL_TIM_ErrorCallback(TIM_HandleTypeDef *htim);
  1111. /**
  1112. * @}
  1113. */
  1114. /** @addtogroup TIM_Exported_Functions_Group10
  1115. * @{
  1116. */
  1117. /* Peripheral State functions **************************************************/
  1118. HAL_TIM_StateTypeDef HAL_TIM_Base_GetState(TIM_HandleTypeDef *htim);
  1119. HAL_TIM_StateTypeDef HAL_TIM_OC_GetState(TIM_HandleTypeDef *htim);
  1120. HAL_TIM_StateTypeDef HAL_TIM_PWM_GetState(TIM_HandleTypeDef *htim);
  1121. HAL_TIM_StateTypeDef HAL_TIM_IC_GetState(TIM_HandleTypeDef *htim);
  1122. HAL_TIM_StateTypeDef HAL_TIM_OnePulse_GetState(TIM_HandleTypeDef *htim);
  1123. HAL_TIM_StateTypeDef HAL_TIM_Encoder_GetState(TIM_HandleTypeDef *htim);
  1124. /**
  1125. * @}
  1126. */
  1127. /**
  1128. * @}
  1129. */
  1130. /* Private macros ------------------------------------------------------------*/
  1131. /** @defgroup TIM_Private_Macros TIM Private Macros
  1132. * @{
  1133. */
  1134. /** @defgroup TIM_IS_TIM_Definitions TIM Private macros to check input parameters
  1135. * @{
  1136. */
  1137. #define IS_TIM_COUNTER_MODE(__MODE__) (((__MODE__) == TIM_COUNTERMODE_UP) || \
  1138. ((__MODE__) == TIM_COUNTERMODE_DOWN) || \
  1139. ((__MODE__) == TIM_COUNTERMODE_CENTERALIGNED1) || \
  1140. ((__MODE__) == TIM_COUNTERMODE_CENTERALIGNED2) || \
  1141. ((__MODE__) == TIM_COUNTERMODE_CENTERALIGNED3))
  1142. #define IS_TIM_CLOCKDIVISION_DIV(__DIV__) (((__DIV__) == TIM_CLOCKDIVISION_DIV1) || \
  1143. ((__DIV__) == TIM_CLOCKDIVISION_DIV2) || \
  1144. ((__DIV__) == TIM_CLOCKDIVISION_DIV4))
  1145. #define IS_TIM_AUTORELOAD_PRELOAD(PRELOAD) (((PRELOAD) == TIM_AUTORELOAD_PRELOAD_DISABLE) || \
  1146. ((PRELOAD) == TIM_AUTORELOAD_PRELOAD_ENABLE))
  1147. #define IS_TIM_FAST_STATE(__STATE__) (((__STATE__) == TIM_OCFAST_DISABLE) || \
  1148. ((__STATE__) == TIM_OCFAST_ENABLE))
  1149. #define IS_TIM_OUTPUT_STATE(STATE) (((STATE) == TIM_OUTPUTSTATE_DISABLE) || \
  1150. ((STATE) == TIM_OUTPUTSTATE_ENABLE))
  1151. #define IS_TIM_OUTPUTN_STATE(STATE) (((STATE) == TIM_OUTPUTNSTATE_DISABLE) || \
  1152. ((STATE) == TIM_OUTPUTNSTATE_ENABLE))
  1153. #define IS_TIM_OC_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_OCPOLARITY_HIGH) || \
  1154. ((__POLARITY__) == TIM_OCPOLARITY_LOW))
  1155. #define IS_TIM_OCN_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_OCNPOLARITY_HIGH) || \
  1156. ((__POLARITY__) == TIM_OCNPOLARITY_LOW))
  1157. #define IS_TIM_OCIDLE_STATE(__STATE__) (((__STATE__) == TIM_OCIDLESTATE_SET) || \
  1158. ((__STATE__) == TIM_OCIDLESTATE_RESET))
  1159. #define IS_TIM_OCNIDLE_STATE(__STATE__) (((__STATE__) == TIM_OCNIDLESTATE_SET) || \
  1160. ((__STATE__) == TIM_OCNIDLESTATE_RESET))
  1161. #define IS_TIM_IC_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_ICPOLARITY_RISING) || \
  1162. ((__POLARITY__) == TIM_ICPOLARITY_FALLING) || \
  1163. ((__POLARITY__) == TIM_ICPOLARITY_BOTHEDGE))
  1164. #define IS_TIM_IC_SELECTION(__SELECTION__) (((__SELECTION__) == TIM_ICSELECTION_DIRECTTI) || \
  1165. ((__SELECTION__) == TIM_ICSELECTION_INDIRECTTI) || \
  1166. ((__SELECTION__) == TIM_ICSELECTION_TRC))
  1167. #define IS_TIM_IC_PRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_ICPSC_DIV1) || \
  1168. ((__PRESCALER__) == TIM_ICPSC_DIV2) || \
  1169. ((__PRESCALER__) == TIM_ICPSC_DIV4) || \
  1170. ((__PRESCALER__) == TIM_ICPSC_DIV8))
  1171. #define IS_TIM_OPM_MODE(__MODE__) (((__MODE__) == TIM_OPMODE_SINGLE) || \
  1172. ((__MODE__) == TIM_OPMODE_REPETITIVE))
  1173. #define IS_TIM_ENCODER_MODE(__MODE__) (((__MODE__) == TIM_ENCODERMODE_TI1) || \
  1174. ((__MODE__) == TIM_ENCODERMODE_TI2) || \
  1175. ((__MODE__) == TIM_ENCODERMODE_TI12))
  1176. #define IS_TIM_IT(__IT__) ((((__IT__) & 0xFFFFFF00U) == 0x00000000U) && ((__IT__) != 0x00000000U))
  1177. #define IS_TIM_GET_IT(__IT__) (((__IT__) == TIM_IT_UPDATE) || \
  1178. ((__IT__) == TIM_IT_CC1) || \
  1179. ((__IT__) == TIM_IT_CC2) || \
  1180. ((__IT__) == TIM_IT_CC3) || \
  1181. ((__IT__) == TIM_IT_CC4) || \
  1182. ((__IT__) == TIM_IT_COM) || \
  1183. ((__IT__) == TIM_IT_TRIGGER) || \
  1184. ((__IT__) == TIM_IT_BREAK))
  1185. #define IS_TIM_DMA_SOURCE(__SOURCE__) ((((__SOURCE__) & 0xFFFF80FFU) == 0x00000000U) && ((__SOURCE__) != 0x00000000U))
  1186. #define IS_TIM_EVENT_SOURCE(__SOURCE__) ((((__SOURCE__) & 0xFFFFFE00U) == 0x00000000U) && ((__SOURCE__) != 0x00000000U))
  1187. #define IS_TIM_FLAG(__FLAG__) (((__FLAG__) == TIM_FLAG_UPDATE) || \
  1188. ((__FLAG__) == TIM_FLAG_CC1) || \
  1189. ((__FLAG__) == TIM_FLAG_CC2) || \
  1190. ((__FLAG__) == TIM_FLAG_CC3) || \
  1191. ((__FLAG__) == TIM_FLAG_CC4) || \
  1192. ((__FLAG__) == TIM_FLAG_COM) || \
  1193. ((__FLAG__) == TIM_FLAG_TRIGGER) || \
  1194. ((__FLAG__) == TIM_FLAG_BREAK) || \
  1195. ((__FLAG__) == TIM_FLAG_BREAK2) || \
  1196. ((__FLAG__) == TIM_FLAG_CC1OF) || \
  1197. ((__FLAG__) == TIM_FLAG_CC2OF) || \
  1198. ((__FLAG__) == TIM_FLAG_CC3OF) || \
  1199. ((__FLAG__) == TIM_FLAG_CC4OF))
  1200. #define IS_TIM_CLOCKSOURCE(__CLOCK__) (((__CLOCK__) == TIM_CLOCKSOURCE_INTERNAL) || \
  1201. ((__CLOCK__) == TIM_CLOCKSOURCE_ETRMODE2) || \
  1202. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR0) || \
  1203. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR1) || \
  1204. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR2) || \
  1205. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR3) || \
  1206. ((__CLOCK__) == TIM_CLOCKSOURCE_TI1ED) || \
  1207. ((__CLOCK__) == TIM_CLOCKSOURCE_TI1) || \
  1208. ((__CLOCK__) == TIM_CLOCKSOURCE_TI2) || \
  1209. ((__CLOCK__) == TIM_CLOCKSOURCE_ETRMODE1))
  1210. #define IS_TIM_CLOCKPOLARITY(__POLARITY__) (((__POLARITY__) == TIM_CLOCKPOLARITY_INVERTED) || \
  1211. ((__POLARITY__) == TIM_CLOCKPOLARITY_NONINVERTED) || \
  1212. ((__POLARITY__) == TIM_CLOCKPOLARITY_RISING) || \
  1213. ((__POLARITY__) == TIM_CLOCKPOLARITY_FALLING) || \
  1214. ((__POLARITY__) == TIM_CLOCKPOLARITY_BOTHEDGE))
  1215. #define IS_TIM_CLOCKPRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV1) || \
  1216. ((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV2) || \
  1217. ((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV4) || \
  1218. ((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV8))
  1219. #define IS_TIM_CLOCKFILTER(__ICFILTER__) ((__ICFILTER__) <= 0xF)
  1220. #define IS_TIM_CLEARINPUT_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_CLEARINPUTPOLARITY_INVERTED) || \
  1221. ((__POLARITY__) == TIM_CLEARINPUTPOLARITY_NONINVERTED))
  1222. #define IS_TIM_CLEARINPUT_PRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV1) || \
  1223. ((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV2) || \
  1224. ((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV4) || \
  1225. ((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV8))
  1226. #define IS_TIM_CLEARINPUT_FILTER(__ICFILTER__) ((__ICFILTER__) <= 0xF)
  1227. #define IS_TIM_OSSR_STATE(__STATE__) (((__STATE__) == TIM_OSSR_ENABLE) || \
  1228. ((__STATE__) == TIM_OSSR_DISABLE))
  1229. #define IS_TIM_OSSI_STATE(__STATE__) (((__STATE__) == TIM_OSSI_ENABLE) || \
  1230. ((__STATE__) == TIM_OSSI_DISABLE))
  1231. #define IS_TIM_LOCK_LEVEL(__LEVEL__) (((__LEVEL__) == TIM_LOCKLEVEL_OFF) || \
  1232. ((__LEVEL__) == TIM_LOCKLEVEL_1) || \
  1233. ((__LEVEL__) == TIM_LOCKLEVEL_2) || \
  1234. ((__LEVEL__) == TIM_LOCKLEVEL_3))
  1235. #define IS_TIM_BREAK_STATE(__STATE__) (((__STATE__) == TIM_BREAK_ENABLE) || \
  1236. ((__STATE__) == TIM_BREAK_DISABLE))
  1237. #define IS_TIM_BREAK_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_BREAKPOLARITY_LOW) || \
  1238. ((__POLARITY__) == TIM_BREAKPOLARITY_HIGH))
  1239. #define IS_TIM_AUTOMATIC_OUTPUT_STATE(__STATE__) (((__STATE__) == TIM_AUTOMATICOUTPUT_ENABLE) || \
  1240. ((__STATE__) == TIM_AUTOMATICOUTPUT_DISABLE))
  1241. #define IS_TIM_TRGO_SOURCE(__SOURCE__) (((__SOURCE__) == TIM_TRGO_RESET) || \
  1242. ((__SOURCE__) == TIM_TRGO_ENABLE) || \
  1243. ((__SOURCE__) == TIM_TRGO_UPDATE) || \
  1244. ((__SOURCE__) == TIM_TRGO_OC1) || \
  1245. ((__SOURCE__) == TIM_TRGO_OC1REF) || \
  1246. ((__SOURCE__) == TIM_TRGO_OC2REF) || \
  1247. ((__SOURCE__) == TIM_TRGO_OC3REF) || \
  1248. ((__SOURCE__) == TIM_TRGO_OC4REF))
  1249. #define IS_TIM_MSM_STATE(__STATE__) (((__STATE__) == TIM_MASTERSLAVEMODE_ENABLE) || \
  1250. ((__STATE__) == TIM_MASTERSLAVEMODE_DISABLE))
  1251. #define IS_TIM_TRIGGER_SELECTION(__SELECTION__) (((__SELECTION__) == TIM_TS_ITR0) || \
  1252. ((__SELECTION__) == TIM_TS_ITR1) || \
  1253. ((__SELECTION__) == TIM_TS_ITR2) || \
  1254. ((__SELECTION__) == TIM_TS_ITR3) || \
  1255. ((__SELECTION__) == TIM_TS_TI1F_ED) || \
  1256. ((__SELECTION__) == TIM_TS_TI1FP1) || \
  1257. ((__SELECTION__) == TIM_TS_TI2FP2) || \
  1258. ((__SELECTION__) == TIM_TS_ETRF))
  1259. #define IS_TIM_INTERNAL_TRIGGER_SELECTION(SELECTION) (((SELECTION) == TIM_TS_ITR0) || \
  1260. ((SELECTION) == TIM_TS_ITR1) || \
  1261. ((SELECTION) == TIM_TS_ITR2) || \
  1262. ((SELECTION) == TIM_TS_ITR3))
  1263. #define IS_TIM_INTERNAL_TRIGGEREVENT_SELECTION(__SELECTION__) (((__SELECTION__) == TIM_TS_ITR0) || \
  1264. ((__SELECTION__) == TIM_TS_ITR1) || \
  1265. ((__SELECTION__) == TIM_TS_ITR2) || \
  1266. ((__SELECTION__) == TIM_TS_ITR3) || \
  1267. ((__SELECTION__) == TIM_TS_NONE))
  1268. #define IS_TIM_TRIGGERPOLARITY(__POLARITY__) (((__POLARITY__) == TIM_TRIGGERPOLARITY_INVERTED ) || \
  1269. ((__POLARITY__) == TIM_TRIGGERPOLARITY_NONINVERTED) || \
  1270. ((__POLARITY__) == TIM_TRIGGERPOLARITY_RISING ) || \
  1271. ((__POLARITY__) == TIM_TRIGGERPOLARITY_FALLING ) || \
  1272. ((__POLARITY__) == TIM_TRIGGERPOLARITY_BOTHEDGE ))
  1273. #define IS_TIM_TRIGGERPRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV1) || \
  1274. ((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV2) || \
  1275. ((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV4) || \
  1276. ((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV8))
  1277. #define IS_TIM_TRIGGERFILTER(__ICFILTER__) ((__ICFILTER__) <= 0xF)
  1278. #define IS_TIM_TI1SELECTION(__TI1SELECTION__) (((__TI1SELECTION__) == TIM_TI1SELECTION_CH1) || \
  1279. ((__TI1SELECTION__) == TIM_TI1SELECTION_XORCOMBINATION))
  1280. #define IS_TIM_DMA_BASE(__BASE__) (((__BASE__) == TIM_DMABASE_CR1) || \
  1281. ((__BASE__) == TIM_DMABASE_CR2) || \
  1282. ((__BASE__) == TIM_DMABASE_SMCR) || \
  1283. ((__BASE__) == TIM_DMABASE_DIER) || \
  1284. ((__BASE__) == TIM_DMABASE_SR) || \
  1285. ((__BASE__) == TIM_DMABASE_EGR) || \
  1286. ((__BASE__) == TIM_DMABASE_CCMR1) || \
  1287. ((__BASE__) == TIM_DMABASE_CCMR2) || \
  1288. ((__BASE__) == TIM_DMABASE_CCER) || \
  1289. ((__BASE__) == TIM_DMABASE_CNT) || \
  1290. ((__BASE__) == TIM_DMABASE_PSC) || \
  1291. ((__BASE__) == TIM_DMABASE_ARR) || \
  1292. ((__BASE__) == TIM_DMABASE_RCR) || \
  1293. ((__BASE__) == TIM_DMABASE_CCR1) || \
  1294. ((__BASE__) == TIM_DMABASE_CCR2) || \
  1295. ((__BASE__) == TIM_DMABASE_CCR3) || \
  1296. ((__BASE__) == TIM_DMABASE_CCR4) || \
  1297. ((__BASE__) == TIM_DMABASE_BDTR) || \
  1298. ((__BASE__) == TIM_DMABASE_DCR) || \
  1299. ((__BASE__) == TIM_DMABASE_OR))
  1300. #define IS_TIM_DMA_LENGTH(__LENGTH__) (((__LENGTH__) == TIM_DMABURSTLENGTH_1TRANSFER) || \
  1301. ((__LENGTH__) == TIM_DMABURSTLENGTH_2TRANSFERS) || \
  1302. ((__LENGTH__) == TIM_DMABURSTLENGTH_3TRANSFERS) || \
  1303. ((__LENGTH__) == TIM_DMABURSTLENGTH_4TRANSFERS) || \
  1304. ((__LENGTH__) == TIM_DMABURSTLENGTH_5TRANSFERS) || \
  1305. ((__LENGTH__) == TIM_DMABURSTLENGTH_6TRANSFERS) || \
  1306. ((__LENGTH__) == TIM_DMABURSTLENGTH_7TRANSFERS) || \
  1307. ((__LENGTH__) == TIM_DMABURSTLENGTH_8TRANSFERS) || \
  1308. ((__LENGTH__) == TIM_DMABURSTLENGTH_9TRANSFERS) || \
  1309. ((__LENGTH__) == TIM_DMABURSTLENGTH_10TRANSFERS) || \
  1310. ((__LENGTH__) == TIM_DMABURSTLENGTH_11TRANSFERS) || \
  1311. ((__LENGTH__) == TIM_DMABURSTLENGTH_12TRANSFERS) || \
  1312. ((__LENGTH__) == TIM_DMABURSTLENGTH_13TRANSFERS) || \
  1313. ((__LENGTH__) == TIM_DMABURSTLENGTH_14TRANSFERS) || \
  1314. ((__LENGTH__) == TIM_DMABURSTLENGTH_15TRANSFERS) || \
  1315. ((__LENGTH__) == TIM_DMABURSTLENGTH_16TRANSFERS) || \
  1316. ((__LENGTH__) == TIM_DMABURSTLENGTH_17TRANSFERS) || \
  1317. ((__LENGTH__) == TIM_DMABURSTLENGTH_18TRANSFERS))
  1318. #define IS_TIM_IC_FILTER(ICFILTER) ((ICFILTER) <= 0xF)
  1319. /**
  1320. * @}
  1321. */
  1322. /**
  1323. * @}
  1324. */
  1325. /* Private functions ---------------------------------------------------------*/
  1326. /** @defgroup TIM_Private_Functions TIM Private Functions
  1327. * @{
  1328. */
  1329. void TIM_Base_SetConfig(TIM_TypeDef *TIMx, TIM_Base_InitTypeDef *Structure);
  1330. void TIM_TI1_SetConfig(TIM_TypeDef *TIMx, uint32_t TIM_ICPolarity, uint32_t TIM_ICSelection, uint32_t TIM_ICFilter);
  1331. void TIM_OC1_SetConfig(TIM_TypeDef *TIMx, TIM_OC_InitTypeDef *OC_Config);
  1332. void TIM_OC2_SetConfig(TIM_TypeDef *TIMx, TIM_OC_InitTypeDef *OC_Config);
  1333. void TIM_OC3_SetConfig(TIM_TypeDef *TIMx, TIM_OC_InitTypeDef *OC_Config);
  1334. void TIM_OC4_SetConfig(TIM_TypeDef *TIMx, TIM_OC_InitTypeDef *OC_Config);
  1335. void TIM_ETR_SetConfig(TIM_TypeDef* TIMx, uint32_t TIM_ExtTRGPrescaler, uint32_t TIM_ExtTRGPolarity, uint32_t ExtTRGFilter);
  1336. void HAL_TIM_DMADelayPulseCplt(DMA_HandleTypeDef *hdma);
  1337. void HAL_TIM_DMAError(DMA_HandleTypeDef *hdma);
  1338. void HAL_TIM_DMACaptureCplt(DMA_HandleTypeDef *hdma);
  1339. void TIM_CCxChannelCmd(TIM_TypeDef* TIMx, uint32_t Channel, uint32_t ChannelState);
  1340. /**
  1341. * @}
  1342. */
  1343. /**
  1344. * @}
  1345. */
  1346. /**
  1347. * @}
  1348. */
  1349. #ifdef __cplusplus
  1350. }
  1351. #endif
  1352. #endif /* __STM32F7xx_HAL_TIM_H */
  1353. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/