Silakka54 Keyboard Documentation

repository·main·Indexed 20 days ago

https://github.com/squalius-cephalus/silakka54

An open-source, 54-key column-staggered split keyboard project based on the RP2040 Zero. Designed for MX-style switches with hotswap capabilities and intended for use with Vial firmware.

Tokens
759
Snippets
0
Records
7
Agent score
20%

What's inside Silakka54

  1. Hardware specifications for Silakka54

    main

    Switch Compatibility

    • Socket Type: Hotswap sockets.
    • Switch Style: Designed for MX-style key switches. The current top plate only supports MX-style switches, though the PCB supports 5-pin switches.

    Microcontroller

    • Base: RP2040 Zero.

    Firmware Recommendation

    • It is recommended to use Vial firmware for this keyboard.
  2. Final mechanical assembly

    main
    1. Attach PCB to Plate: Secure the PCB to the bottom plate using the M2 bolts.
    2. Install Switches: Attach the MX compatible switches to the top plate.
    3. Inspect Pins: Before pressing the plates together, verify that no switch pins are twisted or damaged.
    4. Press Together: Press the top plate (with switches) into the PCB.

    Troubleshooting

    • Fitment Issues: If the PCB does not fit well with the base, cut small pieces off next to the threads. (Note: This is a known issue to be addressed in future models).
    • Stability: It is recommended to add small rubber feet to the bottom plate.
    • Testing: If using the silakka54_vial firmware, use the Vial software matrix tester to verify switch functionality.
  3. Assemble the PCB and RP2040 Zero

    main

    PCB Orientation

    The PCB is designed for double-sided use. Refer to the provided images for orientation.

    RP2040 Zero Installation

    • Flipping: The right side RP2040 must be flipped.
    • Clearance: Do not solder the RP2040 too close to the PCB; leave a 2mm gap. Ensure the pin header legs are long enough.
    • Firmware Access: Since the RP2040 Zero lacks a dedicated RESET pin, ensure you have physical access to the RESET and BOOT buttons to upload or change firmware.

    Firmware Recommendation

    It is recommended to install the firmware on the RP2040 Zero before assembly. The .uf2 file is located in the firmware folder. If firmware is already installed, double-pressing the RESET button will put the device into bootloader mode.

  4. Solder and connect the keyboard halves

    main

    Soldering

    Solder the following components:

    • Kailh Hotswap Sockets
    • PJ320D TRRS audio sockets
    • RP2040 Zero controllers

    Connecting Halves

    Connect the two halves using the TRRS cable.

    CRITICAL SAFETY WARNING: Never connect or disconnect the TRRS cable while the keyboard is powered. Doing so can cause a short circuit.

  5. Bill of materials for Silakka54

    main

    To build a Silakka54, you will need the following components:

    • 54x MX compatible key switches
    • 54x Kailh Hotswap Sockets
    • 54x 1N4148 Diodes
    • 52x 1u keycaps
    • 2x 1.5u keycap
    • 2x RP2040 Zero
    • 2x PJ320D audio sockets
    • 1x TRRS audio cable
    • 20x M2 Heat set inserts, length 2mm (OD3.2mm)
    • 20x M2 bolts, length 4mm
    • 2x PCB
    • 2x Bottom plate
    • 2x Top plate