TONWERK.MODUL

Tonwerk Wavetable as a Eurorack module

The sound engine of the plugin Tonwerk Wavetable on an ESP32-S3, as a 14 HP Eurorack module to build yourself. One monophonic voice: two wavetable oscillators with warp, unison and sub, a multimode filter with drive and an envelope. Built for basses that growl.

The finished module in the rack: black front panel with yellow lettering, ten knobs, two buttons with LEDs, eight jacks
The first build, 27 October 2026, still with the knobs that came with the pots.
Build guide Boards, parts, firmware

Everything needed to build it is open: boards (KiCad), front panel and knobs to print, firmware as a ready-made file. The parts cost about €60–80 plus the boards. The main board also comes as an SMD variant that the manufacturer assembles (never built yet).

Overview

Second firmware: the same boards also play Tonwerk Physical, physical modelling with exciter and resonator, up to four voices and a front panel of its own (yellow with black lettering). A third one plays Tonwerk PD, phase distortion with two lines and chorus in stereo, a fourth Tonwerk Granular, grain clouds from nine sound sources, a fifth Tonwerk Additiv, 64 sine partials from two morphed spectra.

So far one module has been built (the through-hole boards v0.1). Tested: power, flashing, sound at the VOICE output, the knobs. Not yet tested on the hardware: the CV inputs and the V/Oct calibration.

Operation

The front from top to bottom: nine knobs in three rows, below them the WARP button with LED 1 on the left, the CUT CV knob in the middle, the FILTER button with LED 2 on the right, then two rows of jacks. The two outputs OSC and VOICE are framed at the bottom right.

The three layers

Every knob has up to three jobs:

Hold the button, turn the knob, let go of the button. The module saves the hidden values and the modes 3 seconds after the last change; after switching off, everything is back.

Pick-up: why a knob sometimes does nothing

After a layer change a knob is rarely where the other layer's value is. So that nothing jumps, it only takes over once it reaches or crosses the stored value. Until then turning does nothing; once past the value, the value follows the knob. This works both ways: if you turned a knob in a hidden layer, after letting go you first have to bring it back to its old value in the normal layer too.

All knobs

KnobNormalWARP heldFILTER held
TUNETuning ±2 octaves in semitonesOscillator B: transpose ±24 semitonesAttack 0.5 ms to 2 s
FINEFine tuning ±50 cents, a small range at 0 around the centreOscillator B: fine tuning ±50 cents–
TABLETable, ten of them (list below)Oscillator B: table, fully left = B off–
POSITIONPosition in the table (the sound morphs from left to right)Oscillator B: positionFilter keytracking 0–100 %
WARPAmount of the warp modeUnison 1–4 voices per oscillator–
CUTOFFFilter frequency 20 Hz to 20 kHzUnison detune 0–100 centsEnvelope to cutoff, 0–6 octaves
RESOResonance (with the comb: feedback)Sub level, fully left = offDrive before the filter
DECAYDecay and release, 5 ms to 5 sSub: −1 oct. sine, −2 oct. sine, −1 oct. square, −2 oct. squareSustain 0–100 %
POS CVAttenuverter for the POS jack: centre 0, right full, left inverted––
CUT CVAttenuverter for the CUTOFF jack: centre 0, right 1 V/octave, left inverted––

From the factory (and after every flash) oscillator B is off, unison one voice with 20 cents of detune for later, the sub off, attack 0.5 ms, no keytracking, no envelope on the cutoff, no drive and sustain 100 %. The warp mode is off, the filter LP24.

The buttons

Short press
Under 0.3 seconds and without turning a knob: WARP steps the warp mode, FILTER the filter mode. The button acts on release.
Hold
Longer than 0.3 seconds, or shorter but with turning: opens the hidden layer, the mode stays. A knob that is only touched lightly while pressing does not count as turning.
Hold both while powering on
Starts the V/Oct calibration.
Hold only WARP while powering on
Starts the update over Wi-Fi.

Warp modes (short press on WARP, LED 1)

The mode applies to both oscillators; the WARP knob and the WARP jack set the amount.

