jjiihhggffeeddccbbaa115510101515202025253030353540404545505055556060

Breadboard the Liquid Turntable

A picture-by-picture guide to building the whole controller on solderless breadboards before the circuit board is made. No soldering of the circuit, no experience needed: you push parts into holes and join them with jumper wires, one small step at a time, and test after each step.

Every connection here comes from the project's schematic, so what you build behaves like the real board.

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:

  1. Brain board: the ESP32-S3-ETH (the main computer) and the stepper driver that moves the motor.
  2. Panel board: four knobs, a tap button and a small chip (an I2C expander) that reads three of the knob buttons.
  3. 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.
Safety rules (these protect your parts and you)
  • 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

++−−−−++BREADBOARD 0
  • 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

+12 V+5 V+3.3 VGroundSpeed knobHue knobSaturation knobValue knobTap buttonStepDirectionDriver enableUART / I2C clockI2C dataUART / LED data

Parts you need

PartWhat to get
Breadboards3 full-size, 830-point boards (63 columns, 10 lettered rows, 2 power rails on each long edge)
ESP32-S3-ETHWaveshare ESP32-S3-ETH with the header pins soldered on (the pre-soldered version). USB-C cable.
TMC2209 stepper driverBigTreeTech TMC2209 V1.3 (or a compatible StepStick-style TMC2209) with header pins
Stepper motorNEMA17, for example StepperOnline 17HS08-1004S (black, green, red, blue wires)
12 V power12 V DC adapter, 1 A or more, and a barrel-jack-to-screw-terminal adapter (or a bench supply)
5 V power5 V DC adapter, 2 A or more, and a second barrel-jack-to-screw-terminal adapter
MCP23017-E/SP28-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 modules4 pieces, 5-pin
Push button1 tactile button (4-leg, 6 mm)
LED strip8 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)
Capacitors100 µF 35 V electrolytic ×1 (use 2 if you have them, in parallel), 0.1 µF ceramic ×3
Diode1N5819 (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 wiresA 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
ToolsMultimeter, 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.

Where the breadboard differs from the real circuit boardThe breadboard is built for learning and testing, so it leaves out some protection parts that matter on the finished board: the 2 A resettable fuse, the 3.3 V converter (the ESP32 module makes the 3.3 V for you here), the surge and static diodes, the reverse-polarity circuit, and the 178-LED ring. The final reference section lists them all. Wiring is the same everywhere else.

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

Why no 3.3 V converter?On the finished board a separate converter makes the 3.3 V. On the breadboard the ESP32-S3-ETH's own regulator does it, powered from USB, and its 3V3 pin supplies the other chips. The loads here are small (the driver's logic, one chip and four knobs).

Do this

  1. Put Breadboard 1 in front of you with row letters matching the picture. Join the rails by adding wire 3 first.
  2. 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 h and the other in row c. 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.
  3. Add wires 1 and 2 (ground) and 3 (links the top and bottom ground rails). Do not connect the pin labelled 3V3_EN to anything: on the finished board it is grounded, but here the module must make its own 3.3 V.
+12V+12VGNDGNDGNDGNDBREADBOARD 1RJ45USB-CESP32-S3ESP32-S3-ETH(Waveshare)VBUSVSYSGND3V3_EN3V3GP21GP17GNDGP16GP18CHIP_PUGP15GNDGP3GP2GP1GP0GNDGP44GP43GP20GP19GNDGP48GP47GP46GP45GNDGP42GP41GP40GP39GNDGP38GP37GP36GP35GNDGP34GP33pin 1pin 1123

Wires to add

#ColourFromToWhat it does
1 blackBoard 1: i16Board 1: GND rail, col 16ESP32 ground (top row, pin 8) to the top GND rail
2 blackBoard 1: b16Board 1: GND rail, col 16ESP32 ground (bottom row, pin 8) to the bottom GND rail
3 blackBoard 1: GND rail, col 62Board 1: GND rail, col 62Joins the top and bottom GND rails so both sides share ground
Test it
  1. Plug the USB-C cable from your computer into the ESP32-S3-ETH. A light on the module comes on.
  2. Flash the firmware as described in the README (the arduino-cli compile / upload commands there; the board name must have CDCOnBoot=cdc). Open the serial monitor at 115200 baud. You should see the boot messages and, with an Ethernet cable plugged in, ETH got IP.
  3. 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).
