st-flash(1)

💖 st-flash — the manual page, bestie edition 💖

okay so this is st-flash, and it lives in the stlink manual family. literally what it does is flash binary files onto your STM32 device. that's the whole vibe. ✨

🌸 NAME 🌸

st-flash — Flash binary files to STM32 device 🫶

✨ SYNOPSIS ✨

st-flash [OPTIONS] {read|write|erase} [FILE] <ADDR> <SIZE>

🦋 DESCRIPTION 🦋

So here's the tea, bestie: this thing flashes binary files into arbitrary sections of memory, or reads arbitrary addresses of memory out into a binary file. both directions. iconic. 👑

You can use this instead of st-util(1) if that's more your vibe, but listen — use the .bin image, not the .elf file. that part matters, no cap.

And use hexadecimal format for the ADDR and the SIZE. like, hexadecimal. that's the format. periodt. 💅

🎀 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, out to FILE 📖
• erase — Perform a mass erasing of the device firmware 💀
• reset — Reset the target 🔄

💜 OPTIONS 💜

• --version — Print version information 🏷️
• --debug — TODO (yeah bestie, that's literally all it says, the authors left it as a TODO, we don't make the rules) 🙈
• --reset — Trigger a reset both before and after flashing ✨
• --opt — Enable ignore ending empty bytes optimization 🧚
• --serial iSerial — TODO (also just a TODO, fr fr) 💀
• --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 🌟

st-util(1), st-info(1) — go read those too, bestie, they're part of the friend group 🫶

👑 COPYRIGHT 👑

This work is copyrighted. Stlink contributors. See LICENSE file in the stlink source distribution. 📜

okay that's the whole page, you're officially fluent in st-flash now. go flash something responsibly (and in hex, always in hex). 🦋✨

this one came from the stlink crew — that's the "Open Source STMicroelectronics S..." situation — and it's dated Feb 2018. mwah. bye bestie! 💖🎀