EMBER BRICK PRO 0.46 ALPHA – ORIGINALES TRIMUI OS

Status: USB-MIDI und Audio wurden mit 0.3 am Brick Pro bestaetigt.
Der Geraetetest fuer 0.12 steht aus.
Die AliExpress-Seite war nicht abrufbar; Ziel ist ausdrücklich TG4040 mit
originalem TrimUI OS, nicht Brick Hammer Pro U oder ein Android-Modell.

INSTALLATION
1. Das SD-Paket EMBER-Brick-Pro-TrimUI-OS-v0.46-alpha.zip am Stamm der SD-Karte
   entpacken. Ergebnis: Apps/EMBER-Brick/launch.sh und ember-brick.
2. Eigene WAV-Dateien in Apps/EMBER-Brick/Samples/ kopieren.
3. SD sicher auswerfen, ins Gerät einsetzen, im Apps-Menü EMBER Brick starten.
   Es wird keine Firmware geflasht. Das Programm liegt vollständig auf der SD.
4. Class-compliant USB-MIDI-Keyboard am USB-Host-Anschluss anschließen.
   Der Port muss vom Betriebssystem als /dev/snd/midiC*D* erkannt werden.
   Bei stromhungrigem Keyboard einen versorgten USB-Hub verwenden.
   Welcher USB-C-Port am konkreten Pro Host ist, bitte anhand Gerät/Handbuch prüfen.
5. Falls der Eintrag im Apps-Menü nicht erscheint oder der Start sofort endet:
   Apps/EMBER-Brick/log.txt prüfen. Firmwareversion und Log für Fehleranalyse aufheben.

BEDIENUNG
L1 / R1: vorherige/nächste Seite. Steuerkreuz hoch/runter: Zeile wählen.
Links/rechts: Wert ändern. A: einschalten/erhöhen. B: WAV-Browser schließen.
X: WAV-Browser; hoch/runter wählen, A laden, B abbrechen.
Y: C4 halten/spielen. START: alle Noten stoppen.
Linker Stick horizontal: Cutoff relativ ändern. Rechter: Grain-Position ändern.
SELECT: Engine-Preset speichern. R2: Engine-Preset zurückladen. MENU: beenden.
Die Tastenbelegung basiert auf Community-Dokumentation und ist am Gerät zu prüfen.
Volume-Tasten bleiben bei der Firmware. LEDs und Seitenschalter werden nicht verändert.

KLANG / MIDI
Analog ist anfangs aktiv; Sample, Granular und FM auf ihren Seiten zuschalten.
Alle vier Klangquellen lassen sich mischen. Demo-Sample ist im RAM vorhanden.
WAV: PCM16 little-endian, mono/stereo, 8–192 kHz; Stereo wird zu mono gemischt.
Maximal 262144 Frames pro Datei; längere Dateien werden abgeschnitten. Grundton C4.
Acht Engine-Stimmen plus acht einfache One-shot-Sample-Stimmen. Das ist eine
Implementierungsgrenze, keine Zusage zur gleichzeitigen Leistung des Geräts.
FM zunächst mit vier Operatoren. Sample-Layer noch ohne gemeinsamen Filter/FX.
USB-MIDI: Noten, Velocity, CC64 Sustain, Pitchbend, CC74 Cutoff und CC120/123 Panic.
CC1/Channel Pressure werden an die Engine weitergegeben; Wirkung bei passender Matrix.
Alle MIDI-Kanäle spielen denselben Klang. MIDI-Clock noch nicht implementiert.
USB-MIDI-Geräte werden etwa jede Sekunde neu gesucht; Trennung löst Panic aus.
Engine-Preset enthält keine Sample-Datei oder Sample-Layer-Pegel/Ein-Aus-Einstellung.

NEU IN 0.31
PROJECT: Links/Rechts wechselt durch 8 User-Slots und 10 Demo-Songs.
A laedt beide. SONG: START spielt, L2 exportiert als WAV.
Um eine Demo-Kopie zu speichern, User-Slot waehlen und SELECT druecken.

