Skip to content

Ergodox keyboard

https://www.ergodox.io/

Board is: Teensy 2.0 (ATMEGA32U4)

Firmware / Layout

Varac's layout: http://configure.ergodox-ez.com/keyboard_layouts/kgzwnp/edit

Saved into /home/varac/projects/ergodox/configure.ergodox-ez.com

Build .hex from .h source file

https://docs.qmk.fm/

cd ~/projects/hardware/ergodox/firmware/qmk_firmware
make ergodox_ez:default

Old: using ergodox-firmware

cd ~/projects/hardware/ergodox/firmware/ergodox-firmware
git checkout jakemcc_master
sudo apt-get install gcc-avr binutils-avr avr-libc

Flashing

https://www.pjrc.com/teensy/loader_linux.html

Flasg using the teensy cli

https://github.com/PaulStoffregen/teensy_loader_cli

Install

sudo apt-get install libusb-dev
make

Flash

cd /home/varac/projects/ergodox/teensy_loader_cli
./teensy_loader_cli -v --mcu=atmega32u4 -w ../firmware/configure.ergodox-ez.com/ergodox_ez_firmware_varac_kgzwnp.hex
./teensy_loader_cli -v --mcu=atmega32u4 -w ../firmware/qmk_firmware/ergodox_ez_default.hex

then push the flash button on ergodox

Flash using teensy gui

https://www.pjrc.com/teensy/loader_linux.html

Flashing your Ergodox is typically done with the Teensy Loader, and will be needed for the following guide.

  • Locate your .hex file generated by your firmware of choice
  • Start the Teensy Loader program
  • Load the .hex file into it.
  • Press the Reset button by pressing the reset button onboard the Teensy, you may need to insert something such as a paperclip or small screwdriver gently into the reset hole in the top right corner of your case.
  • Note: Some firmware (such as QMK and TMK) allow for the resetting of your atmel chip to be programmed as a keycode.
  • Click the button in the Teensy app to upload the firmware to your keyboard.

Install teensy-gui

cd /home/varac/projects/ergodox/teensy-gui
wget https://www.pjrc.com/teensy/teensy_linux64.tar.gz
tar -xzf teensy_linux64.tar.gz

Install linux-udev rules

wget https://www.pjrc.com/teensy/49-teensy.rules
sudo cp 49-teensy.rules /etc/udev/rules.d/

    ./teensy