qmk_firmware/keyboards/ergodox_ez
kouMatsumoto 91b4acc003 feat: add a keymap of kou (#3219) 2018-06-22 07:07:13 -07:00
..
keymaps feat: add a keymap of kou (#3219) 2018-06-22 07:07:13 -07:00
util
190hotfix.sh
config.h
ergodox_ez.c
ergodox_ez.h Fixed no-op ifndef for ergodox ez (#3189) 2018-06-15 16:16:26 -07:00
i2cmaster.h
info.json
matrix.c
readme.md
rules.mk
twimaster.c

readme.md

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.