Install KMK Firmware
Info
This firmware has been tested on CircuitPython (stable) 8.0.3
Reset Button Help
Single push reset button:
Reboot microcontroller - USB drive is called "CIRCUITPY" or e.g. "KLORL"
Double push reset button:
UF2 Bootloader mode - USB drive is called e.g. "RPI-RP2"
1) Install CircuitPython
KMK is a keyboard focused layer that sits on top of CircuitPython.
Follow these steps and then come back here.
2) Rename your microcontroller
Rename your microcontrollers / USB drives to "KLORL" (for the left keyboard side) and "KLORR" (for the right keyboard side) in order for KMK to figure out which side is which.
Follow this tutorial: "Renaming CIRCUITPY through CircuitPython"
OR use these preconfigured boot.py
files:
Take utilities/rename_klor_left/boot.py
and drag it on your left microcontroller (currently named: "CIRCUITPY")
(available in klor_kmk_firmware.zip or can be manually downloaded here)
Take utilities/rename_klor_right/boot.py
and drag it on your right microcontroller (currently named: "CIRCUITPY")
(available in klor_kmk_firmware.zip or can be manually downloaded here)
After a reboot the microcontroller should appear as "KLORL" and "KLORR" respectively.
3) Install KMK
- Get a copy of KMK from the master branch
- Unzip and copy the
kmk
folder and theboot.py
file at the root of the USB drive (override theboot.py
file used in step 2) - Delete
code.py
from the USB drive
3) Install KLOR firmware
- Download the
kb.py
,main.py
& thelib
folder fromklor_kmk_firmware.zip
via GitHub releases - Copy the files onto your USB drive
- Reboot
Repeat those steps for both the left and right microcontroller.