diff options
author | HorrorTroll <[email protected]> | 2024-11-21 13:28:28 +0700 |
---|---|---|
committer | GitHub <[email protected]> | 2024-11-21 17:28:28 +1100 |
commit | 39161b9ee793f4c62836b209ec877acda457b88d (patch) | |
tree | aa0bd408e0b65e6c9ee31f19b2b3cdfc374e5c83 /docs/flashing.md | |
parent | 074bbbfb2129c738a3abfcdcb3e754c7ffcd1b04 (diff) | |
download | qmk_firmware-39161b9ee793f4c62836b209ec877acda457b88d.tar.gz qmk_firmware-39161b9ee793f4c62836b209ec877acda457b88d.zip |
Added MCU support for ArteryTek AT32F415 (#23445)
Diffstat (limited to 'docs/flashing.md')
-rw-r--r-- | docs/flashing.md | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/flashing.md b/docs/flashing.md index 2afb858860..29dc780aaf 100644 --- a/docs/flashing.md +++ b/docs/flashing.md @@ -345,6 +345,39 @@ Flashing sequence: 3. Flash a .bin file 4. Reset the device into application mode (may be done automatically) +## AT32 DFU + +All AT32 MCUs come preloaded with a factory bootloader that cannot be modified nor deleted. + +To ensure compatibility with the AT32-DFU bootloader, make sure this block is present in your `rules.mk`: + +```make +# Bootloader selection +BOOTLOADER = at32-dfu +``` + +Compatible flashers: + +* [dfu-util](https://dfu-util.sourceforge.net/) / `:dfu-util` target in QMK (recommended command line) + ``` + dfu-util -a 0 -d 2E3C:DF11 -s 0x8000000:leave -D <filename> + ``` + +Flashing sequence: + +1. Enter the bootloader using any of the following methods: + * Tap the `QK_BOOT` keycode + * If a reset circuit is present, tap the `RESET` button on the PCB; some boards may also have a toggle switch that must be flipped + * Otherwise, you need to bridge `BOOT0` to VCC (via `BOOT0` button or jumper), short `RESET` to GND (via `RESET` button or jumper), and then let go of the `BOOT0` bridge +2. Wait for the OS to detect the device +3. Flash a .bin file +4. Reset the device into application mode (may be done automatically) + +### `make` Targets + +* `:dfu-util`: Waits until an AT32 bootloader device is available, and then flashes the firmware. +* `:dfu-util-split-left` and `:dfu-util-split-right`: Flashes the firmware as with `:dfu-util`, but also sets the handedness setting in EEPROM. + ## tinyuf2 Keyboards may opt into supporting the tinyuf2 bootloader. This is currently only supported on F303/F401/F411. |