{"id":3145,"date":"2017-09-12T22:40:09","date_gmt":"2017-09-13T05:40:09","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=3145"},"modified":"2017-09-12T22:40:09","modified_gmt":"2017-09-13T05:40:09","slug":"using-the-stm32-uart-interface-with-hal","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/arm\/stm32\/uart\/hal\/","title":{"rendered":"Using the STM32 UART interface with HAL"},"content":{"rendered":"

This tutorial shows how to use the STM32 UART interface in different modes using the HAL libraries. We will show how to use direct mode, interrupt-based mode and DMA-controlled mode and will use a logic analyzer to compare the precise timings of various events.<\/p>\n

Before you begin, install VisualGDB 5.2 or later.<\/p>\n

    \n
  1. Start Visual Studio and open VisualGDB Embedded Project Wizard:\"01-newprj\"<\/a><\/li>\n
  2. Select “Create a new project with MSBuild -> Embedded Binary”:\"02-msbuild\"<\/a><\/li>\n
  3. On the next page select your STM32 device. We will use the Nucleo-F410RB board that has the STM32F410RB chip:\"03-device\"<\/a><\/li>\n
  4. Proceed with the default “LEDBlink (HAL)” sample:\"04-sample\"<\/a><\/li>\n
  5. Connect your board to USB and let VisualGDB automatically recognize it and configure debug settings:\"05-debug\"<\/a><\/li>\n
  6. Press “Finish” to create the project. We will begin with a simple program that will read bytes via UART and echo them back in groups of 4. This requires four steps:\n
      \n
    1. Enabling the clocks for the UART and GPIO peripherals.<\/li>\n
    2. Configuring the GPIO pins corresponding to UART to actually act as UART pins (as opposed to manually controlled GPIO) pins.<\/li>\n
    3. Initializing the UART module by specifying the operating parameters.<\/li>\n
    4. Actually reading and writing the data.<\/li>\n<\/ol>\n

      Replace the code in your main source file with the following:<\/p>\n

       <\/p>\n

      #include <stm32f4xx_hal.h>\r\n#include <stm32_hal_legacy.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 UART_HandleTypeDef s_UARTHandle = UART_HandleTypeDef();\r\n\r\nint main(void)\r\n{\r\n\u00a0\u00a0 \u00a0HAL_Init();\r\n\r\n\u00a0\u00a0\u00a0 __USART2_CLK_ENABLE();\r\n\u00a0\u00a0\u00a0 __GPIOA_CLK_ENABLE();\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 GPIO_InitTypeDef GPIO_InitStructure;\r\n\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Pin = GPIO_PIN_2;\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Mode = GPIO_MODE_AF_PP;\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Alternate = GPIO_AF7_USART2;\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(GPIOA, &GPIO_InitStructure);\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Pin = GPIO_PIN_3;\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Mode = GPIO_MODE_AF_OD;\r\n\u00a0\u00a0\u00a0 HAL_GPIO_Init(GPIOA, &GPIO_InitStructure);\r\n\r\n\u00a0\u00a0\u00a0 s_UARTHandle.Instance\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 = USART2;\r\n\u00a0\u00a0\u00a0 s_UARTHandle.Init.BaudRate\u00a0\u00a0 = 115200;\r\n\u00a0\u00a0\u00a0 s_UARTHandle.Init.WordLength = UART_WORDLENGTH_8B;\r\n\u00a0\u00a0\u00a0 s_UARTHandle.Init.StopBits\u00a0\u00a0 = UART_STOPBITS_1;\r\n\u00a0\u00a0\u00a0 s_UARTHandle.Init.Parity\u00a0\u00a0\u00a0\u00a0 = UART_PARITY_NONE;\r\n\u00a0\u00a0\u00a0 s_UARTHandle.Init.HwFlowCtl\u00a0 = UART_HWCONTROL_NONE;\r\n\u00a0\u00a0\u00a0 s_UARTHandle.Init.Mode\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 = UART_MODE_TX_RX;\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 if (HAL_UART_Init(&s_UARTHandle) != HAL_OK)\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 asm(\"bkpt 255\");\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 for (;;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 uint8_t buffer[4];\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_UART_Receive(&s_UARTHandle, buffer, sizeof(buffer), HAL_MAX_DELAY);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_UART_Transmit(&s_UARTHandle, buffer, sizeof(buffer), HAL_MAX_DELAY);\r\n\u00a0\u00a0\u00a0 }\r\n}<\/pre>\n<\/li>\n
    5. We are using UART2 and pins PA2 and PA3 as the Nucleo-F410RB board has them connected to the on-board ST-Link UART interface, so we can use a terminal to interact with the board. You can find the GPIO pin numbers and the alternate function numbers corresponding to the UART interface on your device by searching the datasheet for the Alternate Function Mapping section:\"aftable\"<\/a>For STM32F410RB connecting UART2 to pins PA2 and PA3 requires enabling alternate function #7.<\/li>\n
    6. Build the code by pressing Ctrl-Shift-B:\"06-build\"<\/a><\/li>\n
    7. You can use a terminal program to talk to your STM32 board over the UART interface. If you are using VisualGDB Custom Edition, simply enable the Raw Terminal in VisualGDB Project Properties and it will show a terminal window inside the Visual Studio window: \"07-terminal\"<\/a><\/li>\n
    8. Press F5 to start debugging. Try typing some text in the terminal window and see how after every 4 characters the program echoes them back:\"08-echo\"<\/a><\/li>\n
    9. Now we will explore the UART timings using a logic analyzer. First of all, modify your code to continuously output “test\\r\\n” and use GPIOC10 to signal the lifetime of the HAL_UART_Transmit()<\/strong> function:\n
      \u00a0\u00a0\u00a0 __GPIOC_CLK_ENABLE();\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Pin = GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_12;\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Mode = GPIO_MODE_OUTPUT_PP;\r\n\u00a0\u00a0\u00a0 HAL_GPIO_Init(GPIOC, &GPIO_InitStructure);\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 for (;;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 char buffer[] = \"test\\r\\n\";\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_10, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_UART_Transmit(&s_UARTHandle, buffer, sizeof(buffer), HAL_MAX_DELAY);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_10, GPIO_PIN_RESET);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_Delay(2);\r\n\u00a0\u00a0\u00a0 }<\/pre>\n<\/li>\n
    10. We will use Analyzer2Go<\/a> to turn another STM32 board into a full-featured logic analyzer. Connect your second board to your computer, start Analyzer2Go and select the board type: \"09-a2go\"<\/a><\/li>\n
    11. Connect the following signals between the boards:
      \n\n\n\n\n\n\n
      Signal<\/td>\nBoard running firmware<\/td>\nBoard running logic analyzer<\/td>\n<\/tr>\n
      Ground<\/td>\nGND<\/td>\nGND<\/td>\n<\/tr>\n
      UART output<\/td>\nTX<\/td>\nAny of the supported inputs<\/td>\n<\/tr>\n
      HAL_UART_Transmit()<\/strong> lifetime indicator<\/td>\nPC10<\/td>\nAny of the supported inputs<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
      \"2boards\"<\/a><\/li>\n
    12. Enable the connected signals in Analyzer2go to begin watching them. See how the HAL_UART_Transmit()<\/strong> function (red) is active during the entire transmission (blue):\"10-capture\"<\/a><\/li>\n
    13. Press the “Record” button to record several packets in a\u00a0 row. Then stop recording and zoom into one of them:\"12-zoomed\"<\/a><\/li>\n
    14. In order to automatically decode the UART bytes, open the Protocol Analyzers tab, drag\/drop the UART analyzer and connect it to the corresponding signal:\"13-parsed\"<\/a><\/li>\n
    15. You can analyze the raw encoding of the UART signals by selecting the decoded characters and creating notes for some of them:\"14-note\"<\/a><\/li>\n
    16. Then switch to the “Raw” view to see the signal shape. You can click the “set clock period” button to highlight individual zeroes and ones:\"15-period\"<\/a><\/li>\n
    17. The ‘t’ character was encoded as 0 0010 1110 1, which corresponds to a start bit (0) followed by a value of 0x74 (ASCII code for ‘t’) followed by a stop bit (1):\"16-data\"<\/a><\/li>\n
    18. Try changing the stop bit amount to 2:\n
      \u00a0\u00a0\u00a0 s_UARTHandle.Init.StopBits\u00a0\u00a0 = UART_STOPBITS_2;<\/pre>\n
      See how the stop bit is now twice longer:\"17-2stopbits\"<\/a><\/li>\n
    19. Although calling HAL_UART_Transmit() for every transmission is simple, it has one major disadvanrage. While the transmission is active, the program cannot do anything else and has to wait for it to complete. We will now use the interrupt-based transmission to free up some of the CPU cycles. Replace the code in your main source file with this:\n
      #include <stm32f4xx_hal.h>\r\n#include <stm32_hal_legacy.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 UART_HandleTypeDef s_UARTHandle = UART_HandleTypeDef();\r\n\r\nextern \"C\" void USART2_IRQHandler()\r\n{\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_12, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0 HAL_UART_IRQHandler(&s_UARTHandle);\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_12, GPIO_PIN_RESET);\r\n}\r\n\r\nvoid HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)\r\n{\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_11, GPIO_PIN_RESET);\r\n}\r\n\r\nint main(void)\r\n{\r\n\u00a0\u00a0 \u00a0HAL_Init();\r\n\r\n\u00a0\u00a0 \u00a0\/\/ <Initialize UART and GPIO as before>\r\n\r\n\u00a0\u00a0\u00a0 __GPIOC_CLK_ENABLE();\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Pin = GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_12;\r\n\u00a0\u00a0\u00a0 GPIO_InitStructure.Mode = GPIO_MODE_OUTPUT_PP;\r\n\u00a0\u00a0\u00a0 HAL_GPIO_Init(GPIOC, &GPIO_InitStructure);\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 NVIC_EnableIRQ(USART2_IRQn);\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 for (;;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 char buffer[] = \"test\\r\\n\";\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_10 | GPIO_PIN_11, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_12, GPIO_PIN_RESET);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_UART_Transmit_IT(&s_UARTHandle, (uint8_t *)buffer, sizeof(buffer));\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_10, GPIO_PIN_RESET);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HAL_Delay(2);\r\n\u00a0\u00a0\u00a0 }\r\n}<\/pre>\n
      Don’t forget to copy the previous initialization code for UART and GPIO.<\/li>\n
    20. Set a breakpoint in HAL_UART_TxCpltCallback()<\/strong>, start debugging and wait for it to trigger. Then check the call stack:\"stack\"<\/a>You can see how the UART interrupt got invoked when the main() function was already running HAL_Delay(). The USART2_IRQHandler()<\/strong> handler called the HAL_UART_IRQHandler()<\/strong> and the HAL_UART_IRQHandler()<\/strong> in turn called the HAL_UART_TxCpltCallback()<\/strong> once it determined that the last byte got transmitted.<\/li>\n
    21. Remove the breakpoint and restart the program. Then add the C11 and C12 signals to Analyzer2Go and make another recording. Note how the HAL_UART_Transmit_IT()<\/strong> function returns immediately (red) and the interrupt handler (green) is called after each byte is queued for transmission. Finally, the HAL_UART_TxCpltCallback()<\/strong> (orange signal switching to 0) is called once the last byte was physically sent:\"18-isrmode\"<\/a><\/li>\n
    22. Most of the time during the transmission the CPU will be able to run code unrelated to the transmission. It will only be interrupted by occasional UART interrupts. You can measure the overhead of the UART interrupts by comparing the byte transmission period to the width of the ‘ISR’ pulse. For STM32F410RB the overhead is 12 out of 96 microseconds (12.5%) regardless of the buffer size:\"19-usage\"<\/a><\/li>\n
    23. In order to reduce the interrupt-related overhead, we will show switch UART to use DMA (direct memory access). In this mode the DMA controller will automatically feed the entire buffer to the UART byte-by-byte and only raise an interrupt once the entire buffer is sent.\u00a0 Add the following static variable:\n
      static DMA_HandleTypeDef s_DMAHandle = DMA_HandleTypeDef();<\/pre>\n
      Then replace the code below the code initializing GPIOC with the following:<\/p>\n
      \u00a0\u00a0\u00a0 __DMA1_CLK_ENABLE();\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Instance = DMA1_Stream6;\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.Channel = DMA_CHANNEL_4;\r\n\u00a0 \r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.Direction = DMA_MEMORY_TO_PERIPH;\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.PeriphInc = DMA_PINC_DISABLE;\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.MemInc = DMA_MINC_ENABLE;\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.Mode = DMA_CIRCULAR;\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.Priority = DMA_PRIORITY_VERY_HIGH;\r\n\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE;\r\n\u00a0\u00a0\u00a0 s_DMAHandle.Init.MemDataAlignment = DMA_PDATAALIGN_BYTE;\r\n\r\n\u00a0\u00a0\u00a0 if (HAL_DMA_Init(&s_DMAHandle) != HAL_OK)\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 asm(\"bkpt 255\");\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 __HAL_LINKDMA(&s_UARTHandle, hdmatx, s_DMAHandle);\r\n\u00a0\u00a0\u00a0 NVIC_EnableIRQ(DMA1_Stream6_IRQn);\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_10, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0 HAL_UART_Transmit_DMA(&s_UARTHandle, (uint8_t *)s_Buffer, sizeof(s_Buffer));\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 for (;;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0 }<\/pre>\n
      Remove the UART interrupt handler and add the DMA interrupt handler and 2 UART callbacks:<\/p>\n
      extern \"C\" void DMA1_Stream6_IRQHandler()\r\n{\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_12, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0 HAL_DMA_IRQHandler(&s_DMAHandle);\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_12, GPIO_PIN_RESET);\r\n}\r\n\r\nvoid HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)\r\n{\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_10, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_10, GPIO_PIN_RESET);\r\n}\r\n\r\nvoid HAL_UART_TxHalfCpltCallback(UART_HandleTypeDef *huart)\r\n{\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_11, GPIO_PIN_SET);\r\n\u00a0\u00a0\u00a0 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_11, GPIO_PIN_RESET);\r\n}<\/pre>\n
      Note that different devices have different DMA channel and stream numbers assigned to UART. Use the DMA Request Mapping table in your device’s reference manual (not datasheet) to get the correct numbers:\"dma\"<\/a><\/li>\n
    24. Start the program and ensure you still can see the stream of ‘test’ messages:\"20-dmarun\"<\/a><\/li>\n
    25. Go back to Analyzer2Go and and check the timing. See how now the DMA interrupt is only called twice per the entire transmission (once for each half of the buffer):\"21-dma\"<\/a>If you measure the interrupt overhead now you should get 41 microseconds out of 670 (for the entire packet) or ~6%. The DMA interrupt overhead also doesn’t scale up when you increase buffer size, so sending 70 bytes in a packet instead of 7 would reduce the overhead to 0.6%.<\/li>\n
    26. Having a separate callback for each half of the buffer allows implementing double-buffering. While the DMA is transferring the first half of the buffer, you program could fill the second part with the next frame and vice versa. The same technique would also work for other DMA-capable peripherals, such as SPI (see the SPI tutorial<\/a> for more details).<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
      This tutorial shows how to use the STM32 UART interface in different modes using the HAL libraries. We will show<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[16],"tags":[61,70],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3145"}],"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=3145"}],"version-history":[{"count":7,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3145\/revisions"}],"predecessor-version":[{"id":3229,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/3145\/revisions\/3229"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=3145"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=3145"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=3145"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}