Nothing lights up? Try another USB cable (some only charge) and check the module is pressed all the way in.

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

Power order mattersUnplug both the 12 V adapter and the USB cable before wiring this step. Never plug in or unplug the motor with 12 V on. Never power the 12 V with the driver or motor wires loose.

Do this

  1. 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.
  2. Add the diode D1 from j33 to j36 with the stripe (cathode) on the right, at the driver end. The stripe must point toward the driver.
  3. Add the 100 µF capacitor. Electrolytic capacitors have a + leg (longer) and a stripe on the − side. The + leg goes in i36 and the stripe (−) leg in i37. Backwards, it can pop. Check twice.
  4. Add the two 1 kΩ resistors (R23 from j25 to j31, R9 from a34 to a40), then wires 4 to 23 from the table. Do the power wires (red and black from the adapter) last.
  5. 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.
  6. 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.)
+12V+12VGNDGNDGNDGNDBREADBOARD 1RJ45USB-CESP32-S3ESP32-S3-ETH(Waveshare)VBUSVSYSGND3V3_EN3V3GP21GP17GNDGP16GP18CHIP_PUGP15GNDGP3GP2GP1GP0GNDGP44GP43GP20GP19GNDGP48GP47GP46GP45GNDGP42GP41GP40GP39GNDGP38GP37GP36GP35GNDGP34GP33pin 1pin 1+−12 V DC adapterNEMA17TMC2209VMGNDA2A1B1B2VIOGNDENMS1MS2PDNPDNCLKSTEPDIREN / VMendD1 1N5819−+100µF 35VR23 1kR9 1k4567891011121314151617181920212223

Wires to add

#ColourFromToWhat it does
4 red12 V adapter +Board 1: +12V rail, col 412 V adapter + to the +12V rail
5 black12 V adapter −Board 1: GND rail, col 512 V adapter − to the GND rail
6 redBoard 1: +12V rail, col 33Board 1: i33+12V rail to the diode D1 (anode side)
7 blackBoard 1: j37Board 1: GND rail, col 37Driver ground (pin 2, top row) to the GND rail
8 blackBoard 1: j43Board 1: GND rail, col 43Driver ground (pin 8, top row) to the GND rail
9 orangeBoard 1: i13Board 1: i31ESP32 3V3 pin to the 3V3 junction (column 31)
10 orangeBoard 1: h31Board 1: i423V3 junction to the driver's logic supply (VIO)
11 greenmotor green (A−)Board 1: i38Motor green wire (A−)
12 blackmotor black (A+)Board 1: i39Motor black wire (A+)
13 redmotor red (B+)Board 1: i40Motor red wire (B+)
14 bluemotor blue (B−)Board 1: i41Motor blue wire (B−)
15 blackBoard 1: b37Board 1: GND rail, col 37Driver MS1 to GND (selects driver address 0)
16 blackBoard 1: b38Board 1: GND rail, col 38Driver MS2 to GND (selects driver address 0)
17 blackBoard 1: b41Board 1: GND rail, col 41Driver CLK to GND (use the internal clock)
18 limeBoard 1: b39Board 1: b40Joins the driver's two PDN pins together
19 tealBoard 1: a39Board 1: i20UART receive: driver PDN to ESP32 GPIO15
20 limeBoard 1: b13Board 1: b34UART transmit: ESP32 GPIO47 to R9 (the 1k resistor)
21 pinkBoard 1: b14Board 1: b42STEP: ESP32 GPIO46 to the driver's STEP pin
22 brownBoard 1: b12Board 1: b43DIR: ESP32 GPIO48 to the driver's DIR pin
23 greyBoard 1: i25Board 1: b36ENABLE: ESP32 GPIO0 to the driver's EN pin
Test it
  1. Power: plug in USB (ESP32), then the 12 V adapter. Never the other way with the motor loose.
  2. The serial monitor shows the driver being set up: look for TMC2209 UART lines such as microsteps confirmed and current reference is UART.
  3. The motor shaft should feel held (stiffer to turn by hand).
  4. Open http://liquidturntable.local/live on a phone or computer on the same network and press Start. The shaft should turn smoothly. Press Stop.
