TONWERK.MODUL

Tonwerk Additiv as a Eurorack module

A fifth firmware for the same boards as the wavetable module: the sound engine of the plugin Tonwerk Additiv. The sound is made of up to 64 sine partials whose strength and place the module keeps setting anew. Morph, tilt and stretch under CV turn a saw into an organ, a bell or a vowel, and nothing ever folds back.

Overview

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

This firmware is tested on the computer; it has never run on an ESP32. With all 64 partials and every kind of shaping I estimate 30 to 50 % of a core.

Operation

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

All knobs

KnobNormalKLANG A heldKLANG B held
TUNETuning ±2 octaves in semitonesAttack, 1 ms to 10 sFilter: off, lowpass, highpass, bandpass, notch (default off)
FINEFine tuning ±50 centsDecay, 5 ms to 10 sCutoff, 20 Hz to 20 kHz
MORPHFrom spectrum A (left) to spectrum B (right)SustainResonance
OBERTÖNEHow many partials sound, 1 to 64; the first part of the travel is for the first fewRelease, 5 ms to 10 sKey tracking of the filter
NEIGUNGTilt, ±12 dB per octave: brighter to the right, darker to the left. The loudness stays the same.Odd against even: to the right only the odd partials (hollow), to the left more of the even onesDepth of the comb
SPREIZ.Stretch: harmonic in the middle; to the right the partials move up as on a stiff string or a bell, to the left downBeating: each partial detuned by up to 50 cents, each its own waySpacing of the comb, every 2 to 16 partials
ABKLING.How fast the partials die away, 50 ms to 20 s, the high ones sooner. Fully right they never do.Bloom: how late the high partials come in, at once on the left, up to 5 sShift of the comb
VOKALOff on the left, then the formants fade in on A and move through E, I and O to UWidth in the stereo field (default 50 %)Formants shifted by ±12 semitones: a smaller or larger throat
OBT CVAttenuverter for the OBERT. jack: middle 0, right full, left invertedHold: how far the partials die away to (default all the way)Phases: left all alike (a hard attack), right random (default)
SPR CVAttenuverter for the SPREIZ. jack: middle 0, right full, left invertedDamping: how much sooner the high partials die away (default 50 %)–

Spectra (tap KLANG A and KLANG B)

LEDSpectrumHow it sounds
whiteSineThe fundamental alone.
yellowSawEvery partial, each quieter by its number. Spectrum A by default.
cyanSquareOnly the odd partials, hollow. Spectrum B by default.
greenTriangleOdd partials, quickly quieter: soft.
magentaPulseA pulse a quarter wide: every fourth partial missing.
orangeOrganThe first eight partials like pulled drawbars.
blueHollowStrong odd and faint even partials, like a clarinet.
light orangeBrightEvery partial, slowly quieter: brighter than the saw.
violetOctavesOnly the fundamental and its octaves.
turquoiseGlassOnly partials 1, 4, 9, 16 …: glassy, a bell with some stretch.
redPrimesThe fundamental and the partials with a prime number.
greyRandomEach partial randomly strong, always the same randomness.

A tap on KLANG A steps spectrum A on, LED 1 shows it; KLANG B does the same for spectrum B on LED 2. All spectra are equally loud. Both LEDs light up with the envelope and dim with it, never quite off.

Striking and pitch

With a gate
A rising edge at GATE starts the envelope and the partials' envelopes; when the gate falls, the release begins.
With V/OCT alone
While the gate is on, or no cable is in GATE, a jump at V/OCT of at least half a semitone does the same, as with the Physical firmware. A glide only moves the pitch.
Plucked or held
Unless ABKLING. is fully right, every strike dies away, even with the gate held, the high partials first. Fully right the note holds as long as the gate is on.
Pitch
0 V is C2, 1 V per octave. Partials above 0.47 of the sample rate are dropped; high notes therefore have fewer partials, but never aliases.

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. Without a cable always on.
MORPH±5 VAdds to the morph, 5 V over the knob's whole travel.
OBERT.±5 VMoves the number of partials, through the attenuverter OBT CV.
NEIG.±5 VAdds to the tilt, 5 V over the whole travel; with the knob up to ±24 dB per octave.
SPREIZ.±5 VMoves the stretch, through the attenuverter SPR CV.
L (output)±5 VLeft channel.
R (output)±5 VRight channel. For mono set the width to 0, 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. With a lot of resonance or vowel a spectrum can go over full scale; the output rounds that off softly.

First patches

Morphing pad
Organ as A, hollow as B, no gate cable, a slow LFO into MORPH. Width (KLANG A held, VOKAL) fully right.
Bell
Bright or glass, SPREIZ. well to the right, ABKLING. at about two seconds, gate from the sequencer; in the KLANG A layer a little beating and sustain at 0.
Talking bass
Saw, ABKLING. fully right, gate and V/OCT from the sequencer, turn VOKAL by hand between A and U and put an LFO into NEIG.
Counting partials
Saw, phases alike (KLANG B held, OBT CV fully left), OBERTÖNE slowly from left to right, or an envelope CV into OBERT.

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-additiv.bin, written to address 0x0 as in the build guide, step 8. It needs no tables; the first start is as short as any other.

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.