TONWERK.MODUL

Build guide

Step by step from ordering to the first sound: Tonwerk Wavetable as a Eurorack module on the through-hole boards (v0.1), everything to solder yourself; only the ESP32 DevKit and the DAC module come ready-made and are plugged in.

If you would rather not solder that much: the main board also comes as an assembled SMD variant that the board manufacturer delivers soldered.

Important for the v0.1 boards: the silkscreen of the two LEDs is the wrong way round. Inserted as printed, +5 V and ground reach the LED swapped, and it burns out the first time it is powered. The right orientation is in step 5.

As of 28 October 2026: one module has been built following this guide and plays (27 October 2026). Not yet tested on the hardware: the CV inputs and the V/Oct calibration. If you build one, feedback on GitHub helps improve the guide and the boards. File names and the boards' labels are German: Hauptplatine is the main board, Bedienplatine the control board, Frontplatte the front panel, Knopf a knob.

Downloads

Firmware (.bin) Front panel (.stl) Ten knobs (.3mf)

All files are in the folder esp32-wavetable on GitHub, together with the sources (KiCad, OpenSCAD, firmware).

WhatFiles
Boards to order (Gerber)Main board · Control board
SchematicsMain board (PDF) · Control board (PDF)
Shopping listeinkaufsliste-tht.csv (also below as a table) · lists for uploading to distributors' tools: in the pcb folder
Bills of materials by valueMain board · Control board
Assembled variant (SMD)Main board: Gerber · bill of materials (BOM) · placement (CPL) · schematic · by hand
Control board: Gerber · BOM · CPL · schematic · by hand
Front panelraised lettering · engraved lettering · inlaid lettering (3MF, two colours) · 1:1 drilling template for aluminium
Front panel Physicalraised lettering · engraved lettering · inlaid lettering (3MF), for the second firmware
Front panel PDraised lettering · engraved lettering · inlaid lettering (3MF), for the third firmware
Front panel Granularraised lettering · engraved lettering · inlaid lettering (3MF), for the fourth firmware
Front panel Additivraised lettering · engraved lettering · inlaid lettering (3MF), for the fifth firmware
Knobsten knobs, two colours (3MF) · body · pointer · fit test · knopf.scad
Firmwaretonwerk-modul.bin (for address 0x0) · tonwerk-physical.bin (Tonwerk Physical, also 0x0) · tonwerk-pd.bin (Tonwerk PD, also 0x0) · tonwerk-granular.bin (Tonwerk Granular, 0x0, 6.7 MB with the sound sources) · tonwerk-additiv.bin (Tonwerk Additiv, 0x0) · source (ESP-IDF 5.3)

What you need

1. Ordering

Boards: upload the two Gerber zips (Downloads) to a board manufacturer, JLCPCB for example: 5 of each, 2 layers, 1.6 mm, HASL, without assembly. Leave the other settings as the manufacturer suggests. Both boards are 66 × 107.5 mm.

Parts: the shopping list below, an estimated €60–80 plus boards. DevKit, DAC module, pots, jacks and LEDs are cheapest from the large Chinese shippers, the chips, resistors and capacitors from any electronics distributor.

What matters:

Shopping list

