TONWERK.MODUL

Tonwerk Wavetable als Eurorack-Modul

Die Klangerzeugung des Plugins Tonwerk Wavetable auf einem ESP32-S3, als 14-TE-Modul fürs Eurorack zum Selberbauen. Eine monophone Stimme: zwei Wavetable-Oszillatoren mit Warp, Unisono und Sub, ein Multimode-Filter mit Drive und eine Hüllkurve. Gebaut für Bässe, die knurren.

Das fertige Modul im Rack: schwarze Front mit gelber Schrift, zehn Regler, zwei Tasten mit LEDs, acht Buchsen
Der erste Aufbau, 27.10.2026, noch mit den mitgelieferten Knöpfen.
Bauanleitung Platinen, Teile, Firmware

Alles zum Nachbauen ist offen: Platinen (KiCad), Frontplatte und Knöpfe zum Drucken, Firmware als fertige Datei. Kosten etwa 60–80 € für die Teile plus die Platinen. Die Hauptplatine gibt es auch als SMD-Variante, die der Fertiger bestückt (noch nie gebaut).

Überblick

Zweite Firmware: Dieselben Platinen spielen auch Tonwerk Physical, Physical Modeling mit Erreger und Resonator, bis zu vier Stimmen und einer eigenen Frontplatte (gelb mit schwarzer Schrift). Eine dritte spielt Tonwerk PD, Phase Distortion mit zwei Linien und Chorus in Stereo, eine vierte Tonwerk Granular, Kornwolken aus neun Klangquellen, eine fünfte Tonwerk Additiv, 64 Sinus-Teiltöne aus zwei gemorphten Spektren.

Gebaut ist bisher ein Modul (die bedrahteten Platinen v0.1). Geprüft: Versorgung, Flashen, Klang am VOICE-Ausgang, die Regler. Noch nicht auf der Hardware geprüft sind die CV-Eingänge und die V/Oct-Kalibrierung.

Bedienung

Die Front von oben nach unten: neun Regler in drei Reihen, darunter die WARP-Taste mit LED 1 links, der Regler CUT CV in der Mitte, die FILTER-Taste mit LED 2 rechts, dann zwei Reihen Buchsen. Die beiden Ausgänge OSC und VOICE sind unten rechts eingerahmt.

Die drei Ebenen

Jeder Regler hat bis zu drei Aufgaben:

Taste halten, Regler drehen, Taste loslassen. Die versteckten Werte und die Modi speichert das Modul 3 Sekunden nach der letzten Änderung; nach dem Ausschalten ist alles wieder da.

Pick-up: warum ein Regler manchmal nichts tut

Ein Regler steht nach einem Ebenenwechsel selten dort, wo der Wert der anderen Ebene steht. Damit nichts springt, übernimmt er erst, wenn er den gespeicherten Wert erreicht oder überquert. Bis dahin tut Drehen nichts; einmal über den Wert hinweg, folgt der Wert dem Regler. Das gilt in beiden Richtungen: Wer in einer versteckten Ebene gedreht hat, muss den Regler nach dem Loslassen auch in der normalen Ebene erst wieder an seinen alten Wert heranführen.

Alle Regler

ReglerNormalWARP gehaltenFILTER gehalten
TUNEStimmung ±2 Oktaven in HalbtönenOszillator B: Transponierung ±24 HalbtöneAttack 0,5 ms bis 2 s
FINEFeinstimmung ±50 Cent, um die Mitte ein kleiner Bereich mit 0Oszillator B: Feinstimmung ±50 Cent–
TABLETabelle, zehn Stück (Liste unten)Oszillator B: Tabelle, ganz links = B aus–
POSITIONPosition in der Tabelle (der Klang morpht von links nach rechts)Oszillator B: PositionKeytracking des Filters 0–100 %
WARPStärke des Warp-ModusUnisono 1–4 Stimmen je Oszillator–
CUTOFFFilterfrequenz 20 Hz bis 20 kHzUnisono-Verstimmung 0–100 CentHüllkurve auf Cutoff, 0–6 Oktaven
RESOResonanz (beim Kamm: Rückkopplung)Sub-Lautstärke, ganz links = ausDrive vor dem Filter
DECAYDecay und Release, 5 ms bis 5 sSub: −1 Okt. Sinus, −2 Okt. Sinus, −1 Okt. Rechteck, −2 Okt. RechteckSustain 0–100 %
POS CVAbschwächer für die POS-Buchse: Mitte 0, rechts voll, links umgekehrt––
CUT CVAbschwächer für die CUTOFF-Buchse: Mitte 0, rechts 1 V/Oktave, links umgekehrt––

