Traducción del archivo Readme y Manual de construcción original por @aldacortes
Lumberjack es una pcb de teclado ortolinear que utiliza componentes through-hole.
El objetivo de este proyecto es construir un teclado con una pcb utilizando componentes THT, compatible con la mayoría de cases 60% de estilo tray mount (atornillado, cases similares al Tofu).
Inspirado por el teclado Plaid Plaid keyboard.
- Designed to be easy to build with minimal soldering experience.
- All through-hole components, no SMD soldering required.
- Get that visible component aesthetic in a standard 60% tray-mount case.
- Supports both USB Mini and USB-C.
- Plateless or with FR4 switch plates.
See the Bill of materials for a detailed list of the required parts.
PCBs can be manufactuered by a variety of online PCB fabricators. You can use PCBShopper to search for the best price.
The zip file in the gerber directory contains the gerber files your fabricator will need to make the PCB lumberjack.zip PCB.
When uploading the gerber zip files, use the default PCB settings.
If you want to use a plate, there are gerbers for an FR4 plate. You will need two plates, one for each half of the keyboard.
Solder all the components onto the top side of the PCB except the USB connector which should be on the back of the board. Leave the larger components until last so that the board will lie flat upsidedown while you solder the resistors and capacitors.
Take care to put the correct value resistors and capacitors in the correct places, the values are written on the silkmask along with the component reference. If you are unsure about the value of a resistor, check it with a multimeter.
Ensure that polarised components (diodes, LEDs, electrolytic capacitor (C3), IC socket) are in the correct orientation. The square pad is for the negative side of the component; for a diode this means the side with the black stripe; for LEDs and C3 the short leg is the cathode and goes in the square pad.
See the build guide for more information.
Firmware is available in the QMK repository under the name peej/lumberjack.
Follow the QMK firmware instructions to build and flash the firmware.
To put the board into bootloader mode so it is ready to recieve firmware, press and hold the BOOT button (SW2) while pressing and releasing the RESET button (SW1). The board will now be detected as an USBasp device and can have the firmware flashed via the USB port.
Pressing the RESET button (SW1) on its own will restart the microprocessor. Once flashed with firmware it is neccessary to reset the keyboard so as to return control to the new firmware.
Note that due to the BOOT button (SW2) sharing a pin with column 3, when pressed the keys in that column will also activate. This is expected behavour but can be a little annoying or confusing if you are not expecting it.
There is a VIA compatible firmware available in QMK. With this firmware flashed, the board will be automatically recognised by VIA when you plug it in.
If you have a "raw" chip without a bootloader, you will need to compile and flash the bootloader onto the chip via another device. See the build guide for more information.
If you are building your own firmware, the following matrix information will be useful to you:
| Configuration | Value |
|---|---|
| MATRIX_ROWS | 6 |
| MATRIX_COLS | 10 |
| MATRIX_ROW_PINS | C0, B5, B4, B3, B2, B1 |
| MATRIX_COL_PINS | B0, D7, D6, D5, D4, D1, D0, C1, C2, C3 |
| DIODE_DIRECTION | COL2ROW |
Due to the limited pin number of the ATMEGA328P, the PCB uses a 6 by 10 matrix (16 pins) instead of a 5 by 12 matrix (17 pins), this makes organising the matrix in your firmware slightly more complicated. The image below shows pins for each key.
Cut a piece of 2mm thick acrylic to size (95x57mm) and drill 4 m2 holes in the corners for the standoffs. Use the PCB or cover.dxf as a guide for the hole positions, you can also use cover.dxf for laser cutting the correct size acrylic.
Affix the 4 standoffs to the PCB with screws from underneath the PCB. Use the remaining 4 screws to attach the acrylic to the top of the standoffs.
