st-flash - Man Page
Flash binary files to STM32 device
Examples (TL;DR)
- Read 4096 bytes from the device starting from 0x8000000:
st-flash read firmware.bin 0x8000000 4096
- Write firmware to device starting from 0x8000000:
st-flash write firmware.bin 0x8000000
- Erase firmware from device:
st-flash erase
Synopsis
st-flash [Options] {read|write|erase} [FILE] <ADDR> <SIZE>
Description
Flash binary files to arbitrary sections of memory, or read arbitrary addresses of memory out to a binary file.
You can use this instead of st-util(1) if you prefer, but remember to use the .bin image, rather than the .elf file.
Use hexadecimal format for the ADDR and SIZE.
Commands
- write FILE ADDR
Write firmware FILE to device starting from ADDR
- read FILE ADDR SIZE
Read firmware from device starting from ADDR up to SIZE bytes to FILE
- erase
Perform a mass erasing of the device firmware
- reset
Reset the target
Options
- --version
Print version information
- --debug
TODO
- --reset
Trigger a reset both before and after flashing
- --opt
Enable ignore ending empty bytes optimization
- --serial iSerial
TODO
- --flash=fsize
Where fsize is the size in decimal, octal, or hex followed by an optional multiplier `k' for KB, or `m' for MB. Use a leading ā0xā to specify hexadecimal, or a leading zero for octal.
Examples
Flash firmware.bin
to device
$ st-flash write firmware.bin 0x8000000
Read firmware from device (4096 bytes)
$ st-flash read firmware.bin 0x8000000 0x1000
Erase firmware from device
$ st-flash erase
See Also
Copyright
This work is copyrighted. Stlink contributors. See LICENSE file in the stlink source distribution.