QtyPartTypeWhereapprox. €
1Boardstonwerk-bedien-tht + tonwerk-haupt-tht, 5 of each, 2 layers, 1.6 mm, HASL, unassembled—15–30 with shipping
1Microcontroller boardESP32-S3-DevKitC-1 N16R8 (16 MB flash, 8 MB PSRAM), original or clone with the same pinoutMain U46–15
1DAC modulePCM5102A module GY-PCM5102 (purple, 6-pin header VIN GND LCK DIN BCK SCK)Main U52–4
1ADCMCP3208-CI/P (DIP-16)Main U94.50
2Op-ampMCP6004-I/P (DIP-14)Main U7 U81.40
1Op-ampTL072 (DIP-8)Main U60.40
1Buffer74HCT125 or 74AHCT125 (DIP-14), not 74HC125; equivalent without changing the board: 74HCT32 (DIP-14)Main U100.40
1Voltage regulator 3.0 VMCP1700-3002E/TO (TO-92)Main U30.50
1TransistorBC547 (TO-92)Main Q10.10
1Switching regulatorRecom R-78E5.0-0.5 (SIP-3)Main U13.00
3Schottky diode1N5817 (DO-41)Main D1-D30.20
4IC socket3 × DIP-14, 1 × DIP-16 (plus 1 × DIP-8, see next row)Main0.60
1IC socketDIP-8Main0.10
10Resistor 1 %100k (metal film 0207, 1/4 W)Main0.80
7Resistor 1 %1kMain0.60
5Resistor 1 %10kMain0.40
4Resistor 1 %30kMain0.30
2Resistor 1 %6.8kMain0.20
1Resistor 1 %37.4kMain0.10
1Resistor 1 %17.4kMain0.10
1Resistor 1 %16kMain0.10
1Resistor 1 %330 ΩMain0.10
1Resistor 1 %10 ΩMain0.10
20Ceramic capacitor100 nF X7R, 2.54 mm pitch (18 main, 2 control)both1.20
5Ceramic capacitor10 nF, 2.54 mm pitchMain0.30
2Ceramic capacitor1 µF X7R, 2.54 mm pitchMain0.30
4Electrolytic capacitor10 µF 25 V radial, 5 mm diameter, at most 11 mm tall, 2 mm pitchMain0.40
2Female header1 × 22, 2.54 mm pitch, 8.5 mm tall (or cut 2 × 1 × 40 down)Main (DevKit)1.50
1Female header1 × 6, 2.54 mm pitch, 8.5 mm tallMain (DAC module)0.30
2Female header1 × 14, 2.54 mm pitch, 8.5 mm tallMain J3 J40.80
2Pin header1 × 14, 2.54 mm pitch, straightControl J3 J40.30
1Boxed header2 × 5, 2.54 mm pitch, straightMain J10.30
—Hook-up wire3 short wires from the DAC module's output (L, ground, R) to J13Main—
10PotentiometerAlpha 9 mm vertical, B10K linear (footprint Alpha RD901F), shaft to match the knobsControl3–6
10Knobthe knobs to print (above), otherwise to match the shaft, at most 13 mm diameter——
8Jack socketPJ398SM (Thonkiconn or clone)Control2–4
2Push button6 × 6 mm, 13 mm tallControl0.50
2RGB LEDWS2812D-F5, 5 mm through-hole (check the pinout 1 DIN, 2 VDD, 3 GND, 4 DOUT)Control1–2
1Eurorack cableribbon cable 10 to 16 pin—1–2
2StandoffsM3 × 11 mm female/female + 4 screws M3 × 5—1.00
4Rack screwsM3 × 6 with nylon washers—0.50
1Front panelprint frontplatte.stl (above)—1.00

2. Printing the front panel and knobs

Preview of the front panel: 14 HP, black with yellow lettering

14 HP (70.8 × 128.5 mm), 2.5 mm thick, with slots for the rack screws. Three variants, all already oriented for printing (PETG or PLA, 0.2 mm layers):

For the Physical firmware there are the same three variants with its lettering (frontplatte-physical*.stl, frontplatte-physical-einlage.3mf, Downloads), meant to be yellow with black lettering: for the raised print start with yellow and change to black at 2.5 mm. The same for the PD, the Granular and the Additiv firmware (frontplatte-pd*, frontplatte-granular*, frontplatte-additiv*), in colours of your choice; Granular is meant to be magenta with black lettering, for the raised print start with magenta and change to black at 2.5 mm.

Hole sizes: pots 7.2 mm, jacks 6.2 mm, LEDs 5.1 mm, buttons 4.0 mm. After printing, push a pot, a jack, an LED and a button through once: the front is the jig when soldering the control board.

Knobs

Printed knob: black body with grip ridges, yellow pointer and ring in the cap

Black with a yellow pointer and ring, 13.4 mm in diameter. Underneath, the knob has a recess over the nut and washer, so it sits firmly even on the short shaft and almost on the front.

  1. The knobs have a bore of 6.15 mm: on the first build, 5.9 and 6.0 mm were too tight and 6.1 mm a little too snug, as printed holes come out smaller. On another printer, print the fit test first: three rings with bores of 6.05, 6.15 and 6.25 mm (one, two, three marks). Push them onto a shaft; if another than the middle one fits snugly, enter its size as shaft_d in knopf.scad and export again. Also there: D shaft instead of knurled, shaft length, nut height.
  2. Then knopf.3mf: ten knobs, each with the parts “Körper” (body) and “Zeiger” (pointer). They are printed cap down; the pointer is the first layer, so it has the same smooth surface as the rest.
  3. With only one nozzle: the first layer yellow, then change to black. The whole cap is then yellow; if you do not want that, set einlage = false in the .scad.

3. Soldering the main board

Everything goes on the back (the side with the silkscreen, which faces backwards in the module), only the two 14-pin female headers J3 and J4 on the front. Under the DevKit and the DAC module there is room only for flat parts, so go from flat to tall:

Silkscreen of the main board from the back
Silkscreen of the main board, seen from the back. Tap to enlarge.
  1. Resistors. Measure each with the multimeter before soldering: the colour bands of 1 % resistors are easy to mix up.
    ValueParts
    10 ΩR3
    330 ΩR48
    1kR11 R14 R22 R25 R28 R31 R34
    6.8kR10 R13
    10kR9 R12 R40 R43 R46
    16kR42
    17.4kR41
    30kR24 R27 R30 R33
    37.4kR21
    100kR7 R8 R20 R23 R26 R29 R32 R44 R45 R47
    Placement of the resistors, coloured by value
    The resistors coloured by value, component side, boxed header at the top right.
  2. Diodes 1N5817: D1, D2, D3. The band marks the cathode, as on the silkscreen.
  3. Ceramic capacitors: 100 nF (C10–C19, C27, C28, C35–C40), 10 nF (C30–C34), 1 µF (C4, C6). They have no polarity.
    Placement of the capacitors, coloured by value
    The capacitors coloured by value, board turned sideways (boxed header at the bottom right). The electrolytics (purple) come only in step 8.
  4. IC sockets: DIP-8 (U6), DIP-14 (U7, U8, U10), DIP-16 (U9). The notch as on the silkscreen. The chips go in only in step 7.
  5. TO-92: Q1 BC547 (flat side as on the silkscreen) and U3 MCP1700-3002E (3.0 V reference; pin 1 GND, 2 IN, 3 OUT, check the datasheet before soldering).
  6. J13: three pins (L, ground, R) for the wires from the DAC module, straight from the component side.
  7. Female headers for the modules: two 1 × 22 for the DevKit, one 1 × 6 for the DAC module, all 8.5 mm tall. First measure the distance between the two pin rows on your own DevKit: the original has 25.4 mm, some clones 22.86 mm; for the narrower one J3 has a second row of holes further in (labelled “22,86”). Best plug the DevKit into the headers, insert them like that and then solder, so they stand straight.
  8. Electrolytic capacitors 10 µF: C1, C2, C3, C5. Mind the polarity: C1 + to +12 V, C2 + to ground (it sits on −12 V), C3 + to +5 V, C5 + to +3V3A.
  9. Switching regulator U1 (R-78E5.0-0.5), label as on the silkscreen.
  10. Boxed header J1 (Eurorack power): pin 1 is −12 V, where the cable's red stripe goes.
  11. Last, on the front, the female headers J3 and J4 (1 × 14, pin 1 at the top). So that they match the control board: plug in the control board's pin headers, screw both boards together with the standoffs (M3 × 11 mm) and only then solder. This can also wait until after step 5.

4. Preparing the DAC module

On the back of the GY-PCM5102 there are four solder jumpers with three pads each. With a blob of solder connect the middle pad to L (ground) or H:

JumperFunctionSetting
1 FLTFilterL
2 DEMPDe-emphasisL (off)
3 XSMTSoft muteH (sound on)
4 FMTData formatL (I2S)
The four solder jumpers of the GY-PCM5102: 1, 2 and 4 to L, 3 to H
The blob of solder joins the middle pad to H or L. Which side is H is printed as a letter on the module; the layout may differ from the drawing.

Some modules come set this way already or without jumpers at all. SCK needs no wire, the board ties it to ground. Solder the pin header so that the module's labels match those on the main board (VIN GND LCK DIN BCK SCK). Then three short wires from the pads L, G, R next to the module's jack (or its solder lugs) to J13: L, ground, R. L is at J13's square pad, ground is the middle pin. With L and R swapped, the filter acts on the OSC output instead of VOICE.

Wiring from the DAC module to J13 from the component side: R on top, ground in the middle, L at the square pad below
Three wires from the module to J13, seen from the component side, J1 at the bottom right as in the other plans. On the right J13 enlarged: L belongs on the square pad.

5. Soldering the control board

Only C1 and C2 (100 nF) and the two pin headers J3 and J4 (pin 1 at the top) go on the back. Everything else sits on the front: ten pots (RV1 TUNE … RV10 CUT CV), eight jacks (J5 V/OCT … J12 VOICE), two buttons, two LEDs.

