readme.md (3059B)
Unzahl
A Le Chiffre compatible PCB with some added features.


Hardware Specifics
This PCB has the exact same dimensions as the original Le Chiffre PCB, meaning it should be compatible with all existing cases. Only the reset button is in a different location. Some other hardware features and modifications include:
- MX switch hotswap sockets
- Per-key RGB lighting and underglow
- STM32G431 microcontroller
- 74HC595 shift register matrix
- External SPI flash
- Single push-button reset circuit
Ordering
The following instructions will be for JLCPCB, but should generally apply to most PCB manufacturers.
- Upload the gerber files from production/gerbers.zip
- Set PCB quantity and colour as desired
- For PCB assembly, choose Economic PCBA type and Bottom Side for assembly side
- Upload the BOM and CPL files
- Ensure the correct components have been selected, and all are in stock. An effort has been made to choose as few extended components as possible, but this is not possible for some.
- Give a quick look at the component placement and make sure nothing looks wildly wrong. It is normal for some components to be shown oriented incorrectly or not quite where they belong. The PCB reviewers will usually correct this without issue.
Note: The Kailh sockets (CPG151101S11) frequently go out of stock on LCSC. You may need to select a different part (eg. the ones included in the BOM are not manufactured by Kailh), or simply source them yourself and hand-solder them, as they’re very easy to install.
Additional Components
For optional components to be installed by hand:
| Item | Quantity | Remarks |
|------|----------|---------|
| 128x32 I2C OLED Display | 1 | Most DIY keyboard vendors carry these |
| EC11 Rotary Encoder | 1 | This position can be fitted with another MX switch if desired |
| MX Switches | 34 | +1 if you chose to forgo a rotary encoder |
| 2u Stabilisers | 2 | PCB mount screw in or clip in |
Assembly Instructions
These steps assume you already have an assembled PCB and are installing switches, trackpad, etc. If you are hand-assembling the PCBs with all components, the interactive BOM will be handy.
- Compile and flash firmware. This assumes a local QMK build environment has already been setup. Firmware sources can be found here. Enter bootloader by holding the reset button while plugging PCB in. Flash firmware using
qmk flash or QMK Toolbox.
- Ensure the keyboard is functional by shorting switch footprint pins with metal tweezers. This should output keypresses on the computer.
- Install switches by inserting through plate into hotswap sockets. Support sockets from back to prevent knocking them loose.
| # Unzahl
A [Le Chiffre](https://github.com/tominabox1/Le-Chiffre-Keyboard) compatible PCB with some added features.


## Hardware Specifics
This PCB has the exact same dimensions as the original Le Chiffre PCB, meaning it should be compatible with all existing cases. Only the reset button is in a different location. Some other hardware features and modifications include:
- MX switch hotswap sockets
- Per-key RGB lighting and underglow
- STM32G431 microcontroller
- 74HC595 shift register matrix
- External SPI flash
- Single push-button reset circuit
## Ordering
The following instructions will be for [JLCPCB](https://jlcpcb.com), but should generally apply to most PCB manufacturers.
1. Upload the gerber files from [production/gerbers.zip](production/gerbers.zip)
2. Set PCB quantity and colour as desired
3. For PCB assembly, choose **Economic** PCBA type and **Bottom Side** for assembly side
4. Upload the [BOM](production/bom.csv) and [CPL](production/positions.csv) files
5. Ensure the correct components have been selected, and all are in stock. An effort has been made to choose as few extended components as possible, but this is not possible for some.
6. Give a quick look at the component placement and make sure nothing looks wildly wrong. It is normal for some components to be shown oriented incorrectly or not quite where they belong. The PCB reviewers will usually correct this without issue.
Note: The Kailh sockets (CPG151101S11) frequently go out of stock on LCSC. You may need to select a different part (eg. the ones included in the BOM are not manufactured by Kailh), or simply source them yourself and hand-solder them, as they're very easy to install.
### Additional Components
For optional components to be installed by hand:
| Item | Quantity | Remarks |
|------|----------|---------|
| 128x32 I2C OLED Display | 1 | Most DIY keyboard vendors carry these |
| EC11 Rotary Encoder | 1 | This position can be fitted with another MX switch if desired |
| MX Switches | 34 | +1 if you chose to forgo a rotary encoder |
| 2u Stabilisers | 2 | PCB mount screw in or clip in |
## Assembly Instructions
These steps assume you already have an assembled PCB and are installing switches, trackpad, etc. If you are hand-assembling the PCBs with all components, the [interactive BOM](https://html-preview.github.io/?url=https://github.com/waffle87/unzahl/blob/master/ibom.html) will be handy.
1. **Compile and flash firmware.** This assumes a local QMK build environment has already been setup. Firmware sources can be found [here](https://git.pngu.org/qmk_me/keyboards/unzahl). Enter bootloader by holding the reset button while plugging PCB in. Flash firmware using `qmk flash` or QMK Toolbox.
2. **Ensure the keyboard is functional** by shorting switch footprint pins with metal tweezers. This should output keypresses on the computer.
5. **Install switches** by inserting through plate into hotswap sockets. Support sockets from back to prevent knocking them loose.
|