Follow this guide to build your Lagom keyboard.
What’s included in the Lagom kit:
- Printed circuit board, base and switch plate
- Diodes (74)
- Capacitors (2)
- IC sockets (2)
- ICs (SN74HC138N) (2)
- Standoffs (to build the case)
- Rubber bumpers for the base
What’s not included (and you’ll need you source yourself):
- MX compatible switches (3 pin or 5 pin, up to 72 of them depending on the layout)
- A controller (Lagom supports Pro Micro or compatible footprint controllers like the Elite-C, Nice!Nano, or RP2040 based controllers with a Pro Micro footprint)
- PCB mount stabilisers (for bigger keys like Space and Shift, the amount you need depends on the layout you go for)
- OLED screen (we sell these here)
- 2 Rotary Encoders (we sell these here)(and rotary encoder knobs)
- RGB light strip (optional, but possible to add a WS2812b light strip under the PCB for extra glow)
Before you begin
Before you begin!
Please double check everything is there and that you have all the parts! There is a very slim chance we forgot something or that your order is wrong; in the case this is true, please reach out via email at hej at sthlmkb.com and we will work with you to make it right.
Due to the DIY nature of this hobby, as soon as a soldering iron touches or other modifications happen to the board, we are no longer able to issue a refund/replacement.
Note about this guide: I am building a Lagom board with a Pro Micro, 2 encoders and an OLED – yours may differ. You are free to adjust or skip steps if they do not apply to your scenario.
All that being said, let’s get started!
Step by step
1. Check that you have all the components you need.
2. Start by bending all the diodes (I used the 3d printed diode bender above). And then place them in the sockets, ensuring that you have the *correct orientation*, the black line on the diode should match the white lines on the board. I then placed some tape over the diodes to hold them in place while I flipped over the board to solder them.
3. Solder the diodes on (I soldered on the underside of the board) and trim their legs once the solder has cooled
4. Solder the 2 capacitors to the PCB. They should sit on the top side of the PCB (like the diodes). Orientation does not matter with them.
5. Solder the 2 IC sockets to the PCB. They have a notch on them and the notch should be aligned with the notch on the footprint (pointing towards the capacitors). Do *not* place the ICs in the sockets yet.
6. Solder the two rotary encoders to the board. They should only fit one way, ensure that you don’t bend any of the pins when doing so.
7. Cut a small section or two of electrical tape and place it on the back of the OLED screen to cover up the resistors and other surface mount components there. This is to ensure that they do not short with the diodes when placed on top of them.
8. Solder the OLED screen in place. The screen should be facing to the left and the ground pin of the OLED should be at the top of the board. The orientation matters here, but realistically it’s hard to get it wrong as the encoders will be in the way. Remember to clip the legs of the OLED once you’ve soldered it in so that they don’t catch on the base.
9. [Optional] If you’re planning on adding RGB underglow with a light strip (e.g. a WS2812b compatible one) then this is could be a good time to solder a socket to the 3 holes to make it easier for later (but it’s possible to mod this later if you want to). See the image below for an example (excuse the poor soldering). Ensure you get the pins correct when you add an LED strip.
10. Flash your controller and check that it is working as expected (e.g. when you plug it into the computer it is recognised as a USB keyboard device). See flashing instructions here.
11. Solder your controller to the board. The board has offset holes so that hotswapping might work, but this didn’t go so great in practice so I just soldered my controller on. You are of course very welcome to socket your controller too if you value switchability. I soldered headers onto my controller and then soldered everything onto the PCB and then trimmed the legs on the underside of the PCB. Orientation matters here so ensure that you have the controller in the right position. With a pro micro this is facing down so the USB port is wedged between the Pro Micro and the PCB.
12. Insert the ICs into the sockets (be careful of the legs and do not bend them). Now you should be able to plug in your board and test that all keystrokes are recognised. I used a pair of tweezers or a switch to short the switch sockets for this. If you find some keys are not working then the keyboard debugging guide may be useful.
13. Add the stabilisers. Hopefully by now you should know what layout you want, but if you don’t then now’s a good time to choose! I used some Glorious GOAT PCB mounted screw in stabs in the photos. If you want to mod and/or lube your stabs then this is the time!
14. Start by placing a couple switches in the corners of the plate and then attach the plate to the PCB ensuring that you don’t bend any pins while doing so. Ensure that the rotary encoders and the OLED screen are fitting correctly once you place the plate on top.
15. Continue placing the rest of the switches until all keys are present. I used JWick T1 Tactile switches in the photos and went with the standard ANSI layout with a 6.25u space bar.
16. Double check that your stabilisers are all correct (i.e. the wires are seated securely) and lubed as there’s no going back once you’ve soldered switches in. Check again that that none of the switch pins are bent and not poking through the holes. They’re a pain to fix once you’ve started soldering the switches.
17. Start soldering all the switches in place. Double check that you’ve not missed anything (it’s easy to overlook a few switches).
18. Attach the standoffs to the screws on the edges of the switch plate and position the base plate correctly and screw in the screws from the bottom too. Add the rubber bumbers to the base plate in the corners. The larger ones go at the top so that you get a slight typing angle.
19. Add some keycaps and encoder knobs and *you are done!* Have a test that everything’s working as expected and maybe update/flash some new firmware if you feel like it. Enjoy!