stm32l1xx_hal_tim.h 65 KB

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