at32flash

Flash program for AT32 using the AT serial bootloader, based on stm32flash.

at32flash 0.2 is a release with these highlights:

Added support for AT32F425

at32flash 0.1 is a release with these highlights:

Support for AT32F435 beside the STM32 MCUs

Features

UART and I2C transports supported
device identification
write to flash/ram
read from flash/ram
auto-detect Intel HEX or raw binary input format with option to force binary
flash from binary file
save flash to binary file
verify & retry up to N times on failed writes
start execution at specified address
software reset the device when finished if -R is specified
resume already initialized connection (for when reset fails, UART only)
GPIO signalling to enter bootloader mode (hardware dependent)

Usage synopsis:

Usage: ./at32flash [-bvngfhc] [-[rw] filename] [tty_device | i2c_device]
    -a bus_address  Bus address (e.g. for I2C port)
    -b rate     Baud rate (default 57600)
    -m mode     Serial port mode (default 8e1)
    -r filename Read flash to file (or - stdout)
    -w filename Write flash from file (or - stdout)
    -C      Compute CRC of flash content
    -u      Disable the flash write-protection
    -j      Enable the flash read-protection
    -k      Disable the flash read-protection
    -o      Erase only
    -e n        Only erase n pages before writing the flash
    -v      Verify writes
    -n count    Retry failed writes up to count times (default 10)
    -g address  Start execution at specified address (0 = flash start)
    -S address[:length] Specify start address and optionally length for
                        read/write/erase operations
    -F RX_length[:TX_length]  Specify the max length of RX and TX frame
    -s start_page   Flash at specified page (0 = flash start)
    -f      Force binary parser
    -h      Show this help
    -c      Resume the connection (don't send initial INIT)
            *Baud rate must be kept the same as the first init*
            This is useful if the reset fails
    -R      Reset device at exit.
    -i GPIO_string  GPIO sequence to enter/exit bootloader mode
            GPIO_string=[entry_seq][:[exit_seq]]
            sequence=[[-]signal]&|,[sequence]

GPIO sequence

The following signals can appear in a sequence:
  Integer number representing GPIO pin
  'dtr', 'rts' or 'brk' representing serial port signal
The sequence can use the following delimiters:
  ',' adds 100 ms delay between signals
  '&' adds no delay between signals
The following modifiers can be prepended to a signal:
  '-' reset signal (low) instead of setting it (high)

Examples

    Get device information:
        ./at32flash /dev/ttyS0
      or:
        ./at32flash /dev/i2c-0

    Write with verify and then start execution:
        ./at32flash -w filename -v -g 0x0 /dev/ttyS0

    Read flash to file:
        ./at32flash -r filename /dev/ttyS0

    Read 100 bytes of flash from 0x1000 to stdout:
        ./at32flash -r - -S 0x1000:100 /dev/ttyS0

    Start execution:
        ./at32flash -g 0x0 /dev/ttyS0

    GPIO sequence:
    - entry sequence: GPIO_3=low, GPIO_2=low, 100ms delay, GPIO_2=high
    - exit sequence: GPIO_3=high, GPIO_2=low, 300ms delay, GPIO_2=high
        ./at32flash -i '-3&-2,2:3&-2,,,2' /dev/ttyS0
    GPIO sequence adding delay after port opening:
    - entry sequence: delay 500ms
    - exit sequence: rts=high, dtr=low, 300ms delay, GPIO_2=high
        ./at32flash -R -i ',,,,,:rts&-dtr,,,2' /dev/ttyS0

Bug reports and patches

Please file bugs and post patches here in GitHub.

How to compile for Windows

(internal notes)

Get the latest version of Mingw-w64 via MSYS2, which provides up-to-date native builds of GCC, Mingw-w64, and other helpful C++ tools and libraries. You can download the latest installer from the MSYS2 page or use this link to the installer.
Follow the Installation instructions on the MSYS2 website to install Mingw-w64. Commands to be lunched in MinGW:

pacman -Syu
pacman -Su
pacman -S --needed base-devel mingw-w64-x86_64-toolchain
pacman -S make
pacman -S mingw-w64-x86_64-gcc

In MinGW shell, enter the project folder and lunch make
(optional) Add the path to your Mingw-w64 bin folder (ie. C:\msys64\mingw64\bin) to the Windows PATH environment variable.

4.4 KiB Raw Blame History