Introduction ============ A firmware Sketch for the Keyboardio Model 01. Based algerno's: https://git.madhouse-project.org/algernon/Model01-Sketch#base-layer Build ===== On Debian systems, the following packages are required: - avr-libc - avrdude - binutils-avr - gcc-avr - arduino-mk Running `apt install arduino-mk` should pull in all required dependencies. Moreover Arduino 1.6.7 or newer is required. Unfortunately, as of 2019-06-25 the version found in Debian sid is too old (cf. #780706, #925578, #927329), so for now we add ArduinoCore-avr as a submodule. Initialize (or update) submodules: ~$ git submodule update --init \ lib/hardware/arduino/avr \ lib/hardware/keyboardio ~$ git -C lib/hardware/keyboardio submodule update --init --recursive \ "avr/bootloaders/*" \ "avr/libraries/Kaleidoscope" \ "avr/libraries/Kaleidoscope-HIDAdaptor-KeyboardioHID" \ "avr/libraries/Keyboardio*" ~$ make To enable communicating with the host via a simple Serial protocol, use ~$ ENABLE_SERIAL=1 make Flash firmware ============== ~$ make upload Press down the 'prog' key while the board is rebooting. You can release it once it glows red. Apply the color map =================== ~$ make apply-colormap This requires a firmware supporting the Serial protocol. (Add ENABLE_SERIAL=1 to the build environment.)