Motor only buzzes, shudders or turns roughly? The coil wires are paired wrongly. Switch everything off and unplug the motor. With a multimeter on the ohms range, find which two motor wires read a few ohms between them: those are one coil, and they must go to the matching pair of columns (A− and A+ together, B+ and B− together). Move the wires so each coil's pair sits in its own two columns. Turns the wrong way? That is fine: tick Reverse motor direction on the settings page.

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

Do this

  1. Switch everything off.
  2. 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.)
  3. Press the button across the centre channel, columns 56 and 58. It has four legs; this works whichever way round it goes.
  4. 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.
+12V+12VGNDGNDGNDGNDBREADBOARD 1+3V3+3V3GNDGNDGNDGND+3V3+3V3BREADBOARD 2RJ45USB-CESP32-S3ESP32-S3-ETH(Waveshare)VBUSVSYSGND3V3_EN3V3GP21GP17GNDGP16GP18CHIP_PUGP15GNDGP3GP2GP1GP0GNDGP44GP43GP20GP19GNDGP48GP47GP46GP45GNDGP42GP41GP40GP39GNDGP38GP37GP36GP35GNDGP34GP33pin 1pin 1+−12 V DC adapterNEMA17TMC2209VMGNDA2A1B1B2VIOGNDENMS1MS2PDNPDNCLKSTEPDIREN / VMendD1 1N5819−+100µF 35VR23 1kR9 1kSPEEDGND+SWDTCLKTAP buttonto B2: GND rail24to B1: GND rail24to B2: +3V3 rail25to B1: g312526272829to B2: f3130to B1: b2230to B2: f3031to B1: b203132to B2: g5833to B1: i1433

Wires to add

#ColourFromToWhat it does
24 blackBoard 1: GND rail, col 59Board 2: GND rail, col 59Ground link between the Brain board and the Panel board
25 orangeBoard 1: g31Board 2: +3V3 rail, col 573V3 from the Brain board's junction (column 31) to the Panel board's 3V3 rail
26 blackBoard 2: GND rail, col 62Board 2: GND rail, col 62Joins the Panel board's top and bottom GND rails
27 orangeBoard 2: +3V3 rail, col 61Board 2: +3V3 rail, col 61Joins the Panel board's top and bottom 3V3 rails
28 blackBoard 2: f27Board 2: GND rail, col 27Speed knob GND pin to GND
29 orangeBoard 2: f28Board 2: +3V3 rail, col 28Speed knob + pin to 3V3
30 blueBoard 1: b22Board 2: f31Speed knob CLK: ESP32 GPIO38
31 lightblueBoard 1: b20Board 2: f30Speed knob DT: ESP32 GPIO39
32 blackBoard 2: d56Board 2: GND rail, col 56TAP button to GND
33 whiteBoard 1: i14Board 2: g58TAP button signal: ESP32 GPIO21
Test it
  1. Power up (USB first, then 12 V).
  2. 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.
  3. Press the knob once: it jumps to the home speed. Press again: it stops.
  4. Press the TAP button four times in time: the BPM shown changes.
The number goes up two or four per click? Normal for some modules; the README ("Encoder step size") says what to change. Nothing happens? Check that + goes to 3V3 (not GND) and the module is in row j.

4The other three knobs

Hue, Saturation and Value (brightness): same wiring as the speed knob, different pins.

Parts for this step

Do this

  1. Plug the three KY-040 modules into row j of 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.
  2. Add the wires from the table: power wires (black and orange) to the rails, and the long tagged wires to Board 1.
  3. The knobs' push buttons (SW pins) are not wired yet. They go through the expander chip in the next step.