NEU IN 0.27
SETTINGS neben TRACK: Audio-Ausgang Auto / Bluetooth / Internal und
MIDI-Eingang All / Kanal 1-16. A speichert. Audio greift nach Neustart.
Bluetooth verwendet direkte nichtblockierende ALSA-Wiedergabe.

NEU IN 0.21
DRUMS: Part waehlen, X oeffnet die WAV-Auswahl. A oeffnet Ordner oder
laedt die WAV in den Part, Y hoert die WAV vor, B geht eine Ebene zurueck.
DRUMS: B oeffnet die Einstellungen. In der letzten Zeile mit links/rechts
Octal Deep oder Octal Punch waehlen, mit A alle acht Samples zuweisen.
Das Octal House Core Pack mit 44 WAVs liegt in DrumSamples/Octal House Core.
Die CC0-Lizenz und die Herkunftsnachweise liegen neben den Samples.
START auf SONG aktiviert das Arrangement und startet den Transport.
L2 auf SONG exportiert bei gestopptem Transport alle vier Spuren und
Effekte als Stereo-WAV nach Exports/Song-N.wav (48 kHz, 16 Bit).
Bluetooth-Kopfhoerer vor dem Start verbinden. EMBER sucht einen
verbundenen A2DP-Ausgang und oeffnet ihn direkt ueber BlueALSA.
Ohne erkanntes Geraet versucht EMBER den BlueALSA-Standard. Wenn
das Oeffnen fehlschlaegt oder beim Start keine Audiobloecke laufen,
verwendet EMBER den internen Codec. audio-output.txt kann die Auswahl
mit internal oder bluetooth erzwingen. auto ist die Vorgabe.
SONG: A oeffnet die Zelle. DELETE CELL waehlen und mit A bestaetigen
macht den Takt stumm. X RESET TO BASE stellt die Basiszuweisung wieder her.
Bei fehlenden Audio-Callbacks meldet EMBER den Zustand im UI und Log.
Das Log erfasst gestartete und abgeschlossene Audiobloecke.

NEU IN 0.20
SONG: bis zu 64 Takte. Ein Pattern startet in seiner Zelle und laeuft ueber
folgende BASE-Zellen weiter. Ein anderes Pattern oder SILENT beendet es.
Beim Zuweisen wird der Song bei Bedarf bis zum Pattern-Ende verlaengert.
Das Zellenmenue zeigt Slot, Namen und Patternlaenge. Alte unbenannte Slots
zeigen einen Platzhalter. Namen werden beim naechsten Speichern hinterlegt.
SCOPE: hoch/runter aendert Anzeige-Gain (1x, 2x, 4x, 8x, 16x).
DRUMS: Stimme waehlen und X druecken, dann WAV aus DrumSamples/ laden.
16 neu synthetisierte 808-/909-inspirierte WAVs unter CC0 liegen bei.

NEU IN 0.19
TRACK steht vor OSC 1 und erscheint nach dem Splash. Hoch/runter waehlt
Synth 1, 2 oder 3, A oeffnet dessen OSC 1. Drums bleibt Spur 4.
ROLL: B bis SLOT, links/rechts waehlt 1-8, SELECT speichert das Pattern
fuer SONG, R2 laedt den Slot. Ausserhalb SLOT bleibt SELECT das Roll-Menue.
DRUMS: B, USER SLOT waehlen, SELECT speichert ein Drum-Pattern fuer SONG.
SONG: A oeffnet die Zelle. PATTERN waehlt BASE, SILENT oder Slot 1-8.
Synth-Zellen haben zusaetzlich PRESET mit den User-Preset-Slots der Spur.
X kopiert, Y fuegt ein. B schaltet MOVE um, links/rechts tauscht Zellen.
Eine Pattern-Zelle spielt den ersten Takt ihres Slots ab ihrem Taktanfang.
BASE spielt das laufende Spurpattern weiter. Leere nummerierte Synth-Slots
bleiben still; fehlende Drum-Slots nutzen das Basis-Drum-Pattern.
Die Song-Zellen werden im Projekt gespeichert und im WAV-Export gerendert.
Pattern-, Drum- und Preset-Slots bleiben Dateiverweise auf derselben SD-Karte.

