qmk-firmware/keyboards/ckeys/thedora/readme.md
Branden Byers 6b27ebefc6 [Keyboard] Add cKeys' "The Dora" Board (#6469)
* Initial 4x5

* More board

* Update exboard

* Update

* Change name to thedora

* Update keyboards/ckeys/thedora/keymaps/default/keymap.c

Co-Authored-By: fauxpark <fauxpark@gmail.com>

* Update keyboards/ckeys/thedora/config.h

Co-Authored-By: fauxpark <fauxpark@gmail.com>

* Remove the slash

* Attempt at fixing moxygen line break issues

* Update keyboards/ckeys/thedora/config.h

Co-Authored-By: fauxpark <fauxpark@gmail.com>

* Add boilerplate

* Update keyboards/ckeys/thedora/config.h

Co-Authored-By: Drashna Jaelre <drashna@live.com>
2019-08-06 10:17:59 -07:00

58 lines
1.9 KiB
Markdown
Executable File

# theDora Board
![Thedora Board](https://ckeys.org/images/exboard-3.jpg)
A 4x5 keyboard with rotary encoder, QWIIC connector, and header pinouts for easy access to all pins on the Proton C. This keyboard was built for QMK exploration big and small. What will you discover next?
Keyboard Maintainer: [brandenbyers](https://github.com/brandenbyers)
Hardware Supported: theDora
Hardware Availability: [cKeys.org](https://ckeys.org)
Make example for this keyboard (after setting up your build environment):
`make ckeys/thedora:default`
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](Complete Newbs Guide).
---
## Slides
Slides can be found at: https://ckeys.org/slides/exboard/
## Case Design
The acrylic laser cutter file is coming soon!
## PCB Design
All cKeys PCBs are open source. However, this one has not been posted yet because it needs to be cleaned up a bit! Coming soon!
## Firmware
If you want to reflash the pre-installed firmware, use the `.bin` file for Proton C. Flash with the QMK Toolbox or via the command line.
Building for Proton C: `make ckeys/thedora:default`
## Default Layout
You can find the default layout in `thedora/keymaps/default/keymap.c`
## Rotary Encoder
This is the bit of code at the end of `keymap.c` that needs to changed if you want to change the behavior of the rotary encoder.
```
void encoder_update_user(uint8_t index, bool clockwise) {
if (index == 0) { /* First encoder */
if (clockwise) {
tap_code(KC_PGDN); // What the rotary encoder repeatedly does when turned right.
} else {
tap_code(KC_PGUP); // What it does when turned to the left.
}
}
}
```
![The Dora Board](https://ckeys.org/images/exboard-1.jpg)