

Joystick encoder adapter
This is a mod on a Sofle Choc keyboard that replaces the right-side encoder with a joystick. The PCB layout for the adapter board is a KiCad PCB in joystickencoderadapter.
- Size
- 15.6 × 13 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 3
- Nets
- 10
- Pads
- 18
- Tracks, vias
- 25, 2
- Routed
- Yes
- KiCad
- KiCad 8.0 (file 20240108)
- Created
- 8 Feb 2025
- Updated
- 2 Mar 2025
Overview
Joystick encoder adapter is an open-source printed circuit board by eteq, from the eteq/soflejoy-zmk repository on GitHub. It is a 2-layer board of 15.6 × 13 mm with 3 parts on 10 nets, routed with 25 tracks and 2 vias.
Its parts include 2 connectors and 1 switch. It belongs with the keyboards and input and interfaces and adapters boards of this library.
README
READMESoflejoy
This is a mod on a Sofle Choc keyboard that replaces the right-side encoder with a joystick. The PCB layout for the adapter board is a KiCad PCB in joystick_encoder_adapter. The joystick is a FJ06K-S joystick and you can just solder that into the adapter board and then use short lengths of wire to connect the adapter to the encoder footprint. Note, though, there is not a power pin available on the existing Sofle layout, so you will need to do a little bodge wire connecting the 3V pad on the adapter to the nearby 3V pad for the power jack that connects the two halves of the keyboard.
Building
In zmk dir, start devcontainer as:
% devcontainer up --workspace-folder ~/src/zmk && devcontainer exec --workspace-folder ~/src/zmk bash
Then in the devcontainer:
% cd app % west build -d build/left -b nice_nano_v2 -- -DSHIELD=soflejoy_left -DZMK_CONFIG=/workspaces/zmk-config -DZMK_EXTRA_MODULES=/workspaces/zmk-config && west build -d build/right -b nice_nano_v2 -- -DSHIELD=soflejoy_right -DZMK_CONFIG=/workspaces/zmk-config -DZMK_EXTRA_MODULES=/workspaces/zmk-config
But that only works if the zmk-config volume is set up to point to this directory.
Joystick calibration
For in-min/max/deadzone values I set are probably dependent on the specific joystick. To determine them I compiled the right board with -S zmk-usb-logging, set config INPUT_LOG_LEVEL=4 in the defconfig, and then fiddled with the joystick while saving out the ttyACM0 output. I then parsed the raw values with some manual python to get the resulting values. For my particular joystick I saw:
- both x and y would max out at ~4000 if you just scrolled them, but if you wiped them, went up to ~4050
- x and y both mined out within 10 or so of 0, although x consistently at -3, and y either 10 or -3 depending on wiping
- x at center seemed to be 2010 - 2030
- y at center seemed to be 1780 - 2100 - i.e. didn't bounce back to the same spot
- std at stability was ~4
Modifying the keymap
The keymap is configured via the boards/shields/soflejoy/sofle_keymaps.xlsx file. Once updated, run python make_map.py -f sofle_keymaps.xlsx > soflejoy.keymap to update the keymap.
Parts
3| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | EC11 socket | jea:ec11e_from_sofle_nomp | SW1 |
| 1 | PowerPad | TestPoint:TestPoint_THTPad_D2.0mm_Drill1.0mm | P3V3 |
| 1 | ~ | jea:FJ06K | J1 |
Similar boards
- 2 layers40 × 30 mm

- 2 layers51.9 × 16 mm

Passive2-rpi non standard adapter
hzeller/rpi-rgb-led-matrix
Controlling up to three chains of 64x64, 32x32, 16x32 or similar RGB LED displays using Raspberry Pi GPIO
3 parts4.4kGPL-2.0 - 2 layers16.3 × 16.3 mm

- 2 layers

Sub
atopile/atopile
Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️
3 parts4kMIT - 2 layers85 × 30 mm

- 2 layers124.5 × 33.7 mm

- 2 layers10.5 × 83 mm

- 2 layers21.2 × 51.3 mm

Pico reset
hackclub/sprig
🍃 Learn to code by making games in a JavaScript web-based game editor.
3 parts1.1kMIT
Questions
How big is the Joystick encoder adapter PCB?
It measures 15.6 × 13 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Joystick encoder adapter use?
3 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Joystick encoder adapter KiCad files?
From the eteq/soflejoy-zmk repository on GitHub, at the commit this page was made from: the board is joystick_encoder_adapter/joystick_encoder_adapter.kicad_pcb and its schematic joystick_encoder_adapter/joystick_encoder_adapter.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Joystick encoder adapter design in my own project?
Its repository states no licence, so its author keeps all rights: ask eteq before reusing the design.