How to redirect the printf function to a UART for debug messages
1. Introduction
The ST-LINKs embedded on ST Nucleo boards have a virtual com port feature, and we can easily get debugging information on a terminal using printf redirected to the UART of the STM32 connected to the ST-LINK pins used for the virtual COM port.In this article I will show you how to redirect the printf output to the STM32 UART peripheral that is connected to the UART pins on the embedded ST-Link that will be transmitted to the host computer and displayed via a windows terminal program, Tera Term.
2. Pre-requisite
- Hardware:
- Micro USB cable: in order to power and program the board
- Nucleo-G070RB
- Software
- STM32CubeIDE
3. Theory
On the Nulceo-G070RB board, the embedded ST-LINK/V2 is connected to PA2 (UART TX) and PA3 (UART RX) of the target STM32G070 device. These port pins have USART2 alternate functions. printf will be redirected to use PA2 and PA3. We will then use a Terminal connected to the Virtual COM port of the ST-LINK of the Nucleo board to display the printf messages.
4. Steps
- Open STM32CubeIDE
- Create a new project using the NUCLEO-G070RB board
- Give a name to the project
- For this example, the project will be named, “Printf”.
- Initialize all peripherals with their default settings:
- To do this, click on “Yes”.
- Make sure USART2 has been selected, configured, and mapped to PA2 and PA3 as shown below:
- By default, this was configured when starting the project from the Nucleo board that was selected.
- First make sure USART2 is activated as shown here:
- It should be configured in Asynchronous mode with the following settings as shown below in the red rectangles:
- Make sure the USART2 alternate functions have been mapped to PA2 and P3 which are connected to the TX and RX pins (respectively) of the ST-LINK on the Nucleo board.
- Generate Code
- Saving the project will generate the code.
- Add code to toggle the LED:
- This code will redirect the output of the printf function to the USART2. printf function is calling fputc to transmit the output via the USART.
- In main.c, add the following code:
/* USER CODE BEGIN PFP */
#define PUTCHAR_PROTOTYPE int __io_putchar(int ch)
/* USER CODE END PFP */
…
/* USER CODE BEGIN WHILE */
while (1)
{
printf("Hello World\n\r");
HAL_Delay(1000);
/* USER CODE END WHILE */
…
/* USER CODE BEGIN 4 */
/**
* @brief Retargets the C library printf function to the USART.
* @param None
* @retval None
*/
PUTCHAR_PROTOTYPE
{
/* Place your implementation of fputc here */
/* e.g. write a character to the USART1 and Loop until the end of transmission */
HAL_UART_Transmit(&huart2, (uint8_t *)&ch, 1, 0xFFFF);
return ch;
}
/* USER CODE END 4 */
- Build the project, enter debug mode and run the code
- First enter Debug session:
- Then Execute the code:
- Now open a Terminal application like TeraTerm
- Configure the serial port connection to the ST-LINK Virtual COM port.
- Select the following settings:
- You will now see the printf message, “Hello World”, being displayed every second.
5. Links
STM32G0 - DatasheetSTM32G0x0 advanced Arm®-based 32-bit MCUs - Reference manual
STM32CubeIDE - Integrated Development Environment for STM32 - STMicroelectronics
NUCLEO-G070RB - STM32 Nucleo-64 development board with STM32G070RB MCU, supports Arduino and ST morpho connectivity - STMicroelectronics
Tera Term
https://www.st.com/en/evaluation-tools/stm32f4discovery.html
It is showing as Virtual COM port is supported..
Please look that and confirm.
And what is SWD. Please explain.
