Archived
1
0
This repo is archived. You can view files and clone it, but cannot push or open issues or pull requests.
controller/README.markdown
Jacob Alexander 7169a9d58c Adding Cygwin build using Appveyor
- Uses 32 version of Cygwin (on a 64 bit machine)
- Adding PYTHON_EXECUTABLE override variable for Cygwin builds
  * We have to use the system CMake instead of the Cygwin CMake which detects the wrong version of Python
- Update Bootloader build infrastructure to attempt tests on Windows
2016-08-31 10:47:42 -07:00

2.4 KiB

The Kiibohd Controller

This is the main Kiibohd Firmware. In general, this should be the only git repo you need to clone. The KLL git repo is automatically cloned during the build process.

Please refer to the KLL repo or kiibohd.com for details on the KLL (Keyboard Layout Language) Spec.

Travis Status Appveyor Status

Visit our IRC channel

Official Keyboards

  • Infinity 60%
  • Infinity 60% LED
  • Infinity Ergodox
  • WhiteFox
  • K-Type (coming soon)

The Kiibohd firmware supports a lot of other keyboards, but these are more obscure/custom/lesser known.

Compilation

Compilation is possible and tested on Windows/Linux/Mac. Linux is the easiest using this VM.

For most people refer here.

For the full compilation details, please refer to the wiki.

Supported Microcontrollers

  • Teensy 2.0 (Partial)
  • Teensy 2.0++
  • Teensy 3.0
  • Teensy 3.1/3.2
  • mk20dx128vlf5
  • mk20dx256vlh7

Adding support for more microcontrollers is possible. Some considerations for minimum specs:

  • ~8 kB of SRAM
  • ~25 kB of Flash

It's possible to port chips with lower specs, but will be more effort and have fewer features.

Contributions

Contributions welcome!

  • Bug reports
  • Documentation and Wiki editing
  • Patches (including new features)

Licensing

Licensing is done on a per-file basis. Some of the source code is from PJRC/Teensy, other source code is from the McHck Project. Code written specifically for the Kiibohd Controller use the following licenses:

  • MIT
  • GPLv3
  • Public Domain

Contact

If you really need to get a hold of HaaTa, email is best: haata@kiibohd.com