sporq/kmk_firmware
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Clackety Keyboards Powered by Python
19 Commits 17 Branches 0 Tags 16 MiB
Python 99.1%
Makefile 0.6%
Dockerfile 0.2%
ea18655a21
Go to file
Josh Klar ea18655a21 On unhandled exceptions, blink the feather LED repeatedly
2018-09-03 15:20:27 -07:00
boards Use the new debug mode 2018-09-03 13:50:27 -07:00
entrypoints On unhandled exceptions, blink the feather LED repeatedly 2018-09-03 15:20:27 -07:00
kmk On unhandled exceptions, blink the feather LED repeatedly 2018-09-03 15:20:27 -07:00
vendor Add debug hooks to the event dispatcher, remove explicit prints 2018-09-03 13:50:12 -07:00
.gitignore Make builds a bit more robust and reusable 2018-09-03 01:23:15 -07:00
.gitmodules Stop complaining about changed files in the vendor folder we knowingly do terribad things to 2018-09-03 13:53:45 -07:00
BOARD_SETUP.md Add license and a very basic setup script I used to bootstrap the Feathers 2018-08-30 02:54:26 -07:00
LICENSE.md Add license and a very basic setup script I used to bootstrap the Feathers 2018-08-30 02:54:26 -07:00
Makefile Clean up NRF builds big time 2018-09-03 13:51:04 -07:00
Pipfile Niceties 2018-09-03 13:50:53 -07:00
Pipfile.lock Niceties 2018-09-03 13:50:53 -07:00
README.md Actually write up some start of a README 2018-08-30 13:31:02 -07:00
setup.cfg Enforce that dependencies are imported in correct order at lint time 2018-09-03 03:22:31 -07:00
upy-freeze.txt Add debug hooks to the event dispatcher, remove explicit prints 2018-09-03 13:50:12 -07:00

README.md

kmk_firmware

Mechanical keyboard firmware for humans (and ARM microcontrollers)

KMK is a work-in-progress and proof-of-concept firmware for (usually mechanical) keyboards, written in CircuitPython, a fork of MicroPython. This allows for high-level and expressive keyboard programming and creature comforts that C simply doesn't make easy. KMK was heavily inspired by QMK - in fact, KMK was only created because QMK didn't correctly support some hardware I bought, and hacking support in was going to be a heavy uphill battle.

This project is currently written and maintained by @klardotsh and @kdb424.

Supported Devices

Officially Supported

Support Planned/WIP

Unsupported Devices

If you don't see it in "Supported Devices", it won't work out of the box, it's basically that simple. Pull requests are welcome and encouraged to add support for new keyboards. The base requirements for device support are a port of CircuitPython (technically base MicroPython could still work), at least 256KB of flash storage, and USB and/or Bluetooth LE interfaces. DFU bootloaders are very strongly encouraged, but not required.

Devices require at least 256KB of flash to run KMK, and that's already pretty tight. In general this means that no or almost no Arduinos are or will ever be supported. This extends to Arduino-compatibles, including the Pro Micro. If you want to run custom firmware on your Pro Micro-equipped keyboard, or for that matter anything running the ATmega32U4 (Let's Split, Plancks before rev6, hundreds of others), check out QMK, the biggest influence of KMK by far. They're great people.

License, Copyright, and Legal

This project, and all source code within (even if the file is missing headers), is licensed GPLv3 - while the tl;dr is linked, the full license text is included in LICENSE.md at the top of this source tree.

When contributing for the first time, you'll need to sign a Contributor Licensing Agreement which is based on the Free Software Foundation's CLA. The CLA is basically a two-way promise that this code is and remains yours, but will be distributed as part of a larger GPLv3 project. If you'd like to get it out of the way early, you can find said CLA here. If you forget, the bots will remind you when you open the pull request, no worries!