How can semihosting be used when debugging STM32 devices with STM32CubeIDE?
An example using semihosting with Nucleo-STM32F401 board and OpenOCD.
-
Summary
-
Using semihosting with STM32CubeIDE
Note1: ST-LINK GDB server does not support semihosting!
Note2: Please consult SEGGER documentation if semihosting with SEGGER J-LINK is preferred.
-
Update STM32CubeIDE project
-
Remove default syscalls.c
-
-
-
Update main.c
-
#include <stdio.h> extern void initialise_monitor_handles(void);
Add a call to initialise_monitor_handles() function in the beginning of main() function and some variables to be used for semihosting.
int main(void)
{
/* USER CODE BEGIN 1 */
initialise_monitor_handles();
char s[50];
char *p;
FILE *fp;
p=s;
Add some semihosting commands into main() function. Example: Using scanf, printf, fopen, fclose, and fprintf.
/* Infinite loop */
/* USER CODE BEGIN WHILE */
printf("Hello, World!\n");
fp=fopen("c:\\dev\\mytest.txt", "w");
while (1)
{
printf("Enter string:\n");
scanf("%s", p);
printf("\nReceived string: ");
printf(p);
printf("\n");
fprintf(fp,p);
fprintf(fp,"\n");
fclose(fp);
HAL_Delay(500);
fp=fopen("c:\\dev\\mytest.txt", "a");
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
}
-
-
Update GCC Linker configuration
-
In Miscellaneous add Other flags “-specs=rdimon.specs”
-
-
Build
-
-
Debug with semihosting
-
Create/Update OpenOCD debug configuration
-
Note: ST-LINK GDB server does not support semihosting.
Add “monitor arm semihosting enable” initialization command in Debug Configurations - Startup tab.
-
-
Debug
-
Example: Entering “TEST” and “123456”
Open On-Chip Debugger 0.10.0+dev-01288-g7491fb4 (2020-10-27-17:36) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html Info : Listening on port 6666 for tcl connections Info : Listening on port 4444 for telnet connections Info : STLINK V2J37M26 (API v2) VID:PID 0483:374B Info : Target voltage: 3.244649 .. .. semihosting is enabled target halted due to debug-request, current mode: Thread xPSR: 0x01000000 pc: 0x08000860 msp: 0x20018000, semihosting configuring PLL Info : Unable to match requested speed 8000 kHz, using 4000 kHz Info : Unable to match requested speed 8000 kHz, using 4000 kHz Info : Padding image section 0 at 0x08000194 with 12 bytes target halted due to debug-request, current mode: Thread xPSR: 0x01000000 pc: 0x08000a04 msp: 0x20018000, semihosting Hello, World! Enter string: TEST Received string: TEST Enter string: 123456 Received string: 123456 Enter string:Stop the debug session to analyze the log file.
-
Analyze debug session
