qmk-dactyl-manuform-a/keyboards/ergodox_ez
Jack Humbert 998ddbb122 Merge branch 'master' of github.com:qmk/qmk_firmware into hf/shinydox 2018-06-12 10:59:35 -04:00
..
keymaps Keyboard that works on Qwerty or Bepo OS keyboards. (#3149) 2018-06-08 10:06:25 -07:00
util Creates a layouts/ folder for keymaps shared between keyboards (#1609) 2017-08-23 22:29:07 -04:00
190hotfix.sh Creates a layouts/ folder for keymaps shared between keyboards (#1609) 2017-08-23 22:29:07 -04:00
config.h a quick attempt 2018-05-09 09:43:36 -04:00
ergodox_ez.c a failed attempt at hot-plugging 2018-05-24 09:18:36 -04:00
ergodox_ez.h i2c fix 2018-05-15 22:30:58 -04:00
i2cmaster.h Creates a layouts/ folder for keymaps shared between keyboards (#1609) 2017-08-23 22:29:07 -04:00
info.json Fix Ergodox EZ Info.json files (#2979) 2018-05-20 21:34:18 -07:00
matrix.c a failed attempt at hot-plugging 2018-05-24 09:18:36 -04:00
readme.md Syntax update (#2660) 2018-04-24 09:49:34 -07:00
rules.mk i2c fix 2018-05-15 22:30:58 -04:00
twimaster.c Creates a layouts/ folder for keymaps shared between keyboards (#1609) 2017-08-23 22:29:07 -04:00

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.