stm32l0xx_hal_tim.h 66 KB

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