Archived
1
0
This repo is archived. You can view files and clone it, but cannot push or open issues or pull requests.
keybrd/README.md

62 lines
3.1 KiB
Markdown
Raw Normal View History

2016-05-09 20:08:23 +00:00
keybrd library for creating keyboard firmware
2016-07-18 02:26:00 +00:00
=============================================
2016-05-09 14:05:08 +00:00
keybrd library is an open source library for creating custom-keyboard firmware.
2016-07-18 02:26:00 +00:00
The keybrd library allows keyboard designers to develop and publish their firmware simply as possible.
2016-05-09 14:05:08 +00:00
2016-07-22 18:16:47 +00:00
keybrd library supports any keyboard configuration:
2016-05-09 14:05:08 +00:00
* one-piece
2016-07-18 02:26:00 +00:00
* split with shift registers
2016-05-09 14:05:08 +00:00
* split with I/O expander
* single-layer
* multiple-layer
2016-07-22 18:16:47 +00:00
* LED indicator lights
2016-05-09 14:05:08 +00:00
Multiple-layer keyboards can write symbols without using the shift key:
~ ! @ # $ % ^ & * () _ {} | < > : ?
keybrd library leverages the Arduino environment to create keyboard firmware.
The Arduino development environment is free, and easy for novice programmers to setup and learn.
2016-07-18 02:26:00 +00:00
The keybrd library has been tested on Teensy LC, Teensy 2.0, 74HC165 shift registers, and PCA9655E I/O expander.
2016-07-21 20:20:07 +00:00
The resulting keyboard firmware is compatible with standard USB keyboard drivers.
2016-05-09 14:05:08 +00:00
2016-07-18 02:26:00 +00:00
> The keybrd library is in Beta testing. The public API should not be considered stable.
2016-05-09 14:05:08 +00:00
Example minimal keybrd sketch
-----------------------------
2016-07-18 02:26:00 +00:00
A [minimal keybrd sketch](/tutorials/keybrd_1_breadboard/keybrd_1_breadboard.ino)
is 40 lines of code for a 4-key keyboard.
It scans a key matrix just like the big keyboards.
2016-05-09 14:05:08 +00:00
The sketch is small because the keybrd library takes care of the low-level details.
2016-07-18 02:26:00 +00:00
It runs the breadboard keyboard in this picture.
2016-05-09 14:05:08 +00:00
2016-09-28 21:44:44 +00:00
<img src="tutorials/keybrd_1_breadboard/basic_breadboard_keyboard_front.JPG" title="basic breadboard keyboard" alt="basic breadboard keyboard" height="290" width="328">
2016-07-22 08:34:23 +00:00
2016-05-09 14:05:08 +00:00
Example complex keybrd sketch
-----------------------------
The keybrd_DH sketch is a showcase of the keybrd library's capability.
It emulates the DataHand keyboard, which has the most complex layout I know of.
Its layout has 52 keys, 3 primary layers, 5 sub-layers, 2 matrices, 8 LEDs, and blinking LEDs.
Most layouts are much simpler.
keybrd_DH and its instantiation files contain about 800 lines of code.
2016-05-09 19:41:29 +00:00
2016-07-18 02:26:00 +00:00
[keybrd_DH_library_developer_guide.md](https://github.com/wolfv6/keybrd_DH/blob/master/doc/keybrd_DH_library_developer_guide.md)<br>
2016-05-09 20:59:49 +00:00
[mainSketch.ino](https://github.com/wolfv6/keybrd_DH/blob/master/examples/keybrd_DH/mainSketch.cpp)<br>
[instantiations_scannersLEDs.h](https://github.com/wolfv6/keybrd_DH/blob/master/src/instantiations_pins.h)<br>
2016-07-18 02:26:00 +00:00
[instantiations_scancodes.h](https://github.com/wolfv6/keybrd_DH/blob/master/src/instantiations_scancodes.h)<br>
[instantiations_layercodes.h](https://github.com/wolfv6/keybrd_DH/blob/master/src/instantiations_layercodes.h)<br>
[instantiations_rows_L.h](https://github.com/wolfv6/keybrd_DH/blob/master/src/instantiations_rows_L.h)<br>
[instantiations_rows_R.h](https://github.com/wolfv6/keybrd_DH/blob/master/src/instantiations_rows_R.h)
![hweller](images/datahand.jpg "DataHand")
2016-05-09 14:05:08 +00:00
Support
-------
2016-05-09 20:08:23 +00:00
[Guides](doc) and [tutorials](tutorials) are provided.
2016-07-18 02:26:00 +00:00
2016-07-21 20:20:07 +00:00
keybrd tutorial_1 shows how to build a breadboard keyboard.
2016-07-18 02:26:00 +00:00
The remaining [keybrd tutorials](tutorials) show how to create custom keybrd firmware.
2016-07-22 19:55:58 +00:00
Please ask questions in [keybrd firmware library](https://geekhack.org/index.php?topic=83599.0) thread if something is not clear.