summaryrefslogtreecommitdiff
path: root/docs/cli_commands.md
diff options
context:
space:
mode:
authorErovia <Erovia@users.noreply.github.com>2022-08-20 06:39:19 +0100
committerGitHub <noreply@github.com>2022-08-20 15:39:19 +1000
commit5e2ffe7d8f4187109514147469d7db93e075f6f0 (patch)
tree83552a38351b50f6ab175c6abd6070abcc3d78a0 /docs/cli_commands.md
parent3bf36e8b04be5af9826fe3241d227efb185a4a31 (diff)
CLI: Teaching the CLI to flash binaries (#16584)
Co-authored-by: Ryan <fauxpark@gmail.com> Co-authored-by: Sergey Vlasov <sigprof@gmail.com> Co-authored-by: Joel Challis <git@zvecr.com> Co-authored-by: Nick Brassel <nick@tzarc.org>
Diffstat (limited to 'docs/cli_commands.md')
-rw-r--r--docs/cli_commands.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/cli_commands.md b/docs/cli_commands.md
index 56767d962b..4608ed85b6 100644
--- a/docs/cli_commands.md
+++ b/docs/cli_commands.md
@@ -90,6 +90,8 @@ This command is similar to `qmk compile`, but can also target a bootloader. The
90 90
91This command is directory aware. It will automatically fill in KEYBOARD and/or KEYMAP if you are in a keyboard or keymap directory. 91This command is directory aware. It will automatically fill in KEYBOARD and/or KEYMAP if you are in a keyboard or keymap directory.
92 92
93This command can also flash binary firmware files (hex or bin) such as the ones produced by [Configurator](https://config.qmk.fm).
94
93**Usage for Configurator Exports**: 95**Usage for Configurator Exports**:
94 96
95``` 97```
@@ -102,6 +104,21 @@ qmk flash [-bl <bootloader>] [-c] [-e <var>=<value>] [-j <num_jobs>] <configurat
102qmk flash -kb <keyboard_name> -km <keymap_name> [-bl <bootloader>] [-c] [-e <var>=<value>] [-j <num_jobs>] 104qmk flash -kb <keyboard_name> -km <keymap_name> [-bl <bootloader>] [-c] [-e <var>=<value>] [-j <num_jobs>]
103``` 105```
104 106
107**Usage for pre-compiled firmwares**:
108
109**Note**: The microcontroller needs to be specified (`-m` argument) for keyboards with the following bootloaders:
110* HalfKay
111* QMK HID
112* USBaspLoader
113
114ISP flashing is also supported with the following flashers and require the microcontroller to be specified:
115* USBasp
116* USBtinyISP
117
118```
119qmk flash [-m <microcontroller>] <compiledFirmware.[bin|hex]>
120```
121
105**Listing the Bootloaders** 122**Listing the Bootloaders**
106 123
107``` 124```