This guide is for v2 PCBs. Refer to v1 guide if you purchased your pcbs prior to April 2022.

Parts

Required

Optional

Soldering

Diodes

Orientation: Black bar facing downwards or towards the microcontroller.

1. Solder one pad.
2. While holding diode with tweezers, reflow solder and place diode down on pad.
3. Solder other pad.

• Note, when working with MELF package diodes, you may need to reflow and add more solder a couple times before an adequate connection is made.

LEDs

Orientation: Notched corner/pin facing the pad marked with rectangle. This applies for both SK6812 Mini-E & WS2812B LEDs.

• Notes: \ - This component is heat sensitive. Be cautious and work at a safe temp (~300c). \ - It is wise to test the LEDs as you solder then. Consider soldering your controllers beforehand. \ - The LED order is somewhat outlined here and should be followed in order when building.

1. Solder one pad. (it may be easier to solder all 4 pads before placing LED down when installing WS2812B LEDs)
2. While holding LED with tweezers, reflow solder and place LED down on pad.
3. Solder remaining pads.

Microcontrollers

Orientation: Both microcontrollers face down.

• Note, it is recommended to flash each microcontroller prior to soldering. See firmware section for more.

1. Insert headers from front, solder in from the back.
2. Place microcontroller face down. (smooth side facing up)
3. Apply solder to all pins.
4. Use flush cutters or similar to trim excess from pins on each side.

OLEDs

1. Insert headers from front, solder in from the back.
2. Solder only one of pins to begin with.
3. While reflowing solder joint, position OLED so that it is level & straight.
4. Solder remaining pins and clip extra length of pins.

Misc.

TRRS jacks

1. Position TRRS jack on front of PCB and secure with tape.
2. Apply solder to all four pins.

Reset switches

1. Solder one pad.
2. While holding switch with tweezers, refolw solder and place switch down on pad.
3. Solder remaining 3 pads.

Hotswap sockets

1. Solder one pad.
2. While holding hotswap socket (fingers are fine), reflow solder and place socket down on pad.
3. Solder other pad.

• Note, don't hesitate to use a little extra solder, as that will help secure the socket and prevent it from being ripped off.

Encoders

1. Secure in place using tape or hands.
2. Apply solder to all five pins.

Firmware

• Note, default/v1 microdox firmware is not compatible with v2 PCBs. \ To begin, follow the QMK setup guide. (if working from an existing installation, an update may be needed.) \ For flashing instructions, see doc or video

Firmware

QMK

• Note, default/v1 microdox firmware is not compatible with v2 PCBs. \ To begin, follow the QMK setup guide. (if working from an existing installation, an update may be needed.) \ For flashing instructions, see doc or video

KMK / PEG

In Peg or KMK this keyboard can be found under lily58 or boardsource-lulu-blok in Peg

Peg can be downloaded here, and the quick start can be seen here.

For Kmk can be downloaded here and the quick start can be seen here

Here are some links to other articles that may help you get the most out of your new keyboard:

• Get the most out of your PCB Unleashing the High-Tech Power of Custom Keyboards
• Keyboard Programing

Extra

For questions, ask in Boardsource Discord server