NEU IN 0.18
ROLL > SELECT > SYNTH TRACK waehlt Synth 1-3. Der Kopf zeigt EDIT SYNTH.
OSC, FILTER, LFO, DRAW und MOD bearbeiten den gewaehlten Synth.
WAV-Baenke und Preset-Slots gehoeren zur jeweiligen Synth-Spur.
MIX: Steuerkreuz waehlt Zelle. A/Y aendert Pegel oder Pan, schaltet
Mute/Solo um. X setzt die Zelle zurueck. Spur 4 ist Drums.
SONG: bis zu 16 Takte. L2/R2 waehlt User-Preset 1-32, A setzt es,
X setzt BASE, Y schaltet die Zelle stumm, B aktiviert Verschieben.
Im Verschieben-Modus tauscht Links/Rechts Nachbarzellen. R2 setzt die
Songlaenge auf den Cursor-Takt. SELECT schaltet Song an/aus. START spielt.
Die Preset-Zellen wechseln den Klang am Taktanfang. Jede Spur spielt dabei
ihr eigenes Pattern weiter. Fehlende User-Presets fallen auf BASE zurueck.
Song-Zellen nutzen die im Projekt geladenen WAV-Baenke der jeweiligen Spur.
PROJECT speichert Mixer, Arrangement, Sounds und Patterns. Die Song-Zellen
verweisen auf die User-Preset-Slots auf der Karte. WAV-Export rendert den
Song mit Mix, Pan, Mute und Solo, wenn SONG eingeschaltet ist.
Tape und Zusatz-Effekte bleiben auf der Summe. Der One-Shot-Sampler bleibt
auf Synth 1. Die Drum-Spur ist einmal vorhanden und benutzt ihr Drum-Pattern.

NEU IN 0.17
PRESET: Y hoert den markierten Sound mit einer kurzen Phrase vor. A laedt ihn.
NEW SOUNDS: vier weitere Layer aus Analog, FM und Wavetable oder Granular.
ROLL: SELECT, SYNTH TRACK waehlt Synth 1-3 zum Editieren und Spielen.
Synth 1 hat den bisherigen vollen Editor. Synth 2/3 haben eigene Patterns,
Werks-/Layer-Presets und Pegel; PROJECT X/Y stellt ihren Pegel ein.
DRUMS: Steuerkreuz waehlt Instrument und Schritt, A setzt, Y akzentuiert.
B oeffnet Kit, sechs Factory Beats, acht Slots und die Stimmenparameter.
SELECT speichert Drum-Pattern, R2 laedt. START startet/stoppt beide Sequencer.
X laedt ein WAV aus DrumSamples/ auf die markierte Stimme. Pfade bleiben verlinkt.
808-/909-inspirierte Synthese, acht Stimmen. Eigene WAVs pro Stimme sind moeglich.
PROJECT: links/rechts waehlt Slot 1-8; SELECT speichert, R2 laedt alle vier Spuren.
WAV-Export rendert alle vier Spuren. MIDI-Export bleibt pro Synth-Spur.
Drum-Sequenz und Synth-Patterns loopen bei gemeinsamer BPM.

NEU IN 0.16
Splash erscheint drei Sekunden lang; Start-Eingaben werden ignoriert.
SCOPE zeigt linke/rechte Ausgangswellenform. Links/rechts aendert die
Zeitbasis, A friert ein, Y spielt C4 zum Testen.
PRESET: CATEGORY waehlen, SOUND waehlen, A laedt. USER SLOT und SELECT/R2
speichern/laden weiterhin eigene Presets. NEW SOUNDS enthaelt acht neue Sounds.
MIDI/Factory: 40 Patterns in fuenf Gruppen, vier oder acht Takte.

NEU IN 0.15
ROLL: SELECT oeffnet das Piano-Roll-Menue. Laden, Speichern unter Namen,
BPM, Taktzahl, Raster, Vorzaehler und Exporte stehen dort zusammen.
R2 ist die linke beleuchtete Funktionstaste unter dem Display und oeffnet
die Pattern-Liste direkt. Links/rechts wechselt die Gruppe, hoch/runter die
Datei. Y hoert mit dem aktuellen Synth-Klang vor, A laedt, B geht zurueck.
Die Vorschau ersetzt das aktuelle Pattern nicht.
HELP enthaelt Tastenhilfe und https://mpctoolkit.com.
Der animierte Startbildschirm kann mit einer Taste uebersprungen werden.