+12V+12VGNDGNDGNDGNDBREADBOARD 1+3V3+3V3GNDGNDGNDGND+3V3+3V3BREADBOARD 2RJ45USB-CESP32-S3ESP32-S3-ETH(Waveshare)VBUSVSYSGND3V3_EN3V3GP21GP17GNDGP16GP18CHIP_PUGP15GNDGP3GP2GP1GP0GNDGP44GP43GP20GP19GNDGP48GP47GP46GP45GNDGP42GP41GP40GP39GNDGP38GP37GP36GP35GNDGP34GP33pin 1pin 1+−12 V DC adapterNEMA17TMC2209VMGNDA2A1B1B2VIOGNDENMS1MS2PDNPDNCLKSTEPDIREN / VMendD1 1N5819−+100µF 35VR23 1kR9 1kSPEEDGND+SWDTCLKTAP buttonHUEGND+SWDTCLKSATGND+SWDTCLKVALGND+SWDTCLK3435to B2: f736to B1: i2436to B2: f637to B1: b19373839to B2: f1540to B1: i2840to B2: f1441to B1: i27414243to B2: f2344to B1: b1844to B2: f2245to B1: b1745to B2: GND railto B1: GND railto B2: +3V3 railto B1: g31to B2: f31to B1: b22to B2: f30to B1: b20to B2: g58to B1: i14

Wires to add

#ColourFromToWhat it does
34 blackBoard 2: f3Board 2: GND rail, col 3HUE knob GND pin to GND
35 orangeBoard 2: f4Board 2: +3V3 rail, col 4HUE knob + pin to 3V3
36 purpleBoard 1: i24Board 2: f7HUE knob CLK: ESP32 GPIO1
37 pinkBoard 1: b19Board 2: f6HUE knob DT: ESP32 GPIO40
38 blackBoard 2: f11Board 2: GND rail, col 11SAT knob GND pin to GND
39 orangeBoard 2: f12Board 2: +3V3 rail, col 13SAT knob + pin to 3V3
40 greenBoard 1: i28Board 2: f15SAT knob CLK: ESP32 GPIO43
41 limeBoard 1: i27Board 2: f14SAT knob DT: ESP32 GPIO44
42 blackBoard 2: f19Board 2: GND rail, col 19VAL knob GND pin to GND
43 orangeBoard 2: f20Board 2: +3V3 rail, col 20VAL knob + pin to 3V3
44 yellowBoard 1: b18Board 2: f23VAL knob CLK: ESP32 GPIO41
45 whiteBoard 1: b17Board 2: f22VAL knob DT: ESP32 GPIO42
Test itOpen the /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

Do this

  1. 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).
  2. 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.
  3. Add the two 4.7 kΩ pull-up resistors and the small ceramic capacitor (it has no polarity).
  4. 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.
+3V3+3V3GNDGNDGNDGND+3V3+3V3BREADBOARD 2SPEEDGND+SWDTCLKTAP buttonHUEGND+SWDTCLKSATGND+SWDTCLKVALGND+SWDTCLKMCP23017GPB0GPA7GPB1GPA6GPB2GPA5GPB3GPA4GPB4GPA3GPB5GPA2GPB6GPA1GPB7GPA0VDDINTAVSSINTBNCRESETSCLA2SDAA1NCA0pin 1R21 4.7kR22 4.7k1040.1µF464748495051to B1: i1552to B1: i175354555657to B1: GND railto B1: g31to B1: b22to B1: b20to B1: i14to B1: i24to B1: b19to B1: i28to B1: i27to B1: b18to B1: b17

Wires to add

#ColourFromToWhat it does
46 orangeBoard 2: d45Board 2: +3V3 rail, col 45Expander power (VDD, pin 9) to 3V3
47 blackBoard 2: d46Board 2: GND rail, col 43Expander ground (VSS, pin 10) to GND
48 orangeBoard 2: g47Board 2: +3V3 rail, col 47Expander RESET (pin 18) held high at 3V3
49 blackBoard 2: g48Board 2: GND rail, col 47Address pin A2 (pin 17) to GND
50 blackBoard 2: g49Board 2: GND rail, col 49Address pin A1 (pin 16) to GND
51 blackBoard 2: g50Board 2: GND rail, col 50Address pin A0 (pin 15) to GND (all three: address 0x20)
52 cyanBoard 1: i15Board 2: a49I2C data (SDA): ESP32 GPIO17
53 tealBoard 1: i17Board 2: a48I2C clock (SCL): ESP32 GPIO16
54 purpleBoard 2: f5Board 2: g44HUE knob button (SW) to the expander's GPA0
55 cyanBoard 2: f29Board 2: g41Speed knob button (SW) to the expander's GPA3 (it was ESP32 GPIO40 until 2026-11-10)
56 greenBoard 2: f13Board 2: d42SAT knob button (SW) to the expander's GPB5
57 yellowBoard 2: f21Board 2: g39VAL knob button (SW) to the expander's GPA5
Test itPower up. Press the HUE knob: the colour resets to red. SAT: toggles white. VAL: brightness returns to 100%. If a button does nothing, check its single wire first, then the 3V3 and GND wires to the chip. The serial log reports if the expander is not found.

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

