TONWERK.MODUL

Tonwerk Physical as a Eurorack module

A second firmware for the same boards as the wavetable module: the sound engine of the plugin Tonwerk Physical. Instead of playing back waveforms, the module computes how an instrument vibrates. An exciter (pluck, strike, bow, blow) sets a resonator (string, tube, bar, bell, skin, bowl) ringing, optionally through a filter and a body.

Overview

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

This firmware is tested on the computer; it has never run on an ESP32 yet. I estimate the load at 10–30 % of a core.

Operation

The front is the same as on the wavetable module, only the lettering differs. The WARP button is called ERREGER (exciter) here, the FILTER button RESON. (resonator). Layers, pick-up, holding versus tapping, saving and calibration work just as described there. The panel's labels are German; the tables give their meaning.

All knobs

KnobNormalERREGER heldRESON. held
TUNETuning ±2 octaves in semitonesAttack of bow and breath, 1 ms to 2 sFilter cutoff, 20 Hz to 20 kHz
FINEFine tuning ±50 centsDecay of bow and breath, 5 ms to 5 sFilter resonance
HÄRTE (hardness)Hardness of the strike: soft and dark to hard and brightSustain of bow and breathFilter: off, LP12, LP24, HP12, BP (off by default)
POSITIONWhere it is excited, from the edge to the middle. Plucked in the middle, a string loses its even harmonics; at the edge it turns thin and bright.Release of bow and breath, 5 ms to 5 sFilter keytracking
KRAFT (force)Bow pressure and breath; for pluck and strike, how hard it is struckNoise: the bow's scratch, air in the breathBody: off, guitar, violin, box, soundboard
DÄMPF. (damping)Damping: how much faster the high harmonics die awayDynamics: how much quieter a weak strike isBody mix
INHARM.Inharmonicity: on the string the stiffness that stretches its harmonics upwards as on a piano; on the others it stretches the resonances––
DECAYDecay time of the resonator, 20 ms to 20 sVoices 1 to 4 (2 by default)Damper after the gate, 5 ms to 60 s; 60 s by default, the note rings out
POS CVAttenuverter for the POS jack: centre 0, right full, left inverted––
DMP CVAttenuverter for the DÄMPF. jack: centre 0, right full, left inverted––

Exciters (tap ERREGER, LED 1)

LED 1ExciterWhat it does
yellowPluckA short burst over one period of the vibration. The default.
cyanStrikeHammer or mallet: the harder, the shorter and brighter.
magentaBowA bow with stick and slip friction. The string vibrates by itself as long as the gate is on.
greenBlowOn the closed tube a reed that oscillates by itself; otherwise a stream of air. Holds the note like the bow.

Resonators (tap RESON., LED 2)

LED 2ResonatorHow it sounds
yellowStringAll harmonics, with INHARM. stiff like a piano string. The default.
orangeClosed tubeOnly odd harmonics, hollow like a clarinet.
greenOpen tubeAll harmonics, like a flute.
cyanBarOvertones at 4 and 10 times, like a tuned marimba bar.
blueBellWith the hum note an octave below the strike note and the minor third.
redSkinThe inharmonic tones of a drum.
magentaBowlSinging bowl: pairs of closely spaced tones that beat against each other.

Both LEDs light up brightly when a note is struck and dim with it, never quite off.

Striking

With a gate
Every rising edge at GATE plucks or strikes the next voice, as hard as KRAFT is set. When the gate falls, the damper comes down on the newest voice, as fast as DECAY in the RESON. layer says. By default the damper is off (60 s), every note rings out.
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 strikes. A sequencer without a gate thus plays every new note; a glide or a slow LFO only moves the pitch.
Pitch
The newest voice follows V/OCT, TUNE and FINE; the older ones ring on at the pitch they were struck at.
Bow and blow
Hold the note as long as the gate is on; their envelope is in the ERREGER layer. Without a gate cable the bow plays all the time: a drone shaped with KRAFT, POSITION and DÄMPF.

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: damper on the newest voice. On permanently without a cable.
HÄRTE±5 VAdded to the hardness, ±5 V across the knob's whole travel.
POS±5 VShifts the position, through the attenuverter POS CV.
KRAFT±5 VAdded to the force: an LFO at KRAFT moves the bow.
DÄMPF.±5 VShifts the damping, through the attenuverter DMP CV.
ROH (output)±5 VThe voices with the filter, without the body.
KLANG (output)±5 VThe same through the body.

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

First patches

Harp from a sequencer
Pitch into V/OCT, no gate cable, KLANG to the mixer. Pluck on the string; ERREGER layer: four voices (DECAY fully right); RESON. layer: body guitar. DECAY long in the normal layer.
Marimba
Strike on the bar, HÄRTE in the middle, DECAY short, gate from the sequencer. A random CV at POS makes every hit a little different.
Bowed drone
Bow on the string or the bowl, no gate cable. A slow LFO at KRAFT, a second one at POS; DÄMPF. shapes the brightness.
Bells
Strike on the bell, DECAY long, INHARM. turned up a little, two to four voices.

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). Meant to be yellow with black lettering: for the raised print start with yellow and change to black at 2.5 mm.

Firmware

The firmware is one file, tonwerk-physical.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 to the wavetable firmware works the same way, with tonwerk-modul.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.