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

92 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

The Kiibohd Controller
======================
This is the main Kiibohd Firmware.
In general, this should be the **only** git repo you need to clone.
The [KLL](https://github.com/kiibohd/kll) git repo is automatically cloned during the build process.
Please refer to the [KLL](https://github.com/kiibohd/kll) repo or [kiibohd.com](http://kiibohd.com) for details on the KLL (Keyboard Layout Language) Spec.
[![Travis Status](https://travis-ci.org/kiibohd/controller.svg?branch=master)](https://travis-ci.org/kiibohd/controller) [![Appveyor Status](https://ci.appveyor.com/api/projects/status/erfnnhlm3w5sinr3/branch/master?svg=true)](https://ci.appveyor.com/project/haata/controller/branch/master)
2016-08-02 00:30:58 +00:00
[![Visit our IRC channel](https://kiwiirc.com/buttons/irc.freenode.net/input.club.png)](https://kiwiirc.com/client/irc.freenode.net/#input.club)
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](https://s3.amazonaws.com/configurator-assets/ArchLinux_kiibohd_2015-02-13.tar.gz).
For most people refer [here](https://github.com/kiibohd/controller/tree/master/Keyboards).
For the full compilation details, please refer to the [wiki](https://github.com/kiibohd/controller/wiki).
Supported Microcontrollers
--------------------------
* Teensy 2.0 (Partial)
* Teensy 2.0++
2015-10-12 20:11:21 +00:00
* Teensy 3.0
2016-01-13 23:04:45 +00:00
* 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](http://pjrc.com), other source code is from the [McHck Project](https://mchck.org).
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`