Nothing to set upThe firmware drives an SK9822 ring on GPIO18 (data) and GPIO2 (clock) as delivered, and the strip shows the first eight LEDs of it. The settings are on the LEDs tab of the settings page. Each LED is held to 36.6 mA, so the 8-LED strip draws at most about 0.3 A.

Do this

  1. 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.
  2. 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.
  3. 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.
  4. Join the two boards: ground, GPIO18 (data) and GPIO2 (clock).
  5. 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.
+5V+5VGNDGNDGNDGND+5V+5VBREADBOARD 3+12V+12VGNDGNDGNDGNDBREADBOARD 1RJ45USB-CESP32-S3ESP32-S3-ETH(Waveshare)VBUSVSYSGND3V3_EN3V3GP21GP17GNDGP16GP18CHIP_PUGP15GNDGP3GP2GP1GP0GNDGP44GP43GP20GP19GNDGP48GP47GP46GP45GNDGP42GP41GP40GP39GNDGP38GP37GP36GP35GNDGP34GP33pin 1pin 1+−12 V DC adapterNEMA17TMC2209VMGNDA2A1B1B2VIOGNDENMS1MS2PDNPDNCLKSTEPDIREN / VMendD1 1N5819−+100µF 35VR23 1kR9 1k74AHCT1251OEVCC1A4OE1Y4A2OE4Y2A3OE2Y3AGND3Ypin 1R18 330ΩR26 10kR61 330ΩR62 10k1040.1µF8-LED APA102 / SK9822 strip+5VCKIDINGND+−5 V DC adapter, 2 A585960616263646566676869707172737475to B3: a3076to B1: i1876to B3: a4477to B1: i2377to B3: GND rail78to B1: GND rail78to B2: GND railto B2: +3V3 railto B2: f31to B2: f30to B2: g58to B2: f7to B2: f6to B2: f15to B2: f14to B2: f23to B2: f22to B2: a49to B2: a48

Wires to add

#ColourFromToWhat it does
58 rose5 V adapter +Board 3: +5V rail, col 55 V adapter + to the +5V rail
59 black5 V adapter −Board 3: GND rail, col 85 V adapter − to the GND rail
60 roseBoard 3: +5V rail, col 62Board 3: +5V rail, col 62Joins the +5V rails
61 blackBoard 3: GND rail, col 61Board 3: GND rail, col 61Joins the GND rails
62 blackBoard 3: a32Board 3: GND rail, col 32Column 32 to GND, for R26 (holds the data input low while the ESP32 starts)
63 blackBoard 3: a42Board 3: GND rail, col 43Column 42 to GND, for R62 (holds the clock input low while the ESP32 starts)
64 blackBoard 3: a34Board 3: GND rail, col 3474AHCT125 pin 1 (gate 1 output enable, active low) to GND
65 blackBoard 3: a37Board 3: GND rail, col 3774AHCT125 pin 4 (gate 2 output enable, active low) to GND
66 blackBoard 3: a40Board 3: GND rail, col 4074AHCT125 ground (pin 7) to GND
67 blackBoard 3: g39Board 3: GND rail, col 39Unused gate 3: pin 9 (input) to GND
68 roseBoard 3: g38Board 3: +5V rail, col 38Unused gate 3: pin 10 (OE) to +5V, which switches it off
69 blackBoard 3: g36Board 3: GND rail, col 37Unused gate 4: pin 12 (input) to GND
70 roseBoard 3: g35Board 3: +5V rail, col 35Unused gate 4: pin 13 (OE) to +5V
71 roseBoard 3: g34Board 3: +5V rail, col 3474AHCT125 power (VCC, pin 14) to +5V
72 limeBoard 3: a36LED strip DINLED data out (74AHCT125 pin 3) to the strip's DIN pad
73 tealBoard 3: a39LED strip CKILED clock out (74AHCT125 pin 6) to the strip's CKI pad
74 roseLED strip +5VBoard 3: +5V rail, col 45LED strip +5V to the +5V rail
75 blackLED strip GNDBoard 3: GND rail, col 47LED strip GND to the GND rail
76 limeBoard 1: i18Board 3: a30LED data: ESP32 GPIO18 to R18
77 tealBoard 1: i23Board 3: a44LED clock: ESP32 GPIO2 to R61
78 blackBoard 1: GND rail, col 61Board 3: GND rail, col 59Ground link between the Brain board and the Lighting board
Test itPower up (USB for the ESP32, the 5 V adapter, then 12 V). The LEDs tab should show LED engine, SK9822 at about 100 frames a second. Turn the HUE knob: the strip changes colour; SAT changes how rich, VAL changes brightness. Press the SAT knob: the strip goes white; press again: the colour returns.
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

