> For the complete documentation index, see [llms.txt](https://rgbkb.gitbook.io/rgbkb-build-guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rgbkb.gitbook.io/rgbkb-build-guides/zygomorph-build-guide/flashing.md).
# Flashing
Zypomorph uses QMK firmware. [Documentation on installation, keymaps and compiling can be found here.](https://docs.qmk.fm/)
If QMK Toolbox doesn't work, try [these steps](https://www.reddit.com/r/olkb/comments/7jo1ob/qmk_flashing_kbd75_no_device_present/dr9jvj6)
My fork of QMK can be found [here](https://github.com/Legonut/qmk_firmware/tree/zygomorph)
### [Pre-compiled firmware files can be found here](https://github.com/RGBKB/Keyboard-files/tree/master/Zygomorph/Flashing%20files)
**To install the default keymap:**
1. Install [AVRdudess](https://github.com/zkemble/AVRDUDESS)
1. You may need to install [Atmel Flip drivers](https://www.microchip.com/developmenttools/ProductDetails/FLIP) and follow [this guide](https://imgur.com/a/bnwzy) after resetting the board.
2. Download the left/right eeprom files and .hex files [here](https://github.com/RGBKB/Keyboard-files/tree/master/Zygomorph/Flashing%20files)
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: choose**`eeprom-lefthand.eep`**
6. Use a piece of metal to short the two pads marked RESET
7. Press**`Program!`**
4. Flash the right half
1. Place some tweezers/ wire into the holes next to the MASTER jumper. This is needed to activate the USB port, and can be removed after flashing.
2. Plug in the right half alone, into the unused USB port.
3. Follow the same steps as the left, but choose**`eeprom-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.
4. Remove your jumper wire/tweezers
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](https://github.com/qmk/qmk_toolbox), and **you only need to flash the master half**.
**For custom layouts:**
1. Follow [these steps](https://docs.qmk.fm/#/newbs_getting_started?id=windows)
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)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://rgbkb.gitbook.io/rgbkb-build-guides/zygomorph-build-guide/flashing.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.