diff options
| author | Nick Brassel <nick@tzarc.org> | 2021-04-25 13:40:56 +1000 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-04-25 13:40:56 +1000 |
| commit | 891d18d3565090abd5f218a8787acc3e25349b73 (patch) | |
| tree | a18a24e01c9fa0325d4574e7ff4975021cdaeb84 /docs | |
| parent | 2a61a500de6fb286cedf644f56d70d05a0b96f0d (diff) | |
| download | qmk_firmware-891d18d3565090abd5f218a8787acc3e25349b73.tar.gz qmk_firmware-891d18d3565090abd5f218a8787acc3e25349b73.zip | |
Add initial support for tinyuf2 bootloader (when hosted on F411 blackpill) (#12600)
* Add support for jumping to tinyuf2 bootloader. Adds blackpill UF2 example.
* Update flashing.md
* Update chconf.h
* Update config.h
* Update halconf.h
* Update mcuconf.h
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/flashing.md | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/docs/flashing.md b/docs/flashing.md index 7804a6bad..83c97444e 100644 --- a/docs/flashing.md +++ b/docs/flashing.md | |||
| @@ -249,3 +249,29 @@ Flashing sequence: | |||
| 249 | 2. Wait for the OS to detect the device | 249 | 2. Wait for the OS to detect the device |
| 250 | 3. Flash a .bin file | 250 | 3. Flash a .bin file |
| 251 | 4. Reset the device into application mode (may be done automatically) | 251 | 4. Reset the device into application mode (may be done automatically) |
| 252 | |||
| 253 | ## tinyuf2 | ||
| 254 | |||
| 255 | Keyboards may opt into supporting the tinyuf2 bootloader. This is currently only supported on the F411 blackpill. | ||
| 256 | |||
| 257 | The `rules.mk` setting for this bootloader is `tinyuf2`, and can be specified at the keymap or user level. | ||
| 258 | |||
| 259 | To ensure compatibility with the tinyuf2 bootloader, make sure this block is present in your `rules.mk`: | ||
| 260 | |||
| 261 | ```make | ||
| 262 | # Bootloader selection | ||
| 263 | BOOTLOADER = tinyuf2 | ||
| 264 | ``` | ||
| 265 | |||
| 266 | Compatible flashers: | ||
| 267 | |||
| 268 | * Any application able to copy a file from one place to another, such as _macOS Finder_ or _Windows Explorer_. | ||
| 269 | |||
| 270 | Flashing sequence: | ||
| 271 | |||
| 272 | 1. Enter the bootloader using any of the following methods: | ||
| 273 | * Tap the `RESET` keycode | ||
| 274 | * Double-tap the `nRST` button on the PCB. | ||
| 275 | 2. Wait for the OS to detect the device | ||
| 276 | 3. Copy the .uf2 file to the new USB disk | ||
| 277 | 4. Wait for the keyboard to become available | ||
