st-flash(1)                         stlink                         st-flash(1)

NAME
       st-flash - Flash binary files to STM32 device

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
       st-util(1), st-info(1)

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

Open Source STMicroelectronics Stlink Tools
                                   Feb 2018                        st-flash(1)