Silkscreen of the control board from the front
Control board from the front. Caution: the orientation of the LEDs D1 and D2 on this silkscreen is wrong, see below.
  1. Solder C1, C2 and the pin headers first.
  2. Only insert the pots, jacks and buttons, put the printed front on and tighten the nuts lightly. Only then solder, so everything sits exactly in the holes.
  3. LEDs: do not follow the silkscreen. The v0.1 silkscreen shows the flat side at the square pad (pin 1), but on the WS2812D-F5 it is at DOUT (pin 4). Correct is:
    • The two shorter legs (DIN, VDD) into the square pad and the one next to it.
    • The two longer ones (GND, DOUT) on the other side.
    • Seen from the front, the flat side is on the right, away from the square pad.
    Push them in far enough that the LEDs sit in the 5 mm holes with the front on, then solder.
    from the front flat 1234 1 DIN, short 2 VDD (+5 V), short 3 GND, long 4 DOUT, long Pin 1 to the square pad (blue), the flat side away from it
    The WS2812D-F5 from the front, as it should stand on the board.
    The wrong way round, +5 V and ground reach the LED swapped; on the first build one burned out like that. If a pad tears off while desoldering: pad 4 (DOUT) of D2 is not connected, just cut the leg there.
Control board from the back with test points +5 V and ground and the LED enlarged
Control board from the back (solder side): J3 pin 14 is +5 V, pins 1 and 13 are ground. There must be no permanent beep between +5 V and ground.

6. First check without chips

Do not put anything into the sockets yet; the DevKit and the DAC module stay out.

  1. Visual check: solder bridges, forgotten joints, polarity of electrolytics and diodes.
  2. Multimeter on continuity, without power: +12 V, −12 V and +5 V must not be connected to ground (a short beep while the electrolytics charge is normal). Test points in the picture below.
  3. Connect power, on a bench supply with a 50 mA limit per side, otherwise in the case (red stripe at pin 1 of J1 and on the bus at −12 V). The black probe on ground: the six middle pins of J1, or with the cable plugged in the middle pin of J13.
    WhereTargetOn the first build
    U6 pin 8about +11.7 V (+12 V minus a diode)+11.8 V
    U6 pin 4about −11.7 V−12.1 V
    C3 + (5 V), also U10 pin 14about +4.7 to 5 V4.87 V
    U9 pin 15 (reference)3.00 V3.01 V
    There is no 3.3 V yet; it comes only with the DevKit, from its regulator.
  4. If something is off or the current hits the limit: switch off and look for the fault before the chips go in.
Main board with test points: U6 pins 8 and 4, C3, U9 pin 15, ground at J1 and J13
Test points of the main board, component side, boxed header at the bottom right. Pin 1 of U9 is at the top right, pin 15 the second from the right in the bottom row.

7. Inserting chips and modules

Power off. Then insert, the notch as on the silkscreen:

