/handwired_preonic

QMK based 5x12 ortholinear keyboard

Primary LanguageCGNU General Public License v2.0GPL-2.0

Handwired 5x12 Ortholinear Keyboard

This repo contains layout-specific files and a build log for an Atmel-AVR based handwired 50% ortholinear keyboard similar to the Preonic. Keyboard firmware used is the open-source QMK, maintained by Jack Humbert of OLKB along with the MK community.

BOM

Additional Tools

Assembly

  1. 3D print or source out case and switch plate. If 3D printing, making the plate thicker to reduce flexing is recommended.

Case Plate

  1. Loop anode end (non-black line side) of 1N4148 diode to one leg of the switch as shown. Solder, and repeat for all switches. Solder cathode ends (black line side) together to form diode rows. Check for continuity from end to end.

Diode rows

  1. Solder column wires as shown to other leg of the switches. Keeping insulation between connections is recommended. Check for continuity from top row switch leg to bottom row switch leg for each column.

Columns

  1. Pick 17 I/O pins on Pro Micro for each row and column. Pro Micro pinout information can be found on Deskthority. Measure leads to respectable lengths, then cut and solder onto microcontroller board.

Pro Micro

  1. Solder wires created in step 4 to each row and column. Test each connection for continuity.

Pro Micro Connected

  1. Follow QMK's environment setup and firmware building tutorial.
  2. If new to QMK, setup basic firmware structure for handwired builds in QMK's handwiring guide.
  3. Setup keyboard layers as desired. Use Keyboard Layout Editor, QMK Configurator, and QMK basic keycodes as help.
  4. In config.h, change MATRIX_ROWS, MATRIX_COLS, MATRIX_ROW_PINS, and MATRIX_COL_PINS as wired.
  5. Short GND and RST to bring the Pro Micro into bootloader mode.
  6. Use QMK Toolbox or other methods listed in the QMK flashing guide to flash the bootloader.
  7. Use QMK Keyboard Tester to test if each key works as intended. If a key does not work, check wiring for continuity, switches if working, and code.
  8. Once working, prepare case by screwing in M2 screws from below to brass standoffs inside.
  9. Place plate into case, lining up Pro Micro to port hole in the rear of the case. Screw M2 screws to secure plate.

Assembled Plate

  1. Place keycaps onto switches.

Final Assembly

References