Skip to the content
2 layers15.6 × 13 mmJoystick encoder adapter, the printed circuit board in 3D

Joystick encoder adapter

eteq/soflejoy-zmk1

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

README

Soflejoy

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
QtyValueFootprintReferences
1EC11 socketjea:ec11e_from_sofle_nompSW1
1PowerPadTestPoint:TestPoint_THTPad_D2.0mm_Drill1.0mmP3V3
1~jea:FJ06KJ1

Similar boards

  • 2 layers40 × 30 mmBlinky, the printed circuit board in 3D

    Blinky

    earthtojake/text-to-cad

    Design physical products with AI

    3 parts26kMIT
  • 2 layers51.9 × 16 mmPassive2-rpi non standard adapter, the printed circuit board in 3D

    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 mmSensor, the printed circuit board in 3D

    Sensor

    scottbez1/splitflap

    DIY split-flap display

    3 parts4.2k
  • 2 layersSub, the printed circuit board in 3D

    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 mmDual stomp, the printed circuit board in 3D

    Dual stomp

    torvalds/GuitarPedal

    Linus learns analog circuits

    3 parts2.5kGPL-2.0
  • 2 layers124.5 × 33.7 mm172319-1 connector, the printed circuit board in 3D

    172319-1 connector

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    3 parts1.2k
  • 2 layers10.5 × 83 mmProgrammingAdapter, the printed circuit board in 3D

    ProgrammingAdapter

    stuartpittaway/diyBMSv4

    Version 4 of the diyBMS

    3 parts1.1k
  • 2 layers21.2 × 51.3 mmPico reset, the printed circuit board in 3D

    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.