summaryrefslogtreecommitdiff
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
parentb20bbc715216246ac7a93176eac2c5b428b272bf (diff)
Add a warning about USBtinyISP limitations to the ISP flashing guide (#15898)
-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