Skip to content
mmccoyd edited this page Jul 23, 2022 · 24 revisions
Hillside 46 Hillside 48
Hillside 52 Hillside 56

This wiki describes how to order and build the Hillside family of split ergonomic keyboards. See the README for the Hillside features, firmware access and rationale. Hillside is provided as KiCad files, zips of the files for ordering the PCB, build documentation, and QMK and ZMK firmware files.

Building a Hillside involves some soldering skills and tools, having the PCBs created, ordering parts, and assembly. For the Hillside 46, the factory can do the SMT part soldering work.

Soldering Skills and Tools

You need decent small electronics soldering skills and a temperature controlled iron. The through-hole parts are easy with good soldering technique. The SMT parts require a more careful touch but are the larger and easier SMT sizes. See Soldering Skills and Tools for some useful guides and videos. A bad solder job will increase your frustration and likely require debugging. A good clean solder job is likely to lead to a trouble-free assembly.

PCB Manufacturing

The PCB gerber and drill files to send to a PCB manufacturer are under releases and in the commits history. If you would like to make changes to the boards, the KiCad files are in the specific board directories here.

Ordering the Hillside 46

See Ordering Hillside 46.

Ordering the others

Upload to a PCB manufacturer the latest release of that board's gerber files. I have used both JLCPCB and AllPCB with settings of: 10mil trace, 0.4mm min drill hole/via size, 2 layers, 1.6mm board, 1oz copper. See the board details for the PCB size.

One thing that the fab might ask about is within the encoder footprint along the bottom of the board. That footprint handles either a choc switch or an encoder. Yet the choc switch's right stabilizer hole is right next to the ground pin hole for the encoder. If the stabilizer hole was the normal non-plated through-hole, they likely would complain that the two were too close. So the stabilizer hole is described as a plated though-hole and there is a note in the readme within the gerber folder describing that it is fine if it joins with the adjacent plated through-hole ground pin for the encoder. But they may not read that note and may ask about it.

The fabrication cost is around $11 plus $13 to $27 shipping (for five PCBs or two and a half keyboards) for a board with a simple solder mask and finish.

Parts

The core parts for the board are MCUs and sockets, diodes, TRRS jacks, switches and keys. See Parts for the details.

For options such as tenting, encoders, haptic feedback or a trackball, see Tenting, Case and Optional Parts.

For a wireless Nice!nano build, you will also need a battery, power switch, and a capacitor; see Wireless Nicenano Parts.

Building

It is highly recommended that you read through all the preparation and build pages before starting work.

Building your board differs very little between the Hillside models. It differs mainly in the number of diodes, switches and keys and their locations. The build guide images were created for the Hillside 48, but the required steps are the same for all Hillside boards.

The build links to the right will step you through constructing your board.

All components go on the top side of the board. (Well, you could put the diodes on the bottom instead, but on the top they are protected and hidden by the switches.)

The MCUs go with the side with the components face down. A sure way to check is to match up the pin labels on the MCU with the hole labels on the side of the board you are putting the MCU on, the current top side.