Skip to content

Commit

Permalink
Add a warning about USBtinyISP limitations to the ISP flashing guide (q…
Browse files Browse the repository at this point in the history
  • Loading branch information
sigprof authored Jan 30, 2022
1 parent b20bbc7 commit 03b1d9e
Showing 1 changed file with 22 additions and 2 deletions.
24 changes: 22 additions & 2 deletions docs/isp_flashing_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit 03b1d9e

Please sign in to comment.