Ab Werk (und nach jedem Flashen) ist Oszillator B aus, Unisono eine Stimme mit 20 Cent Verstimmung für später, der Sub aus, Attack 0,5 ms, kein Keytracking, keine Hüllkurve auf dem Cutoff, kein Drive und Sustain 100 %. Der Warp-Modus ist aus, das Filter LP24.

Die Tasten

Kurz drücken
Unter 0,3 Sekunden und ohne an einem Regler zu drehen: WARP schaltet den Warp-Modus weiter, FILTER den Filtermodus. Die Taste wirkt beim Loslassen.
Halten
Länger als 0,3 Sekunden, oder kürzer, aber mit Drehen: öffnet die versteckte Ebene, der Modus bleibt. Ein Regler, der beim Drücken nur leicht berührt wird, zählt nicht als Drehen.
Beide beim Einschalten halten
Startet die V/Oct-Kalibrierung.
Nur WARP beim Einschalten halten
Startet das Update über WLAN.

Warp-Modi (WARP kurz drücken, LED 1)

Der Modus gilt für beide Oszillatoren, der WARP-Regler und die WARP-Buchse stellen die Stärke.

LED 1ModusWas er tut
grauausDie Tabelle klingt, wie sie ist.
cyanSyncLiest die Tabelle 1- bis 8-mal pro Periode und beginnt jede Periode neu: der harte Sync-Klang, der beim Drehen „singt“.
gelbBendBiegt die Phase: der Anfang der Periode wird schneller gelesen, das Ende langsamer. Heller, näselnd.
magentaPWMLiest die ganze Tabelle in einem immer kürzeren Teil der Periode (bis 5 %), im Rest bleibt er auf dem Anfangswert stehen: wie Pulsbreite für jede Tabelle.
rotFMOszillator B moduliert die Phase von A (und A die von B). B muss dafür nicht hörbar sein: Ist er aus, läuft er still als Modulator mit, und sein TUNE in der WARP-Ebene stellt das Verhältnis. Bei voller Stärke wird es schnell zu Rauschen.

Filtermodi (FILTER kurz drücken, LED 2)

LED 2ModusWas er tut
cyanLP12Tiefpass 12 dB/Oktave, weich.
blauLP24Tiefpass 24 dB/Oktave, der klassische Bass. Ab Werk.
gelbHP12Hochpass 12 dB/Oktave.
grünBP12Bandpass.
magentaNotchKerbfilter, nimmt ein Band heraus.
rotKammKammfilter auf die Periode des Cutoffs gestimmt, RESO ist die Rückkopplung: metallisch, mit Resonanz fast eine Saite.
grauausKein Filter, nur die Hüllkurve.

Drive (FILTER-Ebene, RESO) sättigt weich vor dem Filter, bis etwa 24 dB Verstärkung, im Pegel ausgeglichen. Der Sub kommt erst hinter dem Filter dazu, so bleibt der Bass sauber, während das Filter sich bewegt.

Die zehn Tabellen

Beim Drehen an TABLE zeigt LED 1 für eine Sekunde die Tabelle als Farbe aus dem Farbkreis, danach wieder den Warp-Modus. POSITION fährt jede Tabelle von links nach rechts durch:

Nr.LED 1TabellePOSITION von links nach rechts
1rotBasisSinus, Dreieck, Sägezahn, Rechteck, ineinander überblendet
2orangeSyncSägezahn mit Sync, seine Frequenz steigt auf das Achtfache
3gelbgrünPWMPuls vom Rechteck bis zur dünnen Nadel
4grünVokalEine gesungene Stimme durch die Vokale a, e, i, o, u
5türkisFM-GrowlZwei-Operator-FM, Modulator eine Oktave höher, Index bis 8: das Knurren
6cyanFalterEin Sinus, immer härter in einen Wavefolder
7blauHarmonischGrundton plus ein Band von Obertönen, das acht Oktaven hinaufwandert
8indigoKammSägezahn mit Kerben, die sich schließen, am Ende nur die geraden Obertöne
9violettBitcrushSägezahn und Sinus in immer weniger Stufen
10pinkRauhSägezahn mit Sinus darunter, immer härter und schief gesättigt

Was die LEDs sonst zeigen

Im Spiel leuchten beide mit der Hüllkurve: hell, solange ein Ton klingt, gedimmt (nie ganz dunkel) dazwischen, damit der Modus immer lesbar bleibt.

