Browse Source

Update build/flash documentation.

Updated docs for the build and flash to have similar content to the new board page.

Added a bit about DFU in case someone were searching for that term.
xmkb
Aaron Nunley 4 years ago committed by Pete Johanson
parent
commit
bcc3d9b5a6
  1. 14
      docs/docs/development/build-flash.md
  2. 3
      docs/docs/development/new-shield.md

14
docs/docs/development/build-flash.md

@ -118,11 +118,17 @@ Now start VSCode and rebuild the container after being prompted. You should be a
## Flashing ## Flashing
Once built, the previously supplied parameters will be remembered so you can run the following to flash your The above build commands generate a UF2 file in `build/zephyr` (or
board with it in bootloader mode: `build/left|right/zephyr` if you followed the instructions for splits) and is by
default named `zmk.uf2`. If your board supports USB Flashing Format (UF2), copy
that file onto the root of the USB mass storage device for your board. The
controller should flash your built firmware and automatically restart once
flashing is complete.
Alternatively, if your board supports flashing and you're not developing from
within a Dockerized environment, enable Device Firmware Upgrade (DFU) mode on
your board and run the following command to flash:
``` ```
west flash west flash
``` ```
For boards that have drag and drop .uf2 flashing capability, the .uf2 file to flash can be found in `build/zephyr` (or `build/left|right/zephyr` if you followed the instructions for splits) and is by default named `zmk.uf2`.

3
docs/docs/development/new-shield.md

@ -469,7 +469,8 @@ storage device for your board. The controller should flash your built firmware
and automatically restart once flashing is complete. and automatically restart once flashing is complete.
Alternatively, if your board supports flashing and you're not developing from Alternatively, if your board supports flashing and you're not developing from
within a Dockerized environment, then you can test your build with: within a Dockerized environment, enable Device Firmware Upgrade (DFU) mode on
your board and run the following command to test your build:
``` ```
west flash west flash

Loading…
Cancel
Save