TONWERK.MODUL

Tonwerk Granular as a Eurorack module

A fourth firmware for the same boards as the wavetable module: the sound engine of the plugin Tonwerk Granular. The module keeps cutting short grains from a sound source, each with its own envelope, pitch, direction and place in the stereo field, up to 40 at once. A choir turns into clouds, glass into sparks and a rhythm into a stutter.

Overview

Preview of the Granular front panel: 14 HP, magenta with black lettering

This firmware is tested on the computer; it has never run on an ESP32. Every grain reads from the PSRAM; with 40 grains I estimate up to half a core.

Operation

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

All knobs

KnobNormalQUELLE heldFENSTER held
TUNETuning ±2 octaves in semitonesAttack, 1 ms to 10 sFilter: off, lowpass 12, lowpass 24, highpass 12, bandpass (default off)
FINEFine tuning ±50 centsDecay, 5 ms to 10 sCutoff, 20 Hz to 20 kHz
GRÖSSELength of a grain, 5 ms to 1 sSustainResonance
POSITIONWhere in the source the grains come from, from start to endRelease, 5 ms to 10 sKey tracking of the filter
DICHTEGrains per second, 1 to 200Randomness: how irregularly the grains comeLFO rate, 0.05 to 20 Hz
STREUUNGHow far around the position a grain may start, up to the whole sourceReverse: the share of grains that run backwardsLFO target: none, position, spray, size, density, pitch, cutoff
SCANThe position moves through the source. In the middle it stands still, to the right it runs forwards, to the left backwards, at the ends twice as fast as the source itself.Grid of the pitch scatter: free, octaves, fifthsLFO amount: middle 0, left inverted
TONSTREUHow far a grain's pitch may stray, up to two octaves; the first part of the travel covers the first semitonesStereo width (default 60 %)LFO shape: sine, triangle, ramp down, ramp up, square, random
POS CVAttenuator for the POS jack: middle 0, right full, left inverted––
STR CVAttenuator for the STREU. jack: middle 0, right full, left inverted––

Sources (tap QUELLE, LED 1)

LED 1SourceWhat it holds
yellowChoirA sung a e i o u, three voices with vibrato. Default.
cyanGlassStruck glass every half second, on the note and its octaves.
magentaStringsSeven detuned saws, bowed in slowly, with a breathing lowpass.
greenPlucksEight plucked strings.
orangeOrganDrawbar organ, with a fast rotor from halfway on.
blueWindNoise through a wandering band, over a rumble.
violetMetalFM at inharmonic ratios, the index swelling up and back.
whiteSineA pure sine: the colour comes from the grains alone.
redRhythmTwo bars of sixteenths at 120 BPM: kick, hats and chord stabs.

All sources sit on C4 and are equally loud. Tapping FENSTER picks the shape of a grain, LED 2 shows it: bell (yellow, soft, default), flat (cyan, short fades, the grain sounds almost whole) or struck (magenta, a steep start, then dying away). Both LEDs light up with the envelope and dim with it, never fully off.

Striking and pitch

With a gate
A rising edge at GATE starts the envelope and reads from the position again: a source that SCAN runs through starts over. When the gate falls, the release begins.
With V/OCT only
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.
Cloud
Without a gate cable the cloud sounds all the time; POSITION, SCAN and an LFO at the POS jack move it.
Pitch
0 V plays the sources at their own pitch (C4), 1 V per octave. Every new grain takes the pitch present at V/OCT. A grain running faster than the source reads a copy filtered beforehand, so nothing folds back.

Sounds of your own

Each of the nine sources can be replaced by a recording of your own, on the page of the update over Wi-Fi (hold the left button while switching on, http://192.168.4.1): read sources, choose a source, choose a file (WAV, MP3, M4A …), set start and length of the cut, listen, use it, and finally write to the module. The browser turns it into mono at 48 kHz and evens out the level; the module then starts with the new sounds. The sources have 36 s together, each at least 0.5 s: for a long one, shorten others first (the number next to the name). A source plays at 0 V at its own pitch, as recorded. Settings and calibration stay; the factory sounds come back with tonwerk-granular.bin through the same page.

Jacks

JackRangeWhat it does
V/OCT−1 to +7 VPitch, 1 V per octave, 0 V = C4. A jump strikes (see above).
GATEfrom about 1.4 VRising: strike. Falling: release. Permanently on without a cable.
GRÖSSE±5 VAdded to the grain size, 5 V over the knob's whole travel.
POS±5 VShifts the position, through the POS CV attenuator; past the end it carries on from the start.
DICHTE±5 VAdded to the density, 5 V over the whole travel.
STREU.±5 VShifts the spray, through the STR CV attenuator.
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.

First patches

Choir cloud
Choir, no gate cable, GRÖSSE a little past the middle, DICHTE half, STREUUNG a third, SCAN slightly right. L and R into the mixer.
Glass sparks
Glass, FENSTER on struck, GRÖSSE small, STREUUNG fully right, TONSTREU fully right and the grid set to octaves in the QUELLE layer.
Stutter
Rhythm, flat window, DICHTE on a few grains per second, randomness (QUELLE held, DICHTE) at 0, a random CV at POS.
Melody
Plucks or strings, gate and V/OCT from the sequencer, SCAN right, in the QUELLE layer sustain at 0 and a short 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-granular.bin, written to address 0x0 as in the build guide, step 8. It carries its nine sources and is therefore 6.7 MB; writing it takes one to two minutes. The sources sit where the wavetable firmware keeps its tables: after flashing tonwerk-modul.bin again, it computes them once more at its first start.

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. If both LEDs blink red, the sources are missing: write the whole file to 0x0 again.

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.