Gelb und cyan, kurz
Das Modul startet.
Rot und gelb, bis zu einer Minute
Erster Start nach dem Flashen einer neuen Tabellen-Version: das Modul berechnet die Tabellen und legt sie im Flash ab. Kein Ton, nicht ausschalten.
Beide blinken rot
Zu wenig PSRAM: das DevKit ist kein N16R8.
Eine blinkt weiß
Kalibrierung, das Modul wartet auf diese Taste.
Beide blinken dreimal grün oder rot
Kalibrierung gespeichert oder verworfen.
Blau im Wechsel, cyan, grün, rot blinkend
Update über WLAN: wartet, empfängt, fertig, Image abgelehnt oder abgebrochen (siehe unten).

Buchsen

BuchseBereichWas sie tut
V/OCT−1 bis +7 VTonhöhe, 1 V pro Oktave, 0 V = C2. Kommt zu TUNE und FINE dazu.
GATEab etwa 1,4 VStartet die Hüllkurve, fällt es ab, beginnt das Release. Ohne Kabel ist das Gate dauerhaft an: das Modul spielt als Drone.
TABLE±5 VVerschiebt die Tabelle, +5 V fahren von ganz links durch alle zehn.
POS±5 VVerschiebt die Position, über den Abschwächer POS CV.
WARP±5 VKommt zur Stärke des Warp dazu, +5 V = voll.
CUTOFF±5 VVerschiebt den Cutoff über den Abschwächer CUT CV; rechts 1 V pro Oktave, so folgt das Filter mit dem V/Oct-Signal der Tonhöhe.
OSC (Ausgang)±5 VOszillator A und B mit Unisono, Warp und Sub, ohne Filter und ohne Hüllkurve: ein VCO, klingt immer.
VOICE (Ausgang)±5 VDasselbe durch Drive und Filter, der Sub dahinter dazu, dann durch die Hüllkurve als VCA.

Die Ausgänge haben Modulpegel. Für Kopfhörer sind sie viel zu laut, immer über einen Mixer oder ein Ausgangsmodul gehen.

Erste Patches

Drone
Nur VOICE an den Mixer. Ohne Gate-Kabel klingt das Modul sofort. TABLE wählen, POSITION und WARP langsam drehen, CUTOFF und RESO dazu.
Bass vom Sequencer
Tonhöhe an V/OCT, Gate an GATE, VOICE an den Mixer. DECAY kurz, FILTER-Ebene: Sustain (DECAY) herunter, Hüllkurve auf Cutoff (CUTOFF) auf zwei bis drei Oktaven, CUTOFF in der normalen Ebene tief. Für mehr Druck in der WARP-Ebene den Sub dazu (RESO).
Wobble
Ein LFO an die CUTOFF-Buchse, CUT CV nach rechts, LP24 und etwas RESO. Mit einem zweiten LFO an POS und der Tabelle FM-Growl wird es Dubstep.
Dicker Lead
WARP-Ebene: Unisono (WARP) auf 3 oder 4, Verstimmung (CUTOFF) auf 20 bis 40 Cent, Oszillator B (TABLE) mit einer zweiten Tabelle, TUNE von B eine Oktave hoch.
Externes Filter
OSC statt VOICE nehmen: der rohe Oszillator für ein anderes Filtermodul und einen VCA.

V/Oct kalibrieren

Damit V/OCT über mehrere Oktaven stimmt, misst das Modul einmal zwei Spannungen. Dafür braucht es eine Quelle, die genau 1,000 V und 3,000 V liefert (ein Labornetzteil und ein Multimeter reichen; ein MIDI-CV-Interface geht auch, wenn man die Noten nachmisst, die genau 1 V und 3 V ergeben).

  1. Ausschalten. Alle Kabel ziehen außer dem für V/OCT: die übrigen Eingänge werden dabei als 0 V gemessen.
  2. Beide Tasten halten und einschalten. LED 1 blinkt weiß.
  3. Genau 1,000 V an V/OCT, WARP drücken. Das Modul misst eine halbe Sekunde, dann blinkt LED 2 weiß.
  4. Genau 3,000 V anlegen, FILTER drücken.
  5. Dreimal grün: gespeichert, das Modul startet normal. Dreimal rot: die Messung war unplausibel (Kabel, Spannung?), die alten Werte bleiben; von vorn beginnen.

Danach mit einem Stimmgerät über mehrere Oktaven nachprüfen. Ohne Kalibrierung rechnet das Modul mit den Sollwerten der Schaltung; wie gut das stimmt, hängt von den Bauteilen ab.

Neue Firmware