NEU IN 0.14
ROLL: R2 oeffnet direkt die Pattern-Liste. A laedt, B schliesst die Liste.
Factory/ sind die 24 Vorlagen, Saved/ sind benannte Patterns, Slot 1-8
zeigt vorhandene alte Speicherplaetze. Eigene .mid-Dateien kommen nach MIDI/.
SELECT oeffnet SAVE AS. Steuerkreuz waehlt Zeichen, A fuegt ein, X loescht.
SELECT oder START speichert nach Patterns/. Namensduplikate werden nummeriert.
Das native Format behaelt Tempo, Laenge, Raster und Velocity.
In BARS springt A zum naechsten Takt.
Diese Tastenbelegung ersetzt die ROLL-Lade-/Speicherhinweise weiter unten.

NEU IN 0.13
ROLL: bis zu 64 Takte bei 4/4, MIDI-Noten 0-127, 48 PPQ. B bis BARS,
links/rechts erweitert oder entfernt einen leeren letzten Takt. R2 springt
zum naechsten Takt. Im SLOT-Modus laedt R2 das gespeicherte Pattern.
MIDI IMPORT uebernimmt bis zu 64 Takte aus SMF 0/1 und verwendet das
Starttempo. Die Exportlaenge wird beim Import auf die Patternlaenge gesetzt.
MIDI/Factory enthaelt sechs editierbare Viertakt-Patterns.
FILTER zeigt Amp- und Filter-ADSR mit animierten Pegelmarken.
EFFECTS enthaelt jetzt Bitcrush, Tremolo und Stereo-Breite.
MOD zeigt Oszillator und Quelltyp beim Ziel an.
X bei WT oder Granular zeigt passende Werks-WAVs sowie eigene WAVs aus Samples/.
WAV-Import prueft Dateigroesse und Format, maximal 8 MiB je Datei.
Die WAV-Verarbeitung fuer Wavetables verwendet vorberechnete Harmonische.

NEU IN 0.12
PRESET: 88 EMBER-Werksklaenge plus 16 Genre-Einstiege.
FACTORY oder GENRE mit links/rechts waehlen und mit A laden.
USER SLOT waehlt einen von 32 Plaetzen. SELECT speichert, R2 laedt.
Presets merken sich WAV-Dateiverweise und den Sampler-Mix.
Eigene WAVs bleiben in Samples/. Mikrofonaufnahmen im RAM werden nicht eingebettet.
ROLL: X startet weiterhin USB-MIDI-Aufnahme mit Vorzaehler.
B bis MIDI IMPORT, A oeffnet .mid/.midi aus Apps/EMBER-Brick/MIDI/.
Import unterstuetzt SMF 0/1 mit PPQ, ersten Takt und Noten C3-B4.
Noten werden auf das interne 48-PPQ-Raster gerundet.
B bis MIDI EXPORT, links/rechts waehlt die Taktzahl, A schreibt .mid nach Exports/.
MIDI enthaelt Piano-Roll-Noten, Tempo, Velocity und Laengen. WAV enthaelt Audio.
Analog: Vibrato und Bend-Range. FM und Wavetable: Drift, Ringmod und Wavetable-Trim.

NEU IN 0.11
ROLL: B bis EXPORT. Links/rechts waehlt 1-64 Takte, hoch/runter schaltet
GRAIN GEN fuer die Datei um. A rendert das Pattern als 48-kHz-PCM16-Stereo-WAV
mit zwei Sekunden Ausklang nach Exports/. Bei GRAIN GEN ON werden aktive
Granular-Oszillatoren auch bei leerem Pattern generativ gerendert. Die
Generatoreinstellungen kommen von GRAIN GEN und starten beim gesetzten Seed.
Tape wird mit dem aktuellen Mix mitgerendert. Export pausiert Live-Wiedergabe.

