Thank you again for picking up your Massdrop x OLKB Planck Light Mechanical Keyboard.
We have designed, prototyped, and manufactured working ISP (in-system programming) flashers for everyone in the original Planck Light drop due to a missing bootloader. There were a few revisions from our initial design to the final device you are receiving now and we are glad we took the time to ensure you got a fully working item.
Below, you’ll see the step by step directions for using your ISP flasher. After using it for your Planck Light, you can keep this device to use with other compatible PCBs in the future.
For those that are joining the current iteration of the Planck Light, you don’t have to worry about the ISP flasher and instructions as your device will be fully functioning out of the box.
Planck Light Bootloader Instructions
Before you start, you will need to remove the Planck Light PCB from the case in order to access the bottom side of the PCB. While it is possible to flash the Planck Light from the top side, we recommend that you flash it from the bottom side because the bottom side has the pin labels. It is possible to cause damage if the ISP flasher board is inserted incorrectly.
1. Launch QMK Toolbox: https://qmk.fm/toolbox/
2. Plug in ISP flasher board to your computer. You should see QMK Toolbox acknowledge that "AVRISP device connected" (see screenshot). If you do not see this message, you are running an older version of QMK Toolbox and you will need to upgrade it to v0.0.9+.
3. Line up the pins of the ISP flasher board with the headers on the Planck Light PCB (see red boxes). Make sure the pins are lined up in the same order, i.e. RST to RST, GND to GND, etc.
4. With the pins lined up, Insert the pins of the flasher board into the Planck Light PCB. Insert it far enough such that it remains connected without you having to hold it. You should see the Planck Light light up.
5. In QMK Toolbox, select the bootloader file (top left) and select 'at90usb1286' for the microcontroller (top right). The bootloader file can also be found https://raw.githubusercontent.com/qmk/qmk_firmware/master/util/bootloader_at90usb128x_1_0_1.hex
6. Click Flash (top right). You should see messages similar to the screenshot below. It should take about 10 seconds. The LEDs on the Planck Light should turn off once the flashing is complete.
7. Unplug the ISP flasher board from your computer and then plug in your Planck Light to your computer. You should see messages acknowledging both: "AVRISP device disconnected", "DFU device connected".
8. Select the default hex file for the Planck Light or your preferred hex file. If you do not have one already downloaded, QMK Toolbox can download it for you if you select "planck/ light" and click "Load".
9. Click "Flash". You should see the message "Attempting to flash" as it starts and "DFU device disconnected" as it finishes. This should only take a few seconds. If you used the default Planck Light hex file, you should hear the startup sound and see the LEDs light up.
10. You're done!
Having any issues or generally need some help?
Let us know in the discussion and we’ll give you a hand.