Flashing

Zypomorph uses QMK firmware. Documentation on installation, keymaps and compiling can be found here.

If QMK Toolbox doesn't work, try these steps

My fork of QMK can be found here

To install the default keymap:

  1. Install AVRdudess

    1. You may need to install Atmel Flip drivers and follow this guide after resetting the board.

  2. Download the left/right eeprom files and .hex files here

    1. Right-click each link and "Save link as..." or download the whole repo

  3. Flash the left half

    1. Programmer: Choose FLIP USB DFU protocol version 1 (doc7618)

    2. Port: usb

    3. MCU: ATmega32U4

    4. Flash: choose your hex file

    5. EEPROM: chooseeeprom-lefthand.eep

    6. Plug in the left half use a wire/something metal to short SJ1

    7. PressProgram!

  4. Flash the right half

    1. Place some tweezers/ wire into the SJ2 holes. This is needed to activate the USB port.

    2. Plug in the right half alone, into the unused USB port.

    3. Follow the same steps as the left, but chooseeeprom-righthand.eep and zygo-noRGB.hex

      1. If you're updating the firmware for the right side, make sure RGB is disabled for the slave side.

  5. Plug the leftmost port into your PC, and the two middle ports into each other.

  6. After the initial setup, you can update your keymap using QMK Toolbox, and you only need to flash the master half.

For custom layouts:

  1. Follow these steps

  2. Install and setup QMK and Avrdudess

  3. Edit your keymap as desired and compile hex file

  4. Flash the hex to the master (follow guide above)