Wysteria

JWE's custom split keyboard, the Wysteria

This is my custom split 36-key keyboard, with an encoder knob on each hand, and a pinky cluster to avoid stretching my pinky – I find lateral movement easier.

The pcbs, and the source ergogen file used to generate v0.3, can be found in the pcbs folder.

It has working firmware for both QMK and ZMK. Source files are in the repo, but I have not put this into the main repos for either QMK or ZMK. My own build process symlinks these as appropriate.

NOTES

v0.3 has been printed and tested, and is my current daily driver. However, please note that to build it, the diodes on the thumb cluster need to be handwired to the rows. The traces on the PCB itself are incorrect. This has been fixed in the ergogen config file, ready for if and when I print it again, but this has not had all the traces set up in KiCad, and has not been printed or tested.

• Will (should) work with both QMK (with an oled and trrs) and ZMK (with nice!nano and nice!view)
• If using a display, make sure to solder the jumpers on the opposite side of the board to where the dislay is mounted. This is different to the MCU jumpers, which should be soldered on the same side as the MCU (if mounting face-up)
• The ergogen config places an extra diode below the middle finger, bottom row. I manually replace this in KiCad with the Wysteria graphic. (I haven't worked out how to make the graphic into an ergogen-compatible footprint. I'm happy with the manual step for now.)

Parts used

• Liatris or nice!nano
• OLED displays or nice!view
• Sockets
• Batteries for wireless builds
• Reset switches
• Hotswap sockets
• Power switches for wireless builds
• Socket pins
• Diodes
• EC11
• EC11 knob from GEIST
• M2 screws
• Switches and keycaps (all 1u). My current set-up has Boba U4 in the office, Boba U4Tx at home, and DES printed by JLCPCB

Tenting set-up

• Z-fold tripod
• Magsafe tripod adapter
• Folding laptop stands

To do

If I ever decide to build a new one, want to:

• Fix the problem of the thumb cluster not being in the matrix
• Move the thumb keys slightly further down (ie closer to the wrist). My thumbs naturally rest so that only the very tip is on the key.
• Rotate the lateral pinky key by 90 degrees, so that the keycap can be rotated as well.
• Move the lateral pinky key down 2mm.
• Move the reset switch to a more sensible location, though where that is I don't currently know.
• If I am feeling very ambitious, think about making a steel plate as a base, so it attaches cleanly to the magsafe tripod adapter. But I would need to work out how to properly countersink the screws, and rethink where the screws are.

References

Made based on

• ergogen
• FlatFootFox's ergogen intro
• TSteffek's guide to ergogen v4 compared to v3
• Kvietcong's fork of ergogen (for the footprints)
• Ceoloide's corney-island
• Narkoleptika's josukey

Guides for other parts

Keyboards used as reference

• Rae-dux (especially the build guide from tzcl for parts references)
• Claw (for ergogen)
• Piano
• PicaChoc36 (eg for parts references)
• Swoop (eg for parts references)
• Klor
• Sofle

Other references:

• Sadek Baroudi's guide to making cases
• Ben Vallack's video on using ergogen (nb: outdated as it is based on ergogen v3)
• Batteries
• The Absolem build guide