LED 1ModeWhat it does
greyoffThe table sounds as it is.
cyanSyncReads the table 1 to 8 times per period and starts every period anew: the hard sync sound that “sings” when you turn it.
yellowBendBends the phase: the start of the period is read faster, the end slower. Brighter, nasal.
magentaPWMReads the whole table in an ever shorter part of the period (down to 5 %) and holds the start value for the rest: like pulse width for any table.
redFMOscillator B modulates A's phase (and A B's). B need not be audible for this: if it is off, it runs silently as a modulator, and its TUNE in the WARP layer sets the ratio. At full amount it quickly turns into noise.

Filter modes (short press on FILTER, LED 2)

LED 2ModeWhat it does
cyanLP12Lowpass 12 dB/octave, soft.
blueLP24Lowpass 24 dB/octave, the classic bass. Factory default.
yellowHP12Highpass 12 dB/octave.
greenBP12Bandpass.
magentaNotchNotch filter, takes out a band.
redCombComb filter tuned to the cutoff's period, RESO is the feedback: metallic, with resonance almost a string.
greyoffNo filter, only the envelope.

Drive (FILTER layer, RESO) saturates softly before the filter, up to about 24 dB of gain, level-compensated. The sub joins only after the filter, so the bass stays clean while the filter moves.

The ten tables

While you turn TABLE, LED 1 shows the table for a second as a colour from the colour wheel, then the warp mode again. POSITION sweeps every table from left to right:

No.LED 1TablePOSITION from left to right
1redBasicSine, triangle, saw, square, crossfaded into each other
2orangeSyncSaw with sync, its frequency rising to eight times
3yellow-greenPWMPulse from square to thin needle
4greenVowelA sung voice through the vowels a, e, i, o, u
5turquoiseFM growlTwo-operator FM, modulator an octave up, index up to 8: the growl
6cyanFolderA sine driven ever harder into a wavefolder
7blueHarmonicFundamental plus a band of overtones that climbs eight octaves
8indigoCombSaw with notches that close, at the end only the even harmonics
9violetBitcrushSaw and sine in ever fewer steps
10pinkRoughSaw with a sine below, saturated ever harder and lopsided

What else the LEDs show

While playing, both light up with the envelope: bright while a note sounds, dimmed (never fully dark) in between, so the mode can always be read.

Yellow and cyan, briefly
The module is starting.
Red and yellow, for up to a minute
First start after flashing a new table version: the module computes the tables and stores them in flash. No sound, do not switch off.
Both blink red
Not enough PSRAM: the DevKit is not an N16R8.
One blinks white
Calibration, the module is waiting for this button.
Both blink green or red three times
Calibration saved or discarded.
Alternating blue, cyan, green, blinking red
Update over Wi-Fi: waiting, receiving, done, image refused or cut off (see below).

Jacks

JackRangeWhat it does
V/OCT−1 to +7 VPitch, 1 V per octave, 0 V = C2. Adds to TUNE and FINE.
GATEfrom about 1.4 VStarts the envelope; when it falls, the release begins. Without a cable the gate is permanently on: the module plays as a drone.
TABLE±5 VShifts the table, +5 V sweep from fully left through all ten.
POS±5 VShifts the position, through the POS CV attenuverter.
WARP±5 VAdds to the warp amount, +5 V = full.
CUTOFF±5 VShifts the cutoff through the CUT CV attenuverter; to the right 1 V per octave, so the filter follows the pitch with the V/Oct signal.
OSC (output)±5 VOscillators A and B with unison, warp and sub, without filter and envelope: a VCO, always sounding.
VOICE (output)±5 VThe same through drive and filter, the sub added after it, then through the envelope as a VCA.

The outputs are at module level. They are far too loud for headphones; always go through a mixer or an output module.

First patches

Drone
Only VOICE to the mixer. Without a gate cable the module sounds at once. Choose a TABLE, turn POSITION and WARP slowly, CUTOFF and RESO along with them.
Bass from the sequencer
Pitch to V/OCT, gate to GATE, VOICE to the mixer. DECAY short; in the FILTER layer: sustain (DECAY) down, envelope to cutoff (CUTOFF) at two to three octaves; CUTOFF low in the normal layer. For more punch, add the sub (RESO) in the WARP layer.
Wobble
An LFO into the CUTOFF jack, CUT CV to the right, LP24 and some RESO. With a second LFO into POS and the FM growl table it becomes dubstep.
Fat lead
WARP layer: unison (WARP) at 3 or 4, detune (CUTOFF) at 20 to 40 cents, oscillator B (TABLE) with a second table, B's TUNE an octave up.
External filter
Use OSC instead of VOICE: the raw oscillator for another filter module and a VCA.

