TONWERK.MODUL

Tonwerk PD as a Eurorack module

A third firmware for the same boards as the wavetable module: the sound engine of the plugin Tonwerk PD, phase distortion. A cosine wave is read through a bent phase. The more it is bent (DCW), the more the soft sine turns into a saw, a square, a pulse or a resonance, and an envelope on the bend opens the sound like a filter.

Overview

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

This firmware is tested on the computer; it has never run on an ESP32. On the computer it needs less processing time than the wavetable firmware.

Operation

The front is the same as on the wavetable module, only the lettering differs. The WARP button is called WELLE 1 (wave 1) here, the FILTER button WELLE 2. Layers, pick-up, holding versus tapping, saving and calibration work exactly as described there.

All knobs

KnobNormalWELLE 1 heldWELLE 2 held
TUNETuning ±2 octaves in semitonesAttack of the DCW envelope, 1 ms to 2 sDetune of line 2, ±50 cents (default +7 cents)
FINEFine tuning ±50 centsSustain of the DCW envelopeLines: 1, 2, 1 + 1′ (line 1 once more, with line 2's detune), 1 + 2′ (both, default)
LINIE 2Interval of line 2, from unison to two octaves in semitones; one octave in the middleSecond wave of line 1: off or one of the eight. The two waves then alternate cycle by cycle.Second wave of line 2
HÜLLK.How far the DCW envelope bends both linesKey tracking: above C3 high notes bend less, so they stay softModulation: off, ring (line 2 times line 1), noise (line 2 read at a wandering phase)
MIXLine 1 against line 2, both equally loud in the middleAttack of the level, 1 ms to 2 sStereo width of the two lines (default 50 %)
DCWBend without the envelope: left a pure cosine, right fully bentSustain of the levelChorus rate, 0.1 to 5 Hz (default 0.6 Hz)
CHORUSChorus mix, off on the leftRelease of the level, 5 ms to 5 sChorus depth
DECAYDecay of the DCW envelope, 5 ms to 5 sDecay of the level, 5 ms to 5 sRelease of the DCW envelope, 5 ms to 5 s
POS CVAttenuator for the HÜLLK. jack: middle 0, right full, left inverted––
DCW CVAttenuator for the DCW jack: middle 0, right full, left inverted––

Waves (tap WELLE 1 and WELLE 2)

WELLE 1 picks the wave of line 1, LED 1 shows it; WELLE 2 and LED 2 do the same for line 2. Saw and square by default.

LEDWaveFully bent
yellowSawSawtooth: all harmonics.
cyanSquareSquare: odd harmonics only, hollow.
magentaPulseNarrow pulse, thin and nasal.
greenDouble sineTwo arches per cycle, the octave comes forward.
orangeSaw-pulseHalf saw, half pulse.
redResonance sawA resonance up to 16 times the note, dying away under a saw: sounds like a filter with high resonance.
blueResonance triangleThe same resonance under a triangle, softer.
violetResonance trapezoidUnder a trapezoid, the fullest.

Unbent, every wave but the resonances is a pure cosine. Both LEDs light up with the level envelope and dim with it, never fully off.

Striking a note

With a gate
A rising edge at GATE restarts both envelopes; when the gate falls, their release begins.
With V/OCT only
While the gate is on, or no cable is in GATE, every jump at V/OCT of at least half a semitone also strikes, as with the Physical firmware. A sequencer without a gate thus plays every new note; a glide only moves the pitch.
Drone
Without a gate cable the note holds after the first strike. DCW, MIX and an LFO at the DCW jack then shape the sound.

Jacks

JackRangeWhat it does
V/OCT−1 to +7 VPitch, 1 V per octave, 0 V = C2. A jump strikes (see above).
GATEfrom about 1.4 VRising: strike. Falling: release. Permanently on without a cable.
LINIE 2±5 V1 V per octave on line 2's interval: a second sequencer plays the second line.
HÜLLK.±5 VShifts the depth of the DCW envelope, through the POS CV attenuator.
MIX±5 VAdded to the mix, 5 V from the middle to the end stop.
DCW±5 VBends both lines, through the DCW CV attenuator, 5 V over the whole travel. With an LFO this becomes a filter sweep.
L (output)±5 VLeft channel.
R (output)±5 VRight channel. For mono set the width to 0 and the chorus off, then both are the same.

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

First patches

Bass
Saw on line 1, MIX fully left, DCW left, HÜLLK. half, DECAY short. Gate and V/OCT from the sequencer: every note opens and closes like a filter.
Resonance sweep
Resonance saw on line 1, a slow LFO at the DCW jack, DCW CV halfway right. The resonance wanders through the harmonics.
Wide pad
Saw and square (the default), LINIE 2 on the octave, MIX in the middle, CHORUS half, long attacks in the WELLE 1 layer. L and R separately into the mixer.
Bell
Hold WELLE 2 and set HÜLLK. to ring, LINIE 2 to an odd interval (a sixth and a few cents), a long level decay.

Front panel

The same three variants as for the wavetable module (build guide, step 2), with this firmware's lettering: raised lettering, engraved lettering and inlaid lettering (3MF, two colours). For the raised print start with the panel's colour and change to the lettering's at 2.5 mm.

Firmware

The firmware is one file, tonwerk-pd.bin, written to address 0x0 as in the build guide, step 8. It needs no tables; the first start takes no longer than any other. Going back works the same way, with tonwerk-modul.bin or tonwerk-physical.bin.

Flashing over USB erases the saved settings and the calibration. So calibrate again afterwards. Over Wi-Fi they are kept, with the left button held at power-on: update over Wi-Fi.

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