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
- The same engine as the plugin, rewritten in float: string and tubes as delay lines, bar, bell, skin and bowl as up to 16 resonances. A test on the computer compares all 28 pairs of exciter and resonator with the plugin.
- Up to four voices: each strike takes the next one, the old ones ring out. A sequence of notes becomes a chord or a harp.
- Two outputs: ROH (raw) is the voices without the body, KLANG (sound) the same through the body (guitar, violin, box, soundboard). Without a body both are the same.
- Six inputs: V/OCT, GATE and CV for hardness, position, force and damping.
- Its own front panel, meant to be yellow with black lettering, so the two modules are easy to tell apart in the rack.
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
| Knob | Normal | ERREGER held | RESON. held |
|---|---|---|---|
| TUNE | Tuning ±2 octaves in semitones | Attack of bow and breath, 1 ms to 2 s | Filter cutoff, 20 Hz to 20 kHz |
| FINE | Fine tuning ±50 cents | Decay of bow and breath, 5 ms to 5 s | Filter resonance |
| HÄRTE (hardness) | Hardness of the strike: soft and dark to hard and bright | Sustain of bow and breath | Filter: off, LP12, LP24, HP12, BP (off by default) |
| POSITION | Where 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 s | Filter keytracking |
| KRAFT (force) | Bow pressure and breath; for pluck and strike, how hard it is struck | Noise: the bow's scratch, air in the breath | Body: off, guitar, violin, box, soundboard |
| DÄMPF. (damping) | Damping: how much faster the high harmonics die away | Dynamics: how much quieter a weak strike is | Body mix |
| INHARM. | Inharmonicity: on the string the stiffness that stretches its harmonics upwards as on a piano; on the others it stretches the resonances | – | – |
| DECAY | Decay time of the resonator, 20 ms to 20 s | Voices 1 to 4 (2 by default) | Damper after the gate, 5 ms to 60 s; 60 s by default, the note rings out |
| POS CV | Attenuverter for the POS jack: centre 0, right full, left inverted | – | – |
| DMP CV | Attenuverter for the DÄMPF. jack: centre 0, right full, left inverted | – | – |
Exciters (tap ERREGER, LED 1)
| LED 1 | Exciter | What it does |
|---|---|---|
| yellow | Pluck | A short burst over one period of the vibration. The default. |
| cyan | Strike | Hammer or mallet: the harder, the shorter and brighter. |
| magenta | Bow | A bow with stick and slip friction. The string vibrates by itself as long as the gate is on. |
| green | Blow | On 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 2 | Resonator | How it sounds |
|---|---|---|
| yellow | String | All harmonics, with INHARM. stiff like a piano string. The default. |
| orange | Closed tube | Only odd harmonics, hollow like a clarinet. |
| green | Open tube | All harmonics, like a flute. |
| cyan | Bar | Overtones at 4 and 10 times, like a tuned marimba bar. |
| blue | Bell | With the hum note an octave below the strike note and the minor third. |
| red | Skin | The inharmonic tones of a drum. |
| magenta | Bowl | Singing 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
| Jack | Range | What it does |
|---|---|---|
| V/OCT | −1 to +7 V | Pitch, 1 V per octave, 0 V = C2. A jump strikes (see above). |
| GATE | from about 1.4 V | Rising: strike. Falling: damper on the newest voice. On permanently without a cable. |
| HÄRTE | ±5 V | Added to the hardness, ±5 V across the knob's whole travel. |
| POS | ±5 V | Shifts the position, through the attenuverter POS CV. |
| KRAFT | ±5 V | Added to the force: an LFO at KRAFT moves the bow. |
| DÄMPF. | ±5 V | Shifts the damping, through the attenuverter DMP CV. |
| ROH (output) | ±5 V | The voices with the filter, without the body. |
| KLANG (output) | ±5 V | The 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.