README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# Kaleidoscope
 
Flexible firmware for Arduino-powered keyboards
 
# Getting Started
 
Pick a directory to work in, you'll need to clone multiple repositories. We'll assume you picked `$HOME/kaleidoscope`, if you chose another adapt the commands below accordingly.
 
## Setup the Arduino IDE
 
Setup the Arduino IDE on your system. Make sure you install at least version 1.6, since older version may not support all required features.
 
* On Linux, follow the instructions [on the wiki](https://github.com/keyboardio/Kaleidoscope/wiki/Arduino-Setup-Linux).
* On macOS, install using [homebrew](http://brew.sh/) [cask](https://caskroom.github.io/) with `brew cask install arduino` or download the application from [the official website](https://www.arduino.cc/en/Main/Software) and move it to your `/Applications` folder.
 
## Install the Kaleidoscope Hardware Definitions
 
```sh
# you'll need to know your arduino sketchbook directory 
 
# on macOS the default is 
SKETCHBOOK_DIR=$HOME/Documents/Arduino
# on Linux the default is 
SKETCHBOOK_DIR=$HOME/Arduino
 
# make a directory for kaleidoscope, the Model 01 firmware 
mkdir $HOME/kaleidoscope
 
# go to your kaleidoscope directory 
cd $HOME/kaleidoscope
 
# then clone the hardware definitions 
git clone --recursive https://github.com/keyboardio/Arduino-Boards.git
 
# and make them available to the arduino environment 
mkdir -p $SKETCHBOOK_DIR/hardware/keyboardio
ln -s $HOME/kaleidoscope/Arduino-Boards $SKETCHBOOK_DIR/hardware/keyboardio/avr
```
 
## Clone and Build the Kaleidoscope Firmware for the Model 01
 
```sh
# go to your keyboardio directory 
cd $HOME/kaleidoscope
 
# then clone the firmware repository 
git clone https://github.com/keyboardio/Model01-Firmware.git
 
# and build your firmware! 
cd Model01-Firmware
 
make flash
 
# When the builder tells you to hit return to continue, 
# hold down "prog" on your keyboard and hit return. 
```
 
<3 jesse
 
[![Build Status](https://travis-ci.org/keyboardio/Model01-Firmware.svg?branch=master)](https://travis-ci.org/keyboardio/Model01-Firmware)