{"id":1756,"date":"2016-03-31T12:22:11","date_gmt":"2016-03-31T19:22:11","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=1756"},"modified":"2016-03-31T12:22:11","modified_gmt":"2016-03-31T19:22:11","slug":"controlling-stm32-hardware-timers-using-hal","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/arm\/stm32\/timers\/hal\/","title":{"rendered":"Controlling STM32 Hardware Timers using HAL"},"content":{"rendered":"

This tutorial shows how to use the STM32 hardware timers via the STM32 HAL API. If you want to use them with the legacy StdPeriph library, follow this tutorial<\/a> instead.<\/p>\n

Before you begin, ensure that you can build and debug embedded projects for your STM32 board by following one of our basic STM32 tutorials<\/a>.<\/p>\n

    \n
  1. Before we can start configuring the timer, we’ll give a brief overview how the timers work. Hardware timers keep counting up or down depending on the module until the timer period is reached. Then the timer is reset:\"\"<\/a><\/li>\n
  2. We will use the timer to keep our LED on 80% of the time by setting a period of 500, turning it on when the counter reaches 400 and turning it off when it reaches 500:\"\"<\/a><\/li>\n
  3. Create a basic HAL-based LEDBlink project for your board if you have not done that already. Then we will begin with configuring the timer. This is done by calling __TIMx_CLK_ENABLE(),\u00a0 filling the fields of the Init<\/strong> member in the TIM_HandleTypeDef<\/strong> structure and calling HAL_TIM_Base_Init() and HAL_TIM_Base_Start():\n
    \u00a0\u00a0\u00a0 __TIM2_CLK_ENABLE();\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.Prescaler = 40000;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.CounterMode = TIM_COUNTERMODE_UP;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.Period = 500;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.RepetitionCounter = 0;\r\n\u00a0\u00a0\u00a0 HAL_TIM_Base_Init(&s_TimerInstance);\r\n\u00a0\u00a0\u00a0 HAL_TIM_Base_Start(&s_TimerInstance);<\/pre>\n<\/li>\n
  4. From the main() function we can get the current timer value using the __HAL_TIM_GET_COUNTER() macro and update the LED accordingly. The main source file will look the following way:\n
    #include <stm32f4xx_hal.h>\r\n\r\n#ifdef __cplusplus\r\nextern \"C\"\r\n#endif\r\nvoid SysTick_Handler(void)\r\n{\r\n\u00a0\u00a0 \u00a0HAL_IncTick();\r\n\u00a0\u00a0 \u00a0HAL_SYSTICK_IRQHandler();\r\n}\r\n\r\nstatic TIM_HandleTypeDef s_TimerInstance = { \r\n\u00a0\u00a0\u00a0 .Instance = TIM2\r\n};\r\n\r\nvoid InitializeTimer()\r\n{\r\n\u00a0\u00a0\u00a0 __TIM2_CLK_ENABLE();\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.Prescaler = 40000;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.CounterMode = TIM_COUNTERMODE_UP;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.Period = 500;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;\r\n\u00a0\u00a0\u00a0 s_TimerInstance.Init.RepetitionCounter = 0;\r\n\u00a0\u00a0\u00a0 HAL_TIM_Base_Init(&s_TimerInstance);\r\n\u00a0\u00a0\u00a0 HAL_TIM_Base_Start(&s_TimerInstance);\r\n}\r\n\r\nvoid InitializeLED()\r\n{\r\n\u00a0\u00a0\u00a0 __GPIOD_CLK_ENABLE();\r\n\u00a0\u00a0\u00a0 GPIO_InitTypeDef GPIO_InitStructure;\r\n\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Pin = GPIO_PIN_12;\r\n\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Mode = GPIO_MODE_OUTPUT_PP;\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Speed = GPIO_SPEED_HIGH;\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Pull = GPIO_NOPULL;\r\n\u00a0\u00a0\u00a0 HAL_GPIO_Init(GPIOD, &GPIO_InitStructure);\r\n}\r\n\r\nint main(void)\r\n{\r\n\u00a0\u00a0 \u00a0HAL_Init();\r\n\u00a0\u00a0\u00a0 InitializeLED();\r\n\u00a0\u00a0\u00a0 InitializeTimer();\r\n\r\n\u00a0\u00a0\u00a0 for (;;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 int timerValue = __HAL_TIM_GET_COUNTER(&s_TimerInstance);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (timerValue == 400)\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOD, GPIO_PIN_12, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (timerValue == 500)\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOD, GPIO_PIN_12, GPIO_PIN_RESET);\r\n\u00a0\u00a0\u00a0 }\r\n}<\/pre>\n<\/li>\n
  5. Run the program and notice how the LED starts blinking. You can use the Preprocess Selected Lines command to see that the __HAL_TIM_GET_COUNTER() simply reads the CNT register of the timer:\"timer\"<\/a><\/li>\n
  6. If you change timerValue to be a static variable, you can use the Live Variables to plot how the value is changing over time following the TIM2->CNT value:\"live\"<\/a><\/li>\n
  7. You can also configure the timer to automatically generate the ‘update’ events once the value reaches the period value. This can be done by replacing a call to HAL_TIM_Base_Start() with HAL_TIM_Base_Start_IT():\n
    \u00a0\u00a0\u00a0 HAL_TIM_Base_Start_IT(&s_TimerInstance);<\/pre>\n<\/li>\n
  8. From the main() function you can check the status of the ‘Update’ interrupt and toggle the LED state when the update happens:\n
    \u00a0\u00a0\u00a0 for (;;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (__HAL_TIM_GET_FLAG(&s_TimerInstance, TIM_FLAG_UPDATE) != RESET)\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 __HAL_TIM_CLEAR_IT(&s_TimerInstance, TIM_IT_UPDATE);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_TogglePin(GPIOD, GPIO_PIN_12);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }\r\n\u00a0\u00a0\u00a0 }<\/pre>\n
    If you run the program now, you will see how the LED changes its state every 500 timer cycles.<\/li>\n
  9. The good thing about the timer interrupts is that you actually don’t need to check their status manually. As long as you enable the interrupt by calling HAL_NVIC_EnableIRQ(), the timer will automatically trigger an interrupt handler function when the event occurs. You can look up the interrupt function name in the startup_stm32xxxx.c file:\"handler\"<\/a><\/li>\n
  10. The easiest way to write the interrupt handler is to simply call HAL_TIM_IRQHandler() from it. The handler provided by HAL will automatically check which event caused the interrupt and invoke one of the specialized handlers like HAL_TIM_PeriodElapsedCallback(). Add the following code to your main file to try that out:\n
    extern \"C\" void TIM2_IRQHandler()\r\n{\r\n\u00a0\u00a0\u00a0 HAL_TIM_IRQHandler(&s_TimerInstance);\r\n}\r\n\r\nvoid HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)\r\n{\r\n\u00a0\u00a0\u00a0 HAL_GPIO_TogglePin(GPIOD, GPIO_PIN_12);\r\n}\r\n\r\nint main(void)\r\n{\r\n\u00a0\u00a0 \u00a0HAL_Init();\r\n\u00a0\u00a0\u00a0 InitializeLED();\r\n\u00a0\u00a0\u00a0 InitializeTimer();\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 HAL_NVIC_SetPriority(TIM2_IRQn, 0, 0);\r\n\u00a0\u00a0\u00a0 HAL_NVIC_EnableIRQ(TIM2_IRQn);\r\n\r\n\u00a0\u00a0\u00a0 for (;;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0 }\r\n}<\/pre>\n
    Note that the main() function does not need to do anything with the timer anymore and can simply handle the rest of your application’s logic.<\/li>\n
  11. You can visualize what happens when the interrupt is triggered by adding an indicator variable and toggling it from the callback function (a value of 250 is chosen to scale good with the timer counter range):\n
    int g_Indicator;\r\n\r\nvoid HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)\r\n{\r\n\u00a0\u00a0\u00a0 HAL_GPIO_TogglePin(GPIOD, GPIO_PIN_12);\r\n\u00a0\u00a0\u00a0 g_Indicator = g_Indicator ? 0 : 250;\r\n}<\/pre>\n<\/li>\n
  12. Simply add both timer counter and the g_Indicator to live variables and observe how the indicator variable is changed each time the timer gets reset:\"ind\"<\/a><\/li>\n
  13. If you set a breakpoint at the HAL_TIM_PeriodElapsedCallback() function, you can see how it’s called by the HAL_TIM_IRQHandler() as a result of the timer 2 interrupt handler being invoked:\"stack\"<\/a><\/li>\n
  14. You can use the Code Map to quickly explore what other event handlers the HAL_TIM_IRQHandler() method invokes:\"cb\"<\/a><\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to use the STM32 hardware timers via the STM32 HAL API. If you want to use<\/p>\n","protected":false},"author":1,"featured_media":1763,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[16],"tags":[53,61,68],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/1756"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=1756"}],"version-history":[{"count":1,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/1756\/revisions"}],"predecessor-version":[{"id":1764,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/1756\/revisions\/1764"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media\/1763"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=1756"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=1756"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=1756"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}