Switch on again. Without firmware the LEDs show nothing (the small LED on the DevKit may blink; that is the manufacturer's test program); the current on +12 V should stay below about 150 mA.

8. Flashing the firmware

The firmware is one file for address 0x0: tonwerk-modul.bin. For Tonwerk Physical use tonwerk-physical.bin instead; it needs no tables, so the first start is as short as any other. For Tonwerk PD likewise tonwerk-pd.bin, for Tonwerk Granular tonwerk-granular.bin; it carries its sound sources, is 6.7 MB and takes one to two minutes. For Tonwerk Additiv tonwerk-additiv.bin.

  1. In Chrome or Edge open Espressif's web flasher, baud rate 921600, Connect and select the DevKit. The DevKit has two USB sockets: use the one labelled “UART” (or “COM”).
  2. Enter 0x0 as the flash address, choose the file, Program.
  3. Under “Console” (115200 baud) you can then see what the module is doing.

On the first start the module computes its tables and stores them in flash, taking up to about a minute; meanwhile the LEDs light red and yellow and there is no sound. Every later start reads the tables in a fraction of a second. If both LEDs blink red, the PSRAM is missing (wrong DevKit).

Flashing works with and without Eurorack power; a diode separates the regulator from USB. New firmware is flashed the same way: the tables stay, but saved modes, hidden values and the V/Oct calibration are lost. So flash first, then calibrate.

Later updates also work without a cable over Wi-Fi, and they keep the settings and calibration: update over Wi-Fi. The first time (and from a firmware older than 1 November 2026) it has to be USB.

Building it yourself: ESP-IDF 5.3, idf.py build flash monitor in the firmware folder; the README on GitHub describes it.

9. Assembly and first sound

  1. Fasten the control board to the front with the nuts of the pots and jacks, put the knobs on.
  2. Plug the main board with its female headers onto the control board's pin headers and screw them together with the two standoffs (holes H1, H2).
  3. Connect it in the case (red stripe at −12 V) and fix it to the rails with four M3 screws.
  4. The VOICE output to a mixer. Without a cable in GATE the gate is permanently on; the module plays as a drone and should sound at once. Turn TUNE, TABLE and CUTOFF, press WARP and FILTER briefly: LED 1 and 2 change colour.

The outputs are at module level (±5 V), far too loud for headphones. How everything is operated: Operation.

10. Calibrating V/Oct

  1. Switch off, only V/OCT plugged in, hold both buttons and switch on. LED 1 blinks white.
  2. Exactly 1.000 V into V/OCT, press WARP. LED 2 blinks white.
  3. Apply exactly 3.000 V, press FILTER.
  4. Three times green: saved. Three times red: the values were implausible and the old ones stay; check voltage and cable and repeat.

Afterwards check with a tuner across several octaves.

Assembled variant (SMD)

Never built yet: the SMD boards are designed and checked (netlist against the parts list, design rules without errors), but never ordered, assembled or powered. Whoever orders them is the first. So far only the through-hole variant above has been built and heard.

Layout of the SMD main board from the back with ESP32 module, USB-C socket and the small parts
SMD main board from the back.

The same circuit, but the board manufacturer solders the main board: the ESP32-S3 module (WROOM-1 N16R8) directly on the board instead of the DevKit, the DAC as a chip instead of the module, all resistors, capacitors and chips in SMD on the back, plus a USB-C socket of its own for flashing and reset and boot buttons. Same dimensions, same front panel, same firmware; every control board fits every main board. The module is about 40 mm deep, 5 mm less than the through-hole variant.

Ordering

  1. Order the main board (tonwerk-haupt) with assembly; the files are prepared for JLCPCB: upload the Gerber zip, turn on assembly, side Bottom (the parts sit on the back), then upload the bill of materials (BOM) and placement (CPL).
  2. Before paying, look at the assembly preview: with packages such as SOT-223, SOT-23-5 and the SOICs on the bottom side, the rotation is often off by 90° or 180°; rotate them in the preview window then. Compare pin 1 of every chip with the dot on the silkscreen.
  3. Replace parts that are out of stock with equivalent ones by value in the manufacturer's tool.
  4. Control board: only C1/C2 on it are SMD, everything else is through-hole and by hand. It is simpler to order it unassembled, either tonwerk-bedien (C1, C2 as 0805 by hand) or straight away the through-hole tonwerk-bedien-tht from above.

Assembly costs considerably more than bare boards; a quote in October 2026 was about €180. In return almost all the soldering of the main board and the hunt for parts go away.

What is still soldered by hand

Checking, flashing, calibrating

  1. Before the first power-up, check with the multimeter that +12 V, −12 V, +5 V and +3.3 V are not shorted to ground. Then power up with current limiting and measure: U6 pin 8 about +11.7 V, pin 4 about −11.7 V, the reference U3 3.00 V, plus 3.3 V at the regulator U2.
  2. Flash through the main board's USB-C socket, with the same file at address 0x0 as in step 8. If the web flasher finds nothing: hold the boot button (solder in SW1 and SW2 for that), press reset briefly, release boot, then Connect once more. The module's messages come through the same socket.
  3. Continue with step 9 and step 10.

Troubleshooting

No sound, LEDs light normally
Solder jumpers on the DAC module (step 4, especially 3 XSMT on H), the three wires to J13, is the TL072 the right way round? Listen at the DAC module's jack (headphones only quietly and not on your ears): if it sounds there, the fault lies between J13 and the output jacks (U6, R9–R14).
The filter acts on OSC instead of VOICE
L and R at J13 are swapped (step 4): L belongs on the square pad. Swap the two outer wires.
No sound on the first start
The tables are still being computed (step 8). Wait until the LEDs show the colours of the modes.
LEDs dark
U10 a 74HC125 instead of HCT? LEDs the right way round (step 5)? R48 (330 Ω) soldered?
An LED has burned out
It was the wrong way round (step 5). Desolder it and insert a new one the right way round.
LEDs in the wrong colours
Cyan shows as purple, magenta as turquoise, green as red: the ready-made images send red-green-blue, as the APA106 (and PL9823) expect, which are often sold as WS2812D-F5. Genuine Worldsemi WS2812D-F5s want green-red-blue: build the firmware yourself with idf.py -DTONWERK_LED_GRB=1 build flash.
Knobs do nothing or jump
A knob takes over only once it reaches the stored value (pick-up). Otherwise check the headers J3 and J4 and the 100 nF capacitors C10–C19.
CV inputs do nothing
MCP3208 (U9) and MCP6004 (U7, U8) the right way round? 3.0 V at U9 pin 15?
Console
Over USB (115200 baud) the module reports the load of the audio core every 5 seconds; errors at start-up appear there too.

As of 28 October 2026. The same guide is in the repository as BAUANLEITUNG.md (German). Boards, front panel, knobs and firmware are under the PolyForm Noncommercial License: building one for yourself yes, selling only with permission.