NEU IN 0.10
GRAIN GEN: PLAY einschalten, nachdem ein OSC auf GRANULAR gestellt wurde.
ROOT MIDI, SCALE, OCTAVES, RATE, PROBABILITY, GATE, STEP SPREAD und SEED
steuern einen reproduzierbaren Zufallslauf. Er spielt nur Granular-Oszillatoren
und verwendet das Tempo der Piano Roll. START in den Klangseiten stoppt ihn.
EFFECTS > TAPE: MIX, SATURATION, TONE, WOW, FLUTTER und HISS.
Tape liegt auf dem Ausgang und wird auch beim WAV-Export angewendet.
Granular: REGION START/END begrenzen den Ausschnitt. Die Wellenform markiert ihn.
WAVs wie bisher selbst in Samples/ auf der SD ablegen und mit X waehlen.
Analog: Suboszillator, Mono/Legato und Glide. FM: benannte Algorithmen,
Phase, Phasenrandomisierung, Stereo und Trim. Wavetable: Phase Bend,
Startphase, Phasenrandomisierung, Stereo und benannte Warp-Modi.
ROLL: Mit B zu EXPORT wechseln und A druecken. Export rendert ein Pattern
mit zwei Sekunden Ausklang als 48 kHz PCM16 stereo in Exports/.
Der Export rendert die Piano Roll, ohne den generativen Zufallslauf mitzuschreiben.
Waehrend des Exports pausiert die Wiedergabe. Vorhandene Exporte bleiben erhalten.
Presets speichern auch die neuen Klangparameter und Generator-/Tape-Einstellungen.
Generator startet nach Preset-Recall auf Wunsch ueber PLAY.

NEU IN 0.9
ROLL: A setzt/loescht. B wechselt den Editiermodus, MOVE verschiebt per Steuerkreuz.
RESOLUTION: 1/16, 1/16T, 1/32, 1/32T, 1/64 oder 1/64T.
COUNT IN: 1-3 Takte. X startet MIDI-Aufnahme mit Klick, START stoppt.
SELECT speichert den gewaehlten Slot, R2 laedt ihn. Alte Patterns werden migriert.
MIX: Pegel fuer OSC 1-3 und Master.
EFFECTS: Effekt in Zeile 1 waehlen, darunter stehen seine Parameter.
LFO: PREVIEW waehlt einen LFO. Formname und Wellenform stehen darunter.
MOD: 16 Slots, Oszillatorziele werden beim Durchblaettern nach Typ gefiltert.
OSC: erweiterte Analog- und FM-Parameter; FM OPERATOR MODE fuer Einzeleditierung.
WAV-Dateien selbst nach Samples/ kopieren. X in einem Wavetable- oder Granular-OSC
laedt in diesen OSC, X auf SAMPLE in den gemeinsamen Sample-Slot.
PCM16 mono/stereo. Bei Wavetable sind 512 Samples pro Zyklus fuer Mehrfachframes
vorgesehen; andere Laengen werden als Einzelzyklus interpretiert.
B am OSC waehlt wieder die Werktabelle bzw. das gemeinsame Sample.
Presets speichern Dateiverweise. WAV-Dateien bleiben auf der SD.
Der Granulator nutzt EMBER mit eigenen WAVs, Grain-Fenstern und Stereo-Streuung.

NEU IN 0.8
L1/R1 blättert durch OSC 1-3, SAMPLE, FILTER, EFFECTS, LFO, DRAW, MOD, PRESET, ROLL.
OSC: SOURCE wählt Off, Analog, FM, Wavetable, Granular, Pluck oder Additive.
Die Parameterliste scrollt. X öffnet WAV-Dateien; alle Granulatoren teilen das aktive WAV.
Wavetable nutzt die EMBER-Werktabelle. Ansicht: perspektivisch gestapelte Frames.
DRAW: Punkt, Wert, Kurvenform und Step ändern. Unter MOD "DRAW LFO" routen.
PRESET: Benutzerplatz wählen, SELECT speichern, R2 laden.
Werksklang in der zweiten Zeile mit links/rechts wählen und mit A laden.
ROLL: B wechselt Grid, Länge, Velocity, Tempo, Slot; links/rechts editiert.
Länge in Viertelschritten eines Sechzehntels; Velocity 1–127 (Änderung in Viererschritten).
Slot 1–8 wählen, SELECT speichern, R2 laden. Ältere Patterns bleiben lesbar.
MIC: versucht mehrere Raten und Kanalzahlen. Falls nötig wird Audio während
der Aufnahme geschlossen und danach wieder geöffnet. Details in log.txt.

