aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authoryiancar <yiangosyiangou@cytanet.com.cy>2019-07-16 03:11:59 +0100
committerDrashna Jaelre <drashna@live.com>2019-07-15 19:11:59 -0700
commit3538955778c253e68779605cc67c27e15d195729 (patch)
tree3287594c4d9dbabbcf26a5a0d7461362c6509883 /docs
parent7d557a0514e2cef42a3d460f6cc78771b5df0a30 (diff)
downloadqmk_firmware-3538955778c253e68779605cc67c27e15d195729.tar.gz
qmk_firmware-3538955778c253e68779605cc67c27e15d195729.zip
Usbasploader bootloader option addition (#6304)
* Added USBasp bootloader option for USBasploader * author comment * ifdef fix :) * Add usbasp target * Update docs/flashing.md Co-Authored-By: fauxpark <fauxpark@gmail.com> * Update docs/flashing.md Co-Authored-By: fauxpark <fauxpark@gmail.com> * Update docs/flashing.md Co-Authored-By: fauxpark <fauxpark@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/config_options.md1
-rw-r--r--docs/flashing.md25
2 files changed, 26 insertions, 0 deletions
diff --git a/docs/config_options.md b/docs/config_options.md
index eb0a441cc..33cb8da9b 100644
--- a/docs/config_options.md
+++ b/docs/config_options.md
@@ -289,6 +289,7 @@ This is a [make](https://www.gnu.org/software/make/manual/make.html) file that i
289 * `halfkay` 289 * `halfkay`
290 * `caterina` 290 * `caterina`
291 * `bootloadHID` 291 * `bootloadHID`
292 * `USBasp`
292 293
293## Feature Options 294## Feature Options
294 295
diff --git a/docs/flashing.md b/docs/flashing.md
index 3b4582f00..833b9dd62 100644
--- a/docs/flashing.md
+++ b/docs/flashing.md
@@ -119,6 +119,31 @@ Flashing sequence:
1193. Flash a .hex file 1193. Flash a .hex file
1204. Reset the device into application mode (may be done automatically) 1204. Reset the device into application mode (may be done automatically)
121 121
122## USBasploader
123
124USBasploader is a bootloader developed by matrixstorm. It is used in some non-USB AVR chips such as the ATmega328P, which run V-USB.
125
126To ensure compatibility with the USBasploader bootloader, make sure this block is present in your `rules.mk`:
127
128 # Bootloader
129 # This definition is optional, and if your keyboard supports multiple bootloaders of
130 # different sizes, comment this out, and the correct address will be loaded
131 # automatically (+60). See bootloader.mk for all options.
132 BOOTLOADER = USBasp
133
134Compatible flashers:
135
136* [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases) (recommended GUI)
137* [avrdude](http://www.nongnu.org/avrdude/) with the `usbasp` programmer
138* [AVRDUDESS](https://github.com/zkemble/AVRDUDESS)
139
140Flashing sequence:
141
1421. Press the `RESET` keycode, or keep the boot pin shorted to GND while quickly shorting RST to GND
1432. Wait for the OS to detect the device
1443. Flash a .hex file
1454. Reset the device into application mode (may be done automatically)
146
122## STM32 147## STM32
123 148
124All STM32 chips come preloaded with a factory bootloader that cannot be modified nor deleted. Some STM32 chips have bootloaders that do not come with USB programming (e.g. STM32F103) but the process is still the same. 149All STM32 chips come preloaded with a factory bootloader that cannot be modified nor deleted. Some STM32 chips have bootloaders that do not come with USB programming (e.g. STM32F103) but the process is still the same.