Posted on

Lily58 Pro Build Guide

Lily58 Build Giude
Lily58 Pro Build Guide
Lily58 Pro Build Guide

Note: This is extremely resumed Lily58 Pro Build Guide and a WIP (work in progress). For a better and more complete guide check this one on which this guide + my experience was based. If you are an experienced man then use this guide.

Start with the left halve of the Lily58 Pro PCB and only after completing all the steps then proceed to the right halve PCB.

1) Solder the 29x diodes on the bottom side of the PCB, making sure the direction is matching the image below.
Tip: tin one pad from one side on the PCB only. Solder the leg of the diode on that pad, holding gently the diode down with the tweezers. Solder now another leg and pad on the PCB. Thanks for this tip to RubenAK and Doctorboy.

2) Solder the 29x Kailh Hotswap Sockets on the bottom side of the PCB, matching the contour of your respective MX/Choc socket.

3) Bridge the four jumpers on the top side of the PCB by soldering them 2 by 2 vertically.

4) Flash the controller (Pro Micro, Elite-C etc) using QMK Toolbox or QMK MSYS. Make sure there are no errors. To reset the controller using tweezers bridge the GND and RST pins 2x times on the Pro Micro, before flashing.

There are a many ways to flash the controller. Here are 3 ways you can go with:

  • 4A) QMK Toolbox: if you already have the compiled .hex file (download it here) then connect the controller to the PC via a reliable cable. Select the Local file your .hex file. Select Auto-Flash. Now bridge the GND and RST pins 2x times on the Pro Micro and you’ll see the process executing on the Toolbox. Wait until it finishes and then you can use it on the PCB.
  • 4B) QMK MSYS + QMK Toolbox: if you don’t have the already compiled .hex file or you want to edit your own keymap then install QMK MSYS and prepare the QMK environment described here. By executing the following command you are compiling the default keymap located in C:\Users\YourUsername\qmk_firmware\keyboards\lily58\keymaps\default\keymap.c
qmk compile -kb lily58/rev1 -km default

After successful compiling you’ll find your .hex file in C:\Users\YourUsername\qmk_firmware folder. Now you can flash your keymap to each controller as described in 4A step using the QMK Toolbox.

  • 4C) QMK MSYS: You can compile and flash your keymap in one step without using QMK Toolbox at all. Select the correct bootloader for your controller.
Pro Micro(Catarina): qmk flash -kb lily58 -km default -bl avrdude 
Elite-C: qmk flash -kb lily58 -km default -bl dfu 
Proton-C: qmk flash -kb lily58 -km default -bl dfu 

5) (If you don’t plan to hotswap the microcontroller skip to 6th step.)
Solder the controller’s hotswap sockets on the top of the PCB, in the marked rectangle section.

  • 5A) Insert the 24 Pins into the socket. Make sure they are all the way down inserted.
  • 5B) Insert the controller into the pins with it’s components faced down.
  • 5C) Solder the 24 pins to the controller. Jump to 7th step.

6) Solder the controller on top the PCB with it’s components faced down.

7) Test the PCB by checking if it registers keypresses. If it registers you did a great job and may proceed.

8) Solder the TRRS and Reset tactile switch on the top side of the PCB.

9) Solder the OLED screen hotswap sockets on the top side of the PCB.

OLED Hotswap sockets installation

10) Insert the controller into the PCB and the OLED screen into their respective sockets. Test if OLED screen is on and keypresses are registering.

11) Repeat all the steps above for the right PCB halve.

12) Screw the 2x 12mm standoffs on the top side of the PCB for the OLED Cover. Screw the 5x 6mm standoffs into the bottom side of the switch plate.

13) Mount the plates: Insert a few switches into the switch plate, then insert the PCB into the switch legs.

  • 13A) Insert all the remaining switches, making sure there are no bended legs.
  • 13B) Screw in the bottom plate. Insert the controller into sockets.
  • 13C) Put some tape under the OLED so it won’t short with the controller and insert it into the socket.
  • 13D) Install the OLED cover.
  • 13E) Put some keycaps and connect the TRRS and USB cable to the left halve. By default your left halve is the master and the right is the slave, but you can change that in QMK later if you desire to have the USB cable connected to the right halve.


Lily58 Hotswap with black plates