/quokka

A split ortholinear keyboard designed for the small handed

Primary LanguageJavaScriptMIT LicenseMIT

Quokka Keyboard

Quokka Keyboard PCB

Features

  • Designed for smaller handed folks
    • Steep columnar stagger
    • Slightly tucked in thumb cluster
  • Per-key RGB Matrix using the easier to solder SK6812-MINI-E LEDs
  • Piezo speakers
  • 128x64 OLED displays
  • TRRS jack faces back to keep your cables out of the way
  • Full duplex serial connection between halves

Parts List

* Affiliate Links

Build Guide

Download the necessary assets from the releases page, you will find instructions on producing parts there as well.

  1. Lay out two PCBs, make sure one is flipped, as if you were to type on the keyboard.

    *Note: if you intend to use plates for the case, you will need to carefully drill out the 5 mounting holes on each PCB (marked in green) with a 1/8" drill bit so the stand-offs can fit through the holes (do not drill out the OLED or OLED cover mounting holes marked in red).

    PCB mounting holes to drill out for plated case

  2. Tin SMD Pads

    Add a bit of solder to on leg of the diodes, switches, and LEDs (if using)

    When soldering SMD components, line up the part close to it's mounting place, heat up the solder on the pre-tinned pad, then slide the part in place, hold it there until after solder is cooled (tweezers will help with smaller parts), then solder the remaining legs, and go back over the first leg to ensure a good connection.

    SMD Pads Tinned

  3. Solder LEDs (if using)

    Place the LEDs face down in the square holes, match the leg with a notch in it to the white triangle on the PCB

    LED orientation, the leg with a notch cut into it matches with the white triangle on the PCB

    LEDs soldered in place

  4. Solder Diodes

    Place the diodes with the stripe facing the top of the keyboard (opposite the thumb keys)

    Diode orientation

    Diodes soldered in place

  5. Solder Hot Swap Sockets

    Place the sockets so the curved portion is on the left, so as not to cover the center hole for the switch pin

    Hot swap socket orientation

    Hot swap sockets soldered in place

  6. Flip the PCBs over, so everything you just soldered on is on the back, facing the table

  7. Solder the jumpers for the MCU and OLED (if using)

    Jumpers soldered

  8. Solder the TRRS jacks

    TRRS jacks soldered

  9. Solder the reset switches

    Reset switches soldered

  10. Solder the piezo elements (if using)

    The orientation of piezo elements does not matter

    Piezo elements soldered

  11. Solder the header strip sockets for the MCU and OLED (if using)

    After soldering the first leg, heat it back up and adjust the angle of the strip to be as close to vertical as possible

    Header strip sockets soldered

  12. Place the MCUs

    Orient the MCUs so they are face up, with the USB-C port facing the back of the keyboard (opposite the thumb keys)

    Use through hole diode or resistor legs to pin down the four corners of each MCU, you should feel some resistance before they drop into the socket, then they will feel snug. Solder down the four corners first.

    MCUs placed

    Note that the two contacts closest to the USB-C port on the KB2040 are not used here (also, you may paint black over the power LEDs like I did here, they are quite bright)

    MCU unused contacts

    Cut the diode or resistor legs above the solder joint, and continue soldering each leg the same way

    MCU contacts soldering process

    MCUs soldered in place

  13. Now is a good time to flash your MCUs, since the boot button will be covered by the OLEDs later on. After the initial flash, they can be put into bootloader mode by double clicking the reset switch (configured by the QMK options RP2040_BOOTLOADER_DOUBLE_TAP_RESET and RP2040_BOOTLOADER_DOUBLE_TAP_RESET_TIMEOUT in config.h)

  14. Install OLEDs (if using)

    Install M2x10mm stand-offs in the two holes in line with the OLED header strip sockets

    OLED mounting standoffs

    Screw the OLEDs to the stand-offs but leave them loose for now

    OLED loosely attached

    Push more diode or resistor legs into the OLED header strip sockets

    OLED pins installed

    Now tighten the OLED mounting screws, keeping it as straight as possible

    OLED screws tightened

    Solder and cut the pins

    OLED installed

  15. Install OLED covers

    Install M2x15mm stand-offs into the OLED cover mounting holes

    OLED cover stand-offs

    Install the OLED covers onto the standoffs

    OLED cover installed

  16. Case options

    • No Case

      The easiest option, just stick some rubber feet to the bottom of the PCBs and call it a day

      Rubber feet on PCB

      No case keyboard finished

    • 3D Printed Case

      1. Print or order the parts

      2. Install the heat set inserts into the bottom of the case body parts, careful not to push too deep as they will go right through the case.

      3. Sand and paint the case, if desired

      4. Place the PCB into the case body

      5. Place an M2x9mm screw into each of the holes in the plate, then push a spacer on the the screw from the bottom of the plate

      6. Place the plate over the PCB and tighten each screw

      7. Install your switches

      8. Stick some rubber feet on the bottom of the case

      Quokka Keyboard

    • Plated Case

      Note: If using the 3D printed plate spacers, assemble without switches and install them last, using the bottom spacer with the wide end against the bottom plate, and the top spacer with the wide end against the PCB.

      1. Install M2x8mm stand-offs on the bottom of the plates in the mounting holes

      2. Install a switch into each corner of the plates

      3. Install the PCB onto the switches in the plate

      4. Install the remaining switches

      5. Install the bottom plate on the stand-offs

      6. Stick some rubber feet on the bottom plate

      Shown here using Aluminum plates from Ponoko, though I would recommend using FR4 plates, or deburred and anodized aluminum plates from sendcutsend.com for less money

      Plate stack build