summary refs log tree commit diff
path: root/docs/isp_flashing_guide.md
diff options
context:
space:
mode:
authorSergey Vlasov <sigprof@gmail.com>2022-01-30 22:06:19 +0300
committerGitHub <noreply@github.com>2022-01-30 11:06:19 -0800
commit03b1d9ef1f7f472f83c929c15044e71453823737 (patch)
tree8f32ff6803a1f93a36a1ed0d32be3aa277c71c7a /docs/isp_flashing_guide.md
parentb20bbc715216246ac7a93176eac2c5b428b272bf (diff)
Add a warning about USBtinyISP limitations to the ISP flashing guide (#15898)
Diffstat (limited to 'docs/isp_flashing_guide.md')
-rw-r--r--docs/isp_flashing_guide.md24
1 files changed, 22 insertions, 2 deletions
diff --git a/docs/isp_flashing_guide.md b/docs/isp_flashing_guide.md
index 384aaf7229..febb34c574 100644
--- a/docs/isp_flashing_guide.md
+++ b/docs/isp_flashing_guide.md
@@ -57,13 +57,33 @@ To use a Teensy 2.0 as an ISP flashing tool, you will first need to load a [spec
 
 !> Note that the `B0` pin on the Teensy should be wired to the `RESET` pin on the keyboard's controller. ***DO NOT*** connect the `RESET` pin on the Teensy to the `RESET` on the keyboard.
 
-### SparkFun PocketAVR / USBtinyISP / USBasp
+### SparkFun PocketAVR / USBtinyISP
 
 [SparkFun PocketAVR](https://www.sparkfun.com/products/9825)  
 [Adafruit USBtinyISP](https://www.adafruit.com/product/46)  
+
+!> SparkFun PocketAVR and USBtinyISP **DO NOT support** AVR chips with more than 64 KiB of flash (e.g., the AT90USB128 series). This limitation is mentioned on the [shop page for SparkFun PocketAVR](https://www.sparkfun.com/products/9825) and in the [FAQ for USBtinyISP](https://learn.adafruit.com/usbtinyisp/f-a-q#faq-2270879). If you try to use one of these programmers with AT90USB128 chips, you will get verification errors from `avrdude`, and the bootloader won't be flashed properly (e.g., see the [issue #3286](https://github.com/qmk/qmk_firmware/issues/3286)).
+
+**AVRDUDE Programmer**: `usbtiny`  
+**AVRDUDE Port**: `usb`
+
+#### Wiring
+
+|ISP      |Keyboard|
+|---------|--------|
+|`VCC`    |`VCC`   |
+|`GND`    |`GND`   |
+|`RST`    |`RESET` |
+|`SCLK`   |`SCLK`  |
+|`MOSI`   |`MOSI`  |
+|`MISO`   |`MISO`  |
+
+
+### USBasp
+
 [Thomas Fischl's USBasp](https://www.fischl.de/usbasp/)
 
-**AVRDUDE Programmer**: `usbtiny` / `usbasp`  
+**AVRDUDE Programmer**: `usbasp`  
 **AVRDUDE Port**: `usb`
 
 #### Wiring