Flashing

Flash your PCBs and test them before soldering the board together. DIP switch configuration is below.

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

Sol 2 has many different features, which must be enabled in QMK. Use the file rgbkb/sol/rev2/rules.mk to turn on/off features. You must do this for custom keymaps using OLED, encoders, or full hand LEDs. Only enable the features you need.

If you are using OLED panels, you must only enable it in the rules.mk for the half with the OLED installed. Due to a firmware issue, enabling it with nothing installed will result in lag. This means if you only have one installed on one half, you'll need to make two different hex files.

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 pre-compiled hex files

    1. Right-click on the RAW button and and "Save link as..."

  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. Flip the #4 (Master) switch to ON

      1. Remove the yellow tape from the DIP switches.

    7. Plug in the left half and toggle the reset switch (position #6) on and off

    8. PressProgram!

  4. Flash the right half

    1. Flip the #4 (Master) switch to ON

    2. Plug in the right half alone

    3. Follow the same steps as the left, but chooseeeprom-righthand.eep

    4. Flip the #4 (Master) switch to OFF

  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. Install Bash on Windows

  2. Install and setup QMK and Avrdudess

  3. Edit your keymap as desired and compile hex file

  4. Flash the hex and left/right eeprom to each half (follow guide above)

Follow these instructions for setting up QMK and flashing on Windows

If QMK Toolbox doesn't work, try these steps

Last updated