NEU IN 0.7
ROLL: 16 Sechzehntel, C3 bis B4, mehrere Noten pro Schritt.
Steuerkreuz bewegt den Cursor, A setzt/loescht Noten, Y hoert den Ton vor.
START startet/stoppt. X schaltet Tempo-Modus, links/rechts aendert BPM.
SELECT speichert das Pattern, das beim Start wieder geladen wird.
Der Sequencer spielt den aktuellen Klang intern, auch beim Wechsel des Reiters.
Die Schriftzeichen werden einzeln gerastert.

NEU IN 0.6
SAMPLE -> RECORD MIC -> A startet die Mikrofonaufnahme. A oder B beendet sie.
Bei 262144 Frames (rund 5,46 s bei 48 kHz) endet die Aufnahme automatisch.
Die Aufnahme ersetzt das aktive Sample im RAM. Y oder MIDI spielt es sofort.
Unter GRANULAR die Quelle einschalten, um dieselbe Aufnahme granular zu spielen.
Aufnahmen werden nicht als WAV gespeichert. Bei Fehlern bleibt das vorige Sample aktiv.
log.txt zeigt den gewaehlten Eingang, die Aufnahmelaenge und den Spitzenpegel.

NEU IN 0.5
EFFECTS: Delay-Zeit, Feedback, Mix, Chorus, Drive und Hall.
Diese Werte werden im Engine-Preset gespeichert.
log.txt listet die vom Audiotreiber angebotenen Aufnahmegeraete auf.

NEU IN 0.4
Reiter, markierte Parameterzeilen, Sample-Wellenform, Granular-Position,
MIDI-Status und Ausgangspegel.

NEU IN 0.3
Das Audio bleibt beim Anschliessen eines MIDI-Geraets geoeffnet.
Sample-Anfaenge und -Enden werden ueber bis zu 5 ms ein- und ausgeblendet.
DELAY MIX auf FILTER / AMP regelt den Echoanteil.

AUDIO / FEHLERSUCHE
SDL2, 48 kHz stereo, standardmäßig 512 Frames. Bei Knacksern in launch.sh
EMBER_BUFFER auf 1024 oder 2048 setzen. Das erhöht auch die Verzögerung.
log.txt nennt Audiotreiber, Controller, MIDI-Geräte und alle zehn Sekunden
Callback-Anzahl, zu langsame Blöcke und längste Renderzeit. Diese Zähler messen
keine vollständigen Hardware-Xruns und keine Ende-zu-Ende-Latenz.
Original TrimUI OS muss SDL2 und USB-MIDI bereitstellen. Ohne Gerät sind
Anzeigetreiber, Firmware-ABI, Audio-Routing und USB-Stromversorgung nicht verifiziert.
Das Paket ist nicht für KNULLI/NextUI/muOS freigegeben.

QUELLEN / BUILD
Quellpaket separat. build.py /path/to/zig baut für aarch64-linux-gnu.2.28,
Cortex-A53. Zig 0.17.1 getestet. SDL2 wird von der Firmware geladen; die erzeugte
Link-Stub-Bibliothek darf niemals auf die SD kopiert werden.
BUILD-REPORT.json dokumentiert die geprüften ELF-Abhängigkeiten.
REFERENZEN.txt enthält technische Quellen. LICENSE gilt für die EMBER-Engine.

NÄCHSTER GERÄTETEST
Start -> Analog mit Y hörbar -> USB-MIDI-Noten/Sustain -> WAV laden -> Granular
-> FM zuschalten -> fünf Minuten spielen und log.txt auf Renderzeiten prüfen.
Noch keine Latenz- oder Polyphoniezusage, kein hörbarer/visueller Test auf Hardware.