Die Firmware ist eine Datei, tonwerk-modul.bin, geschrieben an Adresse 0x0 mit dem Web-Flasher von Espressif im Browser (Chrome oder Edge). Wie, steht in der Bauanleitung, Schritt 8. Das geht im Rack oder lose am USB-Kabel. Für Tonwerk Physical ist es tonwerk-physical.bin, für Tonwerk PD tonwerk-pd.bin, für Tonwerk Granular tonwerk-granular.bin, für Tonwerk Additiv tonwerk-additiv.bin.

Flashen über USB löscht die gespeicherten Modi, die versteckten Werte und die Kalibrierung, die Tabellen bleiben. Darum danach neu kalibrieren. Über WLAN (unten) bleibt alles erhalten.

Update über WLAN

Neben dem Instrument liegt im Flash ein kleiner Updater. Mit ihm kommt eine neue Firmware ohne USB-Kabel aufs Modul, auch eine andere der fünf:

  1. Das Modul mit gehaltener linker Taste einschalten (WARP; bei den anderen Firmwares ERREGER, WELLE 1, QUELLE oder KLANG A), die rechte nicht. Die LEDs blinken blau im Wechsel.
  2. Mit Handy oder Rechner ins WLAN Tonwerk-Modul gehen (ohne Passwort) und http://192.168.4.1 öffnen.
  3. Das Image wählen, dieselbe .bin wie für USB, und Hochladen. Während der Übertragung leuchten die LEDs cyan, die rechte flackert; danach beide grün, und das Modul startet mit der neuen Firmware.
Was erhalten bleibt
Gespeicherte Modi, versteckte Werte und die Kalibrierung. Geschrieben werden nur das Instrument und, bei Tonwerk Granular, seine Quellen.
Doch nicht
Die linke Taste noch einmal drücken. Nach 15 Minuten ohne Upload startet das Instrument von selbst wieder.
Rot blinkend
Das Image passt nicht oder die Übertragung brach ab; die Seite sagt, warum. War das Instrument schon überschrieben, bleibt der Updater an, auch nach dem Aus- und Einschalten, bis ein Image ganz angekommen ist. Das Modul steht nie ohne Firmware da.
Beide dauerhaft rot
Die Aufteilung im Flash kennt den Updater nicht: einmal über USB flashen.
WLAN bricht immer wieder ab
Das Modul startet neu, meist weil das Senden kurz mehr Strom zieht, als die Versorgung hergibt. Der Updater sendet darum mit wenig Leistung und sagt auf der Seite, wenn er neu gestartet ist. Hilft das nicht, das Modul fürs Update zusätzlich über USB versorgen. Ein Updater vom 13.11.2026 oder früher sendet noch mit voller Leistung; den Updater selbst schreibt nur USB neu.

Den Updater bringen erst die Firmwares vom 1.11.2026 an mit, und sie ändern die Aufteilung des Flashs: einmal über USB flashen, danach geht es über WLAN. Ältere Images nimmt der Updater nicht an. Das WLAN ist nur offen, solange der Updater läuft; das Instrument selbst hat kein WLAN. Auf einem Modul getestet (Tonwerk Granular über WLAN, 14.11.2026). USB geht immer.

Probleme

Ein Regler tut nichts
Er hat seinen Wert noch nicht erreicht (Pick-up). Einmal über den ganzen Weg drehen.
Eine Taste reagiert nicht
Kurz drücken und loslassen, ohne dabei an einem Regler zu drehen. Länger als 0,3 Sekunden gilt als Halten.
Kein Ton am VOICE-Ausgang
Steckt ein Kabel in GATE, aber es kommt kein Gate, bleibt die Hüllkurve zu. Kabel ziehen (Drone) oder ein Gate schicken. Auch Sustain 0 und kurzes DECAY machen aus einer Drone Stille. Klingt OSC, aber VOICE nicht, ist der Cutoff ganz unten oder ein Hochpass ganz oben.
Rauschen
FM oder Sync mit voller Stärke klingen so. WARP zurückdrehen oder den Modus wechseln (LED 1 grau = aus).
Verstimmt über die Oktaven
Kalibrieren, und FINE in der Mitte und TUNE prüfen.
Was macht das Modul gerade?
Über USB (115200 Baud, zum Beispiel in der Konsole des Web-Flashers) meldet es Startmeldungen, die Kalibrierung und alle 5 Sekunden die Last des Audio-Kerns.

Stand 28.10.2026. Quelltext, Platinen und Frontplatte stehen auf GitHub unter derselben PolyForm Noncommercial License wie die Plugins: für sich nachbauen ja, verkaufen nur mit Erlaubnis.