stm32l0xx_hal_tim.h 104 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851
  1. /**
  2. ******************************************************************************
  3. * @file stm32l0xx_hal_tim.h
  4. * @author MCD Application Team
  5. * @brief Header file of TIM HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2016 STMicroelectronics.
  10. * All rights reserved.
  11. *
  12. * This software is licensed under terms that can be found in the LICENSE file
  13. * in the root directory of this software component.
  14. * If no LICENSE file comes with this software, it is provided AS-IS.
  15. *
  16. ******************************************************************************
  17. */
  18. /* Define to prevent recursive inclusion -------------------------------------*/
  19. #ifndef STM32L0xx_HAL_TIM_H
  20. #define STM32L0xx_HAL_TIM_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32l0xx_hal_def.h"
  26. /** @addtogroup STM32L0xx_HAL_Driver
  27. * @{
  28. */
  29. /** @addtogroup TIM
  30. * @{
  31. */
  32. /* Exported types ------------------------------------------------------------*/
  33. /** @defgroup TIM_Exported_Types TIM Exported Types
  34. * @{
  35. */
  36. /**
  37. * @brief TIM Time base Configuration Structure definition
  38. */
  39. typedef struct
  40. {
  41. uint32_t Prescaler; /*!< Specifies the prescaler value used to divide the TIM clock.
  42. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF */
  43. uint32_t CounterMode; /*!< Specifies the counter mode.
  44. This parameter can be a value of @ref TIM_Counter_Mode */
  45. uint32_t Period; /*!< Specifies the period value to be loaded into the active
  46. Auto-Reload Register at the next update event.
  47. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF. */
  48. uint32_t ClockDivision; /*!< Specifies the clock division.
  49. This parameter can be a value of @ref TIM_ClockDivision */
  50. uint32_t AutoReloadPreload; /*!< Specifies the auto-reload preload.
  51. This parameter can be a value of @ref TIM_AutoReloadPreload */
  52. } TIM_Base_InitTypeDef;
  53. /**
  54. * @brief TIM Output Compare Configuration Structure definition
  55. */
  56. typedef struct
  57. {
  58. uint32_t OCMode; /*!< Specifies the TIM mode.
  59. This parameter can be a value of @ref TIM_Output_Compare_and_PWM_modes */
  60. uint32_t Pulse; /*!< Specifies the pulse value to be loaded into the Capture Compare Register.
  61. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF */
  62. uint32_t OCPolarity; /*!< Specifies the output polarity.
  63. This parameter can be a value of @ref TIM_Output_Compare_Polarity */
  64. uint32_t OCFastMode; /*!< Specifies the Fast mode state.
  65. This parameter can be a value of @ref TIM_Output_Fast_State
  66. @note This parameter is valid only in PWM1 and PWM2 mode. */
  67. } TIM_OC_InitTypeDef;
  68. /**
  69. * @brief TIM One Pulse Mode Configuration Structure definition
  70. */
  71. typedef struct
  72. {
  73. uint32_t OCMode; /*!< Specifies the TIM mode.
  74. This parameter can be a value of @ref TIM_Output_Compare_and_PWM_modes */
  75. uint32_t Pulse; /*!< Specifies the pulse value to be loaded into the Capture Compare Register.
  76. This parameter can be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF */
  77. uint32_t OCPolarity; /*!< Specifies the output polarity.
  78. This parameter can be a value of @ref TIM_Output_Compare_Polarity */
  79. uint32_t ICPolarity; /*!< Specifies the active edge of the input signal.
  80. This parameter can be a value of @ref TIM_Input_Capture_Polarity */
  81. uint32_t ICSelection; /*!< Specifies the input.
  82. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  83. uint32_t ICFilter; /*!< Specifies the input capture filter.
  84. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  85. } TIM_OnePulse_InitTypeDef;
  86. /**
  87. * @brief TIM Input Capture Configuration Structure definition
  88. */
  89. typedef struct
  90. {
  91. uint32_t ICPolarity; /*!< Specifies the active edge of the input signal.
  92. This parameter can be a value of @ref TIM_Input_Capture_Polarity */
  93. uint32_t ICSelection; /*!< Specifies the input.
  94. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  95. uint32_t ICPrescaler; /*!< Specifies the Input Capture Prescaler.
  96. This parameter can be a value of @ref TIM_Input_Capture_Prescaler */
  97. uint32_t ICFilter; /*!< Specifies the input capture filter.
  98. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  99. } TIM_IC_InitTypeDef;
  100. /**
  101. * @brief TIM Encoder Configuration Structure definition
  102. */
  103. typedef struct
  104. {
  105. uint32_t EncoderMode; /*!< Specifies the active edge of the input signal.
  106. This parameter can be a value of @ref TIM_Encoder_Mode */
  107. uint32_t IC1Polarity; /*!< Specifies the active edge of the input signal.
  108. This parameter can be a value of @ref TIM_Encoder_Input_Polarity */
  109. uint32_t IC1Selection; /*!< Specifies the input.
  110. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  111. uint32_t IC1Prescaler; /*!< Specifies the Input Capture Prescaler.
  112. This parameter can be a value of @ref TIM_Input_Capture_Prescaler */
  113. uint32_t IC1Filter; /*!< Specifies the input capture filter.
  114. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  115. uint32_t IC2Polarity; /*!< Specifies the active edge of the input signal.
  116. This parameter can be a value of @ref TIM_Encoder_Input_Polarity */
  117. uint32_t IC2Selection; /*!< Specifies the input.
  118. This parameter can be a value of @ref TIM_Input_Capture_Selection */
  119. uint32_t IC2Prescaler; /*!< Specifies the Input Capture Prescaler.
  120. This parameter can be a value of @ref TIM_Input_Capture_Prescaler */
  121. uint32_t IC2Filter; /*!< Specifies the input capture filter.
  122. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  123. } TIM_Encoder_InitTypeDef;
  124. /**
  125. * @brief Clock Configuration Handle Structure definition
  126. */
  127. typedef struct
  128. {
  129. uint32_t ClockSource; /*!< TIM clock sources
  130. This parameter can be a value of @ref TIM_Clock_Source */
  131. uint32_t ClockPolarity; /*!< TIM clock polarity
  132. This parameter can be a value of @ref TIM_Clock_Polarity */
  133. uint32_t ClockPrescaler; /*!< TIM clock prescaler
  134. This parameter can be a value of @ref TIM_Clock_Prescaler */
  135. uint32_t ClockFilter; /*!< TIM clock filter
  136. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  137. } TIM_ClockConfigTypeDef;
  138. /**
  139. * @brief TIM Clear Input Configuration Handle Structure definition
  140. */
  141. typedef struct
  142. {
  143. uint32_t ClearInputState; /*!< TIM clear Input state
  144. This parameter can be ENABLE or DISABLE */
  145. uint32_t ClearInputSource; /*!< TIM clear Input sources
  146. This parameter can be a value of @ref TIM_ClearInput_Source */
  147. uint32_t ClearInputPolarity; /*!< TIM Clear Input polarity
  148. This parameter can be a value of @ref TIM_ClearInput_Polarity */
  149. uint32_t ClearInputPrescaler; /*!< TIM Clear Input prescaler
  150. This parameter must be 0: When OCRef clear feature is used with ETR source,
  151. ETR prescaler must be off */
  152. uint32_t ClearInputFilter; /*!< TIM Clear Input filter
  153. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  154. } TIM_ClearInputConfigTypeDef;
  155. /**
  156. * @brief TIM Master configuration Structure definition
  157. */
  158. typedef struct
  159. {
  160. uint32_t MasterOutputTrigger; /*!< Trigger output (TRGO) selection
  161. This parameter can be a value of @ref TIM_Master_Mode_Selection */
  162. uint32_t MasterSlaveMode; /*!< Master/slave mode selection
  163. This parameter can be a value of @ref TIM_Master_Slave_Mode
  164. @note When the Master/slave mode is enabled, the effect of
  165. an event on the trigger input (TRGI) is delayed to allow a
  166. perfect synchronization between the current timer and its
  167. slaves (through TRGO). It is not mandatory in case of timer
  168. synchronization mode. */
  169. } TIM_MasterConfigTypeDef;
  170. /**
  171. * @brief TIM Slave configuration Structure definition
  172. */
  173. typedef struct
  174. {
  175. uint32_t SlaveMode; /*!< Slave mode selection
  176. This parameter can be a value of @ref TIM_Slave_Mode */
  177. uint32_t InputTrigger; /*!< Input Trigger source
  178. This parameter can be a value of @ref TIM_Trigger_Selection */
  179. uint32_t TriggerPolarity; /*!< Input Trigger polarity
  180. This parameter can be a value of @ref TIM_Trigger_Polarity */
  181. uint32_t TriggerPrescaler; /*!< Input trigger prescaler
  182. This parameter can be a value of @ref TIM_Trigger_Prescaler */
  183. uint32_t TriggerFilter; /*!< Input trigger filter
  184. This parameter can be a number between Min_Data = 0x0 and Max_Data = 0xF */
  185. } TIM_SlaveConfigTypeDef;
  186. /**
  187. * @brief HAL State structures definition
  188. */
  189. typedef enum
  190. {
  191. HAL_TIM_STATE_RESET = 0x00U, /*!< Peripheral not yet initialized or disabled */
  192. HAL_TIM_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */
  193. HAL_TIM_STATE_BUSY = 0x02U, /*!< An internal process is ongoing */
  194. HAL_TIM_STATE_TIMEOUT = 0x03U, /*!< Timeout state */
  195. HAL_TIM_STATE_ERROR = 0x04U /*!< Reception process is ongoing */
  196. } HAL_TIM_StateTypeDef;
  197. /**
  198. * @brief TIM Channel States definition
  199. */
  200. typedef enum
  201. {
  202. HAL_TIM_CHANNEL_STATE_RESET = 0x00U, /*!< TIM Channel initial state */
  203. HAL_TIM_CHANNEL_STATE_READY = 0x01U, /*!< TIM Channel ready for use */
  204. HAL_TIM_CHANNEL_STATE_BUSY = 0x02U, /*!< An internal process is ongoing on the TIM channel */
  205. } HAL_TIM_ChannelStateTypeDef;
  206. /**
  207. * @brief DMA Burst States definition
  208. */
  209. typedef enum
  210. {
  211. HAL_DMA_BURST_STATE_RESET = 0x00U, /*!< DMA Burst initial state */
  212. HAL_DMA_BURST_STATE_READY = 0x01U, /*!< DMA Burst ready for use */
  213. HAL_DMA_BURST_STATE_BUSY = 0x02U, /*!< Ongoing DMA Burst */
  214. } HAL_TIM_DMABurstStateTypeDef;
  215. /**
  216. * @brief HAL Active channel structures definition
  217. */
  218. typedef enum
  219. {
  220. HAL_TIM_ACTIVE_CHANNEL_1 = 0x01U, /*!< The active channel is 1 */
  221. HAL_TIM_ACTIVE_CHANNEL_2 = 0x02U, /*!< The active channel is 2 */
  222. HAL_TIM_ACTIVE_CHANNEL_3 = 0x04U, /*!< The active channel is 3 */
  223. HAL_TIM_ACTIVE_CHANNEL_4 = 0x08U, /*!< The active channel is 4 */
  224. HAL_TIM_ACTIVE_CHANNEL_CLEARED = 0x00U /*!< All active channels cleared */
  225. } HAL_TIM_ActiveChannel;
  226. /**
  227. * @brief TIM Time Base Handle Structure definition
  228. */
  229. #if (USE_HAL_TIM_REGISTER_CALLBACKS == 1)
  230. typedef struct __TIM_HandleTypeDef
  231. #else
  232. typedef struct
  233. #endif /* USE_HAL_TIM_REGISTER_CALLBACKS */
  234. {
  235. TIM_TypeDef *Instance; /*!< Register base address */
  236. TIM_Base_InitTypeDef Init; /*!< TIM Time Base required parameters */
  237. HAL_TIM_ActiveChannel Channel; /*!< Active channel */
  238. DMA_HandleTypeDef *hdma[7]; /*!< DMA Handlers array
  239. This array is accessed by a @ref DMA_Handle_index */
  240. HAL_LockTypeDef Lock; /*!< Locking object */
  241. __IO HAL_TIM_StateTypeDef State; /*!< TIM operation state */
  242. __IO HAL_TIM_ChannelStateTypeDef ChannelState[4]; /*!< TIM channel operation state */
  243. __IO HAL_TIM_DMABurstStateTypeDef DMABurstState; /*!< DMA burst operation state */
  244. #if (USE_HAL_TIM_REGISTER_CALLBACKS == 1)
  245. void (* Base_MspInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Base Msp Init Callback */
  246. void (* Base_MspDeInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Base Msp DeInit Callback */
  247. void (* IC_MspInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM IC Msp Init Callback */
  248. void (* IC_MspDeInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM IC Msp DeInit Callback */
  249. void (* OC_MspInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM OC Msp Init Callback */
  250. void (* OC_MspDeInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM OC Msp DeInit Callback */
  251. void (* PWM_MspInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM PWM Msp Init Callback */
  252. void (* PWM_MspDeInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM PWM Msp DeInit Callback */
  253. void (* OnePulse_MspInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM One Pulse Msp Init Callback */
  254. void (* OnePulse_MspDeInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM One Pulse Msp DeInit Callback */
  255. void (* Encoder_MspInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Encoder Msp Init Callback */
  256. void (* Encoder_MspDeInitCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Encoder Msp DeInit Callback */
  257. void (* PeriodElapsedCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Period Elapsed Callback */
  258. void (* PeriodElapsedHalfCpltCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Period Elapsed half complete Callback */
  259. void (* TriggerCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Trigger Callback */
  260. void (* TriggerHalfCpltCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Trigger half complete Callback */
  261. void (* IC_CaptureCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Input Capture Callback */
  262. void (* IC_CaptureHalfCpltCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Input Capture half complete Callback */
  263. void (* OC_DelayElapsedCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Output Compare Delay Elapsed Callback */
  264. void (* PWM_PulseFinishedCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM PWM Pulse Finished Callback */
  265. void (* PWM_PulseFinishedHalfCpltCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM PWM Pulse Finished half complete Callback */
  266. void (* ErrorCallback)(struct __TIM_HandleTypeDef *htim); /*!< TIM Error Callback */
  267. #endif /* USE_HAL_TIM_REGISTER_CALLBACKS */
  268. } TIM_HandleTypeDef;
  269. #if (USE_HAL_TIM_REGISTER_CALLBACKS == 1)
  270. /**
  271. * @brief HAL TIM Callback ID enumeration definition
  272. */
  273. typedef enum
  274. {
  275. HAL_TIM_BASE_MSPINIT_CB_ID = 0x00U /*!< TIM Base MspInit Callback ID */
  276. , HAL_TIM_BASE_MSPDEINIT_CB_ID = 0x01U /*!< TIM Base MspDeInit Callback ID */
  277. , HAL_TIM_IC_MSPINIT_CB_ID = 0x02U /*!< TIM IC MspInit Callback ID */
  278. , HAL_TIM_IC_MSPDEINIT_CB_ID = 0x03U /*!< TIM IC MspDeInit Callback ID */
  279. , HAL_TIM_OC_MSPINIT_CB_ID = 0x04U /*!< TIM OC MspInit Callback ID */
  280. , HAL_TIM_OC_MSPDEINIT_CB_ID = 0x05U /*!< TIM OC MspDeInit Callback ID */
  281. , HAL_TIM_PWM_MSPINIT_CB_ID = 0x06U /*!< TIM PWM MspInit Callback ID */
  282. , HAL_TIM_PWM_MSPDEINIT_CB_ID = 0x07U /*!< TIM PWM MspDeInit Callback ID */
  283. , HAL_TIM_ONE_PULSE_MSPINIT_CB_ID = 0x08U /*!< TIM One Pulse MspInit Callback ID */
  284. , HAL_TIM_ONE_PULSE_MSPDEINIT_CB_ID = 0x09U /*!< TIM One Pulse MspDeInit Callback ID */
  285. , HAL_TIM_ENCODER_MSPINIT_CB_ID = 0x0AU /*!< TIM Encoder MspInit Callback ID */
  286. , HAL_TIM_ENCODER_MSPDEINIT_CB_ID = 0x0BU /*!< TIM Encoder MspDeInit Callback ID */
  287. , HAL_TIM_PERIOD_ELAPSED_CB_ID = 0x0EU /*!< TIM Period Elapsed Callback ID */
  288. , HAL_TIM_PERIOD_ELAPSED_HALF_CB_ID = 0x0FU /*!< TIM Period Elapsed half complete Callback ID */
  289. , HAL_TIM_TRIGGER_CB_ID = 0x10U /*!< TIM Trigger Callback ID */
  290. , HAL_TIM_TRIGGER_HALF_CB_ID = 0x11U /*!< TIM Trigger half complete Callback ID */
  291. , HAL_TIM_IC_CAPTURE_CB_ID = 0x12U /*!< TIM Input Capture Callback ID */
  292. , HAL_TIM_IC_CAPTURE_HALF_CB_ID = 0x13U /*!< TIM Input Capture half complete Callback ID */
  293. , HAL_TIM_OC_DELAY_ELAPSED_CB_ID = 0x14U /*!< TIM Output Compare Delay Elapsed Callback ID */
  294. , HAL_TIM_PWM_PULSE_FINISHED_CB_ID = 0x15U /*!< TIM PWM Pulse Finished Callback ID */
  295. , HAL_TIM_PWM_PULSE_FINISHED_HALF_CB_ID = 0x16U /*!< TIM PWM Pulse Finished half complete Callback ID */
  296. , HAL_TIM_ERROR_CB_ID = 0x17U /*!< TIM Error Callback ID */
  297. } HAL_TIM_CallbackIDTypeDef;
  298. /**
  299. * @brief HAL TIM Callback pointer definition
  300. */
  301. typedef void (*pTIM_CallbackTypeDef)(TIM_HandleTypeDef *htim); /*!< pointer to the TIM callback function */
  302. #endif /* USE_HAL_TIM_REGISTER_CALLBACKS */
  303. /**
  304. * @}
  305. */
  306. /* End of exported types -----------------------------------------------------*/
  307. /* Exported constants --------------------------------------------------------*/
  308. /** @defgroup TIM_Exported_Constants TIM Exported Constants
  309. * @{
  310. */
  311. /** @defgroup TIM_ClearInput_Source TIM Clear Input Source
  312. * @{
  313. */
  314. #define TIM_CLEARINPUTSOURCE_NONE 0x00000000U /*!< OCREF_CLR is disabled */
  315. #define TIM_CLEARINPUTSOURCE_ETR 0x00000001U /*!< OCREF_CLR is connected to ETRF input */
  316. /**
  317. * @}
  318. */
  319. /** @defgroup TIM_DMA_Base_address TIM DMA Base Address
  320. * @{
  321. */
  322. #define TIM_DMABASE_CR1 0x00000000U
  323. #define TIM_DMABASE_CR2 0x00000001U
  324. #define TIM_DMABASE_SMCR 0x00000002U
  325. #define TIM_DMABASE_DIER 0x00000003U
  326. #define TIM_DMABASE_SR 0x00000004U
  327. #define TIM_DMABASE_EGR 0x00000005U
  328. #define TIM_DMABASE_CCMR1 0x00000006U
  329. #define TIM_DMABASE_CCMR2 0x00000007U
  330. #define TIM_DMABASE_CCER 0x00000008U
  331. #define TIM_DMABASE_CNT 0x00000009U
  332. #define TIM_DMABASE_PSC 0x0000000AU
  333. #define TIM_DMABASE_ARR 0x0000000BU
  334. #define TIM_DMABASE_CCR1 0x0000000DU
  335. #define TIM_DMABASE_CCR2 0x0000000EU
  336. #define TIM_DMABASE_CCR3 0x0000000FU
  337. #define TIM_DMABASE_CCR4 0x00000010U
  338. #define TIM_DMABASE_DCR 0x00000012U
  339. #define TIM_DMABASE_DMAR 0x00000013U
  340. #define TIM_DMABASE_OR 0x00000014U
  341. /**
  342. * @}
  343. */
  344. /** @defgroup TIM_Event_Source TIM Event Source
  345. * @{
  346. */
  347. #define TIM_EVENTSOURCE_UPDATE TIM_EGR_UG /*!< Reinitialize the counter and generates an update of the registers */
  348. #define TIM_EVENTSOURCE_CC1 TIM_EGR_CC1G /*!< A capture/compare event is generated on channel 1 */
  349. #define TIM_EVENTSOURCE_CC2 TIM_EGR_CC2G /*!< A capture/compare event is generated on channel 2 */
  350. #define TIM_EVENTSOURCE_CC3 TIM_EGR_CC3G /*!< A capture/compare event is generated on channel 3 */
  351. #define TIM_EVENTSOURCE_CC4 TIM_EGR_CC4G /*!< A capture/compare event is generated on channel 4 */
  352. #define TIM_EVENTSOURCE_TRIGGER TIM_EGR_TG /*!< A trigger event is generated */
  353. /**
  354. * @}
  355. */
  356. /** @defgroup TIM_Input_Channel_Polarity TIM Input Channel polarity
  357. * @{
  358. */
  359. #define TIM_INPUTCHANNELPOLARITY_RISING 0x00000000U /*!< Polarity for TIx source */
  360. #define TIM_INPUTCHANNELPOLARITY_FALLING TIM_CCER_CC1P /*!< Polarity for TIx source */
  361. #define TIM_INPUTCHANNELPOLARITY_BOTHEDGE (TIM_CCER_CC1P | TIM_CCER_CC1NP) /*!< Polarity for TIx source */
  362. /**
  363. * @}
  364. */
  365. /** @defgroup TIM_ETR_Polarity TIM ETR Polarity
  366. * @{
  367. */
  368. #define TIM_ETRPOLARITY_INVERTED TIM_SMCR_ETP /*!< Polarity for ETR source */
  369. #define TIM_ETRPOLARITY_NONINVERTED 0x00000000U /*!< Polarity for ETR source */
  370. /**
  371. * @}
  372. */
  373. /** @defgroup TIM_ETR_Prescaler TIM ETR Prescaler
  374. * @{
  375. */
  376. #define TIM_ETRPRESCALER_DIV1 0x00000000U /*!< No prescaler is used */
  377. #define TIM_ETRPRESCALER_DIV2 TIM_SMCR_ETPS_0 /*!< ETR input source is divided by 2 */
  378. #define TIM_ETRPRESCALER_DIV4 TIM_SMCR_ETPS_1 /*!< ETR input source is divided by 4 */
  379. #define TIM_ETRPRESCALER_DIV8 TIM_SMCR_ETPS /*!< ETR input source is divided by 8 */
  380. /**
  381. * @}
  382. */
  383. /** @defgroup TIM_Counter_Mode TIM Counter Mode
  384. * @{
  385. */
  386. #define TIM_COUNTERMODE_UP 0x00000000U /*!< Counter used as up-counter */
  387. #define TIM_COUNTERMODE_DOWN TIM_CR1_DIR /*!< Counter used as down-counter */
  388. #define TIM_COUNTERMODE_CENTERALIGNED1 TIM_CR1_CMS_0 /*!< Center-aligned mode 1 */
  389. #define TIM_COUNTERMODE_CENTERALIGNED2 TIM_CR1_CMS_1 /*!< Center-aligned mode 2 */
  390. #define TIM_COUNTERMODE_CENTERALIGNED3 TIM_CR1_CMS /*!< Center-aligned mode 3 */
  391. /**
  392. * @}
  393. */
  394. /** @defgroup TIM_ClockDivision TIM Clock Division
  395. * @{
  396. */
  397. #define TIM_CLOCKDIVISION_DIV1 0x00000000U /*!< Clock division: tDTS=tCK_INT */
  398. #define TIM_CLOCKDIVISION_DIV2 TIM_CR1_CKD_0 /*!< Clock division: tDTS=2*tCK_INT */
  399. #define TIM_CLOCKDIVISION_DIV4 TIM_CR1_CKD_1 /*!< Clock division: tDTS=4*tCK_INT */
  400. /**
  401. * @}
  402. */
  403. /** @defgroup TIM_Output_Compare_State TIM Output Compare State
  404. * @{
  405. */
  406. #define TIM_OUTPUTSTATE_DISABLE 0x00000000U /*!< Capture/Compare 1 output disabled */
  407. #define TIM_OUTPUTSTATE_ENABLE TIM_CCER_CC1E /*!< Capture/Compare 1 output enabled */
  408. /**
  409. * @}
  410. */
  411. /** @defgroup TIM_AutoReloadPreload TIM Auto-Reload Preload
  412. * @{
  413. */
  414. #define TIM_AUTORELOAD_PRELOAD_DISABLE 0x00000000U /*!< TIMx_ARR register is not buffered */
  415. #define TIM_AUTORELOAD_PRELOAD_ENABLE TIM_CR1_ARPE /*!< TIMx_ARR register is buffered */
  416. /**
  417. * @}
  418. */
  419. /** @defgroup TIM_Output_Fast_State TIM Output Fast State
  420. * @{
  421. */
  422. #define TIM_OCFAST_DISABLE 0x00000000U /*!< Output Compare fast disable */
  423. #define TIM_OCFAST_ENABLE TIM_CCMR1_OC1FE /*!< Output Compare fast enable */
  424. /**
  425. * @}
  426. */
  427. /** @defgroup TIM_Output_Compare_N_State TIM Complementary Output Compare State
  428. * @{
  429. */
  430. #define TIM_OUTPUTNSTATE_DISABLE 0x00000000U /*!< OCxN is disabled */
  431. #define TIM_OUTPUTNSTATE_ENABLE TIM_CCER_CC1NE /*!< OCxN is enabled */
  432. /**
  433. * @}
  434. */
  435. /** @defgroup TIM_Output_Compare_Polarity TIM Output Compare Polarity
  436. * @{
  437. */
  438. #define TIM_OCPOLARITY_HIGH 0x00000000U /*!< Capture/Compare output polarity */
  439. #define TIM_OCPOLARITY_LOW TIM_CCER_CC1P /*!< Capture/Compare output polarity */
  440. /**
  441. * @}
  442. */
  443. /** @defgroup TIM_Input_Capture_Polarity TIM Input Capture Polarity
  444. * @{
  445. */
  446. #define TIM_ICPOLARITY_RISING TIM_INPUTCHANNELPOLARITY_RISING /*!< Capture triggered by rising edge on timer input */
  447. #define TIM_ICPOLARITY_FALLING TIM_INPUTCHANNELPOLARITY_FALLING /*!< Capture triggered by falling edge on timer input */
  448. #define TIM_ICPOLARITY_BOTHEDGE TIM_INPUTCHANNELPOLARITY_BOTHEDGE /*!< Capture triggered by both rising and falling edges on timer input*/
  449. /**
  450. * @}
  451. */
  452. /** @defgroup TIM_Encoder_Input_Polarity TIM Encoder Input Polarity
  453. * @{
  454. */
  455. #define TIM_ENCODERINPUTPOLARITY_RISING TIM_INPUTCHANNELPOLARITY_RISING /*!< Encoder input with rising edge polarity */
  456. #define TIM_ENCODERINPUTPOLARITY_FALLING TIM_INPUTCHANNELPOLARITY_FALLING /*!< Encoder input with falling edge polarity */
  457. /**
  458. * @}
  459. */
  460. /** @defgroup TIM_Input_Capture_Selection TIM Input Capture Selection
  461. * @{
  462. */
  463. #define TIM_ICSELECTION_DIRECTTI TIM_CCMR1_CC1S_0 /*!< TIM Input 1, 2, 3 or 4 is selected to be connected to IC1, IC2, IC3 or IC4, respectively */
  464. #define TIM_ICSELECTION_INDIRECTTI TIM_CCMR1_CC1S_1 /*!< TIM Input 1, 2, 3 or 4 is selected to be connected to IC2, IC1, IC4 or IC3, respectively */
  465. #define TIM_ICSELECTION_TRC TIM_CCMR1_CC1S /*!< TIM Input 1, 2, 3 or 4 is selected to be connected to TRC */
  466. /**
  467. * @}
  468. */
  469. /** @defgroup TIM_Input_Capture_Prescaler TIM Input Capture Prescaler
  470. * @{
  471. */
  472. #define TIM_ICPSC_DIV1 0x00000000U /*!< Capture performed each time an edge is detected on the capture input */
  473. #define TIM_ICPSC_DIV2 TIM_CCMR1_IC1PSC_0 /*!< Capture performed once every 2 events */
  474. #define TIM_ICPSC_DIV4 TIM_CCMR1_IC1PSC_1 /*!< Capture performed once every 4 events */
  475. #define TIM_ICPSC_DIV8 TIM_CCMR1_IC1PSC /*!< Capture performed once every 8 events */
  476. /**
  477. * @}
  478. */
  479. /** @defgroup TIM_One_Pulse_Mode TIM One Pulse Mode
  480. * @{
  481. */
  482. #define TIM_OPMODE_SINGLE TIM_CR1_OPM /*!< Counter stops counting at the next update event */
  483. #define TIM_OPMODE_REPETITIVE 0x00000000U /*!< Counter is not stopped at update event */
  484. /**
  485. * @}
  486. */
  487. /** @defgroup TIM_Encoder_Mode TIM Encoder Mode
  488. * @{
  489. */
  490. #define TIM_ENCODERMODE_TI1 TIM_SMCR_SMS_0 /*!< Quadrature encoder mode 1, x2 mode, counts up/down on TI1FP1 edge depending on TI2FP2 level */
  491. #define TIM_ENCODERMODE_TI2 TIM_SMCR_SMS_1 /*!< Quadrature encoder mode 2, x2 mode, counts up/down on TI2FP2 edge depending on TI1FP1 level. */
  492. #define TIM_ENCODERMODE_TI12 (TIM_SMCR_SMS_1 | TIM_SMCR_SMS_0) /*!< Quadrature encoder mode 3, x4 mode, counts up/down on both TI1FP1 and TI2FP2 edges depending on the level of the other input. */
  493. /**
  494. * @}
  495. */
  496. /** @defgroup TIM_Interrupt_definition TIM interrupt Definition
  497. * @{
  498. */
  499. #define TIM_IT_UPDATE TIM_DIER_UIE /*!< Update interrupt */
  500. #define TIM_IT_CC1 TIM_DIER_CC1IE /*!< Capture/Compare 1 interrupt */
  501. #define TIM_IT_CC2 TIM_DIER_CC2IE /*!< Capture/Compare 2 interrupt */
  502. #define TIM_IT_CC3 TIM_DIER_CC3IE /*!< Capture/Compare 3 interrupt */
  503. #define TIM_IT_CC4 TIM_DIER_CC4IE /*!< Capture/Compare 4 interrupt */
  504. #define TIM_IT_TRIGGER TIM_DIER_TIE /*!< Trigger interrupt */
  505. /**
  506. * @}
  507. */
  508. /** @defgroup TIM_DMA_sources TIM DMA Sources
  509. * @{
  510. */
  511. #define TIM_DMA_UPDATE TIM_DIER_UDE /*!< DMA request is triggered by the update event */
  512. #define TIM_DMA_CC1 TIM_DIER_CC1DE /*!< DMA request is triggered by the capture/compare macth 1 event */
  513. #define TIM_DMA_CC2 TIM_DIER_CC2DE /*!< DMA request is triggered by the capture/compare macth 2 event event */
  514. #define TIM_DMA_CC3 TIM_DIER_CC3DE /*!< DMA request is triggered by the capture/compare macth 3 event event */
  515. #define TIM_DMA_CC4 TIM_DIER_CC4DE /*!< DMA request is triggered by the capture/compare macth 4 event event */
  516. #define TIM_DMA_TRIGGER TIM_DIER_TDE /*!< DMA request is triggered by the trigger event */
  517. /**
  518. * @}
  519. */
  520. /** @defgroup TIM_CC_DMA_Request CCx DMA request selection
  521. * @{
  522. */
  523. #define TIM_CCDMAREQUEST_CC 0x00000000U /*!< CCx DMA request sent when capture or compare match event occurs */
  524. #define TIM_CCDMAREQUEST_UPDATE TIM_CR2_CCDS /*!< CCx DMA requests sent when update event occurs */
  525. /**
  526. * @}
  527. */
  528. /** @defgroup TIM_Flag_definition TIM Flag Definition
  529. * @{
  530. */
  531. #define TIM_FLAG_UPDATE TIM_SR_UIF /*!< Update interrupt flag */
  532. #define TIM_FLAG_CC1 TIM_SR_CC1IF /*!< Capture/Compare 1 interrupt flag */
  533. #define TIM_FLAG_CC2 TIM_SR_CC2IF /*!< Capture/Compare 2 interrupt flag */
  534. #define TIM_FLAG_CC3 TIM_SR_CC3IF /*!< Capture/Compare 3 interrupt flag */
  535. #define TIM_FLAG_CC4 TIM_SR_CC4IF /*!< Capture/Compare 4 interrupt flag */
  536. #define TIM_FLAG_TRIGGER TIM_SR_TIF /*!< Trigger interrupt flag */
  537. #define TIM_FLAG_CC1OF TIM_SR_CC1OF /*!< Capture 1 overcapture flag */
  538. #define TIM_FLAG_CC2OF TIM_SR_CC2OF /*!< Capture 2 overcapture flag */
  539. #define TIM_FLAG_CC3OF TIM_SR_CC3OF /*!< Capture 3 overcapture flag */
  540. #define TIM_FLAG_CC4OF TIM_SR_CC4OF /*!< Capture 4 overcapture flag */
  541. /**
  542. * @}
  543. */
  544. /** @defgroup TIM_Channel TIM Channel
  545. * @{
  546. */
  547. #define TIM_CHANNEL_1 0x00000000U /*!< Capture/compare channel 1 identifier */
  548. #define TIM_CHANNEL_2 0x00000004U /*!< Capture/compare channel 2 identifier */
  549. #define TIM_CHANNEL_3 0x00000008U /*!< Capture/compare channel 3 identifier */
  550. #define TIM_CHANNEL_4 0x0000000CU /*!< Capture/compare channel 4 identifier */
  551. #define TIM_CHANNEL_ALL 0x0000003CU /*!< Global Capture/compare channel identifier */
  552. /**
  553. * @}
  554. */
  555. /** @defgroup TIM_Clock_Source TIM Clock Source
  556. * @{
  557. */
  558. #define TIM_CLOCKSOURCE_INTERNAL TIM_SMCR_ETPS_0 /*!< Internal clock source */
  559. #define TIM_CLOCKSOURCE_ETRMODE1 TIM_TS_ETRF /*!< External clock source mode 1 (ETRF) */
  560. #define TIM_CLOCKSOURCE_ETRMODE2 TIM_SMCR_ETPS_1 /*!< External clock source mode 2 */
  561. #define TIM_CLOCKSOURCE_TI1ED TIM_TS_TI1F_ED /*!< External clock source mode 1 (TTI1FP1 + edge detect.) */
  562. #define TIM_CLOCKSOURCE_TI1 TIM_TS_TI1FP1 /*!< External clock source mode 1 (TTI1FP1) */
  563. #define TIM_CLOCKSOURCE_TI2 TIM_TS_TI2FP2 /*!< External clock source mode 1 (TTI2FP2) */
  564. #define TIM_CLOCKSOURCE_ITR0 TIM_TS_ITR0 /*!< External clock source mode 1 (ITR0) */
  565. #define TIM_CLOCKSOURCE_ITR1 TIM_TS_ITR1 /*!< External clock source mode 1 (ITR1) */
  566. #define TIM_CLOCKSOURCE_ITR2 TIM_TS_ITR2 /*!< External clock source mode 1 (ITR2) */
  567. #define TIM_CLOCKSOURCE_ITR3 TIM_TS_ITR3 /*!< External clock source mode 1 (ITR3) */
  568. /**
  569. * @}
  570. */
  571. /** @defgroup TIM_Clock_Polarity TIM Clock Polarity
  572. * @{
  573. */
  574. #define TIM_CLOCKPOLARITY_INVERTED TIM_ETRPOLARITY_INVERTED /*!< Polarity for ETRx clock sources */
  575. #define TIM_CLOCKPOLARITY_NONINVERTED TIM_ETRPOLARITY_NONINVERTED /*!< Polarity for ETRx clock sources */
  576. #define TIM_CLOCKPOLARITY_RISING TIM_INPUTCHANNELPOLARITY_RISING /*!< Polarity for TIx clock sources */
  577. #define TIM_CLOCKPOLARITY_FALLING TIM_INPUTCHANNELPOLARITY_FALLING /*!< Polarity for TIx clock sources */
  578. #define TIM_CLOCKPOLARITY_BOTHEDGE TIM_INPUTCHANNELPOLARITY_BOTHEDGE /*!< Polarity for TIx clock sources */
  579. /**
  580. * @}
  581. */
  582. /** @defgroup TIM_Clock_Prescaler TIM Clock Prescaler
  583. * @{
  584. */
  585. #define TIM_CLOCKPRESCALER_DIV1 TIM_ETRPRESCALER_DIV1 /*!< No prescaler is used */
  586. #define TIM_CLOCKPRESCALER_DIV2 TIM_ETRPRESCALER_DIV2 /*!< Prescaler for External ETR Clock: Capture performed once every 2 events. */
  587. #define TIM_CLOCKPRESCALER_DIV4 TIM_ETRPRESCALER_DIV4 /*!< Prescaler for External ETR Clock: Capture performed once every 4 events. */
  588. #define TIM_CLOCKPRESCALER_DIV8 TIM_ETRPRESCALER_DIV8 /*!< Prescaler for External ETR Clock: Capture performed once every 8 events. */
  589. /**
  590. * @}
  591. */
  592. /** @defgroup TIM_ClearInput_Polarity TIM Clear Input Polarity
  593. * @{
  594. */
  595. #define TIM_CLEARINPUTPOLARITY_INVERTED TIM_ETRPOLARITY_INVERTED /*!< Polarity for ETRx pin */
  596. #define TIM_CLEARINPUTPOLARITY_NONINVERTED TIM_ETRPOLARITY_NONINVERTED /*!< Polarity for ETRx pin */
  597. /**
  598. * @}
  599. */
  600. /** @defgroup TIM_ClearInput_Prescaler TIM Clear Input Prescaler
  601. * @{
  602. */
  603. #define TIM_CLEARINPUTPRESCALER_DIV1 TIM_ETRPRESCALER_DIV1 /*!< No prescaler is used */
  604. #define TIM_CLEARINPUTPRESCALER_DIV2 TIM_ETRPRESCALER_DIV2 /*!< Prescaler for External ETR pin: Capture performed once every 2 events. */
  605. #define TIM_CLEARINPUTPRESCALER_DIV4 TIM_ETRPRESCALER_DIV4 /*!< Prescaler for External ETR pin: Capture performed once every 4 events. */
  606. #define TIM_CLEARINPUTPRESCALER_DIV8 TIM_ETRPRESCALER_DIV8 /*!< Prescaler for External ETR pin: Capture performed once every 8 events. */
  607. /**
  608. * @}
  609. */
  610. /** @defgroup TIM_Master_Mode_Selection TIM Master Mode Selection
  611. * @{
  612. */
  613. #define TIM_TRGO_RESET 0x00000000U /*!< TIMx_EGR.UG bit is used as trigger output (TRGO) */
  614. #define TIM_TRGO_ENABLE TIM_CR2_MMS_0 /*!< TIMx_CR1.CEN bit is used as trigger output (TRGO) */
  615. #define TIM_TRGO_UPDATE TIM_CR2_MMS_1 /*!< Update event is used as trigger output (TRGO) */
  616. #define TIM_TRGO_OC1 (TIM_CR2_MMS_1 | TIM_CR2_MMS_0) /*!< Capture or a compare match 1 is used as trigger output (TRGO) */
  617. #define TIM_TRGO_OC1REF TIM_CR2_MMS_2 /*!< OC1REF signal is used as trigger output (TRGO) */
  618. #define TIM_TRGO_OC2REF (TIM_CR2_MMS_2 | TIM_CR2_MMS_0) /*!< OC2REF signal is used as trigger output(TRGO) */
  619. #define TIM_TRGO_OC3REF (TIM_CR2_MMS_2 | TIM_CR2_MMS_1) /*!< OC3REF signal is used as trigger output(TRGO) */
  620. #define TIM_TRGO_OC4REF (TIM_CR2_MMS_2 | TIM_CR2_MMS_1 | TIM_CR2_MMS_0) /*!< OC4REF signal is used as trigger output(TRGO) */
  621. /**
  622. * @}
  623. */
  624. /** @defgroup TIM_Master_Slave_Mode TIM Master/Slave Mode
  625. * @{
  626. */
  627. #define TIM_MASTERSLAVEMODE_ENABLE TIM_SMCR_MSM /*!< No action */
  628. #define TIM_MASTERSLAVEMODE_DISABLE 0x00000000U /*!< Master/slave mode is selected */
  629. /**
  630. * @}
  631. */
  632. /** @defgroup TIM_Slave_Mode TIM Slave mode
  633. * @{
  634. */
  635. #define TIM_SLAVEMODE_DISABLE 0x00000000U /*!< Slave mode disabled */
  636. #define TIM_SLAVEMODE_RESET TIM_SMCR_SMS_2 /*!< Reset Mode */
  637. #define TIM_SLAVEMODE_GATED (TIM_SMCR_SMS_2 | TIM_SMCR_SMS_0) /*!< Gated Mode */
  638. #define TIM_SLAVEMODE_TRIGGER (TIM_SMCR_SMS_2 | TIM_SMCR_SMS_1) /*!< Trigger Mode */
  639. #define TIM_SLAVEMODE_EXTERNAL1 (TIM_SMCR_SMS_2 | TIM_SMCR_SMS_1 | TIM_SMCR_SMS_0) /*!< External Clock Mode 1 */
  640. /**
  641. * @}
  642. */
  643. /** @defgroup TIM_Output_Compare_and_PWM_modes TIM Output Compare and PWM Modes
  644. * @{
  645. */
  646. #define TIM_OCMODE_TIMING 0x00000000U /*!< Frozen */
  647. #define TIM_OCMODE_ACTIVE TIM_CCMR1_OC1M_0 /*!< Set channel to active level on match */
  648. #define TIM_OCMODE_INACTIVE TIM_CCMR1_OC1M_1 /*!< Set channel to inactive level on match */
  649. #define TIM_OCMODE_TOGGLE (TIM_CCMR1_OC1M_1 | TIM_CCMR1_OC1M_0) /*!< Toggle */
  650. #define TIM_OCMODE_PWM1 (TIM_CCMR1_OC1M_2 | TIM_CCMR1_OC1M_1) /*!< PWM mode 1 */
  651. #define TIM_OCMODE_PWM2 (TIM_CCMR1_OC1M_2 | TIM_CCMR1_OC1M_1 | TIM_CCMR1_OC1M_0) /*!< PWM mode 2 */
  652. #define TIM_OCMODE_FORCED_ACTIVE (TIM_CCMR1_OC1M_2 | TIM_CCMR1_OC1M_0) /*!< Force active level */
  653. #define TIM_OCMODE_FORCED_INACTIVE TIM_CCMR1_OC1M_2 /*!< Force inactive level */
  654. /**
  655. * @}
  656. */
  657. /** @defgroup TIM_Trigger_Selection TIM Trigger Selection
  658. * @{
  659. */
  660. #define TIM_TS_ITR0 0x00000000U /*!< Internal Trigger 0 (ITR0) */
  661. #define TIM_TS_ITR1 TIM_SMCR_TS_0 /*!< Internal Trigger 1 (ITR1) */
  662. #define TIM_TS_ITR2 TIM_SMCR_TS_1 /*!< Internal Trigger 2 (ITR2) */
  663. #define TIM_TS_ITR3 (TIM_SMCR_TS_0 | TIM_SMCR_TS_1) /*!< Internal Trigger 3 (ITR3) */
  664. #define TIM_TS_TI1F_ED TIM_SMCR_TS_2 /*!< TI1 Edge Detector (TI1F_ED) */
  665. #define TIM_TS_TI1FP1 (TIM_SMCR_TS_0 | TIM_SMCR_TS_2) /*!< Filtered Timer Input 1 (TI1FP1) */
  666. #define TIM_TS_TI2FP2 (TIM_SMCR_TS_1 | TIM_SMCR_TS_2) /*!< Filtered Timer Input 2 (TI2FP2) */
  667. #define TIM_TS_ETRF (TIM_SMCR_TS_0 | TIM_SMCR_TS_1 | TIM_SMCR_TS_2) /*!< Filtered External Trigger input (ETRF) */
  668. #define TIM_TS_NONE 0x0000FFFFU /*!< No trigger selected */
  669. /**
  670. * @}
  671. */
  672. /** @defgroup TIM_Trigger_Polarity TIM Trigger Polarity
  673. * @{
  674. */
  675. #define TIM_TRIGGERPOLARITY_INVERTED TIM_ETRPOLARITY_INVERTED /*!< Polarity for ETRx trigger sources */
  676. #define TIM_TRIGGERPOLARITY_NONINVERTED TIM_ETRPOLARITY_NONINVERTED /*!< Polarity for ETRx trigger sources */
  677. #define TIM_TRIGGERPOLARITY_RISING TIM_INPUTCHANNELPOLARITY_RISING /*!< Polarity for TIxFPx or TI1_ED trigger sources */
  678. #define TIM_TRIGGERPOLARITY_FALLING TIM_INPUTCHANNELPOLARITY_FALLING /*!< Polarity for TIxFPx or TI1_ED trigger sources */
  679. #define TIM_TRIGGERPOLARITY_BOTHEDGE TIM_INPUTCHANNELPOLARITY_BOTHEDGE /*!< Polarity for TIxFPx or TI1_ED trigger sources */
  680. /**
  681. * @}
  682. */
  683. /** @defgroup TIM_Trigger_Prescaler TIM Trigger Prescaler
  684. * @{
  685. */
  686. #define TIM_TRIGGERPRESCALER_DIV1 TIM_ETRPRESCALER_DIV1 /*!< No prescaler is used */
  687. #define TIM_TRIGGERPRESCALER_DIV2 TIM_ETRPRESCALER_DIV2 /*!< Prescaler for External ETR Trigger: Capture performed once every 2 events. */
  688. #define TIM_TRIGGERPRESCALER_DIV4 TIM_ETRPRESCALER_DIV4 /*!< Prescaler for External ETR Trigger: Capture performed once every 4 events. */
  689. #define TIM_TRIGGERPRESCALER_DIV8 TIM_ETRPRESCALER_DIV8 /*!< Prescaler for External ETR Trigger: Capture performed once every 8 events. */
  690. /**
  691. * @}
  692. */
  693. /** @defgroup TIM_TI1_Selection TIM TI1 Input Selection
  694. * @{
  695. */
  696. #define TIM_TI1SELECTION_CH1 0x00000000U /*!< The TIMx_CH1 pin is connected to TI1 input */
  697. #define TIM_TI1SELECTION_XORCOMBINATION TIM_CR2_TI1S /*!< The TIMx_CH1, CH2 and CH3 pins are connected to the TI1 input (XOR combination) */
  698. /**
  699. * @}
  700. */
  701. /** @defgroup TIM_DMA_Burst_Length TIM DMA Burst Length
  702. * @{
  703. */
  704. #define TIM_DMABURSTLENGTH_1TRANSFER 0x00000000U /*!< The transfer is done to 1 register starting from TIMx_CR1 + TIMx_DCR.DBA */
  705. #define TIM_DMABURSTLENGTH_2TRANSFERS 0x00000100U /*!< The transfer is done to 2 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  706. #define TIM_DMABURSTLENGTH_3TRANSFERS 0x00000200U /*!< The transfer is done to 3 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  707. #define TIM_DMABURSTLENGTH_4TRANSFERS 0x00000300U /*!< The transfer is done to 4 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  708. #define TIM_DMABURSTLENGTH_5TRANSFERS 0x00000400U /*!< The transfer is done to 5 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  709. #define TIM_DMABURSTLENGTH_6TRANSFERS 0x00000500U /*!< The transfer is done to 6 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  710. #define TIM_DMABURSTLENGTH_7TRANSFERS 0x00000600U /*!< The transfer is done to 7 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  711. #define TIM_DMABURSTLENGTH_8TRANSFERS 0x00000700U /*!< The transfer is done to 8 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  712. #define TIM_DMABURSTLENGTH_9TRANSFERS 0x00000800U /*!< The transfer is done to 9 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  713. #define TIM_DMABURSTLENGTH_10TRANSFERS 0x00000900U /*!< The transfer is done to 10 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  714. #define TIM_DMABURSTLENGTH_11TRANSFERS 0x00000A00U /*!< The transfer is done to 11 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  715. #define TIM_DMABURSTLENGTH_12TRANSFERS 0x00000B00U /*!< The transfer is done to 12 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  716. #define TIM_DMABURSTLENGTH_13TRANSFERS 0x00000C00U /*!< The transfer is done to 13 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  717. #define TIM_DMABURSTLENGTH_14TRANSFERS 0x00000D00U /*!< The transfer is done to 14 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  718. #define TIM_DMABURSTLENGTH_15TRANSFERS 0x00000E00U /*!< The transfer is done to 15 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  719. #define TIM_DMABURSTLENGTH_16TRANSFERS 0x00000F00U /*!< The transfer is done to 16 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  720. #define TIM_DMABURSTLENGTH_17TRANSFERS 0x00001000U /*!< The transfer is done to 17 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  721. #define TIM_DMABURSTLENGTH_18TRANSFERS 0x00001100U /*!< The transfer is done to 18 registers starting from TIMx_CR1 + TIMx_DCR.DBA */
  722. /**
  723. * @}
  724. */
  725. /** @defgroup DMA_Handle_index TIM DMA Handle Index
  726. * @{
  727. */
  728. #define TIM_DMA_ID_UPDATE ((uint16_t) 0x0000) /*!< Index of the DMA handle used for Update DMA requests */
  729. #define TIM_DMA_ID_CC1 ((uint16_t) 0x0001) /*!< Index of the DMA handle used for Capture/Compare 1 DMA requests */
  730. #define TIM_DMA_ID_CC2 ((uint16_t) 0x0002) /*!< Index of the DMA handle used for Capture/Compare 2 DMA requests */
  731. #define TIM_DMA_ID_CC3 ((uint16_t) 0x0003) /*!< Index of the DMA handle used for Capture/Compare 3 DMA requests */
  732. #define TIM_DMA_ID_CC4 ((uint16_t) 0x0004) /*!< Index of the DMA handle used for Capture/Compare 4 DMA requests */
  733. #define TIM_DMA_ID_TRIGGER ((uint16_t) 0x0006) /*!< Index of the DMA handle used for Trigger DMA requests */
  734. /**
  735. * @}
  736. */
  737. /** @defgroup Channel_CC_State TIM Capture/Compare Channel State
  738. * @{
  739. */
  740. #define TIM_CCx_ENABLE 0x00000001U /*!< Input or output channel is enabled */
  741. #define TIM_CCx_DISABLE 0x00000000U /*!< Input or output channel is disabled */
  742. /**
  743. * @}
  744. */
  745. /**
  746. * @}
  747. */
  748. /* End of exported constants -------------------------------------------------*/
  749. /* Exported macros -----------------------------------------------------------*/
  750. /** @defgroup TIM_Exported_Macros TIM Exported Macros
  751. * @{
  752. */
  753. /** @brief Reset TIM handle state.
  754. * @param __HANDLE__ TIM handle.
  755. * @retval None
  756. */
  757. #if (USE_HAL_TIM_REGISTER_CALLBACKS == 1)
  758. #define __HAL_TIM_RESET_HANDLE_STATE(__HANDLE__) do { \
  759. (__HANDLE__)->State = HAL_TIM_STATE_RESET; \
  760. (__HANDLE__)->ChannelState[0] = HAL_TIM_CHANNEL_STATE_RESET; \
  761. (__HANDLE__)->ChannelState[1] = HAL_TIM_CHANNEL_STATE_RESET; \
  762. (__HANDLE__)->ChannelState[2] = HAL_TIM_CHANNEL_STATE_RESET; \
  763. (__HANDLE__)->ChannelState[3] = HAL_TIM_CHANNEL_STATE_RESET; \
  764. (__HANDLE__)->DMABurstState = HAL_DMA_BURST_STATE_RESET; \
  765. (__HANDLE__)->Base_MspInitCallback = NULL; \
  766. (__HANDLE__)->Base_MspDeInitCallback = NULL; \
  767. (__HANDLE__)->IC_MspInitCallback = NULL; \
  768. (__HANDLE__)->IC_MspDeInitCallback = NULL; \
  769. (__HANDLE__)->OC_MspInitCallback = NULL; \
  770. (__HANDLE__)->OC_MspDeInitCallback = NULL; \
  771. (__HANDLE__)->PWM_MspInitCallback = NULL; \
  772. (__HANDLE__)->PWM_MspDeInitCallback = NULL; \
  773. (__HANDLE__)->OnePulse_MspInitCallback = NULL; \
  774. (__HANDLE__)->OnePulse_MspDeInitCallback = NULL; \
  775. (__HANDLE__)->Encoder_MspInitCallback = NULL; \
  776. (__HANDLE__)->Encoder_MspDeInitCallback = NULL; \
  777. } while(0)
  778. #else
  779. #define __HAL_TIM_RESET_HANDLE_STATE(__HANDLE__) do { \
  780. (__HANDLE__)->State = HAL_TIM_STATE_RESET; \
  781. (__HANDLE__)->ChannelState[0] = HAL_TIM_CHANNEL_STATE_RESET; \
  782. (__HANDLE__)->ChannelState[1] = HAL_TIM_CHANNEL_STATE_RESET; \
  783. (__HANDLE__)->ChannelState[2] = HAL_TIM_CHANNEL_STATE_RESET; \
  784. (__HANDLE__)->ChannelState[3] = HAL_TIM_CHANNEL_STATE_RESET; \
  785. (__HANDLE__)->DMABurstState = HAL_DMA_BURST_STATE_RESET; \
  786. } while(0)
  787. #endif /* USE_HAL_TIM_REGISTER_CALLBACKS */
  788. /**
  789. * @brief Enable the TIM peripheral.
  790. * @param __HANDLE__ TIM handle
  791. * @retval None
  792. */
  793. #define __HAL_TIM_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1|=(TIM_CR1_CEN))
  794. /**
  795. * @brief Disable the TIM peripheral.
  796. * @param __HANDLE__ TIM handle
  797. * @retval None
  798. */
  799. #define __HAL_TIM_DISABLE(__HANDLE__) \
  800. do { \
  801. if (((__HANDLE__)->Instance->CCER & TIM_CCER_CCxE_MASK) == 0UL) \
  802. { \
  803. (__HANDLE__)->Instance->CR1 &= ~(TIM_CR1_CEN); \
  804. } \
  805. } while(0)
  806. /** @brief Enable the specified TIM interrupt.
  807. * @param __HANDLE__ specifies the TIM Handle.
  808. * @param __INTERRUPT__ specifies the TIM interrupt source to enable.
  809. * This parameter can be one of the following values:
  810. * @arg TIM_IT_UPDATE: Update interrupt
  811. * @arg TIM_IT_CC1: Capture/Compare 1 interrupt
  812. * @arg TIM_IT_CC2: Capture/Compare 2 interrupt
  813. * @arg TIM_IT_CC3: Capture/Compare 3 interrupt
  814. * @arg TIM_IT_CC4: Capture/Compare 4 interrupt
  815. * @arg TIM_IT_TRIGGER: Trigger interrupt
  816. * @retval None
  817. */
  818. #define __HAL_TIM_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->DIER |= (__INTERRUPT__))
  819. /** @brief Disable the specified TIM interrupt.
  820. * @param __HANDLE__ specifies the TIM Handle.
  821. * @param __INTERRUPT__ specifies the TIM interrupt source to disable.
  822. * This parameter can be one of the following values:
  823. * @arg TIM_IT_UPDATE: Update interrupt
  824. * @arg TIM_IT_CC1: Capture/Compare 1 interrupt
  825. * @arg TIM_IT_CC2: Capture/Compare 2 interrupt
  826. * @arg TIM_IT_CC3: Capture/Compare 3 interrupt
  827. * @arg TIM_IT_CC4: Capture/Compare 4 interrupt
  828. * @arg TIM_IT_TRIGGER: Trigger interrupt
  829. * @retval None
  830. */
  831. #define __HAL_TIM_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->DIER &= ~(__INTERRUPT__))
  832. /** @brief Enable the specified DMA request.
  833. * @param __HANDLE__ specifies the TIM Handle.
  834. * @param __DMA__ specifies the TIM DMA request to enable.
  835. * This parameter can be one of the following values:
  836. * @arg TIM_DMA_UPDATE: Update DMA request
  837. * @arg TIM_DMA_CC1: Capture/Compare 1 DMA request
  838. * @arg TIM_DMA_CC2: Capture/Compare 2 DMA request
  839. * @arg TIM_DMA_CC3: Capture/Compare 3 DMA request
  840. * @arg TIM_DMA_CC4: Capture/Compare 4 DMA request
  841. * @arg TIM_DMA_TRIGGER: Trigger DMA request
  842. * @retval None
  843. */
  844. #define __HAL_TIM_ENABLE_DMA(__HANDLE__, __DMA__) ((__HANDLE__)->Instance->DIER |= (__DMA__))
  845. /** @brief Disable the specified DMA request.
  846. * @param __HANDLE__ specifies the TIM Handle.
  847. * @param __DMA__ specifies the TIM DMA request to disable.
  848. * This parameter can be one of the following values:
  849. * @arg TIM_DMA_UPDATE: Update DMA request
  850. * @arg TIM_DMA_CC1: Capture/Compare 1 DMA request
  851. * @arg TIM_DMA_CC2: Capture/Compare 2 DMA request
  852. * @arg TIM_DMA_CC3: Capture/Compare 3 DMA request
  853. * @arg TIM_DMA_CC4: Capture/Compare 4 DMA request
  854. * @arg TIM_DMA_TRIGGER: Trigger DMA request
  855. * @retval None
  856. */
  857. #define __HAL_TIM_DISABLE_DMA(__HANDLE__, __DMA__) ((__HANDLE__)->Instance->DIER &= ~(__DMA__))
  858. /** @brief Check whether the specified TIM interrupt flag is set or not.
  859. * @param __HANDLE__ specifies the TIM Handle.
  860. * @param __FLAG__ specifies the TIM interrupt flag to check.
  861. * This parameter can be one of the following values:
  862. * @arg TIM_FLAG_UPDATE: Update interrupt flag
  863. * @arg TIM_FLAG_CC1: Capture/Compare 1 interrupt flag
  864. * @arg TIM_FLAG_CC2: Capture/Compare 2 interrupt flag
  865. * @arg TIM_FLAG_CC3: Capture/Compare 3 interrupt flag
  866. * @arg TIM_FLAG_CC4: Capture/Compare 4 interrupt flag
  867. * @arg TIM_FLAG_TRIGGER: Trigger interrupt flag
  868. * @arg TIM_FLAG_CC1OF: Capture/Compare 1 overcapture flag
  869. * @arg TIM_FLAG_CC2OF: Capture/Compare 2 overcapture flag
  870. * @arg TIM_FLAG_CC3OF: Capture/Compare 3 overcapture flag
  871. * @arg TIM_FLAG_CC4OF: Capture/Compare 4 overcapture flag
  872. * @retval The new state of __FLAG__ (TRUE or FALSE).
  873. */
  874. #define __HAL_TIM_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->SR &(__FLAG__)) == (__FLAG__))
  875. /** @brief Clear the specified TIM interrupt flag.
  876. * @param __HANDLE__ specifies the TIM Handle.
  877. * @param __FLAG__ specifies the TIM interrupt flag to clear.
  878. * This parameter can be one of the following values:
  879. * @arg TIM_FLAG_UPDATE: Update interrupt flag
  880. * @arg TIM_FLAG_CC1: Capture/Compare 1 interrupt flag
  881. * @arg TIM_FLAG_CC2: Capture/Compare 2 interrupt flag
  882. * @arg TIM_FLAG_CC3: Capture/Compare 3 interrupt flag
  883. * @arg TIM_FLAG_CC4: Capture/Compare 4 interrupt flag
  884. * @arg TIM_FLAG_TRIGGER: Trigger interrupt flag
  885. * @arg TIM_FLAG_CC1OF: Capture/Compare 1 overcapture flag
  886. * @arg TIM_FLAG_CC2OF: Capture/Compare 2 overcapture flag
  887. * @arg TIM_FLAG_CC3OF: Capture/Compare 3 overcapture flag
  888. * @arg TIM_FLAG_CC4OF: Capture/Compare 4 overcapture flag
  889. * @retval The new state of __FLAG__ (TRUE or FALSE).
  890. */
  891. #define __HAL_TIM_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->SR = ~(__FLAG__))
  892. /**
  893. * @brief Check whether the specified TIM interrupt source is enabled or not.
  894. * @param __HANDLE__ TIM handle
  895. * @param __INTERRUPT__ specifies the TIM interrupt source to check.
  896. * This parameter can be one of the following values:
  897. * @arg TIM_IT_UPDATE: Update interrupt
  898. * @arg TIM_IT_CC1: Capture/Compare 1 interrupt
  899. * @arg TIM_IT_CC2: Capture/Compare 2 interrupt
  900. * @arg TIM_IT_CC3: Capture/Compare 3 interrupt
  901. * @arg TIM_IT_CC4: Capture/Compare 4 interrupt
  902. * @arg TIM_IT_TRIGGER: Trigger interrupt
  903. * @retval The state of TIM_IT (SET or RESET).
  904. */
  905. #define __HAL_TIM_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->DIER & (__INTERRUPT__)) \
  906. == (__INTERRUPT__)) ? SET : RESET)
  907. /** @brief Clear the TIM interrupt pending bits.
  908. * @param __HANDLE__ TIM handle
  909. * @param __INTERRUPT__ specifies the interrupt pending bit to clear.
  910. * This parameter can be one of the following values:
  911. * @arg TIM_IT_UPDATE: Update interrupt
  912. * @arg TIM_IT_CC1: Capture/Compare 1 interrupt
  913. * @arg TIM_IT_CC2: Capture/Compare 2 interrupt
  914. * @arg TIM_IT_CC3: Capture/Compare 3 interrupt
  915. * @arg TIM_IT_CC4: Capture/Compare 4 interrupt
  916. * @arg TIM_IT_TRIGGER: Trigger interrupt
  917. * @retval None
  918. */
  919. #define __HAL_TIM_CLEAR_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->SR = ~(__INTERRUPT__))
  920. /**
  921. * @brief Indicates whether or not the TIM Counter is used as downcounter.
  922. * @param __HANDLE__ TIM handle.
  923. * @retval False (Counter used as upcounter) or True (Counter used as downcounter)
  924. * @note This macro is particularly useful to get the counting mode when the timer operates in Center-aligned mode
  925. * or Encoder mode.
  926. */
  927. #define __HAL_TIM_IS_TIM_COUNTING_DOWN(__HANDLE__) (((__HANDLE__)->Instance->CR1 &(TIM_CR1_DIR)) == (TIM_CR1_DIR))
  928. /**
  929. * @brief Set the TIM Prescaler on runtime.
  930. * @param __HANDLE__ TIM handle.
  931. * @param __PRESC__ specifies the Prescaler new value.
  932. * @retval None
  933. */
  934. #define __HAL_TIM_SET_PRESCALER(__HANDLE__, __PRESC__) ((__HANDLE__)->Instance->PSC = (__PRESC__))
  935. /**
  936. * @brief Set the TIM Counter Register value on runtime.
  937. * @param __HANDLE__ TIM handle.
  938. * @param __COUNTER__ specifies the Counter register new value.
  939. * @retval None
  940. */
  941. #define __HAL_TIM_SET_COUNTER(__HANDLE__, __COUNTER__) ((__HANDLE__)->Instance->CNT = (__COUNTER__))
  942. /**
  943. * @brief Get the TIM Counter Register value on runtime.
  944. * @param __HANDLE__ TIM handle.
  945. * @retval 16-bit value of the timer counter register (TIMx_CNT)
  946. */
  947. #define __HAL_TIM_GET_COUNTER(__HANDLE__) ((__HANDLE__)->Instance->CNT)
  948. /**
  949. * @brief Set the TIM Autoreload Register value on runtime without calling another time any Init function.
  950. * @param __HANDLE__ TIM handle.
  951. * @param __AUTORELOAD__ specifies the Counter register new value.
  952. * @retval None
  953. */
  954. #define __HAL_TIM_SET_AUTORELOAD(__HANDLE__, __AUTORELOAD__) \
  955. do{ \
  956. (__HANDLE__)->Instance->ARR = (__AUTORELOAD__); \
  957. (__HANDLE__)->Init.Period = (__AUTORELOAD__); \
  958. } while(0)
  959. /**
  960. * @brief Get the TIM Autoreload Register value on runtime.
  961. * @param __HANDLE__ TIM handle.
  962. * @retval 16-bit value of the timer auto-reload register(TIMx_ARR)
  963. */
  964. #define __HAL_TIM_GET_AUTORELOAD(__HANDLE__) ((__HANDLE__)->Instance->ARR)
  965. /**
  966. * @brief Set the TIM Clock Division value on runtime without calling another time any Init function.
  967. * @param __HANDLE__ TIM handle.
  968. * @param __CKD__ specifies the clock division value.
  969. * This parameter can be one of the following value:
  970. * @arg TIM_CLOCKDIVISION_DIV1: tDTS=tCK_INT
  971. * @arg TIM_CLOCKDIVISION_DIV2: tDTS=2*tCK_INT
  972. * @arg TIM_CLOCKDIVISION_DIV4: tDTS=4*tCK_INT
  973. * @retval None
  974. */
  975. #define __HAL_TIM_SET_CLOCKDIVISION(__HANDLE__, __CKD__) \
  976. do{ \
  977. (__HANDLE__)->Instance->CR1 &= (~TIM_CR1_CKD); \
  978. (__HANDLE__)->Instance->CR1 |= (__CKD__); \
  979. (__HANDLE__)->Init.ClockDivision = (__CKD__); \
  980. } while(0)
  981. /**
  982. * @brief Get the TIM Clock Division value on runtime.
  983. * @param __HANDLE__ TIM handle.
  984. * @retval The clock division can be one of the following values:
  985. * @arg TIM_CLOCKDIVISION_DIV1: tDTS=tCK_INT
  986. * @arg TIM_CLOCKDIVISION_DIV2: tDTS=2*tCK_INT
  987. * @arg TIM_CLOCKDIVISION_DIV4: tDTS=4*tCK_INT
  988. */
  989. #define __HAL_TIM_GET_CLOCKDIVISION(__HANDLE__) ((__HANDLE__)->Instance->CR1 & TIM_CR1_CKD)
  990. /**
  991. * @brief Set the TIM Input Capture prescaler on runtime without calling another time HAL_TIM_IC_ConfigChannel()
  992. * function.
  993. * @param __HANDLE__ TIM handle.
  994. * @param __CHANNEL__ TIM Channels to be configured.
  995. * This parameter can be one of the following values:
  996. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  997. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  998. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  999. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  1000. * @param __ICPSC__ specifies the Input Capture4 prescaler new value.
  1001. * This parameter can be one of the following values:
  1002. * @arg TIM_ICPSC_DIV1: no prescaler
  1003. * @arg TIM_ICPSC_DIV2: capture is done once every 2 events
  1004. * @arg TIM_ICPSC_DIV4: capture is done once every 4 events
  1005. * @arg TIM_ICPSC_DIV8: capture is done once every 8 events
  1006. * @retval None
  1007. */
  1008. #define __HAL_TIM_SET_ICPRESCALER(__HANDLE__, __CHANNEL__, __ICPSC__) \
  1009. do{ \
  1010. TIM_RESET_ICPRESCALERVALUE((__HANDLE__), (__CHANNEL__)); \
  1011. TIM_SET_ICPRESCALERVALUE((__HANDLE__), (__CHANNEL__), (__ICPSC__)); \
  1012. } while(0)
  1013. /**
  1014. * @brief Get the TIM Input Capture prescaler on runtime.
  1015. * @param __HANDLE__ TIM handle.
  1016. * @param __CHANNEL__ TIM Channels to be configured.
  1017. * This parameter can be one of the following values:
  1018. * @arg TIM_CHANNEL_1: get input capture 1 prescaler value
  1019. * @arg TIM_CHANNEL_2: get input capture 2 prescaler value
  1020. * @arg TIM_CHANNEL_3: get input capture 3 prescaler value
  1021. * @arg TIM_CHANNEL_4: get input capture 4 prescaler value
  1022. * @retval The input capture prescaler can be one of the following values:
  1023. * @arg TIM_ICPSC_DIV1: no prescaler
  1024. * @arg TIM_ICPSC_DIV2: capture is done once every 2 events
  1025. * @arg TIM_ICPSC_DIV4: capture is done once every 4 events
  1026. * @arg TIM_ICPSC_DIV8: capture is done once every 8 events
  1027. */
  1028. #define __HAL_TIM_GET_ICPRESCALER(__HANDLE__, __CHANNEL__) \
  1029. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 & TIM_CCMR1_IC1PSC) :\
  1030. ((__CHANNEL__) == TIM_CHANNEL_2) ? (((__HANDLE__)->Instance->CCMR1 & TIM_CCMR1_IC2PSC) >> 8U) :\
  1031. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 & TIM_CCMR2_IC3PSC) :\
  1032. (((__HANDLE__)->Instance->CCMR2 & TIM_CCMR2_IC4PSC)) >> 8U)
  1033. /**
  1034. * @brief Set the TIM Capture Compare Register value on runtime without calling another time ConfigChannel function.
  1035. * @param __HANDLE__ TIM handle.
  1036. * @param __CHANNEL__ TIM Channels to be configured.
  1037. * This parameter can be one of the following values:
  1038. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  1039. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  1040. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  1041. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  1042. * @param __COMPARE__ specifies the Capture Compare register new value.
  1043. * @retval None
  1044. */
  1045. #define __HAL_TIM_SET_COMPARE(__HANDLE__, __CHANNEL__, __COMPARE__) \
  1046. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCR1 = (__COMPARE__)) :\
  1047. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCR2 = (__COMPARE__)) :\
  1048. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCR3 = (__COMPARE__)) :\
  1049. ((__HANDLE__)->Instance->CCR4 = (__COMPARE__)))
  1050. /**
  1051. * @brief Get the TIM Capture Compare Register value on runtime.
  1052. * @param __HANDLE__ TIM handle.
  1053. * @param __CHANNEL__ TIM Channel associated with the capture compare register
  1054. * This parameter can be one of the following values:
  1055. * @arg TIM_CHANNEL_1: get capture/compare 1 register value
  1056. * @arg TIM_CHANNEL_2: get capture/compare 2 register value
  1057. * @arg TIM_CHANNEL_3: get capture/compare 3 register value
  1058. * @arg TIM_CHANNEL_4: get capture/compare 4 register value
  1059. * @retval 16-bit value of the capture/compare register (TIMx_CCRy)
  1060. */
  1061. #define __HAL_TIM_GET_COMPARE(__HANDLE__, __CHANNEL__) \
  1062. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCR1) :\
  1063. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCR2) :\
  1064. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCR3) :\
  1065. ((__HANDLE__)->Instance->CCR4))
  1066. /**
  1067. * @brief Set the TIM Output compare preload.
  1068. * @param __HANDLE__ TIM handle.
  1069. * @param __CHANNEL__ TIM Channels to be configured.
  1070. * This parameter can be one of the following values:
  1071. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  1072. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  1073. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  1074. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  1075. * @retval None
  1076. */
  1077. #define __HAL_TIM_ENABLE_OCxPRELOAD(__HANDLE__, __CHANNEL__) \
  1078. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 |= TIM_CCMR1_OC1PE) :\
  1079. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 |= TIM_CCMR1_OC2PE) :\
  1080. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 |= TIM_CCMR2_OC3PE) :\
  1081. ((__HANDLE__)->Instance->CCMR2 |= TIM_CCMR2_OC4PE))
  1082. /**
  1083. * @brief Reset the TIM Output compare preload.
  1084. * @param __HANDLE__ TIM handle.
  1085. * @param __CHANNEL__ TIM Channels to be configured.
  1086. * This parameter can be one of the following values:
  1087. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  1088. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  1089. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  1090. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  1091. * @retval None
  1092. */
  1093. #define __HAL_TIM_DISABLE_OCxPRELOAD(__HANDLE__, __CHANNEL__) \
  1094. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 &= ~TIM_CCMR1_OC1PE) :\
  1095. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 &= ~TIM_CCMR1_OC2PE) :\
  1096. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 &= ~TIM_CCMR2_OC3PE) :\
  1097. ((__HANDLE__)->Instance->CCMR2 &= ~TIM_CCMR2_OC4PE))
  1098. /**
  1099. * @brief Enable fast mode for a given channel.
  1100. * @param __HANDLE__ TIM handle.
  1101. * @param __CHANNEL__ TIM Channels to be configured.
  1102. * This parameter can be one of the following values:
  1103. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  1104. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  1105. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  1106. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  1107. * @note When fast mode is enabled an active edge on the trigger input acts
  1108. * like a compare match on CCx output. Delay to sample the trigger
  1109. * input and to activate CCx output is reduced to 3 clock cycles.
  1110. * @note Fast mode acts only if the channel is configured in PWM1 or PWM2 mode.
  1111. * @retval None
  1112. */
  1113. #define __HAL_TIM_ENABLE_OCxFAST(__HANDLE__, __CHANNEL__) \
  1114. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 |= TIM_CCMR1_OC1FE) :\
  1115. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 |= TIM_CCMR1_OC2FE) :\
  1116. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 |= TIM_CCMR2_OC3FE) :\
  1117. ((__HANDLE__)->Instance->CCMR2 |= TIM_CCMR2_OC4FE))
  1118. /**
  1119. * @brief Disable fast mode for a given channel.
  1120. * @param __HANDLE__ TIM handle.
  1121. * @param __CHANNEL__ TIM Channels to be configured.
  1122. * This parameter can be one of the following values:
  1123. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  1124. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  1125. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  1126. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  1127. * @note When fast mode is disabled CCx output behaves normally depending
  1128. * on counter and CCRx values even when the trigger is ON. The minimum
  1129. * delay to activate CCx output when an active edge occurs on the
  1130. * trigger input is 5 clock cycles.
  1131. * @retval None
  1132. */
  1133. #define __HAL_TIM_DISABLE_OCxFAST(__HANDLE__, __CHANNEL__) \
  1134. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 &= ~TIM_CCMR1_OC1FE) :\
  1135. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 &= ~TIM_CCMR1_OC2FE) :\
  1136. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 &= ~TIM_CCMR2_OC3FE) :\
  1137. ((__HANDLE__)->Instance->CCMR2 &= ~TIM_CCMR2_OC4FE))
  1138. /**
  1139. * @brief Set the Update Request Source (URS) bit of the TIMx_CR1 register.
  1140. * @param __HANDLE__ TIM handle.
  1141. * @note When the URS bit of the TIMx_CR1 register is set, only counter
  1142. * overflow/underflow generates an update interrupt or DMA request (if
  1143. * enabled)
  1144. * @retval None
  1145. */
  1146. #define __HAL_TIM_URS_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1|= TIM_CR1_URS)
  1147. /**
  1148. * @brief Reset the Update Request Source (URS) bit of the TIMx_CR1 register.
  1149. * @param __HANDLE__ TIM handle.
  1150. * @note When the URS bit of the TIMx_CR1 register is reset, any of the
  1151. * following events generate an update interrupt or DMA request (if
  1152. * enabled):
  1153. * _ Counter overflow underflow
  1154. * _ Setting the UG bit
  1155. * _ Update generation through the slave mode controller
  1156. * @retval None
  1157. */
  1158. #define __HAL_TIM_URS_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1&=~TIM_CR1_URS)
  1159. /**
  1160. * @brief Set the TIM Capture x input polarity on runtime.
  1161. * @param __HANDLE__ TIM handle.
  1162. * @param __CHANNEL__ TIM Channels to be configured.
  1163. * This parameter can be one of the following values:
  1164. * @arg TIM_CHANNEL_1: TIM Channel 1 selected
  1165. * @arg TIM_CHANNEL_2: TIM Channel 2 selected
  1166. * @arg TIM_CHANNEL_3: TIM Channel 3 selected
  1167. * @arg TIM_CHANNEL_4: TIM Channel 4 selected
  1168. * @param __POLARITY__ Polarity for TIx source
  1169. * @arg TIM_INPUTCHANNELPOLARITY_RISING: Rising Edge
  1170. * @arg TIM_INPUTCHANNELPOLARITY_FALLING: Falling Edge
  1171. * @arg TIM_INPUTCHANNELPOLARITY_BOTHEDGE: Rising and Falling Edge
  1172. * @retval None
  1173. */
  1174. #define __HAL_TIM_SET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__, __POLARITY__) \
  1175. do{ \
  1176. TIM_RESET_CAPTUREPOLARITY((__HANDLE__), (__CHANNEL__)); \
  1177. TIM_SET_CAPTUREPOLARITY((__HANDLE__), (__CHANNEL__), (__POLARITY__)); \
  1178. }while(0)
  1179. /** @brief Select the Capture/compare DMA request source.
  1180. * @param __HANDLE__ specifies the TIM Handle.
  1181. * @param __CCDMA__ specifies Capture/compare DMA request source
  1182. * This parameter can be one of the following values:
  1183. * @arg TIM_CCDMAREQUEST_CC: CCx DMA request generated on Capture/Compare event
  1184. * @arg TIM_CCDMAREQUEST_UPDATE: CCx DMA request generated on Update event
  1185. * @retval None
  1186. */
  1187. #define __HAL_TIM_SELECT_CCDMAREQUEST(__HANDLE__, __CCDMA__) \
  1188. MODIFY_REG((__HANDLE__)->Instance->CR2, TIM_CR2_CCDS, (__CCDMA__))
  1189. /**
  1190. * @}
  1191. */
  1192. /* End of exported macros ----------------------------------------------------*/
  1193. /* Private constants ---------------------------------------------------------*/
  1194. /** @defgroup TIM_Private_Constants TIM Private Constants
  1195. * @{
  1196. */
  1197. /* The counter of a timer instance is disabled only if all the CCx and CCxN
  1198. channels have been disabled */
  1199. #define TIM_CCER_CCxE_MASK ((uint32_t)(TIM_CCER_CC1E | TIM_CCER_CC2E | TIM_CCER_CC3E | TIM_CCER_CC4E))
  1200. /**
  1201. * @}
  1202. */
  1203. /* End of private constants --------------------------------------------------*/
  1204. /* Private macros ------------------------------------------------------------*/
  1205. /** @defgroup TIM_Private_Macros TIM Private Macros
  1206. * @{
  1207. */
  1208. #define IS_TIM_CLEARINPUT_SOURCE(__MODE__) (((__MODE__) == TIM_CLEARINPUTSOURCE_NONE) || \
  1209. ((__MODE__) == TIM_CLEARINPUTSOURCE_ETR))
  1210. #define IS_TIM_DMA_BASE(__BASE__) (((__BASE__) == TIM_DMABASE_CR1) || \
  1211. ((__BASE__) == TIM_DMABASE_CR2) || \
  1212. ((__BASE__) == TIM_DMABASE_SMCR) || \
  1213. ((__BASE__) == TIM_DMABASE_DIER) || \
  1214. ((__BASE__) == TIM_DMABASE_SR) || \
  1215. ((__BASE__) == TIM_DMABASE_EGR) || \
  1216. ((__BASE__) == TIM_DMABASE_CCMR1) || \
  1217. ((__BASE__) == TIM_DMABASE_CCMR2) || \
  1218. ((__BASE__) == TIM_DMABASE_CCER) || \
  1219. ((__BASE__) == TIM_DMABASE_CNT) || \
  1220. ((__BASE__) == TIM_DMABASE_PSC) || \
  1221. ((__BASE__) == TIM_DMABASE_ARR) || \
  1222. ((__BASE__) == TIM_DMABASE_CCR1) || \
  1223. ((__BASE__) == TIM_DMABASE_CCR2) || \
  1224. ((__BASE__) == TIM_DMABASE_CCR3) || \
  1225. ((__BASE__) == TIM_DMABASE_CCR4) || \
  1226. ((__BASE__) == TIM_DMABASE_OR))
  1227. #define IS_TIM_EVENT_SOURCE(__SOURCE__) ((((__SOURCE__) & 0xFFFFFFA0U) == 0x00000000U) && ((__SOURCE__) != 0x00000000U))
  1228. #define IS_TIM_COUNTER_MODE(__MODE__) (((__MODE__) == TIM_COUNTERMODE_UP) || \
  1229. ((__MODE__) == TIM_COUNTERMODE_DOWN) || \
  1230. ((__MODE__) == TIM_COUNTERMODE_CENTERALIGNED1) || \
  1231. ((__MODE__) == TIM_COUNTERMODE_CENTERALIGNED2) || \
  1232. ((__MODE__) == TIM_COUNTERMODE_CENTERALIGNED3))
  1233. #define IS_TIM_CLOCKDIVISION_DIV(__DIV__) (((__DIV__) == TIM_CLOCKDIVISION_DIV1) || \
  1234. ((__DIV__) == TIM_CLOCKDIVISION_DIV2) || \
  1235. ((__DIV__) == TIM_CLOCKDIVISION_DIV4))
  1236. #define IS_TIM_AUTORELOAD_PRELOAD(PRELOAD) (((PRELOAD) == TIM_AUTORELOAD_PRELOAD_DISABLE) || \
  1237. ((PRELOAD) == TIM_AUTORELOAD_PRELOAD_ENABLE))
  1238. #define IS_TIM_FAST_STATE(__STATE__) (((__STATE__) == TIM_OCFAST_DISABLE) || \
  1239. ((__STATE__) == TIM_OCFAST_ENABLE))
  1240. #define IS_TIM_OC_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_OCPOLARITY_HIGH) || \
  1241. ((__POLARITY__) == TIM_OCPOLARITY_LOW))
  1242. #define IS_TIM_ENCODERINPUT_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_ENCODERINPUTPOLARITY_RISING) || \
  1243. ((__POLARITY__) == TIM_ENCODERINPUTPOLARITY_FALLING))
  1244. #define IS_TIM_IC_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_ICPOLARITY_RISING) || \
  1245. ((__POLARITY__) == TIM_ICPOLARITY_FALLING) || \
  1246. ((__POLARITY__) == TIM_ICPOLARITY_BOTHEDGE))
  1247. #define IS_TIM_IC_SELECTION(__SELECTION__) (((__SELECTION__) == TIM_ICSELECTION_DIRECTTI) || \
  1248. ((__SELECTION__) == TIM_ICSELECTION_INDIRECTTI) || \
  1249. ((__SELECTION__) == TIM_ICSELECTION_TRC))
  1250. #define IS_TIM_IC_PRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_ICPSC_DIV1) || \
  1251. ((__PRESCALER__) == TIM_ICPSC_DIV2) || \
  1252. ((__PRESCALER__) == TIM_ICPSC_DIV4) || \
  1253. ((__PRESCALER__) == TIM_ICPSC_DIV8))
  1254. #define IS_TIM_OPM_MODE(__MODE__) (((__MODE__) == TIM_OPMODE_SINGLE) || \
  1255. ((__MODE__) == TIM_OPMODE_REPETITIVE))
  1256. #define IS_TIM_ENCODER_MODE(__MODE__) (((__MODE__) == TIM_ENCODERMODE_TI1) || \
  1257. ((__MODE__) == TIM_ENCODERMODE_TI2) || \
  1258. ((__MODE__) == TIM_ENCODERMODE_TI12))
  1259. #define IS_TIM_DMA_SOURCE(__SOURCE__) ((((__SOURCE__) & 0xFFFFA0FFU) == 0x00000000U) && ((__SOURCE__) != 0x00000000U))
  1260. #define IS_TIM_CHANNELS(__CHANNEL__) (((__CHANNEL__) == TIM_CHANNEL_1) || \
  1261. ((__CHANNEL__) == TIM_CHANNEL_2) || \
  1262. ((__CHANNEL__) == TIM_CHANNEL_3) || \
  1263. ((__CHANNEL__) == TIM_CHANNEL_4) || \
  1264. ((__CHANNEL__) == TIM_CHANNEL_ALL))
  1265. #define IS_TIM_OPM_CHANNELS(__CHANNEL__) (((__CHANNEL__) == TIM_CHANNEL_1) || \
  1266. ((__CHANNEL__) == TIM_CHANNEL_2))
  1267. #define IS_TIM_PERIOD(__PERIOD__) (((__PERIOD__) > 0U) && ((__PERIOD__) <= 0xFFFFU))
  1268. #define IS_TIM_PRESCALER(__PRESCALER__) ((__PRESCALER__) <= 0xFFFFU)
  1269. #define IS_TIM_CLOCKSOURCE(__CLOCK__) (((__CLOCK__) == TIM_CLOCKSOURCE_INTERNAL) || \
  1270. ((__CLOCK__) == TIM_CLOCKSOURCE_ETRMODE1) || \
  1271. ((__CLOCK__) == TIM_CLOCKSOURCE_ETRMODE2) || \
  1272. ((__CLOCK__) == TIM_CLOCKSOURCE_TI1ED) || \
  1273. ((__CLOCK__) == TIM_CLOCKSOURCE_TI1) || \
  1274. ((__CLOCK__) == TIM_CLOCKSOURCE_TI2) || \
  1275. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR0) || \
  1276. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR1) || \
  1277. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR2) || \
  1278. ((__CLOCK__) == TIM_CLOCKSOURCE_ITR3))
  1279. #define IS_TIM_CLOCKPOLARITY(__POLARITY__) (((__POLARITY__) == TIM_CLOCKPOLARITY_INVERTED) || \
  1280. ((__POLARITY__) == TIM_CLOCKPOLARITY_NONINVERTED) || \
  1281. ((__POLARITY__) == TIM_CLOCKPOLARITY_RISING) || \
  1282. ((__POLARITY__) == TIM_CLOCKPOLARITY_FALLING) || \
  1283. ((__POLARITY__) == TIM_CLOCKPOLARITY_BOTHEDGE))
  1284. #define IS_TIM_CLOCKPRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV1) || \
  1285. ((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV2) || \
  1286. ((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV4) || \
  1287. ((__PRESCALER__) == TIM_CLOCKPRESCALER_DIV8))
  1288. #define IS_TIM_CLOCKFILTER(__ICFILTER__) ((__ICFILTER__) <= 0xFU)
  1289. #define IS_TIM_CLEARINPUT_POLARITY(__POLARITY__) (((__POLARITY__) == TIM_CLEARINPUTPOLARITY_INVERTED) || \
  1290. ((__POLARITY__) == TIM_CLEARINPUTPOLARITY_NONINVERTED))
  1291. #define IS_TIM_CLEARINPUT_PRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV1) || \
  1292. ((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV2) || \
  1293. ((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV4) || \
  1294. ((__PRESCALER__) == TIM_CLEARINPUTPRESCALER_DIV8))
  1295. #define IS_TIM_CLEARINPUT_FILTER(__ICFILTER__) ((__ICFILTER__) <= 0xFU)
  1296. #define IS_TIM_TRGO_SOURCE(__SOURCE__) (((__SOURCE__) == TIM_TRGO_RESET) || \
  1297. ((__SOURCE__) == TIM_TRGO_ENABLE) || \
  1298. ((__SOURCE__) == TIM_TRGO_UPDATE) || \
  1299. ((__SOURCE__) == TIM_TRGO_OC1) || \
  1300. ((__SOURCE__) == TIM_TRGO_OC1REF) || \
  1301. ((__SOURCE__) == TIM_TRGO_OC2REF) || \
  1302. ((__SOURCE__) == TIM_TRGO_OC3REF) || \
  1303. ((__SOURCE__) == TIM_TRGO_OC4REF))
  1304. #define IS_TIM_MSM_STATE(__STATE__) (((__STATE__) == TIM_MASTERSLAVEMODE_ENABLE) || \
  1305. ((__STATE__) == TIM_MASTERSLAVEMODE_DISABLE))
  1306. #define IS_TIM_SLAVE_MODE(__MODE__) (((__MODE__) == TIM_SLAVEMODE_DISABLE) || \
  1307. ((__MODE__) == TIM_SLAVEMODE_RESET) || \
  1308. ((__MODE__) == TIM_SLAVEMODE_GATED) || \
  1309. ((__MODE__) == TIM_SLAVEMODE_TRIGGER) || \
  1310. ((__MODE__) == TIM_SLAVEMODE_EXTERNAL1))
  1311. #define IS_TIM_PWM_MODE(__MODE__) (((__MODE__) == TIM_OCMODE_PWM1) || \
  1312. ((__MODE__) == TIM_OCMODE_PWM2))
  1313. #define IS_TIM_OC_MODE(__MODE__) (((__MODE__) == TIM_OCMODE_TIMING) || \
  1314. ((__MODE__) == TIM_OCMODE_ACTIVE) || \
  1315. ((__MODE__) == TIM_OCMODE_INACTIVE) || \
  1316. ((__MODE__) == TIM_OCMODE_TOGGLE) || \
  1317. ((__MODE__) == TIM_OCMODE_FORCED_ACTIVE) || \
  1318. ((__MODE__) == TIM_OCMODE_FORCED_INACTIVE))
  1319. #define IS_TIM_TRIGGER_SELECTION(__SELECTION__) (((__SELECTION__) == TIM_TS_ITR0) || \
  1320. ((__SELECTION__) == TIM_TS_ITR1) || \
  1321. ((__SELECTION__) == TIM_TS_ITR2) || \
  1322. ((__SELECTION__) == TIM_TS_ITR3) || \
  1323. ((__SELECTION__) == TIM_TS_TI1F_ED) || \
  1324. ((__SELECTION__) == TIM_TS_TI1FP1) || \
  1325. ((__SELECTION__) == TIM_TS_TI2FP2) || \
  1326. ((__SELECTION__) == TIM_TS_ETRF))
  1327. #define IS_TIM_INTERNAL_TRIGGEREVENT_SELECTION(__SELECTION__) (((__SELECTION__) == TIM_TS_ITR0) || \
  1328. ((__SELECTION__) == TIM_TS_ITR1) || \
  1329. ((__SELECTION__) == TIM_TS_ITR2) || \
  1330. ((__SELECTION__) == TIM_TS_ITR3) || \
  1331. ((__SELECTION__) == TIM_TS_NONE))
  1332. #define IS_TIM_TRIGGERPOLARITY(__POLARITY__) (((__POLARITY__) == TIM_TRIGGERPOLARITY_INVERTED ) || \
  1333. ((__POLARITY__) == TIM_TRIGGERPOLARITY_NONINVERTED) || \
  1334. ((__POLARITY__) == TIM_TRIGGERPOLARITY_RISING ) || \
  1335. ((__POLARITY__) == TIM_TRIGGERPOLARITY_FALLING ) || \
  1336. ((__POLARITY__) == TIM_TRIGGERPOLARITY_BOTHEDGE ))
  1337. #define IS_TIM_TRIGGERPRESCALER(__PRESCALER__) (((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV1) || \
  1338. ((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV2) || \
  1339. ((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV4) || \
  1340. ((__PRESCALER__) == TIM_TRIGGERPRESCALER_DIV8))
  1341. #define IS_TIM_TRIGGERFILTER(__ICFILTER__) ((__ICFILTER__) <= 0xFU)
  1342. #define IS_TIM_TI1SELECTION(__TI1SELECTION__) (((__TI1SELECTION__) == TIM_TI1SELECTION_CH1) || \
  1343. ((__TI1SELECTION__) == TIM_TI1SELECTION_XORCOMBINATION))
  1344. #define IS_TIM_DMA_LENGTH(__LENGTH__) (((__LENGTH__) == TIM_DMABURSTLENGTH_1TRANSFER) || \
  1345. ((__LENGTH__) == TIM_DMABURSTLENGTH_2TRANSFERS) || \
  1346. ((__LENGTH__) == TIM_DMABURSTLENGTH_3TRANSFERS) || \
  1347. ((__LENGTH__) == TIM_DMABURSTLENGTH_4TRANSFERS) || \
  1348. ((__LENGTH__) == TIM_DMABURSTLENGTH_5TRANSFERS) || \
  1349. ((__LENGTH__) == TIM_DMABURSTLENGTH_6TRANSFERS) || \
  1350. ((__LENGTH__) == TIM_DMABURSTLENGTH_7TRANSFERS) || \
  1351. ((__LENGTH__) == TIM_DMABURSTLENGTH_8TRANSFERS) || \
  1352. ((__LENGTH__) == TIM_DMABURSTLENGTH_9TRANSFERS) || \
  1353. ((__LENGTH__) == TIM_DMABURSTLENGTH_10TRANSFERS) || \
  1354. ((__LENGTH__) == TIM_DMABURSTLENGTH_11TRANSFERS) || \
  1355. ((__LENGTH__) == TIM_DMABURSTLENGTH_12TRANSFERS) || \
  1356. ((__LENGTH__) == TIM_DMABURSTLENGTH_13TRANSFERS) || \
  1357. ((__LENGTH__) == TIM_DMABURSTLENGTH_14TRANSFERS) || \
  1358. ((__LENGTH__) == TIM_DMABURSTLENGTH_15TRANSFERS) || \
  1359. ((__LENGTH__) == TIM_DMABURSTLENGTH_16TRANSFERS) || \
  1360. ((__LENGTH__) == TIM_DMABURSTLENGTH_17TRANSFERS) || \
  1361. ((__LENGTH__) == TIM_DMABURSTLENGTH_18TRANSFERS))
  1362. #define IS_TIM_DMA_DATA_LENGTH(LENGTH) (((LENGTH) >= 0x1U) && ((LENGTH) < 0x10000U))
  1363. #define IS_TIM_IC_FILTER(__ICFILTER__) ((__ICFILTER__) <= 0xFU)
  1364. #define IS_TIM_SLAVEMODE_TRIGGER_ENABLED(__TRIGGER__) ((__TRIGGER__) == TIM_SLAVEMODE_TRIGGER)
  1365. #define TIM_SET_ICPRESCALERVALUE(__HANDLE__, __CHANNEL__, __ICPSC__) \
  1366. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 |= (__ICPSC__)) :\
  1367. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 |= ((__ICPSC__) << 8U)) :\
  1368. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 |= (__ICPSC__)) :\
  1369. ((__HANDLE__)->Instance->CCMR2 |= ((__ICPSC__) << 8U)))
  1370. #define TIM_RESET_ICPRESCALERVALUE(__HANDLE__, __CHANNEL__) \
  1371. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCMR1 &= ~TIM_CCMR1_IC1PSC) :\
  1372. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCMR1 &= ~TIM_CCMR1_IC2PSC) :\
  1373. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCMR2 &= ~TIM_CCMR2_IC3PSC) :\
  1374. ((__HANDLE__)->Instance->CCMR2 &= ~TIM_CCMR2_IC4PSC))
  1375. #define TIM_SET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__, __POLARITY__) \
  1376. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCER |= (__POLARITY__)) :\
  1377. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCER |= ((__POLARITY__) << 4U)) :\
  1378. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCER |= ((__POLARITY__) << 8U)) :\
  1379. ((__HANDLE__)->Instance->CCER |= (((__POLARITY__) << 12U))))
  1380. #define TIM_RESET_CAPTUREPOLARITY(__HANDLE__, __CHANNEL__) \
  1381. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC1P | TIM_CCER_CC1NP)) :\
  1382. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC2P | TIM_CCER_CC2NP)) :\
  1383. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC3P | TIM_CCER_CC3NP)) :\
  1384. ((__HANDLE__)->Instance->CCER &= ~(TIM_CCER_CC4P | TIM_CCER_CC4NP)))
  1385. #define TIM_CHANNEL_STATE_GET(__HANDLE__, __CHANNEL__)\
  1386. (((__CHANNEL__) == TIM_CHANNEL_1) ? (__HANDLE__)->ChannelState[0] :\
  1387. ((__CHANNEL__) == TIM_CHANNEL_2) ? (__HANDLE__)->ChannelState[1] :\
  1388. ((__CHANNEL__) == TIM_CHANNEL_3) ? (__HANDLE__)->ChannelState[2] :\
  1389. (__HANDLE__)->ChannelState[3])
  1390. #define TIM_CHANNEL_STATE_SET(__HANDLE__, __CHANNEL__, __CHANNEL_STATE__) \
  1391. (((__CHANNEL__) == TIM_CHANNEL_1) ? ((__HANDLE__)->ChannelState[0] = (__CHANNEL_STATE__)) :\
  1392. ((__CHANNEL__) == TIM_CHANNEL_2) ? ((__HANDLE__)->ChannelState[1] = (__CHANNEL_STATE__)) :\
  1393. ((__CHANNEL__) == TIM_CHANNEL_3) ? ((__HANDLE__)->ChannelState[2] = (__CHANNEL_STATE__)) :\
  1394. ((__HANDLE__)->ChannelState[3] = (__CHANNEL_STATE__)))
  1395. #define TIM_CHANNEL_STATE_SET_ALL(__HANDLE__, __CHANNEL_STATE__) do { \
  1396. (__HANDLE__)->ChannelState[0] = (__CHANNEL_STATE__); \
  1397. (__HANDLE__)->ChannelState[1] = (__CHANNEL_STATE__); \
  1398. (__HANDLE__)->ChannelState[2] = (__CHANNEL_STATE__); \
  1399. (__HANDLE__)->ChannelState[3] = (__CHANNEL_STATE__); \
  1400. } while(0)
  1401. /**
  1402. * @}
  1403. */
  1404. /* End of private macros -----------------------------------------------------*/
  1405. /* Include TIM HAL Extended module */
  1406. #include "stm32l0xx_hal_tim_ex.h"
  1407. /* Exported functions --------------------------------------------------------*/
  1408. /** @addtogroup TIM_Exported_Functions TIM Exported Functions
  1409. * @{
  1410. */
  1411. /** @addtogroup TIM_Exported_Functions_Group1 TIM Time Base functions
  1412. * @brief Time Base functions
  1413. * @{
  1414. */
  1415. /* Time Base functions ********************************************************/
  1416. HAL_StatusTypeDef HAL_TIM_Base_Init(TIM_HandleTypeDef *htim);
  1417. HAL_StatusTypeDef HAL_TIM_Base_DeInit(TIM_HandleTypeDef *htim);
  1418. void HAL_TIM_Base_MspInit(TIM_HandleTypeDef *htim);
  1419. void HAL_TIM_Base_MspDeInit(TIM_HandleTypeDef *htim);
  1420. /* Blocking mode: Polling */
  1421. HAL_StatusTypeDef HAL_TIM_Base_Start(TIM_HandleTypeDef *htim);
  1422. HAL_StatusTypeDef HAL_TIM_Base_Stop(TIM_HandleTypeDef *htim);
  1423. /* Non-Blocking mode: Interrupt */
  1424. HAL_StatusTypeDef HAL_TIM_Base_Start_IT(TIM_HandleTypeDef *htim);
  1425. HAL_StatusTypeDef HAL_TIM_Base_Stop_IT(TIM_HandleTypeDef *htim);
  1426. /* Non-Blocking mode: DMA */
  1427. HAL_StatusTypeDef HAL_TIM_Base_Start_DMA(TIM_HandleTypeDef *htim, const uint32_t *pData, uint16_t Length);
  1428. HAL_StatusTypeDef HAL_TIM_Base_Stop_DMA(TIM_HandleTypeDef *htim);
  1429. /**
  1430. * @}
  1431. */
  1432. /** @addtogroup TIM_Exported_Functions_Group2 TIM Output Compare functions
  1433. * @brief TIM Output Compare functions
  1434. * @{
  1435. */
  1436. /* Timer Output Compare functions *********************************************/
  1437. HAL_StatusTypeDef HAL_TIM_OC_Init(TIM_HandleTypeDef *htim);
  1438. HAL_StatusTypeDef HAL_TIM_OC_DeInit(TIM_HandleTypeDef *htim);
  1439. void HAL_TIM_OC_MspInit(TIM_HandleTypeDef *htim);
  1440. void HAL_TIM_OC_MspDeInit(TIM_HandleTypeDef *htim);
  1441. /* Blocking mode: Polling */
  1442. HAL_StatusTypeDef HAL_TIM_OC_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  1443. HAL_StatusTypeDef HAL_TIM_OC_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  1444. /* Non-Blocking mode: Interrupt */
  1445. HAL_StatusTypeDef HAL_TIM_OC_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1446. HAL_StatusTypeDef HAL_TIM_OC_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1447. /* Non-Blocking mode: DMA */
  1448. HAL_StatusTypeDef HAL_TIM_OC_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, const uint32_t *pData,
  1449. uint16_t Length);
  1450. HAL_StatusTypeDef HAL_TIM_OC_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  1451. /**
  1452. * @}
  1453. */
  1454. /** @addtogroup TIM_Exported_Functions_Group3 TIM PWM functions
  1455. * @brief TIM PWM functions
  1456. * @{
  1457. */
  1458. /* Timer PWM functions ********************************************************/
  1459. HAL_StatusTypeDef HAL_TIM_PWM_Init(TIM_HandleTypeDef *htim);
  1460. HAL_StatusTypeDef HAL_TIM_PWM_DeInit(TIM_HandleTypeDef *htim);
  1461. void HAL_TIM_PWM_MspInit(TIM_HandleTypeDef *htim);
  1462. void HAL_TIM_PWM_MspDeInit(TIM_HandleTypeDef *htim);
  1463. /* Blocking mode: Polling */
  1464. HAL_StatusTypeDef HAL_TIM_PWM_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  1465. HAL_StatusTypeDef HAL_TIM_PWM_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  1466. /* Non-Blocking mode: Interrupt */
  1467. HAL_StatusTypeDef HAL_TIM_PWM_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1468. HAL_StatusTypeDef HAL_TIM_PWM_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1469. /* Non-Blocking mode: DMA */
  1470. HAL_StatusTypeDef HAL_TIM_PWM_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, const uint32_t *pData,
  1471. uint16_t Length);
  1472. HAL_StatusTypeDef HAL_TIM_PWM_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  1473. /**
  1474. * @}
  1475. */
  1476. /** @addtogroup TIM_Exported_Functions_Group4 TIM Input Capture functions
  1477. * @brief TIM Input Capture functions
  1478. * @{
  1479. */
  1480. /* Timer Input Capture functions **********************************************/
  1481. HAL_StatusTypeDef HAL_TIM_IC_Init(TIM_HandleTypeDef *htim);
  1482. HAL_StatusTypeDef HAL_TIM_IC_DeInit(TIM_HandleTypeDef *htim);
  1483. void HAL_TIM_IC_MspInit(TIM_HandleTypeDef *htim);
  1484. void HAL_TIM_IC_MspDeInit(TIM_HandleTypeDef *htim);
  1485. /* Blocking mode: Polling */
  1486. HAL_StatusTypeDef HAL_TIM_IC_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  1487. HAL_StatusTypeDef HAL_TIM_IC_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  1488. /* Non-Blocking mode: Interrupt */
  1489. HAL_StatusTypeDef HAL_TIM_IC_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1490. HAL_StatusTypeDef HAL_TIM_IC_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1491. /* Non-Blocking mode: DMA */
  1492. HAL_StatusTypeDef HAL_TIM_IC_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, uint32_t *pData, uint16_t Length);
  1493. HAL_StatusTypeDef HAL_TIM_IC_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  1494. /**
  1495. * @}
  1496. */
  1497. /** @addtogroup TIM_Exported_Functions_Group5 TIM One Pulse functions
  1498. * @brief TIM One Pulse functions
  1499. * @{
  1500. */
  1501. /* Timer One Pulse functions **************************************************/
  1502. HAL_StatusTypeDef HAL_TIM_OnePulse_Init(TIM_HandleTypeDef *htim, uint32_t OnePulseMode);
  1503. HAL_StatusTypeDef HAL_TIM_OnePulse_DeInit(TIM_HandleTypeDef *htim);
  1504. void HAL_TIM_OnePulse_MspInit(TIM_HandleTypeDef *htim);
  1505. void HAL_TIM_OnePulse_MspDeInit(TIM_HandleTypeDef *htim);
  1506. /* Blocking mode: Polling */
  1507. HAL_StatusTypeDef HAL_TIM_OnePulse_Start(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1508. HAL_StatusTypeDef HAL_TIM_OnePulse_Stop(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1509. /* Non-Blocking mode: Interrupt */
  1510. HAL_StatusTypeDef HAL_TIM_OnePulse_Start_IT(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1511. HAL_StatusTypeDef HAL_TIM_OnePulse_Stop_IT(TIM_HandleTypeDef *htim, uint32_t OutputChannel);
  1512. /**
  1513. * @}
  1514. */
  1515. /** @addtogroup TIM_Exported_Functions_Group6 TIM Encoder functions
  1516. * @brief TIM Encoder functions
  1517. * @{
  1518. */
  1519. /* Timer Encoder functions ****************************************************/
  1520. HAL_StatusTypeDef HAL_TIM_Encoder_Init(TIM_HandleTypeDef *htim, const TIM_Encoder_InitTypeDef *sConfig);
  1521. HAL_StatusTypeDef HAL_TIM_Encoder_DeInit(TIM_HandleTypeDef *htim);
  1522. void HAL_TIM_Encoder_MspInit(TIM_HandleTypeDef *htim);
  1523. void HAL_TIM_Encoder_MspDeInit(TIM_HandleTypeDef *htim);
  1524. /* Blocking mode: Polling */
  1525. HAL_StatusTypeDef HAL_TIM_Encoder_Start(TIM_HandleTypeDef *htim, uint32_t Channel);
  1526. HAL_StatusTypeDef HAL_TIM_Encoder_Stop(TIM_HandleTypeDef *htim, uint32_t Channel);
  1527. /* Non-Blocking mode: Interrupt */
  1528. HAL_StatusTypeDef HAL_TIM_Encoder_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1529. HAL_StatusTypeDef HAL_TIM_Encoder_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel);
  1530. /* Non-Blocking mode: DMA */
  1531. HAL_StatusTypeDef HAL_TIM_Encoder_Start_DMA(TIM_HandleTypeDef *htim, uint32_t Channel, uint32_t *pData1,
  1532. uint32_t *pData2, uint16_t Length);
  1533. HAL_StatusTypeDef HAL_TIM_Encoder_Stop_DMA(TIM_HandleTypeDef *htim, uint32_t Channel);
  1534. /**
  1535. * @}
  1536. */
  1537. /** @addtogroup TIM_Exported_Functions_Group7 TIM IRQ handler management
  1538. * @brief IRQ handler management
  1539. * @{
  1540. */
  1541. /* Interrupt Handler functions ***********************************************/
  1542. void HAL_TIM_IRQHandler(TIM_HandleTypeDef *htim);
  1543. /**
  1544. * @}
  1545. */
  1546. /** @defgroup TIM_Exported_Functions_Group8 TIM Peripheral Control functions
  1547. * @brief Peripheral Control functions
  1548. * @{
  1549. */
  1550. /* Control functions *********************************************************/
  1551. HAL_StatusTypeDef HAL_TIM_OC_ConfigChannel(TIM_HandleTypeDef *htim, const TIM_OC_InitTypeDef *sConfig,
  1552. uint32_t Channel);
  1553. HAL_StatusTypeDef HAL_TIM_PWM_ConfigChannel(TIM_HandleTypeDef *htim, const TIM_OC_InitTypeDef *sConfig,
  1554. uint32_t Channel);
  1555. HAL_StatusTypeDef HAL_TIM_IC_ConfigChannel(TIM_HandleTypeDef *htim, const TIM_IC_InitTypeDef *sConfig,
  1556. uint32_t Channel);
  1557. HAL_StatusTypeDef HAL_TIM_OnePulse_ConfigChannel(TIM_HandleTypeDef *htim, TIM_OnePulse_InitTypeDef *sConfig,
  1558. uint32_t OutputChannel, uint32_t InputChannel);
  1559. HAL_StatusTypeDef HAL_TIM_ConfigOCrefClear(TIM_HandleTypeDef *htim,
  1560. const TIM_ClearInputConfigTypeDef *sClearInputConfig,
  1561. uint32_t Channel);
  1562. HAL_StatusTypeDef HAL_TIM_ConfigClockSource(TIM_HandleTypeDef *htim, const TIM_ClockConfigTypeDef *sClockSourceConfig);
  1563. HAL_StatusTypeDef HAL_TIM_ConfigTI1Input(TIM_HandleTypeDef *htim, uint32_t TI1_Selection);
  1564. HAL_StatusTypeDef HAL_TIM_SlaveConfigSynchro(TIM_HandleTypeDef *htim, const TIM_SlaveConfigTypeDef *sSlaveConfig);
  1565. HAL_StatusTypeDef HAL_TIM_SlaveConfigSynchro_IT(TIM_HandleTypeDef *htim, const TIM_SlaveConfigTypeDef *sSlaveConfig);
  1566. HAL_StatusTypeDef HAL_TIM_DMABurst_WriteStart(TIM_HandleTypeDef *htim, uint32_t BurstBaseAddress,
  1567. uint32_t BurstRequestSrc, const uint32_t *BurstBuffer, uint32_t BurstLength);
  1568. HAL_StatusTypeDef HAL_TIM_DMABurst_MultiWriteStart(TIM_HandleTypeDef *htim, uint32_t BurstBaseAddress,
  1569. uint32_t BurstRequestSrc, const uint32_t *BurstBuffer,
  1570. uint32_t BurstLength, uint32_t DataLength);
  1571. HAL_StatusTypeDef HAL_TIM_DMABurst_WriteStop(TIM_HandleTypeDef *htim, uint32_t BurstRequestSrc);
  1572. HAL_StatusTypeDef HAL_TIM_DMABurst_ReadStart(TIM_HandleTypeDef *htim, uint32_t BurstBaseAddress,
  1573. uint32_t BurstRequestSrc, uint32_t *BurstBuffer, uint32_t BurstLength);
  1574. HAL_StatusTypeDef HAL_TIM_DMABurst_MultiReadStart(TIM_HandleTypeDef *htim, uint32_t BurstBaseAddress,
  1575. uint32_t BurstRequestSrc, uint32_t *BurstBuffer,
  1576. uint32_t BurstLength, uint32_t DataLength);
  1577. HAL_StatusTypeDef HAL_TIM_DMABurst_ReadStop(TIM_HandleTypeDef *htim, uint32_t BurstRequestSrc);
  1578. HAL_StatusTypeDef HAL_TIM_GenerateEvent(TIM_HandleTypeDef *htim, uint32_t EventSource);
  1579. uint32_t HAL_TIM_ReadCapturedValue(const TIM_HandleTypeDef *htim, uint32_t Channel);
  1580. /**
  1581. * @}
  1582. */
  1583. /** @defgroup TIM_Exported_Functions_Group9 TIM Callbacks functions
  1584. * @brief TIM Callbacks functions
  1585. * @{
  1586. */
  1587. /* Callback in non blocking modes (Interrupt and DMA) *************************/
  1588. void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim);
  1589. void HAL_TIM_PeriodElapsedHalfCpltCallback(TIM_HandleTypeDef *htim);
  1590. void HAL_TIM_OC_DelayElapsedCallback(TIM_HandleTypeDef *htim);
  1591. void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim);
  1592. void HAL_TIM_IC_CaptureHalfCpltCallback(TIM_HandleTypeDef *htim);
  1593. void HAL_TIM_PWM_PulseFinishedCallback(TIM_HandleTypeDef *htim);
  1594. void HAL_TIM_PWM_PulseFinishedHalfCpltCallback(TIM_HandleTypeDef *htim);
  1595. void HAL_TIM_TriggerCallback(TIM_HandleTypeDef *htim);
  1596. void HAL_TIM_TriggerHalfCpltCallback(TIM_HandleTypeDef *htim);
  1597. void HAL_TIM_ErrorCallback(TIM_HandleTypeDef *htim);
  1598. /* Callbacks Register/UnRegister functions ***********************************/
  1599. #if (USE_HAL_TIM_REGISTER_CALLBACKS == 1)
  1600. HAL_StatusTypeDef HAL_TIM_RegisterCallback(TIM_HandleTypeDef *htim, HAL_TIM_CallbackIDTypeDef CallbackID,
  1601. pTIM_CallbackTypeDef pCallback);
  1602. HAL_StatusTypeDef HAL_TIM_UnRegisterCallback(TIM_HandleTypeDef *htim, HAL_TIM_CallbackIDTypeDef CallbackID);
  1603. #endif /* USE_HAL_TIM_REGISTER_CALLBACKS */
  1604. /**
  1605. * @}
  1606. */
  1607. /** @defgroup TIM_Exported_Functions_Group10 TIM Peripheral State functions
  1608. * @brief Peripheral State functions
  1609. * @{
  1610. */
  1611. /* Peripheral State functions ************************************************/
  1612. HAL_TIM_StateTypeDef HAL_TIM_Base_GetState(const TIM_HandleTypeDef *htim);
  1613. HAL_TIM_StateTypeDef HAL_TIM_OC_GetState(const TIM_HandleTypeDef *htim);
  1614. HAL_TIM_StateTypeDef HAL_TIM_PWM_GetState(const TIM_HandleTypeDef *htim);
  1615. HAL_TIM_StateTypeDef HAL_TIM_IC_GetState(const TIM_HandleTypeDef *htim);
  1616. HAL_TIM_StateTypeDef HAL_TIM_OnePulse_GetState(const TIM_HandleTypeDef *htim);
  1617. HAL_TIM_StateTypeDef HAL_TIM_Encoder_GetState(const TIM_HandleTypeDef *htim);
  1618. /* Peripheral Channel state functions ************************************************/
  1619. HAL_TIM_ActiveChannel HAL_TIM_GetActiveChannel(const TIM_HandleTypeDef *htim);
  1620. HAL_TIM_ChannelStateTypeDef HAL_TIM_GetChannelState(const TIM_HandleTypeDef *htim, uint32_t Channel);
  1621. HAL_TIM_DMABurstStateTypeDef HAL_TIM_DMABurstState(const TIM_HandleTypeDef *htim);
  1622. /**
  1623. * @}
  1624. */
  1625. /**
  1626. * @}
  1627. */
  1628. /* End of exported functions -------------------------------------------------*/
  1629. /* Private functions----------------------------------------------------------*/
  1630. /** @defgroup TIM_Private_Functions TIM Private Functions
  1631. * @{
  1632. */
  1633. void TIM_DMAError(DMA_HandleTypeDef *hdma);
  1634. void TIM_DMACaptureCplt(DMA_HandleTypeDef *hdma);
  1635. void TIM_DMACaptureHalfCplt(DMA_HandleTypeDef *hdma);
  1636. #if (USE_HAL_TIM_REGISTER_CALLBACKS == 1)
  1637. void TIM_ResetCallback(TIM_HandleTypeDef *htim);
  1638. #endif /* USE_HAL_TIM_REGISTER_CALLBACKS */
  1639. /**
  1640. * @}
  1641. */
  1642. /* End of private functions --------------------------------------------------*/
  1643. /**
  1644. * @}
  1645. */
  1646. /**
  1647. * @}
  1648. */
  1649. #ifdef __cplusplus
  1650. }
  1651. #endif
  1652. #endif /* STM32L0xx_HAL_TIM_H */