
Pokodoro
justinjchae/poko
Poko: a phone-free MagSafe companion. nRF52840 + Zephyr, round display, haptic ring, voice memos, iPhone app, parametric CAD, KiCad.

RP2040 board (Pico-clone with RTL8720DN WiFi — GP4/GP5 not exposed) + TB6612FNG motor drivers + Alps motorized faders.
Motorized faders is an open-source printed circuit board by Ilosariph, from the Ilosariph/motorized-faders repository on GitHub. It is a 2-layer board of 155 × 93 mm with 66 parts on 65 nets, routed with 765 tracks and 82 vias.
It is built around the MCP3208-BI/P and B3F-4050. It belongs with the RP2040 boards of this library.
RP2040 board (Pico-clone with RTL8720DN WiFi — GP4/GP5 not exposed) + TB6612FNG motor drivers + Alps motorized faders.
Two builds exist:
| 2-fader breadboard | 4-fader PCB | |
|---|---|---|
| Faders | 2x RS60N11M9 (60 mm, 5 kΩ) | 4x RSA0N11M9 (100 mm, 10 kΩ) |
| ADC | RP2040 internal (GP26/27) | MCP3208, 12-bit SPI |
| Drivers | 1x TB6612FNG breakout | 2x TB6612FNG |
| Displays | none | 4x SSD1306 128x64 SPI |
| Buttons | none | 4 per-fader + 2 general, ADC ladder |
| Motor rail | 10 V bench supply | 9 V USB-C PD trigger |
| Docs | this file | pcb_design.md, firmware.md |
The wiring below is the 2-fader breadboard build. For the 4-fader PCB see docs/pcb_design.md (hardware) and docs/firmware.md (protocol, mute, displays, buttons).
Firmware in pico/ is the 4-fader version. It needs the MCP3208 and will
report RAIL:fail without the PD rail; the 2-fader build is kept in git
history.
| From | To | Notes |
|---|---|---|
| 10V supply + | TB6612FNG VM | Motor power |
| 10V supply − | Common GND | |
| Pico 3.3V (pin 36) | TB6612FNG VCC | Logic power |
| Pico GND (any) | TB6612FNG GND | |
| Pico GND (any) | 10V supply − | Common ground — important! |
The Pico gets power from USB. The 10V supply powers the motors only. All grounds must be connected together.
| Fader terminal | Connect to |
|---|---|
| Terminal 1 (GND) | GND |
| Terminal 3 (3.3V) | Pico 3.3V |
| Terminal A | TB6612FNG AO1 (fader 1) or BO1 (fader 2) |
| Terminal B | TB6612FNG AO2 (fader 1) or BO2 (fader 2) |
If the fader moves in the wrong direction, swap A and B.
| Fader terminal | Pico pin | Notes |
|---|---|---|
| Terminal 2 (wiper) | GP26 (fader 1) | ADC position feedback |
| Terminal 2 (wiper) | GP27 (fader 2) | ADC position feedback |
Terminal T (touch) is unused — the firmware detects move completion from the PID state machine (deadband + settle timer), not from touch.
| TB6612FNG pin | Pico pin | Notes |
|---|---|---|
| AIN1 | GP2 | Fader 1 direction |
| AIN2 | GP3 | Fader 1 direction |
| PWMA | GP6 | Fader 1 speed |
| BIN1 | GP7 | Fader 2 direction |
| BIN2 | GP8 | Fader 2 direction |
| PWMB | GP9 | Fader 2 speed |
| STBY | GP10 | Driver enable |
Note: GP4 and GP5 are skipped — this board does not expose them on the header. If you have a real Raspberry Pi Pico W, you can use the standard GP2–GP8 range instead and update
pico/main.pyaccordingly.
If you only have one fader connected, the firmware still works — fader 2 will sit at its default setpoint (50%) but won't move since nothing is connected. No code changes needed.
Just leave BIN1, BIN2, PWMB, BO1, BO2, and GP27 unconnected.
Two interfaces. The terminal tool is for bring-up and PID tuning; the extension host is what you actually run day to day.
pip install pyserial
python host/host.pyType 50 75 to set fader 1 to 50% and fader 2 to 75%. Type 50 to set fader 1 only.
If the Pico isn't detected automatically, pass the port explicitly:
python host/host.py /dev/ttyACM0 # Linux
python host/host.py COM3 # WindowsBinds faders to things on the PC. faders/config.json declares which
extension owns which fader:
python -m faders.runWith pulse_sink, each fader controls a PulseAudio/PipeWire sink: move the
fader to change volume, change it in pavucontrol and the fader follows, and
press the fader's button to mute. The fader's display shows that sink's label
and volume — display content comes from whichever extension owns the fader, so
it describes whatever that fader actually controls.
{"fader": 0, "sink": "sink-music", "min": 0, "max": 100, "label": "Music"}"source": "source-mic" in place of sink puts an input (e.g. a mic) on the
fader the same way. label is optional and defaults to the sink name — worth setting, since real
sink names (alsa_output.pci-0000_00_1f.3.analog-stereo) do not fit a 128 px
screen.
More sinks than faders → pages: fader 4-7 is page 2, 8-11 page 3 (G2 +
F1/F4, x/y on the last screen; entries without fader fill slots in
list order). The dict form sets paging and shares keys between
entries:
"pulse_sink": {
"paging": true,
"max": 150,
"faders": [{"sink": "sink-music"}, {"sink": "sink-comms"}, {"sink": "sink-apps"}]
}paging: "auto" (default) pages only when a fader is past the last one;
true always pages; false never pages and skips entries past the last
fader. A/B works either way (tap G2 + Fn). Same for voicemeeter.
Plugins are grouped into layers that take turns owning the four faders.
Each layer remembers its own fader levels, mutes, screens and creases.
Without a layers key every plugin is its own layer (pulse_sink → "Audio",
discord_voice → "Discord", home_assistant → "Home", voicemeeter →
"Voicemeeter", filter_param → "FX"); to choose, list them:
"layers": [
{"name": "Audio", "extensions": {"pulse_sink": [...]}},
{"name": "Discord", "extensions": {"discord_voice": {...}}}
],| Buttons | Action |
|---|---|
F1-F4 | Mute that fader |
G1 + F1 / F4 | Previous / next layer — screens show the name while G1 is held, faders move on its release |
G2 + Fn (tap) | A/B position swap |
G2 + F1 / F4 (hold 0.4 s) | Previous / next page (paged layers: Discord, Home / Audio / Voicemeeter / FX with >4 entries or "paging": true) |
discord_voice puts the other people in your current voice channel on the
faders: name on the screen, fader = their local volume 0-200%, fader button =
Discord's per-user mute (right-click → Mute; volume untouched). More than four
people → pages, shown as x/y on the last screen. Needs the official desktop
client (Vesktop/arRPC lack voice RPC) and your own Discord application:
http://localhost."discord_voice": {"client_id": "...", "client_secret_file": "/path/to/secret"}
(client_secret inline also works; keep the file private).~/.local/state/motorized-faders/discord_token.json.home_assistant binds faders to lights and covers over HA's WebSocket API:
Light: fader = brightness, dragged to the bottom = off; button = off / back on at its brightness. Turned off in HA → fader parks (muted).
Cover: "attribute": "position" (default) or "tilt". Two faders on
one blind give position and slat angle. Button = close (0) / restore.
Covers get one command when the fader comes to rest; the fader follows HA
once the cover stops moving.
Switch (switch.*, input_boolean.*): fader bottom = off, above = on;
button toggles.
Entries fill the faders in order; more than four → pages (hold G2 + F1/F4,
x/y on the last screen). null leaves a fader empty, e.g. to keep a
blind's pair on one page. Needs a long-lived access token (HA profile →
Security):
"home_assistant": {
"url": "http://homeassistant.local:8123",
"token_file": "~/.config/motorized-faders/ha-token",
"faders": [
{"entity": "light.desk", "label": "Desk"},
null,
{"entity": "cover.office", "attribute": "position", "label": "Blinds"},
{"entity": "cover.office", "attribute": "tilt", "label": "Slats"}
]
}token inline also works (keep the config private); "verify_ssl": false
for a self-signed https URL. "follow": false on an entry ignores the values
HA reports for it (the fader alone is the truth) — for a device whose reports
are wrong, e.g. a cover stuck at 1% until its travel is calibrated.
voicemeeter binds faders to Voicemeeter (Basic, Banana or Potato) input
strips and output buses, the way pulse_sink binds them to sinks: the fader
sets the gain in dB, gain changed in Voicemeeter moves the fader, and the
fader button toggles the strip's/bus's mute (both ways). Screens show the
label set in Voicemeeter (or label) and the gain.
"voicemeeter": [
{"fader": 0, "strip": 0, "label": "Mic"},
{"fader": 1, "strip": 3},
{"fader": 3, "bus": 0, "min": -40, "max": 0}
]strip / bus are 0-based, left to right as in Voicemeeter's window.
min/max are dB (default -60 / +12, the full slider). More than four
entries → pages, and "paging" works as for pulse_sink. Talks to the Remote
API DLL shipped with Voicemeeter via ctypes — only pyserial needed:
pip install pyserial
python -m faders.run --config my-config.jsonVoicemeeter may start after the host or restart; faders resync when it shows up.
filter_param puts controls of plugins running in PipeWire filter-chain
modules (an LSP compressor's threshold, ratio, makeup, a gate's threshold ...)
on faders. The fader sets the control, changes made elsewhere move it, the
screen shows the value in real units, and the button bypasses the plugin
(every fader on that plugin parks while it is off). One detent marks the
control's original value.
"filter_param": {
"faders": [
{"param": "fx-comp-apps:al", "scale": "db", "min": -40, "max": 0, "label": "Apps thr"},
{"param": "fx-comp-apps:cr", "scale": "log", "min": 1, "max": 10, "unit": ":1", "label": "Apps ratio"}
]
}param is <filter node name>:<LV2 port symbol>, as pw-dump lists it
under the node's Props. scale: db for controls that are linear gains
(range in dB), log for times and ratios, linear otherwise. More than four
entries → pages. Give it a layer of its own (a layer has one set of pages).
Values set from the faders are saved to
~/.local/state/motorized-faders/filter_param.json with the config's original
next to each, and put back when PipeWire reloads the filter (restart, reboot).
A changed value in the PipeWire config wins over a saved one.
motorized-faders-fx status lists them, motorized-faders-fx reset [param ...]
restores the originals. "persist": false turns saving off.
The host survives the Pico being unplugged: it waits for the port to come
back (it may return as a different ttyACM node), then replays display text,
A/B badges and creases, and extensions re-seed fader positions and mute via
their on_connect hook. Starting without the Pico attached waits the same way.
flake.nix exports the package (nix run .), a dev shell and
nixosModules.default, which runs the host as a systemd user service
(plugins like pulse_sink need the user's PipeWire session) and grants the
logged-in user the Pico's tty via udev uaccess:
{
inputs.motorized-faders.url = "github:Ilosariph/motorized-faders";
# in nixosSystem modules: inputs.motorized-faders.nixosModules.default
services.motorized-faders = {
enable = true;
plugins.pulse_sink = [
{ fader = 0; sink = "sink-master"; max = 100; label = "Master"; }
{ fader = 3; sink = "sink-music"; max = 150; label = "Music"; }
];
plugins.discord_voice = {
client_id = "1234567890";
client_secret_file = "/run/secrets/discord-faders"; # not in the store
};
};
}plugins keys are module names in faders/extensions/ (checked at eval);
each value is one instance config or a list. layers (list of
{ name; extensions; }) sets explicit layers. Logs:
journalctl --user -u motorized-faders -f.
No hardware needed — the fader is simulated and machine/utime are stubbed:
python3 tests/run_all.py| File | Description |
|---|---|
pico/main.py | MicroPython firmware — copy to Pico as main.py |
pico/lib/ | Device drivers: MCP3208, buttons, SSD1306, screen layout — upload with main.py |
host/host.py | PC terminal interface (calibrated 0–100% display) |
host/host_raw.py | Raw 16-bit ADC viewer for wiring diagnostics |
faders/ | Extension host — serial transport, button/mute dispatch, plugins |
faders/extensions/pulse_sink.py | Binds a fader to a PulseAudio/PipeWire sink |
faders/extensions/discord_voice.py | Voice-channel users on the faders: volume, mute, pages |
faders/extensions/home_assistant.py | HA lights (brightness, on/off) and covers (position, tilt), paged |
faders/extensions/voicemeeter.py | Binds a fader to a Voicemeeter strip or bus (Windows) |
faders/extensions/filter_param.py | PipeWire filter-chain plugin controls (compressor, gate ...), saved across restarts |
tests/ | Test suites — run python3 tests/run_all.py, no hardware required |
docs/upload.md | How to flash firmware to the Pico (Thonny + mpremote) |
docs/pid_tuning.md | How to tune the PID controller |
docs/firmware.md | 4-fader firmware — protocol, buttons, mute, displays |
docs/pcb_design.md | 4-fader PCB design — ADC choice, TB6612FNG, BOM |
docs/modular_design.md | Future modular expansion plan (RP2040-Zero modules) |
| Qty | Value | Footprint | References |
|---|---|---|---|
| 9 | 10kOhm | Resistor_SMD:R_0805_2012Metric | R_BTN_FADER, R_BTN_GEN, R_DISP_RES, R_F1_WIPER, R_F2_WIPER, R_F3_WIPER, R_F4_WIPER, R_SW_F4, R_VM_SENSE_TOP |
| 8 | Conn_01x08 | Connector_PinHeader_2.54mm:PinHeader_1x08_P2.54mm_Vertical | J_DISP1, J_DISP2, J_DISP3, J_DISP4, J_MOT_BOB_A_P1, J_MOT_BOB_A_P2, J_MOT_BOB_B_P1, J_MOT_BOB_B_P2 |
| 6 | B3F-4050 | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | SW_F1, SW_F2, SW_F3, SW_F4, SW_G1, SW_G2 |
| 6 | TestPoint | TestPoint:TestPoint_THTPad_D1.5mm_Drill0.7mm | TP_3V3, TP_F1_ADC, TP_GND, TP_GNDPWR, TP_SCK, TP_VM1 |
| 5 | 100nF | Capacitor_SMD:C_0805_2012Metric | C_BTN_FADER, C_BTN_GEN, C_DISP_RES, C_MCP3208_VDD_GND, C_MCP3208_VREF_GND |
| 4 | 100nF ceramic | Capacitor_SMD:C_0805_2012Metric | C_VCC_A, C_VCC_B, C_VM_A_HF, C_VM_B_HF |
| 4 | 10nF | Capacitor_SMD:C_0805_2012Metric | C_F1_WIPER, C_F2_WIPER, C_F3_WIPER, C_F4_WIPER |
| 4 | Conn_01x02 | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J_F1_MOT1, J_F2_MOT1, J_F3_MOT1, J_F4_MOT1 |
| 4 | Conn_01x03 | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | J_F1_GEN1, J_F2_GEN1, J_F3_GEN1, J_F4_GEN1 |
| 2 | 100uF electrolytic | Capacitor_THT:CP_Radial_D8.0mm_P5.00mm | C_VM_A, C_VM_B |
| 2 | 4.7kOhm | Resistor_SMD:R_0805_2012Metric | R_SW_F3, R_SW_G2 |
| 2 | TB6612FNG | Package_SO:SSOP-24_5.3x8.2mm_P0.65mm | U_MOT_A, U_MOT_B |
| 1 | 2.2kOhm | Resistor_SMD:R_0805_2012Metric | R_SW_F2 |
| 1 | 3.3kOhm | Resistor_SMD:R_0805_2012Metric | R_VM_SENSE_BOT |
| 1 | Conn_01x04 | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J_PD |
| 1 | MCP3208 | Package_DIP:DIP-16_W7.62mm | U_ADC |
| 1 | NetTie_2 | NetTie:NetTie-2_SMD_Pad2.0mm | NT1 |
| 1 | RaspberryPi_Pico | Module:RaspberryPi_Pico_Common_THT | A1 |
The 62 most common of 66 parts.

justinjchae/poko
Poko: a phone-free MagSafe companion. nRF52840 + Zephyr, round display, haptic ring, voice memos, iPhone app, parametric CAD, KiCad.

Rithvik-Vadlamani/kvm-switch
Four-layer HDMI/USB KVM design with STM32 firmware, supply supervision, and verification evidence

vekkuli/chess_clock
This repo contains design and fabrication files for my DIY chess clock project. The main components in the design are

ZeusyBoy98/HexiLux
A custom open-source smart lighting solution, using tiling hexagonal panels. Featuring music sync and home assistant compatibility.


ctag-fh-kiel/esp32-eurorack-audio
Open source eurorack audio module based on ESP32

sinneb/esp32-hvcc
Heavy compiler (hvcc) sources running on ESP32-DevKitC powered eurorack module

It measures 155 × 93 mm and has 2 copper layers, 1.6 mm thick.
66 parts, built around the MCP3208-BI/P and B3F-4050. 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.
From the Ilosariph/motorized-faders repository on GitHub, at the commit this page was made from: the board is motorized-faders/motorized-faders.kicad_pcb and its schematic motorized-faders/display.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask Ilosariph before reusing the design.