Check the 2N7000 pinoutWith the flat face towards you and the legs down, the legs of a 2N7000 are Source, Gate, Drain from left to right. The look-alike BS170 is Drain, Gate, Source: the opposite. Check your part's datasheet; a swapped transistor will not damage anything but the fan will not work.
Use a 12 V fanA 5 V fan on this circuit will be damaged. Only fans that are marked 12 V and have 4 wires (ground, +12 V, tach, PWM).

Do this

  1. 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.
  2. Add the transistor and the three resistors, then the wires in the table.
+12V+12VGNDGNDGNDGNDBREADBOARD 1+3V3+3V3GNDGNDGNDGND+3V3+3V3BREADBOARD 2RJ45USB-CESP32-S3ESP32-S3-ETH(Waveshare)VBUSVSYSGND3V3_EN3V3GP21GP17GNDGP16GP18CHIP_PUGP15GNDGP3GP2GP1GP0GNDGP44GP43GP20GP19GNDGP48GP47GP46GP45GNDGP42GP41GP40GP39GNDGP38GP37GP36GP35GNDGP34GP33pin 1pin 1+−12 V DC adapterNEMA17TMC2209VMGNDA2A1B1B2VIOGNDENMS1MS2PDNPDNCLKSTEPDIREN / VMendD1 1N5819−+100µF 35VR23 1kR9 1kSPEEDGND+SWDTCLKTAP buttonHUEGND+SWDTCLKSATGND+SWDTCLKVALGND+SWDTCLKMCP23017GPB0GPA7GPB1GPA6GPB2GPA5GPB3GPA4GPB4GPA3GPB5GPA2GPB6GPA1GPB7GPA0VDDINTAVSSINTBNCRESETSCLA2SDAA1NCA0pin 1R21 4.7kR22 4.7k1040.1µFGND+12VTACHPWMfan plug fits here12 V 4-wire PWM fan (optional)2N7000SGDQ6 2N7000R57 1kR58 10kR59 4.7k7980818283to B2: g3884to B1: j5284to B2: GND railto B1: GND railto B2: +3V3 railto B1: g31to B2: f31to B1: b22to B2: f30to B1: b20to B2: g58to B1: i14to B2: f7to B1: i24to B2: f6to B1: b19to B2: f15to B1: i28to B2: f14to B1: i27to B2: f23to B1: b18to B2: f22to B1: b17to B2: a49to B1: i15to B2: a48to B1: i17to B3: a30to B3: a44to B3: GND rail

Wires to add

#ColourFromToWhat it does
79 blackBoard 1: j46Board 1: GND rail, col 46Fan ground to the GND rail
80 redBoard 1: j47Board 1: h36Fan +12 V to the driver's VM column (after diode D1)
81 blackBoard 1: c56Board 1: GND rail, col 55Q6 source to GND
82 pinkBoard 1: b15Board 1: b53Fan speed: ESP32 GPIO45 to R57
83 blueBoard 1: c58Board 1: h49Q6 drain to the fan's PWM wire
84 greenBoard 1: j52Board 2: g38Fan tach (through R59) to the expander's GPA6
Test itWith the firmware running, the fan follows the chip temperature (it starts at the minimum speed, 25%). The status page shows tach turning. As a safety test, unplug the USB (ESP32 off) with 12 V still on: the fan should go to full speed.

The finished system

All three boards together.

