You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Gavin Howard ca20ba82d6
Remove macros
4 months ago
src src/Model01-Firmware.h: Add a #pragma once to make cpplint happy 3 years ago
.gitignore snapshot sketch and infrastructure from the Kaleidoscope example 5 years ago
.travis.yml Travis cleanup 3 years ago
LICENSE Initial commit 5 years ago
Makefile Update Model01 Firmware to new build system 11 months ago
Model01-Firmware.ino Remove macros 4 months ago Some additional expository prose in the install instructions. 1 year ago Little bits of glue to make the Model01 Firwmare into a 'real' arduino library that the IDE doesn't hate 4 years ago
sketch.json Update Model01 Firmware to new build system 11 months ago

Keyboardio Model 01 Firmware

The default firmware for the Keyboardio Model 01

This is a quick start guide for folks who are familiar with Arduino and prefer to use the command line. For everyone else:

Download and install

Set up the Arduino IDE

Setup the Arduino IDE on your system. Make sure you install at least version 1.8.11, since older version may not support all required features.

Out of the box, Arduino does not include support for Kaleidoscope keyboards. To be able to build and install new firmware on your keyboard, you will need to teach Arduino about Kaleidoscope.

You can find instructions for setting up the Arduino IDE and adding support for Kaleidoscope on the Kaleidoscope wiki

Once that's done, you're ready to download the Model 01's firmware source code.

Download the Model 01 Firmware

git clone

Build and flash the firmware

Before you begin, make sure your Model 01 is connected to your computer.

Option 1: From the command line

cd Model01-Firmware
make flash

When the builder tells you to hit Enter to continue, hold down "Prog" in the top left corner of your keyboard and hit Enter.

Option 2: From the Arduino IDE

Open the sketch you wish to flash (for example, Model01-Firmware.ino).

Make sure that you've picked the Model 01 from the Boards list in the tools menu.

Click the Upload button or press Ctrl-U.

Hold down the "Prog" key in the top left corner of your keyboard, until the compile finishes and the upload begins.

Start to customize the firmware

You can customize your keyboard's key layout and LED effects by modifying the Model01-Firmware.ino file in the same directory as this README. Model01-Firmware.ino is a computer program written in 'Arduino C'. You can find documentation about Arduino C at

You can also find Kaleidoscope-specific documentation on our wiki.

Getting help

As you start to explore customization of your keyboard's firmware, the community at can often be a valuable resource.


<3 jesse

Build Status