aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 3352f2b7c54dcccb287e1131535414bc05c7681d (plain)
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
Introduction
============

A firmware Sketch for the Keyboardio Model 01.  Based algerno's:
https://git.madhouse-project.org/algernon/Model01-Sketch#base-layer


Build firmware
==============

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=yes make


Flash firmware
==============

    ~$ make upload

Press down the 'prog' key while the board is rebooting.  You can release
it once it glows red.


Apply color map
===============

    ~$ make apply-colormap

This requires a firmware supporting the Serial protocol.  (Add
ENABLE_SERIAL=yes to the build environment.)