Before you start
Read this page once; it saves mistakes later.
The plan
The turntable controller is built from several circuits. You will build them on three breadboards, one stage at a time, checking that each stage works before adding the next:
- Brain board: the ESP32-S3-ETH (the main computer) and the stepper driver that moves the motor.
- Panel board: four knobs, a tap button and a small chip (an I2C expander) that reads three of the knob buttons.
- Lighting board: a signal-boosting chip and a short LED strip standing in for the 178-LED ring, driven by the ESP32-S3-ETH itself.
- Power off before you change any wire. Unplug the 12 V adapter and the USB cables first.
- Never plug or unplug the motor while the 12 V is on. This can destroy the driver chip.
- Do not connect mains (wall) power to anything here except through the finished 12 V adapter. There is no mains wiring on a breadboard.
- The 12 V rail and the 3.3 V / 5 V rails must never touch. Keep red 12 V wires well away from orange 3.3 V wires.
How a breadboard works
- Each short vertical line of 5 holes (one column, in the top half or the bottom half) is joined inside. In the picture the orange and blue stripes show two such columns.
- The top half and the bottom half are not joined. The channel in the middle separates them; chips straddle it.
- The long lines along the edges are power rails. Every hole in one rail line is joined. We use them for 12 V, 3.3 V, 5 V and ground (GND).
- Some breadboards split each rail in the middle. If yours does, bridge the gap with a jumper, or your power will stop halfway along.
- Each hole has a name: its row letter then its column number, like
h13. Rails are named by what they carry, like "GND rail near column 16".
How to read the pictures
- Turn each breadboard so the row letters and column numbers printed on it match the picture (letter
jat the top, column 1 on the left). - A dashed orange outline marks a part you add in the current step. Wires from earlier steps are shown faded.
- Each new wire has a numbered black circle. The table under the picture lists that number, the wire colour (a suggestion; any colour works), where it starts and where it ends.
- A wire that goes to another breadboard ends in a vertical tag that says where the other end goes ("to Board 2: f27"). Use long jumper wires for these.
- Press parts in straight and firmly. Half-inserted pins are the most common cause of "it does not work".
Parts you need
| Part | What to get |
|---|---|
| Breadboards | 3 full-size, 830-point boards (63 columns, 10 lettered rows, 2 power rails on each long edge) |
| ESP32-S3-ETH | Waveshare ESP32-S3-ETH with the header pins soldered on (the pre-soldered version). USB-C cable. |
| TMC2209 stepper driver | BigTreeTech TMC2209 V1.3 (or a compatible StepStick-style TMC2209) with header pins |
| Stepper motor | NEMA17, for example StepperOnline 17HS08-1004S (black, green, red, blue wires) |
| 12 V power | 12 V DC adapter, 1 A or more, and a barrel-jack-to-screw-terminal adapter (or a bench supply) |
| 5 V power | 5 V DC adapter, 2 A or more, and a second barrel-jack-to-screw-terminal adapter |
| MCP23017-E/SP | 28-pin DIP I2C port expander (the PCB uses the surface-mount version) |
| 74AHCT125 (DIP-14) | or 74HCT125. The PCB uses two single-gate 74AHCT1G125s |
| KY-040 rotary encoder modules | 4 pieces, 5-pin |
| Push button | 1 tactile button (4-leg, 6 mm) |
| LED strip | 8 LEDs, APA102 or SK9822 (data and clock), 5 V, with 4 wires or pads (+5V, CKI or CI, DIN or DI, GND) |
| Resistors (1/4 W) | 1 kΩ ×3 (R9, R23, R57), 4.7 kΩ ×3 (R21, R22, R59), 330 Ω ×2 (R18, R61), 10 kΩ ×3 (R26, R62, R58) |
| Capacitors | 100 µF 35 V electrolytic ×1 (use 2 if you have them, in parallel), 0.1 µF ceramic ×3 |
| Diode | 1N5819 (or 1N5822) Schottky ×1 |
| Fan section (optional) | 12 V 4-wire PWM fan (ARCTIC P12 PWM or Noctua NF-P12 redux), 2N7000 (TO-92; a stand-in for the board's SOT-23 2N7002) ×1, 4-pin male header |
| Jumper wires | A pack of 65+ solid-core jumpers in assorted lengths (the pictures use wire colours; use what you have), plus 14 long (20–30 cm) male-to-male jumpers to join the boards |
| Tools | Multimeter, small wire cutter / tweezers, a computer with the Arduino CLI or IDE |
Resistor colour bands: 330 Ω orange-orange-brown, 1 kΩ brown-black-red, 4.7 kΩ yellow-violet-red, 10 kΩ brown-black-orange.
Software you need first
The ESP32-S3-ETH runs this project's firmware. Install the Arduino CLI (or the Arduino IDE) and the ESP32 board support, then see Building / flashing in the README. It also drives the LEDs, so there is nothing else to flash.
1The ESP32-S3-ETH and ground
The main computer. It also makes the 3.3 V that powers everything else on the breadboards.
Parts for this step
- Breadboard 1
- ESP32-S3-ETH (header pins soldered on), USB-C cable
- 3 jumper wires
3V3 pin supplies the other chips. The loads here are small (the driver's logic, one chip and four knobs).Do this
- Put Breadboard 1 in front of you with row letters matching the picture. Join the rails by adding wire 3 first.
- Plug the ESP32-S3-ETH across the centre channel. Its USB-C and Ethernet end goes to the left. Its first pin (pin 1, the end of each pin row nearest the USB-C port) goes in column 9; the pins fill columns 9 to 28. One row of pins lands in row
hand the other in rowc. Check: the pin labels printed on the module should read GP21, GP17 (and so on) along the top row; they are drawn on the picture. If the printed labels run the other way, the module is backwards. - Add wires 1 and 2 (ground) and 3 (links the top and bottom ground rails). Do not connect the pin labelled
3V3_ENto anything: on the finished board it is grounded, but here the module must make its own 3.3 V.
Wires to add
| # | Colour | From | To | What it does |
|---|---|---|---|---|
| 1 | black | Board 1: i16 | Board 1: GND rail, col 16 | ESP32 ground (top row, pin 8) to the top GND rail |
| 2 | black | Board 1: b16 | Board 1: GND rail, col 16 | ESP32 ground (bottom row, pin 8) to the bottom GND rail |
| 3 | black | Board 1: GND rail, col 62 | Board 1: GND rail, col 62 | Joins the top and bottom GND rails so both sides share ground |
- Plug the USB-C cable from your computer into the ESP32-S3-ETH. A light on the module comes on.
- Flash the firmware as described in the README (the
arduino-cli compile/uploadcommands there; the board name must haveCDCOnBoot=cdc). Open the serial monitor at 115200 baud. You should see the boot messages and, with an Ethernet cable plugged in,ETH got IP. - With a multimeter set to DC volts, put the black probe on a GND rail and the red probe on hole
i13(the module's 3V3 pin). You should read 3.3 V (3.2 to 3.4).
2Stepper driver and motor
The TMC2209 takes STEP and DIR pulses from the ESP32 and drives the motor coils with 12 V.
Parts for this step
- TMC2209 driver module (pins soldered on)
- NEMA17 motor
- 12 V adapter with screw-terminal jack
- 1N5819 diode, 100 µF 35 V capacitor
- Two 1 kΩ resistors (R9 and R23)
- About 20 jumper wires
Do this
- Place the driver. Pins 1 to 8 of one row go in columns 36 to 43 of the bottom pin row (
c) and the other row in the top pin row (g). The end labelled EN / VM goes to the left (column 36). Read the labels printed on your module and check against the picture before you press it in: a driver put in backwards will be destroyed when power is applied. - Add the diode D1 from
j33toj36with the stripe (cathode) on the right, at the driver end. The stripe must point toward the driver. - Add the 100 µF capacitor. Electrolytic capacitors have a + leg (longer) and a stripe on the − side. The + leg goes in
i36and the stripe (−) leg ini37. Backwards, it can pop. Check twice. - Add the two 1 kΩ resistors (R23 from
j25toj31, R9 froma34toa40), then wires 4 to 23 from the table. Do the power wires (red and black from the adapter) last. - Check the 12 V adapter first. With a multimeter on DC volts, confirm it reads +12 V (about 11 to 13 V) between its + and − terminals, and that the + terminal really is the positive one. Barrel-jack adapters are normally centre-positive, but check: reversed power will damage the driver.
- Connect the motor wires with everything off: green →
i38, black →i39, red →i40, blue →i41. (A motor wire set usually ends in a plug; use a plug-to-jumper lead, or twist the bare ends onto jumper-wire pins.)
Wires to add
| # | Colour | From | To | What it does |
|---|---|---|---|---|
| 4 | red | 12 V adapter + | Board 1: +12V rail, col 4 | 12 V adapter + to the +12V rail |
| 5 | black | 12 V adapter − | Board 1: GND rail, col 5 | 12 V adapter − to the GND rail |
| 6 | red | Board 1: +12V rail, col 33 | Board 1: i33 | +12V rail to the diode D1 (anode side) |
| 7 | black | Board 1: j37 | Board 1: GND rail, col 37 | Driver ground (pin 2, top row) to the GND rail |
| 8 | black | Board 1: j43 | Board 1: GND rail, col 43 | Driver ground (pin 8, top row) to the GND rail |
| 9 | orange | Board 1: i13 | Board 1: i31 | ESP32 3V3 pin to the 3V3 junction (column 31) |
| 10 | orange | Board 1: h31 | Board 1: i42 | 3V3 junction to the driver's logic supply (VIO) |
| 11 | green | motor green (A−) | Board 1: i38 | Motor green wire (A−) |
| 12 | black | motor black (A+) | Board 1: i39 | Motor black wire (A+) |
| 13 | red | motor red (B+) | Board 1: i40 | Motor red wire (B+) |
| 14 | blue | motor blue (B−) | Board 1: i41 | Motor blue wire (B−) |
| 15 | black | Board 1: b37 | Board 1: GND rail, col 37 | Driver MS1 to GND (selects driver address 0) |
| 16 | black | Board 1: b38 | Board 1: GND rail, col 38 | Driver MS2 to GND (selects driver address 0) |
| 17 | black | Board 1: b41 | Board 1: GND rail, col 41 | Driver CLK to GND (use the internal clock) |
| 18 | lime | Board 1: b39 | Board 1: b40 | Joins the driver's two PDN pins together |
| 19 | teal | Board 1: a39 | Board 1: i20 | UART receive: driver PDN to ESP32 GPIO15 |
| 20 | lime | Board 1: b13 | Board 1: b34 | UART transmit: ESP32 GPIO47 to R9 (the 1k resistor) |
| 21 | pink | Board 1: b14 | Board 1: b42 | STEP: ESP32 GPIO46 to the driver's STEP pin |
| 22 | brown | Board 1: b12 | Board 1: b43 | DIR: ESP32 GPIO48 to the driver's DIR pin |
| 23 | grey | Board 1: i25 | Board 1: b36 | ENABLE: ESP32 GPIO0 to the driver's EN pin |
- Power: plug in USB (ESP32), then the 12 V adapter. Never the other way with the motor loose.
- The serial monitor shows the driver being set up: look for
TMC2209 UARTlines such asmicrosteps confirmedandcurrent reference is UART. - The motor shaft should feel held (stiffer to turn by hand).
- Open
http://liquidturntable.local/liveon a phone or computer on the same network and press Start. The shaft should turn smoothly. Press Stop.
3The speed knob and the tap button
Start the panel board: the main speed knob (a KY-040 rotary encoder) and the TAP button.
Parts for this step
- Breadboard 2
- 1 KY-040 knob module
- 1 push button
- About 12 jumper wires, 6 of them long (to join the two boards)
Do this
- Switch everything off.
- On Breadboard 2, plug the KY-040 into row
j, columns 27 to 31, with the knob facing up and the module hanging off the top edge. Reading its labels left to right the pins are GND, +, SW, DT, CLK, as in the picture. (If it feels wobbly, you can instead use female-to-male jumper wires from the module's pins to the same holes.) - Press the button across the centre channel, columns 56 and 58. It has four legs; this works whichever way round it goes.
- Add the wires. The wires marked with a tag go to the other board: for each, connect one end to the hole named on Board 1 and the other to the hole named on Board 2.
Wires to add
| # | Colour | From | To | What it does |
|---|---|---|---|---|
| 24 | black | Board 1: GND rail, col 59 | Board 2: GND rail, col 59 | Ground link between the Brain board and the Panel board |
| 25 | orange | Board 1: g31 | Board 2: +3V3 rail, col 57 | 3V3 from the Brain board's junction (column 31) to the Panel board's 3V3 rail |
| 26 | black | Board 2: GND rail, col 62 | Board 2: GND rail, col 62 | Joins the Panel board's top and bottom GND rails |
| 27 | orange | Board 2: +3V3 rail, col 61 | Board 2: +3V3 rail, col 61 | Joins the Panel board's top and bottom 3V3 rails |
| 28 | black | Board 2: f27 | Board 2: GND rail, col 27 | Speed knob GND pin to GND |
| 29 | orange | Board 2: f28 | Board 2: +3V3 rail, col 28 | Speed knob + pin to 3V3 |
| 30 | blue | Board 1: b22 | Board 2: f31 | Speed knob CLK: ESP32 GPIO38 |
| 31 | lightblue | Board 1: b20 | Board 2: f30 | Speed knob DT: ESP32 GPIO39 |
| 32 | black | Board 2: d56 | Board 2: GND rail, col 56 | TAP button to GND |
| 33 | white | Board 1: i14 | Board 2: g58 | TAP button signal: ESP32 GPIO21 |
- Power up (USB first, then 12 V).
- On the phone page (
/live), turn the speed knob clockwise a few clicks: the speed figure rises and the motor starts to turn. Counter-clockwise past zero reverses it. - Press the knob once: it jumps to the home speed. Press again: it stops.
- Press the TAP button four times in time: the BPM shown changes.
j.4The other three knobs
Hue, Saturation and Value (brightness): same wiring as the speed knob, different pins.
Parts for this step
- 3 KY-040 knob modules
- 12 jumper wires (6 short, 6 long)
Do this
- Plug the three KY-040 modules into row
jof Breadboard 2: HUE in columns 3–7, SAT in 11–15, VAL in 19–23 (all with GND on the left, CLK on the right). Leave a gap of one column between modules: each is about 19 mm wide. - Add the wires from the table: power wires (black and orange) to the rails, and the long tagged wires to Board 1.
- The knobs' push buttons (SW pins) are not wired yet. They go through the expander chip in the next step.
Wires to add
| # | Colour | From | To | What it does |
|---|---|---|---|---|
| 34 | black | Board 2: f3 | Board 2: GND rail, col 3 | HUE knob GND pin to GND |
| 35 | orange | Board 2: f4 | Board 2: +3V3 rail, col 4 | HUE knob + pin to 3V3 |
| 36 | purple | Board 1: i24 | Board 2: f7 | HUE knob CLK: ESP32 GPIO1 |
| 37 | pink | Board 1: b19 | Board 2: f6 | HUE knob DT: ESP32 GPIO40 |
| 38 | black | Board 2: f11 | Board 2: GND rail, col 11 | SAT knob GND pin to GND |
| 39 | orange | Board 2: f12 | Board 2: +3V3 rail, col 13 | SAT knob + pin to 3V3 |
| 40 | green | Board 1: i28 | Board 2: f15 | SAT knob CLK: ESP32 GPIO43 |
| 41 | lime | Board 1: i27 | Board 2: f14 | SAT knob DT: ESP32 GPIO44 |
| 42 | black | Board 2: f19 | Board 2: GND rail, col 19 | VAL knob GND pin to GND |
| 43 | orange | Board 2: f20 | Board 2: +3V3 rail, col 20 | VAL knob + pin to 3V3 |
| 44 | yellow | Board 1: b18 | Board 2: f23 | VAL knob CLK: ESP32 GPIO41 |
| 45 | white | Board 1: b17 | Board 2: f22 | VAL knob DT: ESP32 GPIO42 |
/live page. Turn HUE: the colour value changes; SAT: how rich; VAL: brightness. (The LEDs are not connected yet, so you only see the numbers change.)5The I2C expander and the four knob buttons
The ESP32 has run out of pins, so a small chip (MCP23017) reads the four knob buttons and passes the result on over two wires.
Parts for this step
- MCP23017-E/SP (28-pin DIP chip)
- Two 4.7 kΩ resistors (R21, R22)
- 0.1 µF ceramic capacitor
- 12 wires
Do this
- Find pin 1 of the chip: the end with the half-round notch or dot. Pins number up one side, then back down the other (a U shape).
- Press the chip across the centre channel with pin 1 at column 37 on the bottom row (
e) and the notch on the left. Chip legs bend easily: straighten them against a table edge first. - Add the two 4.7 kΩ pull-up resistors and the small ceramic capacitor (it has no polarity).
- Add the wires. The first six wires in the table give the chip power and set its address; SDA and SCL (cyan and teal) go to Board 1; the three button wires go from each knob's SW pin to the chip.
Wires to add
| # | Colour | From | To | What it does |
|---|---|---|---|---|
| 46 | orange | Board 2: d45 | Board 2: +3V3 rail, col 45 | Expander power (VDD, pin 9) to 3V3 |
| 47 | black | Board 2: d46 | Board 2: GND rail, col 43 | Expander ground (VSS, pin 10) to GND |
| 48 | orange | Board 2: g47 | Board 2: +3V3 rail, col 47 | Expander RESET (pin 18) held high at 3V3 |
| 49 | black | Board 2: g48 | Board 2: GND rail, col 47 | Address pin A2 (pin 17) to GND |
| 50 | black | Board 2: g49 | Board 2: GND rail, col 49 | Address pin A1 (pin 16) to GND |
| 51 | black | Board 2: g50 | Board 2: GND rail, col 50 | Address pin A0 (pin 15) to GND (all three: address 0x20) |
| 52 | cyan | Board 1: i15 | Board 2: a49 | I2C data (SDA): ESP32 GPIO17 |
| 53 | teal | Board 1: i17 | Board 2: a48 | I2C clock (SCL): ESP32 GPIO16 |
| 54 | purple | Board 2: f5 | Board 2: g44 | HUE knob button (SW) to the expander's GPA0 |
| 55 | cyan | Board 2: f29 | Board 2: g41 | Speed knob button (SW) to the expander's GPA3 (it was ESP32 GPIO40 until 2026-11-10) |
| 56 | green | Board 2: f13 | Board 2: d42 | SAT knob button (SW) to the expander's GPB5 |
| 57 | yellow | Board 2: f21 | Board 2: g39 | VAL knob button (SW) to the expander's GPA5 |
6Lighting: the LED buffers and the LED strip
The ESP32-S3-ETH drives the LEDs itself. A 74AHCT125 chip lifts its 3.3 V data and clock signals to 5 V for the LEDs, and a 5 V adapter powers the strip.
Parts for this step
- Breadboard 3, 74AHCT125 chip, 330 Ω ×2, 10 kΩ ×2, 0.1 µF
- 8-LED APA102 or SK9822 strip, 4 wires or pads
- 5 V DC adapter (2 A) and a barrel-jack-to-screw-terminal adapter
- About 24 wires
Do this
- Switch everything off. Press the 74AHCT125 chip across the channel, pin 1 (notch end) at column 34, bottom row. Add R18, R26, R61, R62 and the 0.1 µF capacitor between the two top rails.
- Power: connect the 5 V adapter to the top rails (+ to +5V, − to GND). Never join the 5 V rails to the 3.3 V or 12 V rails.
- Wire the chip. Gate 1 carries the data and gate 2 the clock; the extra wires tie the two unused gates down so they do not pick up noise.
- Join the two boards: ground, GPIO18 (data) and GPIO2 (clock).
- Connect the strip: +5V and GND to the rails, DIN to the chip's pin 3 and CKI to its pin 6. Check the pad names on your strip: some say DI and CI.
Wires to add
| # | Colour | From | To | What it does |
|---|---|---|---|---|
| 58 | rose | 5 V adapter + | Board 3: +5V rail, col 5 | 5 V adapter + to the +5V rail |
| 59 | black | 5 V adapter − | Board 3: GND rail, col 8 | 5 V adapter − to the GND rail |
| 60 | rose | Board 3: +5V rail, col 62 | Board 3: +5V rail, col 62 | Joins the +5V rails |
| 61 | black | Board 3: GND rail, col 61 | Board 3: GND rail, col 61 | Joins the GND rails |
| 62 | black | Board 3: a32 | Board 3: GND rail, col 32 | Column 32 to GND, for R26 (holds the data input low while the ESP32 starts) |
| 63 | black | Board 3: a42 | Board 3: GND rail, col 43 | Column 42 to GND, for R62 (holds the clock input low while the ESP32 starts) |
| 64 | black | Board 3: a34 | Board 3: GND rail, col 34 | 74AHCT125 pin 1 (gate 1 output enable, active low) to GND |
| 65 | black | Board 3: a37 | Board 3: GND rail, col 37 | 74AHCT125 pin 4 (gate 2 output enable, active low) to GND |
| 66 | black | Board 3: a40 | Board 3: GND rail, col 40 | 74AHCT125 ground (pin 7) to GND |
| 67 | black | Board 3: g39 | Board 3: GND rail, col 39 | Unused gate 3: pin 9 (input) to GND |
| 68 | rose | Board 3: g38 | Board 3: +5V rail, col 38 | Unused gate 3: pin 10 (OE) to +5V, which switches it off |
| 69 | black | Board 3: g36 | Board 3: GND rail, col 37 | Unused gate 4: pin 12 (input) to GND |
| 70 | rose | Board 3: g35 | Board 3: +5V rail, col 35 | Unused gate 4: pin 13 (OE) to +5V |
| 71 | rose | Board 3: g34 | Board 3: +5V rail, col 34 | 74AHCT125 power (VCC, pin 14) to +5V |
| 72 | lime | Board 3: a36 | LED strip DIN | LED data out (74AHCT125 pin 3) to the strip's DIN pad |
| 73 | teal | Board 3: a39 | LED strip CKI | LED clock out (74AHCT125 pin 6) to the strip's CKI pad |
| 74 | rose | LED strip +5V | Board 3: +5V rail, col 45 | LED strip +5V to the +5V rail |
| 75 | black | LED strip GND | Board 3: GND rail, col 47 | LED strip GND to the GND rail |
| 76 | lime | Board 1: i18 | Board 3: a30 | LED data: ESP32 GPIO18 to R18 |
| 77 | teal | Board 1: i23 | Board 3: a44 | LED clock: ESP32 GPIO2 to R61 |
| 78 | black | Board 1: GND rail, col 61 | Board 3: GND rail, col 59 | Ground link between the Brain board and the Lighting board |
Strip does nothing? Check that DIN and CKI are not swapped, that the strip has 5 V at its +5V pad, and that the GND link between the boards is in. Wrong colours? Change Colour order on the LEDs tab (RBG for the SK9822; many APA102 strips are BGR).
Only have a WS2812B strip? Set LED type to WS281x and order GRB on the LEDs tab, and wire only DIN; the clock gate is then unused.
7Optional: the cooling fan
A 12 V PWM fan on a small transistor switch. Skip this stage if you have no fan.
Parts for this step
- 12 V 4-wire PWM fan
- 2N7000 transistor (TO-92; a stand-in for the SOT-23 2N7002 on the board)
- R57 1 kΩ, R58 10 kΩ, R59 4.7 kΩ
- 4-pin male header, 9 wires
Do this
- Press the 4-pin male header into row
g, columns 46 to 49 (GND, +12V, TACH, PWM left to right) and plug the fan's 4-pin connector onto it. - Add the transistor and the three resistors, then the wires in the table.
Wires to add
| # | Colour | From | To | What it does |
|---|---|---|---|---|
| 79 | black | Board 1: j46 | Board 1: GND rail, col 46 | Fan ground to the GND rail |
| 80 | red | Board 1: j47 | Board 1: h36 | Fan +12 V to the driver's VM column (after diode D1) |
| 81 | black | Board 1: c56 | Board 1: GND rail, col 55 | Q6 source to GND |
| 82 | pink | Board 1: b15 | Board 1: b53 | Fan speed: ESP32 GPIO45 to R57 |
| 83 | blue | Board 1: c58 | Board 1: h49 | Q6 drain to the fan's PWM wire |
| 84 | green | Board 1: j52 | Board 2: g38 | Fan tach (through R59) to the expander's GPA6 |
The finished system
All three boards together.
- Speed knob: speeds up, slows, reverses; its button jumps to home speed and stops.
- TAP button: sets tempo.
- HUE / SAT / VAL knobs and their buttons change the strip.
- The
/liveand settings pages open; the log shows no errors. - Switching off: turn the 12 V adapter off first, wait a few seconds, then unplug the USB cables.
Reference
What the breadboard leaves out
| On the circuit board | On the breadboard | Why it is safe to leave out |
|---|---|---|
| 2 A resettable fuse on the 12 V side (the 5 V side has no fuse) | None | Small loads, and you are watching. Use a bench supply with a current limit of about 1 A if you have one. |
| TCA9555 expander (surface-mount, TSSOP-24) | MCP23017 (28-pin DIP) | The firmware drives either one: same address, same pins by function (GPAn = IO0_n, GPBn = IO1_n). |
| Surge and static diodes (TVS), reverse-polarity FET | Only the 1N5819 diode on 12 V | They protect against faults you do not have on a bench. |
| 1 kΩ and 100 Ω resistors and a TVS on every knob wire | Direct wires | Static protection for the panel wiring; not needed on a bench. |
| Two 74AHCT1G125 single-gate buffers (SMD) | 74AHCT125 DIP, two of four gates used | Same function. |
| 33 Ω resistors R63/R64 at the buffer outputs, and D33 feeding the buffers | Direct wires and the 5 V rail | They damp the cable to the ring and guard against a reversed supply; a short breadboard lead does not need them. |
| 178-LED SK9822 ring, about 4.5 A | 8-LED strip from a 5 V adapter | Keeps the current small. The strip proves the data and clock path. |
| Bulk capacitors (2 × 100 µF), bleeder resistor | One 100 µF capacitor | Enough to keep the driver steady at this size. |
| Ring thermistor on GPIO3 (10 kΩ pull-up, 1 kΩ, 100 nF; the NTC on the ring) | GPIO3 left open | The firmware reports the ring sensor as open and runs the fan at full speed with a 3 A ring limit, which does not matter for an 8-LED strip. |
Every pin used, by signal
| Signal | ESP32 GPIO | ESP32-S3-ETH header | Goes to |
|---|---|---|---|
| STEP | 46 | H2 pin 6 | TMC2209 STEP |
| DIR | 48 | H2 pin 4 | TMC2209 DIR |
| ENABLE | 0 | H1 pin 17 | TMC2209 EN (and 1 kΩ to 3V3) |
| UART RX / TX | 15 / 47 | H1 pin 12 / H2 pin 5 | TMC2209 PDN (TX through 1 kΩ) |
| Speed knob CLK / DT | 38 / 39 | H2 pins 14 / 12 | KY-040 (Panel board); its button goes to the expander |
| HUE knob CLK / DT | 1 / 40 | H1 pin 16 / H2 pin 11 | KY-040 |
| SAT knob CLK / DT | 43 / 44 | H1 pins 20 / 19 | KY-040 |
| VAL knob CLK / DT | 41 / 42 | H2 pins 10 / 9 | KY-040 |
| TAP button | 21 | H1 pin 6 | Push button to GND |
| I2C SDA / SCL | 17 / 16 | H1 pins 7 / 9 | MCP23017 pins 13 / 12 |
| LED data / clock | 18 / 2 | H1 pins 10 / 15 | 74AHCT125 pins 2 / 5 through 330 Ω |
| Fan PWM | 45 | H2 pin 7 | 2N7000 gate via 1 kΩ |
Where each knob button goes
The four knob buttons are read by the expander: HUE → GPA0 (pin 21), speed → GPA3 (pin 24), VAL → GPA5 (pin 26), SAT → GPB5 (pin 6), fan tach → GPA6 (pin 27).
Troubleshooting
- Always check first: is it plugged in firmly? is the wire in the right column and the right half (top or bottom) of the board?
- Random behaviour: a missing ground. Every board must share ground, with the link wires in.
- The module gets hot: unplug it now. Something is backwards (a chip, a capacitor or the driver).
- Useful tool: set a multimeter to "continuity" (the beep symbol) and touch both ends of a wire; it beeps if the connection is good. Use it to check that a pin and the hole you wired are really connected.
Source of the wiring: the mainboard schematic. This page is generated by docs/breadboard/build_breadboard_guide.py.