qmk-firmware/keyboards/ergodox_ez
Tsan-Kuang Lee 8b832c494c [Keyboard] add keymap beautifier for Ergodox EZ (#4393)
* add beautifier

* add example

* Update keyboards/ergodox_ez/util/keymap_beautifier.py

Co-Authored-By: tsankuanglee <1425438+tsankuanglee@users.noreply.github.com>

* Update keyboards/ergodox_ez/util/keymap_beautifier.py

Co-Authored-By: tsankuanglee <1425438+tsankuanglee@users.noreply.github.com>

* works for regular layout

* all planned features implemented

* add justification switch

* docker support

* doc and starting script

* clean up the container after done
2019-11-04 23:14:15 -08:00
..
keymaps [Keymap] Layout update for my ergodox (#7187) 2019-10-28 16:26:13 -07:00
util [Keyboard] add keymap beautifier for Ergodox EZ (#4393) 2019-11-04 23:14:15 -08:00
190hotfix.sh Creates a layouts/ folder for keymaps shared between keyboards (#1609) 2017-08-23 22:29:07 -04:00
config.h Keyboard/ergodox debounce (#6994) 2019-10-09 23:23:57 +01:00
ergodox_ez.c [Keyboard] Updates to ZSA boards (#6513) 2019-08-21 17:19:07 -07:00
ergodox_ez.h [Keyboard] Updates to ZSA boards (#6513) 2019-08-21 17:19:07 -07:00
info.json Removes Erez personally from QMK (#5883) 2019-05-15 19:53:45 -04:00
matrix.c Port DEBUG_MATRIX_SCAN_RATE to core (#7029) 2019-10-15 13:32:52 +01:00
readme.md Syntax update (#2660) 2018-04-24 09:49:34 -07:00
rules.mk Cleanup rules.mk for 32U4 keyboards, A-F (#6804) 2019-10-05 11:09:35 -07:00

ErgoDox EZ

The Ez uses the Teensy Loader.

Linux users need to modify udev rules as described on the Teensy Linux page. Some distributions provide a binary, maybe called teensy-loader-cli.

To flash the firmware:

  • Build the firmware with make <keyboardname>:<keymapname>, for example make ergodox_ez: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 corner.

  • Click the button in the Teensy app to download the firmware.

See also video demonstration using Teensy in auto mode.

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_.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.