+12V+12VGNDGNDGNDGNDBREADBOARD 1+3V3+3V3GNDGNDGNDGND+3V3+3V3BREADBOARD 2+5V+5VGNDGNDGNDGND+5V+5VBREADBOARD 3RJ45USB-CESP32-S3ESP32-S3-ETH(Waveshare)VBUSVSYSGND3V3_EN3V3GP21GP17GNDGP16GP18CHIP_PUGP15GNDGP3GP2GP1GP0GNDGP44GP43GP20GP19GNDGP48GP47GP46GP45GNDGP42GP41GP40GP39GNDGP38GP37GP36GP35GNDGP34GP33pin 1pin 1+−12 V DC adapterNEMA17TMC2209VMGNDA2A1B1B2VIOGNDENMS1MS2PDNPDNCLKSTEPDIREN / VMendD1 1N5819−+100µF 35VR23 1kR9 1kSPEEDGND+SWDTCLKTAP buttonHUEGND+SWDTCLKSATGND+SWDTCLKVALGND+SWDTCLKMCP23017GPB0GPA7GPB1GPA6GPB2GPA5GPB3GPA4GPB4GPA3GPB5GPA2GPB6GPA1GPB7GPA0VDDINTAVSSINTBNCRESETSCLA2SDAA1NCA0pin 1R21 4.7kR22 4.7k1040.1µF74AHCT1251OEVCC1A4OE1Y4A2OE4Y2A3OE2Y3AGND3Ypin 1R18 330ΩR26 10kR61 330ΩR62 10k1040.1µF8-LED APA102 / SK9822 strip+5VCKIDINGND+−5 V DC adapter, 2 AGND+12VTACHPWMfan plug fits here12 V 4-wire PWM fan (optional)2N7000SGDQ6 2N7000R57 1kR58 10kR59 4.7k7980818283to B2: g3884to B1: j5284to B2: GND railto B1: GND railto B2: +3V3 railto B1: g31to B2: f31to B1: b22to B2: f30to B1: b20to B2: g58to B1: i14to B2: f7to B1: i24to B2: f6to B1: b19to B2: f15to B1: i28to B2: f14to B1: i27to B2: f23to B1: b18to B2: f22to B1: b17to B2: a49to B1: i15to B2: a48to B1: i17to B3: a30to B1: i18to B3: a44to B1: i23to B3: GND railto B1: GND rail
Final checklist
  • 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 /live and 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 boardOn the breadboardWhy it is safe to leave out
2 A resettable fuse on the 12 V side (the 5 V side has no fuse)NoneSmall 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 FETOnly the 1N5819 diode on 12 VThey protect against faults you do not have on a bench.
1 kΩ and 100 Ω resistors and a TVS on every knob wireDirect wiresStatic protection for the panel wiring; not needed on a bench.
Two 74AHCT1G125 single-gate buffers (SMD)74AHCT125 DIP, two of four gates usedSame function.
33 Ω resistors R63/R64 at the buffer outputs, and D33 feeding the buffersDirect wires and the 5 V railThey 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 A8-LED strip from a 5 V adapterKeeps the current small. The strip proves the data and clock path.
Bulk capacitors (2 × 100 µF), bleeder resistorOne 100 µF capacitorEnough 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 openThe 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

SignalESP32 GPIOESP32-S3-ETH headerGoes to
STEP46H2 pin 6TMC2209 STEP
DIR48H2 pin 4TMC2209 DIR
ENABLE0H1 pin 17TMC2209 EN (and 1 kΩ to 3V3)
UART RX / TX15 / 47H1 pin 12 / H2 pin 5TMC2209 PDN (TX through 1 kΩ)
Speed knob CLK / DT38 / 39H2 pins 14 / 12KY-040 (Panel board); its button goes to the expander
HUE knob CLK / DT1 / 40H1 pin 16 / H2 pin 11KY-040
SAT knob CLK / DT43 / 44H1 pins 20 / 19KY-040
VAL knob CLK / DT41 / 42H2 pins 10 / 9KY-040
TAP button21H1 pin 6Push button to GND
I2C SDA / SCL17 / 16H1 pins 7 / 9MCP23017 pins 13 / 12
LED data / clock18 / 2H1 pins 10 / 1574AHCT125 pins 2 / 5 through 330 Ω
Fan PWM45H2 pin 72N7000 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

Source of the wiring: the mainboard schematic. This page is generated by docs/breadboard/build_breadboard_guide.py.