39d3d92364
This is particularly relevant for, e.g., the ergodox EZ and other keyboards with slow scan rates. Without changing the API or behavior of individual process_record() calls, we allow a configuration flag to make multiple calls in a single scan. This will probably have miniscule effects on non-steno users, and it's not enabled by default for any keyboards. Added note about it to ergodox README. Signed-off-by: seebs <seebs@seebs.net>
39 lines
1.1 KiB
Markdown
39 lines
1.1 KiB
Markdown
# ErgoDox EZ
|
||
|
||
The Ez uses the [Teensy Loader](https://www.pjrc.com/teensy/loader.html).
|
||
|
||
Linux users need to modify udev rules as described on the [Teensy
|
||
Linux page]. Some distributions provide a binary, maybe called
|
||
`teensy-loader-cli`.
|
||
|
||
[Teensy Linux page]: https://www.pjrc.com/teensy/loader_linux.html
|
||
|
||
To flash the firmware:
|
||
|
||
- Build the firmware with `make keymapname`, for example `make default`
|
||
- This will result in a hex file called `ergodox_ez_keymapname.hex`, e.g.
|
||
`ergodox_ez_default.hex`
|
||
|
||
- Start the teensy loader.
|
||
|
||
- Load the .hex file into it.
|
||
|
||
- Press the Reset button by inserting a paperclip gently into the reset hole
|
||
in the top right corder.
|
||
|
||
- Click the button in the Teensy app to download the firmware.
|
||
|
||
To flash with ´teensy-loader-cli´:
|
||
|
||
- Build the firmware with `make keymapname`, for example `make default`
|
||
|
||
- Run ´<path/to/>teensy_loader_cli -mmcu=atmega32u4 -w ergodox_ez_<keymap>.hex´
|
||
|
||
- Press the Reset button by inserting a paperclip gently into the reset hole
|
||
in the top right corder.
|
||
|
||
## Settings
|
||
|
||
You may want to enable QMK_KEYS_PER_SCAN because the Ergodox has a relatively
|
||
slow scan rate.
|