stlink-org/stlink
Stlink
stlink is a toolset for ARM Cortex-M flashing, firmware management, and debug server operations, with specific support for STM32 microcontrollers. It provides an ARM Cortex-M flash programmer for writing binary and hex files, an ITM trace logger for real-time instrumentation data, and a SWD/JTAG debug server.
The project includes a graphical user interface for managing MCU firmware and exporting memory, as well as a remote server that allows external debuggers to control execution and inspect registers on target hardware.
The toolset covers microcontroller memory management through flash erasure and option byte configuration, as well as system observability via semihosting and execution trace recording. It also provides utilities for chip information extraction and device resets.
Features
- Firmware Flashing - Provides core functionality to write binary or hex files directly to the flash memory of supported microcontrollers.
- STM32 Target Programming - Provides a comprehensive toolset for flashing firmware and managing memory specifically for STM32 microcontrollers.
- Flash Memory Access - Provides low-level interfaces for reading, writing, and erasing raw flash memory on target microcontrollers.
- Flash Memory Erasing Tools - Provides a function to perform a mass erase of the microcontroller's flash memory to remove existing firmware.
- Command Line Interfaces - Ships a suite of standalone command-line utilities for flashing, erasing, and querying microcontroller hardware.
- GDB Server Implementations - Implements a GDB remote serial protocol server to allow external debuggers to control target hardware execution.
- Toolchain Debugging Servers - Implements a remote server that allows external debuggers to control execution and inspect registers via SWD/JTAG.
- Embedded Firmware Development - Supports the iterative development of ARM Cortex firmware through integrated flashing and device reset capabilities.
- Serial Wire Debug Probes - Provides a Serial Wire Debug (SWD) interface to manage microcontroller memory and processor state.
- Microcontroller Flash Programmers - Ships a programmer for writing binary and hex files to ARM Cortex-M based microcontroller flash memory.
- Embedded Systems Debugging - Enables low-level analysis, register inspection, and execution control for ARM Cortex-M microcontrollers.
- USB Device Communication - Implements low-level USB communication to transfer data and commands between the host computer and the programmer board.
- Flash Address Mapping - Provides the mechanism to translate raw binaries into specific memory address writes for the target microcontroller.
- Flash Memory Exports - Implements a process for reading the contents of microcontroller flash memory and saving the data to a host file.
- Graphical Flashing Interfaces - Provides a graphical user interface for flashing binaries and exporting memory from connected programmers.
- Option Byte Configurations - Allows reading and modifying device configuration bytes that control hardware options and boot behaviors.
- Programmer Management Interfaces - Ships a graphical user interface for connecting to programmers, flashing binaries, and viewing device memory address maps.
- Semihosting Interfaces - Implements semihosting to redirect microcontroller input and output to the host terminal for simplified logging.
- Semihosting Redirections - Intercepts microcontroller system calls to redirect input and output to the host terminal for simplified debugging.
- Instrumentation Trace Streaming - Captures real-time instrumentation data from the target chip and streams it back to the host via ITM.
- Real-Time Trace Collectors - Implements real-time collection and streaming of trace packets from the microcontroller to the host.
- Hardware Reset Triggers - Provides a mechanism to trigger hardware-level reboots of the target microcontroller to initialize the system.
- Execution Tracing - Records the sequence of operations and execution flow on the target device for troubleshooting.
- Remote Debug Execution Control - Provides the capability to control and inspect code execution on a target device using a remote debugging interface.