Calibrating V/Oct

For V/OCT to track over several octaves, the module measures two voltages once. For that it needs a source that delivers exactly 1.000 V and 3.000 V (a bench power supply and a multimeter will do; a MIDI-to-CV interface works too if you measure which notes give exactly 1 V and 3 V).

  1. Switch off. Unplug every cable except the one for V/OCT: the other inputs are measured as 0 V meanwhile.
  2. Hold both buttons and switch on. LED 1 blinks white.
  3. Exactly 1.000 V into V/OCT, press WARP. The module measures for half a second, then LED 2 blinks white.
  4. Apply exactly 3.000 V, press FILTER.
  5. Three times green: saved, the module starts normally. Three times red: the measurement was implausible (cable, voltage?), the old values stay; start over.

Afterwards check with a tuner across several octaves. Without calibration the module uses the circuit's nominal values; how well they track depends on the parts.

New firmware

The firmware is one file, tonwerk-modul.bin, written at address 0x0 with Espressif's web flasher in the browser (Chrome or Edge). How is described in the build guide, step 8. This works in the rack or loose on the USB cable. For Tonwerk Physical it is tonwerk-physical.bin, for Tonwerk PD tonwerk-pd.bin, for Tonwerk Granular tonwerk-granular.bin, for Tonwerk Additiv tonwerk-additiv.bin.

Flashing over USB erases the saved modes, the hidden values and the calibration; the tables stay. So calibrate again afterwards. Over Wi-Fi (below) everything is kept.

Update over Wi-Fi

Next to the instrument the flash holds a small updater. With it new firmware reaches the module without a USB cable, including another of the five:

  1. Switch the module on while holding the left button (WARP; in the other firmwares ERREGER, WELLE 1, QUELLE or KLANG A), not the right one. The LEDs blink blue in turn.
  2. Join the Wi-Fi network Tonwerk-Modul (no password) with a phone or computer and open http://192.168.4.1.
  3. Choose the image, the same .bin as for USB, and upload it. During the transfer the LEDs light cyan, the right one flickers; then both turn green and the module starts with the new firmware.
What is kept
Saved modes, hidden values and the calibration. Only the instrument and, for Tonwerk Granular, its sources are written.
Changed your mind
Press the left button again. After 15 minutes without an upload the instrument starts again by itself.
Blinking red
The image does not fit or the transfer broke off; the page says why. If the instrument had already been overwritten, the updater stays on, even after switching off and on, until an image has arrived completely. The module is never left without firmware.
Both steady red
The flash layout does not know the updater: flash once over USB.
Wi-Fi keeps dropping
The module restarts, usually because transmitting briefly draws more current than the supply gives. So the updater transmits at low power and says on the page when it restarted. If that does not help, also power the module over USB for the update. An updater from 13 November 2026 or earlier still transmits at full power; only USB rewrites the updater itself.

Only the firmwares from 1 November 2026 on bring the updater, and they change the flash layout: flash once over USB, after that Wi-Fi works. The updater refuses older images. The Wi-Fi network is only open while the updater runs; the instrument itself has no Wi-Fi. Tested on a module (Tonwerk Granular over Wi-Fi, 14 November 2026). USB always works.

Problems

A knob does nothing
It has not reached its value yet (pick-up). Turn it once across the whole range.
A button does not respond
Press briefly and release, without turning a knob meanwhile. Longer than 0.3 seconds counts as holding.
No sound at the VOICE output
If a cable is in GATE but no gate arrives, the envelope stays closed. Pull the cable (drone) or send a gate. Sustain 0 and a short DECAY also turn a drone into silence. If OSC sounds but VOICE does not, the cutoff is fully down or a highpass fully up.
Noise
FM or sync at full amount sound like that. Turn WARP back or change the mode (LED 1 grey = off).
Out of tune across octaves
Calibrate, and check FINE at the centre and TUNE.
What is the module doing right now?
Over USB (115200 baud, for example in the web flasher's console) it reports start-up messages, the calibration and every 5 seconds the load of the audio core.

As of 28 October 2026. Source code, boards and front panel are on GitHub under the same PolyForm Noncommercial License as the plugins: building one for yourself yes, selling only with permission.