From ad60cd9ba1b4349c3f73f62c8fe1197d51faa7ae Mon Sep 17 00:00:00 2001 From: Worldwave Date: Tue, 13 Oct 2026 22:30:10 -0400 Subject: [PATCH 01/10] #52 step 1: config files on the drive, the engine stack, the log on the drive Config files (.cnfg, ini, first line names the format) live in WAKES/CNFG/ on the drive and are read at every ON, before PRST. config/ in the repo is the built-in default every image carries; the build fails on a bad default. wakes-sp1-fresh writes both files to the drive as templates. - logs.cnfg: enabled + five categories (performance, controls, midi, usb, storage). Line by line: a bad line keeps its default and the log names it; the same key twice -> the first wins. - engines.cnfg (replaces engines.csv + engines-instructions.md): slot = engine, slots 1-24, and the file is the whole stack. The default stack is the 16 original Plaits engines; VA-VCF, phase-distortion, wave-terrain, string-machine and chiptune move out (17-24 empty for users). Engine names are hyphenated, and matching uses letters and digits only, ignoring case, so old PRST spellings still load. On the device it is all or nothing: missing, unreadable or any problem -> the built-in stack, every problem logged. The stack is in RAM (two copies, one atomic flip); ROTC and the start go to the first filled slot of the stack in use. - The log: sp1_logbuf now runs on sp1_logring, a ring with a file cursor and a STANDBY gap. With logging on, the card stays on and mounted through ON; the store thread appends category-filtered lines every 5 s and syncs. One file per session, WAKES/LOGS/NNNN.LOGS (session mod 10000; the number keeps counting in WAKES/LOGS/SESSION), the last 5 kept, 8 MB cap. A soft reset continues the same session. At shutdown the PRST save goes first, then the last flush, inside the same 4 s; the 30 s backstop never waits (rule 5a). - RAM log 96 -> 16 KB in storage builds (~80 KB freed); the fallback keeps 96. - docs/SAFETY.md rule 9: nothing configurable reaches the power path. - New host suite cnfgtest; uitest 21 and prsttest cover the stack, ROTC and the old names. Untested on hardware. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/build.yml | 3 +- README.md | 3 +- config/engines-instructions.md | 18 - config/engines.cnfg | 276 ++++++++++++++ config/engines.csv | 25 -- config/logs.cnfg | 38 ++ config/midi.ini | 2 +- docs/DEFAULTS.md | 15 +- docs/MARBLES-SETTINGS.md | 4 +- docs/MIDI.md | 2 +- docs/PLAITS-ENGINES.md | 158 ++++---- docs/SAFETY.md | 7 + docs/UI-PAGES.md | 4 +- firmware/CMakeLists.txt | 35 +- firmware/Kconfig | 6 +- firmware/src/main.c | 61 ++- firmware/src/sp1_cnfg.c | 468 +++++++++++++++++++++++ firmware/src/sp1_cnfg.h | 166 ++++++++ firmware/src/sp1_logbuf.c | 77 +++- firmware/src/sp1_logbuf.h | 28 +- firmware/src/sp1_logring.c | 181 +++++++++ firmware/src/sp1_logring.h | 64 ++++ firmware/src/sp1_plaits_ui.c | 122 ++++-- firmware/src/sp1_plaits_ui.h | 24 +- firmware/src/sp1_prst.h | 4 +- firmware/src/sp1_store.c | 667 +++++++++++++++++++++++++++++++-- firmware/src/sp1_store.h | 28 ++ firmware/src/sp1_synth.h | 2 +- firmware/src/sp1_ui_timing.h | 2 +- tools/gen_engines.py | 223 ++++++----- tools/gen_logs.py | 144 +++++++ tools/gen_midi.py | 2 +- tools/gen_prst.py | 2 +- tools/host-tests/README.md | 5 +- tools/host-tests/cnfgtest.c | 420 +++++++++++++++++++++ tools/host-tests/hostbuild.sh | 7 +- tools/host-tests/prsttest.c | 20 +- tools/host-tests/uitest.c | 49 +++ 38 files changed, 3005 insertions(+), 357 deletions(-) delete mode 100644 config/engines-instructions.md create mode 100644 config/engines.cnfg delete mode 100644 config/engines.csv create mode 100644 config/logs.cnfg create mode 100644 firmware/src/sp1_cnfg.c create mode 100644 firmware/src/sp1_cnfg.h create mode 100644 firmware/src/sp1_logring.c create mode 100644 firmware/src/sp1_logring.h create mode 100644 tools/gen_logs.py create mode 100644 tools/host-tests/cnfgtest.c diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index e4d4b19..ae2cba5 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -33,7 +33,7 @@ jobs: run: | sh tools/host-tests/hostbuild.sh routetest.cc uitest.c miditest.cc miditest_alt.cc \ miditest_pickup.cc miditest_clock.cc ../../third_party/feldd/test/test_usb_rt_parse.c \ - uactest.c prsttest.c + uactest.c prsttest.c cnfgtest.c "$SP1_HOST_BUILD_DIR/routetest" "$SP1_HOST_BUILD_DIR/uitest" "$SP1_HOST_BUILD_DIR/miditest" @@ -44,6 +44,7 @@ jobs: "$SP1_HOST_BUILD_DIR/test_usb_rt_parse" "$SP1_HOST_BUILD_DIR/uactest" "$SP1_HOST_BUILD_DIR/prsttest" + "$SP1_HOST_BUILD_DIR/cnfgtest" firmware: runs-on: ubuntu-latest diff --git a/README.md b/README.md index a5a10b4..f574e45 100644 --- a/README.md +++ b/README.md @@ -58,13 +58,14 @@ Output: `build/zephyr/wakes-sp1.bin`. The Zephyr patch is required and is lost o | | | |---|---| | [`docs/UI-PAGES.md`](docs/UI-PAGES.md) | every control on every page, in detail | -| [`config/engines.csv`](config/engines.csv) | which engine sits in each of the 24 slots (editable) | +| [`config/engines.cnfg`](config/engines.cnfg) | the default engine stack: which engine sits in each of the 24 slots, and what every engine does | | [`docs/PLAITS-ENGINES.md`](docs/PLAITS-ENGINES.md) | every engine, its faders and its CPU cost | | [`docs/MARBLES-SETTINGS.md`](docs/MARBLES-SETTINGS.md) | Marbles models, ranges and scales | | [`docs/DEFAULTS.md`](docs/DEFAULTS.md) | every default, and what a reset restores | | [`docs/MIDI.md`](docs/MIDI.md) | MIDI over USB: what it does, and how to change it | | [`config/midi.ini`](config/midi.ini) | the MIDI script: channel, legato, CC numbers (editable) | | [`config/audio.ini`](config/audio.ini) | USB audio out: its level (parked or on VOL) and the speaker while a host records (editable) | +| [`config/logs.cnfg`](config/logs.cnfg) | the log Wakes writes to its drive, `WAKES/LOGS/` (the default; Wakes reads `WAKES/CNFG/logs.cnfg` on its drive at every ON) | | [`docs/SAFETY.md`](docs/SAFETY.md) | rules for anyone changing the firmware | ## Licence diff --git a/config/engines-instructions.md b/config/engines-instructions.md deleted file mode 100644 index d55b86b..0000000 --- a/config/engines-instructions.md +++ /dev/null @@ -1,18 +0,0 @@ -# Configuring `engines.csv` - -Each row is a slot, 1 to 24. T2/T3 step through the slots in row order. - -- **Edit only the Engine column.** Don't change Slot or Glyph, and don't move whole rows. -- **Add an engine:** type its name into an empty Engine cell. -- **Remove an engine:** clear its Engine cell. Empty slots are skipped. -- **Reorder:** move names between Engine cells. -- Each engine can be used once. The device starts on the first filled slot. -- Save as UTF-8. If the glyphs turn into `?`, write them as `#` (full), `+` (half), `.` (off). -- Rebuild the firmware. If the file is wrong, the build names the line. - -## Engine names - -2-op FM · 6-op FM A · 6-op FM B · 6-op FM C · additive · bass drum · chiptune · chords · -filtered noise · grain / formant · hi-hat · modal · particle · phase distortion · snare drum · -speech · string · string machine · swarm · VA + VCF · virtual analog · wave terrain · -waveshaping · wavetable diff --git a/config/engines.cnfg b/config/engines.cnfg new file mode 100644 index 0000000..ee5984f --- /dev/null +++ b/config/engines.cnfg @@ -0,0 +1,276 @@ +; Format: ini +; ===================================================================================== +; Wakes — Plaits Engine Stack Configuration +; ===================================================================================== +; +; Mutable Instruments Plaits is a Eurorack macro-oscillator module created by Émilie Gillet, +; and its code comprises the audible portion of Wakes! Plaits has 24 sound engines. Its custom +; firmware community has created many more over the years. Wakes currently features the originals. +; This CNFG file determines the Plaits sound engines you want to include in your engine stack. +; T2 and T3 step through the slots in the order shown below, skipping empty slots or unused lines. +; Wakes starts on the first filled slot. You'll return to that slot when you Rip Out The Cables. +; +; - LIST FORMAT: +; N = engine-name ; +; +; - 16 default slots, with a maximum of 24. Each slot has its own glyph which flashes when selected. +; Glyphs are shown after the ; on each line. The glyph belongs to the SLOT, not to the engine +; in that slot. Moving an engine moves it to that slot's glyph. +; - To include an engine, paste its name directly from the ENGINES section below. +; Each engine can be used once. +; - Leave a slot empty (or delete its line) to skip it. +; - This file is the whole stack: a slot that is not listed here is empty. +; - Engines that are not in the stack will still be usable if a PRST uses them. +; You'll know an engine is not in your stack by a flashing glyph across all four face LEDs. +; +; Remember: in ini files, text following a ; or a # is a comment. + +[engines] +1 = virtual-analog ; ●○○○ +2 = waveshaping ; ●●○○ +3 = 2-op-FM ; ●●●○ +4 = grain-formant ; ●●●● +5 = additive ; ○●●● +6 = wavetable ; ○○●● +7 = chords ; ○○○● +8 = speech ; ○●○○ +9 = swarm ; ○○●○ +10 = filtered-noise ; ●○○● +11 = particle ; ○●●○ +12 = string ; ●○●● +13 = modal ; ●●○● +14 = bass-drum ; ●○●○ +15 = snare-drum ; ○●○● +16 = hi-hat ; ○○○○ +17 = ; ◐◐◐◐ +18 = ; ○◐◐○ +19 = ; ◐○○◐ +20 = ; ○◐○◐ +21 = ; ◐○◐○ +22 = ; ○◐◐◐ +23 = ; ○○○◐ +24 = ; ○◐○○ + + +; ===================================================================================== +; ENGINES +; ===================================================================================== +; +; This section contains a micro-manual for each Plaits engine Wakes can play, including +; engine names to copy from and paste above. +; Faders: F1 is always FREQ, but F2, F3 and F4 each have engine-unique parameters. +; The signals offered on the AUX output also differ between engines. +; Most engine parameters are unipolar. For engines where some parameters are bipolar, +; they're indicated below. + +; ------------------------------------------------------------------------------------- +; virtual-analog (default slot 1) +; ------------------------------------------------------------------------------------- +; Two analog-style oscillators mixed together: a variable square and a variable saw. +; F2 TIMB the square: narrow pulse -> full square -> hard-sync formants +; F3 MORP the saw: triangle -> saw, with a notch that widens +; F4 HARM detune between the two oscillators +; AUX two hard-synced waveforms added together, shaped by MORP +; Bipolar parameters: F2, F4. + +; ------------------------------------------------------------------------------------- +; waveshaping (default slot 2) +; ------------------------------------------------------------------------------------- +; A triangle wave through a waveshaper and a wavefolder. +; F2 TIMB how hard the wavefolder folds +; F3 MORP asymmetry of the waveform +; F4 HARM the waveshaper's curve +; AUX the same, through a different wavefolder curve +; Bipolar parameters: F4. + +; ------------------------------------------------------------------------------------- +; 2-op-FM (default slot 3) +; ------------------------------------------------------------------------------------- +; Two sine operators, one modulating the other's phase. +; F2 TIMB modulation index: how bright the tone is +; F3 MORP feedback: one operator modulating its own phase or the other's +; F4 HARM frequency ratio between the two operators +; AUX a sub-oscillator +; Bipolar parameters: F3. + +; ------------------------------------------------------------------------------------- +; grain-formant (default slot 4) +; ------------------------------------------------------------------------------------- +; Vocal-like formants made from windowed sine grains. +; F2 TIMB formant frequency +; F3 MORP formant width and shape +; F4 HARM frequency ratio between the two formants +; AUX filtered waveforms imitated with windowed sines +; Bipolar parameters: F4. + +; ------------------------------------------------------------------------------------- +; additive (default slot 5) +; ------------------------------------------------------------------------------------- +; A sum of harmonics whose levels follow one or more bumps in the spectrum. +; F2 TIMB which harmonic is loudest -- a little like a filter cutoff +; F3 MORP bump shape: flat and wide -> peaked and narrow +; F4 HARM how many bumps the spectrum has, starting from one +; AUX only the harmonics a drawbar organ has + +; ------------------------------------------------------------------------------------- +; wavetable (default slot 6) +; ------------------------------------------------------------------------------------- +; Banks of single-cycle waves laid out in a grid. +; F2 TIMB wavetable row: the waves are sorted dark to bright +; F3 MORP wavetable column: select shape families +; F4 HARM which bank (from the middle down, TIMB and MORP are interpolated) +; AUX a low-fi, 5-bit version + +; ------------------------------------------------------------------------------------- +; chords (default slot 7) +; ------------------------------------------------------------------------------------- +; Four-note chords played by a string-machine ensemble or a wavetable scan. +; F2 TIMB chord voicing - inversion and transposition +; F3 MORP waveform: string-machine sounds below the middle, wavetable above +; F4 HARM chord types: oct, 5, sus4, m, m7, m9, m11, 69, M9, M7, M +; AUX the chord's isolated root note + +; ------------------------------------------------------------------------------------- +; speech (default slot 8) +; ------------------------------------------------------------------------------------- +; A collection of speech synth algorithms: formant filters, SAM, LPC vowels and words. +; F2 TIMB size of the speaker, from Daleks to chipmunks (Émilie's wording lol) +; F3 MORP which vowel, phoneme or word segment +; F4 HARM the method: formants -> SAM -> LPC vowels, then banks of LPC words +; AUX the raw voice source, pre-filtering + +; ------------------------------------------------------------------------------------- +; swarm (default slot 9) +; ------------------------------------------------------------------------------------- +; Eight saw-like grains, each slightly detuned: a cloud of voices. +; F2 TIMB how many grains per second +; F3 MORP grain length and overlap; at the top they run into each other +; F4 HARM how far each grain's pitch wanders +; AUX the same cloud made of sine waves + +; ------------------------------------------------------------------------------------- +; filtered-noise (default slot 10) +; ------------------------------------------------------------------------------------- +; Clocked noise through a resonant filter. +; F2 TIMB the noise's clock rate +; F3 MORP filter resonance +; F4 HARM filter type: low-pass -> band-pass -> high-pass +; AUX two band-pass filters, as far apart as HARM sets +; Bipolar parameters: F4. + +; ------------------------------------------------------------------------------------- +; particle (default slot 11) +; ------------------------------------------------------------------------------------- +; Random impulses ringing through filters: rain, crackle, droplets. +; F2 TIMB how dense the particles are +; F3 MORP below centre: reverberating all-pass network, above it: resonant +; band-pass filters +; F4 HARM how random each particle's pitch is +; AUX the raw impulses (dust) +; Bipolar parameters: F3. + +; ------------------------------------------------------------------------------------- +; string (default slot 12) +; ------------------------------------------------------------------------------------- +; A plucked or bowed string, modelled physically. Two strings take turns, so a new note +; can ring while the last one fades. +; F2 TIMB how bright the excitation is (and how dense, while it drones) +; F3 MORP decay time +; F4 HARM inharmonicity: dispersive at the bottom, stiff at the top, and +; harmonic in a small zone about a quarter of the way up +; AUX the raw excitation + +; ------------------------------------------------------------------------------------- +; modal (default slot 13) +; ------------------------------------------------------------------------------------- +; A struck resonator: bells, bars, plates, membranes. +; F2 TIMB how bright the excitation is (and how dense, while it drones) +; F3 MORP decay time +; F4 HARM the material: how inharmonic the resonator is +; AUX the raw excitation + +; ------------------------------------------------------------------------------------- +; bass-drum (default slot 14) +; ------------------------------------------------------------------------------------- +; An analog-style kick. +; F2 TIMB brightness +; F3 MORP decay time +; F4 HARM how sharp the attack is, and how much overdrive +; AUX a different kick: a frequency-modulated triangle shaped into a sine + +; ------------------------------------------------------------------------------------- +; snare-drum (default slot 15) +; ------------------------------------------------------------------------------------- +; An analog-style snare: tuned drum modes and noise. +; F2 TIMB balance between the drum's modes +; F3 MORP decay time +; F4 HARM balance between the drum and the noise +; AUX a different snare: two frequency-modulated sines and high-passed noise + +; ------------------------------------------------------------------------------------- +; hi-hat (default slot 16) +; ------------------------------------------------------------------------------------- +; A metallic hi-hat: square oscillators ring-modulating each other, plus noise. +; F2 TIMB high-pass filter cutoff +; F3 MORP decay time +; F4 HARM balance between the metal and the noise +; AUX a different hi-hat: three pairs of ring-modulated squares, cleaner + +; ------------------------------------------------------------------------------------- +; VA-VCF (not in the default stack) +; ------------------------------------------------------------------------------------- +; A classic subtractive voice: an analog-style oscillator into a resonant filter. +; F2 TIMB filter cutoff +; F3 MORP waveform, and how much sub-oscillator +; F4 HARM resonance and character: a gentle 24 dB/oct filter below the middle, +; a harsh 12 dB/oct one above +; AUX the high-pass output +; Bipolar parameters: F3, F4. + +; ------------------------------------------------------------------------------------- +; phase-distortion (not in the default stack) +; ------------------------------------------------------------------------------------- +; A sine whose phase is bent by a second oscillator: Casio-style tones. +; F2 TIMB how much distortion +; F3 MORP how asymmetric the distortion is +; F4 HARM the distorting oscillator's frequency +; AUX the same with the carrier running free: phase modulation + +; ------------------------------------------------------------------------------------- +; wave-terrain (not in the default stack) +; ------------------------------------------------------------------------------------- +; A point circling over a 3D surface; the height under it is the sound. +; F2 TIMB the size of the circle +; F3 MORP where the circle sits on the surface +; F4 HARM which surface +; AUX the height used to bend the phase of a sine instead +; Bipolar parameters: F3. + +; ------------------------------------------------------------------------------------- +; string-machine (not in the default stack) +; ------------------------------------------------------------------------------------- +; A vintage string ensemble playing chords, through a chorus and a filter. +; F2 TIMB chorus and filter amount +; F3 MORP waveform +; F4 HARM chord +; AUX part of the chord (mostly the 2nd and 4th voices) +; Bipolar parameters: F2. + +; ------------------------------------------------------------------------------------- +; chiptune (not in the default stack) +; ------------------------------------------------------------------------------------- +; An 8-bit game console: pulse waves playing chords and arpeggios. +; F2 TIMB arpeggio pattern, or chord inversion +; F3 MORP pulse width, and sync +; F4 HARM chord +; AUX the console's triangle voice + +; ------------------------------------------------------------------------------------- +; 6-op-FM-A 6-op-FM-B 6-op-FM-C (not in the default stack) +; ------------------------------------------------------------------------------------- +; Three banks A, B and C, each containing 32 six-operator FM patches in the style of a DX7. +; F2 TIMB modulator levels +; F3 MORP stretches the envelopes and the modulation ("time travel") +; F4 HARM Bank patch selection +; AUX the same as OUT +; Bipolar parameters: F3. diff --git a/config/engines.csv b/config/engines.csv deleted file mode 100644 index adc3338..0000000 --- a/config/engines.csv +++ /dev/null @@ -1,25 +0,0 @@ -Slot,Glyph,Engine -1,●○○○,virtual analog -2,●●○○,waveshaping -3,●●●○,2-op FM -4,●●●●,grain / formant -5,○●●●,additive -6,○○●●,wavetable -7,○○○●,chords -8,○●○○,speech -9,○○●○,swarm -10,●○○●,filtered noise -11,○●●○,particle -12,●○●●,string -13,●●○●,modal -14,●○●○,bass drum -15,○●○●,snare drum -16,○○○○,hi-hat -17,◐◐◐◐,VA + VCF -18,○◐◐○,phase distortion -19,◐○○◐,wave terrain -20,○◐○◐,string machine -21,◐○◐○,chiptune -22,○◐◐◐, -23,○○○◐, -24,○◐○○, diff --git a/config/logs.cnfg b/config/logs.cnfg new file mode 100644 index 0000000..ed08895 --- /dev/null +++ b/config/logs.cnfg @@ -0,0 +1,38 @@ +; Format: ini +; ===================================================================================== +; Wakes — logging +; ===================================================================================== +; +; Wakes writes what it is doing to its drive, in WAKES/LOGS/: one file per session (from +; turning Wakes on until it is switched off), numbered -- 0001.LOGS, 0002.LOGS, ... after +; 9999.LOGS comes 0000.LOGS. The last 5 sessions are kept; WAKES/LOGS/SESSION holds the +; latest session's number. If you ask us for help, send them all. +; Each file stops at 8 MB, about 18 hours of playing. STANDBY (plugged in and off) is not +; logged. +; +; Wakes reads this file every time it turns ON, so a change takes effect at the next ON. +; Lines starting with ; are comments. Every setting can be left out to get its default. +; A setting Wakes cannot read keeps its default, and the log says which line it was. +; +; Startup, power, battery and error lines are always written; the settings below choose +; what else goes in. + +[logs] +; on = Wakes writes the log to its drive while ON (default). +; off = nothing is written to the drive. +enabled = on + +; CPU and audio load, every 5 seconds. +performance = on + +; What you do on the controls: pages, engines, routing, scales, ROTC. +controls = on + +; MIDI over USB, and the MIDI clock. +midi = on + +; USB audio out and the USB connection. +usb = on + +; The drive itself: loading and saving presets (PRST), the config files, the log. +storage = on diff --git a/config/midi.ini b/config/midi.ini index 5998845..16f5f37 100644 --- a/config/midi.ini +++ b/config/midi.ini @@ -190,7 +190,7 @@ lpg_decay = cc 25 level = cc 26 ; can connect LEVEL, as pushing the fader up does octave_range = cc 102 ; stepped: whole range modes ; Not on a fader at all: which engine plays, as an offset from the one T2/T3 selected, -; up through the filled slots of config/engines.csv (0 = the selected engine, 127 = the +; up through the filled slots of config/engines.cnfg (0 = the selected engine, 127 = the ; last slot). A change plays the engine flash, as T2/T3 do, and MIDI changes the engine at ; most every 50 ms -- each change costs the audio a moment, as a T2/T3 press does. model = cc 105 diff --git a/docs/DEFAULTS.md b/docs/DEFAULTS.md index 74516f8..ed6f4d2 100644 --- a/docs/DEFAULTS.md +++ b/docs/DEFAULTS.md @@ -33,11 +33,12 @@ than a description; it is now both.) | | parameter | range | boot | ROTC | notes | |---|---|---|---|---|---| | F1 | FREQUENCY | per OCTAVE range | **the fader's position** | fader set to 0.5, or C4, frequency unlocked (see SETTINGS F1 on ROTC) | Seeded from the physical fader on the first ON after boot only | -| F2 | TIMBRE | 0…1 | the fader's position | slot 1's neutral position (contextual to the engine) | meaning is per engine | -| F3 | MORPH | 0…1 | the fader's position | slot 1's neutral position (contextual to the engine) | meaning is per engine | -| F4 | HARMONICS | 0…1 | the fader's position | slot 1's neutral position (contextual to the engine) | meaning is per engine | +| F2 | TIMBRE | 0…1 | the fader's position | the neutral position of the first filled slot's engine | meaning is per engine | +| F3 | MORPH | 0…1 | the fader's position | the neutral position of the first filled slot's engine | meaning is per engine | +| F4 | HARMONICS | 0…1 | the fader's position | the neutral position of the first filled slot's engine | meaning is per engine | -**ROTC is a full patch reset, not a modulation reset.** It returns the engine to slot 1 and the +**ROTC is a full patch reset, not a modulation reset.** It returns the engine to the first +filled slot of the engine stack (#52: of your `engines.cnfg`, slot 1 by default) and the four BASE faders to that engine's neutral state: **0.5 for a bipolar parameter, 0 for a unipolar one**, and F1 to the middle of its travel with the range open and the quantizer off. @@ -48,7 +49,7 @@ detent means it is a real landing spot rather than a coincidence of fader positi **Which parameters are bipolar is already known per engine**, so nothing new has to be decided: each engine's detents (listed in `docs/PLAITS-ENGINES.md`) mark exactly the parameters whose centre is a neutral point, and they are compiled into `SP1_ENGINE_TABLE[].centre`. On virtual -analog, slot 1 by default, that gives F2 → 0.5, F3 → 0, F4 → 0.5. +analog, the first filled slot by default, that gives F2 → 0.5, F3 → 0, F4 → 0.5. ⚠️ **REVIEW 1 — the faders will not match after a ROTC, by design.** ROTC sets the stored values; the physical faders stay where your hands left them. Pickup then catches each one up on its next @@ -57,7 +58,7 @@ after a ROTC the instrument sounds neutral while the faders still look wrong. Th is the only way to do it without motorised faders. Confirmed as intended (Adara). ⚠️ **REVIEW 2 — neutral is per engine, and ROTC is a moment in time.** Because ROTC also returns -you to slot 1, "the engine's neutral state" is unambiguous at the moment it fires. But if you then +you to the first filled slot, "the engine's neutral state" is unambiguous at the moment it fires. But if you then step to an engine with a different bipolar set, the values stay where ROTC put them and are no longer that engine's neutral. The alternative — re-neutralising on every engine change — would mean losing your patch just by browsing engines, which is clearly worse. Leaving it as a @@ -87,7 +88,7 @@ Never seeded from the faders, at boot or ever. Gain 0 means nothing modulates un | parameter | range | boot | ON | ROTC | notes | |---|---|---|---|---|---| -| engine | 24 slots, 21 filled by default | slot 1 | — | slot 1 | the first filled slot of `config/engines.csv` | +| engine | 24 slots, 16 filled by default | the first filled slot | — | the first filled slot | of the stack in `WAKES/CNFG/engines.cnfg` on the drive, or the built-in `config/engines.cnfg` | | FREQUENCY quantization | off + 7 scales | off | — | off | forced off when something is routed to V/Oct | | output select | OUT / AUX / OUT+AUX / OUT×AUX | OUT | OUT | OUT | RAM only | | soft-clip drive | off, +3 / +8 / +15 / +24 dB | off | off | off | forced off on every entry to ON (this will change when ON is set to reload savestates in M5). Uneven steps since M4e; `••`+VOL− steps DOWN rather than toggling | diff --git a/docs/MARBLES-SETTINGS.md b/docs/MARBLES-SETTINGS.md index e16129a..060e1ed 100644 --- a/docs/MARBLES-SETTINGS.md +++ b/docs/MARBLES-SETTINGS.md @@ -4,10 +4,10 @@ The Marbles-side companion to `docs/PLAITS-ENGINES.md`: everything that is a *ch than a fader, what each choice does, the LED glyph that flashes when you change it, and whether it is included in the firmware. -⚠️ **This file is NOT read by the build**, unlike `config/engines.csv` for Plaits. The tables below are the +⚠️ **This file is NOT read by the build**, unlike `config/engines.cnfg` for Plaits. The tables below are the authority for what the firmware *should* do; `firmware/src/sp1_marbles_ui.c` holds the same glyphs and inclusion flags in C. If a third consumer ever appears, generate them from here the -way `tools/gen_engines.py` generates the engine list from `config/engines.csv` — until then, changing a glyph or an +way `tools/gen_engines.py` generates the engine list from `config/engines.cnfg` — until then, changing a glyph or an inclusion flag means changing both. ## LED glyphs diff --git a/docs/MIDI.md b/docs/MIDI.md index 5ebed7e..f31e5d3 100644 --- a/docs/MIDI.md +++ b/docs/MIDI.md @@ -168,7 +168,7 @@ half still works. | 25 | 57 | LPG decay | | 26 | 58 | LEVEL (PLAITS SETTINGS F4 — can connect it, like the fader) | | 102 | | OCTAVE range | -| 105 | | MODEL: the engine, as an offset up through your filled slots in `config/engines.csv` | +| 105 | | MODEL: the engine, as an offset up through your filled slots in `config/engines.cnfg` | | 27 | 59 | RATE | | 16 | 48 | t BIAS | | 85 | | JITTER | diff --git a/docs/PLAITS-ENGINES.md b/docs/PLAITS-ENGINES.md index eb4756f..fcf9976 100644 --- a/docs/PLAITS-ENGINES.md +++ b/docs/PLAITS-ENGINES.md @@ -1,33 +1,50 @@ # Plaits engines — choosing them, glyphs, detents -**Which engine sits in which slot is set in [`config/engines.csv`](../config/engines.csv)**, not in -this document. The build reads that file every time. This page is reference: what each engine is, -what it costs, and what each fader does on it. +**Which engine sits in which slot is set in [`config/engines.cnfg`](../config/engines.cnfg)**, not +in this document. The build reads that file every time, and it also describes every engine and +what its faders do. This page is reference: what each engine is, what it costs, and why the +detents are where they are. + +## Choosing engines: `config/engines.cnfg` + +An ini file (#52): one line per slot under `[engines]`, `slot = engine`, slots 1–24. T2/T3 step +through the slots in order and skip empty ones. The device starts on the first filled slot, and +"rip out the cables" returns there. + +```ini +[engines] +1 = virtual-analog ; ●○○○ +2 = waveshaping ; ●●○○ +... +17 = ; ◐◐◐◐ +``` + +- **The file is the whole stack.** A slot with no name, `none`, or no line at all is empty. +- **To remove an engine**, clear its name. **To add one**, write its name after an empty slot's + `=`. **To reorder**, move names between slots — not whole lines: each slot keeps its glyph. +- Names are written as in the file's engine list, with hyphens instead of spaces (`virtual-analog`, + `grain-formant`, `VA-VCF`); case doesn't matter. Each engine can appear once. +- The glyph after the `;` is a comment showing the slot's glyph. The build checks it, so a line + moved together with its glyph is caught. +- Engine names match on their letters and digits, case ignored: `grain-formant`, `grain / formant` + and `Grain Formant` are one engine (so PRST files saved under an older spelling still load). + `python tools/gen_engines.py --list` prints every engine name the file may use. -## Choosing engines: `config/engines.csv` - -The file has one row per slot, 24 at most, in slot order. T2/T3 step through the slots in that -order. The device starts on the first slot that has an engine, and "rip out the cables" returns -there. - -| column | what it is | can you change it? | -|---|---|---| -| **Slot** | the slot number. It's the row's position, printed so the file reads like the device. | No | -| **Glyph** | the four-LED pattern flashed when the slot is selected, T1 first. It belongs to the slot, not to the engine in it. | No | -| **Engine** | the engine in that slot, named exactly as under "Available engines" below (upper/lower case doesn't matter). **Leave it empty** for an empty slot, which T2/T3 skip. | **Yes** | - -- **To remove an engine**, clear its Engine cell. The slot stays and is skipped. -- **To add one**, type its name into an empty slot's Engine cell. -- **To reorder**, move the engine names between rows. Don't move whole rows: the Slot and Glyph - columns have to stay where they are. +Leaving an engine out removes it from engine select. It does **not** make the firmware smaller: +Plaits' voice object contains every engine regardless, and a PRST preset that names an engine not +in the stack still plays it (its flash is all four LEDs fading down instead of a glyph). -Each engine can appear once. Open the file in a spreadsheet or a text editor; GitHub shows it as -a table. If the file is wrong, for example a glyph edited or a whole row moved, the build stops -with a message naming the line and saying what's expected there. -`python tools/gen_engines.py --list` prints every engine name the file may use. +**Two copies, two kinds of check** (#52): -Leaving an engine out removes it from engine select. It does **not** make the firmware smaller: -Plaits' voice object contains every engine regardless. +- **On the drive, `WAKES/CNFG/engines.cnfg`** — the one users edit. Wakes reads it at every ON, + before the PRST slots. A stack is all or nothing: if the file is missing, unreadable, or has + any problem — a name that is not an engine, an engine twice, a slot outside 1–24 or set twice, + another section, no engine at all — Wakes plays the **built-in stack** and the log names every + problem line (`CNFG engines.cnfg line N: …`). ROTC and the start go to the first filled slot of + whichever stack is in use. `wakes-sp1-fresh` writes the file there. +- **In the repository, `config/engines.cnfg`** — the built-in stack every image carries, and the + file fresh writes. The build checks it and stops on any problem, naming the line, so a broken + default can never ship. ### Glyphs @@ -40,50 +57,47 @@ recognisable, not counted in binary: full brightness for slots 1–16, half brig | `◐` | `+` | half brightness (`SP1_ENGINE_LED_HALF` in `firmware/src/sp1_ui_timing.h`) | | `○` | `.` | off | -Save the file as UTF-8. If a spreadsheet or editor turns the circles into `?` or garbage, the -build will say so; write the glyphs in their ASCII forms instead (`#..#` is the same glyph as -`●○○●`). - Slot 16's glyph is `○○○○` (all off); its flash shows as a brief dark blink. ### What you can't change here Each slot's **glyph**, and each engine's **index inside Plaits** and **centre detents**, are fixed, -so the CSV can't change them. They live in `SLOT_GLYPHS` and `PLAITS_ENGINES` in +so the file can't change them. They live in `SLOT_GLYPHS` and `PLAITS_ENGINES` in `tools/gen_engines.py`. The reasons for each detent are under "Why these detents" below. ## Available engines -The default `config/engines.csv` has the 16 original Plaits models first, in their panel order, -then five of the 8 models added in Plaits 1.2. Slots 22–24 are empty: the three **6-op FM** banks -are left out (a community DX7 firmware covers them), but any of them can go in an empty slot. +The default stack is the 16 original Plaits models, in their panel order, in slots 1–16 (Adara, +#52). Slots 17–24, the half-lit glyphs, are empty for you to fill: the five models added in +Plaits 1.2 (VA-VCF, phase-distortion, wave-terrain, string-machine, chiptune) and the three +**6-op FM** banks (6-op-FM-A, -B, -C) are out of the default stack, but any of them can go in an empty slot. | Default slot | Engine | Plaits # | Detents | CPU (avg; M3b–M3f logs) | |---|---|---|---|---| -| 1 | virtual analog | 8 | F2 F4 | 67.8 % | +| 1 | virtual-analog | 8 | F2 F4 | 67.8 % | | 2 | waveshaping | 9 | F4 | 52.2 % (61 % peak) | -| 3 | 2-op FM | 10 | F3 | 70.5 % (76 % peak) | -| 4 | grain / formant | 11 | F4 | 75.7 % | +| 3 | 2-op-FM | 10 | F3 | 70.5 % (76 % peak) | +| 4 | grain-formant | 11 | F4 | 75.7 % | | 5 | additive | 12 | - | M3f: 54.8 % (64 % peak); M4a: est. ~61 % / ~71 % | | 6 | wavetable | 13 | - | 63.4 % | | 7 | chords | 14 | - | 76.6 % | | 8 | speech | 15 | - | 27–39 % (varies with MORPH/HARMONICS) | | 9 | swarm | 16 | - | 73.9 % | -| 10 | filtered noise | 17 | F4 | 64.7 % | +| 10 | filtered-noise | 17 | F4 | 64.7 % | | 11 | particle | 18 | F3 | 86.5 % at 6; M3f (3): 49–51 % avg, 83–100 % peaks below MORPH centre; M4: 2 particles | | 12 | string | 19 | - | 68.9 % (74 % peak) at 2 strings (M3f) | | 13 | modal | 20 | - | 49.1 % (54 % peak) at 8 modes (M3f); M3g: 12, est. ~65 % | -| 14 | bass drum | 21 | - | 67.1 % | -| 15 | snare drum | 22 | - | 68.3 % | +| 14 | bass-drum | 21 | - | 67.1 % | +| 15 | snare-drum | 22 | - | 68.3 % | | 16 | hi-hat | 23 | - | 71.4 % | -| 17 | VA + VCF | 0 | F3 F4 | 66.4 % | -| 18 | phase distortion | 1 | - | 72.1 % | -| 19 | wave terrain | 5 | F3 | 62.6 % (one window) | -| 20 | string machine | 6 | F2 | 84.4 % (~98 % peak); M3g/M4: est. ~61 % at TIMBRE centre, ~76 % with the 2-tap chorus | -| 21 | chiptune | 7 | - | 27.7 % (one window) | -| — | 6-op FM A | 2 | F3 | ~78 % (one window) | -| — | 6-op FM B | 3 | F3 | not measured | -| — | 6-op FM C | 4 | F3 | not measured | +| — | VA-VCF | 0 | F3 F4 | 66.4 % | +| — | phase-distortion | 1 | - | 72.1 % | +| — | wave-terrain | 5 | F3 | 62.6 % (one window) | +| — | string-machine | 6 | F2 | 84.4 % (~98 % peak); M3g/M4: est. ~61 % at TIMBRE centre, ~76 % with the 2-tap chorus | +| — | chiptune | 7 | - | 27.7 % (one window) | +| — | 6-op-FM-A | 2 | F3 | ~78 % (one window) | +| — | 6-op-FM-B | 3 | F3 | not measured | +| — | 6-op-FM-C | 4 | F3 | not measured | The Plaits # and Detents columns are copied from `tools/gen_engines.py` for reference; that file, not this table, is what the build uses. @@ -104,18 +118,18 @@ rather than with Plaits alone. | Plaits # | slot | engine | avg % (M4a–M4d hardware) | column above | |---|---|---|---|---| -| 5 | 19 | wave terrain | **82.3** | 62.6 % "one window" | -| 7 | 21 | chiptune | 73.7 | 27.7 % "one window" | -| 8 | 1 | virtual analog | 56.5 | 67.8 % | +| 5 | — | wave-terrain | **82.3** | 62.6 % "one window" | +| 7 | — | chiptune | 73.7 | 27.7 % "one window" | +| 8 | 1 | virtual-analog | 56.5 | 67.8 % | | 9 | 2 | waveshaping | 55.9 | 52.2 % | | 12 | 5 | additive | 67.4 | M4a est. ~61 % | | 13 | 6 | wavetable | 73.9 | 63.4 % | | 16 | 9 | swarm | **79.5** | 73.9 % | -| 17 | 10 | filtered noise | 66.1 | 64.7 % | +| 17 | 10 | filtered-noise | 66.1 | 64.7 % | | 18 | 11 | particle | 47.6 | M3f (3 particles) 49–51 %; this build has 2 | | 19 | 12 | string | 71.3 | 68.9 % at 2 strings | | 20 | 13 | modal | 73.0 | M3g est. ~65 % at 12 modes | -| 21 | 14 | bass drum | 75.3 | 67.1 % | +| 21 | 14 | bass-drum | 75.3 | 67.1 % | | 23 | 16 | hi-hat | 77.0 | 71.4 % | **Everything fits.** The heaviest is wave terrain at 82.3 %, and an hour of playing produced no @@ -146,28 +160,28 @@ its range set by SETTINGS F1. Only F2–F4 change meaning with the engine. | Default slot | Engine | F2 TIMBRE | F3 MORPH | F4 HARMONICS | AUX (SETTINGS T4) | |---|---|---|---|---|---| -| 1 | virtual analog | variable square, from narrow pulse to full square to hardsync formants | variable saw, from triangle to saw with an increasingly wide notch | detuning between the two waves | sum of two hardsync'ed waveforms, shaped by MORPH | +| 1 | virtual-analog | variable square, from narrow pulse to full square to hardsync formants | variable saw, from triangle to saw with an increasingly wide notch | detuning between the two waves | sum of two hardsync'ed waveforms, shaped by MORPH | | 2 | waveshaping | wavefolder amount | waveform asymmetry | waveshaper waveform | the same, with Warps' other wavefolder curve | -| 3 | 2-op FM | modulation index | feedback — operator 2 modulating its own phase, or operator 1's | frequency ratio | sub-oscillator | -| 4 | grain / formant | formant frequency | formant width and shape (the window's shape) | frequency ratio between formant 1 and 2 | filtered waveforms simulated by windowed sine waves | +| 3 | 2-op-FM | modulation index | feedback — operator 2 modulating its own phase, or operator 1's | frequency ratio | sub-oscillator | +| 4 | grain-formant | formant frequency | formant width and shape (the window's shape) | frequency ratio between formant 1 and 2 | filtered waveforms simulated by windowed sine waves | | 5 | additive | index of the most prominent harmonic — a bit like a cutoff frequency | bump shape, from flat and wide to peaked and narrow | number of bumps in the spectrum, starting with one big bump | only the harmonics a Hammond organ's drawbars have | | 6 | wavetable | row index — waves sorted by spectral brightness | column index | active bank | low-fi (5-bit) output | | 7 | chords | chord inversion and transposition | waveform: string-machine waveforms below the centre, a wavetable scan above | chord type | the chord's root note | | 8 | speech | species, from Daleks to chipmunks | phoneme or word-segment selection | crossfades formant filtering → SAM → LPC vowels, then banks of LPC words | the unfiltered vocal cords' signal | | 9 | swarm | grain density | grain duration and overlap; at the top the grains merge into each other | amount of pitch randomisation | the same, with sine-wave oscillators | -| 10 | filtered noise | clock frequency | filter resonance | filter response, LP → BP → HP | two band-pass filters, separation set by HARMONICS | +| 10 | filtered-noise | clock frequency | filter resonance | filter response, LP → BP → HP | two band-pass filters, separation set by HARMONICS | | 11 | particle | particle density | filter type: a reverberating all-pass network below the centre, resonant band-pass filters above | amount of frequency randomisation | raw dust noise | | 12 | string | excitation brightness, and the dust density while it drones | decay time (energy absorption) | inharmonicity: dispersive below ~25 % of travel, stiff above, harmonic in the small dead band between | the raw exciter signal | | 13 | modal | excitation brightness and dust density | decay time (energy absorption) | amount of inharmonicity, or material | the raw exciter signal | -| 14 | bass drum | brightness | decay time | attack sharpness and amount of overdrive | a frequency-modulated triangle VCO turned into a sine by diodes | -| 15 | snare drum | balance between the drum's modes | decay time | balance of the harmonic and noisy components | two frequency-modulated sine VCOs mixed with high-passed noise | +| 14 | bass-drum | brightness | decay time | attack sharpness and amount of overdrive | a frequency-modulated triangle VCO turned into a sine by diodes | +| 15 | snare-drum | balance between the drum's modes | decay time | balance of the harmonic and noisy components | two frequency-modulated sine VCOs mixed with high-passed noise | | 16 | hi-hat | high-pass filter cutoff | decay time | balance of the metallic and the filtered noise | three pairs of square oscillators ring-modulating each other, through a clean linear VCA | -| 17 | VA + VCF | filter cutoff | waveform and sub level | resonance and filter character — gentle 24 dB/oct below the centre, harsh 12 dB/oct above | the 12 dB/oct high-pass output | -| 18 | phase distortion | distortion amount | distortion asymmetry | distortion frequency | the carrier runs free, making it phase modulation | -| 19 | wave terrain | path radius | path offset | terrain | the terrain's height read as phase distortion, sin(y+z) | -| 20 | string machine | chorus / filter amount | waveform | chord | voices 2 and 4, mostly | -| 21 | chiptune | arpeggio type, or chord inversion | pulse width / sync | chord | the NES triangle voice | -| — | 6-op FM A/B/C | modulator level(s) | envelope and modulation stretching ("time travel") | preset selection, within this bank | the same signal as OUT | +| — | VA-VCF | filter cutoff | waveform and sub level | resonance and filter character — gentle 24 dB/oct below the centre, harsh 12 dB/oct above | the 12 dB/oct high-pass output | +| — | phase-distortion | distortion amount | distortion asymmetry | distortion frequency | the carrier runs free, making it phase modulation | +| — | wave-terrain | path radius | path offset | terrain | the terrain's height read as phase distortion, sin(y+z) | +| — | string-machine | chorus / filter amount | waveform | chord | voices 2 and 4, mostly | +| — | chiptune | arpeggio type, or chord inversion | pulse width / sync | chord | the NES triangle voice | +| — | 6-op-FM-A/B/C | modulator level(s) | envelope and modulation stretching ("time travel") | preset selection, within this bank | the same signal as OUT | Sources: the Plaits manual's model table for F2–F4 and AUX, and the firmware 1.2 release notes for the 1.2 models (VA + VCF onwards, and 6-op FM). **String is the one the manual never documented** — its row is read @@ -176,7 +190,7 @@ argument (non-linearity is `(s−0.24)·4.166` below 0.24, `(s−0.26)·1.35` ab between), TIMBRE is `brightness` squared, and MORPH is `damping`. The 6-op FM banks' AUX is `aux[i] = out[i]` in `six_op_engine.cc`, i.e. the two outputs carry the same thing. -The rows follow the default slot order. Your own `config/engines.csv` may order them +The rows follow the default slot order. Your own `config/engines.cnfg` may order them differently; the per-engine descriptions don't change. ## Why these detents @@ -190,15 +204,15 @@ itself changes: | engine | detent | centre means (source) | |---|---|---| -| VA + VCF | F4, F3 | F4: resonance = max(\|h−.5\|−.125, 0), so the centre is zero resonance (24 dB/oct below, 12 dB/oct above). F3: the centre is a plain square with no sub-oscillator. | +| VA-VCF | F4, F3 | F4: resonance = max(\|h−.5\|−.125, 0), so the centre is zero resonance (24 dB/oct below, 12 dB/oct above). F3: the centre is a plain square with no sub-oscillator. | | 6-op FM ×3 | F3 | envelope time × 2^((.5−m)·8): the centre is the patch's own envelopes. | -| wave terrain | F3 | path offset 1.9m−1: the centre is (almost exactly) a centred path. | -| string machine | F2 | ensemble amount \|t−.5\|·2: the centre is dry, with filter on one side and chorus on the other. | -| virtual analog | F4, F2 | F4: detune 2.05h−1.025, so the centre is unison. F2: square wave, no sync ("narrow pulse … full square … hardsync"). | +| wave-terrain | F3 | path offset 1.9m−1: the centre is (almost exactly) a centred path. | +| string-machine | F2 | ensemble amount \|t−.5\|·2: the centre is dry, with filter on one side and chorus on the other. | +| virtual-analog | F4, F2 | F4: detune 2.05h−1.025, so the centre is unison. F2: square wave, no sync ("narrow pulse … full square … hardsync"). | | waveshaping | F4 | shape amount \|h−.5\|·2: the centre is no waveshaping. | -| 2-op FM | F3 | feedback 2m−1: the centre is no feedback ("before 12 o'clock, chaotic! past 12 o'clock, rough!"). | -| grain / formant | F4 | formant ratio −24+48h semitones: the centre is 1:1. | -| filtered noise | F4 | the 2nd filter sits at the same pitch as the 1st; response goes LP → BP (centre) → HP. | +| 2-op-FM | F3 | feedback 2m−1: the centre is no feedback ("before 12 o'clock, chaotic! past 12 o'clock, rough!"). | +| grain-formant | F4 | formant ratio −24+48h semitones: the centre is 1:1. | +| filtered-noise | F4 | the 2nd filter sits at the same pitch as the 1st; response goes LP → BP (centre) → HP. | | particle | F3 | all-pass network below the centre, resonant band-pass above; the centre is neither. | ⚠️ **The detents are also the unipolar/bipolar table.** A detent marks a parameter whose centre is diff --git a/docs/SAFETY.md b/docs/SAFETY.md index 1cbe660..11eb25a 100644 --- a/docs/SAFETY.md +++ b/docs/SAFETY.md @@ -47,6 +47,13 @@ battery overnight, and a powered amp with no clock can murmur audibly. **8. Clear every LED before `SYSTEM_OFF`.** It freezes GPIO levels; anything still lit stays lit into sleep. +**9. Nothing the user can configure reaches the power path.** The config files on the +drive (`WAKES/CNFG/*.cnfg`, issue #52) are read at every ON and a user can put anything in +them. They never name power-off or its timings, the watchdog, the flash layout, or the USB +descriptors, and none of those is ever read from the drive. A bad line keeps its built-in +default; a file that crashes the device at ON can be deleted from a computer in STANDBY, +because drive mode never reads `CNFG/`. + Rules 1–5 and 7 are the "BIG FIVE" as established by the author of `chattock/sp1-tape-looper` on real hardware. We did not discover them; we are inheriting them, and they were expensive to find. diff --git a/docs/UI-PAGES.md b/docs/UI-PAGES.md index c3083a9..413ee03 100644 --- a/docs/UI-PAGES.md +++ b/docs/UI-PAGES.md @@ -126,7 +126,7 @@ So the combination space is exactly: **`••` + one button**, on either ladder ⚠️ So FFWD now **re-triggers** the note Marbles is holding rather than making the sequence advance faster: a roll, not an arpeggio. Driving the clock at a subdivision instead is a separate option, parked for a community vote (Adara). -- **Engines off the list** (#50): every build contains all of Plaits' engines; `config/engines.csv` +- **Engines off the list** (#50): every build contains all of Plaits' engines; `config/engines.cnfg` only decides which ones T2/T3 reach. A PRST slot may name one that is not listed, and it plays. It has no glyph of its own, so its engine flash is all four face LEDs ramping 70 % → 0 at 15.6 Hz for 0.7 s. From it, **T3 → the first listed engine, T2 → the last**; MIDI's MODEL CC counts from @@ -452,7 +452,7 @@ T2/T3 (`[F]` / `[G]`). | **Both outputs at once** | Plaits renders OUT and AUX every block and we pick one (or a mix) for a single mono speaker. SETTINGS T4's four modes are the whole of what one output can be. A second physical output is not available. | | **User data** | wavetables and DX7 patches loaded through the ear-jack. `plaits/user_data.h` is **shimmed away** because upstream's reads STM32 flash at an address that does not exist on this chip. | | **FINE TUNE** | exposed until M4a, removed: it only ever acted in octave-range mode 9, and mode 9 is the mode that quantizes F1 to whole octaves. | -| **6-op FM ×3** | compiled but left out of the default `config/engines.csv` (slots 22–24 are empty); a community DX7 firmware covers it. Type a name into an empty slot to get one. | +| **6-op FM ×3** | compiled but left out of the default `config/engines.cnfg` (slots 17–24 are empty); a community DX7 firmware covers it. Type a name into an empty slot to get one. | ### Marbles features not exposed diff --git a/firmware/CMakeLists.txt b/firmware/CMakeLists.txt index becb3c3..19d6257 100644 --- a/firmware/CMakeLists.txt +++ b/firmware/CMakeLists.txt @@ -16,18 +16,19 @@ project(wakes-sp1) # The USB device is ours since M5a (src/sp1_usbd.c, CONFIG_SP1_USB_* in Kconfig): Zephyr's # sample helper, included here through M4e, hard-codes Zephyr's test vendor ID. -# ---- the engine list: generated from config/engines.csv ---- -# The CSV is the USER's choice of engines, slots and glyphs; the facts about each engine -# (its index inside Plaits, its centre detents) live in tools/gen_engines.py and are not -# user-editable. The build fails with a message naming the line if the CSV is malformed. -set(SP1_ENGINES_CSV ${CMAKE_CURRENT_SOURCE_DIR}/../config/engines.csv) +# ---- the engine list: generated from config/engines.cnfg ---- +# The DEFAULT engine stack (ini, #52): which engine sits in which slot. Each slot's glyph and +# the facts about each engine (its index inside Plaits, its centre detents) live in +# tools/gen_engines.py and are not user-editable. The build fails, naming the line, if the +# file is wrong. +set(SP1_ENGINES_CNFG ${CMAKE_CURRENT_SOURCE_DIR}/../config/engines.cnfg) set(SP1_ENGINES_GEN ${CMAKE_CURRENT_SOURCE_DIR}/../tools/gen_engines.py) set(SP1_ENGINES_H ${CMAKE_CURRENT_BINARY_DIR}/sp1_generated/sp1_engines_gen.h) add_custom_command( OUTPUT ${SP1_ENGINES_H} - COMMAND ${Python3_EXECUTABLE} ${SP1_ENGINES_GEN} ${SP1_ENGINES_CSV} ${SP1_ENGINES_H} - DEPENDS ${SP1_ENGINES_CSV} ${SP1_ENGINES_GEN} - COMMENT "Generating the engine table from config/engines.csv" + COMMAND ${Python3_EXECUTABLE} ${SP1_ENGINES_GEN} ${SP1_ENGINES_CNFG} ${SP1_ENGINES_H} + DEPENDS ${SP1_ENGINES_CNFG} ${SP1_ENGINES_GEN} + COMMENT "Generating the engine table from config/engines.cnfg" ) add_custom_target(sp1_engines_gen DEPENDS ${SP1_ENGINES_H}) add_dependencies(app sp1_engines_gen) @@ -72,6 +73,21 @@ add_custom_command( add_custom_target(sp1_audio_gen DEPENDS ${SP1_AUDIO_H}) add_dependencies(app sp1_audio_gen) +# ---- the logging defaults: config/logs.cnfg -> sp1_logs_gen.h (#52) ---- +# The built-in defaults the drive's WAKES/CNFG/logs.cnfg overrides, and the file's text for +# wakes-sp1-fresh to write there. A bad default fails the build, naming the line. +set(SP1_LOGS_CNFG ${CMAKE_CURRENT_SOURCE_DIR}/../config/logs.cnfg) +set(SP1_LOGS_GEN ${CMAKE_CURRENT_SOURCE_DIR}/../tools/gen_logs.py) +set(SP1_LOGS_H ${CMAKE_CURRENT_BINARY_DIR}/sp1_generated/sp1_logs_gen.h) +add_custom_command( + OUTPUT ${SP1_LOGS_H} + COMMAND ${Python3_EXECUTABLE} ${SP1_LOGS_GEN} ${SP1_LOGS_CNFG} ${SP1_LOGS_H} + DEPENDS ${SP1_LOGS_CNFG} ${SP1_LOGS_GEN} + COMMENT "Generating the logging defaults from config/logs.cnfg" +) +add_custom_target(sp1_logs_gen DEPENDS ${SP1_LOGS_H}) +add_dependencies(app sp1_logs_gen) + # ---- PRST (M6, #50): the slot file's field table, from tools/gen_prst.py ---- # No user input: the field list lives in the script. It also holds the format versions, and # FAILS the build if the field list changed without a new version (Adara, #50). @@ -94,6 +110,7 @@ target_sources(app PRIVATE src/sp1_standby.c src/sp1_console.c src/sp1_logbuf.c + src/sp1_logring.c src/sp1_threads.c src/sp1_usbd.c src/sp1_controls.c @@ -107,7 +124,7 @@ target_sources(app PRIVATE # ---- M6 (#43): the eMMC and the FAT volume on it (src/sp1_store.h) ---- if(CONFIG_SP1_STORAGE) - target_sources(app PRIVATE src/sp1_emmc.c src/sp1_store.c) + target_sources(app PRIVATE src/sp1_emmc.c src/sp1_store.c src/sp1_cnfg.c) target_sources_ifdef(CONFIG_SP1_STORAGE_TEST app PRIVATE src/sp1_emmc_report.c) # ff.h, for FATFS and MKFS_PARM (Zephyr's fatfs module, ELMFAT interface). target_link_libraries(app PRIVATE ELMFAT) diff --git a/firmware/Kconfig b/firmware/Kconfig index 40abf54..7bdd487 100644 --- a/firmware/Kconfig +++ b/firmware/Kconfig @@ -182,12 +182,16 @@ config FS_FATFS_CUSTOM_MOUNT_POINTS config SP1_LOGBUF_KB int "Stored log, in KB of RAM" + default 16 if SP1_STORAGE default 96 range 4 160 help Everything printk writes is also kept in RAM, newest last, and played back when a terminal next opens the console -- so a session with the USB port in another host's - hands (the OP-XY) is not lost (src/sp1_logbuf.h). 96 KB is ~14 minutes of a session. + hands (the OP-XY) is not lost (src/sp1_logbuf.h). Since #52 the session also goes to + WAKES/LOGS/ on the drive every 5 s, so this only has to cover the gap between flushes + and the boot before the first ON: 16 KB, ~2 minutes of a session (96 KB before, and + still in an image without storage -- the fallback -- where RAM is all there is). config SP1_USB_THREADS_BELOW_AUDIO bool "Run Zephyr's USB threads below the audio thread (#32)" diff --git a/firmware/src/main.c b/firmware/src/main.c index cdb3ae4..28f57e2 100644 --- a/firmware/src/main.c +++ b/firmware/src/main.c @@ -310,7 +310,7 @@ static void prst_glyph_levels(int slot, uint32_t t, uint8_t lv[4]) /* ---- the engine flash, for an engine on the list or off it (#50) ---- * On the list: its fixed glyph through sp1_display_engine(), as always. Off the list (a PRST - * slot loaded an engine engines.csv does not list): no glyph exists, so all four face LEDs + * slot loaded an engine engines.cnfg does not list): no glyph exists, so all four face LEDs * ramp 70 % -> 0 every SP1_OFFLIST_RAMP_MS for SP1_DISP_ENGINE_HOLD_MS, then the same fade * (Adara). Redrawn every tick by offlist_glyph_tick(); anything else that flashes the row * stops it (sp1_display_flash_count). Use this wherever the ENGINE glyph is shown. */ @@ -1178,33 +1178,50 @@ static void prst_gather(struct sp1_prst *p) * Adara: "the shutdown animation completes -> the UI freezes -> save -> OFF or STANDBY", * with the UI locked and the LEDs off, limit 4 s. The UI is frozen because main is in here; * audio stops first (sp1_quiesce_peripherals() would stop it a moment later anyway), so the - * storage thread has the CPU. Never called by the 30 s backstop (sp1_power.h). */ -static void prst_save_at_shutdown(void) + * storage thread has the CPU. Never called by the 30 s backstop (sp1_power.h). + * #52: then the log's last lines, in what is left of the same 4 s (Adara: the save first). */ +static void storage_at_shutdown(void) { - if (!g_prst_on) { + const bool log = sp1_store_log_live(); + if (!g_prst_on && !log) { return; } - g_prst_on = false; sp1_leds_all_off(); sp1_audio_stop(); - struct sp1_prst p; - prst_gather(&p); const uint32_t t0 = k_uptime_get_32(); - if (!sp1_store_prst_save(g_prst_slot, &p)) { - printk("PRST save: not possible (storage not ready) -- nothing saved\n"); - return; + if (!g_prst_on) { + sp1_store_log_end(); + } else { + g_prst_on = false; + struct sp1_prst p; + prst_gather(&p); + if (!sp1_store_prst_save(g_prst_slot, &p)) { + printk("PRST save: not possible (storage not ready) -- nothing saved\n"); + sp1_store_log_end(); + } else { + while (sp1_store_save_result() == SP1_STORE_SAVE_BUSY && + k_uptime_get_32() - t0 < SP1_PRST_SAVE_MS) { + sp1_wdt_feed(); + k_msleep(TICK_MS); + } + const enum sp1_store_save r = sp1_store_save_result(); + printk("PRST save slot %d: %s after %u ms\n", g_prst_slot + 1, + r == SP1_STORE_SAVE_OK ? "saved" : (r == SP1_STORE_SAVE_BUSY + ? "NOT finished in time -- powering off anyway" + : "FAILED"), + (unsigned)(k_uptime_get_32() - t0)); + } } - while (sp1_store_save_result() == SP1_STORE_SAVE_BUSY && - k_uptime_get_32() - t0 < SP1_PRST_SAVE_MS) { + /* The save job closes the log after the save (sp1_store.h). */ + while (sp1_store_log_live() && k_uptime_get_32() - t0 < SP1_PRST_SAVE_MS) { sp1_wdt_feed(); k_msleep(TICK_MS); } - const enum sp1_store_save r = sp1_store_save_result(); - printk("PRST save slot %d: %s after %u ms\n", g_prst_slot + 1, - r == SP1_STORE_SAVE_OK ? "saved" : (r == SP1_STORE_SAVE_BUSY - ? "NOT finished in time -- powering off anyway" - : "FAILED"), - (unsigned)(k_uptime_get_32() - t0)); + if (log) { + printk("LOG %s after %u ms\n", sp1_store_log_live() + ? "NOT closed in time -- powering off anyway" : "closed", + (unsigned)(k_uptime_get_32() - t0)); + } } #elif defined(CONFIG_SP1_PLAITS) /* Without storage there is no PRST: "••" + PLAY is ROTC alone. */ @@ -1373,7 +1390,7 @@ int main(void) sp1_mui_init(); #endif #if defined(CONFIG_SP1_STORAGE) && defined(CONFIG_SP1_PLAITS) - sp1_power_set_save_hook(prst_save_at_shutdown); /* PRST (#50) */ + sp1_power_set_save_hook(storage_at_shutdown); /* PRST (#50), the log (#52) */ #endif /* ---- top-level state machine ---- @@ -1384,6 +1401,9 @@ int main(void) for (;;) { if (standby) { + /* #52 (Adara): STANDBY is not logged to the drive. Its lines stay in the + * RAM log for the console; the file's cursor jumps over them at ON. */ + sp1_logbuf_file_pause(); sp1_standby_run(); /* returns only when powering ON */ standby = false; } @@ -1417,6 +1437,7 @@ int main(void) #if defined(CONFIG_SP1_STORAGE) /* M6 (#43): the eMMC job runs in the storage thread, below main and audio; * this only queues it. Every way out of ON stops it (sp1_quiesce_peripherals). */ + sp1_logbuf_file_resume(); /* #52: from here the lines are for the log file */ sp1_store_on_enter(); #if defined(CONFIG_SP1_FRESH) /* The fresh image's format holds ON entry, before audio (storage_gate). */ @@ -1431,6 +1452,8 @@ int main(void) standby = true; /* the 30 s backstop, plugged in */ continue; } + /* #52: the ON job may have installed a new engine stack (engines.cnfg). */ + sp1_pui_stack_settle(); if (g_prst_on) { prst_apply(sp1_store_prst_slot(g_prst_slot)); } diff --git a/firmware/src/sp1_cnfg.c b/firmware/src/sp1_cnfg.c new file mode 100644 index 0000000..577a364 --- /dev/null +++ b/firmware/src/sp1_cnfg.c @@ -0,0 +1,468 @@ +/* wakes-sp1 — the config files on the drive (#52). See sp1_cnfg.h. */ +#include "sp1_cnfg.h" +#include "sp1_logs_gen.h" +#include "sp1_engines_gen.h" + +#include + +_Static_assert(SP1_ENGINE_SLOTS == SP1_CNFG_SLOTS, "engines.cnfg has 24 slots"); +_Static_assert(SP1_ENGINE_EMPTY == SP1_CNFG_EMPTY, "one value for an empty slot"); +_Static_assert(SP1_PLAITS_ENGINE_COUNT <= 32, "the used-engine set is a 32-bit mask"); + +/* ---------------------------------------------------------------- the ini reader */ + +static bool space(char c) +{ + return c == ' ' || c == '\t' || c == '\r' || c == '\n' || c == '\f' || c == '\v'; +} + +static char lower(char c) +{ + return (c >= 'A' && c <= 'Z') ? (char)(c - 'A' + 'a') : c; +} + +/* Trim s in place; returns the new start. */ +static char *trim(char *s) +{ + while (space(*s)) { + s++; + } + size_t n = strlen(s); + while (n > 0u && space(s[n - 1u])) { + s[--n] = '\0'; + } + return s; +} + +static void lower_str(char *s) +{ + for (; *s != '\0'; s++) { + *s = lower(*s); + } +} + +static bool same(const char *a, const char *b) +{ + for (; *a != '\0' && lower(*a) == lower(*b); a++, b++) { + } + return lower(*a) == lower(*b); +} + +void sp1_cnfg_begin(struct sp1_cnfg_parser *p, sp1_cnfg_entry_fn entry, + sp1_cnfg_problem_fn problem, void *ctx) +{ + memset(p, 0, sizeof(*p)); + p->entry = entry; + p->problem = problem; + p->ctx = ctx; +} + +static void line_done(struct sp1_cnfg_parser *p) +{ + p->line++; + p->buf[p->n] = '\0'; + const bool overlong = p->overlong; + p->n = 0u; + p->overlong = false; + if (overlong) { + p->problem(p->ctx, p->line, "(a long line)", + "over 160 characters: the line is ignored"); + return; + } + char *s = p->buf; + /* A UTF-8 byte order mark (Notepad and Excel write one). */ + if (p->line == 1 && (unsigned char)s[0] == 0xEFu && (unsigned char)s[1] == 0xBBu && + (unsigned char)s[2] == 0xBFu) { + s += 3; + } + s = trim(s); + if (*s == '\0' || *s == ';' || *s == '#') { + return; + } + if (*s == '[') { + char *end = strchr(s, ']'); + if (end == NULL) { + p->section[0] = '\0'; + p->problem(p->ctx, p->line, s, "a section name needs a closing ]: the " + "settings under it are ignored"); + return; + } + *end = '\0'; + char *name = trim(s + 1); + if (strlen(name) >= sizeof(p->section)) { + p->section[0] = '\0'; + p->problem(p->ctx, p->line, name, "is not a section: the settings under it " + "are ignored"); + return; + } + strcpy(p->section, name); + lower_str(p->section); + return; + } + char *eq = strchr(s, '='); + if (eq == NULL) { + p->problem(p->ctx, p->line, s, "is not a setting (key = value): ignored"); + return; + } + *eq = '\0'; + char *key = trim(s); + char *val = eq + 1; + /* An inline comment: ; or # at the start of the value or after whitespace (Python's + * configparser, which checks the defaults at build time, reads them the same way). */ + for (char *c = val; *c != '\0'; c++) { + if ((*c == ';' || *c == '#') && (c == val || space(c[-1]))) { + *c = '\0'; + break; + } + } + val = trim(val); + if (*key == '\0') { + p->problem(p->ctx, p->line, "(nothing before the =)", "a setting needs a name: " + "ignored"); + return; + } + lower_str(key); + p->entry(p->ctx, p->line, p->section, key, val); +} + +void sp1_cnfg_feed(struct sp1_cnfg_parser *p, const char *text, size_t n) +{ + for (size_t i = 0u; i < n; i++) { + const char c = text[i]; + if (c == '\n') { + line_done(p); + } else if (p->n < SP1_CNFG_LINE_MAX) { + p->buf[p->n++] = (c == '\0') ? ' ' : c; + } else { + p->overlong = true; + } + } +} + +void sp1_cnfg_end(struct sp1_cnfg_parser *p) +{ + if (p->n > 0u || p->overlong) { + line_done(p); + } +} + +/* ---------------------------------------------------------------- logs.cnfg */ + +static const struct { + const char *key; + uint8_t bit; /* SP1_LOG_*, or 0 for `enabled` */ +} LOG_KEYS[] = { + { "enabled", 0u }, + { "performance", SP1_LOG_PERFORMANCE }, + { "controls", SP1_LOG_CONTROLS }, + { "midi", SP1_LOG_MIDI }, + { "usb", SP1_LOG_USB }, + { "storage", SP1_LOG_STORAGE }, +}; +#define SEEN_ENABLED 0x80u + +void sp1_logs_defaults(struct sp1_logs_cfg *c) +{ + c->enabled = SP1_LOGS_DEF_ENABLED != 0; + c->cats = (uint8_t)SP1_LOGS_DEF_CATS; +} + +static void report(struct sp1_logs_reader *r, int line, const char *what, const char *why) +{ + r->problems++; + r->problem(r->ctx, line, what, why); +} + +static void logs_entry(void *ctx, int line, const char *section, const char *key, + const char *value) +{ + struct sp1_logs_reader *r = ctx; + if (section[0] == '\0') { + report(r, line, key, "is not under [logs]: ignored"); + return; + } + if (strcmp(section, "logs") != 0) { + if (strcmp(section, r->bad_section) != 0) { + strcpy(r->bad_section, section); /* both < SP1_CNFG_NAME_MAX */ + report(r, line, section, "is not a section of logs.cnfg (expected [logs]): " + "its settings are ignored"); + } + return; + } + for (size_t i = 0u; i < sizeof(LOG_KEYS) / sizeof(LOG_KEYS[0]); i++) { + if (strcmp(key, LOG_KEYS[i].key) != 0) { + continue; + } + const uint8_t seen = LOG_KEYS[i].bit ? LOG_KEYS[i].bit : SEEN_ENABLED; + if (r->seen & seen) { + report(r, line, key, "is set twice: the first one is used"); + return; + } + r->seen |= seen; + bool on; + if (same(value, "on")) { + on = true; + } else if (same(value, "off")) { + on = false; + } else { + size_t k = strlen(key); + memcpy(r->what, key, k); + memcpy(r->what + k, " = ", 3u); + const size_t v = strlen(value); /* key + value < SP1_CNFG_LINE_MAX */ + memcpy(r->what + k + 3u, value, v + 1u); + report(r, line, r->what, "must be on or off: the default is used"); + return; + } + if (LOG_KEYS[i].bit == 0u) { + r->cfg->enabled = on; + } else if (on) { + r->cfg->cats |= LOG_KEYS[i].bit; + } else { + r->cfg->cats &= (uint8_t)~LOG_KEYS[i].bit; + } + return; + } + report(r, line, key, "is not a logs.cnfg setting: ignored"); +} + +static void logs_problem(void *ctx, int line, const char *what, const char *why) +{ + report(ctx, line, what, why); +} + +void sp1_logs_begin(struct sp1_logs_reader *r, struct sp1_logs_cfg *c, + sp1_cnfg_problem_fn problem, void *ctx) +{ + memset(r, 0, sizeof(*r)); + r->cfg = c; + r->problem = problem; + r->ctx = ctx; + sp1_cnfg_begin(&r->p, logs_entry, logs_problem, r); +} + +void sp1_logs_feed(struct sp1_logs_reader *r, const char *text, size_t n) +{ + sp1_cnfg_feed(&r->p, text, n); +} + +int sp1_logs_end(struct sp1_logs_reader *r) +{ + sp1_cnfg_end(&r->p); + return r->problems; +} + +const char *sp1_logs_describe(uint8_t cats, char *buf, size_t size) +{ + size_t n = 0u; + buf[0] = '\0'; + for (size_t i = 1u; i < sizeof(LOG_KEYS) / sizeof(LOG_KEYS[0]); i++) { + if (!(cats & LOG_KEYS[i].bit)) { + continue; + } + const size_t k = strlen(LOG_KEYS[i].key); + if (n + k + 2u > size) { + break; + } + if (n > 0u) { + buf[n++] = ' '; + } + memcpy(buf + n, LOG_KEYS[i].key, k + 1u); + n += k; + } + if (n == 0u && size >= 5u) { + memcpy(buf, "none", 5u); + } + return buf; +} + +/* ---------------------------------------------------------------- engines.cnfg */ + +int sp1_engine_index(const char *name, size_t n) +{ + for (int i = 0; i < SP1_PLAITS_ENGINE_COUNT; i++) { + if (sp1_engine_name_eq(SP1_PLAITS_ENGINES[i].name, name, n)) { + return i; + } + } + return -1; +} + +void sp1_engines_defaults(uint8_t out[SP1_CNFG_SLOTS]) +{ + static const uint8_t def[SP1_CNFG_SLOTS] = SP1_ENGINE_DEFAULT_STACK; + memcpy(out, def, SP1_CNFG_SLOTS); +} + +static void eng_report(struct sp1_engines_reader *r, int line, const char *what, const char *why) +{ + r->problems++; + r->problem(r->ctx, line, what, why); +} + +static void eng_problem(void *ctx, int line, const char *what, const char *why) +{ + eng_report(ctx, line, what, why); +} + +/* " = " into r->what, for a problem that is about the whole line. */ +static const char *eng_line(struct sp1_engines_reader *r, const char *key, const char *value) +{ + const size_t k = strlen(key); + const size_t v = strlen(value); /* key + value < SP1_CNFG_LINE_MAX */ + memcpy(r->what, key, k); + memcpy(r->what + k, " = ", 3u); + memcpy(r->what + k + 3u, value, v + 1u); + return r->what; +} + +static void eng_entry(void *ctx, int line, const char *section, const char *key, + const char *value) +{ + struct sp1_engines_reader *r = ctx; + if (section[0] == '\0') { + eng_report(r, line, key, "is not under [engines]"); + return; + } + if (strcmp(section, "engines") != 0) { + if (strcmp(section, r->bad_section) != 0) { + strcpy(r->bad_section, section); /* both < SP1_CNFG_NAME_MAX */ + eng_report(r, line, section, "is not a section of engines.cnfg (expected " + "[engines])"); + } + return; + } + /* The slot: 1-24, digits only. */ + int slot = 0; + const char *k = key; + for (; *k >= '0' && *k <= '9' && slot <= SP1_CNFG_SLOTS; k++) { + slot = slot * 10 + (*k - '0'); + } + if (*k != '\0' || k == key || slot < 1 || slot > SP1_CNFG_SLOTS) { + eng_report(r, line, key, "is not a slot (1-24)"); + return; + } + const uint32_t bit = 1u << (slot - 1); + if (r->seen & bit) { + eng_report(r, line, key, "is set twice"); + return; + } + r->seen |= bit; + if (value[0] == '\0' || same(value, "none")) { + return; /* an empty slot */ + } + const int e = sp1_engine_index(value, strlen(value)); + if (e < 0) { + eng_report(r, line, eng_line(r, key, value), "is not an engine name (the list is at " + "the end of the file)"); + return; + } + if (r->used & (1u << e)) { + eng_report(r, line, eng_line(r, key, value), "uses an engine that is already in " + "another slot (each engine can be used once)"); + return; + } + r->used |= 1u << e; + r->stack[slot - 1] = (uint8_t)e; + r->filled++; +} + +void sp1_engines_begin(struct sp1_engines_reader *r, sp1_cnfg_problem_fn problem, void *ctx) +{ + memset(r, 0, sizeof(*r)); + memset(r->stack, SP1_CNFG_EMPTY, sizeof(r->stack)); + r->problem = problem; + r->ctx = ctx; + sp1_cnfg_begin(&r->p, eng_entry, eng_problem, r); +} + +void sp1_engines_feed(struct sp1_engines_reader *r, const char *text, size_t n) +{ + sp1_cnfg_feed(&r->p, text, n); +} + +int sp1_engines_end(struct sp1_engines_reader *r, uint8_t out[SP1_CNFG_SLOTS], int *filled) +{ + sp1_cnfg_end(&r->p); + if (r->problems == 0 && r->filled == 0) { + eng_report(r, r->p.line, "(the whole file)", "names no engine: T2/T3 would have " + "nothing to play"); + } + if (r->problems == 0) { + memcpy(out, r->stack, SP1_CNFG_SLOTS); + *filled = r->filled; + } else { + sp1_engines_defaults(out); + int n = 0; + for (int i = 0; i < SP1_CNFG_SLOTS; i++) { + n += (out[i] != SP1_CNFG_EMPTY); + } + *filled = n; + } + return r->problems; +} + +/* ---------------------------------------------------------------- the log's categories */ + +/* Every tag the firmware prints, by category (the first word of the line). A tag that is + * not here -- BOOT, PWR, CHARGE, JACK, CTRL, CALIBRATION, CNFG, the "[ON]" status line -- + * is always written. A new printk tag lands there too until it is added. */ +static const struct { + const char *tag; + uint8_t cat; +} TAGS[] = { + { "AUD", SP1_LOG_PERFORMANCE }, { "CPU", SP1_LOG_PERFORMANCE }, + { "BLK", SP1_LOG_PERFORMANCE }, { "MISS", SP1_LOG_PERFORMANCE }, + { "SYN", SP1_LOG_PERFORMANCE }, { "THREADS", SP1_LOG_PERFORMANCE }, + { "PAGE", SP1_LOG_CONTROLS }, { "SHIFT", SP1_LOG_CONTROLS }, + { "ENGINE", SP1_LOG_CONTROLS }, { "MODULE", SP1_LOG_CONTROLS }, + { "MODEL", SP1_LOG_CONTROLS }, { "ROUTE", SP1_LOG_CONTROLS }, + { "RIP", SP1_LOG_CONTROLS }, { "UNPATCH", SP1_LOG_CONTROLS }, + { "RANGE", SP1_LOG_CONTROLS }, { "LEVEL", SP1_LOG_CONTROLS }, + { "QUANTIZE", SP1_LOG_CONTROLS }, { "SCALE", SP1_LOG_CONTROLS }, + { "PICKUP", SP1_LOG_CONTROLS }, { "DRIVE", SP1_LOG_CONTROLS }, + { "BURST", SP1_LOG_CONTROLS }, { "DIVISION", SP1_LOG_CONTROLS }, + { "OUTPUT", SP1_LOG_CONTROLS }, { "TRIG", SP1_LOG_CONTROLS }, + { "FREQUENCY", SP1_LOG_CONTROLS }, { "MARBLES", SP1_LOG_CONTROLS }, + { "DEJA", SP1_LOG_CONTROLS }, { "DIVERSITY", SP1_LOG_CONTROLS }, + { "TONE", SP1_LOG_CONTROLS }, { "SAG", SP1_LOG_CONTROLS }, + { "MIDI", SP1_LOG_MIDI }, { "CLOCK", SP1_LOG_MIDI }, + { "USB", SP1_LOG_USB }, { "UAC", SP1_LOG_USB }, + { "SPEAKER", SP1_LOG_USB }, + { "STORE", SP1_LOG_STORAGE }, { "EMMC", SP1_LOG_STORAGE }, + { "PRST", SP1_LOG_STORAGE }, { "LOG", SP1_LOG_STORAGE }, +}; + +uint8_t sp1_log_category(const char *line, size_t n) +{ + size_t i = 0u; + /* "[+hh:mm:ss.mmm] " */ + if (n >= 2u && line[0] == '[' && line[1] == '+') { + while (i < n && line[i] != ']') { + i++; + } + i++; + while (i < n && line[i] == ' ') { + i++; + } + } + size_t k = 0u; + while (i + k < n && line[i + k] >= 'A' && line[i + k] <= 'Z') { + k++; + } + if (k < 2u || k > 9u) { + return 0u; + } + /* The tag is a whole word: "STORE ..." yes, "Singles" or "USBx" no. */ + if (i + k < n) { + const char c = line[i + k]; + if ((c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '_') { + return 0u; + } + } + for (size_t t = 0u; t < sizeof(TAGS) / sizeof(TAGS[0]); t++) { + if (strlen(TAGS[t].tag) == k && memcmp(TAGS[t].tag, line + i, k) == 0) { + return TAGS[t].cat; + } + } + return 0u; +} diff --git a/firmware/src/sp1_cnfg.h b/firmware/src/sp1_cnfg.h new file mode 100644 index 0000000..833d47d --- /dev/null +++ b/firmware/src/sp1_cnfg.h @@ -0,0 +1,166 @@ +/* + * wakes-sp1 — the config files on the drive (#52): WAKES/CNFG/.cnfg. + * + * Pure C, no Zephyr, no storage: the storage thread reads a file a chunk at a time and feeds + * it here; the host suite (tools/host-tests/cnfgtest.c) feeds it broken files. + * + * ---- the rules (Adara, #52) ---- + * - config/.cnfg in the repository is the built-in DEFAULT, compiled into every + * image (tools/gen_.py, which fails the build on a bad default). End users never + * touch it: they edit the copy on the drive, which wakes-sp1-fresh writes. + * - Read at EVERY ON, before PRST and before audio. A line overrides its default; a line + * left out keeps it; a line that cannot be read keeps it too, and the log names it. + * - The same key twice: the FIRST is used, the later one is reported. + * - Nothing in a config file touches the power path, the watchdog, the flash layout or + * the USB descriptors (docs/SAFETY.md). + * + * ---- the format: ini ---- + * [section] names ignore case + * key = value keys ignore case; ; or # after whitespace starts a comment + * ; comment / # comment + * A UTF-8 byte order mark is skipped. Lines are at most SP1_CNFG_LINE_MAX bytes. + */ +#ifndef SP1_CNFG_H +#define SP1_CNFG_H + +#include +#include +#include + +#define SP1_CNFG_LINE_MAX 160 +#define SP1_CNFG_NAME_MAX 24 + +/* A problem with one line: `what` is the line (or its key), `why` the reason and what Wakes + * does instead. The firmware prints "CNFG line N: -- ". */ +typedef void (*sp1_cnfg_problem_fn)(void *ctx, int line, const char *what, const char *why); + +/* One `key = value` (section, key lowercased; value trimmed, comment removed). */ +typedef void (*sp1_cnfg_entry_fn)(void *ctx, int line, const char *section, const char *key, + const char *value); + +struct sp1_cnfg_parser { + sp1_cnfg_entry_fn entry; + sp1_cnfg_problem_fn problem; + void *ctx; + char section[SP1_CNFG_NAME_MAX]; + char buf[SP1_CNFG_LINE_MAX + 1]; + size_t n; + int line; + bool overlong; +}; + +void sp1_cnfg_begin(struct sp1_cnfg_parser *p, sp1_cnfg_entry_fn entry, + sp1_cnfg_problem_fn problem, void *ctx); +void sp1_cnfg_feed(struct sp1_cnfg_parser *p, const char *text, size_t n); +void sp1_cnfg_end(struct sp1_cnfg_parser *p); + +/* ---------------------------------------------------------------- logs.cnfg */ + +/* What goes into the log file besides the lines that always do. */ +#define SP1_LOG_PERFORMANCE 0x01u +#define SP1_LOG_CONTROLS 0x02u +#define SP1_LOG_MIDI 0x04u +#define SP1_LOG_USB 0x08u +#define SP1_LOG_STORAGE 0x10u +#define SP1_LOG_ALL 0x1Fu + +struct sp1_logs_cfg { + bool enabled; + uint8_t cats; /* SP1_LOG_* bits */ +}; + +/* The built-in defaults, from config/logs.cnfg (sp1_logs_gen.h). */ +void sp1_logs_defaults(struct sp1_logs_cfg *c); + +/* Read logs.cnfg's text over the defaults already in *c. Returns the number of problems. */ +struct sp1_logs_reader { + struct sp1_cnfg_parser p; + struct sp1_logs_cfg *cfg; + sp1_cnfg_problem_fn problem; + void *ctx; + uint8_t seen; /* keys already set (the first wins) */ + char bad_section[SP1_CNFG_NAME_MAX]; + char what[SP1_CNFG_LINE_MAX + 4]; + int problems; +}; +void sp1_logs_begin(struct sp1_logs_reader *r, struct sp1_logs_cfg *c, + sp1_cnfg_problem_fn problem, void *ctx); +void sp1_logs_feed(struct sp1_logs_reader *r, const char *text, size_t n); +int sp1_logs_end(struct sp1_logs_reader *r); + +/* The categories as words, for the log: "performance controls midi usb storage" or "none". + * buf of at least 48 bytes. */ +const char *sp1_logs_describe(uint8_t cats, char *buf, size_t size); + +/* Which category a log line belongs to, from its tag -- the first word after the + * "[+hh:mm:ss.mmm] " stamp (CPU, MIDI, STORE, ...). 0 = always written: startup, power, + * battery, warnings, and any line without a known tag. */ +uint8_t sp1_log_category(const char *line, size_t n); + +/* ---------------------------------------------------------------- engines.cnfg */ + +/* Two engine names are the same engine when their letters and digits match, case ignored + * (tools/gen_engines.py, name_key): "grain / formant", "grain-formant" and "Grain Formant" + * are one engine -- so a PRST file saved under an older spelling still loads. `canon` is + * NUL-terminated; `s` is `n` bytes. */ +static inline bool sp1_engine_name_eq(const char *canon, const char *s, size_t n) +{ + size_t i = 0u; + for (;;) { + while (*canon != '\0' && !((*canon >= 'a' && *canon <= 'z') || + (*canon >= 'A' && *canon <= 'Z') || + (*canon >= '0' && *canon <= '9'))) { + canon++; + } + while (i < n && !((s[i] >= 'a' && s[i] <= 'z') || (s[i] >= 'A' && s[i] <= 'Z') || + (s[i] >= '0' && s[i] <= '9'))) { + i++; + } + if (*canon == '\0' || i == n) { + return *canon == '\0' && i == n; + } + const char a = (*canon >= 'A' && *canon <= 'Z') ? (char)(*canon - 'A' + 'a') : *canon; + const char b = (s[i] >= 'A' && s[i] <= 'Z') ? (char)(s[i] - 'A' + 'a') : s[i]; + if (a != b) { + return false; + } + canon++; + i++; + } +} + +/* The stack: SP1_CNFG_SLOTS Plaits engine indices, SP1_CNFG_EMPTY for an empty slot (the + * same values as sp1_engines_gen.h's SP1_ENGINE_DEFAULT_STACK; sp1_cnfg.c checks). */ +#define SP1_CNFG_SLOTS 24 +#define SP1_CNFG_EMPTY 255u + +/* An engine of this build by name (sp1_engine_name_eq): its Plaits index, or -1. */ +int sp1_engine_index(const char *name, size_t n); + +/* The built-in stack (config/engines.cnfg at build time). */ +void sp1_engines_defaults(uint8_t out[SP1_CNFG_SLOTS]); + +/* Read engines.cnfg. The file is the WHOLE stack (Adara, #52): a slot it does not name is + * empty. Unlike logs.cnfg, a stack is all or nothing -- half of one would play engines in + * slots nobody chose -- so ANY problem (a name that is not an engine, an engine twice, a + * slot outside 1-24, a slot twice, another section, no engine at all) makes the whole file + * unusable and Wakes uses the built-in stack, every problem named in the log. */ +struct sp1_engines_reader { + struct sp1_cnfg_parser p; + sp1_cnfg_problem_fn problem; + void *ctx; + uint8_t stack[SP1_CNFG_SLOTS]; + uint32_t seen; /* slots set, bit per slot */ + uint32_t used; /* engines used, bit per Plaits index */ + char bad_section[SP1_CNFG_NAME_MAX]; + char what[SP1_CNFG_LINE_MAX + 4]; + int problems; + int filled; +}; +void sp1_engines_begin(struct sp1_engines_reader *r, sp1_cnfg_problem_fn problem, void *ctx); +void sp1_engines_feed(struct sp1_engines_reader *r, const char *text, size_t n); +/* The number of problems. `out` is the file's stack when there were none, otherwise the + * built-in stack. `*filled` = engines in `out`. */ +int sp1_engines_end(struct sp1_engines_reader *r, uint8_t out[SP1_CNFG_SLOTS], int *filled); + +#endif /* SP1_CNFG_H */ diff --git a/firmware/src/sp1_logbuf.c b/firmware/src/sp1_logbuf.c index 4ee7e97..5f98901 100644 --- a/firmware/src/sp1_logbuf.c +++ b/firmware/src/sp1_logbuf.c @@ -1,5 +1,6 @@ /* wakes-sp1 — the stored log. See sp1_logbuf.h. */ #include "sp1_logbuf.h" +#include "sp1_logring.h" #include #include @@ -7,7 +8,7 @@ #include #define LB_SIZE ((uint32_t)CONFIG_SP1_LOGBUF_KB * 1024u) -#define LB_MAGIC 0x574B4C47u /* "WKLG" */ +#define LB_MAGIC 0x324B4C47u /* "GLK2": the ring + file cursor (#52) */ #define STEP_MAX 512u /* bytes played back per control tick, then * on to the end of that line */ #define PACE 48u /* bytes per 1 ms: under CDC ACM's 64 B / frame */ @@ -15,14 +16,16 @@ BUILD_ASSERT(CONFIG_SP1_LOGBUF_KB >= 4, "the stored log needs at least 4 KB"); /* ---- the buffer: survives a soft reset if RAM does (sp1_logbuf.h) ---- */ +/* The file's cursor lives in the ring too, so lines a reset cut off before they reached the + * drive are still written at the next ON (#52). */ static __noinit struct { uint32_t magic; - uint32_t size; - uint32_t head; /* next byte written */ - uint32_t len; /* bytes held, <= size */ + struct sp1_logring ring; uint32_t boots; /* boots this log has run across */ } hdr; static __noinit char data[LB_SIZE]; +static bool continued; /* this boot carries on a kept log */ +static uint32_t boot_resetreas; static printk_hook_fn_t next; /* the console's own printk output */ static struct k_spinlock lock; @@ -35,11 +38,7 @@ static uint32_t rp_pos, rp_left; static void put(char c) { - data[hdr.head] = c; - hdr.head = (hdr.head + 1u == LB_SIZE) ? 0u : hdr.head + 1u; - if (hdr.len < LB_SIZE) { - hdr.len++; - } + sp1_logring_put(&hdr.ring, data, c); } static void put_str(const char *s) @@ -95,17 +94,16 @@ static int hook(int c) void sp1_logbuf_init(uint32_t resetreas) { - const bool kept = hdr.magic == LB_MAGIC && hdr.size == LB_SIZE && - hdr.head < LB_SIZE && hdr.len <= LB_SIZE; + const bool kept = hdr.magic == LB_MAGIC && sp1_logring_valid(&hdr.ring, LB_SIZE); if (!kept) { hdr.magic = LB_MAGIC; - hdr.size = LB_SIZE; - hdr.head = 0u; - hdr.len = 0u; + sp1_logring_init(&hdr.ring, LB_SIZE); hdr.boots = 0u; } hdr.boots++; - if (kept && hdr.len > 0u) { + boot_resetreas = resetreas; + continued = kept && hdr.ring.len > 0u; + if (continued) { char m[96]; snprintk(m, sizeof(m), "\n=== RESET (resetreas 0x%08x): the log above is the boot before; " @@ -133,8 +131,8 @@ static void out_str(const char *s) void sp1_logbuf_replay_start(void) { k_spinlock_key_t key = k_spin_lock(&lock); - rp_left = hdr.len; - rp_pos = (hdr.head + LB_SIZE - hdr.len) % LB_SIZE; + rp_left = hdr.ring.len; + rp_pos = sp1_logring_oldest(&hdr.ring); k_spin_unlock(&lock, key); char m[112]; snprintk(m, sizeof(m), "\n=== STORED LOG: %u bytes, oldest first, [+uptime] per line; " @@ -184,3 +182,48 @@ void sp1_logbuf_replay_step(void) out_str("=== STORED LOG: end ===\n"); } } + +/* ---- the log file (#52) ---- */ + +bool sp1_logbuf_continued(void) +{ + return continued; +} + +uint32_t sp1_logbuf_resetreas(void) +{ + return boot_resetreas; +} + +size_t sp1_logbuf_file_take(char *out, size_t max, uint32_t *lost) +{ + /* One line per lock: at most SP1_LOGBUF_TAKE_MAX bytes copied with interrupts held off. */ + if (max > SP1_LOGBUF_TAKE_MAX) { + max = SP1_LOGBUF_TAKE_MAX; + } + k_spinlock_key_t key = k_spin_lock(&lock); + const size_t n = sp1_logring_take(&hdr.ring, data, out, max, lost); + k_spin_unlock(&lock, key); + return n; +} + +void sp1_logbuf_file_pause(void) +{ + k_spinlock_key_t key = k_spin_lock(&lock); + sp1_logring_pause(&hdr.ring); + k_spin_unlock(&lock, key); +} + +void sp1_logbuf_file_resume(void) +{ + k_spinlock_key_t key = k_spin_lock(&lock); + sp1_logring_resume(&hdr.ring); + k_spin_unlock(&lock, key); +} + +void sp1_logbuf_file_skip(void) +{ + k_spinlock_key_t key = k_spin_lock(&lock); + sp1_logring_skip(&hdr.ring); + k_spin_unlock(&lock, key); +} diff --git a/firmware/src/sp1_logbuf.h b/firmware/src/sp1_logbuf.h index 7231a34..c0299f3 100644 --- a/firmware/src/sp1_logbuf.h +++ b/firmware/src/sp1_logbuf.h @@ -8,8 +8,9 @@ * after the banner, then carries on live. Keep Wakes ON after the session, plug it into the PC, * start the logger: the session is in the file. * - * - CONFIG_SP1_LOGBUF_KB of RAM (96 KB: ~14 minutes at a session's ~120 bytes/s). When it is - * full the OLDEST lines go; the newest are always there. + * - CONFIG_SP1_LOGBUF_KB of RAM (16 KB: ~2 minutes at a session's ~120 bytes/s; 96 KB until + * the log went to the drive, #52). When it is full the OLDEST lines go; the newest are + * always there. * - Every stored line starts with the device's uptime, "[+hh:mm:ss.mmm]", because the * logger's own timestamps on a played-back line are the time of the dump, not of the event. * - It sits in .noinit, so a soft reset -- the watchdog, a fault, sp1_power_off with USB -- @@ -22,12 +23,18 @@ * keep feeding the watchdog. A full buffer takes a few seconds; the controls answer a little * slowly meanwhile. * + * - THE LOG FILE (#52): the storage thread takes whole lines from here every 5 s and writes + * them to WAKES/LOGS/ on the drive (sp1_store.h). Its cursor lives in the ring + * (sp1_logring.h), in .noinit with the rest, so lines a reset cut off before they reached + * the drive are written at the next ON. STANDBY's lines are not for the file (Adara). + * * Nothing here is on the power path, and the audio thread never prints (rule since M2). */ #ifndef SP1_LOGBUF_H #define SP1_LOGBUF_H #include +#include #include /* Once, in main(), after the console is up and before anything else prints. Wraps printk's @@ -44,4 +51,21 @@ void sp1_logbuf_replay_stop(void); bool sp1_logbuf_replaying(void); void sp1_logbuf_replay_step(void); +/* ---- the log file (#52) ---- + * This boot carries on a log kept across a soft reset (the "=== RESET" marker): the same + * session, so the drive's log is appended to rather than rotated. */ +bool sp1_logbuf_continued(void); +uint32_t sp1_logbuf_resetreas(void); + +/* Storage thread: the next line for the file (sp1_logring_take), at most SP1_LOGBUF_TAKE_MAX + * bytes, taken under the lock -- one line's copy with interrupts held off, a few us. */ +#define SP1_LOGBUF_TAKE_MAX 256u +size_t sp1_logbuf_file_take(char *out, size_t max, uint32_t *lost); + +/* Main thread: STANDBY entry / ON entry (STANDBY is not logged to the drive), and "logging + * is off this ON" (nothing written so far is owed to the file). */ +void sp1_logbuf_file_pause(void); +void sp1_logbuf_file_resume(void); +void sp1_logbuf_file_skip(void); + #endif /* SP1_LOGBUF_H */ diff --git a/firmware/src/sp1_logring.c b/firmware/src/sp1_logring.c new file mode 100644 index 0000000..f3f9f7d --- /dev/null +++ b/firmware/src/sp1_logring.c @@ -0,0 +1,181 @@ +/* wakes-sp1 — the stored log's ring and the file's cursor. See sp1_logring.h. */ +#include "sp1_logring.h" + +#include + +/* a < b, positions compared by difference (sp1_logring.h). */ +static bool before(uint32_t a, uint32_t b) +{ + return (int32_t)(a - b) < 0; +} + +/* The index in data[] of absolute position p, which must be held. */ +static uint32_t at(const struct sp1_logring *r, uint32_t p) +{ + return (r->head + r->size - (r->total - p)) % r->size; +} + +void sp1_logring_init(struct sp1_logring *r, uint32_t size) +{ + memset(r, 0, sizeof(*r)); + r->size = size; +} + +bool sp1_logring_valid(struct sp1_logring *r, uint32_t size) +{ + if (r->size != size || size == 0u || r->head >= size || r->len > size || + r->paused > 1u || r->gap > 1u) { + return false; + } + /* A cursor ahead of the writer is nonsense: start the file at the oldest line held. */ + if (before(r->total, r->frd)) { + r->frd = r->total - r->len; + } + if (r->gap && (before(r->gap_to, r->gap_from) || before(r->total, r->gap_to))) { + r->gap = 0u; + } + if (r->paused && before(r->total, r->gap_from)) { + r->paused = 0u; + } + return true; +} + +void sp1_logring_put(struct sp1_logring *r, char *data, char c) +{ + data[r->head] = c; + r->head = (r->head + 1u == r->size) ? 0u : r->head + 1u; + if (r->len < r->size) { + r->len++; + } + r->total++; +} + +uint32_t sp1_logring_oldest(const struct sp1_logring *r) +{ + return (r->head + r->size - r->len) % r->size; +} + +void sp1_logring_pause(struct sp1_logring *r) +{ + if (r->paused) { + return; + } + /* A closed gap the cursor has not reached yet stretches to cover this one too: the + * lines between them (an ON whose log never reached the drive) go with it. */ + if (!r->gap) { + r->gap_from = r->total; + } + r->gap = 0u; + r->paused = 1u; +} + +void sp1_logring_resume(struct sp1_logring *r) +{ + if (!r->paused) { + return; + } + r->paused = 0u; + r->gap_to = r->total; + r->gap = (r->gap_to != r->gap_from) ? 1u : 0u; +} + +void sp1_logring_skip(struct sp1_logring *r) +{ + r->frd = r->total; + r->gap = 0u; + if (r->paused) { + r->gap_from = r->total; + } +} + +size_t sp1_logring_take(struct sp1_logring *r, const char *data, char *out, size_t max, + uint32_t *lost) +{ + bool resync = false; + + /* 1. Overwritten before the file took it. The gap's own bytes are not a loss. */ + const uint32_t oldest = r->total - r->len; + if (before(r->frd, oldest)) { + uint32_t gone = oldest - r->frd; + if (r->gap || r->paused) { + const uint32_t gend = r->paused ? r->total : r->gap_to; + const uint32_t lo = before(r->frd, r->gap_from) ? r->gap_from : r->frd; + const uint32_t hi = before(oldest, gend) ? oldest : gend; + if (before(lo, hi)) { + gone -= hi - lo; + } + } + *lost += gone; + r->frd = oldest; + resync = true; /* mid-line, most likely */ + } + + /* 2. Over a closed gap. Resume lands between lines, so no resync after it. */ + if (r->gap && !before(r->frd, r->gap_from)) { + if (before(r->frd, r->gap_to)) { + r->frd = r->gap_to; + resync = false; + } + r->gap = 0u; + } + + /* 3. How far the file may read: to the gap, if there is one ahead. While paused, + * everything from gap_from on is STANDBY's (the cursor waits there for the resume); + * after step 2 a closed gap is always ahead of the cursor. */ + uint32_t limit = r->total; + bool cut = false; + if (r->paused) { + if (!before(r->frd, r->gap_from)) { + return 0u; + } + limit = r->gap_from; + cut = true; + } else if (r->gap) { + limit = r->gap_from; + cut = true; + } + + if (resync) { + while (before(r->frd, limit) && data[at(r, r->frd)] != '\n') { + r->frd++; + (*lost)++; + } + if (!before(r->frd, limit)) { + return 0u; + } + r->frd++; /* past the '\n' */ + (*lost)++; + } + if (!before(r->frd, limit)) { + return 0u; + } + + /* 4. One line, or a max-byte piece of a long one. */ + const uint32_t avail = limit - r->frd; + const uint32_t scan = avail < max ? avail : (uint32_t)max; + uint32_t i = at(r, r->frd); + size_t n = 0u; + for (uint32_t k = 0u; k < scan; k++) { + if (data[i] == '\n') { + n = (size_t)k + 1u; + break; + } + i = (i + 1u == r->size) ? 0u : i + 1u; + } + if (n == 0u) { + if (avail >= max) { + n = max; + } else if (cut) { + n = avail; /* the gap cuts this line */ + } else { + return 0u; /* still being written */ + } + } + i = at(r, r->frd); + for (size_t k = 0u; k < n; k++) { + out[k] = data[i]; + i = (i + 1u == r->size) ? 0u : i + 1u; + } + r->frd += (uint32_t)n; + return n; +} diff --git a/firmware/src/sp1_logring.h b/firmware/src/sp1_logring.h new file mode 100644 index 0000000..af3b6cd --- /dev/null +++ b/firmware/src/sp1_logring.h @@ -0,0 +1,64 @@ +/* + * wakes-sp1 — the stored log's ring and the log file's cursor into it (#52). + * + * Pure C, no Zephyr: sp1_logbuf.c owns the memory and the lock and calls these under it; + * the host suite (tools/host-tests/cnfgtest.c) drives them through overruns and gaps that + * would take hours to make on the device. + * + * Positions are ABSOLUTE: `total` counts every byte ever written (mod 2^32), and the file's + * cursor and the STANDBY gap are values of it. Compared by difference, so the wrap at 4 GB + * (about a year at a session's ~120 B/s) is harmless. + * + * ---- what the file gets ---- + * Whole lines, oldest first, from `frd` on. Not: + * - STANDBY (Adara, #52): sp1_logring_pause() at STANDBY entry and _resume() at ON entry + * mark a gap the cursor jumps over. Boot lines before the first STANDBY are kept. + * - Lines the ring overwrote before the file took them: counted in `lost` (bytes; the + * gap's own bytes are not counted), and the cursor moves to the next whole line. + */ +#ifndef SP1_LOGRING_H +#define SP1_LOGRING_H + +#include +#include +#include + +struct sp1_logring { + uint32_t size; /* bytes of data[] */ + uint32_t head; /* next byte written */ + uint32_t len; /* bytes held, <= size */ + uint32_t total; /* bytes ever written */ + uint32_t frd; /* the file's cursor: the next byte it takes */ + uint32_t gap_from; /* STANDBY's lines are [gap_from, gap_to) */ + uint32_t gap_to; + uint8_t paused; /* in STANDBY: nothing from gap_from on, yet */ + uint8_t gap; /* a closed gap waits for the cursor */ + uint8_t pad[2]; +}; + +/* An empty ring over `size` bytes; the cursor at the start. */ +void sp1_logring_init(struct sp1_logring *r, uint32_t size); + +/* A ring found in .noinit after a reset: true if every field is consistent (then the file's + * cursor is clamped into what the ring still holds), false if it must be re-initialised. */ +bool sp1_logring_valid(struct sp1_logring *r, uint32_t size); + +void sp1_logring_put(struct sp1_logring *r, char *data, char c); + +/* The oldest byte still held, as an index into data[]. */ +uint32_t sp1_logring_oldest(const struct sp1_logring *r); + +/* STANDBY entry / ON entry. A second pause before a resume keeps the first. */ +void sp1_logring_pause(struct sp1_logring *r); +void sp1_logring_resume(struct sp1_logring *r); + +/* Logging is off this ON: the file is not owed anything written so far. */ +void sp1_logring_skip(struct sp1_logring *r); + +/* The next line for the file into out[0..max), max >= 2: its length (with its '\n'), or 0 + * if no whole line is waiting. A line longer than max comes in max-byte pieces. A partial + * line is taken only where a gap cuts it. `*lost` += bytes the ring overwrote first. */ +size_t sp1_logring_take(struct sp1_logring *r, const char *data, char *out, size_t max, + uint32_t *lost); + +#endif /* SP1_LOGRING_H */ diff --git a/firmware/src/sp1_plaits_ui.c b/firmware/src/sp1_plaits_ui.c index 8685e38..82ca5b6 100644 --- a/firmware/src/sp1_plaits_ui.c +++ b/firmware/src/sp1_plaits_ui.c @@ -8,6 +8,7 @@ #include "sp1_marbles.h" /* the scale quantizer FREQUENCY borrows (M4b) */ #include "sp1_midi.h" /* MIDI's offsets and the quantizer bypass (M5a) */ #include "sp1_ui_timing.h" +#include "sp1_cnfg.h" /* engine names compare by letters and digits (#52) */ #include #include @@ -52,11 +53,11 @@ #define DOUBLE_TAP_MS 400u /* second tap must START within this of the 1st */ #define BREATH_MS 1200u /* SETTINGS page breathing period */ -/* ---- the engine list: GENERATED from config/engines.csv ---- - * Which engine is in which slot comes from the user's CSV; each slot's glyph, and each +/* ---- the engine list: GENERATED from config/engines.cnfg ---- + * Which engine is in which slot comes from config/engines.cnfg; each slot's glyph, and each * engine's Plaits index and centre detents, from the fixed tables in tools/gen_engines.py * (run by the build). The reasons for each detent are in docs/PLAITS-ENGINES.md. Edit - * the CSV, not this file. */ + * config/engines.cnfg, not this file. */ #include "sp1_engines_gen.h" #define C_H 0x1u /* HARMONICS (F4) */ @@ -76,12 +77,40 @@ static enum sp1_pui_layer page = SP1_PUI_BASE; static enum sp1_pui_layer active = SP1_PUI_BASE; static bool base_seeded; /* The SELECTED engine: a position in the generated table -- or, past the table, an engine - * that is NOT in config/engines.csv, loaded from a PRST slot (#50): SP1_PUI_OFFLIST + its - * Plaits index. Every build contains all of Plaits' engines; the CSV only decides which + * that is NOT in config/engines.cnfg, loaded from a PRST slot (#50): SP1_PUI_OFFLIST + its + * Plaits index. Every build contains all of Plaits' engines; the stack only decides which * ones T2/T3 reach. Read the engine's facts through engine_of() / centre_of() / name_of(), * never SP1_ENGINE_TABLE[slot] directly. */ static int slot = SP1_ENGINE_DEFAULT_SLOT; +/* ---- the STACK: which engine is in each slot (#52) ---- + * The built-in stack until the ON job reads WAKES/CNFG/engines.cnfg from the drive, which + * replaces it at every ON (sp1_pui_set_stack). Plaits indices, SP1_ENGINE_EMPTY = an empty + * slot. SP1_ENGINE_TABLE keeps only what never changes: each slot's glyph. + * TWO copies: the storage thread writes the one not in use and then flips `live`, so main + * never reads a stack half-written -- even if it stopped waiting for the ON job (PRST's + * 10 s limit) while the job was still running. Main reads whichever is live at the start of + * each call (stk()). */ +static uint8_t stacks[2][SP1_ENGINE_SLOTS] = { SP1_ENGINE_DEFAULT_STACK, + SP1_ENGINE_DEFAULT_STACK }; +static int live; + +static const uint8_t *stk(void) +{ + return stacks[__atomic_load_n(&live, __ATOMIC_ACQUIRE) & 1]; +} + +/* The first filled slot: where the device starts and where ROTC returns (Adara, #52). */ +static int first_slot(const uint8_t *t) +{ + for (int i = 0; i < SP1_ENGINE_SLOTS; i++) { + if (t[i] != SP1_ENGINE_EMPTY) { + return i; + } + } + return 0; /* never: the readers guarantee one engine (sp1_cnfg.h) */ +} + static bool fnc_was; static bool press_dirty; /* activity seen during this press */ static uint32_t press_ms; @@ -118,12 +147,17 @@ static bool offlist(int s) /* A selection the UI can hold: a FILLED list position, or an engine off the list. */ static bool slot_ok(int s) { - return (s >= 0 && s < SP1_ENGINE_SLOTS && SP1_ENGINE_TABLE[s].on) || offlist(s); + return (s >= 0 && s < SP1_ENGINE_SLOTS && stk()[s] != SP1_ENGINE_EMPTY) || offlist(s); } static int engine_of(int s) { - return offlist(s) ? s - SP1_PUI_OFFLIST : SP1_ENGINE_TABLE[s].plaits; + if (offlist(s)) { + return s - SP1_PUI_OFFLIST; + } + const uint8_t e = (s >= 0 && s < SP1_ENGINE_SLOTS) ? stk()[s] : SP1_ENGINE_EMPTY; + /* An empty slot has no engine: callers check slot_ok() first; this is a backstop. */ + return e < SP1_PLAITS_ENGINE_COUNT ? e : stk()[first_slot(stk())]; } static uint8_t centre_of(int s) @@ -138,7 +172,7 @@ static const char *name_of(int s) /* ---- the engine that PLAYS (M5a) ---- * `slot` is what T2/T3 selected; MIDI's MODEL CC offsets it, through the filled slots of - * config/engines.csv in order, clamped at both ends (Plaits' own MODEL CV input is an offset + * config/engines.cnfg in order, clamped at both ends (Plaits' own MODEL CV input is an offset * from the button-selected model too). A CC at either end reaches every filled slot from * any selection. Everything that depends on the engine actually sounding -- its detents, * Plaits' engine index, INTELLIGENT's polarity, the log -- uses this; the engine flash and @@ -149,10 +183,11 @@ static int eslot(void) if (off == 0.0f) { return slot; } + const uint8_t *t = stk(); int filled[SP1_ENGINE_SLOTS]; int n = 0, here = 0; /* off the list: MODEL counts from position 1 (#50) */ for (int i = 0; i < SP1_ENGINE_SLOTS; i++) { - if (SP1_ENGINE_TABLE[i].on) { + if (t[i] != SP1_ENGINE_EMPTY) { if (i == slot) { here = n; } @@ -612,7 +647,8 @@ void sp1_pui_rip(void) /* ---- "rip out the cables" on PLAITS: a FULL PATCH WIPE (Adara, M4d) ---- * ⚠️ Through M4b this was a modulation reset that deliberately kept BASE and the * engine. docs/DEFAULTS.md changed that: it now wipes the patch. Engine back to - * slot 1, the four BASE faders to THAT engine's neutral state, everything on the + * the FIRST FILLED SLOT of the stack (#52, Adara: of the user's engines.cnfg, not slot 1 + * of the built-in one), the four BASE faders to THAT engine's neutral state, everything on the * SHIFT and SETTINGS layers to its default, and the FREQUENCY quantizer off. * * Neutral means: 0.5 for a BIPOLAR parameter -- its centre is the point where the @@ -631,14 +667,14 @@ void sp1_pui_rip(void) * set afterwards and the values stay where the rip put them. Re-neutralising on * every engine change would mean losing a patch just by browsing engines. */ struct sp1_pui_patch p; - sp1_pui_rip_patch(SP1_ENGINE_DEFAULT_SLOT, &p); + sp1_pui_rip_patch(-1, &p); /* the first filled slot of the stack (#52) */ sp1_pui_put(&p); } void sp1_pui_rip_patch(int s, struct sp1_pui_patch *p) { if (!slot_ok(s)) { - s = SP1_ENGINE_DEFAULT_SLOT; + s = first_slot(stk()); } const uint8_t c = centre_of(s); p->slot = s; @@ -666,7 +702,7 @@ void sp1_pui_get(struct sp1_pui_patch *p) void sp1_pui_put(const struct sp1_pui_patch *p) { - slot = slot_ok(p->slot) ? p->slot : SP1_ENGINE_DEFAULT_SLOT; + slot = slot_ok(p->slot) ? p->slot : first_slot(stk()); for (int l = 0; l < SP1_PUI_LAYERS; l++) { for (int i = 0; i < 4; i++) { const float x = p->v[l][i]; @@ -678,26 +714,13 @@ void sp1_pui_put(const struct sp1_pui_patch *p) pickup_all(); } -static int lower(int ch) -{ - return (ch >= 'A' && ch <= 'Z') ? ch - 'A' + 'a' : ch; -} - -static bool same_name(const char *n, const char *name, int len) -{ - int k = 0; - while (k < len && n[k] != '\0' && lower((unsigned char)n[k]) == - lower((unsigned char)name[k])) { - k++; - } - return k == len && n[k] == '\0'; -} - int sp1_pui_slot_of(const char *name, int len) { int e = -1; for (int i = 0; i < SP1_PLAITS_ENGINE_COUNT; i++) { - if (same_name(SP1_PLAITS_ENGINES[i].name, name, len)) { + /* Letters and digits, case ignored (sp1_cnfg.h, #52): an older spelling of a + * name in a PRST file still finds its engine. */ + if (sp1_engine_name_eq(SP1_PLAITS_ENGINES[i].name, name, len < 0 ? 0u : (size_t)len)) { e = i; break; } @@ -705,14 +728,41 @@ int sp1_pui_slot_of(const char *name, int len) if (e < 0) { return -1; /* not an engine of this build */ } + const uint8_t *t = stk(); for (int s = 0; s < SP1_ENGINE_SLOTS; s++) { - if (SP1_ENGINE_TABLE[s].on && SP1_ENGINE_TABLE[s].plaits == e) { - return s; /* on the list: its position */ + if (t[s] == e) { + return s; /* in the stack: its position */ } } return SP1_PUI_OFFLIST + e; /* in the build, off the list (#50) */ } +void sp1_pui_set_stack(const uint8_t stack[SP1_ENGINE_SLOTS]) +{ + const int next = (__atomic_load_n(&live, __ATOMIC_ACQUIRE) & 1) ^ 1; + for (int i = 0; i < SP1_ENGINE_SLOTS; i++) { + stacks[next][i] = stack[i] < SP1_PLAITS_ENGINE_COUNT ? stack[i] : SP1_ENGINE_EMPTY; + } + bool any = false; + for (int i = 0; i < SP1_ENGINE_SLOTS; i++) { + any = any || stacks[next][i] != SP1_ENGINE_EMPTY; + } + if (!any) { + const uint8_t def[SP1_ENGINE_SLOTS] = SP1_ENGINE_DEFAULT_STACK; + for (int i = 0; i < SP1_ENGINE_SLOTS; i++) { + stacks[next][i] = def[i]; + } + } + __atomic_store_n(&live, next, __ATOMIC_RELEASE); +} + +void sp1_pui_stack_settle(void) +{ + if (!slot_ok(slot)) { + slot = first_slot(stk()); + } +} + const char *sp1_pui_slot_name(int s) { return slot_ok(s) ? name_of(s) : ""; @@ -753,27 +803,29 @@ void sp1_pui_slot_leds(int s, uint8_t out[4]) } } -/* ---- engine select (T2 / T3), in SLOT order from config/engines.csv ---- - * A slot with no engine in the CSV is empty: it keeps its place and glyph, and is +/* ---- engine select (T2 / T3), in SLOT order from config/engines.cnfg ---- + * A slot with no engine in engines.cnfg is empty: it keeps its place and glyph, and is * skipped. The build guarantees at least one slot is filled. Wraps at both ends. */ int sp1_pui_engine_step(int dir) { if (offlist(slot)) { /* From an engine off the list (#50, Adara): T3 -> the first listed engine, * T2 -> the last. */ + const uint8_t *t = stk(); int s2 = -1; for (int i = 0; i < SP1_ENGINE_SLOTS; i++) { - if (SP1_ENGINE_TABLE[i].on && (s2 < 0 || dir < 0)) { + if (t[i] != SP1_ENGINE_EMPTY && (s2 < 0 || dir < 0)) { s2 = i; } } slot = s2; return slot; } + const uint8_t *t = stk(); int s2 = slot; for (int n = 0; n < SP1_ENGINE_SLOTS; n++) { s2 = (s2 + (dir < 0 ? SP1_ENGINE_SLOTS - 1 : 1)) % SP1_ENGINE_SLOTS; - if (SP1_ENGINE_TABLE[s2].on) { + if (t[s2] != SP1_ENGINE_EMPTY) { break; } } diff --git a/firmware/src/sp1_plaits_ui.h b/firmware/src/sp1_plaits_ui.h index 08688c7..42261ef 100644 --- a/firmware/src/sp1_plaits_ui.h +++ b/firmware/src/sp1_plaits_ui.h @@ -154,7 +154,7 @@ int sp1_pui_scale(void); void sp1_pui_set_octave_max(void); bool sp1_pui_catching(int fader); /* in the active layer */ bool sp1_pui_level_connected(void); /* SETTINGS F4 >= 5 % (M4a) */ -/* ---- engines: slots from config/engines.csv; glyphs and detents fixed in gen_engines.py ---- */ +/* ---- engines: slots from config/engines.cnfg; glyphs and detents fixed in gen_engines.py ---- */ int sp1_pui_engine(void); /* Plaits engine index (voice.cc) */ /* Which of the CURRENT engine's parameters are bipolar, as SP1_ENGINE_TABLE[].centre: * 0x1 = HARMONICS (F4), 0x2 = TIMBRE (F2), 0x4 = MORPH (F3). A detent is placed exactly @@ -190,7 +190,7 @@ void sp1_pui_rip(void); * quantizer. (The output mode, burst division and drive are main.c's; src/sp1_prst.h.) * Pickup state is NOT part of it -- sp1_pui_put() re-evaluates it, as a rip does. */ struct sp1_pui_patch { - int slot; /* engine: position in config/engines.csv */ + int slot; /* engine: position in config/engines.cnfg */ float v[SP1_PUI_LAYERS][4]; /* stored values, pot space 0..1 */ int scale; /* FREQUENCY quantizer, SP1_PUI_SCALE_OFF */ }; @@ -205,9 +205,9 @@ void sp1_pui_put(const struct sp1_pui_patch *p); * source of PLAITS' ROTC defaults: PRST's field check takes its defaults from here too. */ void sp1_pui_rip_patch(int slot, struct sp1_pui_patch *p); /* The slot whose engine is called `name` (case-insensitive), among the FILLED slots of - * config/engines.csv; -1 if there is none. */ + * config/engines.cnfg; -1 if there is none. */ /* ---- engines OFF the list (#50) ---- - * Every build contains all of Plaits' engines; config/engines.csv only decides which ones + * Every build contains all of Plaits' engines; config/engines.cnfg only decides which ones * T2/T3 reach. A PRST slot may name one that is not listed, and it plays. Such a selection * is SP1_PUI_OFFLIST + its Plaits index, wherever a "slot" appears in this API. It has no * glyph (sp1_pui_slot_leds() gives dark; main.c draws the off-list animation), T3 from it @@ -215,9 +215,21 @@ void sp1_pui_rip_patch(int slot, struct sp1_pui_patch *p); * position 1. */ #define SP1_PUI_OFFLIST 100 bool sp1_pui_offlist(int slot); -/* The selection for engine `name` (case ignored): its list position if it is listed, else - * SP1_PUI_OFFLIST + its Plaits index; -1 if this build has no such engine. */ +/* The selection for engine `name` (letters and digits, case ignored -- sp1_cnfg.h): its + * position if it is in the stack, else SP1_PUI_OFFLIST + its Plaits index; -1 if this build + * has no such engine. */ int sp1_pui_slot_of(const char *name, int len); + +/* ---- the stack (#52) ---- + * Which engine is in each slot: the built-in stack (config/engines.cnfg at build time) until + * the ON job reads WAKES/CNFG/engines.cnfg from the drive and calls this -- every ON, before + * the PRST slots are read, so their engine names resolve against the new stack. Plaits + * indices, SP1_ENGINE_EMPTY for an empty slot; a stack with no engine is replaced by the + * built-in one. Safe from the storage thread while main runs (two copies, one flip). */ +void sp1_pui_set_stack(const uint8_t stack[24]); +/* Main, after the ON job: a selection left on a slot the new stack emptied moves to the + * first filled slot. (With PRST on, the loaded slot replaces the selection anyway.) */ +void sp1_pui_stack_settle(void); const char *sp1_pui_slot_name(int slot); /* "" for no engine */ const char *sp1_pui_engine_name(void); diff --git a/firmware/src/sp1_prst.h b/firmware/src/sp1_prst.h index e5d3e88..5176bfc 100644 --- a/firmware/src/sp1_prst.h +++ b/firmware/src/sp1_prst.h @@ -24,7 +24,7 @@ * ... * * Fader values are positions 0..1 with four decimals; choices are lowercase tokens; the - * engine is its NAME from config/engines.csv (Adara: by name, so a slot survives an edited + * engine is its NAME from config/engines.cnfg (Adara: by name, so a slot survives an edited * engine list). Reading ignores case, blank lines and lines starting ';' or '#'. A key the * table does not know is ignored, so is a section. If a key appears twice, the last wins. * @@ -36,7 +36,7 @@ * exponent, nothing after it); * - a choice must be one of its tokens, and pass its check (an included scale; a * destination on that output's ring); - * - the engine must name a filled slot of config/engines.csv; otherwise slot 1; + * - the engine must name a filled slot of config/engines.cnfg; otherwise slot 1; * - a missing key takes its default too. * The ROTC default comes from the rip code itself (sp1_pui_rip_patch, sp1_mui_rip_patch), * never from a second table -- and for a BASE fader it is the neutral value of the engine diff --git a/firmware/src/sp1_store.c b/firmware/src/sp1_store.c index 414be14..d41b602 100644 --- a/firmware/src/sp1_store.c +++ b/firmware/src/sp1_store.c @@ -3,11 +3,19 @@ * * FatFs (ChaN, R0.16, through Zephyr's fs layer) sits on a disk driver here that reads * and writes single blocks through sp1_emmc.c. Every console line starts "STORE" (this - * file) or "EMMC" (sp1_emmc_report.c). + * file), "CNFG" (the config files), "LOG" (the log on the drive) or "EMMC" + * (sp1_emmc_report.c). */ #include "sp1_store.h" #include "sp1_emmc.h" #include "sp1_console.h" +#include "sp1_cnfg.h" +#include "sp1_logbuf.h" +#if defined(CONFIG_SP1_FRESH) +#define SP1_CNFG_TEMPLATES /* the fresh image writes the config files */ +#include "sp1_engines_gen.h" /* ...engines.cnfg among them */ +#endif +#include "sp1_logs_gen.h" #if defined(CONFIG_SP1_STORAGE_TEST) #include "sp1_emmc_report.h" #endif @@ -24,6 +32,8 @@ #define DISK_NAME "EMMC" /* = CONFIG_FS_FATFS_CUSTOM_MOUNT_POINTS */ #define MNT "/EMMC:" #define DIR_WAKES MNT "/WAKES" +#define DIR_CNFG DIR_WAKES "/CNFG" +#define DIR_LOGS DIR_WAKES "/LOGS" /* The partition starts one erase group in: 8192 blocks = 4 MB (EXT_CSD * HC_ERASE_GRP_SIZE 8 x 512 KB on this card, logs/sp1-20261007-152119.log). */ @@ -32,6 +42,9 @@ #define LINE(...) do { printk(__VA_ARGS__); sp1_console_pace(); } while (0) static volatile bool stop; +/* Set by sp1_store_abort and cleared only by the thread, once it has let go of the log file + * and the volume (log_teardown): sp1_store_on_enter() clears `stop`, so it cannot say this. */ +static volatile bool torn; /* ---- who owns the card (drive mode, M6) ---- * Two disks over one card: "EMMC" is Wakes' (FatFs, this thread) and "DRIVE" the host's @@ -55,6 +68,7 @@ static uint32_t r_data; #define JOB_ON BIT(0) #define JOB_HOST BIT(1) #define JOB_SAVE BIT(2) +#define JOB_LOGEND BIT(3) static atomic_t pending; /* What main's storage_gate() reads (sp1_store.h). */ @@ -306,6 +320,515 @@ __maybe_unused static int read_file(const char *path, void *d, size_t max, size_ return rc; } +/* Verify `path` is a FOLDER; create it if nothing is there (Adara, #50; the log's and the + * config files' folders too since #52). 0 when there is a folder to write into. Something + * else with that name -- a computer can leave a FILE called "3" where slot 3's folder + * should be -- is -ENOTDIR and is left alone: the write fails with that in the log rather + * than touching a file it did not write. */ +static int ensure_dir(const char *path) +{ + static struct fs_dirent st; + int rc = fs_stat(path, &st); + if (rc == 0) { + if (st.type == FS_DIR_ENTRY_DIR) { + return 0; + } + LINE("STORE %s is a file, not a folder -- not writing there\n", path); + return -ENOTDIR; + } + if (rc != -ENOENT) { + return rc; + } + rc = fs_mkdir(path); + LINE("STORE no folder %s -- %s (%d)\n", path, rc == 0 ? "created" : "create FAILED", rc); + return rc; +} + +/* ---------------------------------------------------------------- CNFG (#52) */ + +#define LOGS_CNFG DIR_CNFG "/logs.cnfg" +#define ENGINES_CNFG DIR_CNFG "/engines.cnfg" +#define CNFG_READ_MAX 16384u /* a config file is a few KB; never read a huge one */ + +static struct sp1_logs_cfg logs_cfg; + +static void cnfg_problem(void *ctx, int line, const char *what, const char *why) +{ + LINE("CNFG %s line %d: %s -- %s\n", (const char *)ctx, line, what, why); +} + +/* A file through a reader, CNFG_READ_MAX at most. 0 = read (*got bytes, *rerr if a read + * failed part-way); -ENOENT = not on the drive; anything else = could not be opened. */ +static int cnfg_read(const char *path, void (*feed)(void *r, const char *t, size_t n), void *r, + size_t *got, bool *rerr) +{ + static char chunk[128]; + *got = 0u; + *rerr = false; + struct fs_file_t f; + fs_file_t_init(&f); + const int rc = fs_open(&f, path, FS_O_READ); + if (rc != 0) { + return rc; + } + while (!stop && *got < CNFG_READ_MAX) { + const ssize_t n = fs_read(&f, chunk, sizeof(chunk)); + if (n <= 0) { + *rerr = n < 0; + break; + } + feed(r, chunk, (size_t)n); + *got += (size_t)n; + } + (void)fs_close(&f); + return 0; +} + +static void logs_feed(void *r, const char *t, size_t n) +{ + sp1_logs_feed(r, t, n); +} + +/* logs.cnfg: line by line over the built-in defaults -- a bad line keeps its default. */ +static void cnfg_load_logs(void) +{ + static struct sp1_logs_reader rd; /* ~0.4 KB: off the thread's stack */ + sp1_logs_defaults(&logs_cfg); + sp1_logs_begin(&rd, &logs_cfg, cnfg_problem, (void *)"logs.cnfg"); + size_t got; + bool rerr; + const int rc = cnfg_read(LOGS_CNFG, logs_feed, &rd, &got, &rerr); + if (rc == -ENOENT) { + LINE("CNFG logs.cnfg: not on the drive -- the built-in defaults\n"); + } else if (rc != 0) { + LINE("CNFG logs.cnfg: cannot be opened (%d) -- the built-in defaults\n", rc); + } else { + const int bad = sp1_logs_end(&rd); + LINE("CNFG logs.cnfg: %u B read%s, %d problem%s%s\n", (unsigned)got, + rerr ? " (then a read error)" : (got >= CNFG_READ_MAX ? " (the rest ignored)" : ""), + bad, bad == 1 ? "" : "s", bad ? " -- those lines keep their defaults" : ""); + } + char d[48]; + LINE("CNFG logging to the drive %s: %s\n", logs_cfg.enabled ? "on" : "off", + sp1_logs_describe(logs_cfg.cats, d, sizeof(d))); +} + +#if defined(CONFIG_SP1_PLAITS) +static void engines_feed(void *r, const char *t, size_t n) +{ + sp1_engines_feed(r, t, n); +} + +static int stack_count(const uint8_t s[SP1_CNFG_SLOTS]) +{ + int n = 0; + for (int i = 0; i < SP1_CNFG_SLOTS; i++) { + n += (s[i] != SP1_CNFG_EMPTY); + } + return n; +} + +/* engines.cnfg: ALL OR NOTHING (sp1_cnfg.h). Missing, unreadable, or any problem in it -> + * the built-in stack, every problem named. Installed before PRST reads its slots, so their + * engine names resolve against it; ROTC and the start go to its first filled slot. */ +static void cnfg_load_engines(void) +{ + static struct sp1_engines_reader rd; /* ~0.4 KB: off the thread's stack */ + uint8_t stack[SP1_CNFG_SLOTS]; + int filled = 0; + sp1_engines_begin(&rd, cnfg_problem, (void *)"engines.cnfg"); + size_t got; + bool rerr; + const int rc = cnfg_read(ENGINES_CNFG, engines_feed, &rd, &got, &rerr); + if (rc != 0) { + sp1_engines_defaults(stack); + filled = stack_count(stack); + if (rc == -ENOENT) { + LINE("CNFG engines.cnfg: not on the drive -- the built-in stack\n"); + } else { + LINE("CNFG engines.cnfg: cannot be opened (%d) -- the built-in stack\n", rc); + } + } else { + int bad = sp1_engines_end(&rd, stack, &filled); + if (bad == 0 && (rerr || got >= CNFG_READ_MAX)) { + /* Only part of the file was read: part of a stack is not the user's stack. */ + bad = 1; + sp1_engines_defaults(stack); + filled = stack_count(stack); + } + LINE("CNFG engines.cnfg: %u B read%s, %d problem%s -- %s\n", (unsigned)got, + rerr ? " (then a read error)" : (got >= CNFG_READ_MAX ? " (too long)" : ""), + bad, bad == 1 ? "" : "s", + bad ? "the built-in stack instead (the whole file is set aside)" + : "your stack"); + } + sp1_pui_set_stack(stack); + int first = 0; + while (first < SP1_CNFG_SLOTS - 1 && stack[first] == SP1_CNFG_EMPTY) { + first++; + } + LINE("CNFG engine stack: %d engine%s, starting at slot %d\n", filled, + filled == 1 ? "" : "s", first + 1); +} +#endif + +/* No volume: the built-in everything, so nothing from an earlier ON's files lingers. */ +static void cnfg_defaults(void) +{ + sp1_logs_defaults(&logs_cfg); +#if defined(CONFIG_SP1_PLAITS) + uint8_t stack[SP1_CNFG_SLOTS]; + sp1_engines_defaults(stack); + sp1_pui_set_stack(stack); +#endif +} + +/* Inside the ON job, the volume mounted: every config file, over the built-in defaults. + * Never fails: a missing or unreadable file keeps the defaults. */ +static void cnfg_load(void) +{ + cnfg_load_logs(); +#if defined(CONFIG_SP1_PLAITS) + if (!stop) { + cnfg_load_engines(); + } +#endif +} + +#if defined(CONFIG_SP1_FRESH) +/* wakes-sp1-fresh, after its format (Adara, #52): the config files, commented, in + * WAKES/CNFG/. config/.cnfg in the repository, byte for byte. */ +static int cnfg_write_one(const char *path, const char *name, const char *text, size_t n) +{ + const int rc = write_file(path, text, n); + LINE("STORE fresh: WAKES/CNFG/%s (%u B): %s (%d)\n", name, (unsigned)n, + rc == 0 ? "written" : "FAILED", rc); + return rc; +} + +static int cnfg_write_templates(void) +{ + int rc = ensure_dir(DIR_CNFG); + if (rc == 0 && !stop) { + rc = cnfg_write_one(LOGS_CNFG, "logs.cnfg", SP1_LOGS_TEMPLATE, + sizeof(SP1_LOGS_TEMPLATE) - 1u); + } +#if defined(CONFIG_SP1_PLAITS) + if (rc == 0 && !stop) { + rc = cnfg_write_one(ENGINES_CNFG, "engines.cnfg", SP1_ENGINES_TEMPLATE, + sizeof(SP1_ENGINES_TEMPLATE) - 1u); + } +#endif + return stop ? -ECANCELED : rc; +} +#endif + +/* ---------------------------------------------------------------- the log (#52) */ + +/* One file per session, NNNN.LOGS (Adara): the session number mod 10000, so 9999.LOGS is + * followed by 0000.LOGS. The number itself keeps counting, in WAKES/LOGS/SESSION and in each + * file's first line. The last SP1_STORE_LOG_KEEP sessions are kept: a new one deletes the + * file of the session SP1_STORE_LOG_KEEP before it. */ +#define LOG_SESSION DIR_LOGS "/SESSION" +#define LOG_NAMES 10000u +#define LOG_SUMMARY_MS 60000u + +static atomic_t log_live_a; /* main reads it: sp1_store_log_live() */ +static bool log_live; /* the file is open, the card on and mounted */ +static bool session_open; /* this boot has opened (or started) its file */ +static uint32_t session_n; /* ...and its session number */ +static char log_path[sizeof(DIR_LOGS) + 16]; +static struct fs_file_t log_f; +static uint32_t log_size; +static bool log_full; +static uint32_t log_next; /* uptime of the next flush */ +static bool piece_cont; /* the last piece taken ended mid-line... */ +static bool piece_keep; /* ...and was (not) for the file */ +static char piece[SP1_LOGBUF_TAKE_MAX]; +/* What goes to the card: the ring is never handed to the disk directly, both because + * printk keeps writing it and because of nRF52840 anomaly 198 (SPIM3's DMA source). */ +static char stage[1024]; +static uint32_t sum_t0, sum_flushes, sum_bytes, sum_max_ms, sum_lost; + +static void log_name(uint32_t n, char *buf, size_t size) +{ + snprintk(buf, size, DIR_LOGS "/%04u.LOGS", (unsigned)(n % LOG_NAMES)); +} + +/* WAKES/LOGS/SESSION: the last session's number. false if it is missing or not a number. */ +static bool log_read_session(uint32_t *n) +{ + char t[16]; + size_t got = 0u; + if (read_file(LOG_SESSION, t, sizeof(t) - 1u, &got) != 0) { + return false; + } + uint32_t v = 0u; + size_t i = 0u; + while (i < got && (t[i] == ' ' || t[i] == '\t')) { + i++; + } + const size_t start = i; + for (; i < got && t[i] >= '0' && t[i] <= '9' && v < 429496729u; i++) { + v = v * 10u + (uint32_t)(t[i] - '0'); + } + if (i == start) { + return false; + } + *n = v; + return true; +} + +static int log_put(const char *d, size_t n) +{ + const ssize_t w = fs_write(&log_f, d, n); + if (w != (ssize_t)n) { + return w < 0 ? (int)w : -EIO; + } + log_size += (uint32_t)n; + return 0; +} + +/* Into the file through the size cap: past it, one last line and nothing more this session. */ +static int log_write(const char *d, size_t n) +{ + if (log_full || n == 0u) { + return 0; + } + static const char full[] = "=== LOG FULL at 8 MB: the rest of this session is not on the " + "drive (the console still has it) ===\n"; + if (log_size + n + sizeof(full) > SP1_STORE_LOG_MAX) { + log_full = true; + return log_put(full, sizeof(full) - 1u); + } + return log_put(d, n); +} + +/* The volume mounted, at the end of the ON job: open this session's file. The first time this + * boot, a NEW session -- the next number -- unless the boot carries on a log kept across a + * soft reset (the same session: the crash and what led to it stay in one file). Later ONs of + * the same boot carry on too. */ +static int log_open(void) +{ + int rc = ensure_dir(DIR_WAKES); + if (rc == 0) { + rc = ensure_dir(DIR_LOGS); + } + if (rc != 0) { + return rc; + } + uint32_t last = 0u; + const bool known = log_read_session(&last); + bool fresh_session = false; + if (!session_open) { + if (sp1_logbuf_continued() && known) { + session_n = last; /* a soft reset: the same session */ + } else { + session_n = known ? last + 1u : 1u; + fresh_session = true; + } + } + log_name(session_n, log_path, sizeof(log_path)); + if (fresh_session) { + char t[16]; + const int n = snprintk(t, sizeof(t), "%u\n", (unsigned)session_n); + rc = write_file(LOG_SESSION, t, (size_t)n); + if (rc != 0) { + return rc; + } + /* A file already under this name is from a session 10000 back (or a lost + * counter): this session starts it afresh. */ + (void)fs_unlink(log_path); + if (session_n > SP1_STORE_LOG_KEEP) { + char old[sizeof(log_path)]; + log_name(session_n - SP1_STORE_LOG_KEEP, old, sizeof(old)); + const int urc = fs_unlink(old); + if (urc != 0 && urc != -ENOENT) { + LINE("LOG could not delete %s (%d)\n", old + sizeof(DIR_LOGS), urc); + } + } + } + fs_file_t_init(&log_f); + rc = fs_open(&log_f, log_path, FS_O_CREATE | FS_O_WRITE | FS_O_APPEND); + if (rc != 0) { + return rc; + } + rc = fs_seek(&log_f, 0, FS_SEEK_END); + const off_t at = (rc == 0) ? fs_tell(&log_f) : -1; + if (at < 0) { + (void)fs_close(&log_f); + return rc != 0 ? rc : (int)at; + } + log_size = (uint32_t)at; + log_full = log_size >= SP1_STORE_LOG_MAX; + piece_cont = false; + if (fresh_session || log_size == 0u) { + char h[160]; + const int n = snprintk(h, sizeof(h), "=== Wakes v" APP_VERSION_STRING ", built %s %s -- " + "log session %u -- resetreas 0x%08x ===\n", __DATE__, __TIME__, + (unsigned)session_n, sp1_logbuf_resetreas()); + rc = log_write(h, (size_t)n); + if (rc != 0) { + (void)fs_close(&log_f); + return rc; + } + } + session_open = true; + log_live = true; + atomic_set(&log_live_a, 1); + LINE("LOG %s %u: WAKES/LOGS/%s (%u KB)\n", fresh_session ? "new session" : "carrying on session", + (unsigned)session_n, log_path + sizeof(DIR_LOGS), (unsigned)(log_size / 1024u)); + return 0; +} + +/* Lines a filtered category leaves out; a long line's later pieces follow its first. */ +static bool keep_piece(const char *d, size_t n) +{ + bool keep; + if (piece_cont) { + keep = piece_keep; + } else { + const uint8_t c = sp1_log_category(d, n); + keep = (c == 0u) || (logs_cfg.cats & c) != 0u; + } + piece_cont = d[n - 1u] != '\n'; + piece_keep = keep; + return keep; +} + +/* Everything new in the RAM log, into the file, then synced: the file's size on the card is + * then current, so a cut-off loses only what came after. */ +static int log_flush(void) +{ + const uint32_t t0 = k_uptime_get_32(); + size_t used = 0u; + uint32_t written = 0u; + int rc = 0; + for (;;) { + uint32_t lost = 0u; + const size_t n = sp1_logbuf_file_take(piece, sizeof(piece), &lost); + if (lost > 0u) { + sum_lost += lost; + char m[112]; + const int k = snprintk(m, sizeof(m), "=== LOG: %u bytes lost here -- the RAM log " + "filled before the drive took them ===\n", + (unsigned)lost); + if (used + (size_t)k > sizeof(stage)) { + rc = log_write(stage, used); + written += (uint32_t)used; + used = 0u; + } + memcpy(stage + used, m, (size_t)k); + used += (size_t)k; + piece_cont = false; + } + if (n == 0u || rc != 0 || stop) { + break; + } + if (!keep_piece(piece, n)) { + continue; + } + if (used + n > sizeof(stage)) { + rc = log_write(stage, used); + written += (uint32_t)used; + used = 0u; + if (rc != 0) { + break; + } + } + memcpy(stage + used, piece, n); + used += n; + } + if (rc == 0 && used > 0u) { + rc = log_write(stage, used); + written += (uint32_t)used; + } + if (rc == 0 && written > 0u) { + rc = fs_sync(&log_f); + } + const uint32_t ms = k_uptime_get_32() - t0; + sum_flushes++; + sum_bytes += written; + if (ms > sum_max_ms) { + sum_max_ms = ms; + } + return stop ? -ECANCELED : rc; +} + +/* Close the file and let go of the card: unmount, power down, nobody owns it. */ +static void log_finish(void) +{ + if (log_live) { + (void)fs_close(&log_f); + log_live = false; + } + unmount_vol(); + if (!stop) { + sp1_emmc_power_down(); + } + atomic_set(&owner, OWN_NONE); + atomic_set(&log_live_a, 0); +} + +/* After sp1_store_abort: the card is already off and nobody owns it, so closing the file + * cannot write (every disk call checks the owner); it frees the file and the volume. */ +static void log_teardown(void) +{ + torn = false; + if (log_live) { + (void)fs_close(&log_f); + log_live = false; + } + unmount_vol(); + atomic_set(&log_live_a, 0); +} + +/* Every SP1_STORE_LOG_FLUSH_MS while ON, and once a minute the LOG line. */ +static void log_tick(void) +{ + const uint32_t now = k_uptime_get_32(); + if ((int32_t)(now - log_next) < 0) { + return; + } + log_next = ((int32_t)(now - log_next) > (int32_t)SP1_STORE_LOG_FLUSH_MS) + ? now + SP1_STORE_LOG_FLUSH_MS : log_next + SP1_STORE_LOG_FLUSH_MS; + const int rc = log_flush(); + if (rc != 0) { + if (!stop) { + LINE("LOG off: writing %s failed (%d) -- no more log on the drive " + "until the next ON; the console still has it\n", + log_path + sizeof(DIR_LOGS), rc); + log_finish(); + } + return; + } + if (now - sum_t0 >= LOG_SUMMARY_MS) { + LINE("LOG %u s: %u flushes, %u B written, longest %u ms, %u B lost; log file %u KB%s\n", + (unsigned)((now - sum_t0) / 1000u), (unsigned)sum_flushes, (unsigned)sum_bytes, + (unsigned)sum_max_ms, (unsigned)sum_lost, (unsigned)(log_size / 1024u), + log_full ? " (full)" : ""); + sum_t0 = now; + sum_flushes = sum_bytes = sum_max_ms = sum_lost = 0u; + } +} + +/* The end of an ON session, after any save: the last lines, then let go of the card. */ +static void log_end(void) +{ + if (!log_live) { + return; + } + const uint32_t t0 = k_uptime_get_32(); + LINE("LOG closing %s (%u KB)\n", log_path + sizeof(DIR_LOGS), + (unsigned)(log_size / 1024u)); + const int rc = log_flush(); + log_finish(); + if (rc != 0 && !stop) { + LINE("LOG the last flush FAILED (%d) after %u ms\n", rc, + (unsigned)(k_uptime_get_32() - t0)); + } +} + /* ---------------------------------------------------------------- fresh */ #if defined(CONFIG_SP1_FRESH) @@ -353,6 +876,9 @@ static int format_card(void) * ("block writes against ... expected"); it only scales the progress bar. */ fmt_expected += 5u * 64u + 5u * 4u; #endif + /* + WAKES/CNFG (#52): its directory cluster, logs.cnfg and engines.cnfg (~14 KB, 28 + * blocks), the same estimate. */ + fmt_expected += 64u + 4u + 32u; fmt_written = 0u; atomic_set(&progress, 0); counting = true; @@ -465,6 +991,10 @@ static void fresh(void) rc = prst_write_defaults(); } #endif + if (rc == 0) { + /* #52 (Adara): the config files, for users to edit on the drive. */ + rc = cnfg_write_templates(); + } if (rc == 0) { /* The stamp goes LAST: if anything before it failed, the next ON * formats again. */ @@ -765,30 +1295,6 @@ static void prst_load_all(void) LINE("STORE PRST on: slot %d current\n", prst_current + 1); } -/* Verify `path` is a FOLDER; create it if nothing is there (Adara, #50). 0 when there is a - * folder to save into. Something else with that name -- a computer can leave a FILE called - * "3" where slot 3's folder should be -- is -ENOTDIR and is left alone: the save fails with - * that in the log rather than touching a file it did not write. */ -static int ensure_dir(const char *path) -{ - static struct fs_dirent st; - int rc = fs_stat(path, &st); - if (rc == 0) { - if (st.type == FS_DIR_ENTRY_DIR) { - return 0; - } - LINE("STORE PRST: %s is a file, not a folder -- not saving there\n", path); - return -ENOTDIR; - } - if (rc != -ENOENT) { - return rc; - } - rc = fs_mkdir(path); - LINE("STORE PRST: no folder %s -- %s (%d)\n", path, rc == 0 ? "created" : "create FAILED", - rc); - return rc; -} - #if defined(CONFIG_SP1_FRESH) /* wakes-sp1-fresh, right after its format (Adara, #50): WAKES/PRST/1..4, each holding N.prst * with the ROTC default patch, and SLOT = 1. Before the stamp, so a failure here formats @@ -821,20 +1327,24 @@ static int prst_write_defaults(void) } #endif -/* The save, at shutdown. The card was powered down after the ON job, so it starts again. */ +/* The save, at shutdown. With the log on (#52) the card is still on and mounted from the ON + * job; otherwise it was powered down after it, and starts again. */ static void job_save(void) { static char tmp[PATH_MAX_]; static char dst[PATH_MAX_]; const uint32_t t0 = k_uptime_get_32(); const int i = save_slot; - claim_for_wakes(); - struct sp1_emmc_ident id; - int rc = sp1_emmc_init(&id) ? 0 : -EIO; - view_base = 0; - view_count = sp1_emmc_sectors(); - if (rc == 0 && !stop) { - rc = mount_vol(); + int rc = 0; + if (!log_live) { + claim_for_wakes(); + struct sp1_emmc_ident id; + rc = sp1_emmc_init(&id) ? 0 : -EIO; + view_base = 0; + view_count = sp1_emmc_sectors(); + if (rc == 0 && !stop) { + rc = mount_vol(); + } } snprintk(tmp, sizeof(tmp), DIR_PRST "/%d", i + 1); if (rc == 0 && !stop) { @@ -864,17 +1374,23 @@ static void job_save(void) if (stop && rc == 0) { rc = -ECANCELED; } - unmount_vol(); - if (!stop) { - sp1_emmc_power_down(); - } - atomic_set(&owner, OWN_NONE); if (rc == 0) { prst_current = i; } LINE("STORE PRST save slot %d -> %s: %s (%d) in %u ms\n", i + 1, prst_name[i], rc == 0 ? "done" : "FAILED", rc, (unsigned)(k_uptime_get_32() - t0)); atomic_set(&save_state, rc == 0 ? SP1_STORE_SAVE_OK : SP1_STORE_SAVE_FAILED); + /* Then the log's last lines (Adara: the save first, the log in the time left); main + * waits for sp1_store_log_live() to drop. */ + if (log_live) { + log_end(); + } else { + unmount_vol(); + if (!stop) { + sp1_emmc_power_down(); + } + atomic_set(&owner, OWN_NONE); + } } #endif /* CONFIG_SP1_PLAITS */ @@ -903,6 +1419,10 @@ static void claim_for_wakes(void) static void job_on_enter(void) { const uint32_t t0 = k_uptime_get_32(); + if (log_live) { + log_teardown(); /* never expected: every way out of ON closes the log */ + } + cnfg_defaults(); /* until (unless) the drive's files say otherwise (#52) */ claim_for_wakes(); struct sp1_emmc_ident id; const bool ok = sp1_emmc_init(&id); /* a fresh start whoever had the card */ @@ -946,6 +1466,10 @@ static void job_on_enter(void) "written; wakes-sp1-fresh creates one\n", rc); } } + /* #52: the config files, every ON, before PRST and before audio. */ + if (rc == 0 && !stop) { + cnfg_load(); + } #if defined(CONFIG_SP1_PLAITS) /* PRST (#50): all four slots into RAM, before main starts audio. */ if (rc == 0 && !stop) { @@ -961,6 +1485,28 @@ static void job_on_enter(void) sp1_emmc_report_stats(); #endif } + /* #52: with logging on, the card stays on and mounted for the whole ON session (Adara) + * and the log is written every SP1_STORE_LOG_FLUSH_MS; every way out of ON lets go of + * it (log_end at shutdown, log_teardown after sp1_store_abort). Off: as before. */ + if (ok && !stop && atomic_get(&vol_state) == SP1_STORE_VOL_OK) { + if (!logs_cfg.enabled) { + sp1_logbuf_file_skip(); + } else { + const int lrc = log_open(); + if (lrc != 0 && !stop) { + LINE("LOG off: the log file in WAKES/LOGS/ cannot be opened (%d) -- no log on " + "the drive this ON\n", lrc); + } + } + } + if (log_live) { + LINE("STORE done after %u ms -- the eMMC stays on for the log\n", + (unsigned)(k_uptime_get_32() - t0)); + sum_t0 = k_uptime_get_32(); + sum_flushes = sum_bytes = sum_max_ms = sum_lost = 0u; + log_next = sum_t0; /* the first flush now: the boot so far */ + return; + } unmount_vol(); if (!stop) { sp1_emmc_power_down(); @@ -971,6 +1517,12 @@ static void job_on_enter(void) (unsigned)(k_uptime_get_32() - t0)); } +/* Shutdown with PRST off but the log on: only the log's last lines. */ +static void job_log_end(void) +{ + log_end(); +} + #if defined(CONFIG_SP1_DRIVE) /* STANDBY with a host attached: power the card and, if it holds a filesystem, hand it to * the host until ON (claim_for_wakes) or power-off (sp1_store_abort). A card WITHOUT one @@ -978,6 +1530,9 @@ static void job_on_enter(void) * which Wakes cannot read), and only wakes-sp1-fresh formats (Adara). */ static void job_host(void) { + if (log_live) { + log_teardown(); /* never expected: STANDBY comes after a closed log */ + } k_mutex_lock(&card_lock, K_FOREVER); struct sp1_emmc_ident id; const bool ok = !stop && sp1_emmc_init(&id); @@ -1023,7 +1578,16 @@ static void store_thread(void *a, void *b, void *c) ARG_UNUSED(b); ARG_UNUSED(c); for (;;) { - k_sem_take(&go, K_FOREVER); + /* With the log on, wake for its next flush (#52); otherwise only for a job. */ + k_timeout_t to = K_FOREVER; + if (log_live) { + const int32_t left = (int32_t)(log_next - k_uptime_get_32()); + to = left > 0 ? K_MSEC(left) : K_NO_WAIT; + } + (void)k_sem_take(&go, to); + if (torn) { + log_teardown(); + } for (;;) { const atomic_val_t jobs = atomic_get(&pending); if (jobs & JOB_ON) { /* ON always wins: Wakes takes the card */ @@ -1034,6 +1598,9 @@ static void store_thread(void *a, void *b, void *c) atomic_and(&pending, ~JOB_SAVE); job_save(); #endif + } else if (jobs & JOB_LOGEND) { + atomic_and(&pending, ~JOB_LOGEND); + job_log_end(); } else if (jobs & JOB_HOST) { atomic_and(&pending, ~JOB_HOST); #if defined(CONFIG_SP1_DRIVE) @@ -1042,6 +1609,9 @@ static void store_thread(void *a, void *b, void *c) } else { break; } + if (torn) { + log_teardown(); + } #if defined(CONFIG_SP1_STORAGE_TEST) size_t unused = 0; if (k_thread_stack_space_get(k_current_get(), &unused) == 0) { @@ -1051,6 +1621,9 @@ static void store_thread(void *a, void *b, void *c) } #endif } + if (log_live && !torn) { + log_tick(); + } } } @@ -1169,10 +1742,26 @@ enum sp1_store_save sp1_store_save_result(void) } #endif +bool sp1_store_log_live(void) +{ + return atomic_get(&log_live_a) != 0; +} + +void sp1_store_log_end(void) +{ + if (atomic_get(&log_live_a) != 0) { + atomic_or(&pending, JOB_LOGEND); + k_sem_give(&go); + } +} + void sp1_store_abort(void) { stop = true; + torn = true; /* the thread lets go of the log file and the volume */ atomic_clear(&pending); atomic_set(&owner, OWN_NONE); + atomic_set(&log_live_a, 0); /* nothing to wait for: the card is going off now */ sp1_emmc_abort(); + k_sem_give(&go); } diff --git a/firmware/src/sp1_store.h b/firmware/src/sp1_store.h index 376aecf..b339f7c 100644 --- a/firmware/src/sp1_store.h +++ b/firmware/src/sp1_store.h @@ -31,6 +31,7 @@ #ifndef SP1_STORE_H #define SP1_STORE_H +#include #include /* Once at boot, before any other call: registers the disk and starts the thread. */ @@ -147,6 +148,33 @@ enum sp1_store_save { enum sp1_store_save sp1_store_save_result(void); #endif +/* ---- the config files and the log (#52) ---- + * CONFIG: WAKES/CNFG/.cnfg, read by the ON job every ON, after the volume check and + * before PRST (sp1_cnfg.h has the rules): logs.cnfg (line by line) and engines.cnfg (all + * or nothing: any problem -> the built-in stack). No volume -> the built-in everything. + * + * THE LOG (Adara, #52): with logs.cnfg's `enabled = on` (the default) the ON job opens this + * session's file in WAKES/LOGS/ and the card STAYS on and mounted for the whole ON session; + * every SP1_STORE_LOG_FLUSH_MS the thread appends what the RAM log (sp1_logbuf.h) has + * gathered, filtered by logs.cnfg's categories, and syncs. One file per session, NNNN.LOGS = + * the session number mod 10000 (9999.LOGS is followed by 0000.LOGS); the number keeps + * counting in WAKES/LOGS/SESSION. A new session -- the first ON after a power-on from OFF -- + * takes the next number and deletes the file SP1_STORE_LOG_KEEP sessions back; a boot that + * carries on a RAM log kept across a soft reset is the same session and appends. Each file stops at SP1_STORE_LOG_MAX + * with a last line saying so. STANDBY is not logged. A LOG line once a minute gives the + * flushes, bytes and the longest flush (the CPU check Adara asked for). + * At shutdown the PRST save goes first, then the last lines (main waits on + * sp1_store_log_live(), inside the same 4 s). The 30 s backstop never waits for either + * (rule 5a): sp1_store_abort cuts the card off, and the unsynced tail is lost. */ +#define SP1_STORE_LOG_FLUSH_MS 5000u +#define SP1_STORE_LOG_MAX (8u * 1024u * 1024u) +#define SP1_STORE_LOG_KEEP 5u /* sessions kept, this one included (Adara) */ + +/* The log file is open: the card is on for it. Cleared once it is closed and the card is off. */ +bool sp1_store_log_live(void); +/* Main, at shutdown when no PRST save is queued: the log's last lines, then the card off. */ +void sp1_store_log_end(void); + /* From sp1_quiesce_peripherals(), on every way out of ON and out of STANDBY: stop the job, * take the card from a host, drop queued jobs, and power the card down now. A job cut short by this fails its remaining steps; a format cut short * leaves no FRESH.ID, so the fresh image formats again at the next ON. Never waits. */ diff --git a/firmware/src/sp1_synth.h b/firmware/src/sp1_synth.h index 89379d2..13b85f2 100644 --- a/firmware/src/sp1_synth.h +++ b/firmware/src/sp1_synth.h @@ -43,7 +43,7 @@ extern "C" { /* Engine the voice is constructed with, before the UI publishes its first parameters * (plaits/dsp/voice.cc order): virtual analog. Only a placeholder: the UI starts on the - * first filled slot of config/engines.csv, whatever that is, and publishes it before the + * first filled slot of config/engines.cnfg, whatever that is, and publishes it before the * first block. */ #define SP1_SYNTH_ENGINE_INITIAL 8 diff --git a/firmware/src/sp1_ui_timing.h b/firmware/src/sp1_ui_timing.h index 8887a40..6899fcb 100644 --- a/firmware/src/sp1_ui_timing.h +++ b/firmware/src/sp1_ui_timing.h @@ -266,7 +266,7 @@ * shorter one was hard to read). A sweep restarts it at each change, as scrolling T2/T3 does. */ #define SP1_DISP_ENGINE_HOLD_MS 700u /* pattern shown solid (Adara: 0.7 s) */ #define SP1_DISP_ENGINE_FADE_MS 350u /* then cross-fades into the page */ -/* ---- an engine OFF the engines.csv list (#50, Adara) ---- +/* ---- an engine OFF the engines.cnfg list (#50, Adara) ---- * It has no glyph (glyphs belong to list positions), so its flash is an animation: all four * face LEDs ramp down from 70 % to 0 every SP1_OFFLIST_RAMP_MS, for the same * SP1_DISP_ENGINE_HOLD_MS, then the same fade. 70 % rather than full because of the flash diff --git a/tools/gen_engines.py b/tools/gen_engines.py index c0a4e9e..36966f2 100644 --- a/tools/gen_engines.py +++ b/tools/gen_engines.py @@ -1,29 +1,29 @@ #!/usr/bin/env python3 -"""wakes-sp1 -- generate the firmware's engine table from config/engines.csv. +"""wakes-sp1 -- generate the firmware's engine table from config/engines.cnfg. - gen_engines.py build step (CMake runs this) + gen_engines.py build step (CMake runs this) gen_engines.py --list print every engine a config may name Two inputs, deliberately kept apart: - config/engines.csv the USER's choice: which engine sits in which slot. One row per - slot, at most 24, in slot order -- ROW POSITION is the slot. - Columns Slot, Glyph, Engine. Only Engine is the user's: Slot and - Glyph are printed there so the file reads as the device does, and - the build checks they are unchanged. An empty Engine is an empty - slot, which T2/T3 engine select skips. + config/engines.cnfg the DEFAULT engine stack (ini, #52): `slot = engine` under [engines], + slots 1-24. The file is the whole stack: a slot it does not list, or + lists with no name (or `none`), is empty, and T2/T3 skip it. Each + line may carry the slot's glyph as a comment; the build checks it. this file FACTS the user cannot choose: each slot's glyph (SLOT_GLYPHS) and each engine's index inside Plaits and centre detents (PLAITS_ENGINES, keyed by name). -Glyphs are four symbols, T1 first: U+25CF full, U+25D0 half, U+25CB off. The CSV may -also spell them # + . -- editors and spreadsheets sometimes mangle the circles. +Glyphs are four symbols, T1 first: U+25CF full, U+25D0 half, U+25CB off (or # + .). -Standard library only. The CSV is read as UTF-8 (with or without a BOM, which Excel -writes): Windows' default code page would mangle the glyphs. +The build fails, naming the line, on anything wrong in the default: the repository's copy +must be exactly right. (The device's own reader of the drive's copy, when it comes, keeps +going instead -- sp1_cnfg.h's rules.) + +Standard library only. Read as UTF-8, with or without a BOM. """ -import csv import os +import re import sys # ---- facts: NOT user configuration ------------------------------------------------------- @@ -44,29 +44,29 @@ # (SP1_ENGINE_TABLE[].centre). The reasoning for each is in docs/PLAITS-ENGINES.md, "Why # these detents". Change these only when Plaits itself changes. PLAITS_ENGINES = [ - (0, "VA + VCF", "F3 F4"), - (1, "phase distortion", ""), - (2, "6-op FM A", "F3"), - (3, "6-op FM B", "F3"), - (4, "6-op FM C", "F3"), - (5, "wave terrain", "F3"), - (6, "string machine", "F2"), + (0, "VA-VCF", "F3 F4"), + (1, "phase-distortion", ""), + (2, "6-op-FM-A", "F3"), + (3, "6-op-FM-B", "F3"), + (4, "6-op-FM-C", "F3"), + (5, "wave-terrain", "F3"), + (6, "string-machine", "F2"), (7, "chiptune", ""), - (8, "virtual analog", "F2 F4"), + (8, "virtual-analog", "F2 F4"), (9, "waveshaping", "F4"), - (10, "2-op FM", "F3"), - (11, "grain / formant", "F4"), + (10, "2-op-FM", "F3"), + (11, "grain-formant", "F4"), (12, "additive", ""), (13, "wavetable", ""), (14, "chords", ""), (15, "speech", ""), (16, "swarm", ""), - (17, "filtered noise", "F4"), + (17, "filtered-noise", "F4"), (18, "particle", "F3"), (19, "string", ""), (20, "modal", ""), - (21, "bass drum", ""), - (22, "snare drum", ""), + (21, "bass-drum", ""), + (22, "snare-drum", ""), (23, "hi-hat", ""), ] DETENT_BITS = {"F4": 0x1, "F2": 0x2, "F3": 0x4} # HARMONICS, TIMBRE, MORPH @@ -75,12 +75,12 @@ GLYPH_LEVEL = {"○": 0, ".": 0, "◐": 1, "+": 1, "●": 2, "#": 2} ASCII_GLYPH = {ord("●"): "#", ord("◐"): "+", ord("○"): "."} -COLUMNS = ("slot", "glyph", "engine") -CSV_NAME = "config/engines.csv" +CNFG_NAME = "config/engines.cnfg" +LINE_MAX = 160 # SP1_CNFG_LINE_MAX: the device ignores longer lines def fail(msg): - msg = "\n*** %s: %s\n\n" % (CSV_NAME, msg) + msg = "\n*** %s: %s\n\n" % (CNFG_NAME, msg) try: msg.encode(sys.stderr.encoding or "ascii") except UnicodeEncodeError: @@ -98,6 +98,13 @@ def levels(glyph): return [GLYPH_LEVEL[ch] for ch in syms] +def name_key(name): + """How names are compared, here and on the device (sp1_cnfg.h, sp1_engine_name_eq): + letters and digits only, case ignored -- so "grain / formant", "grain-formant" and + "Grain Formant" are one engine, and a PRST file saved under an older spelling loads.""" + return "".join(ch for ch in name.lower() if ch.isascii() and ch.isalnum()) + + def facts(): assert len({tuple(levels(g)) for g in SLOT_GLYPHS}) == MAX_SLOTS, "slot glyphs must differ" by_name = {} @@ -105,59 +112,74 @@ def facts(): bits = 0 for d in det.split(): bits |= DETENT_BITS[d] - by_name[name.lower()] = dict(plaits=idx, name=name, centre=bits) - assert sorted(e["plaits"] for e in by_name.values()) == list(range(24)) + by_name[name_key(name)] = dict(plaits=idx, name=name, centre=bits) + assert sorted(e["plaits"] for e in by_name.values()) == list(range(24)), "names must differ" return by_name -def parse(csv_path): - known = facts() - with open(csv_path, encoding="utf-8-sig", newline="") as f: - rows = [(n + 1, r) for n, r in enumerate(csv.reader(f)) if r] - if not rows: - fail("the file is empty") - header = [c.strip().lower() for c in rows[0][1]] - if tuple(header[:3]) != COLUMNS: - fail("line %d: the first row must be the header Slot,Glyph,Engine -- got %s" - % (rows[0][0], ",".join(rows[0][1]))) - rows = rows[1:] - if len(rows) > MAX_SLOTS: - fail("%d slots listed; there are at most %d" % (len(rows), MAX_SLOTS)) - - slots, used = [], {} - for n, (line, r) in enumerate(rows): - slot = n + 1 - r = [c.strip() for c in r] + [""] * 3 - slot_t, glyph_t, name_t = r[:3] - where = "line %d (slot %d)" % (line, slot) - # Slot and Glyph are labels, not settings: row position is the slot, and the - # glyph belongs to the slot. A mismatch means a whole row was moved, or edited. - if slot_t != str(slot): - fail("%s: the Slot column says %r, but this is row %d, so slot %d.\n" - " Row position is the slot and cannot be changed. To reorder, move the\n" - " Engine names between rows, not whole rows." % (where, slot_t, slot, slot)) - want = SLOT_GLYPHS[n] - got = levels(glyph_t) - if got != levels(want): - hint = ("" if got is not None else - "\n If the circles came out as '?' or garbage, your editor saved in the" - "\n wrong encoding: save as UTF-8, or write the glyph as `%s`." - % want.translate(ASCII_GLYPH)) - fail("%s: slot %d's glyph is %s and cannot be changed -- the file says `%s`.%s" - % (where, slot, want, glyph_t, hint)) - entry = dict(slot=slot, levels=levels(want), on=False, plaits=0, centre=0, name="") - if name_t: - e = known.get(name_t.lower()) - if e is None: - fail("%s: no engine is called %r. Available engines:\n %s" - % (where, name_t, "\n ".join(n for _, n, _ in PLAITS_ENGINES))) - if e["name"] in used: - fail("%s: %s is already in slot %d; an engine can be listed once" - % (where, e["name"], used[e["name"]])) - used[e["name"]] = slot - entry.update(e, on=True) - slots.append(entry) +def ini_lines(path): + """(line number, key, value, comment) for every setting, split the way the device's + reader splits them (sp1_cnfg.c): ; or # at the value's start or after whitespace starts + a comment.""" + with open(path, encoding="utf-8-sig") as f: + lines = f.read().split("\n") + if not lines[0].lstrip().startswith(";"): + fail('line 1: the file must start with a comment naming its format ("; Format: ini")') + section, out = "", [] + for n, raw in enumerate(lines, 1): + if len(raw.rstrip("\r").encode("utf-8")) > LINE_MAX: + fail("line %d is over %d bytes: the device would ignore it" % (n, LINE_MAX)) + s = raw.strip() + if not s or s[0] in ";#": + continue + if s[0] == "[": + if not s.endswith("]"): + fail("line %d: a section name needs a closing ]" % n) + section = s[1:-1].strip().lower() + if section != "engines": + fail("line %d: unknown section [%s] (expected [engines])" % (n, section)) + continue + if not section: + fail("line %d: %r is not under [engines]" % (n, s)) + if "=" not in s: + fail("line %d: %r is not a setting (slot = engine)" % (n, s)) + key, val = s.split("=", 1) + m = re.search(r"(^|\s)[;#]", val) + comment = val[m.end():].strip() if m else "" + val = (val[:m.start()] if m else val).strip() + out.append((n, key.strip().lower(), val, comment)) + return out + +def parse(path): + known = facts() + slots = [dict(slot=n + 1, levels=levels(g), on=False, plaits=0, centre=0, name="") + for n, g in enumerate(SLOT_GLYPHS)] + seen, used = {}, {} + for line, key, val, comment in ini_lines(path): + where = "line %d" % line + if not key.isdigit() or not 1 <= int(key) <= MAX_SLOTS: + fail("%s: %r is not a slot (1-%d)" % (where, key, MAX_SLOTS)) + slot = int(key) + if slot in seen: + fail("%s: slot %d is already set on line %d" % (where, slot, seen[slot])) + seen[slot] = line + want = SLOT_GLYPHS[slot - 1] + if comment and levels(comment) is not None and levels(comment) != levels(want): + fail("%s: slot %d's glyph is %s; the comment says %s. The glyph belongs to the\n" + " slot: move engine NAMES between slots, not whole lines with their glyphs." + % (where, slot, want, comment)) + if not val or val.lower() == "none": + continue + e = known.get(name_key(val)) + if e is None: + fail("%s: no engine is called %r. Available engines:\n %s" + % (where, val, "\n ".join(n for _, n, _ in PLAITS_ENGINES))) + if e["name"] in used: + fail("%s: %s is already in slot %d; an engine can be listed once" + % (where, e["name"], used[e["name"]])) + used[e["name"]] = slot + slots[slot - 1].update(e, on=True) if not used: fail("every slot is empty; the firmware needs at least one engine") return slots @@ -168,13 +190,13 @@ def c_str(s): return '"' + s.replace("\\", "\\\\").replace('"', '\\"') + '"' -def generate(csv_path, out_path): - slots = parse(csv_path) +def generate(path, out_path): + slots = parse(path) # The device starts on the first slot with an engine in it (M4, Adara: slot 1 by default). default = next(n for n, s in enumerate(slots) if s["on"]) out = [ - "/* GENERATED from config/engines.csv by tools/gen_engines.py.", - " * Do not edit: edit the CSV and rebuild. */", + "/* GENERATED from config/engines.cnfg by tools/gen_engines.py.", + " * Do not edit: edit config/engines.cnfg and rebuild. */", "#ifndef SP1_ENGINES_GEN_H", "#define SP1_ENGINES_GEN_H", "", @@ -183,6 +205,12 @@ def generate(csv_path, out_path): "#define SP1_ENGINE_SLOTS %d" % len(slots), "#define SP1_ENGINE_DEFAULT_SLOT %d /* the first slot with an engine */" % default, "", + "/* The built-in stack as Plaits indices, 255 = an empty slot: the initialiser of the", + " * RAM stack that WAKES/CNFG/engines.cnfg replaces at ON (sp1_plaits_ui.c, #52). */", + "#define SP1_ENGINE_EMPTY 255u", + "#define SP1_ENGINE_DEFAULT_STACK { %s }" % ", ".join( + str(s["plaits"]) if s["on"] else "255" for s in slots), + "", "/* on: 0 = an empty slot, which engine select skips", " * centre: 0x1 = F4 HARMONICS, 0x2 = F2 TIMBRE, 0x4 = F3 MORPH", " * led: T1..T4, 0 = off, 1 = half, 2 = full (the slot's fixed glyph) */", @@ -199,8 +227,8 @@ def generate(csv_path, out_path): % ((s["plaits"], int(s["on"]), s["centre"]) + tuple(s["levels"]) + (c_str(s["name"]), s["slot"]))) # Every engine in the build, listed or not, by its Plaits index (#50): a PRST slot may - # name an engine that is not in this CSV, and the firmware plays it -- every build - # contains all of Plaits' engines; the CSV only chooses which ones T2/T3 reach. + # name an engine that is not in the stack, and the firmware plays it -- every build + # contains all of Plaits' engines; engines.cnfg only chooses which ones T2/T3 reach. by_idx = sorted(facts().values(), key=lambda e: e["plaits"]) out += ["};", "", "#define SP1_PLAITS_ENGINE_COUNT %d" % len(by_idx), "", @@ -211,7 +239,30 @@ def generate(csv_path, out_path): "} SP1_PLAITS_ENGINES[SP1_PLAITS_ENGINE_COUNT] = {"] for e in by_idx: out.append("\t{ 0x%x, %s }, /* plaits %2d */" % (e["centre"], c_str(e["name"]), e["plaits"])) - out += ["};", "", "#endif /* SP1_ENGINES_GEN_H */", ""] + out += ["};", ""] + # #52: the file itself, for wakes-sp1-fresh to write to WAKES/CNFG/engines.cnfg. + with open(path, encoding="utf-8-sig") as f: + template = f.read().replace("\r\n", "\n") + out += ["#if defined(SP1_CNFG_TEMPLATES)", + "static const char SP1_ENGINES_TEMPLATE[] ="] + for ln in template.splitlines(keepends=True): + lit = "" + for b in ln.encode("utf-8"): + ch = chr(b) + if ch == "\\": + lit += "\\\\" + elif ch == '"': + lit += '\\"' + elif ch == "\n": + lit += "\\n" + elif ch == "\t": + lit += "\\t" + elif 0x20 <= b < 0x7F: + lit += ch + else: + lit += "\\%03o" % b + out.append('\t"%s"' % lit) + out += ["\t;" if template else '\t"";', "#endif", "", "#endif /* SP1_ENGINES_GEN_H */", ""] text = "\n".join(out) os.makedirs(os.path.dirname(os.path.abspath(out_path)), exist_ok=True) try: @@ -230,7 +281,7 @@ def generate(csv_path, out_path): for idx, name, det in PLAITS_ENGINES: print("%-18s Plaits #%-2d detents %s" % (name, idx, det or "-")) elif len(a) == 2: - CSV_NAME = os.path.normpath(a[0]) + CNFG_NAME = os.path.normpath(a[0]) generate(a[0], a[1]) else: sys.stderr.write(__doc__) diff --git a/tools/gen_logs.py b/tools/gen_logs.py new file mode 100644 index 0000000..5c1e6ad --- /dev/null +++ b/tools/gen_logs.py @@ -0,0 +1,144 @@ +#!/usr/bin/env python3 +"""wakes-sp1 -- the built-in logging defaults, from config/logs.cnfg (#52). + + gen_logs.py build step (CMake runs this) + +config/logs.cnfg is the DEFAULT: what Wakes does when the drive has no WAKES/CNFG/logs.cnfg, +or a line in it cannot be read. End users edit the copy on the drive, which wakes-sp1-fresh +writes from this same file -- so out.h carries the file's text too (SP1_LOGS_TEMPLATE). + +The build fails, naming the line, on anything invalid: a default that half-works is worse +than one that refuses to build (gen_audio.py's rule). The device reads the drive's copy with +its own reader (firmware/src/sp1_cnfg.c), which never fails: a bad line keeps its default. +tools/host-tests/cnfgtest.c runs that reader over this file and checks it agrees. + +Standard library only. Read as UTF-8 (with or without a BOM). +""" +import configparser +import os +import re +import sys + +KEYS = ['enabled', 'performance', 'controls', 'midi', 'usb', 'storage'] +CATS = {'performance': 'SP1_LOG_PERFORMANCE', 'controls': 'SP1_LOG_CONTROLS', + 'midi': 'SP1_LOG_MIDI', 'usb': 'SP1_LOG_USB', 'storage': 'SP1_LOG_STORAGE'} +ONOFF = {'on': 1, 'off': 0} +LINE_MAX = 160 # SP1_CNFG_LINE_MAX: the device ignores longer lines + + +def fail(path, line, msg): + where = '%s:%d' % (path, line) if line else path + sys.stderr.write('\n%s: error: %s\n\n' + 'The built-in logging defaults are checked at build time. See the\n' + 'comments in config/logs.cnfg.\n' % (where, msg)) + sys.exit(1) + + +def line_of(text, section, key): + cur = None + for i, ln in enumerate(text.splitlines(), 1): + s = ln.strip() + m = re.match(r'^\[(.+)\]$', s) + if m: + cur = m.group(1).strip().lower() + elif cur == section and re.match(r'^%s\s*=' % re.escape(key), s, re.I): + return i + return 0 + + +def parse(path): + with open(path, encoding='utf-8-sig') as f: + text = f.read() + if not text.lstrip().startswith(';'): + fail(path, 1, 'the file must start with a comment naming its format ("; Format: ini")') + for i, ln in enumerate(text.splitlines(), 1): + if len(ln.encode('utf-8')) > LINE_MAX: + fail(path, i, 'line is over %d bytes: the device would ignore it' % LINE_MAX) + cp = configparser.ConfigParser(inline_comment_prefixes=(';', '#'), + comment_prefixes=(';', '#'), strict=True, + interpolation=None) + try: + cp.read_string(text, source=path) + except configparser.Error as e: + fail(path, getattr(e, 'lineno', 0), str(e).splitlines()[0]) + for sec in cp.sections(): + if sec != 'logs': + fail(path, 0, 'unknown section [%s] (expected [logs])' % sec) + logs = cp['logs'] if cp.has_section('logs') else {} + cfg = {} + for key in logs: + if key not in KEYS: + fail(path, line_of(text, 'logs', key), 'unknown setting "%s" (expected %s)' + % (key, ', '.join(KEYS))) + for key in KEYS: + v = logs.get(key, 'on').strip().lower() + if v not in ONOFF: + fail(path, line_of(text, 'logs', key), '%s must be on or off, not "%s"' % (key, v)) + cfg[key] = ONOFF[v] + return cfg, text + + +def c_string(text): + """The text as C string literals, one per line; non-ASCII as octal escapes (a hex escape + would swallow the hex digits after it).""" + out = [] + for ln in text.splitlines(keepends=True): + s = '' + for b in ln.encode('utf-8'): + c = chr(b) + if c == '\\': + s += '\\\\' + elif c == '"': + s += '\\"' + elif c == '\n': + s += '\\n' + elif c == '\t': + s += '\\t' + elif 0x20 <= b < 0x7f: + s += c + else: + s += '\\%03o' % b + out.append('\t"%s"' % s) + return '\n'.join(out) if out else '\t""' + + +def header(cfg, text): + cats = [CATS[k] for k in CATS if cfg[k]] + return '\n'.join([ + '/* GENERATED by tools/gen_logs.py from config/logs.cnfg -- do not edit. */', + '#pragma once', + '', + '/* The built-in defaults (sp1_cnfg.h: SP1_LOG_*). */', + '#define SP1_LOGS_DEF_ENABLED %d' % cfg['enabled'], + '#define SP1_LOGS_DEF_CATS (%s)' % (' | '.join(cats) if cats else '0u'), + '', + '/* config/logs.cnfg as written to WAKES/CNFG/logs.cnfg by wakes-sp1-fresh, which', + ' * defines SP1_CNFG_TEMPLATES before including this (no other file has a use for it). */', + '#if defined(SP1_CNFG_TEMPLATES)', + 'static const char SP1_LOGS_TEMPLATE[] =', + c_string(text) + ';', + '#endif', + '', + ]) + + +def main(): + if len(sys.argv) != 3: + sys.stderr.write(__doc__) + sys.exit(2) + src, out = sys.argv[1], sys.argv[2] + cfg, text = parse(src) + text = header(cfg, text.replace('\r\n', '\n')) + try: + with open(out, encoding='utf-8') as f: + if f.read() == text: + return # unchanged: do not force a rebuild + except OSError: + pass + os.makedirs(os.path.dirname(os.path.abspath(out)), exist_ok=True) + with open(out, 'w', encoding='utf-8', newline='\n') as f: + f.write(text) + + +if __name__ == '__main__': + main() diff --git a/tools/gen_midi.py b/tools/gen_midi.py index 709c9a6..c55906e 100644 --- a/tools/gen_midi.py +++ b/tools/gen_midi.py @@ -3,7 +3,7 @@ gen_midi.py [--chart ] build step (CMake runs this) -Two inputs, deliberately kept apart (as gen_engines.py does for engines.csv): +Two inputs, deliberately kept apart (as gen_engines.py does for engines.cnfg): config/midi.ini the USER's choices: channel, note priority, legato, portamento, bend range, the sustain pedal's CC, the CC smoothing time, which CC moves diff --git a/tools/gen_prst.py b/tools/gen_prst.py index f6cf69e..884a4bc 100644 --- a/tools/gen_prst.py +++ b/tools/gen_prst.py @@ -64,7 +64,7 @@ # ---- the fields, in the order they are written ------------------------------------------- # (section, key, kind, check, path in struct sp1_prst) -# kind engine = an engine NAME (config/engines.csv), resolved to its slot +# kind engine = an engine NAME (config/engines.cnfg), resolved to its slot # pos = a fader value, 0..1 (pot space, before detents) # = one of CHOICES[kind] # check extra validity beyond "is one of the tokens", applied by sp1_prst.c: diff --git a/tools/host-tests/README.md b/tools/host-tests/README.md index 02f66f2..a3bdcba 100644 --- a/tools/host-tests/README.md +++ b/tools/host-tests/README.md @@ -14,15 +14,16 @@ proved on a laptop, and because there is exactly one SP-1 (`docs/SAFETY.md`). | `miditest_alt.cc` | the same, built against `midi-alt.ini` (pickup `sum`) | omni, legato on, Yarns' portamento curve, velocity -> LEVEL, aftertouch -> TIMBRE, no sustain pedal, bend range | | `third_party/feldd/test/test_usb_rt_parse.c` | feldd's packet validator | feldd's own test, unmodified | | `prsttest.c` | `sp1_prst.c` + both UI files, with the same stubs as `uitest` | PRST slot files (#50): the ROTC defaults come from the rip code and a rip still gives them, write -> read returns the patch, every corrupt field (NaN, inf, out of range, exponent, unknown token, a destination off its ring, a scale not included) loads only THAT field's default and a bad BASE fader the loaded engine's neutral, unknown engine -> slot 1, an unknown or missing format -> the whole slot from defaults, hand-edited text (CRLF, case, comments, duplicates), the writer never overruns, and ~23 000 truncated / damaged / random files all give a safe patch | +| `cnfgtest.c` | `sp1_cnfg.c` + `sp1_logring.c`, nothing else | The config files and the log on the drive (#52): `config/logs.cnfg` as fresh writes it reads back as exactly the built-in defaults at any chunk size; overrides, case, CRLF, a BOM, inline comments; a bad value, an unknown key or section, a line with no `=`, a section with no `]` and an over-long line each keep their defaults and are reported on the right line; the same key twice -> the first wins; every log tag lands in its category and untagged lines are always written; the file's cursor takes whole lines, skips STANDBY, counts what an overrun lost (not the gap's own bytes) and resumes on a whole line, survives the 32-bit wrap, and a kept ring with a bad header is rejected | | `uactest.c` | Ryan Gilmore's USB audio ring and packet regulator (`third_party/sp1-usb-audio`, with Wakes' word-copy patch applied as the firmware will) at Wakes' tuning, `firmware/src/sp1_uac_tuning.h` | USB audio out (M5c): ±200 ppm of clock drift, a heavy patch starting and stopping, a 200 % block every 997, with no underflow, no lost frame, a margin left in the ring, at most 20 packet-size corrections a second and none from load alone; priming, underflow, overflow | ```sh tools/host-tests/hostbuild.sh routetest.cc uitest.c miditest.cc miditest_alt.cc \ miditest_pickup.cc miditest_clock.cc ../../third_party/feldd/test/test_usb_rt_parse.c \ - uactest.c prsttest.c + uactest.c prsttest.c cnfgtest.c cd /tmp/wakes-sp1-host && ./routetest && ./uitest && ./miditest && ./miditest_alt \ && ./miditest_pickup_shared && ./miditest_pickup_takeover && ./miditest_clock \ - && ./test_usb_rt_parse && ./uactest && ./prsttest + && ./test_usb_rt_parse && ./uactest && ./prsttest && ./cnfgtest ``` Builds go to `$TMPDIR/wakes-sp1-host` (override with `SP1_HOST_BUILD_DIR`); nothing is written diff --git a/tools/host-tests/cnfgtest.c b/tools/host-tests/cnfgtest.c new file mode 100644 index 0000000..fabcbe7 --- /dev/null +++ b/tools/host-tests/cnfgtest.c @@ -0,0 +1,420 @@ +/* wakes-sp1 #52: host checks of the config-file reader (sp1_cnfg.c) and the log file's cursor + * into the RAM log (sp1_logring.c) -- the cases that would take hours, or a broken drive, to + * make on the device. */ +#include +#include +#include + +#define SP1_CNFG_TEMPLATES +#include "sp1_cnfg.h" +#include "sp1_logring.h" +#include "sp1_logs_gen.h" +#include "sp1_engines_gen.h" + +static int fails; +#define CHECK(cond, ...) do { if (!(cond)) { printf(" FAIL: "); \ + printf(__VA_ARGS__); printf("\n"); fails++; } } while (0) + +/* ---------------------------------------------------------------- the reader */ + +static int problems_seen; +static int last_line; +static char last_what[200]; + +static void problem(void *ctx, int line, const char *what, const char *why) +{ + (void)ctx; + problems_seen++; + last_line = line; + snprintf(last_what, sizeof(last_what), "%s", what); + if (getenv("CNFGTEST_VERBOSE")) { + printf(" line %d: %s -- %s\n", line, what, why); + } +} + +/* Read `text` over the defaults, `chunk` bytes at a time (0 = all at once). */ +static int read_logs(const char *text, size_t chunk, struct sp1_logs_cfg *c) +{ + struct sp1_logs_reader r; + problems_seen = 0; + last_line = 0; + last_what[0] = '\0'; + sp1_logs_defaults(c); + sp1_logs_begin(&r, c, problem, NULL); + const size_t n = strlen(text); + if (chunk == 0u) { + chunk = n ? n : 1u; + } + for (size_t i = 0u; i < n; i += chunk) { + sp1_logs_feed(&r, text + i, (i + chunk <= n) ? chunk : n - i); + } + const int bad = sp1_logs_end(&r); + CHECK(bad == problems_seen, "reader counted %d problems, reported %d", bad, problems_seen); + return bad; +} + +static void reader(void) +{ + printf("[1] logs.cnfg: the reader\n"); + struct sp1_logs_cfg c, d; + sp1_logs_defaults(&d); + CHECK(d.enabled && d.cats == SP1_LOG_ALL, "the shipped defaults are on/all (got %d/0x%02x)", + d.enabled, d.cats); + + /* The template the fresh image writes reads back as exactly the built-in defaults, with + * no problem -- whatever chunk size the drive hands over. */ + const size_t chunks[] = { 0u, 1u, 7u, 128u }; + for (size_t k = 0u; k < sizeof(chunks) / sizeof(chunks[0]); k++) { + const int bad = read_logs(SP1_LOGS_TEMPLATE, chunks[k], &c); + CHECK(bad == 0, "template, chunk %u: %d problems (line %d: %s)", (unsigned)chunks[k], bad, + last_line, last_what); + CHECK(c.enabled == d.enabled && c.cats == d.cats, + "template, chunk %u: %d/0x%02x, defaults %d/0x%02x", (unsigned)chunks[k], c.enabled, + c.cats, d.enabled, d.cats); + } + + /* Overrides, case, CRLF, a BOM, inline comments, no newline at the end. */ + CHECK(read_logs("\xEF\xBB\xBF; Format: ini\r\n[LOGS]\r\nEnabled = OFF ; quiet\r\n" + "midi=off\r\nusb = on # yes\r\nstorage = off", 0u, &c) == 0, + "overrides: %d problems (line %d: %s)", problems_seen, last_line, last_what); + CHECK(!c.enabled && c.cats == (SP1_LOG_ALL & ~(SP1_LOG_MIDI | SP1_LOG_STORAGE)), + "overrides: got %d/0x%02x", c.enabled, c.cats); + + /* A bad value keeps its default; the rest of the file still applies. */ + CHECK(read_logs("[logs]\nenabled = maybe\nmidi = off\n", 0u, &c) == 1 && last_line == 2, + "bad value: %d problems, line %d", problems_seen, last_line); + CHECK(c.enabled && !(c.cats & SP1_LOG_MIDI), "bad value: got %d/0x%02x", c.enabled, c.cats); + CHECK(strcmp(last_what, "enabled = maybe") == 0, "bad value named as \"%s\"", last_what); + + /* The same key twice: the FIRST is used (Adara's rule, #52). */ + CHECK(read_logs("[logs]\nmidi = off\nmidi = on\n", 0u, &c) == 1 && last_line == 3, + "twice: %d problems, line %d", problems_seen, last_line); + CHECK(!(c.cats & SP1_LOG_MIDI), "twice: the first did not win (0x%02x)", c.cats); + /* ...also when the first one was unreadable: it still counts as set. */ + CHECK(read_logs("[logs]\nusb = ?\nusb = off\n", 0u, &c) == 2 && (c.cats & SP1_LOG_USB), + "twice, first bad: %d problems, 0x%02x", problems_seen, c.cats); + + /* Unknown key, unknown section (reported once, its keys ignored), outside any section, + * no '=', a section without its ']'. */ + CHECK(read_logs("[logs]\nverbose = on\n", 0u, &c) == 1 && last_line == 2, + "unknown key: %d problems, line %d", problems_seen, last_line); + CHECK(read_logs("[midi]\nchannel = 3\nclock = off\n[logs]\nmidi = off\n", 0u, &c) == 1 && + last_line == 2 && !(c.cats & SP1_LOG_MIDI), + "unknown section: %d problems, line %d, 0x%02x", problems_seen, last_line, c.cats); + CHECK(read_logs("midi = off\n[logs]\n", 0u, &c) == 1 && (c.cats & SP1_LOG_MIDI), + "outside a section: %d problems, 0x%02x", problems_seen, c.cats); + CHECK(read_logs("[logs]\njust words\n", 0u, &c) == 1 && last_line == 2, + "no '=': %d problems, line %d", problems_seen, last_line); + CHECK(read_logs("[logs\nmidi = off\n", 0u, &c) == 2 && (c.cats & SP1_LOG_MIDI), + "no ']': %d problems, 0x%02x", problems_seen, c.cats); + + /* A line over the limit is one problem, and the line after it is read normally -- + * also when the long line arrives a byte at a time. */ + char longf[600]; + memset(longf, 0, sizeof(longf)); + strcpy(longf, "[logs]\n; "); + memset(longf + strlen(longf), 'x', 300); + strcat(longf, "\nusb = off\n"); + CHECK(read_logs(longf, 1u, &c) == 1 && last_line == 2 && !(c.cats & SP1_LOG_USB), + "long line: %d problems, line %d, 0x%02x", problems_seen, last_line, c.cats); + + /* An empty file and a file of comments: the defaults, no problem. */ + CHECK(read_logs("", 0u, &c) == 0 && c.enabled && c.cats == d.cats, "empty file"); + CHECK(read_logs("; nothing\n# here\n\n", 0u, &c) == 0 && c.cats == d.cats, "comments"); + + char b[48]; + CHECK(strcmp(sp1_logs_describe(SP1_LOG_ALL, b, sizeof(b)), + "performance controls midi usb storage") == 0, "describe all: %s", b); + CHECK(strcmp(sp1_logs_describe(0u, b, sizeof(b)), "none") == 0, "describe none: %s", b); +} + +/* ---------------------------------------------------------------- categories */ + +static void categories(void) +{ + printf("[2] the log's categories\n"); + static const struct { + const char *line; + uint8_t cat; + } T[] = { + { "[+00:01:02.345] CPU eng=60.1/70.2\n", SP1_LOG_PERFORMANCE }, + { "[+00:01:02.345] MISS/ms eng=3\n", SP1_LOG_PERFORMANCE }, + { "[+00:01:02.345] THREADS main=1.0\n", SP1_LOG_PERFORMANCE }, + { "[+00:01:02.345] ENGINE 3: 2-op FM\n", SP1_LOG_CONTROLS }, + { "[+00:01:02.345] DEJA VU t on\n", SP1_LOG_CONTROLS }, + { "[+00:01:02.345] MIDI port enabled\n", SP1_LOG_MIDI }, + { "[+00:01:02.345] CLOCK run\n", SP1_LOG_MIDI }, + { "[+00:01:02.345] UAC open=1\n", SP1_LOG_USB }, + { "[+00:01:02.345] STORE volume ok\n", SP1_LOG_STORAGE }, + { "[+00:01:02.345] LOG 60 s: 12 flushes\n", SP1_LOG_STORAGE }, + /* Always written. */ + { "[+00:01:02.345] PWR shutdown suppressed\n", 0u }, + { "[+00:01:02.345] BOOT on battery\n", 0u }, + { "[+00:01:02.345] CNFG logs.cnfg line 3: x -- y\n", 0u }, + { "[+00:01:02.345] [ON] batt raw=1234\n", 0u }, + { "[+00:01:02.345] resetreas 0x00000001\n", 0u }, + { "[+00:01:02.345] Singles: 209\n", 0u }, + { "[+00:01:02.345] USBx\n", 0u }, + { "=== RESET (resetreas 0x2) ===\n", 0u }, + { "AUD start rc=0\n", SP1_LOG_PERFORMANCE }, /* no stamp */ + { "", 0u }, + }; + for (size_t i = 0u; i < sizeof(T) / sizeof(T[0]); i++) { + const uint8_t c = sp1_log_category(T[i].line, strlen(T[i].line)); + CHECK(c == T[i].cat, "\"%.40s\": 0x%02x, expected 0x%02x", T[i].line, c, T[i].cat); + } +} + +/* ---------------------------------------------------------------- the ring */ + +#define RSZ 64u +static struct sp1_logring R; +static char data[RSZ]; +static char got[4096]; +static size_t got_n; +static uint32_t lost; + +static void puts_r(const char *s) +{ + for (; *s; s++) { + sp1_logring_put(&R, data, *s); + } +} + +/* Everything the file can take now, into got[] (appended). max = the piece size. */ +static void drain(size_t max) +{ + char out[256]; + size_t n; + while ((n = sp1_logring_take(&R, data, out, max, &lost)) > 0u) { + memcpy(got + got_n, out, n); + got_n += n; + got[got_n] = '\0'; + } +} + +static void reset_ring(void) +{ + sp1_logring_init(&R, RSZ); + got_n = 0u; + got[0] = '\0'; + lost = 0u; +} + +static void ring(void) +{ + printf("[3] the log file's cursor\n"); + + /* Whole lines only; a partial line waits for its end. */ + reset_ring(); + puts_r("one\ntwo\nthr"); + drain(32u); + CHECK(strcmp(got, "one\ntwo\n") == 0 && lost == 0u, "lines: \"%s\" lost %u", got, lost); + puts_r("ee\n"); + drain(32u); + CHECK(strcmp(got, "one\ntwo\nthree\n") == 0, "partial completed: \"%s\"", got); + + /* A line longer than a piece comes in pieces. */ + reset_ring(); + puts_r("abcdefghijklmnop\n"); + drain(6u); + CHECK(strcmp(got, "abcdefghijklmnop\n") == 0, "pieces: \"%s\"", got); + + /* STANDBY (Adara): pause..resume is skipped; lines before and after are kept. */ + reset_ring(); + puts_r("boot\n"); + sp1_logring_pause(&R); + puts_r("[STANDBY] a\n[STANDBY] b\n"); + drain(32u); /* while still in STANDBY: only what came before */ + CHECK(strcmp(got, "boot\n") == 0, "paused: \"%s\"", got); + sp1_logring_resume(&R); + puts_r("on\n"); + drain(32u); + CHECK(strcmp(got, "boot\non\n") == 0 && lost == 0u, "gap: \"%s\" lost %u", got, lost); + + /* A second STANDBY before the file caught up merges with the first (documented). */ + reset_ring(); + puts_r("a\n"); + sp1_logring_pause(&R); + puts_r("s1\n"); + sp1_logring_resume(&R); + puts_r("b\n"); + sp1_logring_pause(&R); + puts_r("s2\n"); + sp1_logring_resume(&R); + puts_r("c\n"); + drain(32u); + CHECK(strcmp(got, "a\nc\n") == 0, "two gaps: \"%s\"", got); + + /* Overrun: what the ring overwrote is counted, and the file resumes on a whole line. */ + reset_ring(); + for (int i = 0; i < 20; i++) { + char l[16]; + snprintf(l, sizeof(l), "line %02d\n", i); /* 8 bytes each: 160 > 64 */ + puts_r(l); + } + drain(32u); + CHECK(lost == 160u - 64u + 0u || lost == 160u - 64u + 8u, + "overrun: lost %u (expected 96, or 104 with the cut line)", lost); + CHECK(got_n > 0u && got[got_n - 1u] == '\n' && strncmp(got, "line ", 5) == 0, + "overrun: resumes on a line: \"%s\"", got); + CHECK(lost + got_n == 160u, "overrun: lost + taken = %u, expected 160", lost + (unsigned)got_n); + + /* Overrun inside a STANDBY gap: the gap's bytes are not a loss. */ + reset_ring(); + puts_r("before\n"); /* 7 */ + drain(32u); + sp1_logring_pause(&R); + for (int i = 0; i < 30; i++) { + puts_r("standby\n"); /* 240 bytes of STANDBY */ + } + sp1_logring_resume(&R); + puts_r("after\n"); + drain(32u); + CHECK(strcmp(got, "before\nafter\n") == 0 && lost == 0u, + "gap overwritten: \"%s\" lost %u", got, lost); + + /* Logging off this ON: nothing so far is owed to the file. */ + reset_ring(); + puts_r("old\n"); + sp1_logring_skip(&R); + puts_r("new\n"); + drain(32u); + CHECK(strcmp(got, "new\n") == 0, "skip: \"%s\"", got); + + /* After a reset: a cursor ahead of the writer is pulled back; a bad header fails. */ + reset_ring(); + puts_r("kept\n"); + R.frd = R.total + 100u; + CHECK(sp1_logring_valid(&R, RSZ), "valid: a sane ring"); + drain(32u); + CHECK(strcmp(got, "kept\n") == 0, "valid: cursor clamped: \"%s\"", got); + R.head = RSZ; + CHECK(!sp1_logring_valid(&R, RSZ), "valid: head out of range"); + sp1_logring_init(&R, RSZ); + CHECK(!sp1_logring_valid(&R, RSZ * 2u), "valid: another size"); + + /* The 32-bit wrap of the position counter is harmless. */ + reset_ring(); + R.total = R.frd = 0xFFFFFFF0u; + R.gap_from = R.gap_to = R.total; + puts_r("wrap one\nwrap two\n"); + drain(32u); + CHECK(strcmp(got, "wrap one\nwrap two\n") == 0 && lost == 0u, "wrap: \"%s\" lost %u", got, + lost); +} + +/* ---------------------------------------------------------------- engines.cnfg */ + +static uint8_t estack[SP1_CNFG_SLOTS]; +static int efilled; + +static int read_engines(const char *text, size_t chunk) +{ + struct sp1_engines_reader r; + problems_seen = 0; + last_line = 0; + last_what[0] = '\0'; + sp1_engines_begin(&r, problem, NULL); + const size_t n = strlen(text); + if (chunk == 0u) { + chunk = n ? n : 1u; + } + for (size_t i = 0u; i < n; i += chunk) { + sp1_engines_feed(&r, text + i, (i + chunk <= n) ? chunk : n - i); + } + const int bad = sp1_engines_end(&r, estack, &efilled); + CHECK(bad == problems_seen, "engines: counted %d, reported %d", bad, problems_seen); + return bad; +} + +static bool is_default(void) +{ + static const uint8_t def[SP1_CNFG_SLOTS] = SP1_ENGINE_DEFAULT_STACK; + return memcmp(estack, def, sizeof(def)) == 0; +} + +static int idx(const char *name) +{ + return sp1_engine_index(name, strlen(name)); +} + +static void engines(void) +{ + printf("[4] engines.cnfg: names and the stack\n"); + + /* Names: letters and digits, case ignored -- spaces, hyphens and / + do not matter. */ + static const struct { + const char *name; + const char *as; + } SAME[] = { + { "virtual-analog", "virtual analog" }, { "VIRTUAL ANALOG", "virtual analog" }, + { "grain-formant", "grain / formant" }, { "grain-/-formant", "grain / formant" }, + { "VA-VCF", "VA + VCF" }, { "va + vcf", "VA + VCF" }, + { "2-op-FM", "2-op FM" }, { "6-op-fm-c", "6-op FM C" }, + { "hi hat", "hi-hat" }, { "string-machine", "string machine" }, + { "stringmachine", "string machine" }, + }; + for (size_t i = 0u; i < sizeof(SAME) / sizeof(SAME[0]); i++) { + CHECK(idx(SAME[i].name) >= 0 && idx(SAME[i].name) == idx(SAME[i].as), + "name \"%s\" -> %d, \"%s\" -> %d", SAME[i].name, idx(SAME[i].name), SAME[i].as, + idx(SAME[i].as)); + } + CHECK(idx("string") != idx("string machine"), "string is not string machine"); + CHECK(idx("6-op FM") < 0 && idx("") < 0 && idx("moog") < 0 && idx("-") < 0, + "partial / empty / unknown names are no engine"); + + /* The template fresh writes: no problem, exactly the built-in stack, 16 engines. */ + const size_t chunks[] = { 0u, 1u, 128u }; + for (size_t k = 0u; k < sizeof(chunks) / sizeof(chunks[0]); k++) { + CHECK(read_engines(SP1_ENGINES_TEMPLATE, chunks[k]) == 0 && is_default() && + efilled == 16, "template, chunk %u: %d problems (line %d: %s), %d engines", + (unsigned)chunks[k], problems_seen, last_line, last_what, efilled); + } + + /* A user's stack: the file is the WHOLE stack; any spelling of a name. */ + CHECK(read_engines("; Format: ini\r\n[ENGINES]\r\n1 = chords ; ●○○○\r\n3 = Grain-Formant\r\n" + "7 =\r\n8 = none\r\n24 = VA-VCF\r\n", 0u) == 0 && efilled == 3 && + estack[0] == idx("chords") && estack[2] == idx("grain / formant") && + estack[23] == idx("VA + VCF") && estack[1] == SP1_CNFG_EMPTY && + estack[6] == SP1_CNFG_EMPTY && estack[7] == SP1_CNFG_EMPTY, + "user stack: %d problems (line %d: %s), %d engines", problems_seen, last_line, + last_what, efilled); + + /* Anything wrong: the WHOLE file is set aside for the built-in stack, every problem + * reported on its line. */ + static const struct { + const char *text; + int problems; + int line; + } BAD[] = { + { "[engines]\n1 = chords\n2 = moog\n", 1, 3 }, /* not an engine */ + { "[engines]\n1 = chords\n5 = Chords\n", 1, 3 }, /* engine twice */ + { "[engines]\n25 = chords\n", 1, 2 }, /* no slot 25 */ + { "[engines]\n0 = chords\n", 1, 2 }, /* no slot 0 */ + { "[engines]\nx = chords\n", 1, 2 }, /* not a slot */ + { "[engines]\n1 = chords\n1 = speech\n", 1, 3 }, /* slot twice */ + { "[engine]\n1 = chords\n", 1, 2 }, /* not [engines] */ + { "1 = chords\n[engines]\n2 = speech\n", 1, 1 }, /* outside [engines] */ + { "[engines]\n1 =\n2 = none\n", 1, 3 }, /* no engine at all */ + { "", 1, 0 }, /* an empty file */ + { "[engines]\n1 = chords\njust words\n", 1, 3 }, /* not a setting */ + }; + for (size_t i = 0u; i < sizeof(BAD) / sizeof(BAD[0]); i++) { + const int bad = read_engines(BAD[i].text, i % 2 ? 1u : 0u); + CHECK(bad == BAD[i].problems && last_line == BAD[i].line && is_default() && + efilled == 16, "bad file %u: %d problems (want %d), line %d (want %d), %s", + (unsigned)i, bad, BAD[i].problems, last_line, BAD[i].line, + is_default() ? "default stack" : "NOT the default stack"); + } +} + +int main(void) +{ + reader(); + categories(); + ring(); + engines(); + printf(fails ? "cnfgtest: %d FAILED\n" : "cnfgtest: all passed\n", fails); + return fails ? 1 : 0; +} diff --git a/tools/host-tests/hostbuild.sh b/tools/host-tests/hostbuild.sh index 3b360dc..fdaffcb 100644 --- a/tools/host-tests/hostbuild.sh +++ b/tools/host-tests/hostbuild.sh @@ -23,9 +23,11 @@ OBJ=$SP/hostobj$SP1_PLAITS_BLOCK python3 "$HERE/mkovr.py" "$OVR" >/dev/null mkdir -p "$GEN" "$OBJ" -python3 "$ROOT/tools/gen_engines.py" "$ROOT/config/engines.csv" "$GEN/sp1_engines_gen.h" >/dev/null +python3 "$ROOT/tools/gen_engines.py" "$ROOT/config/engines.cnfg" "$GEN/sp1_engines_gen.h" >/dev/null # M6 (#50): the PRST field table -- also where a format change without a version bump fails. python3 "$ROOT/tools/gen_prst.py" "$GEN/sp1_prst_gen.h" >/dev/null +# #52: the logging defaults and logs.cnfg's text, as the firmware build generates them. +python3 "$ROOT/tools/gen_logs.py" "$ROOT/config/logs.cnfg" "$GEN/sp1_logs_gen.h" >/dev/null # The MIDI script (M5a) as the firmware build generates it -- with ONE change: its `pickup` # forced to `sum`, because miditest.cc checks the offset maths and the other suites were # written against offsets. miditest_pickup.cc runs the shipped script as it is otherwise, once @@ -116,6 +118,9 @@ for t in "$@"; do gcc -std=c99 -O2 -Wall -fno-tree-loop-distribute-patterns -fno-unroll-loops \ -include "$SRC/sp1_uac_tuning.h" $EXTRA_UAC_FLAGS -I"$UAC" \ "$t" "$SP/uacring.c" -o "$out" ;; + *cnfgtest.c) + # #52: the config-file reader and the log file's cursor -- pure C, nothing else linked. + gcc $CFLAGS -Wall -Wextra $INC "$t" "$SRC/sp1_cnfg.c" "$SRC/sp1_logring.c" -o "$out" ;; *test_usb_rt_parse.c) # feldd's own host test of the packet validator Wakes uses (third_party/feldd). gcc -std=gnu11 -O2 "$t" "$FELDD/src/usb_rt_parse.c" -o "$out" ;; diff --git a/tools/host-tests/prsttest.c b/tools/host-tests/prsttest.c index 0f6ee60..b516bd7 100644 --- a/tools/host-tests/prsttest.c +++ b/tools/host-tests/prsttest.c @@ -6,7 +6,7 @@ #include #include "sp1_prst.h" -#include "sp1_engines_gen.h" /* which engines config/engines.csv lists */ +#include "sp1_engines_gen.h" /* which engines config/engines.cnfg lists */ /* ---- stubs for the parts that live in the audio thread (as uitest.c) ---- */ uint8_t sp1_marbles_last_gates(void) { return 0u; } @@ -200,7 +200,7 @@ int main(void) sp1_mui_get(&a.marbles); CHECK(diff(&a, &d, "rip vs sp1_prst_rip") == 0, "the rip and the PRST defaults differ"); /* docs/DEFAULTS.md, spot checks: slot 1 = virtual analog, TIMBRE and HARMONICS bipolar */ - CHECK(d.plaits.slot == 0 && strcmp(sp1_pui_slot_name(0), "virtual analog") == 0, + CHECK(d.plaits.slot == 0 && strcmp(sp1_pui_slot_name(0), "virtual-analog") == 0, "slot 1 is not virtual analog"); CHECK(d.plaits.v[SP1_PUI_BASE][0] == 0.5f && d.plaits.v[SP1_PUI_BASE][1] == 0.5f && d.plaits.v[SP1_PUI_BASE][2] == 0.0f && d.plaits.v[SP1_PUI_BASE][3] == 0.5f, @@ -221,7 +221,7 @@ int main(void) sp1_prst_rip(&b, 6); CHECK(b.plaits.slot == 6 && b.plaits.v[SP1_PUI_BASE][1] == 0.0f && b.plaits.v[SP1_PUI_BASE][3] == 0.0f, "chords' neutral BASE is wrong"); - sp1_prst_rip(&b, 23); /* an empty slot (config/engines.csv) -> slot 1 */ + sp1_prst_rip(&b, 23); /* an empty slot (config/engines.cnfg) -> slot 1 */ CHECK(b.plaits.slot == 0, "an empty slot was accepted"); /* ---------- 2. write -> read gives the patch back ---------- */ @@ -496,7 +496,7 @@ int main(void) printf(" %d corrupt files, all safe\n", runs); /* ---------- 9. an engine OFF the list (#50) ---------- */ - printf("9. engines off engines.csv\n"); + printf("9. engines off engines.cnfg\n"); { int off = -1, first = -1, last = -1; for (int i = 0; i < SP1_ENGINE_SLOTS; i++) { @@ -541,6 +541,18 @@ int main(void) sp1_prst_parse(text, (size_t)n, &b, &rep); CHECK(diff(&a, &b, "off-list round trip") == 0 && rep.bad == 0, "an off-list engine does not survive a round trip"); + /* #52: names became hyphenated (VA-VCF, grain-formant); a file saved under the + * old spelling still loads its engine -- names match on letters and digits. */ + static const char *const OLD[] = { "VA + VCF", "grain / formant", + "string machine", "virtual analog" }; + for (size_t k = 0; k < sizeof(OLD) / sizeof(OLD[0]); k++) { + with(text, "engine", OLD[k], buf2, sizeof(buf2)); + sp1_prst_parse(buf2, strlen(buf2), &b, &rep); + const int want = sp1_pui_slot_of(OLD[k], (int)strlen(OLD[k])); + CHECK(want >= 0 && b.plaits.slot == want && rep.bad == 0, + "old name \"%s\" -> slot %d (want %d), bad %d", OLD[k], + b.plaits.slot, want, rep.bad); + } /* the UI plays it, with its own detents and no glyph */ sp1_pui_put(&a.plaits); struct sp1_synth_params sp; diff --git a/tools/host-tests/uitest.c b/tools/host-tests/uitest.c index e9e4308..ce2a179 100644 --- a/tools/host-tests/uitest.c +++ b/tools/host-tests/uitest.c @@ -6,6 +6,7 @@ #include "sp1_marbles_ui.h" #include "sp1_plaits_ui.h" #include "sp1_release_guard.h" +#include "sp1_engines_gen.h" /* the built-in stack (#52) */ /* ---- stubs for the parts that live in the audio thread ---- */ static uint8_t stub_gates; /* t1..t3 as Marbles last rendered them (section 19) */ @@ -1002,6 +1003,54 @@ int main(void) CHECK(pb.timbre > pa.timbre + 0.1f, "a real TIMBRE move after the lock did nothing"); } + printf("21. the engine stack from the drive (#52)\n"); + { + /* A user's engines.cnfg: slots 1-4 empty, chords in 5, speech in 9, VA + VCF in 20 + * (Plaits indices 14, 15, 0). */ + uint8_t st[24]; + memset(st, 255, sizeof(st)); + st[4] = 14; + st[8] = 15; + st[19] = 0; + sp1_pui_init(); + sp1_pui_enter(raw_mid); + sp1_pui_set_stack(st); + sp1_pui_stack_settle(); /* slot 1 is empty now: -> slot 5 */ + CHECK(sp1_pui_slot() == 4 && sp1_pui_engine() == 14, + "settle: slot %d engine %d, want slot 5 (chords)", sp1_pui_slot() + 1, + sp1_pui_engine()); + sp1_pui_engine_step(1); + sp1_pui_engine_step(1); + CHECK(sp1_pui_slot() == 19 && sp1_pui_engine() == 0, + "T3 twice: slot %d, want 20 (VA + VCF)", sp1_pui_slot() + 1); + sp1_pui_engine_step(1); /* wraps past the empty slots */ + CHECK(sp1_pui_slot() == 4, "T3 wrap: slot %d, want 5", sp1_pui_slot() + 1); + sp1_pui_engine_step(-1); + CHECK(sp1_pui_slot() == 19, "T2 wrap: slot %d, want 20", sp1_pui_slot() + 1); + /* ROTC returns to the FIRST FILLED slot of THIS stack (Adara, #52). */ + sp1_pui_rip(); + CHECK(sp1_pui_slot() == 4 && sp1_pui_engine() == 14, + "ROTC: slot %d engine %d, want slot 5 (chords)", sp1_pui_slot() + 1, + sp1_pui_engine()); + /* Names resolve against this stack, any spelling; off it -> off-list. */ + CHECK(sp1_pui_slot_of("VA-VCF", 6) == 19, "VA-VCF -> %d, want slot 20", + sp1_pui_slot_of("VA-VCF", 6)); + CHECK(sp1_pui_slot_of("grain / formant", 15) == SP1_PUI_OFFLIST + 11, + "grain / formant is off this stack: %d", sp1_pui_slot_of("grain / formant", 15)); + CHECK(sp1_pui_slot_of("virtual analog", 14) == SP1_PUI_OFFLIST + 8, + "virtual analog is off this stack"); + /* A stack with no engine is never installed: the built-in one is used. */ + memset(st, 255, sizeof(st)); + sp1_pui_set_stack(st); + sp1_pui_rip(); + CHECK(sp1_pui_slot() == 0 && sp1_pui_engine() == 8, + "empty stack -> built-in: slot %d engine %d", sp1_pui_slot() + 1, + sp1_pui_engine()); + /* And back to the built-in stack for anything after this. */ + const uint8_t def[24] = SP1_ENGINE_DEFAULT_STACK; + sp1_pui_set_stack(def); + } + printf("\n%s (%d failure%s)\n", fails ? "FAILED" : "all checks passed", fails, fails == 1 ? "" : "s"); return fails != 0; From f37a4632820f935d907a7a719ef48cd8342e2a74 Mon Sep 17 00:00:00 2001 From: Worldwave Date: Thu, 15 Oct 2026 16:50:55 -0400 Subject: [PATCH 02/10] #52: logging-off lines no longer leak; a fader spike no longer stops a shutdown Two findings from Adara's hardware test (2026-10-15, 0006/0007.LOGS): - An ON with logs.cnfg `enabled = off` skipped the RAM log only up to the moment it read the file. Its later lines stayed queued and were written into the next ON's log (0007.LOGS opened with them). sp1_logring now has a `discard` state: skip drops the whole ON, the STANDBY pause drops the rest, and sp1_logbuf_file_keep() ends it when logging is on. A cnfgtest case reproduces the log. - One 8 ms reading 82 counts off on F4 (parked at 0, untouched) stopped a 3 s shutdown. 4382 logged fader snapshots show no sign of a worn F4: at the bottom of travel it is the quietest of the four. A fader now has to stay >= 80 counts from the mark on 2 valid scans in a row (SP1_TOUCH_SCANS), the buttons' own debounce. Real moves suppress 8 ms later; a lone spike is ignored. This only gates the animation; the 30 s backstop is untouched. Also: logs.cnfg says ~12 hours per 8 MB file (measured ~190 B/s), not 18. Co-Authored-By: Claude Opus 5.5 --- config/logs.cnfg | 2 +- firmware/src/sp1_controls.c | 34 +++++++++++++++++++++++++++++++--- firmware/src/sp1_logbuf.c | 7 +++++++ firmware/src/sp1_logbuf.h | 2 ++ firmware/src/sp1_logring.c | 13 ++++++++++++- firmware/src/sp1_logring.h | 9 +++++++-- firmware/src/sp1_store.c | 3 ++- tools/host-tests/cnfgtest.c | 21 +++++++++++++++++++++ 8 files changed, 83 insertions(+), 8 deletions(-) diff --git a/config/logs.cnfg b/config/logs.cnfg index ed08895..6727570 100644 --- a/config/logs.cnfg +++ b/config/logs.cnfg @@ -7,7 +7,7 @@ ; turning Wakes on until it is switched off), numbered -- 0001.LOGS, 0002.LOGS, ... after ; 9999.LOGS comes 0000.LOGS. The last 5 sessions are kept; WAKES/LOGS/SESSION holds the ; latest session's number. If you ask us for help, send them all. -; Each file stops at 8 MB, about 18 hours of playing. STANDBY (plugged in and off) is not +; Each file stops at 8 MB, about 12 hours of playing. STANDBY (plugged in and off) is not ; logged. ; ; Wakes reads this file every time it turns ON, so a change takes effect at the next ON. diff --git a/firmware/src/sp1_controls.c b/firmware/src/sp1_controls.c index 8554626..3dd1e68 100644 --- a/firmware/src/sp1_controls.c +++ b/firmware/src/sp1_controls.c @@ -30,6 +30,7 @@ static bool ok; static uint16_t lad_raw[2]; static uint16_t fad_raw[SP1_NUM_FADERS]; /* last VALID fader sample */ +static void track_touch(void); /* shutdown suppression: below the scan */ static uint16_t fad_scratch[SP1_NUM_FADERS]; /* this scan, maybe sagged */ static bool fad_valid; static enum sp1_rail rail; @@ -474,6 +475,9 @@ void sp1_controls_scan(void) last_idle[i] = fad_raw[i]; } } + if (fad_valid) { + track_touch(); /* a rejected scan is no evidence either way */ + } decode_buttons(); } @@ -700,11 +704,34 @@ static uint16_t why_from, why_to; * exact 0 when parked, and 2x oversampling keeps mid-travel quiet), and far below * any deliberate move -- a real shift gesture sweeps hundreds of counts. */ #define SP1_TOUCH_COUNTS 80u +/* ...and it must be away from the mark on this many VALID scans in a row (2 = 16 ms), the + * buttons' own debounce. One reading 82 counts off on a fader parked at 0 suppressed a + * shutdown on 2026-10-15 (0006.LOGS) with nobody touching it; the logged positions show no + * sign of a worn fader (F4 is the quietest at the bottom), so a lone spike is the likely + * cause. A real move lasts far longer than 16 ms, so shifting is unchanged. This only + * decides whether the 3 s animation starts; the 30 s backstop never looks (rule 5a). */ +#define SP1_TOUCH_SCANS 2u +static uint8_t touch_run[SP1_NUM_FADERS]; /* valid scans in a row past the threshold */ + +static void track_touch(void) +{ + for (int i = 0; i < SP1_NUM_FADERS; i++) { + const uint16_t v = fad_raw[i]; + const uint16_t d = (v > mark_fad[i]) ? (uint16_t)(v - mark_fad[i]) + : (uint16_t)(mark_fad[i] - v); + if (!marked || d < SP1_TOUCH_COUNTS) { + touch_run[i] = 0u; + } else if (touch_run[i] < 255u) { + touch_run[i]++; + } + } +} void sp1_controls_activity_mark(void) { for (int i = 0; i < SP1_NUM_FADERS; i++) { mark_fad[i] = fad_raw[i]; + touch_run[i] = 0u; } marked = true; } @@ -712,6 +739,9 @@ void sp1_controls_activity_mark(void) void sp1_controls_activity_clear(void) { marked = false; + for (int i = 0; i < SP1_NUM_FADERS; i++) { + touch_run[i] = 0u; + } } bool sp1_controls_activity(void) @@ -748,9 +778,7 @@ bool sp1_controls_activity(void) * move through sag -- the sagged samples were never stored. */ for (int i = 0; i < SP1_NUM_FADERS; i++) { const uint16_t v = fad_raw[i]; - const uint16_t d = (v > mark_fad[i]) ? (uint16_t)(v - mark_fad[i]) - : (uint16_t)(mark_fad[i] - v); - if (d >= SP1_TOUCH_COUNTS) { + if (touch_run[i] >= SP1_TOUCH_SCANS) { /* past the threshold, and stayed */ why_kind = WHY_FADER; why_index = i; why_from = mark_fad[i]; diff --git a/firmware/src/sp1_logbuf.c b/firmware/src/sp1_logbuf.c index 5f98901..12fefa6 100644 --- a/firmware/src/sp1_logbuf.c +++ b/firmware/src/sp1_logbuf.c @@ -227,3 +227,10 @@ void sp1_logbuf_file_skip(void) sp1_logring_skip(&hdr.ring); k_spin_unlock(&lock, key); } + +void sp1_logbuf_file_keep(void) +{ + k_spinlock_key_t key = k_spin_lock(&lock); + sp1_logring_keep(&hdr.ring); + k_spin_unlock(&lock, key); +} diff --git a/firmware/src/sp1_logbuf.h b/firmware/src/sp1_logbuf.h index c0299f3..03effb3 100644 --- a/firmware/src/sp1_logbuf.h +++ b/firmware/src/sp1_logbuf.h @@ -67,5 +67,7 @@ size_t sp1_logbuf_file_take(char *out, size_t max, uint32_t *lost); void sp1_logbuf_file_pause(void); void sp1_logbuf_file_resume(void); void sp1_logbuf_file_skip(void); +/* Storage thread: logging is on this ON (undoes _skip's "not owed until the ON ends"). */ +void sp1_logbuf_file_keep(void); #endif /* SP1_LOGBUF_H */ diff --git a/firmware/src/sp1_logring.c b/firmware/src/sp1_logring.c index f3f9f7d..21aac1a 100644 --- a/firmware/src/sp1_logring.c +++ b/firmware/src/sp1_logring.c @@ -24,7 +24,7 @@ void sp1_logring_init(struct sp1_logring *r, uint32_t size) bool sp1_logring_valid(struct sp1_logring *r, uint32_t size) { if (r->size != size || size == 0u || r->head >= size || r->len > size || - r->paused > 1u || r->gap > 1u) { + r->paused > 1u || r->gap > 1u || r->discard > 1u) { return false; } /* A cursor ahead of the writer is nonsense: start the file at the oldest line held. */ @@ -60,6 +60,11 @@ void sp1_logring_pause(struct sp1_logring *r) if (r->paused) { return; } + /* An ON with logging off: none of its lines are owed, the ones since the skip included. */ + if (r->discard) { + r->frd = r->total; + r->gap = 0u; + } /* A closed gap the cursor has not reached yet stretches to cover this one too: the * lines between them (an ON whose log never reached the drive) go with it. */ if (!r->gap) { @@ -83,11 +88,17 @@ void sp1_logring_skip(struct sp1_logring *r) { r->frd = r->total; r->gap = 0u; + r->discard = 1u; if (r->paused) { r->gap_from = r->total; } } +void sp1_logring_keep(struct sp1_logring *r) +{ + r->discard = 0u; +} + size_t sp1_logring_take(struct sp1_logring *r, const char *data, char *out, size_t max, uint32_t *lost) { diff --git a/firmware/src/sp1_logring.h b/firmware/src/sp1_logring.h index af3b6cd..f05c97c 100644 --- a/firmware/src/sp1_logring.h +++ b/firmware/src/sp1_logring.h @@ -33,7 +33,8 @@ struct sp1_logring { uint32_t gap_to; uint8_t paused; /* in STANDBY: nothing from gap_from on, yet */ uint8_t gap; /* a closed gap waits for the cursor */ - uint8_t pad[2]; + uint8_t discard; /* logging is off this ON: its lines are not owed */ + uint8_t pad; }; /* An empty ring over `size` bytes; the cursor at the start. */ @@ -52,8 +53,12 @@ uint32_t sp1_logring_oldest(const struct sp1_logring *r); void sp1_logring_pause(struct sp1_logring *r); void sp1_logring_resume(struct sp1_logring *r); -/* Logging is off this ON: the file is not owed anything written so far. */ +/* Logging is off this ON: the file is not owed anything written so far, NOR anything written + * until the ON ends -- the pause at STANDBY entry drops this ON's lines too, so they cannot + * reach the next ON's file (found in Adara's test, 0007.LOGS, 2026-10-15). Until _keep(). */ void sp1_logring_skip(struct sp1_logring *r); +/* Logging is on this ON: from here the lines are owed to the file again. */ +void sp1_logring_keep(struct sp1_logring *r); /* The next line for the file into out[0..max), max >= 2: its length (with its '\n'), or 0 * if no whole line is waiting. A line longer than max comes in max-byte pieces. A partial diff --git a/firmware/src/sp1_store.c b/firmware/src/sp1_store.c index d41b602..6cc4c52 100644 --- a/firmware/src/sp1_store.c +++ b/firmware/src/sp1_store.c @@ -1490,8 +1490,9 @@ static void job_on_enter(void) * it (log_end at shutdown, log_teardown after sp1_store_abort). Off: as before. */ if (ok && !stop && atomic_get(&vol_state) == SP1_STORE_VOL_OK) { if (!logs_cfg.enabled) { - sp1_logbuf_file_skip(); + sp1_logbuf_file_skip(); /* ...and this whole ON (sp1_logring.h) */ } else { + sp1_logbuf_file_keep(); const int lrc = log_open(); if (lrc != 0 && !stop) { LINE("LOG off: the log file in WAKES/LOGS/ cannot be opened (%d) -- no log on " diff --git a/tools/host-tests/cnfgtest.c b/tools/host-tests/cnfgtest.c index fabcbe7..69c0d34 100644 --- a/tools/host-tests/cnfgtest.c +++ b/tools/host-tests/cnfgtest.c @@ -282,6 +282,27 @@ static void ring(void) drain(32u); CHECK(strcmp(got, "new\n") == 0, "skip: \"%s\"", got); + /* An ON with logging OFF, then STANDBY, then an ON with logging on (Adara's test, + * 0007.LOGS): none of the logging-off ON's lines reach the file -- not those before the + * ON job's decision, not those after it. */ + reset_ring(); + puts_r("boot\n"); + sp1_logring_pause(&R); /* plugged-in boot: STANDBY */ + puts_r("[STANDBY] a\n"); + sp1_logring_resume(&R); /* ON #1 */ + puts_r("CNFG logging off\n"); + sp1_logring_skip(&R); /* ...the ON job decides: off */ + puts_r("ON1 played\nPRST save\n"); + sp1_logring_pause(&R); /* STANDBY */ + puts_r("[STANDBY] b\n"); + sp1_logring_resume(&R); /* ON #2 */ + puts_r("CNFG logging on\n"); + sp1_logring_keep(&R); /* ...the ON job decides: on */ + puts_r("ON2 played\n"); + drain(32u); + CHECK(strcmp(got, "CNFG logging on\nON2 played\n") == 0 && lost == 0u, + "logging off then on: \"%s\" lost %u", got, lost); + /* After a reset: a cursor ahead of the writer is pulled back; a bad header fails. */ reset_ring(); puts_r("kept\n"); From 3ca08fe7dcd68b1258d4ab2251243d65d1342c38 Mon Sep 17 00:00:00 2001 From: Worldwave Date: Thu, 15 Oct 2026 17:19:38 -0400 Subject: [PATCH 03/10] #52 step 2: audio.cnfg and midi.cnfg on the drive; missing files are written config/audio.ini and config/midi.ini become config/audio.cnfg and config/midi.cnfg (first line `; Format: ini`, text rewritten for editing on the drive). They stay the built-in defaults; the build still fails on a bad default. Wakes reads WAKES/CNFG/audio.cnfg and midi.cnfg at every ON and main applies them before the MIDI reset and audio start. - Runtime settings: struct sp1_audio_cfg / sp1_midi_cfg (sp1_cnfg.h), one generated initializer each (SP1_AUDIO_CFG_DEFAULTS, SP1_MIDI_CFG_DEFAULTS). Every former SP1_MIDI_* / SP1_AUDIO_USB_* use reads the live copy (sp1_midi_set_config, sp1_audio_set_config). - The CC rule (Adara): a user line takes a default's CC (a note in the log); two user lines on one CC -> the first keeps it, the later gets none (a problem); the sustain line counts; reserved CCs and 33-63 are refused. `velocity = none` removes a binding. - Adara's ADD: a .cnfg missing from WAKES/CNFG is written with its built-in text by every image, after PRST loads. An existing file is never touched; deleting one resets it at the next ON. Fresh relies on the same path. - CNFG_READ_MAX 16 -> 64 KB (engines.cnfg was already ~16 KB). - Tests: cnfgtest sections for both readers and the CC rule; miditest switches the script at runtime. Image 513 268 B (+44 KB: the readers and the four files' text), 0 warnings. Untested on hardware. Co-Authored-By: Claude Opus 5.5 --- README.md | 4 +- config/{audio.ini => audio.cnfg} | 9 +- config/{midi.ini => midi.cnfg} | 22 +- docs/MIDI.md | 26 +- docs/PLAITS-ENGINES.md | 3 +- firmware/CMakeLists.txt | 20 +- firmware/Kconfig | 3 +- firmware/src/main.c | 58 ++- firmware/src/sp1_audio.c | 38 +- firmware/src/sp1_audio.h | 8 + firmware/src/sp1_cnfg.c | 637 +++++++++++++++++++++++++++++++ firmware/src/sp1_cnfg.h | 91 ++++- firmware/src/sp1_midi.cc | 106 ++--- firmware/src/sp1_midi.h | 13 +- firmware/src/sp1_store.c | 182 +++++++-- firmware/src/sp1_store.h | 9 + firmware/src/sp1_usbd.c | 5 +- tools/gen_audio.py | 62 ++- tools/gen_engines.py | 2 +- tools/gen_logs.py | 6 +- tools/gen_midi.py | 81 +++- tools/gen_prst.py | 2 +- tools/host-tests/README.md | 4 +- tools/host-tests/cnfgtest.c | 226 ++++++++++- tools/host-tests/hostbuild.sh | 7 +- tools/host-tests/midi-alt.ini | 4 +- tools/host-tests/miditest.cc | 46 ++- 27 files changed, 1500 insertions(+), 174 deletions(-) rename config/{audio.ini => audio.cnfg} (85%) rename config/{midi.ini => midi.cnfg} (93%) diff --git a/README.md b/README.md index f574e45..b9a0beb 100644 --- a/README.md +++ b/README.md @@ -63,8 +63,8 @@ Output: `build/zephyr/wakes-sp1.bin`. The Zephyr patch is required and is lost o | [`docs/MARBLES-SETTINGS.md`](docs/MARBLES-SETTINGS.md) | Marbles models, ranges and scales | | [`docs/DEFAULTS.md`](docs/DEFAULTS.md) | every default, and what a reset restores | | [`docs/MIDI.md`](docs/MIDI.md) | MIDI over USB: what it does, and how to change it | -| [`config/midi.ini`](config/midi.ini) | the MIDI script: channel, legato, CC numbers (editable) | -| [`config/audio.ini`](config/audio.ini) | USB audio out: its level (parked or on VOL) and the speaker while a host records (editable) | +| [`config/midi.cnfg`](config/midi.cnfg) | the MIDI script: channel, legato, CC numbers (the default; Wakes reads `WAKES/CNFG/midi.cnfg` on its drive at every ON) | +| [`config/audio.cnfg`](config/audio.cnfg) | USB audio out: its level (parked or on VOL) and the speaker while a host records (the default; Wakes reads `WAKES/CNFG/audio.cnfg` on its drive at every ON) | | [`config/logs.cnfg`](config/logs.cnfg) | the log Wakes writes to its drive, `WAKES/LOGS/` (the default; Wakes reads `WAKES/CNFG/logs.cnfg` on its drive at every ON) | | [`docs/SAFETY.md`](docs/SAFETY.md) | rules for anyone changing the firmware | diff --git a/config/audio.ini b/config/audio.cnfg similarity index 85% rename from config/audio.ini rename to config/audio.cnfg index 9e16a7d..0d7d0ca 100644 --- a/config/audio.ini +++ b/config/audio.cnfg @@ -1,12 +1,13 @@ +; Format: ini ; ===================================================================================== ; Wakes — the audio settings ; ===================================================================================== ; -; How Wakes' sound leaves the device. Edit it in your fork, build (or let CI build) and -; flash: the build reads this file and FAILS with the line number if something in it is -; wrong, so a typo can never become a firmware that silently ignores your setting. +; How Wakes' sound leaves the device. Wakes reads this file from its drive +; (WAKES/CNFG/audio.cnfg) every time it turns ON, so a change takes effect at the next ON. ; -; Lines starting with ; are comments. Every setting can be left out to get its default. +; Lines starting with ; or # are comments. Every setting can be left out to get its +; default. A line Wakes cannot read keeps its default, and the log (WAKES/LOGS/) names it. [usb] diff --git a/config/midi.ini b/config/midi.cnfg similarity index 93% rename from config/midi.ini rename to config/midi.cnfg index 16f5f37..0db9a20 100644 --- a/config/midi.ini +++ b/config/midi.cnfg @@ -1,14 +1,16 @@ +; Format: ini ; ===================================================================================== ; Wakes — the MIDI script ; ===================================================================================== ; -; How Wakes listens to MIDI over USB. Edit it in your fork, build (or let CI build) and -; flash: the build reads this file and FAILS with the line number if something in it is -; wrong, so a typo can never become a firmware that silently ignores your setting. -; Every build also writes a CC chart from this file (Markdown, and a CSV in the -; midi.guide format) next to the firmware, so your chart always matches your script. +; How Wakes listens to MIDI over USB. Wakes reads this file from its drive +; (WAKES/CNFG/midi.cnfg) every time it turns ON, so a change takes effect at the next ON. ; -; Lines starting with ; are comments. Every setting can be left out to get its default. +; Lines starting with ; or # are comments. Every setting can be left out to get its +; default. A line Wakes cannot read keeps its default, and the log (WAKES/LOGS/) names it. +; If two of your lines give the same CC, the first one keeps it and the later one gets +; none. A CC you give a parameter is taken from whichever parameter had it by default. +; The CC chart that comes with each Wakes release lists the default CCs. ; ; What MIDI does on Wakes, in short: ; NOTES play Plaits, one at a time (the newest, by default). A note-on strikes TRIG and @@ -25,7 +27,7 @@ ; UNPLUG: notes are released, the bend and every offset go back to neutral, and a ; Marbles the host was clocking stops and has its own clock again. ; -; docs/MIDI.md has the whole story. +; The Wakes manual has the whole story. ; ; Credit: the way Wakes plays notes -- which held note sounds, legato, portamento, the ; sustain pedal -- is ported from Mutable Instruments Yarns (Emilie Gillet, MIT): its @@ -190,7 +192,7 @@ lpg_decay = cc 25 level = cc 26 ; can connect LEVEL, as pushing the fader up does octave_range = cc 102 ; stepped: whole range modes ; Not on a fader at all: which engine plays, as an offset from the one T2/T3 selected, -; up through the filled slots of config/engines.cnfg (0 = the selected engine, 127 = the +; up through the filled slots of engines.cnfg (0 = the selected engine, 127 = the ; last slot). A change plays the engine flash, as T2/T3 do, and MIDI changes the engine at ; most every 50 ms -- each change costs the audio a moment, as a T2/T3 press does. model = cc 105 @@ -223,7 +225,7 @@ y_divider = cc 104 ; stepped ; velocity = [depth%] how hard each note was played ; aftertouch = [depth%] channel pressure ; -; is any name from the two lists above, and the depth is -100% .. 100% +; is any name from the two lists above (or none), and the depth is -100% .. 100% ; (default 100%). The source pushes that parameter up from where it is, by up to its ; whole travel at 100% -- an offset, whatever `pickup` says. ; @@ -232,7 +234,7 @@ y_divider = cc 104 ; stepped ; LEVEL. At 100% the hardest note opens it fully and the softest barely at all; at 50% ; the softest still opens it half way. It shapes MIDI notes only: once a note's release ; has ended, LEVEL is the fader's again, as it is for RWD, FFWD and Marbles' TRIG. -; To play every note at full LEVEL, comment out the velocity line. +; To play every note at full LEVEL, write `velocity = none`. ; ; You can also do this on the host instead: most DAWs can turn velocity or pressure ; into a CC, and aim it at the CC of the parameter you want. diff --git a/docs/MIDI.md b/docs/MIDI.md index f31e5d3..b9e6714 100644 --- a/docs/MIDI.md +++ b/docs/MIDI.md @@ -5,8 +5,9 @@ class-compliant **USB-MIDI** port called `Wakes` — no driver. It listens; it d (Through v0.6.x the port was called `wakes-sp1`: re-select it once in your DAW or host.) Nothing about it needs setting up on the device, and there are **no new pages**: notes play -Plaits straight away, and everything deeper is set in the MIDI script, -[`config/midi.ini`](../config/midi.ini), before the firmware is built. +Plaits straight away, and everything deeper is set in the MIDI script, `midi.cnfg`, on +Wakes' own drive (`WAKES/CNFG/midi.cnfg`): edit it from a computer, and Wakes reads it at the +next ON. ## What MIDI does @@ -195,10 +196,20 @@ Left free on purpose, for your own script: CC 1 (mod wheel), 2 (breath), 4 (foot ## Changing it: the MIDI script -[`config/midi.ini`](../config/midi.ini) is commented line by line. In a fork, edit it — GitHub's -web editor is enough — and the CI build of your fork produces a `.bin` with your settings. -The build **refuses** a script with a mistake in it and names the line, so a typo cannot become a -firmware that quietly ignores you. +`midi.cnfg` is commented line by line. It lives on Wakes' drive: plug Wakes into a computer +while it is off (STANDBY), open `WAKES/CNFG/midi.cnfg` in a text editor, save, and turn Wakes +ON — it reads the file at every ON. If the file is not there, Wakes writes it there with the +built-in settings, commented (so deleting it resets it at the next ON); the built-in default is [`config/midi.cnfg`](../config/midi.cnfg) in this repository, which is also +where to get a clean copy. + +- Every line can be left out: it keeps its default. +- A line Wakes cannot read keeps its default too, and the log (`WAKES/LOGS/`) names the line + and what is wrong with it. +- **A CC you give a parameter is taken from whichever parameter had it by default**, which then + has none (the log notes it). **Two of your own lines on the same CC: the first keeps it**, the + later one gets none (the log says so). CC 33–63 (the fine halves) and MIDI's reserved CCs + cannot be given. +- The CC chart that comes with each release lists the built-in CCs; your file may change them. What it sets: @@ -224,7 +235,8 @@ What it sets: (`velocity = timbre 40%`). Aimed at `level`, they set how far each note opens LEVEL — which Plaits also reads as accent, so soft notes are quieter and darker. **The shipped script has `velocity = level`** (100 %: the softest note barely opens it; at 50 % the - softest still opens it half way). Comment that line out to play every note at full LEVEL. + softest still opens it half way). Write `velocity = none` to play every note at full LEVEL + (leaving the line out keeps the built-in `level`). You can also do this on the host instead: most DAWs can turn velocity or pressure into a CC and aim it at one of the CCs above. diff --git a/docs/PLAITS-ENGINES.md b/docs/PLAITS-ENGINES.md index fcf9976..6007bc6 100644 --- a/docs/PLAITS-ENGINES.md +++ b/docs/PLAITS-ENGINES.md @@ -41,7 +41,8 @@ in the stack still plays it (its flash is all four LEDs fading down instead of a any problem — a name that is not an engine, an engine twice, a slot outside 1–24 or set twice, another section, no engine at all — Wakes plays the **built-in stack** and the log names every problem line (`CNFG engines.cnfg line N: …`). ROTC and the start go to the first filled slot of - whichever stack is in use. `wakes-sp1-fresh` writes the file there. + whichever stack is in use. If the file is not there, Wakes writes it there with the + built-in stack and the engine descriptions (so deleting it resets it at the next ON). - **In the repository, `config/engines.cnfg`** — the built-in stack every image carries, and the file fresh writes. The build checks it and stops on any problem, naming the line, so a broken default can never ship. diff --git a/firmware/CMakeLists.txt b/firmware/CMakeLists.txt index 19d6257..b0f71ae 100644 --- a/firmware/CMakeLists.txt +++ b/firmware/CMakeLists.txt @@ -34,12 +34,12 @@ add_custom_target(sp1_engines_gen DEPENDS ${SP1_ENGINES_H}) add_dependencies(app sp1_engines_gen) target_include_directories(app PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/sp1_generated) -# ---- the MIDI script (M5a): generated from config/midi.ini ---- +# ---- the MIDI script (M5a): generated from config/midi.cnfg ---- # Like the engine list: tools/gen_midi.py fails the build, naming the line, on anything # invalid. Generated in EVERY configuration, because the UI files read its enum even where # MIDI is compiled out (sp1_midi.h then stubs the calls). With MIDI in, it also writes this # build's CC chart next to the firmware: wakes-sp1-midi.md and .csv. -set(SP1_MIDI_INI ${CMAKE_CURRENT_SOURCE_DIR}/../config/midi.ini) +set(SP1_MIDI_CNFG ${CMAKE_CURRENT_SOURCE_DIR}/../config/midi.cnfg) set(SP1_MIDI_GEN ${CMAKE_CURRENT_SOURCE_DIR}/../tools/gen_midi.py) set(SP1_MIDI_H ${CMAKE_CURRENT_BINARY_DIR}/sp1_generated/sp1_midi_gen.h) set(SP1_MIDI_OUT ${SP1_MIDI_H}) @@ -51,24 +51,24 @@ if(CONFIG_SP1_MIDI) endif() add_custom_command( OUTPUT ${SP1_MIDI_OUT} - COMMAND ${Python3_EXECUTABLE} ${SP1_MIDI_GEN} ${SP1_MIDI_INI} ${SP1_MIDI_H} ${SP1_MIDI_CHART} - DEPENDS ${SP1_MIDI_INI} ${SP1_MIDI_GEN} - COMMENT "Generating the MIDI tables from config/midi.ini" + COMMAND ${Python3_EXECUTABLE} ${SP1_MIDI_GEN} ${SP1_MIDI_CNFG} ${SP1_MIDI_H} ${SP1_MIDI_CHART} + DEPENDS ${SP1_MIDI_CNFG} ${SP1_MIDI_GEN} + COMMENT "Generating the MIDI tables from config/midi.cnfg" ) add_custom_target(sp1_midi_gen DEPENDS ${SP1_MIDI_OUT}) add_dependencies(app sp1_midi_gen) -# ---- the audio settings: config/audio.ini -> sp1_audio_gen.h (M5c) ---- +# ---- the audio settings: config/audio.cnfg -> sp1_audio_gen.h (M5c) ---- # How sound leaves the device: USB audio out's level mode and the speaker while a host takes # it. Same rule as the MIDI script: a bad value fails the build, naming the line. -set(SP1_AUDIO_INI ${CMAKE_CURRENT_SOURCE_DIR}/../config/audio.ini) +set(SP1_AUDIO_CNFG ${CMAKE_CURRENT_SOURCE_DIR}/../config/audio.cnfg) set(SP1_AUDIO_GEN ${CMAKE_CURRENT_SOURCE_DIR}/../tools/gen_audio.py) set(SP1_AUDIO_H ${CMAKE_CURRENT_BINARY_DIR}/sp1_generated/sp1_audio_gen.h) add_custom_command( OUTPUT ${SP1_AUDIO_H} - COMMAND ${Python3_EXECUTABLE} ${SP1_AUDIO_GEN} ${SP1_AUDIO_INI} ${SP1_AUDIO_H} - DEPENDS ${SP1_AUDIO_INI} ${SP1_AUDIO_GEN} - COMMENT "Generating the audio settings from config/audio.ini" + COMMAND ${Python3_EXECUTABLE} ${SP1_AUDIO_GEN} ${SP1_AUDIO_CNFG} ${SP1_AUDIO_H} + DEPENDS ${SP1_AUDIO_CNFG} ${SP1_AUDIO_GEN} + COMMENT "Generating the audio settings from config/audio.cnfg" ) add_custom_target(sp1_audio_gen DEPENDS ${SP1_AUDIO_H}) add_dependencies(app sp1_audio_gen) diff --git a/firmware/Kconfig b/firmware/Kconfig index 7bdd487..0e2e044 100644 --- a/firmware/Kconfig +++ b/firmware/Kconfig @@ -210,7 +210,8 @@ config SP1_MIDI help A USB-MIDI 1.0 port (feldd's class, third_party/feldd) next to the console. Notes play Plaits, CCs offset parameters on both modules, all configured by - config/midi.ini at build time. Costs nothing until a host sends something. + the MIDI script (config/midi.cnfg built in, WAKES/CNFG/midi.cnfg on the drive at + every ON). Costs nothing until a host sends something. n: no MIDI function on the USB device at all. config SP1_USB_AUDIO diff --git a/firmware/src/main.c b/firmware/src/main.c index 28f57e2..bfbb85d 100644 --- a/firmware/src/main.c +++ b/firmware/src/main.c @@ -95,14 +95,15 @@ #include "sp1_prst.h" /* M6 (#50): the ROTC defaults main.c owns */ #include "sp1_release_guard.h" #include "sp1_midi.h" +#include "sp1_cnfg.h" /* the config types: midi.cnfg, audio.cnfg (#52) */ #endif #if defined(CONFIG_SP1_USB_AUDIO) #include "sp1_uac.h" -#include "sp1_audio_gen.h" /* config/audio.ini */ +#include "sp1_cnfg.h" /* struct sp1_audio_cfg: audio.cnfg, live (#52) */ #endif -/* ---- USB audio out's level (M5c; config/audio.ini [usb] level) ---- - * `parked`: while a host takes USB audio out (sp1_uac_live), VOL is set to audio.ini's +/* ---- USB audio out's level (M5c; audio.cnfg [usb] level) ---- + * `parked`: while a host takes USB audio out (sp1_uac_live), VOL is set to audio.cnfg's * parked_level and its buttons do nothing; when the host stops, VOL goes back to where the * user left it. Wakes has ONE output level for every output, so this parks the headphones * (and the speaker, if it is on) too -- deliberately: a separate USB level would be a second @@ -116,25 +117,29 @@ static int vol_saved; static int usb_parked_db(void) { - return SP1_AUDIO_USB_PARKED_DB; + return sp1_audio_config()->parked_db; } static void usb_level_park(bool usb_live) { - if (!SP1_AUDIO_USB_LEVEL_PARKED) { + const struct sp1_audio_cfg *ac = sp1_audio_config(); + /* Already parked when the settings changed (a new ON with `level = vol`): unpark. */ + if ((!ac->parked || !usb_live) && vol_parked) { + sp1_audio_level_step(vol_saved - sp1_audio_level_get()); + vol_parked = false; + printk("LEVEL back to step %d: no host takes USB audio out, VOL unlocked\n", + vol_saved); + return; + } + if (!ac->parked) { return; } if (usb_live && !vol_parked) { vol_saved = sp1_audio_level_get(); - sp1_audio_level_step(SP1_AUDIO_USB_PARKED_STEP - vol_saved); + sp1_audio_level_step((int)ac->parked_step - vol_saved); vol_parked = true; printk("LEVEL parked at %d dBFS: a host takes USB audio out, VOL locked" - " (config/audio.ini)\n", (int)SP1_AUDIO_USB_PARKED_DB); - } else if (!usb_live && vol_parked) { - sp1_audio_level_step(vol_saved - sp1_audio_level_get()); - vol_parked = false; - printk("LEVEL back to step %d: no host takes USB audio out, VOL unlocked\n", - vol_saved); + " (audio.cnfg)\n", (int)ac->parked_db); } } #else @@ -487,7 +492,7 @@ static void midi_tick(uint32_t dt, bool busy) const bool up = sp1_midi_port_up(); if (up != midi_port_was) { midi_port_was = up; - /* The script's pickup (config/midi.ini), so a log says which one was flashed. */ + /* The script's pickup (midi.cnfg, #52), so a log says which one is in use. */ static const char *const pickup[] = { [SP1_MIDI_PICKUP_SUM] = "sum: CCs offset the faders", [SP1_MIDI_PICKUP_SHARED] = "shared: CCs and faders share each value", @@ -495,7 +500,7 @@ static void midi_tick(uint32_t dt, bool busy) }; if (up) { printk("MIDI port enabled by the host (pickup %s)\n", - pickup[SP1_MIDI_PICKUP]); + pickup[sp1_midi_config()->pickup % 3u]); /* A host can start Marbles before PLAY ever has (M5b), so seed its * random stream now if PLAY has not: the moment a host enumerates * varies as much as the moment of a first PLAY. */ @@ -1454,6 +1459,25 @@ int main(void) } /* #52: the ON job may have installed a new engine stack (engines.cnfg). */ sp1_pui_stack_settle(); + /* ...and read audio.cnfg and midi.cnfg: applied here, before the MIDI reset and + * audio start below, so nothing runs on a half-applied script. */ + { + const struct sp1_audio_cfg *ac; + const struct sp1_midi_cfg *mc; + if (sp1_store_cnfg(&ac, &mc)) { +#if defined(CONFIG_SP1_USB_AUDIO) + sp1_audio_set_config(ac); +#endif +#if defined(CONFIG_SP1_MIDI) + sp1_midi_set_config(mc); +#endif + } else { + printk("CNFG not read this ON: audio and MIDI settings stay as they " + "were\n"); + } + ARG_UNUSED(ac); + ARG_UNUSED(mc); + } if (g_prst_on) { prst_apply(sp1_store_prst_slot(g_prst_slot)); } @@ -2283,10 +2307,10 @@ int main(void) * drive above instead, so this whole block stands down. */ if (!fnc && vol_parked && (sp1_button_pressed(SP1_BTN_VOL_DOWN) || sp1_button_pressed(SP1_BTN_VOL_UP))) { - /* config/audio.ini level = parked: a host is recording, so VOL stays - * where audio.ini put it until the host stops (usb_level_park). */ + /* audio.cnfg level = parked: a host is recording, so VOL stays + * where audio.cnfg put it until the host stops (usb_level_park). */ printk("LEVEL locked at %d dBFS while a host takes USB audio out" - " (config/audio.ini)\n", (int)usb_parked_db()); + " (audio.cnfg)\n", (int)usb_parked_db()); } if (!fnc && !vol_parked && sp1_button_pressed(SP1_BTN_VOL_DOWN)) { sp1_audio_level_step(+1); diff --git a/firmware/src/sp1_audio.c b/firmware/src/sp1_audio.c index 50f39ad..f5eed86 100644 --- a/firmware/src/sp1_audio.c +++ b/firmware/src/sp1_audio.c @@ -53,7 +53,29 @@ K_MEM_SLAB_DEFINE_STATIC(tx_slab, BLK_BYTES, TX_QUEUE + 4, 4); #if defined(CONFIG_SP1_USB_AUDIO) #include "sp1_uac.h" /* M5c: the same blocks, to the host */ -#include "sp1_audio_gen.h" /* config/audio.ini: the speaker while a host takes them */ +#include "sp1_audio_gen.h" /* config/audio.cnfg built in: the speaker while a host takes them */ +#include "sp1_cnfg.h" /* struct sp1_audio_cfg (#52) */ + +/* ---- the audio settings, LIVE (#52) ---- + * config/audio.cnfg's built-in values until main hands over the drive's + * WAKES/CNFG/audio.cnfg at ON entry (sp1_audio_set_config). Main writes and reads them. */ +static struct sp1_audio_cfg audio_cfg = SP1_AUDIO_CFG_DEFAULTS; + +void sp1_audio_set_config(const struct sp1_audio_cfg *c) +{ + audio_cfg = *c; + /* The reader only passes VOL's steps; a stray value parks at the default. */ + if (audio_cfg.parked_step >= SP1_LEVEL_STEPS - 1) { + const struct sp1_audio_cfg def = SP1_AUDIO_CFG_DEFAULTS; + audio_cfg.parked_step = def.parked_step; + audio_cfg.parked_db = def.parked_db; + } +} + +const struct sp1_audio_cfg *sp1_audio_config(void) +{ + return &audio_cfg; +} #endif #if defined(CONFIG_SP1_MIDI) @@ -236,12 +258,14 @@ static const int16_t TONE_AMP[SP1_LEVEL_STEPS] = { static const int16_t TONE_DB_X10[SP1_LEVEL_STEPS] = { 0, -30, -60, -90, -120, -151, -181, -211, -241, -271, -301, -9990, }; -/* config/audio.ini's parked_level is one of these steps, as tools/gen_audio.py knows them - * (0 .. -30 dB, 3 dB apart, then mute): parking USB audio out IS setting VOL (main.c). */ -BUILD_ASSERT(SP1_LEVEL_STEPS == 12, "VOL's steps changed: update VOL_STEPS in tools/gen_audio.py"); +/* audio.cnfg's parked_level is one of these steps, as tools/gen_audio.py and the drive's + * reader (sp1_cnfg.c) know them (0 .. -30 dB, 3 dB apart, then mute): parking USB audio out + * IS setting VOL (main.c). */ +BUILD_ASSERT(SP1_LEVEL_STEPS == 12, "VOL's steps changed: update VOL_STEPS in tools/gen_audio.py " + "and the parked_level check in sp1_cnfg.c"); #if defined(CONFIG_SP1_USB_AUDIO) BUILD_ASSERT(SP1_AUDIO_USB_PARKED_STEP >= 0 && SP1_AUDIO_USB_PARKED_STEP < SP1_LEVEL_STEPS - 1, - "config/audio.ini parked_level is not one of VOL's steps"); + "config/audio.cnfg parked_level is not one of VOL's steps"); #endif static volatile bool tone_on; @@ -939,7 +963,7 @@ void sp1_audio_take_sections(struct sp1_audio_sections *out) * While it is, the TAS2505's class-D driver is powered down (page 1, reg 0x2D). * * M5c (Adara, 2026-10-05): the speaker is also off while a host is TAKING USB audio out -- - * unless config/audio.ini says `speaker = on` (SP1_AUDIO_USB_SPEAKER; default off) + * unless audio.cnfg says `speaker = on` (sp1_audio_config(); default off) * (sp1_uac_live: the stream open AND packets going out since the last poll) -- recording * Wakes over USB, the speaker would only be a second, room copy. Anything short of that * defaults to the speaker (Adara): a charger, a host without USB audio or that rejects @@ -995,7 +1019,7 @@ static bool speaker_driver(bool on) static bool speaker_wanted(void) { #if defined(CONFIG_SP1_USB_AUDIO) - if (!SP1_AUDIO_USB_SPEAKER && sp1_uac_live()) { + if (!audio_cfg.speaker && sp1_uac_live()) { return false; } #endif diff --git a/firmware/src/sp1_audio.h b/firmware/src/sp1_audio.h index 3131a4d..10d763a 100644 --- a/firmware/src/sp1_audio.h +++ b/firmware/src/sp1_audio.h @@ -96,6 +96,14 @@ uint32_t sp1_audio_take_peak(void); void sp1_audio_level_step(int delta); /* +1 = quieter by 3 dB, -1 = louder */ int sp1_audio_level_get(void); + +#if defined(CONFIG_SP1_USB_AUDIO) +/* #52: the audio settings from the drive (audio.cnfg). Main, at ON entry. sp1_audio_config() + * is the live copy (the built-in one until then). */ +struct sp1_audio_cfg; +void sp1_audio_set_config(const struct sp1_audio_cfg *c); +const struct sp1_audio_cfg *sp1_audio_config(void); +#endif int sp1_audio_level_db_x10(void); /* tenths of dBFS, -9990 = mute */ /* ---- the fallback test tone (CONFIG_SP1_PLAITS=n only): 440 Hz, off at start ---- */ diff --git a/firmware/src/sp1_cnfg.c b/firmware/src/sp1_cnfg.c index 577a364..f34b81d 100644 --- a/firmware/src/sp1_cnfg.c +++ b/firmware/src/sp1_cnfg.c @@ -1,7 +1,11 @@ /* wakes-sp1 — the config files on the drive (#52). See sp1_cnfg.h. */ +/* midi.cnfg's reader needs the destinations' names (SP1_MIDI_NAME): a second, small copy of + * that table besides sp1_midi.cc's. Defined before the first include of sp1_midi_gen.h. */ +#define SP1_MIDI_GEN_TABLES #include "sp1_cnfg.h" #include "sp1_logs_gen.h" #include "sp1_engines_gen.h" +#include "sp1_audio_gen.h" #include @@ -466,3 +470,636 @@ uint8_t sp1_log_category(const char *line, size_t n) } return 0u; } + +/* ---------------------------------------------------------------- shared helpers */ + +/* A non-negative decimal, digits only, at most `max`. */ +static bool parse_uint(const char *s, int max, int *out) +{ + int v = 0; + if (*s == '\0') { + return false; + } + for (; *s != '\0'; s++) { + if (*s < '0' || *s > '9') { + return false; + } + v = v * 10 + (*s - '0'); + if (v > max) { + return false; + } + } + *out = v; + return true; +} + +/* "cc N" (also "ccN", any case) -> N 0-127; "none" / "off" / "" -> -1 when allowed; else -2. */ +static int parse_cc(const char *s, bool allow_none) +{ + if (allow_none && (s[0] == '\0' || same(s, "none") || same(s, "off"))) { + return -1; + } + if (lower(s[0]) != 'c' || lower(s[1]) != 'c') { + return -2; + } + s += 2; + while (space(*s)) { + s++; + } + int n; + return parse_uint(s, 127, &n) ? n : -2; +} + +/* MIDI's own CCs (tools/gen_midi.py RESERVED): bank select, data entry, (N)RPN, channel mode. */ +static const char *cc_reserved(int n) +{ + if (n == 0 || n == 32) { + return "bank select"; + } + if (n == 6 || n == 38 || n == 96 || n == 97) { + return "data entry"; + } + if (n >= 98 && n <= 101) { + return "parameter numbers (RPN / NRPN)"; + } + if (n >= 120) { + return "channel mode messages"; + } + return NULL; +} + +/* A small text builder for messages: no printf in this file. */ +struct msg { + char *b; + size_t size, n; +}; + +static void msg_s(struct msg *m, const char *s) +{ + while (*s != '\0' && m->n + 1u < m->size) { + m->b[m->n++] = *s++; + } + m->b[m->n] = '\0'; +} + +static void msg_i(struct msg *m, int v) +{ + char t[12]; + int k = 0; + unsigned u = (unsigned)(v < 0 ? -v : v); + do { + t[k++] = (char)('0' + u % 10u); + u /= 10u; + } while (u != 0u && k < 11); + if (v < 0) { + t[k++] = '-'; + } + while (k > 0 && m->n + 1u < m->size) { + m->b[m->n++] = t[--k]; + } + m->b[m->n] = '\0'; +} + +static const char *key_value(char *buf, const char *key, const char *value) +{ + struct msg m = { buf, SP1_CNFG_LINE_MAX + 4u, 0u }; + msg_s(&m, key); + msg_s(&m, " = "); + msg_s(&m, value); + return buf; +} + +/* ---------------------------------------------------------------- audio.cnfg */ + +_Static_assert(sizeof(struct sp1_audio_cfg) == 4u, "SP1_AUDIO_CFG_DEFAULTS: one value a field"); + +void sp1_audio_cfg_defaults(struct sp1_audio_cfg *c) +{ + static const struct sp1_audio_cfg def = SP1_AUDIO_CFG_DEFAULTS; + *c = def; +} + +static void audio_report(struct sp1_audio_reader *r, int line, const char *what, const char *why) +{ + r->problems++; + r->problem(r->ctx, line, what, why); +} + +static void audio_problem(void *ctx, int line, const char *what, const char *why) +{ + audio_report(ctx, line, what, why); +} + +static void audio_entry(void *ctx, int line, const char *section, const char *key, + const char *value) +{ + struct sp1_audio_reader *r = ctx; + if (section[0] == '\0') { + audio_report(r, line, key, "is not under [usb]: ignored"); + return; + } + if (strcmp(section, "usb") != 0) { + if (strcmp(section, r->bad_section) != 0) { + strcpy(r->bad_section, section); + audio_report(r, line, section, "is not a section of audio.cnfg (expected [usb]): " + "its settings are ignored"); + } + return; + } + static const char *const KEYS[] = { "level", "parked_level", "speaker" }; + int k = -1; + for (int i = 0; i < 3; i++) { + if (strcmp(key, KEYS[i]) == 0) { + k = i; + } + } + if (k < 0) { + audio_report(r, line, key, "is not an audio.cnfg setting: ignored"); + return; + } + if (r->seen & (1u << k)) { + audio_report(r, line, key, "is set twice: the first one is used"); + return; + } + r->seen |= (uint8_t)(1u << k); + if (k == 0) { + if (same(value, "parked")) { + r->cfg->parked = 1u; + } else if (same(value, "vol")) { + r->cfg->parked = 0u; + } else { + audio_report(r, line, key_value(r->what, key, value), + "must be parked or vol: the default is used"); + } + } else if (k == 1) { + /* -6, -6 dB, -6db; 0. One of VOL's steps: 0 .. -30, 3 dB apart. */ + char t[16]; + size_t n = 0u; + const char *s = value; + bool neg = false; + if (*s == '-' || *s == '+') { + neg = (*s == '-'); + s++; + } + while (*s >= '0' && *s <= '9' && n < sizeof(t) - 1u) { + t[n++] = *s++; + } + t[n] = '\0'; + while (space(*s)) { + s++; + } + int db; + const bool unit_ok = (*s == '\0') || same(s, "db"); + if (n == 0u || !unit_ok || !parse_uint(t, 99, &db) || (db != 0 && !neg) || + db > 30 || db % 3 != 0) { + audio_report(r, line, key_value(r->what, key, value), + "must be one of VOL's steps (0, -3, -6 ... -30): the default is used"); + } else { + r->cfg->parked_db = (int8_t)(-db); + r->cfg->parked_step = (uint8_t)(db / 3); + } + } else { + if (same(value, "on")) { + r->cfg->speaker = 1u; + } else if (same(value, "off")) { + r->cfg->speaker = 0u; + } else { + audio_report(r, line, key_value(r->what, key, value), + "must be on or off: the default is used"); + } + } +} + +void sp1_audio_reader_begin(struct sp1_audio_reader *r, struct sp1_audio_cfg *c, + sp1_cnfg_problem_fn problem, void *ctx) +{ + memset(r, 0, sizeof(*r)); + sp1_audio_cfg_defaults(c); + r->cfg = c; + r->problem = problem; + r->ctx = ctx; + sp1_cnfg_begin(&r->p, audio_entry, audio_problem, r); +} + +void sp1_audio_reader_feed(struct sp1_audio_reader *r, const char *text, size_t n) +{ + sp1_cnfg_feed(&r->p, text, n); +} + +int sp1_audio_reader_end(struct sp1_audio_reader *r) +{ + sp1_cnfg_end(&r->p); + return r->problems; +} + +/* ---------------------------------------------------------------- midi.cnfg */ + +_Static_assert(SP1_MIDI_DESTS <= 31, "seen_dest is a 32-bit mask"); + +void sp1_midi_cfg_defaults(struct sp1_midi_cfg *c) +{ + static const struct sp1_midi_cfg def = SP1_MIDI_CFG_DEFAULTS; + *c = def; +} + +/* SP1_MIDI_NAME[d] is "
". */ +static bool dest_is(int d, const char *section, const char *key) +{ + const char *n = SP1_MIDI_NAME[d]; + const size_t s = strlen(section); + return strncmp(n, section, s) == 0 && n[s] == ' ' && strcmp(n + s + 1, key) == 0; +} + +static const char *dest_key(int d) +{ + const char *n = strchr(SP1_MIDI_NAME[d], ' '); + return n != NULL ? n + 1 : SP1_MIDI_NAME[d]; +} + +static void midi_report(struct sp1_midi_reader *r, int line, const char *what, const char *why) +{ + r->problems++; + r->problem(r->ctx, line, what, why); +} + +static void midi_problem(void *ctx, int line, const char *what, const char *why) +{ + midi_report(ctx, line, what, why); +} + +static bool once(struct sp1_midi_reader *r, int line, const char *key, uint32_t *seen, + uint32_t bit) +{ + if (*seen & bit) { + midi_report(r, line, key, "is set twice: the first one is used"); + return false; + } + *seen |= bit; + return true; +} + +/* A CC value for `who` (a destination, or the sustain pedal): checked, then queued for the + * collision pass at the end. */ +static void take_cc(struct sp1_midi_reader *r, int line, int who, const char *key, + const char *value) +{ + const int n = parse_cc(value, true); + struct msg m = { r->why, sizeof(r->why), 0u }; + if (n == -2) { + midi_report(r, line, key_value(r->what, key, value), + "is not `cc N` with N 0-127 (or none): the default is kept"); + return; + } + if (n >= 0 && cc_reserved(n) != NULL) { + msg_s(&m, "CC "); + msg_i(&m, n); + msg_s(&m, " is reserved by MIDI ("); + msg_s(&m, cc_reserved(n)); + msg_s(&m, "): the default is kept"); + midi_report(r, line, key_value(r->what, key, value), r->why); + return; + } + if (n >= 33 && n <= 63) { + msg_s(&m, "CC "); + msg_i(&m, n); + msg_s(&m, " is the fine half of 14-bit CC "); + msg_i(&m, n - 32); + msg_s(&m, "; use CC "); + msg_i(&m, n - 32); + msg_s(&m, ": the default is kept"); + midi_report(r, line, key_value(r->what, key, value), r->why); + return; + } + r->user_cc[who] = (int8_t)n; + r->user_line[who] = (int16_t)line; + r->order[r->n_order++] = (uint8_t)who; +} + +static void midi_section(struct sp1_midi_reader *r, int line, const char *key, const char *value) +{ + static const char *const KEYS[] = { + "channel", "note_priority", "legato", "portamento", "bend_range", "sustain", + "cc_smoothing", "pickup", "clock", "clock_lead", + }; + int k = -1; + for (int i = 0; i < (int)(sizeof(KEYS) / sizeof(KEYS[0])); i++) { + if (strcmp(key, KEYS[i]) == 0) { + k = i; + } + } + if (k < 0) { + midi_report(r, line, key, "is not a [midi] setting: ignored"); + return; + } + uint32_t seen = r->seen_midi; + const bool first = once(r, line, key, &seen, 1u << k); + r->seen_midi = (uint16_t)seen; + if (!first) { + return; + } + struct sp1_midi_cfg *c = r->cfg; + const char *why = NULL; + int v; + switch (k) { + case 0: /* channel: 1-16 or omni */ + if (same(value, "omni")) { + c->channel = SP1_MIDI_OMNI; + } else if (parse_uint(value, 16, &v) && v >= 1) { + c->channel = (int8_t)(v - 1); + } else { + why = "must be 1-16 or omni: the default is used"; + } + break; + case 1: /* note_priority */ + if (same(value, "last")) { + c->priority = 0u; + } else if (same(value, "low")) { + c->priority = 1u; + } else if (same(value, "high")) { + c->priority = 2u; + } else { + why = "must be last, low or high: the default is used"; + } + break; + case 2: /* legato: off 0, auto 1, on 2 (Yarns) */ + if (same(value, "off")) { + c->legato = 0u; + } else if (same(value, "auto")) { + c->legato = 1u; + } else if (same(value, "on")) { + c->legato = 2u; + } else { + why = "must be off, on or auto: the default is used"; + } + break; + case 3: /* portamento: 0, t1-t50 (time), r0-r50 (rate) */ + if (strcmp(value, "0") == 0) { + c->portamento = 0u; + } else if (lower(value[0]) == 't' && parse_uint(value + 1, 50, &v) && v >= 1) { + c->portamento = (uint8_t)v; + } else if (lower(value[0]) == 'r' && parse_uint(value + 1, 50, &v)) { + c->portamento = (uint8_t)(51 + v); + } else { + why = "must be 0, t1-t50 or r0-r50: the default is used"; + } + break; + case 4: /* bend_range: 0-24 */ + if (parse_uint(value, 24, &v)) { + c->bend_range = (uint8_t)v; + } else { + why = "must be 0-24 semitones: the default is used"; + } + break; + case 5: /* sustain: cc N, or off */ + take_cc(r, line, SP1_MIDI_WHO_SUSTAIN, key, value); + return; + case 6: /* cc_smoothing: 0-200 ms */ + if (parse_uint(value, 200, &v)) { + c->smooth_ms = (uint8_t)v; + } else { + why = "must be 0-200 (ms): the default is used"; + } + break; + case 7: /* pickup */ + if (same(value, "sum")) { + c->pickup = SP1_MIDI_PICKUP_SUM; + } else if (same(value, "shared")) { + c->pickup = SP1_MIDI_PICKUP_SHARED; + } else if (same(value, "takeover")) { + c->pickup = SP1_MIDI_PICKUP_TAKEOVER; + } else { + why = "must be sum, shared or takeover: the default is used"; + } + break; + case 8: /* clock */ + if (same(value, "on")) { + c->clock = 1u; + } else if (same(value, "off")) { + c->clock = 0u; + } else { + why = "must be on or off: the default is used"; + } + break; + default: /* clock_lead: notes, auto, or 0-200 ms */ + if (same(value, "notes")) { + c->clock_lead_ms = -2; + } else if (same(value, "auto")) { + c->clock_lead_ms = -1; + } else if (parse_uint(value, 200, &v)) { + c->clock_lead_ms = (int16_t)v; + } else { + why = "must be notes, auto or 0-200 (ms): the default is used"; + } + break; + } + if (why != NULL) { + midi_report(r, line, key_value(r->what, key, value), why); + } +} + +/* [bind]: velocity / aftertouch = [depth%], or none. */ +static void bind_section(struct sp1_midi_reader *r, int line, const char *key, const char *value) +{ + const int src = strcmp(key, "velocity") == 0 ? 0 : (strcmp(key, "aftertouch") == 0 ? 1 : -1); + if (src < 0) { + midi_report(r, line, key, "is not a [bind] source (velocity or aftertouch): ignored"); + return; + } + uint32_t seen = r->seen_bind; + const bool first = once(r, line, key, &seen, 1u << src); + r->seen_bind = (uint8_t)seen; + if (!first) { + return; + } + int dest = -1; + int depth = 100; + if (!same(value, "none")) { + char name[SP1_CNFG_NAME_MAX]; + size_t n = 0u; + const char *s = value; + while (*s != '\0' && !space(*s) && n < sizeof(name) - 1u) { + name[n++] = lower(*s++); + } + name[n] = '\0'; + bool ok = n > 0u && (*s == '\0' || space(*s)); /* the name ends at a space */ + while (space(*s)) { + s++; + } + if (ok && *s != '\0') { + /* "[-]N%" */ + char t[8]; + size_t k = 0u; + const bool neg = (*s == '-'); + if (neg) { + s++; + } + while (*s >= '0' && *s <= '9' && k < sizeof(t) - 1u) { + t[k++] = *s++; + } + t[k] = '\0'; + while (space(*s)) { + s++; + } + int pct = 0; + ok = k > 0u && *s == '%' && s[1] == '\0' && parse_uint(t, 100, &pct); + depth = neg ? -pct : pct; + } + for (int d = 0; ok && d < SP1_MIDI_DESTS && dest < 0; d++) { + if (strcmp(dest_key(d), name) == 0) { + dest = d; + } + } + if (!ok || dest < 0) { + midi_report(r, line, key_value(r->what, key, value), + "is not ` [depth%]` with a parameter from the lists above " + "and a depth of -100% to 100% (or none): the default is used"); + return; + } + } + if (src == 0) { + r->cfg->vel_dest = (int8_t)dest; + r->cfg->vel_depth = (float)depth * 0.01f; + } else { + r->cfg->at_dest = (int8_t)dest; + r->cfg->at_depth = (float)depth * 0.01f; + } +} + +static void midi_entry(void *ctx, int line, const char *section, const char *key, + const char *value) +{ + struct sp1_midi_reader *r = ctx; + if (section[0] == '\0') { + midi_report(r, line, key, "is not under a section: ignored"); + return; + } + if (strcmp(section, "midi") == 0) { + midi_section(r, line, key, value); + return; + } + if (strcmp(section, "bind") == 0) { + bind_section(r, line, key, value); + return; + } + if (strcmp(section, "plaits") == 0 || strcmp(section, "marbles") == 0) { + for (int d = 0; d < SP1_MIDI_DESTS; d++) { + if (dest_is(d, section, key)) { + if (once(r, line, key, &r->seen_dest, 1u << d)) { + take_cc(r, line, d, key, value); + } + return; + } + } + struct msg m = { r->why, sizeof(r->why), 0u }; + msg_s(&m, "is not a parameter of ["); + msg_s(&m, section); + msg_s(&m, "]: ignored"); + midi_report(r, line, key, r->why); + return; + } + if (strcmp(section, r->bad_section) != 0) { + strcpy(r->bad_section, section); + midi_report(r, line, section, "is not a section of midi.cnfg (expected [midi], [plaits], " + "[marbles] or [bind]): its settings are ignored"); + } +} + +void sp1_midi_reader_begin(struct sp1_midi_reader *r, struct sp1_midi_cfg *c, + sp1_cnfg_problem_fn problem, void *ctx) +{ + memset(r, 0, sizeof(*r)); + sp1_midi_cfg_defaults(c); + r->cfg = c; + r->problem = problem; + r->ctx = ctx; + for (int i = 0; i <= SP1_MIDI_DESTS; i++) { + r->user_cc[i] = -2; + } + sp1_cnfg_begin(&r->p, midi_entry, midi_problem, r); +} + +void sp1_midi_reader_feed(struct sp1_midi_reader *r, const char *text, size_t n) +{ + sp1_cnfg_feed(&r->p, text, n); +} + +static const char *who_name(int who) +{ + return who == SP1_MIDI_WHO_SUSTAIN ? "the sustain pedal" : SP1_MIDI_NAME[who]; +} + +int sp1_midi_reader_end(struct sp1_midi_reader *r, int *notes) +{ + sp1_cnfg_end(&r->p); + struct sp1_midi_cfg def; + sp1_midi_cfg_defaults(&def); + int8_t owner[128]; + int16_t owner_line[128]; + memset(owner, -1, sizeof(owner)); + memset(owner_line, 0, sizeof(owner_line)); + + /* 1. Your lines, in file order: the first to name a CC keeps it. */ + for (int k = 0; k < r->n_order; k++) { + const int who = r->order[k]; + const int cc = r->user_cc[who]; + if (cc < 0) { + continue; + } + if (owner[cc] >= 0) { + struct msg m = { r->why, sizeof(r->why), 0u }; + msg_s(&m, "CC "); + msg_i(&m, cc); + msg_s(&m, " is already given to "); + msg_s(&m, who_name(owner[cc])); + msg_s(&m, " on line "); + msg_i(&m, owner_line[cc]); + msg_s(&m, ": this one gets none"); + midi_report(r, r->user_line[who], who == SP1_MIDI_WHO_SUSTAIN ? "sustain" + : dest_key(who), r->why); + r->user_cc[who] = -1; + continue; + } + owner[cc] = (int8_t)who; + owner_line[cc] = r->user_line[who]; + } + + /* 2. The defaults of everything you did not set: a CC one of your lines took is gone. */ + for (int who = 0; who <= SP1_MIDI_DESTS; who++) { + if (r->user_cc[who] != -2) { + continue; + } + const int cc = (who == SP1_MIDI_WHO_SUSTAIN) ? def.sustain_cc : def.dest_cc[who]; + if (cc < 0) { + r->user_cc[who] = -1; + continue; + } + if (owner[cc] >= 0) { + struct msg m = { r->why, sizeof(r->why), 0u }; + msg_s(&m, "note: takes CC "); + msg_i(&m, cc); + msg_s(&m, " from "); + msg_s(&m, who_name(who)); + msg_s(&m, ", which has no CC now"); + r->notes++; + r->problem(r->ctx, owner_line[cc], who_name(owner[cc]), r->why); + r->user_cc[who] = -1; + continue; + } + owner[cc] = (int8_t)who; + r->user_cc[who] = (int8_t)cc; + } + + /* 3. The tables. */ + memset(r->cfg->cc_dest, -1, sizeof(r->cfg->cc_dest)); + for (int d = 0; d < SP1_MIDI_DESTS; d++) { + r->cfg->dest_cc[d] = r->user_cc[d]; + if (r->user_cc[d] >= 0) { + r->cfg->cc_dest[r->user_cc[d]] = (int8_t)d; + } + } + r->cfg->sustain_cc = r->user_cc[SP1_MIDI_WHO_SUSTAIN]; + if (notes != NULL) { + *notes = r->notes; + } + return r->problems; +} diff --git a/firmware/src/sp1_cnfg.h b/firmware/src/sp1_cnfg.h index 833d47d..124f793 100644 --- a/firmware/src/sp1_cnfg.h +++ b/firmware/src/sp1_cnfg.h @@ -7,7 +7,8 @@ * ---- the rules (Adara, #52) ---- * - config/.cnfg in the repository is the built-in DEFAULT, compiled into every * image (tools/gen_.py, which fails the build on a bad default). End users never - * touch it: they edit the copy on the drive, which wakes-sp1-fresh writes. + * touch it: they edit the copy on the drive, which every image writes there when it is + * missing (Adara: no trip to the repo, no fresh flash, to get a file back). * - Read at EVERY ON, before PRST and before audio. A line overrides its default; a line * left out keeps it; a line that cannot be read keeps it too, and the log names it. * - The same key twice: the FIRST is used, the later one is reported. @@ -163,4 +164,92 @@ void sp1_engines_feed(struct sp1_engines_reader *r, const char *text, size_t n); * built-in stack. `*filled` = engines in `out`. */ int sp1_engines_end(struct sp1_engines_reader *r, uint8_t out[SP1_CNFG_SLOTS], int *filled); +/* ---------------------------------------------------------------- audio.cnfg */ + +/* How sound leaves the device: USB audio out's level and the speaker while a host takes it. + * The built-in values are config/audio.cnfg's (SP1_AUDIO_CFG_DEFAULTS, sp1_audio_gen.h, in + * this field order); sp1_audio.c holds the live copy (sp1_audio_set_config). */ +struct sp1_audio_cfg { + uint8_t parked; /* [usb] level: 1 parked, 0 vol */ + int8_t parked_db; /* [usb] parked_level, 0 .. -30 in 3 dB steps */ + uint8_t parked_step; /* ...as VOL's step, -parked_db / 3 */ + uint8_t speaker; /* [usb] speaker: 1 on while a host takes USB audio out */ +}; +void sp1_audio_cfg_defaults(struct sp1_audio_cfg *c); + +/* Line by line over the built-in values, like logs.cnfg. */ +struct sp1_audio_reader { + struct sp1_cnfg_parser p; + struct sp1_audio_cfg *cfg; + sp1_cnfg_problem_fn problem; + void *ctx; + uint8_t seen; + char bad_section[SP1_CNFG_NAME_MAX]; + char what[SP1_CNFG_LINE_MAX + 4]; + int problems; +}; +void sp1_audio_reader_begin(struct sp1_audio_reader *r, struct sp1_audio_cfg *c, + sp1_cnfg_problem_fn problem, void *ctx); +void sp1_audio_reader_feed(struct sp1_audio_reader *r, const char *text, size_t n); +int sp1_audio_reader_end(struct sp1_audio_reader *r); + +/* ---------------------------------------------------------------- midi.cnfg */ + +#include "sp1_midi_gen.h" /* SP1_MIDI_DESTS and the destination enum */ + +/* The MIDI script. The built-in values are config/midi.cnfg's (SP1_MIDI_CFG_DEFAULTS, + * sp1_midi_gen.h, in this field order); sp1_midi.cc holds the live copy + * (sp1_midi_set_config), which every thread reads and only main writes, at ON entry with the + * audio thread stopped. */ +struct sp1_midi_cfg { + int8_t channel; /* 0-15, or SP1_MIDI_OMNI */ + uint8_t priority; /* stmlib NoteStackFlags: 0 last, 1 low, 2 high */ + uint8_t legato; /* Yarns legato_mode: 0 off, 1 auto, 2 on */ + uint8_t portamento; /* Yarns: 0 none, 1-50 time, 51-101 rate */ + uint8_t bend_range; /* semitones, until RPN 0 says otherwise */ + int8_t sustain_cc; /* -1 = no sustain pedal */ + uint8_t smooth_ms; /* 0-200 */ + uint8_t pickup; /* SP1_MIDI_PICKUP_SUM / _SHARED / _TAKEOVER */ + uint8_t clock; /* 1 = Marbles follows MIDI clock + transport */ + int16_t clock_lead_ms; /* 0-200; -1 auto, -2 notes */ + int8_t vel_dest; /* [bind] velocity: a destination, or -1 */ + int8_t at_dest; /* [bind] aftertouch */ + float vel_depth; /* -1 .. 1 */ + float at_depth; + int8_t dest_cc[SP1_MIDI_DESTS]; /* destination -> its CC (coarse half), or -1 */ + int8_t cc_dest[128]; /* CC -> destination, or -1 */ +}; +void sp1_midi_cfg_defaults(struct sp1_midi_cfg *c); + +/* Line by line over the built-in values, like logs.cnfg -- plus the CC rule (Adara, #52): + * - a CC you give a parameter (or the sustain pedal) is TAKEN from whichever parameter had + * it by default, which gets none (a note in the log, not a problem); + * - two of your lines on the same CC: the FIRST keeps it, the later gets none (a problem); + * - CC 33-63 are the fine halves of 1-31 and cannot be given; reserved CCs neither. + * `velocity = none` / `aftertouch = none` remove a binding. */ +#define SP1_MIDI_WHO_SUSTAIN SP1_MIDI_DESTS +struct sp1_midi_reader { + struct sp1_cnfg_parser p; + struct sp1_midi_cfg *cfg; + sp1_cnfg_problem_fn problem; + void *ctx; + uint16_t seen_midi; /* [midi] keys set (the first wins) */ + uint32_t seen_dest; /* destinations set */ + uint8_t seen_bind; + int8_t user_cc[SP1_MIDI_DESTS + 1]; /* -2 not given, -1 none, else the CC; */ + int16_t user_line[SP1_MIDI_DESTS + 1]; /* index SP1_MIDI_WHO_SUSTAIN = sustain */ + uint8_t order[SP1_MIDI_DESTS + 1]; /* the CC lines in file order */ + uint8_t n_order; + char bad_section[SP1_CNFG_NAME_MAX]; + char what[SP1_CNFG_LINE_MAX + 4]; + char why[160]; + int problems; + int notes; /* defaults that gave up their CC */ +}; +void sp1_midi_reader_begin(struct sp1_midi_reader *r, struct sp1_midi_cfg *c, + sp1_cnfg_problem_fn problem, void *ctx); +void sp1_midi_reader_feed(struct sp1_midi_reader *r, const char *text, size_t n); +/* Problems; `*notes` = defaults that gave up their CC to one of your lines. */ +int sp1_midi_reader_end(struct sp1_midi_reader *r, int *notes); + #endif /* SP1_CNFG_H */ diff --git a/firmware/src/sp1_midi.cc b/firmware/src/sp1_midi.cc index bd139bd..ebb4a52 100644 --- a/firmware/src/sp1_midi.cc +++ b/firmware/src/sp1_midi.cc @@ -19,6 +19,7 @@ #define SP1_MIDI_GEN_TABLES #include "sp1_midi.h" #include "sp1_synth.h" // SP1_SYNTH_BLOCK: MIDI runs once per Plaits block (#32) +#include "sp1_cnfg.h" // struct sp1_midi_cfg: the script, live (#52) #include #include @@ -87,6 +88,12 @@ bool trig_pending; uint8_t velocity; // latest note's, Yarns' mod_velocity_ uint8_t aftertouch; +// ---- the MIDI script, LIVE (#52) ---- +// config/midi.cnfg's built-in values until main hands over the drive's WAKES/CNFG/midi.cnfg +// at ON entry (sp1_midi_set_config), with the audio thread stopped. The audio thread, the USB +// interrupt and main all read it; only that call writes it. +sp1_midi_cfg g_cfg = SP1_MIDI_CFG_DEFAULTS; + // Yarns Voice: the glide, in semitones. float note_source = 60.0f, note_target = 60.0f, note_now = 60.0f; float porta_phase = 1.0f, porta_inc = 0.0f; @@ -203,10 +210,10 @@ volatile bool out_usb; // main: a host is taking USB audio // they have said, auto (lead_learned < 0). A fixed number of ms otherwise. float lead_learned = -1.0f; float Lead() { - if (SP1_MIDI_CLOCK_LEAD_MS >= 0) { - return static_cast(SP1_MIDI_CLOCK_LEAD_MS) * static_cast(kBlocksPerMs); + if (g_cfg.clock_lead_ms >= 0) { + return static_cast(g_cfg.clock_lead_ms) * static_cast(kBlocksPerMs); } - if (SP1_MIDI_CLOCK_LEAD_MS == -2 && lead_learned >= 0.0f) { + if (g_cfg.clock_lead_ms == -2 && lead_learned >= 0.0f) { return lead_learned; } return out_usb ? kLeadAutoUsbBlocks : kLeadAutoBlocks; @@ -289,12 +296,12 @@ bool prev_begin_valid; inline float Clamp(float v, float lo, float hi) { return v < lo ? lo : (v > hi ? hi : v); } -// ---- the pickup setting (config/midi.ini `pickup`, Adara, M5a round 4) ---- +// ---- the pickup setting (midi.cnfg `pickup`, Adara, M5a round 4) ---- // sum: a CC is an OFFSET on its fader. shared / takeover: a CC is a POSITION on the fader's // own value, which the UI moves through sp1_midi_drive() -- so there it is no offset at all. // MODEL has no fader and is an offset in every setting. -constexpr bool CcIsOffset(int d) { - return SP1_MIDI_PICKUP == SP1_MIDI_PICKUP_SUM || d == SP1_MIDI_D_MODEL; +inline bool CcIsOffset(int d) { + return g_cfg.pickup == SP1_MIDI_PICKUP_SUM || d == SP1_MIDI_D_MODEL; } // ---- Plaits' catch-up: plaits/pot_controller.h, POT_STATE_CATCHING_UP (Emilie Gillet, MIT) ---- @@ -390,11 +397,12 @@ void Refresh() { note_now = note_source + (note_target - note_source) * k; } -const stmlib::NoteStackFlags kPriority = - static_cast(SP1_MIDI_PRIORITY); +stmlib::NoteStackFlags Priority() { + return static_cast(g_cfg.priority); +} uint8_t Top() { - return stack.note_by_priority(kPriority).note; + return stack.note_by_priority(Priority()).note; } // ---- Yarns part.cc, the 1M (mono) branches ------------------------------------------------ @@ -412,19 +420,19 @@ void NoteOn(uint8_t note, uint8_t vel) { // the same pitch is one long note. Either way the note-off of the first one will not end // it (on_count). stack.NoteOn(note, vel); - if (SP1_MIDI_LEGATO == 0) { - Glide(note, vel, SP1_MIDI_PORTAMENTO, true); + if (g_cfg.legato == 0) { + Glide(note, vel, g_cfg.portamento, true); } return; } const uint8_t before = Top(); stack.NoteOn(note, vel); - const stmlib::NoteEntry& after = stack.note_by_priority(kPriority); + const stmlib::NoteEntry& after = stack.note_by_priority(Priority()); if (before != after.note) { const bool legato = stack.size() > 1; Glide(after.note, after.velocity, - (SP1_MIDI_LEGATO == 1) && !legato ? 0 : SP1_MIDI_PORTAMENTO, - (SP1_MIDI_LEGATO == 0) || !legato); + (g_cfg.legato == 1) && !legato ? 0 : g_cfg.portamento, + (g_cfg.legato == 0) || !legato); } } @@ -438,10 +446,10 @@ void InternalNoteOff(uint8_t note) { tail = true; } } else { - const stmlib::NoteEntry& after = stack.note_by_priority(kPriority); + const stmlib::NoteEntry& after = stack.note_by_priority(Priority()); if (before != after.note) { // Back to a key that is still held: slide there, and in legato off strike again. - Glide(after.note, after.velocity, SP1_MIDI_PORTAMENTO, SP1_MIDI_LEGATO == 0); + Glide(after.note, after.velocity, g_cfg.portamento, g_cfg.legato == 0); } } } @@ -534,11 +542,11 @@ void Publish(int d) { // their depth, whichever way the CC reads. Aimed at LEVEL they shape the gate height // instead (GateHeight()). float bound = 0.0f; - if (SP1_MIDI_VELOCITY_DEST == d && d != SP1_MIDI_D_LEVEL) { - bound += SP1_MIDI_VELOCITY_DEPTH * static_cast(velocity) / 127.0f; + if (g_cfg.vel_dest == d && d != SP1_MIDI_D_LEVEL) { + bound += g_cfg.vel_depth * static_cast(velocity) / 127.0f; } - if (SP1_MIDI_AFTERTOUCH_DEST == d && d != SP1_MIDI_D_LEVEL) { - bound += SP1_MIDI_AFTERTOUCH_DEPTH * static_cast(aftertouch) / 127.0f; + if (g_cfg.at_dest == d && d != SP1_MIDI_D_LEVEL) { + bound += g_cfg.at_depth * static_cast(aftertouch) / 127.0f; } const bool offset = CcIsOffset(d); target_bi[d] = Clamp((offset ? CcOffset(d, true) : 0.0f) + bound, -1.0f, 1.0f); @@ -647,11 +655,11 @@ void ResetControllers() { // The gate's height. 1 unless velocity or aftertouch is bound to LEVEL. float GateHeight() { float h = 1.0f; - if (SP1_MIDI_VELOCITY_DEST == SP1_MIDI_D_LEVEL) { - h *= 1.0f + SP1_MIDI_VELOCITY_DEPTH * (static_cast(velocity) / 127.0f - 1.0f); + if (g_cfg.vel_dest == SP1_MIDI_D_LEVEL) { + h *= 1.0f + g_cfg.vel_depth * (static_cast(velocity) / 127.0f - 1.0f); } - if (SP1_MIDI_AFTERTOUCH_DEST == SP1_MIDI_D_LEVEL) { - h *= 1.0f + SP1_MIDI_AFTERTOUCH_DEPTH * (static_cast(aftertouch) / 127.0f - 1.0f); + if (g_cfg.at_dest == SP1_MIDI_D_LEVEL) { + h *= 1.0f + g_cfg.at_depth * (static_cast(aftertouch) / 127.0f - 1.0f); } return Clamp(h, 0.0f, 1.0f); } @@ -668,7 +676,7 @@ bool RpnBendSelected() { } void ControlChange(uint8_t cc, uint8_t v) { - if (SP1_MIDI_SUSTAIN_CC >= 0 && cc == SP1_MIDI_SUSTAIN_CC) { + if (g_cfg.sustain_cc >= 0 && cc == static_cast(g_cfg.sustain_cc)) { Sustain(v >= 64); return; } @@ -713,7 +721,7 @@ void ControlChange(uint8_t cc, uint8_t v) { } int d; if (cc >= 32 && cc < 64) { - d = SP1_MIDI_CC_DEST[cc - 32]; // the fine half of a 14-bit pair + d = g_cfg.cc_dest[cc - 32]; // the fine half of a 14-bit pair if (d < 0) { ++st_ignored; return; @@ -722,7 +730,7 @@ void ControlChange(uint8_t cc, uint8_t v) { cc_has_lsb[d] = true; cc_present[d] = true; } else { - d = SP1_MIDI_CC_DEST[cc]; + d = g_cfg.cc_dest[cc]; if (d < 0) { ++st_ignored; return; @@ -743,7 +751,7 @@ void ControlChange(uint8_t cc, uint8_t v) { __attribute__((noinline)) void Process(const Event& e) { const uint8_t status = e.msg[0]; const uint8_t type = status & 0xF0u; - if (SP1_MIDI_CHANNEL != SP1_MIDI_OMNI && (status & 0x0Fu) != SP1_MIDI_CHANNEL) { + if (g_cfg.channel != SP1_MIDI_OMNI && (status & 0x0Fu) != static_cast(g_cfg.channel)) { st_ignored = st_ignored + 1u; return; } @@ -755,8 +763,8 @@ __attribute__((noinline)) void Process(const Event& e) { session = true; st_notes = st_notes + 1u; NoteOn(d1, d2); - if (SP1_MIDI_VELOCITY_DEST >= 0) { - Publish(SP1_MIDI_VELOCITY_DEST); + if (g_cfg.vel_dest >= 0) { + Publish(g_cfg.vel_dest); } break; } @@ -776,8 +784,8 @@ __attribute__((noinline)) void Process(const Event& e) { case 0xD0: session = true; aftertouch = d1; - if (SP1_MIDI_AFTERTOUCH_DEST >= 0) { - Publish(SP1_MIDI_AFTERTOUCH_DEST); + if (g_cfg.at_dest >= 0) { + Publish(g_cfg.at_dest); } break; default: @@ -918,7 +926,7 @@ void NoteSkew(uint32_t cycles) { } void ClockRealTime(uint8_t b, uint32_t cycles) { - if (!SP1_MIDI_CLOCK) { + if (!g_cfg.clock) { return; } switch (b) { @@ -1051,7 +1059,7 @@ void ClockBlock(uint32_t blocks) { // they ARRIVE, so a note that arrives `mean` before its tick lines up with Marbles when // Marbles leads the tick by -mean. Only from quantised notes (a tight window); a lead // never goes below 0 (a clock sent EARLY would need Marbles to lag) or past 200 ms. - if (SP1_MIDI_CLOCK_LEAD_MS == -2 && sk_n >= 8u && sd < 1000.0f) { + if (g_cfg.clock_lead_ms == -2 && sk_n >= 8u && sd < 1000.0f) { float lead_ms = -mean * 1e-3f; lead_ms = lead_ms < 0.0f ? 0.0f : (lead_ms > 200.0f ? 200.0f : lead_ms); lead_learned = lead_ms * static_cast(kBlocksPerMs); @@ -1080,16 +1088,16 @@ void Neutral() { clk_b = 0.0f; ClockForgetTempo(); pub_bpm10 = 0; - if (SP1_MIDI_CLOCK_LEAD_MS == -2) { + if (g_cfg.clock_lead_ms == -2) { lead_learned = -1.0f; // notes: a new host has said nothing yet - lead_blocks = Lead(); } + lead_blocks = Lead(); // the script's lead may have changed (#52) session = false; AllNotesOff(); ResetControllers(); velocity = 0; PublishAll(); - bend_semis = SP1_MIDI_BEND_RANGE; + bend_semis = g_cfg.bend_range; bend_cents = 0; UpdateBendScale(); trig_pending = false; @@ -1186,6 +1194,18 @@ extern "C" void sp1_midi_on_enter(void) { reset_req = reset_req + 1u; } +// ---- the script from the drive (#52) ---- +// Main, at ON entry, BEFORE sp1_midi_on_enter() and audio start: nothing reads a half-copied +// script then except, possibly, the USB interrupt's `clock` byte. The reset that on_enter +// requests then puts the bend range, the clock lead and every offset back to neutral under +// the new script; the smoothing coefficient is recomputed at its next step. +extern "C" void sp1_midi_set_config(const struct sp1_midi_cfg* c) { + g_cfg = *c; + smooth_coef_blocks = 0; +} + +extern "C" const struct sp1_midi_cfg* sp1_midi_config(void) { return &g_cfg; } + extern "C" void sp1_midi_main_tick(uint32_t elapsed_ms) { if (model_since_ms < kModelStepMs) { model_since_ms += elapsed_ms; @@ -1195,7 +1215,7 @@ extern "C" void sp1_midi_main_tick(uint32_t elapsed_ms) { model_held = mt; model_since_ms = 0; } - const float tau = static_cast(SP1_MIDI_SMOOTH_MS); + const float tau = static_cast(g_cfg.smooth_ms); const float k = tau <= 0.0f ? 1.0f : 1.0f - expf(-static_cast(elapsed_ms) / tau); for (int d = 0; d < SP1_MIDI_DESTS; ++d) { if (SP1_MIDI_KIND[d] == SP1_MIDI_K_MAIN) { @@ -1206,7 +1226,7 @@ extern "C" void sp1_midi_main_tick(uint32_t elapsed_ms) { } } } - if (SP1_MIDI_PICKUP != SP1_MIDI_PICKUP_SUM) { + if (g_cfg.pickup != SP1_MIDI_PICKUP_SUM) { // The positions sp1_midi_drive() reads. A CC that has just arrived starts AT its // position: smoothing it up from 0 would be a movement the hand never made. for (int d = 0; d < SP1_MIDI_DESTS; ++d) { @@ -1239,7 +1259,7 @@ extern "C" void sp1_midi_main_tick(uint32_t elapsed_ms) { // longer matches it and catches up again, Plaits' way (CatchUp). // The UI tells its fader the value moved; the fader then catches up with it the same way. extern "C" bool sp1_midi_drive(int d, float* s) { - if (SP1_MIDI_PICKUP == SP1_MIDI_PICKUP_SUM || d < 0 || d >= SP1_MIDI_DESTS || CcIsOffset(d)) { + if (g_cfg.pickup == SP1_MIDI_PICKUP_SUM || d < 0 || d >= SP1_MIDI_DESTS || CcIsOffset(d)) { return false; } Drive& k = drive[d]; @@ -1278,8 +1298,8 @@ extern "C" bool sp1_midi_drive(int d, float* s) { // pickup takeover: while the port is up, a fader whose parameter has a CC rests. extern "C" bool sp1_midi_fader_held(int d) { - return SP1_MIDI_PICKUP == SP1_MIDI_PICKUP_TAKEOVER && d >= 0 && d < SP1_MIDI_DESTS && - !CcIsOffset(d) && SP1_MIDI_DEST_CC[d] >= 0 && port_up != 0u; + return g_cfg.pickup == SP1_MIDI_PICKUP_TAKEOVER && d >= 0 && d < SP1_MIDI_DESTS && + !CcIsOffset(d) && g_cfg.dest_cc[d] >= 0 && port_up != 0u; } extern "C" float sp1_midi_offset(int d) { @@ -1421,7 +1441,7 @@ extern "C" bool sp1_midi_audio_begin(uint32_t cycles, uint32_t blocks, uint8_t e if (smooth_due >= kSmoothBlocks) { if (smooth_due != smooth_coef_blocks) { smooth_coef_blocks = smooth_due; - const float tau = static_cast(SP1_MIDI_SMOOTH_MS) * 1e-3f; + const float tau = static_cast(g_cfg.smooth_ms) * 1e-3f; smooth_coef = tau <= 0.0f ? 1.0f : 1.0f - expf(-static_cast(smooth_due) / (tau * kRefreshHz)); diff --git a/firmware/src/sp1_midi.h b/firmware/src/sp1_midi.h index d01ce96..882a609 100644 --- a/firmware/src/sp1_midi.h +++ b/firmware/src/sp1_midi.h @@ -2,8 +2,9 @@ * wakes-sp1 — MIDI in (M5a): notes into Plaits, CCs onto both modules. * * The plan, and every decision behind it, is private/docs/M5-PLAN.md. The user-facing side is - * config/midi.ini (the MIDI script, read at build time by tools/gen_midi.py into - * sp1_midi_gen.h) and docs/MIDI.md. + * the MIDI script -- config/midi.cnfg built in (tools/gen_midi.py -> sp1_midi_gen.h), and + * WAKES/CNFG/midi.cnfg on the drive at every ON (#52, sp1_midi_set_config) -- and + * docs/MIDI.md. * * Framework-agnostic, like sp1_synth.cc: no Zephyr header, so the host suite runs it as is. * The USB side (feldd's class, our sp1_usbd.c) only ever calls the two producer functions. @@ -35,7 +36,7 @@ * of a Plaits block. * * ---- pickup: how a CC and its fader share a parameter (Adara, M5a round 4) ---- - * The MIDI script's `pickup` setting, fixed at build time (SP1_MIDI_PICKUP). All three use + * The MIDI script's `pickup` setting (struct sp1_midi_cfg, sp1_cnfg.h). All three use * Plaits' catch-up (plaits/pot_controller.h), as the faders do: * sum the CC is an OFFSET on top of the fader, read by polarity (below). The UIs and * the synth add sp1_midi_offset() / the audio block's offsets. @@ -169,6 +170,12 @@ void sp1_midi_set_output_usb(bool usb); /* ---- main thread ---- */ /* On every entry to ON: forget anything that queued while OFF and start from neutral. */ void sp1_midi_on_enter(void); + +/* #52: the MIDI script from the drive. Main, at ON entry, BEFORE sp1_midi_on_enter() and + * audio start. sp1_midi_config() is the live script (the built-in one until then). */ +struct sp1_midi_cfg; +void sp1_midi_set_config(const struct sp1_midi_cfg *c); +const struct sp1_midi_cfg *sp1_midi_config(void); /* Once per control tick, before the UI computes its parameters: advances the control-loop * smoothing of the Marbles offsets. */ void sp1_midi_main_tick(uint32_t elapsed_ms); diff --git a/firmware/src/sp1_store.c b/firmware/src/sp1_store.c index 6cc4c52..37007ed 100644 --- a/firmware/src/sp1_store.c +++ b/firmware/src/sp1_store.c @@ -6,14 +6,18 @@ * file), "CNFG" (the config files), "LOG" (the log on the drive) or "EMMC" * (sp1_emmc_report.c). */ +/* Every image writes a config file that is missing from the drive, with its built-in text + * (Adara, #52): the text comes with the generated headers, and only when this is defined + * BEFORE the first include of any of them. ~33 KB of flash for the four files. */ +#define SP1_CNFG_TEMPLATES #include "sp1_store.h" #include "sp1_emmc.h" #include "sp1_console.h" #include "sp1_cnfg.h" #include "sp1_logbuf.h" -#if defined(CONFIG_SP1_FRESH) -#define SP1_CNFG_TEMPLATES /* the fresh image writes the config files */ -#include "sp1_engines_gen.h" /* ...engines.cnfg among them */ +#include "sp1_engines_gen.h" +#if defined(CONFIG_SP1_PLAITS) +#include "sp1_audio_gen.h" #endif #include "sp1_logs_gen.h" #if defined(CONFIG_SP1_STORAGE_TEST) @@ -348,10 +352,21 @@ static int ensure_dir(const char *path) #define LOGS_CNFG DIR_CNFG "/logs.cnfg" #define ENGINES_CNFG DIR_CNFG "/engines.cnfg" -#define CNFG_READ_MAX 16384u /* a config file is a few KB; never read a huge one */ +#define AUDIO_CNFG DIR_CNFG "/audio.cnfg" +#define MIDI_CNFG DIR_CNFG "/midi.cnfg" +/* A config file is a few KB (engines.cnfg ~16, midi.cnfg ~14); never read a huge one. */ +#define CNFG_READ_MAX 65536u static struct sp1_logs_cfg logs_cfg; +/* The files this ON's job found missing: written with their built-in text once PRST has + * loaded (cnfg_create_missing), so the user always has every file to edit. */ +#define MISSING_LOGS 0x1u +#define MISSING_ENGINES 0x2u +#define MISSING_AUDIO 0x4u +#define MISSING_MIDI 0x8u +static uint8_t cnfg_missing; + static void cnfg_problem(void *ctx, int line, const char *what, const char *why) { LINE("CNFG %s line %d: %s -- %s\n", (const char *)ctx, line, what, why); @@ -399,7 +414,8 @@ static void cnfg_load_logs(void) bool rerr; const int rc = cnfg_read(LOGS_CNFG, logs_feed, &rd, &got, &rerr); if (rc == -ENOENT) { - LINE("CNFG logs.cnfg: not on the drive -- the built-in defaults\n"); + cnfg_missing |= MISSING_LOGS; + LINE("CNFG logs.cnfg: not on the drive -- the built-in defaults (a copy goes there)\n"); } else if (rc != 0) { LINE("CNFG logs.cnfg: cannot be opened (%d) -- the built-in defaults\n", rc); } else { @@ -444,7 +460,9 @@ static void cnfg_load_engines(void) sp1_engines_defaults(stack); filled = stack_count(stack); if (rc == -ENOENT) { - LINE("CNFG engines.cnfg: not on the drive -- the built-in stack\n"); + cnfg_missing |= MISSING_ENGINES; + LINE("CNFG engines.cnfg: not on the drive -- the built-in stack (a copy goes " + "there)\n"); } else { LINE("CNFG engines.cnfg: cannot be opened (%d) -- the built-in stack\n", rc); } @@ -472,6 +490,73 @@ static void cnfg_load_engines(void) } #endif +#if defined(CONFIG_SP1_PLAITS) +/* audio.cnfg and midi.cnfg land here; main takes them at ON entry, before audio starts + * (sp1_store_cnfg). `cnfg_ready` says the ON job has finished writing them this ON. */ +static struct sp1_audio_cfg st_audio; +static struct sp1_midi_cfg st_midi; +static atomic_t cnfg_ready; + +static void audio_feed(void *r, const char *t, size_t n) +{ + sp1_audio_reader_feed(r, t, n); +} + +static void midi_feed(void *r, const char *t, size_t n) +{ + sp1_midi_reader_feed(r, t, n); +} + +/* audio.cnfg: line by line over the built-in values. */ +static void cnfg_load_audio(void) +{ + static struct sp1_audio_reader rd; + sp1_audio_reader_begin(&rd, &st_audio, cnfg_problem, (void *)"audio.cnfg"); + size_t got; + bool rerr; + const int rc = cnfg_read(AUDIO_CNFG, audio_feed, &rd, &got, &rerr); + if (rc != 0) { + sp1_audio_cfg_defaults(&st_audio); + if (rc == -ENOENT) { + cnfg_missing |= MISSING_AUDIO; + } + LINE("CNFG audio.cnfg: %s -- the built-in settings\n", + rc == -ENOENT ? "not on the drive (a copy goes there)" : "cannot be opened"); + return; + } + const int bad = sp1_audio_reader_end(&rd); + LINE("CNFG audio.cnfg: %u B read%s, %d problem%s%s\n", (unsigned)got, + rerr ? " (then a read error)" : (got >= CNFG_READ_MAX ? " (the rest ignored)" : ""), + bad, bad == 1 ? "" : "s", bad ? " -- those lines keep their defaults" : ""); +} + +/* midi.cnfg: line by line over the built-in script, then the CC rule (sp1_cnfg.h). */ +static void cnfg_load_midi(void) +{ + static struct sp1_midi_reader rd; /* ~0.6 KB: off the thread's stack */ + sp1_midi_reader_begin(&rd, &st_midi, cnfg_problem, (void *)"midi.cnfg"); + size_t got; + bool rerr; + const int rc = cnfg_read(MIDI_CNFG, midi_feed, &rd, &got, &rerr); + if (rc != 0) { + sp1_midi_cfg_defaults(&st_midi); + if (rc == -ENOENT) { + cnfg_missing |= MISSING_MIDI; + } + LINE("CNFG midi.cnfg: %s -- the built-in script\n", + rc == -ENOENT ? "not on the drive (a copy goes there)" : "cannot be opened"); + return; + } + int notes = 0; + const int bad = sp1_midi_reader_end(&rd, ¬es); + LINE("CNFG midi.cnfg: %u B read%s, %d problem%s%s, %d CC%s taken from a default\n", + (unsigned)got, + rerr ? " (then a read error)" : (got >= CNFG_READ_MAX ? " (the rest ignored)" : ""), + bad, bad == 1 ? "" : "s", bad ? " -- those lines keep their defaults" : "", + notes, notes == 1 ? "" : "s"); +} +#endif + /* No volume: the built-in everything, so nothing from an earlier ON's files lingers. */ static void cnfg_defaults(void) { @@ -480,6 +565,9 @@ static void cnfg_defaults(void) uint8_t stack[SP1_CNFG_SLOTS]; sp1_engines_defaults(stack); sp1_pui_set_stack(stack); + sp1_audio_cfg_defaults(&st_audio); + sp1_midi_cfg_defaults(&st_midi); + atomic_set(&cnfg_ready, 1); #endif } @@ -487,41 +575,69 @@ static void cnfg_defaults(void) * Never fails: a missing or unreadable file keeps the defaults. */ static void cnfg_load(void) { + cnfg_missing = 0u; cnfg_load_logs(); #if defined(CONFIG_SP1_PLAITS) if (!stop) { cnfg_load_engines(); } + if (!stop) { + cnfg_load_audio(); + } + if (!stop) { + cnfg_load_midi(); + } + atomic_set(&cnfg_ready, 1); #endif } -#if defined(CONFIG_SP1_FRESH) -/* wakes-sp1-fresh, after its format (Adara, #52): the config files, commented, in - * WAKES/CNFG/. config/.cnfg in the repository, byte for byte. */ +/* A config file that was missing, written with its built-in text (Adara, #52): "this'll + * prevent people from having to refer to the repo to copy in missing cnfg files, or resorting + * to flashing a fresh bin". Only a file that is NOT THERE -- one that exists is the user's and + * is never touched, even when it cannot be read. After PRST has loaded, so ON is not held up. + * This is also how wakes-sp1-fresh fills its new WAKES/CNFG/, and how "delete a file" resets + * it to the defaults at the next ON. */ static int cnfg_write_one(const char *path, const char *name, const char *text, size_t n) { const int rc = write_file(path, text, n); - LINE("STORE fresh: WAKES/CNFG/%s (%u B): %s (%d)\n", name, (unsigned)n, - rc == 0 ? "written" : "FAILED", rc); + LINE("CNFG %s: written to the drive with the built-in text (%u B): %s (%d)\n", name, + (unsigned)n, rc == 0 ? "done" : "FAILED", rc); return rc; } -static int cnfg_write_templates(void) +static void cnfg_create_missing(void) { - int rc = ensure_dir(DIR_CNFG); - if (rc == 0 && !stop) { - rc = cnfg_write_one(LOGS_CNFG, "logs.cnfg", SP1_LOGS_TEMPLATE, - sizeof(SP1_LOGS_TEMPLATE) - 1u); + if (cnfg_missing == 0u || stop) { + return; + } + int rc = ensure_dir(DIR_WAKES); + if (rc == 0) { + rc = ensure_dir(DIR_CNFG); + } + if (rc != 0) { + LINE("CNFG the missing files cannot be written: no WAKES/CNFG folder (%d)\n", rc); + return; + } + if ((cnfg_missing & MISSING_LOGS) && !stop) { + (void)cnfg_write_one(LOGS_CNFG, "logs.cnfg", SP1_LOGS_TEMPLATE, + sizeof(SP1_LOGS_TEMPLATE) - 1u); } #if defined(CONFIG_SP1_PLAITS) - if (rc == 0 && !stop) { - rc = cnfg_write_one(ENGINES_CNFG, "engines.cnfg", SP1_ENGINES_TEMPLATE, - sizeof(SP1_ENGINES_TEMPLATE) - 1u); + if ((cnfg_missing & MISSING_ENGINES) && !stop) { + (void)cnfg_write_one(ENGINES_CNFG, "engines.cnfg", SP1_ENGINES_TEMPLATE, + sizeof(SP1_ENGINES_TEMPLATE) - 1u); + } + if ((cnfg_missing & MISSING_AUDIO) && !stop) { + (void)cnfg_write_one(AUDIO_CNFG, "audio.cnfg", SP1_AUDIO_TEMPLATE, + sizeof(SP1_AUDIO_TEMPLATE) - 1u); + } + if ((cnfg_missing & MISSING_MIDI) && !stop) { + (void)cnfg_write_one(MIDI_CNFG, "midi.cnfg", SP1_MIDI_TEMPLATE, + sizeof(SP1_MIDI_TEMPLATE) - 1u); } #endif - return stop ? -ECANCELED : rc; + cnfg_missing = 0u; } -#endif /* ---------------------------------------------------------------- the log (#52) */ @@ -876,9 +992,7 @@ static int format_card(void) * ("block writes against ... expected"); it only scales the progress bar. */ fmt_expected += 5u * 64u + 5u * 4u; #endif - /* + WAKES/CNFG (#52): its directory cluster, logs.cnfg and engines.cnfg (~14 KB, 28 - * blocks), the same estimate. */ - fmt_expected += 64u + 4u + 32u; + /* (WAKES/CNFG and its files are written by the ON job that follows, #52: not counted.) */ fmt_written = 0u; atomic_set(&progress, 0); counting = true; @@ -991,10 +1105,6 @@ static void fresh(void) rc = prst_write_defaults(); } #endif - if (rc == 0) { - /* #52 (Adara): the config files, for users to edit on the drive. */ - rc = cnfg_write_templates(); - } if (rc == 0) { /* The stamp goes LAST: if anything before it failed, the next ON * formats again. */ @@ -1478,6 +1588,10 @@ static void job_on_enter(void) atomic_set(&prst_state, SP1_STORE_PRST_OFF); } #endif + /* #52: write any config file that was missing, now that main has what it needs. */ + if (rc == 0 && !stop) { + cnfg_create_missing(); + } #if defined(CONFIG_SP1_STORAGE_TEST) if (rc == 0 && !stop) { file_test(); @@ -1645,6 +1759,9 @@ void sp1_store_on_enter(void) atomic_set(&fmt_result, SP1_STORE_FMT_NONE); atomic_set(&progress, 0); atomic_set(&vol_state, SP1_STORE_VOL_UNKNOWN); /* PRST waits for the ON job's look */ +#if defined(CONFIG_SP1_PLAITS) + atomic_set(&cnfg_ready, 0); /* this ON's files not read yet */ +#endif #if defined(CONFIG_SP1_PLAITS) atomic_set(&prst_state, SP1_STORE_PRST_WAIT); atomic_set(&save_state, SP1_STORE_SAVE_IDLE); @@ -1743,6 +1860,15 @@ enum sp1_store_save sp1_store_save_result(void) } #endif +#if defined(CONFIG_SP1_PLAITS) +bool sp1_store_cnfg(const struct sp1_audio_cfg **audio, const struct sp1_midi_cfg **midi) +{ + *audio = &st_audio; + *midi = &st_midi; + return atomic_get(&cnfg_ready) != 0; +} +#endif + bool sp1_store_log_live(void) { return atomic_get(&log_live_a) != 0; diff --git a/firmware/src/sp1_store.h b/firmware/src/sp1_store.h index b339f7c..22c346e 100644 --- a/firmware/src/sp1_store.h +++ b/firmware/src/sp1_store.h @@ -172,6 +172,15 @@ enum sp1_store_save sp1_store_save_result(void); /* The log file is open: the card is on for it. Cleared once it is closed and the card is off. */ bool sp1_store_log_live(void); + +#if defined(CONFIG_SP1_PLAITS) +/* Main, at ON entry after the PRST gate: audio.cnfg and midi.cnfg as this ON's job read + * them (the built-in values when a file is missing or there is no volume). False if the job + * has not got that far this ON (PRST's 10 s limit ran out): keep the settings in use. */ +struct sp1_audio_cfg; +struct sp1_midi_cfg; +bool sp1_store_cnfg(const struct sp1_audio_cfg **audio, const struct sp1_midi_cfg **midi); +#endif /* Main, at shutdown when no PRST save is queued: the log's last lines, then the card off. */ void sp1_store_log_end(void); diff --git a/firmware/src/sp1_usbd.c b/firmware/src/sp1_usbd.c index 7a55305..3a6d270 100644 --- a/firmware/src/sp1_usbd.c +++ b/firmware/src/sp1_usbd.c @@ -23,6 +23,7 @@ #include #include "sp1_midi.h" #include "sp1_midi_usb.h" +#include "sp1_cnfg.h" /* struct sp1_midi_cfg: the script's `clock` (#52) */ #include "usb_rt_parse.h" BUILD_ASSERT(CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC == SP1_MIDI_STAMP_HZ, @@ -252,7 +253,7 @@ void sp1_midi_usb_rx(const uint8_t *data, size_t len) rt_cin5 = rt_cin5 + 1u; } if (msg[0] != 0u) { - if (SP1_MIDI_CLOCK) { /* the script's `clock` */ + if (sp1_midi_config()->clock) { /* the script's `clock` */ sp1_midi_push(msg, 1u, now); } continue; @@ -265,7 +266,7 @@ void sp1_midi_usb_rx(const uint8_t *data, size_t len) if (cin >= 0x4u && cin <= 0x7u) { const uint8_t mmc = sp1_midi_mmc_feed(&data[i]); if (mmc > 1u) { - if (SP1_MIDI_CLOCK) { + if (sp1_midi_config()->clock) { msg[0] = mmc; sp1_midi_push(msg, 1u, now); } diff --git a/tools/gen_audio.py b/tools/gen_audio.py index 832591b..f4080a9 100644 --- a/tools/gen_audio.py +++ b/tools/gen_audio.py @@ -1,15 +1,16 @@ #!/usr/bin/env python3 -"""wakes-sp1 -- generate the firmware's audio settings from config/audio.ini. +"""wakes-sp1 -- generate the firmware's audio settings from config/audio.cnfg. - gen_audio.py build step (CMake runs this) + gen_audio.py build step (CMake runs this) -config/audio.ini holds the USER's choices for how Wakes' sound leaves the device: today, how +config/audio.cnfg holds the BUILT-IN DEFAULTS (#52) of the user's choices for how Wakes' sound leaves the device: today, how USB audio out sets its level and whether the speaker plays while a host records over USB. This file holds the facts the user cannot choose (VOL's steps). -The build fails, naming the line, on anything invalid -- an unknown section or key, a value -that is not one of the choices, a level that is not one of VOL's steps. A setting that -half-works is worse than one that refuses to build (the same rule as gen_midi.py). +Users edit the copy on the drive, WAKES/CNFG/audio.cnfg, read at every ON by the firmware's +own reader (firmware/src/sp1_cnfg.c: a bad line keeps its default). The build fails, naming +the line, on anything invalid in the DEFAULT -- an unknown section or key, a value that is +not one of the choices, a level that is not one of VOL's steps. Standard library only. Read as UTF-8 (with or without a BOM). """ @@ -30,12 +31,46 @@ KEYS = {'usb': {'level', 'parked_level', 'speaker'}} DEFAULTS = {'level': 'parked', 'parked_level': '-6', 'speaker': 'off'} +def c_template(name, text): + """The file as a C string for the firmware to write to WAKES/CNFG/ when it is missing (#52). + Non-ASCII as octal escapes (a hex escape would swallow the hex digits after it).""" + out = ['#if defined(SP1_CNFG_TEMPLATES)', 'static const char %s[] =' % name] + for ln in text.splitlines(keepends=True): + lit = '' + for b in ln.encode('utf-8'): + ch = chr(b) + if ch == '\\': + lit += '\\\\' + elif ch == '"': + lit += '\\"' + elif ch == '\n': + lit += '\\n' + elif ch == '\t': + lit += '\\t' + elif 0x20 <= b < 0x7f: + lit += ch + else: + lit += '\\%03o' % b + out.append('\t"%s"' % lit) + out += ['\t;' if text else '\t"";', '#endif'] + return out + + +def check_lines(path, text, fail_fn): + """#52: the first line names the format, and no line is longer than the device reads.""" + if not text.lstrip().startswith(';'): + fail_fn(path, 1, 'the file must start with a comment naming its format ("; Format: ini")') + for i, ln in enumerate(text.splitlines(), 1): + if len(ln.encode('utf-8')) > 160: + fail_fn(path, i, 'line is over 160 bytes: the device would ignore it') + + def fail(path, line, msg): where = '%s:%d' % (path, line) if line else path sys.stderr.write('\n%s: error: %s\n\n' 'The audio settings are checked at build time so a mistake cannot reach\n' - 'the device. See the comments in config/audio.ini.\n' % (where, msg)) + 'the device. See the comments in config/audio.cnfg.\n' % (where, msg)) sys.exit(1) @@ -55,6 +90,7 @@ def line_of(text, section, key): def parse(path): with open(path, encoding='utf-8-sig') as f: text = f.read() + check_lines(path, text, fail) cp = configparser.ConfigParser(inline_comment_prefixes=(';', '#'), comment_prefixes=(';', '#'), strict=True, interpolation=None) @@ -104,7 +140,7 @@ def get(key): return cfg -def header(cfg, src): +def header(cfg, src, text): return '\n'.join([ '/* GENERATED by tools/gen_audio.py from %s -- do not edit. */' % src, '#pragma once', @@ -118,7 +154,11 @@ def header(cfg, src): '/* [usb] speaker: 1 = the speaker keeps playing while a host takes USB audio out. */', '#define SP1_AUDIO_USB_SPEAKER %d' % cfg['speaker'], '', - ]) + '/* struct sp1_audio_cfg (sp1_cnfg.h), field by field (#52). */', + '#define SP1_AUDIO_CFG_DEFAULTS { %d, %d, %d, %d }' + % (cfg['parked'], cfg['parked_db'], cfg['parked_step'], cfg['speaker']), + '', + ] + c_template('SP1_AUDIO_TEMPLATE', text) + ['']) def main(): @@ -126,7 +166,9 @@ def main(): sys.stderr.write(__doc__) sys.exit(2) src, out = sys.argv[1], sys.argv[2] - text = header(parse(src), 'config/audio.ini') + with open(src, encoding='utf-8-sig') as f: + raw = f.read().replace('\r\n', '\n') + text = header(parse(src), 'config/audio.cnfg', raw) try: with open(out, encoding='utf-8') as f: if f.read() == text: diff --git a/tools/gen_engines.py b/tools/gen_engines.py index 36966f2..ba0172e 100644 --- a/tools/gen_engines.py +++ b/tools/gen_engines.py @@ -240,7 +240,7 @@ def generate(path, out_path): for e in by_idx: out.append("\t{ 0x%x, %s }, /* plaits %2d */" % (e["centre"], c_str(e["name"]), e["plaits"])) out += ["};", ""] - # #52: the file itself, for wakes-sp1-fresh to write to WAKES/CNFG/engines.cnfg. + # #52: the file itself, for the firmware to write to WAKES/CNFG/ when it is missing. with open(path, encoding="utf-8-sig") as f: template = f.read().replace("\r\n", "\n") out += ["#if defined(SP1_CNFG_TEMPLATES)", diff --git a/tools/gen_logs.py b/tools/gen_logs.py index 5c1e6ad..2b92499 100644 --- a/tools/gen_logs.py +++ b/tools/gen_logs.py @@ -4,8 +4,8 @@ gen_logs.py build step (CMake runs this) config/logs.cnfg is the DEFAULT: what Wakes does when the drive has no WAKES/CNFG/logs.cnfg, -or a line in it cannot be read. End users edit the copy on the drive, which wakes-sp1-fresh -writes from this same file -- so out.h carries the file's text too (SP1_LOGS_TEMPLATE). +or a line in it cannot be read. End users edit the copy on the drive, which the firmware +writes from this same file when it is missing -- so out.h carries the file's text too (SP1_LOGS_TEMPLATE). The build fails, naming the line, on anything invalid: a default that half-works is worse than one that refuses to build (gen_audio.py's rule). The device reads the drive's copy with @@ -112,7 +112,7 @@ def header(cfg, text): '#define SP1_LOGS_DEF_ENABLED %d' % cfg['enabled'], '#define SP1_LOGS_DEF_CATS (%s)' % (' | '.join(cats) if cats else '0u'), '', - '/* config/logs.cnfg as written to WAKES/CNFG/logs.cnfg by wakes-sp1-fresh, which', + '/* config/logs.cnfg as the firmware writes it to WAKES/CNFG/ when it is missing; sp1_store.c', ' * defines SP1_CNFG_TEMPLATES before including this (no other file has a use for it). */', '#if defined(SP1_CNFG_TEMPLATES)', 'static const char SP1_LOGS_TEMPLATE[] =', diff --git a/tools/gen_midi.py b/tools/gen_midi.py index c55906e..a9f8e55 100644 --- a/tools/gen_midi.py +++ b/tools/gen_midi.py @@ -1,20 +1,23 @@ #!/usr/bin/env python3 -"""wakes-sp1 -- generate the firmware's MIDI tables from the MIDI script, config/midi.ini. +"""wakes-sp1 -- generate the firmware's MIDI tables from the MIDI script, config/midi.cnfg. - gen_midi.py [--chart ] build step (CMake runs this) + gen_midi.py [--chart ] build step (CMake runs this) Two inputs, deliberately kept apart (as gen_engines.py does for engines.cnfg): - config/midi.ini the USER's choices: channel, note priority, legato, portamento, bend - range, the sustain pedal's CC, the CC smoothing time, which CC moves - which parameter, and optional velocity / aftertouch bindings. + config/midi.cnfg the BUILT-IN DEFAULTS (#52): channel, note priority, legato, + portamento, bend range, the sustain pedal's CC, the CC smoothing time, + which CC moves which parameter, and velocity / aftertouch bindings. Users + edit the copy on the drive, WAKES/CNFG/midi.cnfg, which the firmware reads + at every ON with its own reader (firmware/src/sp1_cnfg.c, the same rules + but it never fails: a bad line keeps its default). The firmware writes + this file there when it is missing (SP1_MIDI_TEMPLATE). this file FACTS the user cannot choose: which parameters exist, which thread applies each one, and which CC numbers MIDI itself reserves (DESTS, RESERVED). -The build fails, naming the line, on anything invalid -- an unknown name, a CC used twice, -a reserved CC, a value out of range. A script that half-works is worse than one that -refuses to build. +The build fails, naming the line, on anything invalid in the DEFAULT -- an unknown name, a +CC used twice, a reserved CC, a value out of range: a broken default must never ship. --chart also writes the CC chart for this script, next to the firmware: wakes-sp1-midi.md for people @@ -115,12 +118,46 @@ def polarity_code(k): PICKUP = {'sum': 0, 'shared': 1, 'takeover': 2} SOURCES = ('velocity', 'aftertouch') +def c_template(name, text): + """The file as a C string for the firmware to write to WAKES/CNFG/ when it is missing (#52). + Non-ASCII as octal escapes (a hex escape would swallow the hex digits after it).""" + out = ['#if defined(SP1_CNFG_TEMPLATES)', 'static const char %s[] =' % name] + for ln in text.splitlines(keepends=True): + lit = '' + for b in ln.encode('utf-8'): + ch = chr(b) + if ch == '\\': + lit += '\\\\' + elif ch == '"': + lit += '\\"' + elif ch == '\n': + lit += '\\n' + elif ch == '\t': + lit += '\\t' + elif 0x20 <= b < 0x7f: + lit += ch + else: + lit += '\\%03o' % b + out.append('\t"%s"' % lit) + out += ['\t;' if text else '\t"";', '#endif'] + return out + + +def check_lines(path, text, fail_fn): + """#52: the first line names the format, and no line is longer than the device reads.""" + if not text.lstrip().startswith(';'): + fail_fn(path, 1, 'the file must start with a comment naming its format ("; Format: ini")') + for i, ln in enumerate(text.splitlines(), 1): + if len(ln.encode('utf-8')) > 160: + fail_fn(path, i, 'line is over 160 bytes: the device would ignore it') + + def fail(path, line, msg): where = '%s:%d' % (path, line) if line else path sys.stderr.write('\n%s: error: %s\n\n' 'The MIDI script is checked at build time so a mistake cannot reach\n' - 'the device. See the comments in config/midi.ini.\n' % (where, msg)) + 'the device. See the comments in config/midi.cnfg.\n' % (where, msg)) sys.exit(1) @@ -140,6 +177,7 @@ def line_of(text, section, key): def parse(path): with open(path, encoding='utf-8-sig') as f: text = f.read() + check_lines(path, text, fail) # interpolation=None: a depth is written "50%", and configparser's default # interpolation would read the % as the start of a %(name)s reference and crash. cp = configparser.ConfigParser(inline_comment_prefixes=(';', '#'), @@ -248,7 +286,7 @@ def cc_value(sec, key, raw, allow_none): continue for k, raw in cp[sec].items(): if (sec, k) not in names: - err(sec, k, 'no parameter "%s" in [%s] (see the list in config/midi.ini)' + err(sec, k, 'no parameter "%s" in [%s] (see the list in config/midi.cnfg)' % (k, sec)) n = cc_value(sec, k, raw, True) if n < 0: @@ -268,6 +306,8 @@ def cc_value(sec, key, raw, allow_none): for k, raw in b.items(): if k not in SOURCES: err('bind', k, 'unknown source "%s" (expected velocity or aftertouch)' % k) + if raw.strip().lower() == 'none': + continue # #52: `velocity = none` mm = re.fullmatch(r'([a-z_]+)(?:\s+(-?\d+)\s*%)?', raw.strip().lower()) if not mm: err('bind', k, '"%s" is not " [depth%%]"' % raw.strip()) @@ -289,7 +329,7 @@ def generate(ini, out, chart_dir): for i, n in enumerate(ccs): if n >= 0: cc_dest[n] = i - L = ['/* GENERATED by tools/gen_midi.py from config/midi.ini -- do not edit. */', + L = ['/* GENERATED by tools/gen_midi.py from config/midi.cnfg -- do not edit. */', '#ifndef SP1_MIDI_GEN_H', '#define SP1_MIDI_GEN_H', '', '#include ', '', '#define SP1_MIDI_OMNI 16', '#define SP1_MIDI_CHANNEL %d /* 0-15, or SP1_MIDI_OMNI */' % cfg['channel'], @@ -338,7 +378,21 @@ def generate(ini, out, chart_dir): 'static const int8_t SP1_MIDI_CC_DEST[128] = {'] for r in range(0, 128, 16): L.append('\t' + ' '.join('%d,' % x for x in cc_dest[r:r + 16])) - L += ['};', '#endif /* SP1_MIDI_GEN_TABLES */', '', '#endif /* SP1_MIDI_GEN_H */', ''] + L += ['};', '#endif /* SP1_MIDI_GEN_TABLES */', ''] + # #52: the whole default as ONE initializer of struct sp1_midi_cfg (sp1_cnfg.h), in its field + # order: the firmware's live settings start from it, and the drive's reader resets to it. + vel = binds.get('velocity', (-1, 0.0)) + aft = binds.get('aftertouch', (-1, 0.0)) + L += ['/* struct sp1_midi_cfg (sp1_cnfg.h), field by field. */', + '#define SP1_MIDI_CFG_DEFAULTS { %d, %d, %d, %d, %d, %d, %d, %d, %d, %d, %d, %d, %sf, %sf, \\' + % (cfg['channel'], cfg['priority'], cfg['legato'], cfg['portamento'], cfg['bend_range'], + cfg['sustain'], cfg['smooth_ms'], cfg['pickup'], cfg['clock'], cfg['clock_lead'], + vel[0], aft[0], repr(float(vel[1])), repr(float(aft[1]))), + '\t{ %s }, \\' % ', '.join(str(n) for n in ccs), + '\t{ %s } }' % ', '.join(str(x) for x in cc_dest), ''] + with open(ini, encoding='utf-8-sig') as f: + L += c_template('SP1_MIDI_TEMPLATE', f.read().replace('\r\n', '\n')) + L += ['', '#endif /* SP1_MIDI_GEN_H */', ''] write_if_changed(out, '\n'.join(L)) if chart_dir: write_charts(chart_dir, cfg, ccs, binds) @@ -375,7 +429,8 @@ def write_charts(d, cfg, ccs, binds): ' with the value the fader left. Unplug and the fader catches up in turn.'], }[cfg['pickup']] md = ['# Wakes — MIDI CC chart', '', - 'Generated from `config/midi.ini` by the build that produced this firmware.', '', + 'The built-in MIDI script (`config/midi.cnfg`) of the build that produced this ' + 'firmware. Your `WAKES/CNFG/midi.cnfg` on the drive may change it.', '', '- Channel: **%s**' % ch, '- Notes play Plaits; pitch bend ±%d semitones until the host sends RPN 0' % cfg['bend_range'], diff --git a/tools/gen_prst.py b/tools/gen_prst.py index 884a4bc..ccd226e 100644 --- a/tools/gen_prst.py +++ b/tools/gen_prst.py @@ -70,7 +70,7 @@ # check extra validity beyond "is one of the tokens", applied by sp1_prst.c: # scale = a scale that is included (docs/MARBLES-SETTINGS.md); scale_off also -1 # t_dest / x_dest = on that side's destination ring -# Fader keys use config/midi.ini's names, so the two files speak the same vocabulary. +# Fader keys use config/midi.cnfg's names, so the two files speak the same vocabulary. T, TS, XB, Y = 'SP1_MUI_T_BASE', 'SP1_MUI_T_SHIFT', 'SP1_MUI_X_BASE', 'SP1_MUI_Y' B, SH, ST = 'SP1_PUI_BASE', 'SP1_PUI_SHIFT', 'SP1_PUI_SETTINGS' FIELDS = [ diff --git a/tools/host-tests/README.md b/tools/host-tests/README.md index a3bdcba..5b6b3df 100644 --- a/tools/host-tests/README.md +++ b/tools/host-tests/README.md @@ -8,13 +8,13 @@ proved on a laptop, and because there is exactly one SP-1 (`docs/SAFETY.md`). |---|---|---| | `uitest.c` | `sp1_plaits_ui.c` + `sp1_marbles_ui.c`, with stubs | pages, layers, pickup, detents, rings, glyph uniqueness, scale stepping, the DEJA VU toggles, the V/Oct interlock, both rip wipes, `[J]`, GTLT on t SHIFT F1, Unpatch eating its own release (`sp1_release_guard.h`) | | `routetest.cc` | all of Plaits and Marbles (with the overrides applied) + `sp1_synth.cc` + `sp1_marbles.cc` + both UI objects | routing, TRIG edges, the summing clamp, the HARMONICS attenuverter, the FREQUENCY quantizer's note sets, the soft-clip drive, the deferred re-seed, INTELLIGENT's per-channel ranges, GTLT's curve and TRIG exemption | -| `miditest.cc` | the same + `sp1_midi.cc`, against the shipped `config/midi.ini` with its `pickup` set to `sum` | MIDI in (M5a): note priority and legato off, the LEVEL hand-back through a real LPG, sustain, 7- and 14-bit CCs read by polarity, the catch-up across an engine change, smoothing, pitch bend and RPN 0, channel filter, placement inside the audio block, queue overflow, disconnect to neutral, the quantizer bypass, stepped targets, Marbles offsets | +| `miditest.cc` | the same + `sp1_midi.cc`, against the shipped `config/midi.cnfg` with its `pickup` set to `sum` | MIDI in (M5a): note priority and legato off, the LEVEL hand-back through a real LPG, sustain, 7- and 14-bit CCs read by polarity, the catch-up across an engine change, smoothing, pitch bend and RPN 0, channel filter, placement inside the audio block, queue overflow, disconnect to neutral, the quantizer bypass, stepped targets, Marbles offsets | | `miditest_pickup.cc` | the same, against the shipped script with `pickup` set to `shared`, then `takeover`: two binaries, `miditest_pickup_shared` and `miditest_pickup_takeover` | a CC as a second hand on the fader's value: its first value only a reference, Plaits' catch-up both ways between CC and fader, a rip under a CC, a page not on show, Marbles not on show, MODEL still an offset, a disconnect leaving the values; takeover's resting faders and their catch-up after unplugging | | `miditest_clock.cc` | the same as `miditest.cc`, with real cycle-counter stamps on every tick | MIDI clock and transport into Marbles (M5b): tempo and position from ticks, ±1 ms of USB jitter, a stopped clock waiting, Start arming beat 1 on its own Plaits block, Marbles' beats at the host's tempo, RATE as Marbles' ratio table (×4, ×1/4), Stop / Continue, a stalled clock, PLAY on the host's clock, and the cable pulled (Marbles stops, own clock again) | | `miditest_alt.cc` | the same, built against `midi-alt.ini` (pickup `sum`) | omni, legato on, Yarns' portamento curve, velocity -> LEVEL, aftertouch -> TIMBRE, no sustain pedal, bend range | | `third_party/feldd/test/test_usb_rt_parse.c` | feldd's packet validator | feldd's own test, unmodified | | `prsttest.c` | `sp1_prst.c` + both UI files, with the same stubs as `uitest` | PRST slot files (#50): the ROTC defaults come from the rip code and a rip still gives them, write -> read returns the patch, every corrupt field (NaN, inf, out of range, exponent, unknown token, a destination off its ring, a scale not included) loads only THAT field's default and a bad BASE fader the loaded engine's neutral, unknown engine -> slot 1, an unknown or missing format -> the whole slot from defaults, hand-edited text (CRLF, case, comments, duplicates), the writer never overruns, and ~23 000 truncated / damaged / random files all give a safe patch | -| `cnfgtest.c` | `sp1_cnfg.c` + `sp1_logring.c`, nothing else | The config files and the log on the drive (#52): `config/logs.cnfg` as fresh writes it reads back as exactly the built-in defaults at any chunk size; overrides, case, CRLF, a BOM, inline comments; a bad value, an unknown key or section, a line with no `=`, a section with no `]` and an over-long line each keep their defaults and are reported on the right line; the same key twice -> the first wins; every log tag lands in its category and untagged lines are always written; the file's cursor takes whole lines, skips STANDBY, counts what an overrun lost (not the gap's own bytes) and resumes on a whole line, survives the 32-bit wrap, and a kept ring with a bad header is rejected | +| `cnfgtest.c` | `sp1_cnfg.c` + `sp1_logring.c`, nothing else | The config files and the log on the drive (#52): `config/logs.cnfg` as fresh writes it reads back as exactly the built-in defaults at any chunk size; overrides, case, CRLF, a BOM, inline comments; a bad value, an unknown key or section, a line with no `=`, a section with no `]` and an over-long line each keep their defaults and are reported on the right line; the same key twice -> the first wins; every log tag lands in its category and untagged lines are always written; the file's cursor takes whole lines, skips STANDBY, counts what an overrun lost (not the gap's own bytes) and resumes on a whole line, survives the 32-bit wrap, and a kept ring with a bad header is rejected; engines.cnfg all-or-nothing; audio.cnfg and midi.cnfg: their templates read back as exactly the built-in values, every [midi] value form, bad values keep their defaults, and the CC rule -- a user line takes a default's CC (a note), two user lines on one CC (first wins), the sustain pedal as a line, reserved CCs and fine halves, [bind] with depth or none | | `uactest.c` | Ryan Gilmore's USB audio ring and packet regulator (`third_party/sp1-usb-audio`, with Wakes' word-copy patch applied as the firmware will) at Wakes' tuning, `firmware/src/sp1_uac_tuning.h` | USB audio out (M5c): ±200 ppm of clock drift, a heavy patch starting and stopping, a 200 % block every 997, with no underflow, no lost frame, a margin left in the ring, at most 20 packet-size corrections a second and none from load alone; priming, underflow, overflow | ```sh diff --git a/tools/host-tests/cnfgtest.c b/tools/host-tests/cnfgtest.c index 69c0d34..d348d0d 100644 --- a/tools/host-tests/cnfgtest.c +++ b/tools/host-tests/cnfgtest.c @@ -10,6 +10,7 @@ #include "sp1_logring.h" #include "sp1_logs_gen.h" #include "sp1_engines_gen.h" +#include "sp1_audio_gen.h" static int fails; #define CHECK(cond, ...) do { if (!(cond)) { printf(" FAIL: "); \ @@ -61,7 +62,7 @@ static void reader(void) CHECK(d.enabled && d.cats == SP1_LOG_ALL, "the shipped defaults are on/all (got %d/0x%02x)", d.enabled, d.cats); - /* The template the fresh image writes reads back as exactly the built-in defaults, with + /* The template the firmware writes when the file is missing reads back as exactly the built-in defaults, with * no problem -- whatever chunk size the drive hands over. */ const size_t chunks[] = { 0u, 1u, 7u, 128u }; for (size_t k = 0u; k < sizeof(chunks) / sizeof(chunks[0]); k++) { @@ -385,7 +386,7 @@ static void engines(void) CHECK(idx("6-op FM") < 0 && idx("") < 0 && idx("moog") < 0 && idx("-") < 0, "partial / empty / unknown names are no engine"); - /* The template fresh writes: no problem, exactly the built-in stack, 16 engines. */ + /* The template written when the file is missing: no problem, exactly the built-in stack, 16 engines. */ const size_t chunks[] = { 0u, 1u, 128u }; for (size_t k = 0u; k < sizeof(chunks) / sizeof(chunks[0]); k++) { CHECK(read_engines(SP1_ENGINES_TEMPLATE, chunks[k]) == 0 && is_default() && @@ -430,12 +431,233 @@ static void engines(void) } } +/* ---------------------------------------------------------------- audio.cnfg */ + +static struct sp1_audio_cfg acfg; + +static int read_audio(const char *text, size_t chunk) +{ + struct sp1_audio_reader r; + problems_seen = 0; + last_line = 0; + sp1_audio_reader_begin(&r, &acfg, problem, NULL); + const size_t n = strlen(text); + if (chunk == 0u) { + chunk = n ? n : 1u; + } + for (size_t i = 0u; i < n; i += chunk) { + sp1_audio_reader_feed(&r, text + i, (i + chunk <= n) ? chunk : n - i); + } + const int bad = sp1_audio_reader_end(&r); + CHECK(bad == problems_seen, "audio: counted %d, reported %d", bad, problems_seen); + return bad; +} + +static void audio(void) +{ + printf("[5] audio.cnfg\n"); + struct sp1_audio_cfg d; + sp1_audio_cfg_defaults(&d); + CHECK(d.parked == SP1_AUDIO_USB_LEVEL_PARKED && d.parked_db == SP1_AUDIO_USB_PARKED_DB && + d.parked_step == SP1_AUDIO_USB_PARKED_STEP && d.speaker == SP1_AUDIO_USB_SPEAKER, + "audio defaults differ from the generated ones"); + const size_t chunks[] = { 0u, 1u, 128u }; + for (size_t k = 0u; k < sizeof(chunks) / sizeof(chunks[0]); k++) { + CHECK(read_audio(SP1_AUDIO_TEMPLATE, chunks[k]) == 0 && + memcmp(&acfg, &d, sizeof(d)) == 0, + "template, chunk %u: %d problems (line %d: %s)", (unsigned)chunks[k], + problems_seen, last_line, last_what); + } + CHECK(read_audio("[usb]\nlevel = VOL\nparked_level = -9 dB\nspeaker = on\n", 0u) == 0 && + acfg.parked == 0u && acfg.parked_db == -9 && acfg.parked_step == 3u && + acfg.speaker == 1u, "overrides: %d problems, %d/%d/%u/%u", problems_seen, + acfg.parked, acfg.parked_db, acfg.parked_step, acfg.speaker); + CHECK(read_audio("[usb]\nparked_level = 0\n", 0u) == 0 && acfg.parked_step == 0u, + "0 dB is a step"); + CHECK(read_audio("[usb]\nparked_level = -30db\n", 0u) == 0 && acfg.parked_step == 10u, + "-30 dB is a step"); + /* Not steps: each keeps the default, one problem each. */ + static const char *const BADLVL[] = { "-7", "-33", "6", "+3", "-6 dBFS", "loud", "" }; + for (size_t i = 0u; i < sizeof(BADLVL) / sizeof(BADLVL[0]); i++) { + char t[64]; + snprintf(t, sizeof(t), "[usb]\nparked_level = %s\n", BADLVL[i]); + CHECK(read_audio(t, 0u) == 1 && acfg.parked_db == d.parked_db, + "parked_level = %s: %d problems, %d dB", BADLVL[i], problems_seen, + acfg.parked_db); + } + CHECK(read_audio("[usb]\nspeaker = maybe\nspeaker = on\nvolume = 3\n[out]\nx = 1\n", 0u) + == 4 && acfg.speaker == d.speaker, + "bad value / twice / unknown key / section: %d problems", problems_seen); +} + +/* ---------------------------------------------------------------- midi.cnfg */ + +static struct sp1_midi_cfg mcfg; +static int mnotes; + +static int read_midi(const char *text, size_t chunk) +{ + struct sp1_midi_reader r; + problems_seen = 0; + last_line = 0; + last_what[0] = '\0'; + sp1_midi_reader_begin(&r, &mcfg, problem, NULL); + const size_t n = strlen(text); + if (chunk == 0u) { + chunk = n ? n : 1u; + } + for (size_t i = 0u; i < n; i += chunk) { + sp1_midi_reader_feed(&r, text + i, (i + chunk <= n) ? chunk : n - i); + } + const int bad = sp1_midi_reader_end(&r, &mnotes); + CHECK(bad + mnotes == problems_seen, "midi: counted %d + %d notes, reported %d", bad, + mnotes, problems_seen); + return bad; +} + +/* Field by field (the struct has padding), and the two CC tables agree with each other. */ +static bool midi_same(const struct sp1_midi_cfg *a, const struct sp1_midi_cfg *b) +{ + return a->channel == b->channel && a->priority == b->priority && a->legato == b->legato && + a->portamento == b->portamento && a->bend_range == b->bend_range && + a->sustain_cc == b->sustain_cc && a->smooth_ms == b->smooth_ms && + a->pickup == b->pickup && a->clock == b->clock && + a->clock_lead_ms == b->clock_lead_ms && a->vel_dest == b->vel_dest && + a->at_dest == b->at_dest && a->vel_depth == b->vel_depth && + a->at_depth == b->at_depth && + memcmp(a->dest_cc, b->dest_cc, sizeof(a->dest_cc)) == 0 && + memcmp(a->cc_dest, b->cc_dest, sizeof(a->cc_dest)) == 0; +} + +static bool tables_agree(const struct sp1_midi_cfg *c) +{ + for (int cc = 0; cc < 128; cc++) { + const int d = c->cc_dest[cc]; + if (d >= 0 && c->dest_cc[d] != cc) { + return false; + } + } + for (int d = 0; d < SP1_MIDI_DESTS; d++) { + if (c->dest_cc[d] >= 0 && c->cc_dest[(int)c->dest_cc[d]] != d) { + return false; + } + if (c->dest_cc[d] >= 0 && c->dest_cc[d] == c->sustain_cc) { + return false; + } + } + return true; +} + +static void midi(void) +{ + printf("[6] midi.cnfg\n"); + struct sp1_midi_cfg d; + sp1_midi_cfg_defaults(&d); + CHECK(d.channel == SP1_MIDI_CHANNEL && d.pickup == SP1_MIDI_PICKUP && + d.sustain_cc == SP1_MIDI_SUSTAIN_CC && d.dest_cc[SP1_MIDI_D_TIMBRE] == 3 && + d.vel_dest == SP1_MIDI_VELOCITY_DEST && tables_agree(&d), + "midi defaults differ from the generated ones"); + + /* The template written when the file is missing reads back as exactly the built-in script. */ + const size_t chunks[] = { 0u, 1u, 128u }; + for (size_t k = 0u; k < sizeof(chunks) / sizeof(chunks[0]); k++) { + CHECK(read_midi(SP1_MIDI_TEMPLATE, chunks[k]) == 0 && mnotes == 0 && + midi_same(&mcfg, &d), "template, chunk %u: %d problems (line %d: %s)", + (unsigned)chunks[k], problems_seen, last_line, last_what); + } + + /* [midi] values, every form. */ + CHECK(read_midi("[midi]\nchannel = 3\nnote_priority = LOW\nlegato = auto\n" + "portamento = t10\nbend_range = 12\ncc_smoothing = 0\npickup = takeover\n" + "clock = off\nclock_lead = 25\n", 0u) == 0 && + mcfg.channel == 2 && mcfg.priority == 1u && mcfg.legato == 1u && + mcfg.portamento == 10u && mcfg.bend_range == 12u && mcfg.smooth_ms == 0u && + mcfg.pickup == SP1_MIDI_PICKUP_TAKEOVER && mcfg.clock == 0u && + mcfg.clock_lead_ms == 25, "[midi] overrides: %d problems (line %d: %s)", + problems_seen, last_line, last_what); + CHECK(read_midi("[midi]\nchannel = omni\nportamento = r0\nclock_lead = notes\n", 0u) == 0 && + mcfg.channel == SP1_MIDI_OMNI && mcfg.portamento == 51u && mcfg.clock_lead_ms == -2, + "omni / r0 / notes"); + static const char *const BADMIDI[] = { + "channel = 0", "channel = 17", "note_priority = first", "legato = maybe", + "portamento = t0", "portamento = t51", "portamento = r51", "bend_range = 25", + "cc_smoothing = 201", "pickup = both", "clock = yes", "clock_lead = 201", + }; + for (size_t i = 0u; i < sizeof(BADMIDI) / sizeof(BADMIDI[0]); i++) { + char t[64]; + snprintf(t, sizeof(t), "[midi]\n%s\n", BADMIDI[i]); + CHECK(read_midi(t, 0u) == 1 && midi_same(&mcfg, &d), "\"%s\": %d problems, %s", + BADMIDI[i], problems_seen, midi_same(&mcfg, &d) ? "default kept" : "CHANGED"); + } + + /* THE CC RULE (Adara, #52). 1: your line TAKES a default's CC -- MORPH's CC 9 to TIMBRE: + * MORPH has none, a note (not a problem); TIMBRE's own CC 3 is free. */ + CHECK(read_midi("[plaits]\ntimbre = cc 9\n", 0u) == 0 && mnotes == 1 && + mcfg.dest_cc[SP1_MIDI_D_TIMBRE] == 9 && mcfg.dest_cc[SP1_MIDI_D_MORPH] == -1 && + mcfg.cc_dest[9] == SP1_MIDI_D_TIMBRE && mcfg.cc_dest[3] == -1 && tables_agree(&mcfg), + "user takes a default's CC: %d problems, %d notes, timbre %d morph %d", + problems_seen - mnotes, mnotes, mcfg.dest_cc[SP1_MIDI_D_TIMBRE], + mcfg.dest_cc[SP1_MIDI_D_MORPH]); + /* 2: two of YOUR lines on one CC: the first keeps it, the later gets none (a problem). */ + CHECK(read_midi("[plaits]\ntimbre = cc 70\nmorph = cc 70\n", 0u) == 1 && last_line == 3 && + mcfg.dest_cc[SP1_MIDI_D_TIMBRE] == 70 && mcfg.dest_cc[SP1_MIDI_D_MORPH] == -1 && + tables_agree(&mcfg), "two user lines, one CC: %d problems, line %d, morph %d", + problems_seen, last_line, mcfg.dest_cc[SP1_MIDI_D_MORPH]); + /* ...across sections and against the sustain pedal, which is a line like any other. */ + CHECK(read_midi("[midi]\nsustain = cc 70\n[marbles]\nrate = cc 70\n", 0u) == 1 && + mcfg.sustain_cc == 70 && mcfg.dest_cc[SP1_MIDI_D_RATE] == -1 && tables_agree(&mcfg), + "sustain first, rate later: sustain %d rate %d", mcfg.sustain_cc, + mcfg.dest_cc[SP1_MIDI_D_RATE]); + /* 3: a user line taking the DEFAULT sustain CC 64 turns the pedal off (a note). */ + CHECK(read_midi("[plaits]\nlevel = cc 64\n", 0u) == 0 && mnotes == 1 && + mcfg.sustain_cc == -1 && mcfg.dest_cc[SP1_MIDI_D_LEVEL] == 64 && tables_agree(&mcfg), + "user takes the pedal's CC: sustain %d", mcfg.sustain_cc); + /* 4: `none` frees a CC, which a default then keeps nothing of. */ + CHECK(read_midi("[plaits]\ntimbre = none\nmorph = cc 3\n", 0u) == 0 && mnotes == 0 && + mcfg.dest_cc[SP1_MIDI_D_TIMBRE] == -1 && mcfg.dest_cc[SP1_MIDI_D_MORPH] == 3 && + tables_agree(&mcfg), "none then reuse: %d notes", mnotes); + /* Reserved CCs, fine halves, nonsense: the default is kept. */ + static const char *const BADCC[] = { "cc 6", "cc 0", "cc 101", "cc 120", "cc 40", "cc 128", + "ccc", "7", "cc -1" }; + for (size_t i = 0u; i < sizeof(BADCC) / sizeof(BADCC[0]); i++) { + char t[64]; + snprintf(t, sizeof(t), "[plaits]\ntimbre = %s\n", BADCC[i]); + CHECK(read_midi(t, 0u) == 1 && mcfg.dest_cc[SP1_MIDI_D_TIMBRE] == 3, + "timbre = %s: %d problems, cc %d", BADCC[i], problems_seen, + mcfg.dest_cc[SP1_MIDI_D_TIMBRE]); + } + /* A parameter in the wrong section, an unknown one, the same key twice. */ + CHECK(read_midi("[marbles]\ntimbre = cc 70\n", 0u) == 1 && midi_same(&mcfg, &d), + "timbre under [marbles]"); + CHECK(read_midi("[plaits]\ncutoff = cc 70\n", 0u) == 1, "unknown parameter"); + CHECK(read_midi("[plaits]\ntimbre = cc 70\ntimbre = cc 71\n", 0u) == 1 && + mcfg.dest_cc[SP1_MIDI_D_TIMBRE] == 70, "the same key twice: the first wins"); + + /* [bind]. */ + CHECK(read_midi("[bind]\nvelocity = none\naftertouch = MORPH -50%\n", 0u) == 0 && + mcfg.vel_dest == -1 && mcfg.at_dest == SP1_MIDI_D_MORPH && mcfg.at_depth == -0.5f, + "bind: velocity %d aftertouch %d %.2f", mcfg.vel_dest, mcfg.at_dest, + (double)mcfg.at_depth); + CHECK(read_midi("[bind]\naftertouch = rate 100%\n", 0u) == 0 && + mcfg.at_dest == SP1_MIDI_D_RATE && mcfg.at_depth == 1.0f, "bind to a Marbles parameter"); + static const char *const BADBIND[] = { "velocity = cutoff", "velocity = timbre 150%", + "velocity = timbre 50", "breath = timbre" }; + for (size_t i = 0u; i < sizeof(BADBIND) / sizeof(BADBIND[0]); i++) { + char t[64]; + snprintf(t, sizeof(t), "[bind]\n%s\n", BADBIND[i]); + CHECK(read_midi(t, 0u) == 1 && mcfg.vel_dest == d.vel_dest, "\"%s\": %d problems", + BADBIND[i], problems_seen); + } +} + int main(void) { reader(); categories(); ring(); engines(); + audio(); + midi(); printf(fails ? "cnfgtest: %d FAILED\n" : "cnfgtest: all passed\n", fails); return fails ? 1 : 0; } diff --git a/tools/host-tests/hostbuild.sh b/tools/host-tests/hostbuild.sh index fdaffcb..3c86bdc 100644 --- a/tools/host-tests/hostbuild.sh +++ b/tools/host-tests/hostbuild.sh @@ -28,20 +28,21 @@ python3 "$ROOT/tools/gen_engines.py" "$ROOT/config/engines.cnfg" "$GEN/sp1_engin python3 "$ROOT/tools/gen_prst.py" "$GEN/sp1_prst_gen.h" >/dev/null # #52: the logging defaults and logs.cnfg's text, as the firmware build generates them. python3 "$ROOT/tools/gen_logs.py" "$ROOT/config/logs.cnfg" "$GEN/sp1_logs_gen.h" >/dev/null +python3 "$ROOT/tools/gen_audio.py" "$ROOT/config/audio.cnfg" "$GEN/sp1_audio_gen.h" >/dev/null # The MIDI script (M5a) as the firmware build generates it -- with ONE change: its `pickup` # forced to `sum`, because miditest.cc checks the offset maths and the other suites were # written against offsets. miditest_pickup.cc runs the shipped script as it is otherwise, once # per other pickup (below); miditest_alt.cc uses a second script of its own. # $1 = pickup, $2 = the ini to write. Fails if the script has no `pickup` line to replace. pickup_ini() { - sed -E 's/^pickup[[:space:]]*=.*/pickup = '"$1"'/' "$ROOT/config/midi.ini" > "$2" - grep -Eq "^pickup = $1\$" "$2" || { echo "hostbuild: no pickup line in config/midi.ini" >&2; exit 1; } + sed -E 's/^pickup[[:space:]]*=.*/pickup = '"$1"'/' "$ROOT/config/midi.cnfg" > "$2" + grep -Eq "^pickup = $1\$" "$2" || { echo "hostbuild: no pickup line in config/midi.cnfg" >&2; exit 1; } } pickup_ini sum "$GEN/midi-sum.ini" # ...and its legato forced to `off`, Yarns' default, whatever the shipped script is set to for # a hardware test: miditest.cc checks legato off; miditest_alt.cc checks legato on. sed -i -E 's/^legato[[:space:]]*=.*/legato = off/' "$GEN/midi-sum.ini" -grep -Eq '^legato = off$' "$GEN/midi-sum.ini" || { echo "hostbuild: no legato line in config/midi.ini" >&2; exit 1; } +grep -Eq '^legato = off$' "$GEN/midi-sum.ini" || { echo "hostbuild: no legato line in config/midi.cnfg" >&2; exit 1; } python3 "$ROOT/tools/gen_midi.py" "$GEN/midi-sum.ini" "$GEN/sp1_midi_gen.h" >/dev/null INC="-I$OVR -I$SRC/plaits_ovr -I$SRC/plaits_shim -I$ER -I$SRC -I$GEN" diff --git a/tools/host-tests/midi-alt.ini b/tools/host-tests/midi-alt.ini index 7d539d9..403cd79 100644 --- a/tools/host-tests/midi-alt.ini +++ b/tools/host-tests/midi-alt.ini @@ -1,5 +1,5 @@ -; The second MIDI script miditest_alt.cc runs against: everything config/midi.ini leaves at -; its default, changed. Not a template for users -- config/midi.ini is. +; The second MIDI script miditest_alt.cc runs against: everything config/midi.cnfg leaves at +; its default, changed. Not a template for users -- config/midi.cnfg is. [midi] channel = omni note_priority = last diff --git a/tools/host-tests/miditest.cc b/tools/host-tests/miditest.cc index 50132bd..71280e1 100644 --- a/tools/host-tests/miditest.cc +++ b/tools/host-tests/miditest.cc @@ -1,4 +1,4 @@ -// wakes-sp1 M5a: host checks of MIDI in, against the shipped script (config/midi.ini) with +// wakes-sp1 M5a: host checks of MIDI in, against the shipped script (config/midi.cnfg) with // its pickup set to SUM (hostbuild.sh): this suite checks the offset maths. // Drives the real sp1_midi core directly, then through sp1_synth / both UIs. // miditest_alt.cc covers the settings this script leaves at their defaults; @@ -14,6 +14,7 @@ extern "C" { #include "sp1_plaits_ui.h" #include "sp1_marbles_ui.h" #include "sp1_engines_gen.h" +#include "sp1_cnfg.h" } static int fails; @@ -705,6 +706,49 @@ int main() { CHECK(rt.gtlt == 0.0f, "GTLT CC 64 should be back on the detent, got %.4f", rt.gtlt); } + // ---- the script from the drive, at ON entry (#52): sp1_midi_set_config ---- + // The same core, a different script without a rebuild: channel 2, TIMBRE on CC 70 instead + // of CC 3, velocity unbound. Then the built-in script again. + printf("§21 the script changed at ON entry (midi.cnfg on the drive)\n"); + { + const struct sp1_midi_cfg builtin = *sp1_midi_config(); + struct sp1_midi_cfg c = builtin; + c.channel = 1; // MIDI channel 2 + c.cc_dest[3] = -1; + c.dest_cc[SP1_MIDI_D_TIMBRE] = 70; + c.cc_dest[70] = SP1_MIDI_D_TIMBRE; + c.vel_dest = -1; + sp1_midi_set_config(&c); + sp1_midi_on_enter(); + reset(); + centre = 0x2; + on(60); // channel 1: not ours any more + block(); + CHECK(!any_trig(), "a note on channel 1 struck with the script on channel 2"); + send(0x91, 60, 127); // channel 2 + block(); + CHECK(any_trig(), "a note on channel 2 did not strike"); + send(0x81, 60, 0); + send(0xB1, 3, 127); // CC 3: nothing now + for (int i = 0; i < 100; ++i) block(); + CHECK(fabsf(moff[SP1_MIDI_D_TIMBRE]) < 1e-4f, "CC 3 still moves TIMBRE: %.4f", + moff[SP1_MIDI_D_TIMBRE]); + send(0xB1, 70, 127); // CC 70: TIMBRE, centred + for (int i = 0; i < 100; ++i) block(); + CHECK(fabsf(moff[SP1_MIDI_D_TIMBRE] - 0.5f) < 1e-3f, "CC 70 -> TIMBRE +1/2: %.4f", + moff[SP1_MIDI_D_TIMBRE]); + send(0xB1, 70, 64); + for (int i = 0; i < 100; ++i) block(); + sp1_midi_set_config(&builtin); + sp1_midi_on_enter(); + reset(); + on(60); + block(); + CHECK(any_trig(), "the built-in script (channel 1) is not back"); + off(60); + reset(); + } + printf("\n%s (%d failure%s)\n", fails ? "FAILED" : "all checks passed", fails, fails == 1 ? "" : "s"); return fails ? 1 : 0; From 09870ef30052abcfdac4f204a1cb4fbd6491ef21 Mon Sep 17 00:00:00 2001 From: Worldwave Date: Thu, 15 Oct 2026 17:32:58 -0400 Subject: [PATCH 04/10] v0.8.2 #52: the config files on the drive (WAKES/CNFG/: logs, engines, audio, midi, read at every ON, written with their defaults when missing), the log on the drive (WAKES/LOGS/NNNN.LOGS, last 5 sessions), the 16-engine default stack with hyphenated engine names, ROTC to the first filled slot, and the two fixes from the 2026-10-15 hardware test. Co-Authored-By: Claude Opus 5.5 --- .github/ISSUE_TEMPLATE/bug.yml | 2 +- .github/ISSUE_TEMPLATE/feature.yml | 2 +- firmware/VERSION | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml index bbda699..f7bdfa1 100644 --- a/.github/ISSUE_TEMPLATE/bug.yml +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -89,7 +89,7 @@ body: attributes: label: Version description: The release you flashed (e.g. from its file name), or the commit if you built it yourself. - placeholder: v0.8.0 + placeholder: v0.8.2 validations: required: true diff --git a/.github/ISSUE_TEMPLATE/feature.yml b/.github/ISSUE_TEMPLATE/feature.yml index 6de1b56..e66cefc 100644 --- a/.github/ISSUE_TEMPLATE/feature.yml +++ b/.github/ISSUE_TEMPLATE/feature.yml @@ -76,6 +76,6 @@ body: attributes: label: Version description: The release you are using, if the request is about something you've seen on hardware. - placeholder: v0.8.0 + placeholder: v0.8.2 validations: required: false diff --git a/firmware/VERSION b/firmware/VERSION index 485e9ed..98240f4 100644 --- a/firmware/VERSION +++ b/firmware/VERSION @@ -1,5 +1,5 @@ VERSION_MAJOR = 0 VERSION_MINOR = 8 -PATCHLEVEL = 0 +PATCHLEVEL = 2 VERSION_TWEAK = 0 EXTRAVERSION = From 8c723fffa593b9941c426c25d916244cff0f4f70 Mon Sep 17 00:00:00 2001 From: Worldwave Date: Fri, 16 Oct 2026 00:50:37 -0400 Subject: [PATCH 05/10] #52: new shipped defaults, every ON its own log file, lowercase .logs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Defaults (Adara): midi.cnfg ships channel omni, legato auto, portamento t9, velocity and aftertouch none, with her rewritten text; logs.cnfg ships with only `performance` on; audio.cnfg text revised. config/README.md says these are the built-in defaults, not a device's settings. Logging: every ON starts a new session and file, including STANDBY then ON while plugged in. Before the new file opens, the previous session's file gets what it still owed (lines from before the last STANDBY: closing lines, a 30 s backstop's tail, a crash kept across a soft reset) via sp1_logring_take_before_standby. Log files are named NNNN.logs. Reader: `velocity/aftertouch = none` now reads as depth 0, as gen_midi.py writes it (no audible change; the template read-back differed). Host tests: hostbuild.sh forces channel 1 / portamento 0 / velocity level for miditest's exact maths; miditest_pickup §S checks the shipped defaults as they are (incl. legato auto, untested before); cnfgtest no longer assumes all log categories on, and checks the before-STANDBY take. All 11 suites pass. Co-Authored-By: Claude Opus 5.5 --- config/README.md | 33 +++++ config/audio.cnfg | 50 +++---- config/logs.cnfg | 32 +++-- config/midi.cnfg | 207 +++++++++++++--------------- docs/MIDI.md | 20 +-- firmware/src/sp1_cnfg.c | 3 +- firmware/src/sp1_logbuf.c | 11 ++ firmware/src/sp1_logbuf.h | 6 +- firmware/src/sp1_logring.c | 58 +++++--- firmware/src/sp1_logring.h | 5 + firmware/src/sp1_store.c | 134 +++++++++++------- firmware/src/sp1_store.h | 11 +- tools/host-tests/cnfgtest.c | 114 +++++++++++++-- tools/host-tests/hostbuild.sh | 16 ++- tools/host-tests/miditest.cc | 10 +- tools/host-tests/miditest_pickup.cc | 106 +++++++++++++- 16 files changed, 560 insertions(+), 256 deletions(-) create mode 100644 config/README.md diff --git a/config/README.md b/config/README.md new file mode 100644 index 0000000..efd2ada --- /dev/null +++ b/config/README.md @@ -0,0 +1,33 @@ +# config/ — Wakes' built-in defaults + +**These files are not the settings on your Wakes.** They are the defaults every firmware image is +built with. You do not need to edit them, fork this repository or build anything to change how +your Wakes behaves. + +## To change your Wakes' settings + +Edit the copies on Wakes' own drive: + +1. Plug Wakes into a computer while it is off (STANDBY). It shows up as a drive. +2. Open `WAKES/CNFG/` and edit the file in a text editor. +3. Eject the drive and turn Wakes ON. It reads the files at every ON. + +If a file is missing from `WAKES/CNFG/`, Wakes writes it there with these defaults at the next ON, +so deleting a file is how you reset it. Each file explains its own settings, and a line Wakes +cannot read keeps its default and is named in the log (`WAKES/LOGS/`). + +| File | What it sets | +|---|---| +| `engines.cnfg` | which Plaits engine sits in each of the 24 slots, and what every engine does | +| `midi.cnfg` | MIDI over USB: channel, note priority, legato, portamento, which CC moves which parameter | +| `audio.cnfg` | USB audio out: its level (parked or on VOL) and the speaker while a host records | +| `logs.cnfg` | the log Wakes writes to its drive, and what goes in it | + +## When to edit these + +Only to build your own firmware with **different defaults**: the values a Wakes uses when its drive +has no file, and the text it writes there when one is missing. The build checks every file here and +stops, naming the line, if one is wrong, so a broken default can never ship. + +You can also copy a file from here to `WAKES/CNFG/` to get a clean one back, though deleting it +from the drive does the same thing. diff --git a/config/audio.cnfg b/config/audio.cnfg index 0d7d0ca..8e5ce77 100644 --- a/config/audio.cnfg +++ b/config/audio.cnfg @@ -3,42 +3,36 @@ ; Wakes — the audio settings ; ===================================================================================== ; -; How Wakes' sound leaves the device. Wakes reads this file from its drive -; (WAKES/CNFG/audio.cnfg) every time it turns ON, so a change takes effect at the next ON. +; This file configures how Wakes handles sound output. Wakes reads this file from its drive +; (WAKES/CNFG/audio.cnfg) every time it turns ON. ; -; Lines starting with ; or # are comments. Every setting can be left out to get its -; default. A line Wakes cannot read keeps its default, and the log (WAKES/LOGS/) names it. +; Lines starting with ; or # are comments. They are not applied as settings. +; Every setting can be left blank to get its default. +; A line Wakes cannot read keeps its default, and the log (WAKES/LOGS/) names it. [usb] ; USB AUDIO OUT. Plugged into a computer, phone or other USB host, Wakes shows up as an -; audio input ("Wakes Audio Out", or "Wakes" -- the name depends on the host): 48 kHz, -; 16-bit stereo, no driver. It carries what the speaker and headphones get -- the output -; select (OUT / AUX / OUT+AUX / OUTxAUX) and the drive included. Nothing changes until a -; host actually takes the audio (records or monitors the input); these settings apply only -; while it does. Headphones always play. +; audio input ("Wakes Audio Out", or "Wakes" - the name depends on the host): 48 kHz, +; 16-bit stereo, no driver. It carries what the speaker and headphones get. -; How USB audio out sets its level: -; parked (default) = while a host takes USB audio, VOL is set to `parked_level` and its -; buttons do nothing, so a recording's level never depends on where VOL happened to -; be. When the host stops, VOL goes back to where you left it. -; Wakes has ONE output level for every output, so parking it parks the headphones -; (and the speaker, if `speaker = on`) at that level too. That is deliberate: it is -; the cheapest way to do it. A separate level for USB alone would need a second gain -; pass over every block of audio (about 0.3 % of the CPU), which Wakes keeps for its -; engines. -; vol = VOL moves USB audio out like everything else, like the volume knob of a -; hardware synth on a mixer track. +; level - How USB audio out sets its level: +; parked (default) = +; while a host takes USB audio, VOL is set to `parked_level` (the next parameter below) +; and VOL+/VOL- are disabled. When the host stops, VOL goes back to where you left it. +; Wakes has ONE output level controlling every output, so parking it parks the +; headphones (and the speaker, if `speaker = on`) at that level too. +; vol = +; VOL+/- are unlocked, controlling USB audio gain like everything else. level = parked -; The level USB audio out is parked at, in dB: one of VOL's steps -- 0, -3, -6, -9, -12, + +; parked_level - 'parked' mode gainstage, in dB. Options are: -- 0, -3, -6, -9, -12, ; -15, -18, -21, -24, -27 or -30. 0 is full scale, which Wakes' loudest patches (the -; drive's top steps) reach; -6 leaves a recording some headroom. +; drive's top steps) reach; -6 leaves the recording device some headroom. parked_level = -6 -; The speaker while a host takes USB audio: -; off (default) = quiet: the host is recording, so the room only gets a second copy. -; It comes back as soon as the host stops taking the audio (or goes to sleep, or the -; cable is pulled). -; on = it keeps playing. -speaker = off +; speaker - enable or disable the speaker while a host takes USB audio: +; off (default) = while connected, the onboard speaker is disabled. +; on = the speaker will play the same audio that goes out over USB and the headphone jack. +speaker = off \ No newline at end of file diff --git a/config/logs.cnfg b/config/logs.cnfg index 6727570..88e02de 100644 --- a/config/logs.cnfg +++ b/config/logs.cnfg @@ -1,21 +1,23 @@ ; Format: ini ; ===================================================================================== -; Wakes — logging +; Wakes — LOGS ; ===================================================================================== ; -; Wakes writes what it is doing to its drive, in WAKES/LOGS/: one file per session (from -; turning Wakes on until it is switched off), numbered -- 0001.LOGS, 0002.LOGS, ... after -; 9999.LOGS comes 0000.LOGS. The last 5 sessions are kept; WAKES/LOGS/SESSION holds the -; latest session's number. If you ask us for help, send them all. -; Each file stops at 8 MB, about 12 hours of playing. STANDBY (plugged in and off) is not -; logged. +; Wakes logs activity to its drive, in WAKES/LOGS/. One file per session (from turning Wakes +; on, until it is turned off). The last 5 sessions are kept. +; Find your log files in WAKES/LOGS/SESSION. Logs are named with the latest session's number. +; If you need support, we might ask you to send us these. Each file stops at 8 MB, about 12 +; hours of playing. ; -; Wakes reads this file every time it turns ON, so a change takes effect at the next ON. -; Lines starting with ; are comments. Every setting can be left out to get its default. +; Wakes reads this .cnfg file every time it turns ON and applies cnfg changes. +; Edit these settings to control log granularity. Adara might ask to edit these based on your +; circumstance. +; +; Lines starting with ; or # are comments. Every setting can be left out to get its default. ; A setting Wakes cannot read keeps its default, and the log says which line it was. ; -; Startup, power, battery and error lines are always written; the settings below choose -; what else goes in. +; Startup, power, battery, headphone and cnfg file lines are always written; +; the settings below choose what else gets logged. [logs] ; on = Wakes writes the log to its drive while ON (default). @@ -26,13 +28,13 @@ enabled = on performance = on ; What you do on the controls: pages, engines, routing, scales, ROTC. -controls = on +controls = off ; MIDI over USB, and the MIDI clock. -midi = on +midi = off ; USB audio out and the USB connection. -usb = on +usb = off -; The drive itself: loading and saving presets (PRST), the config files, the log. +; Storage drive logs: loading and saving presets (PRST), .logs files. storage = on diff --git a/config/midi.cnfg b/config/midi.cnfg index 0db9a20..9338b72 100644 --- a/config/midi.cnfg +++ b/config/midi.cnfg @@ -1,9 +1,9 @@ ; Format: ini ; ===================================================================================== -; Wakes — the MIDI script +; Wakes — MIDI ; ===================================================================================== ; -; How Wakes listens to MIDI over USB. Wakes reads this file from its drive +; This file configures Wakes' MIDI handling. Wakes reads this file from its drive ; (WAKES/CNFG/midi.cnfg) every time it turns ON, so a change takes effect at the next ON. ; ; Lines starting with ; or # are comments. Every setting can be left out to get its @@ -11,36 +11,13 @@ ; If two of your lines give the same CC, the first one keeps it and the later one gets ; none. A CC you give a parameter is taken from whichever parameter had it by default. ; The CC chart that comes with each Wakes release lists the default CCs. -; -; What MIDI does on Wakes, in short: -; NOTES play Plaits, one at a time (the newest, by default). A note-on strikes TRIG and -; opens LEVEL -- as far as the note's velocity says, by default ([bind] below) -- and a -; note-off lets it close through Plaits' own low-pass gate. Pitch is added to FREQUENCY -; like a V/Oct cable, with note 60 (C4) adding nothing: with F1 on its centre detent the -; keyboard plays at its real pitch, and F1 transposes. From the first note or CC until -; you unplug, FREQUENCY's scale quantizer stands aside and F1's centre detent widens -; to 10 %. -; CCs: each parameter below can be given a CC, which moves it like a second hand on its -; fader -- how the two hands share it is `pickup`, below. Nothing moves until you aim -; something at it. -; CLOCK: Marbles follows the host's MIDI clock and Start / Continue / Stop (`clock`). -; UNPLUG: notes are released, the bend and every offset go back to neutral, and a -; Marbles the host was clocking stops and has its own clock again. -; -; The Wakes manual has the whole story. -; -; Credit: the way Wakes plays notes -- which held note sounds, legato, portamento, the -; sustain pedal -- is ported from Mutable Instruments Yarns (Emilie Gillet, MIT): its -; monophonic part, with its note stack, its legato modes and its portamento curves and -; table. Everything Yarns does that matters here is explained below, so you never need -; its manual to read this file. Attribution in NOTICE. [midi] -; Which MIDI channel Wakes listens on: 1-16, or omni (every channel). Clock and transport -; have no channel, so Marbles follows them whatever this says. -channel = 1 +; Which MIDI channel Wakes listens on: 1-16, or omni (every channel). +channel = omni -; Plaits plays one note at a time. When several keys are held, which one you hear: +; note_priority - Plaits is a monophonic synthesizer. When several keys are held, determines +; which one you hear: ; last = the most recently pressed key (most mono synths). ; low = the lowest key held -- a bass line that ignores notes played above it. ; high = the highest key held -- a lead that ignores notes played below it. @@ -48,10 +25,10 @@ channel = 1 ; rule takes over if it is still held (with `last`: the one pressed before it). note_priority = last -; What happens when a new note takes over while another key is still held: +; legato - What happens when a new note takes over while another key is still held: ; off = it strikes TRIG again, like a new note, and so does falling back to a key still ; held. Every note is articulated. Portamento (below) applies to every note. -; on = it does NOT strike: the pitch moves to the new note while the sound carries on, +; on = no reTRIG: the pitch moves to the new note while the sound carries on, ; as on a monosynth played legato. Only a note played after letting go of every ; key strikes. Portamento applies to every note. ; auto = as on, and portamento ONLY between overlapping notes: play legato to glide, @@ -60,9 +37,10 @@ note_priority = last ; The same pitch played again before its note-off -- a sequencer's notes longer than its ; step -- strikes again in off, and is tied into one long note in on and auto. Either way it ; ends at the LAST of its note-offs, not the first. -legato = off +legato = auto -; Portamento: the pitch glides from one note to the next instead of jumping. 0 = none. +; portamento - the pitch glides from one note to the next instead of jumping. +; 0 = none. ; t1 .. t50 = constant TIME: every glide takes the same time, whatever the interval. ; The curve is exponential -- fast at first, then settling into the note, ; the way an analog glide (a capacitor charging) sounds -- and it lands @@ -73,24 +51,44 @@ legato = off ; The scale is steep, finest at the short end. Glide time (t), or time per octave (r): ; 1 ~ 1 ms 5 ~ 6 ms 10 ~ 22 ms 20 ~ 135 ms 30 ~ 0.47 s 40 ~ 1.2 s 50 ~ 2.6 s ; (r0 is under 1 ms per octave: practically instant.) -portamento = 0 +portamento = t9 -; Pitch bend range in semitones, 0-24. If the host sends its own bend range -; (RPN 0, "pitch bend sensitivity"), Wakes uses the host's until it is unplugged. +; bend_range - Pitch bend range in semitones, 0-24. If the host sends its own bend range +; (RPN 0, "pitch bend sensitivity"), Wakes uses the host's until unplugged. bend_range = 2 ; The sustain pedal: cc N, or off. CC 64 is the standard pedal. sustain = cc 64 -; How long a CC takes to glide to a new value, in milliseconds (0-200). This is what -; turns a CC's steps into a smooth movement instead of zipper noise. Stepped parameters -; (OCTAVE range, MODEL, LENGTH, Y divider) do not glide: a step is the point. +; cc_smoothing - How long a CC takes to glide to a new value, in milliseconds (0-200). +; This is what turns a CC's steps into a smooth movement instead of zipper noise. cc_smoothing = 10 -; How a CC and its fader share a parameter. All three use Plaits' own pickup ("catch-up"), -; the one its knobs use after a preset change: a control that does not match the value -; does not make it jump -- moving it moves the value the same way from where it is, a -; little faster or slower, until the two meet and it simply follows. +; clock - controls whether Marbles receives MIDI clock and transport. +; on = Marbles' clock syncs with the host's clock when it receives a tick or start message. +; Marbles' RATE fader then picks a ratio of the host's beat instead of a tempo: +; 1/4, 1/3, 1/2, 2/3, 1, 3/2, 2, 3, 4. DIV+/- selects a subdivision of that ratio. +; off = disabled. +clock = on + +; clock_lead - Determines how far ahead of the host's clock Marbles will compensate. +; notes (default) = Marbles will intelligently switch between MIDI note-based clock +; delay compensation and its own auto-switching delay compensation (below). +; auto = Wakes' own delay (8.5 ms): Marbles' beats leave the output when the clock's do. +; While the host is recording Wakes over USB audio, that output is 1 ms later, and +; auto (and notes, until it has measured) follows it: 9.5 ms. +; 0-200 = that many ms, for a host whose clock offset you would rather set here. +; Tips: +; With the 'notes' or 'auto' options, leave the host's own clock offset / sync delay +; for Wakes at 0. +; Wakes outputs sound with a small delay after the triggers that cause it. Audio can't +; be played early, but a clock can: it is steady, so Wakes can read ahead and compensate +; to play tighter. +clock_lead = notes + +; pickup - How a CC and its fader share a parameter. A control that does not match the value +; does not jump - moving it moves the value the same way from where it is, a little faster +; or slower, until the two meet and continue together. ; ; sum = the CC is an OFFSET on top of the fader: fader + CC. A parameter whose ; middle is neutral reads its CC centred (64 = no change, 0 / 127 = half a @@ -113,133 +111,118 @@ cc_smoothing = 10 ; [bind] sources at the end of this file. pickup = shared -; MIDI clock and transport into Marbles: on, or off (ignore them). -; on = from the host's first clock tick (or Start), Marbles' clock IS the host's clock, -; like a cable in the Eurorack Marbles' CLOCK input. Marbles' RATE fader then picks a -; ratio of the host's beat instead of a tempo: 1/4, 1/3, 1/2, 2/3, 1, 3/2, 2, 3, 4 -; (Marbles' own table, centre = 1), times 4 or 1/4 with the t range. Start plays from -; beat 1, Continue carries on, Stop stops; PLAY still works too. MMC Play / Stop -; (MIDI Machine Control, what the OP-XY sends) work too: with MIDI clock arriving, -; Play waits for beat 1 like Start; without, it plays Marbles on its own RATE -; tempo. If the host stops -; sending clock, Marbles waits for it. Unplug, and Marbles stops and has its own -; clock again. Song Position Pointer is ignored. -; A DAW's clock arrives a few ms early or late on every tick: Wakes follows a -; straight line through the last two beats of ticks, not each tick, so Marbles' -; beats stay steady (under 1 ms of the +-8 ms in the ticks). -; Clock alone does not count as MIDI in use: the scale quantizer and F1's detent -; stay as they are. The FFWD burst follows the host's tempo too. -clock = on - -; How far ahead of the host's clock Marbles runs: notes, auto, or a number of ms (0-200). -; Wakes plays every sound about 8.5 ms after the MIDI that caused it (one 2 ms audio -; block to place the message on time, the audio queued ahead of the output, and Plaits' -; 0.5 ms TRIG delay). Notes cannot be played early, but a clock can: it is steady, so -; Wakes can read it ahead. -; notes (default) = Marbles' beats land with the host's NOTES. Hosts often send their -; clock later than their notes (Bitwig: ~23 ms), so following the clock alone puts -; Marbles late against the notes it modulates. Wakes measures where the host's notes -; fall on its clock -- quantised notes, every 5 s -- and leads by exactly that, so -; no clock offset is needed in the host. Until notes arrive (or with notes off the -; grid: swing, triplets, playing by hand) it uses auto. The console's "MIDI notes vs -; clock" line shows the measurement and the lead in use. -; auto = Wakes' own delay (8.5 ms): Marbles' beats leave the output when the clock's do. -; While the host is recording Wakes over USB audio, that output is 1 ms later, and -; auto (and notes, until it has measured) follows it: 9.5 ms. -; A number: that many ms, for a host whose clock offset you would rather set here. -; With notes or auto, leave the host's own clock offset / sync delay for Wakes at 0. -; Beat 1 after a Start is the exception: nothing said when it would come, so it sounds -; on arrival and Marbles is on time from beat 2. -clock_lead = notes - - ; ------------------------------------------------------------------------------------- -; The parameters, and which CC moves each one. name = cc N (or none) +; MIDI CC Assignments +; +; Example: +; +; name = cc N (or none) ; ; CC 0-31 are 14-bit: Wakes also listens to their partner CC N+32 for the fine half of ; the value, which is how a host sends high-resolution CCs. A host that only sends the ; coarse half still works. Any other CC is 7-bit (128 steps), smoothed. +; For this reason, CCs 33-63 can't be assigned. Wakes will refuse them. ; ; The defaults below use only CC numbers that keyboards and DAWs do not send on their ; own (the undefined ones, and General Purpose 1-4 = CC 16-19), so out of the box ; nothing moves until you point something at it. The mod wheel (1), breath (2), foot ; (4), portamento time (5) and expression (11) are deliberately left free for you. ; -; Not allowed, because MIDI already uses them: CC 0/32 (bank select), 6/38 and 96-101 -; (data entry and parameter numbers -- needed for the host's bend range), 120-127 -; (channel mode messages), and whatever CC the sustain pedal is on. CC 33-63 are the fine -; halves of CC 1-31: give the parameter CC N, and N+32 comes with it. A CC may move only -; one parameter. +; The following MIDI CCs are not allowed for parameter control, +; as they are taken up by other functions: +; CC 0 and its fine-half CC 32 (bank select) +; CC 6 and its fine-half CC 38 (data entry) +; CC 96-101 (data entry and parameter numbers -- needed for the host's bend range) +; CC 120-127 (channel mode messages) +; CC 33-63 (discussed above) ; -; How a CC reads depends on `pickup` (above): in shared and takeover it is the fader's -; position (0 = bottom, 127 = top); in sum it is an offset, centred or one-sided. +; How a CC reads depends on `pickup` (refer to the explanation above). ; ------------------------------------------------------------------------------------- + + + [plaits] ; BASE page timbre = cc 3 morph = cc 9 harmonics = cc 14 frequency = cc 15 + ; SHIFT page: the four attenuverters fm_attenuverter = cc 20 timbre_attenuverter = cc 21 morph_attenuverter = cc 22 harmonics_attenuverter = cc 23 + ; SETTINGS page lpg_colour = cc 24 lpg_decay = cc 25 -level = cc 26 ; can connect LEVEL, as pushing the fader up does -octave_range = cc 102 ; stepped: whole range modes -; Not on a fader at all: which engine plays, as an offset from the one T2/T3 selected, -; up through the filled slots of engines.cnfg (0 = the selected engine, 127 = the -; last slot). A change plays the engine flash, as T2/T3 do, and MIDI changes the engine at -; most every 50 ms -- each change costs the audio a moment, as a T2/T3 press does. +level = cc 26 +octave_range = cc 102 +; model - Selects which engine plays, as an offset from the one T2/T3 selected, +; up through the filled slots of engines.cnfg (0 = the selected engine, 127 = the +; last slot). Changing MODEL will flash the slot glyph, as T2/T3 do. +; MIDI changes the engine at most every 50 ms -- each change costs the audio thread +; a brief CPU spike, as a T2/T3 press does. model = cc 105 + + + [marbles] ; t page rate = cc 27 t_bias = cc 16 jitter = cc 85 deja_vu = cc 31 + ; t SHIFT page -gtlt = cc 89 ; t gate tilt +gtlt = cc 89 gate_length = cc 17 gate_length_random = cc 86 -length = cc 103 ; stepped +length = cc 103 + ; X page spread = cc 28 x_bias = cc 29 steps = cc 30 + ; SETTINGS (Y) page y_spread = cc 18 y_bias = cc 19 y_steps = cc 87 -y_divider = cc 104 ; stepped +y_divider = cc 104 + + ; ------------------------------------------------------------------------------------- ; Extra sources. ; -; velocity = [depth%] how hard each note was played -; aftertouch = [depth%] channel pressure +; velocity = [%] how hard each note was played +; aftertouch = [%] channel pressure ; -; is any name from the two lists above (or none), and the depth is -100% .. 100% -; (default 100%). The source pushes that parameter up from where it is, by up to its -; whole travel at 100% -- an offset, whatever `pickup` says. +; is any parameter name pasted from the two MIDI CC parameter lists above +; (or `none`), and an optional depth setting -100% .. 100% (100% if unset). +; The source offsets that parameter by up to its full travel at 100%, regardless of the +; `pickup` setting selected above. ; ; Aimed at `level`, it sets how far each note opens LEVEL instead, which Plaits also reads -; as accent: soft notes are quieter AND darker, as on the module with a velocity CV in -; LEVEL. At 100% the hardest note opens it fully and the softest barely at all; at 50% -; the softest still opens it half way. It shapes MIDI notes only: once a note's release -; has ended, LEVEL is the fader's again, as it is for RWD, FFWD and Marbles' TRIG. -; To play every note at full LEVEL, write `velocity = none`. +; similarly to an accent modulation: soft notes are quieter and darker. +; At 100%, the hardest note opens the LPG fully, and at 0%, velocity is functionally +; disabled. To play every note at full LEVEL, disconnect velocity by setting it to `none`. ; ; You can also do this on the host instead: most DAWs can turn velocity or pressure ; into a CC, and aim it at the CC of the parameter you want. +; +; Examples: +; +; velocity = level +; aftertouch = timbre 50% +; ; ------------------------------------------------------------------------------------- [bind] -velocity = level -; aftertouch = timbre 50% +velocity = none +aftertouch = none diff --git a/docs/MIDI.md b/docs/MIDI.md index b9e6714..5a73dc1 100644 --- a/docs/MIDI.md +++ b/docs/MIDI.md @@ -13,8 +13,8 @@ next ON. | | | |---|---| -| **Notes** | play Plaits. A note-on strikes **TRIG** and holds **LEVEL** open — as far as the note's **velocity** says, out of the box, so soft notes are quieter and darker (Plaits reads LEVEL as accent too); a note-off lets LEVEL close through Plaits' own low-pass gate, so the release is the LPG's. | -| **Several keys** | Plaits is one voice: you hear the **newest** key. Let it go and you hear the previous one if it is still held. (`note_priority` in the script can make it the lowest or the highest key held instead.) The same pitch played again before its note-off -- a sequencer's notes longer than its step -- strikes again with `legato = off` and is tied into one long note with `on` / `auto`; it ends at its **last** note-off. Even a note shorter than a quarter of a millisecond opens the gate. | +| **Notes** | play Plaits, on **any channel** out of the box (`channel = omni`). A note-on strikes **TRIG** and holds **LEVEL** fully open — velocity changes nothing out of the box; `[bind]` can aim it at LEVEL so soft notes are quieter and darker (Plaits reads LEVEL as accent too). A note-off lets LEVEL close through Plaits' own low-pass gate, so the release is the LPG's. | +| **Several keys** | Plaits is one voice: you hear the **newest** key. Let it go and you hear the previous one if it is still held. (`note_priority` in the script can make it the lowest or the highest key held instead.) Out of the box (`legato = auto`, `portamento = t9`) a key played while another is held **glides** to its pitch in about 18 ms without a new strike, and a key played after letting go strikes and jumps straight to its note. The same pitch played again before its note-off -- a sequencer's notes longer than its step -- strikes again with `legato = off` and is tied into one long note with `on` / `auto`; it ends at its **last** note-off. Even a note shorter than a quarter of a millisecond opens the gate. | | **Pitch** | added to FREQUENCY like a V/Oct cable, with **note 60 (C4) adding nothing**. F1 on its centre detent is exactly C4, so a centred F1 plays the keyboard at its real pitch, and moving F1 transposes. While MIDI is in use the FREQUENCY detent is **10 %** of the fader's travel (5 % otherwise), so C4 is easy to land on. | | **Pitch bend** | ±2 semitones, or whatever range the host sends (RPN 0, "pitch bend sensitivity"). | | **Sustain pedal** | CC 64 holds released notes until it lifts. | @@ -213,14 +213,14 @@ where to get a clean copy. What it sets: -- `channel` — 1–16, or `omni`. +- `channel` — 1–16, or `omni` (default: every channel). - `note_priority` — `last` (default), `low` or `high`. -- `legato` — `off` (every new note strikes; the default), `on` (a note played over a held one - slides without striking), `auto` (as `on`, with portamento only between overlapping notes, - so playing legato glides and playing detached jumps). +- `legato` — `off` (every new note strikes), `on` (a note played over a held one slides + without striking), `auto` (the default: as `on`, with portamento only between overlapping + notes, so playing legato glides and playing detached jumps). - `portamento` — `0`, `t1`–`t50` (constant time, an exponential glide), `r0`–`r50` (constant rate, a straight line, timed per octave). From about 1 ms up to about 2.6 s; - the script lists the steps. + the script lists the steps. The default is `t9`, about 18 ms. - `bend_range` — 0–24 semitones, until the host sends its own. - `sustain` — `cc N`, or `off`. - `cc_smoothing` — 0–200 ms: how long a CC glides to a new value. This is what turns a CC's @@ -234,9 +234,9 @@ What it sets: - `[bind]` — `velocity` and `aftertouch` (channel pressure) can push a parameter by a depth (`velocity = timbre 40%`). Aimed at `level`, they set how far each note opens LEVEL — which Plaits also reads as accent, so soft notes are quieter and darker. **The shipped - script has `velocity = level`** (100 %: the softest note barely opens it; at 50 % the - softest still opens it half way). Write `velocity = none` to play every note at full LEVEL - (leaving the line out keeps the built-in `level`). + script has `velocity = none` and `aftertouch = none`**: every note opens LEVEL fully. Write + `velocity = level` for velocity on LEVEL (100 %: the softest note barely opens it; at 50 % + the softest still opens it half way; at 0 % velocity does nothing). You can also do this on the host instead: most DAWs can turn velocity or pressure into a CC and aim it at one of the CCs above. diff --git a/firmware/src/sp1_cnfg.c b/firmware/src/sp1_cnfg.c index f34b81d..d9acc0a 100644 --- a/firmware/src/sp1_cnfg.c +++ b/firmware/src/sp1_cnfg.c @@ -912,8 +912,9 @@ static void bind_section(struct sp1_midi_reader *r, int line, const char *key, c return; } int dest = -1; - int depth = 100; + int depth = 0; /* none: depth 0, as gen_midi.py writes an unbound source */ if (!same(value, "none")) { + depth = 100; char name[SP1_CNFG_NAME_MAX]; size_t n = 0u; const char *s = value; diff --git a/firmware/src/sp1_logbuf.c b/firmware/src/sp1_logbuf.c index 12fefa6..06bf2b9 100644 --- a/firmware/src/sp1_logbuf.c +++ b/firmware/src/sp1_logbuf.c @@ -207,6 +207,17 @@ size_t sp1_logbuf_file_take(char *out, size_t max, uint32_t *lost) return n; } +size_t sp1_logbuf_file_take_before_standby(char *out, size_t max, uint32_t *lost) +{ + if (max > SP1_LOGBUF_TAKE_MAX) { + max = SP1_LOGBUF_TAKE_MAX; + } + k_spinlock_key_t key = k_spin_lock(&lock); + const size_t n = sp1_logring_take_before_standby(&hdr.ring, data, out, max, lost); + k_spin_unlock(&lock, key); + return n; +} + void sp1_logbuf_file_pause(void) { k_spinlock_key_t key = k_spin_lock(&lock); diff --git a/firmware/src/sp1_logbuf.h b/firmware/src/sp1_logbuf.h index 03effb3..972c4b5 100644 --- a/firmware/src/sp1_logbuf.h +++ b/firmware/src/sp1_logbuf.h @@ -52,8 +52,8 @@ bool sp1_logbuf_replaying(void); void sp1_logbuf_replay_step(void); /* ---- the log file (#52) ---- - * This boot carries on a log kept across a soft reset (the "=== RESET" marker): the same - * session, so the drive's log is appended to rather than rotated. */ + * This boot carries on a log kept across a soft reset (the "=== RESET" marker): the crash and + * this boot's first lines go to the interrupted session's file, the next ON starts a new one. */ bool sp1_logbuf_continued(void); uint32_t sp1_logbuf_resetreas(void); @@ -61,6 +61,8 @@ uint32_t sp1_logbuf_resetreas(void); * bytes, taken under the lock -- one line's copy with interrupts held off, a few us. */ #define SP1_LOGBUF_TAKE_MAX 256u size_t sp1_logbuf_file_take(char *out, size_t max, uint32_t *lost); +/* The same, only for lines from before the last STANDBY (sp1_logring_take_before_standby). */ +size_t sp1_logbuf_file_take_before_standby(char *out, size_t max, uint32_t *lost); /* Main thread: STANDBY entry / ON entry (STANDBY is not logged to the drive), and "logging * is off this ON" (nothing written so far is owed to the file). */ diff --git a/firmware/src/sp1_logring.c b/firmware/src/sp1_logring.c index 21aac1a..c4862cd 100644 --- a/firmware/src/sp1_logring.c +++ b/firmware/src/sp1_logring.c @@ -99,8 +99,23 @@ void sp1_logring_keep(struct sp1_logring *r) r->discard = 0u; } +static size_t take_lines(struct sp1_logring *r, const char *data, char *out, size_t max, + uint32_t *lost, bool before_standby); + size_t sp1_logring_take(struct sp1_logring *r, const char *data, char *out, size_t max, uint32_t *lost) +{ + return take_lines(r, data, out, max, lost, false); +} + +size_t sp1_logring_take_before_standby(struct sp1_logring *r, const char *data, char *out, + size_t max, uint32_t *lost) +{ + return take_lines(r, data, out, max, lost, true); +} + +static size_t take_lines(struct sp1_logring *r, const char *data, char *out, size_t max, + uint32_t *lost, bool before_standby) { bool resync = false; @@ -121,29 +136,40 @@ size_t sp1_logring_take(struct sp1_logring *r, const char *data, char *out, size resync = true; /* mid-line, most likely */ } - /* 2. Over a closed gap. Resume lands between lines, so no resync after it. */ - if (r->gap && !before(r->frd, r->gap_from)) { - if (before(r->frd, r->gap_to)) { - r->frd = r->gap_to; - resync = false; - } - r->gap = 0u; - } - - /* 3. How far the file may read: to the gap, if there is one ahead. While paused, - * everything from gap_from on is STANDBY's (the cursor waits there for the resume); - * after step 2 a closed gap is always ahead of the cursor. */ uint32_t limit = r->total; bool cut = false; - if (r->paused) { + if (before_standby) { + /* Only what the last ON still owes ITS file: up to where STANDBY began, never + * across. gap_from marks that whether or not STANDBY printed anything (an empty + * STANDBY leaves gap_from == gap_to, and no gap to jump), and while it lasts. */ if (!before(r->frd, r->gap_from)) { return 0u; } limit = r->gap_from; cut = true; - } else if (r->gap) { - limit = r->gap_from; - cut = true; + } else { + /* 2. Over a closed gap. Resume lands between lines, so no resync after it. */ + if (r->gap && !before(r->frd, r->gap_from)) { + if (before(r->frd, r->gap_to)) { + r->frd = r->gap_to; + resync = false; + } + r->gap = 0u; + } + + /* 3. How far the file may read: to the gap, if there is one ahead. While paused, + * everything from gap_from on is STANDBY's (the cursor waits there for the + * resume); after step 2 a closed gap is always ahead of the cursor. */ + if (r->paused) { + if (!before(r->frd, r->gap_from)) { + return 0u; + } + limit = r->gap_from; + cut = true; + } else if (r->gap) { + limit = r->gap_from; + cut = true; + } } if (resync) { diff --git a/firmware/src/sp1_logring.h b/firmware/src/sp1_logring.h index f05c97c..cb3972a 100644 --- a/firmware/src/sp1_logring.h +++ b/firmware/src/sp1_logring.h @@ -65,5 +65,10 @@ void sp1_logring_keep(struct sp1_logring *r); * line is taken only where a gap cuts it. `*lost` += bytes the ring overwrote first. */ size_t sp1_logring_take(struct sp1_logring *r, const char *data, char *out, size_t max, uint32_t *lost); +/* As _take, but only lines from before the last STANDBY began: what the previous ON still owes + * its own file (its closing lines, or a 30 s backstop's tail) when this ON starts a new one. + * 0 once the cursor reaches STANDBY; never crosses it. */ +size_t sp1_logring_take_before_standby(struct sp1_logring *r, const char *data, char *out, + size_t max, uint32_t *lost); #endif /* SP1_LOGRING_H */ diff --git a/firmware/src/sp1_store.c b/firmware/src/sp1_store.c index 37007ed..e7e8dc5 100644 --- a/firmware/src/sp1_store.c +++ b/firmware/src/sp1_store.c @@ -641,8 +641,8 @@ static void cnfg_create_missing(void) /* ---------------------------------------------------------------- the log (#52) */ -/* One file per session, NNNN.LOGS (Adara): the session number mod 10000, so 9999.LOGS is - * followed by 0000.LOGS. The number itself keeps counting, in WAKES/LOGS/SESSION and in each +/* One file per session, NNNN.logs (Adara): the session number mod 10000, so 9999.logs is + * followed by 0000.logs. The number itself keeps counting, in WAKES/LOGS/SESSION and in each * file's first line. The last SP1_STORE_LOG_KEEP sessions are kept: a new one deletes the * file of the session SP1_STORE_LOG_KEEP before it. */ #define LOG_SESSION DIR_LOGS "/SESSION" @@ -651,7 +651,7 @@ static void cnfg_create_missing(void) static atomic_t log_live_a; /* main reads it: sp1_store_log_live() */ static bool log_live; /* the file is open, the card on and mounted */ -static bool session_open; /* this boot has opened (or started) its file */ +static bool session_open; /* this boot has opened a session's file */ static uint32_t session_n; /* ...and its session number */ static char log_path[sizeof(DIR_LOGS) + 16]; static struct fs_file_t log_f; @@ -668,7 +668,7 @@ static uint32_t sum_t0, sum_flushes, sum_bytes, sum_max_ms, sum_lost; static void log_name(uint32_t n, char *buf, size_t size) { - snprintk(buf, size, DIR_LOGS "/%04u.LOGS", (unsigned)(n % LOG_NAMES)); + snprintk(buf, size, DIR_LOGS "/%04u.logs", (unsigned)(n % LOG_NAMES)); } /* WAKES/LOGS/SESSION: the last session's number. false if it is missing or not a number. */ @@ -720,10 +720,48 @@ static int log_write(const char *d, size_t n) return log_put(d, n); } -/* The volume mounted, at the end of the ON job: open this session's file. The first time this - * boot, a NEW session -- the next number -- unless the boot carries on a log kept across a - * soft reset (the same session: the crash and what led to it stay in one file). Later ONs of - * the same boot carry on too. */ +static int log_flush(bool before_standby); + +/* Before a new session: the lines the previous one still owes its own file -- what it printed + * after its last flush (its closing lines), or a 30 s backstop's tail, or, after a soft reset + * that kept the RAM log, the crash and the boot that followed it. They are in the RAM log + * before the last STANDBY; without this they would open the NEW file. Its own errors are + * logged, not returned: the new session opens anyway, and anything left goes into it. */ +static void log_catch_up(uint32_t prev) +{ + log_name(prev, log_path, sizeof(log_path)); + fs_file_t_init(&log_f); + /* No FS_O_CREATE: a file deleted from a computer meanwhile is not brought back. */ + int rc = fs_open(&log_f, log_path, FS_O_WRITE | FS_O_APPEND); + if (rc != 0) { + if (rc != -ENOENT) { + LINE("LOG could not reopen %s for the last ON's lines (%d)\n", + log_path + sizeof(DIR_LOGS), rc); + } + return; + } + rc = fs_seek(&log_f, 0, FS_SEEK_END); + const off_t at = (rc == 0) ? fs_tell(&log_f) : -1; + if (at >= 0) { + log_size = (uint32_t)at; + log_full = log_size >= SP1_STORE_LOG_MAX; + piece_cont = false; + rc = log_flush(true); + } + const uint32_t added = (at >= 0) ? log_size - (uint32_t)at : 0u; + (void)fs_close(&log_f); + if ((at < 0 || rc != 0) && !stop) { + LINE("LOG the last ON's lines into %s FAILED (%d)\n", log_path + sizeof(DIR_LOGS), + at < 0 ? (int)at : rc); + } else if (added > 0u && !stop) { + LINE("LOG %u B of the last ON's lines into %s\n", (unsigned)added, + log_path + sizeof(DIR_LOGS)); + } +} + +/* The volume mounted, at the end of the ON job: every ON starts a NEW session, the next + * number (Adara, 2026-10-16: STANDBY then ON is a new file too). The previous session's + * last lines go to its own file first (log_catch_up). */ static int log_open(void) { int rc = ensure_dir(DIR_WAKES); @@ -735,33 +773,28 @@ static int log_open(void) } uint32_t last = 0u; const bool known = log_read_session(&last); - bool fresh_session = false; - if (!session_open) { - if (sp1_logbuf_continued() && known) { - session_n = last; /* a soft reset: the same session */ - } else { - session_n = known ? last + 1u : 1u; - fresh_session = true; - } + if (session_open) { + log_catch_up(session_n); /* an earlier ON of this boot */ + } else if (sp1_logbuf_continued() && known) { + log_catch_up(last); /* the session a soft reset interrupted */ } + session_n = (known ? last : (session_open ? session_n : 0u)) + 1u; log_name(session_n, log_path, sizeof(log_path)); - if (fresh_session) { - char t[16]; - const int n = snprintk(t, sizeof(t), "%u\n", (unsigned)session_n); - rc = write_file(LOG_SESSION, t, (size_t)n); - if (rc != 0) { - return rc; - } - /* A file already under this name is from a session 10000 back (or a lost - * counter): this session starts it afresh. */ - (void)fs_unlink(log_path); - if (session_n > SP1_STORE_LOG_KEEP) { - char old[sizeof(log_path)]; - log_name(session_n - SP1_STORE_LOG_KEEP, old, sizeof(old)); - const int urc = fs_unlink(old); - if (urc != 0 && urc != -ENOENT) { - LINE("LOG could not delete %s (%d)\n", old + sizeof(DIR_LOGS), urc); - } + char num[16]; + const int k = snprintk(num, sizeof(num), "%u\n", (unsigned)session_n); + rc = write_file(LOG_SESSION, num, (size_t)k); + if (rc != 0) { + return rc; + } + /* A file already under this name is from a session 10000 back (or a lost + * counter): this session starts it afresh. */ + (void)fs_unlink(log_path); + if (session_n > SP1_STORE_LOG_KEEP) { + char old[sizeof(log_path)]; + log_name(session_n - SP1_STORE_LOG_KEEP, old, sizeof(old)); + const int urc = fs_unlink(old); + if (urc != 0 && urc != -ENOENT) { + LINE("LOG could not delete %s (%d)\n", old + sizeof(DIR_LOGS), urc); } } fs_file_t_init(&log_f); @@ -778,22 +811,20 @@ static int log_open(void) log_size = (uint32_t)at; log_full = log_size >= SP1_STORE_LOG_MAX; piece_cont = false; - if (fresh_session || log_size == 0u) { - char h[160]; - const int n = snprintk(h, sizeof(h), "=== Wakes v" APP_VERSION_STRING ", built %s %s -- " - "log session %u -- resetreas 0x%08x ===\n", __DATE__, __TIME__, - (unsigned)session_n, sp1_logbuf_resetreas()); - rc = log_write(h, (size_t)n); - if (rc != 0) { - (void)fs_close(&log_f); - return rc; - } + char h[160]; + const int n = snprintk(h, sizeof(h), "=== Wakes v" APP_VERSION_STRING ", built %s %s -- " + "log session %u -- resetreas 0x%08x ===\n", __DATE__, __TIME__, + (unsigned)session_n, sp1_logbuf_resetreas()); + rc = log_write(h, (size_t)n); + if (rc != 0) { + (void)fs_close(&log_f); + return rc; } session_open = true; log_live = true; atomic_set(&log_live_a, 1); - LINE("LOG %s %u: WAKES/LOGS/%s (%u KB)\n", fresh_session ? "new session" : "carrying on session", - (unsigned)session_n, log_path + sizeof(DIR_LOGS), (unsigned)(log_size / 1024u)); + LINE("LOG new session %u: WAKES/LOGS/%s (%u KB)\n", (unsigned)session_n, + log_path + sizeof(DIR_LOGS), (unsigned)(log_size / 1024u)); return 0; } @@ -813,8 +844,9 @@ static bool keep_piece(const char *d, size_t n) } /* Everything new in the RAM log, into the file, then synced: the file's size on the card is - * then current, so a cut-off loses only what came after. */ -static int log_flush(void) + * then current, so a cut-off loses only what came after. `before_standby`: only the lines + * from before the last STANDBY (log_catch_up). */ +static int log_flush(bool before_standby) { const uint32_t t0 = k_uptime_get_32(); size_t used = 0u; @@ -822,7 +854,9 @@ static int log_flush(void) int rc = 0; for (;;) { uint32_t lost = 0u; - const size_t n = sp1_logbuf_file_take(piece, sizeof(piece), &lost); + const size_t n = before_standby + ? sp1_logbuf_file_take_before_standby(piece, sizeof(piece), &lost) + : sp1_logbuf_file_take(piece, sizeof(piece), &lost); if (lost > 0u) { sum_lost += lost; char m[112]; @@ -908,7 +942,7 @@ static void log_tick(void) } log_next = ((int32_t)(now - log_next) > (int32_t)SP1_STORE_LOG_FLUSH_MS) ? now + SP1_STORE_LOG_FLUSH_MS : log_next + SP1_STORE_LOG_FLUSH_MS; - const int rc = log_flush(); + const int rc = log_flush(false); if (rc != 0) { if (!stop) { LINE("LOG off: writing %s failed (%d) -- no more log on the drive " @@ -937,7 +971,7 @@ static void log_end(void) const uint32_t t0 = k_uptime_get_32(); LINE("LOG closing %s (%u KB)\n", log_path + sizeof(DIR_LOGS), (unsigned)(log_size / 1024u)); - const int rc = log_flush(); + const int rc = log_flush(false); log_finish(); if (rc != 0 && !stop) { LINE("LOG the last flush FAILED (%d) after %u ms\n", rc, diff --git a/firmware/src/sp1_store.h b/firmware/src/sp1_store.h index 22c346e..18ca3a5 100644 --- a/firmware/src/sp1_store.h +++ b/firmware/src/sp1_store.h @@ -156,11 +156,12 @@ enum sp1_store_save sp1_store_save_result(void); * THE LOG (Adara, #52): with logs.cnfg's `enabled = on` (the default) the ON job opens this * session's file in WAKES/LOGS/ and the card STAYS on and mounted for the whole ON session; * every SP1_STORE_LOG_FLUSH_MS the thread appends what the RAM log (sp1_logbuf.h) has - * gathered, filtered by logs.cnfg's categories, and syncs. One file per session, NNNN.LOGS = - * the session number mod 10000 (9999.LOGS is followed by 0000.LOGS); the number keeps - * counting in WAKES/LOGS/SESSION. A new session -- the first ON after a power-on from OFF -- - * takes the next number and deletes the file SP1_STORE_LOG_KEEP sessions back; a boot that - * carries on a RAM log kept across a soft reset is the same session and appends. Each file stops at SP1_STORE_LOG_MAX + * gathered, filtered by logs.cnfg's categories, and syncs. One file per session, NNNN.logs = + * the session number mod 10000 (9999.logs is followed by 0000.logs); the number keeps + * counting in WAKES/LOGS/SESSION. EVERY ON is a new session (Adara, 2026-10-16: STANDBY then + * ON too): it takes the next number and deletes the file SP1_STORE_LOG_KEEP sessions back, + * after appending to the previous session's file what that one still owed it (its closing + * lines, a backstop's tail, or a crash kept across a soft reset). Each file stops at SP1_STORE_LOG_MAX * with a last line saying so. STANDBY is not logged. A LOG line once a minute gives the * flushes, bytes and the longest flush (the CPU check Adara asked for). * At shutdown the PRST save goes first, then the last lines (main waits on diff --git a/tools/host-tests/cnfgtest.c b/tools/host-tests/cnfgtest.c index d348d0d..2b22452 100644 --- a/tools/host-tests/cnfgtest.c +++ b/tools/host-tests/cnfgtest.c @@ -59,8 +59,12 @@ static void reader(void) printf("[1] logs.cnfg: the reader\n"); struct sp1_logs_cfg c, d; sp1_logs_defaults(&d); - CHECK(d.enabled && d.cats == SP1_LOG_ALL, "the shipped defaults are on/all (got %d/0x%02x)", - d.enabled, d.cats); + CHECK((d.cats & ~SP1_LOG_ALL) == 0u, "the shipped defaults: unknown bits 0x%02x", d.cats); + /* The checks below hold whatever config/logs.cnfg ships with: a line that must be + * IGNORED sets the opposite of its default, so it would show if it were applied. */ + const char *not_midi = (d.cats & SP1_LOG_MIDI) ? "off" : "on"; + const char *not_usb = (d.cats & SP1_LOG_USB) ? "off" : "on"; + char f[96]; /* The template the firmware writes when the file is missing reads back as exactly the built-in defaults, with * no problem -- whatever chunk size the drive hands over. */ @@ -78,13 +82,15 @@ static void reader(void) CHECK(read_logs("\xEF\xBB\xBF; Format: ini\r\n[LOGS]\r\nEnabled = OFF ; quiet\r\n" "midi=off\r\nusb = on # yes\r\nstorage = off", 0u, &c) == 0, "overrides: %d problems (line %d: %s)", problems_seen, last_line, last_what); - CHECK(!c.enabled && c.cats == (SP1_LOG_ALL & ~(SP1_LOG_MIDI | SP1_LOG_STORAGE)), + CHECK(!c.enabled && c.cats == ((d.cats & (SP1_LOG_PERFORMANCE | SP1_LOG_CONTROLS)) | + SP1_LOG_USB), "overrides: got %d/0x%02x", c.enabled, c.cats); /* A bad value keeps its default; the rest of the file still applies. */ CHECK(read_logs("[logs]\nenabled = maybe\nmidi = off\n", 0u, &c) == 1 && last_line == 2, "bad value: %d problems, line %d", problems_seen, last_line); - CHECK(c.enabled && !(c.cats & SP1_LOG_MIDI), "bad value: got %d/0x%02x", c.enabled, c.cats); + CHECK(c.enabled == d.enabled && !(c.cats & SP1_LOG_MIDI), "bad value: got %d/0x%02x", + c.enabled, c.cats); CHECK(strcmp(last_what, "enabled = maybe") == 0, "bad value named as \"%s\"", last_what); /* The same key twice: the FIRST is used (Adara's rule, #52). */ @@ -92,7 +98,8 @@ static void reader(void) "twice: %d problems, line %d", problems_seen, last_line); CHECK(!(c.cats & SP1_LOG_MIDI), "twice: the first did not win (0x%02x)", c.cats); /* ...also when the first one was unreadable: it still counts as set. */ - CHECK(read_logs("[logs]\nusb = ?\nusb = off\n", 0u, &c) == 2 && (c.cats & SP1_LOG_USB), + snprintf(f, sizeof(f), "[logs]\nusb = ?\nusb = %s\n", not_usb); + CHECK(read_logs(f, 0u, &c) == 2 && (c.cats & SP1_LOG_USB) == (d.cats & SP1_LOG_USB), "twice, first bad: %d problems, 0x%02x", problems_seen, c.cats); /* Unknown key, unknown section (reported once, its keys ignored), outside any section, @@ -102,11 +109,13 @@ static void reader(void) CHECK(read_logs("[midi]\nchannel = 3\nclock = off\n[logs]\nmidi = off\n", 0u, &c) == 1 && last_line == 2 && !(c.cats & SP1_LOG_MIDI), "unknown section: %d problems, line %d, 0x%02x", problems_seen, last_line, c.cats); - CHECK(read_logs("midi = off\n[logs]\n", 0u, &c) == 1 && (c.cats & SP1_LOG_MIDI), + snprintf(f, sizeof(f), "midi = %s\n[logs]\n", not_midi); + CHECK(read_logs(f, 0u, &c) == 1 && (c.cats & SP1_LOG_MIDI) == (d.cats & SP1_LOG_MIDI), "outside a section: %d problems, 0x%02x", problems_seen, c.cats); CHECK(read_logs("[logs]\njust words\n", 0u, &c) == 1 && last_line == 2, "no '=': %d problems, line %d", problems_seen, last_line); - CHECK(read_logs("[logs\nmidi = off\n", 0u, &c) == 2 && (c.cats & SP1_LOG_MIDI), + snprintf(f, sizeof(f), "[logs\nmidi = %s\n", not_midi); + CHECK(read_logs(f, 0u, &c) == 2 && (c.cats & SP1_LOG_MIDI) == (d.cats & SP1_LOG_MIDI), "no ']': %d problems, 0x%02x", problems_seen, c.cats); /* A line over the limit is one problem, and the line after it is read normally -- @@ -120,7 +129,7 @@ static void reader(void) "long line: %d problems, line %d, 0x%02x", problems_seen, last_line, c.cats); /* An empty file and a file of comments: the defaults, no problem. */ - CHECK(read_logs("", 0u, &c) == 0 && c.enabled && c.cats == d.cats, "empty file"); + CHECK(read_logs("", 0u, &c) == 0 && c.enabled == d.enabled && c.cats == d.cats, "empty file"); CHECK(read_logs("; nothing\n# here\n\n", 0u, &c) == 0 && c.cats == d.cats, "comments"); char b[48]; @@ -194,6 +203,18 @@ static void drain(size_t max) } } +/* ...only what the last ON still owes its own file (sp1_logring_take_before_standby). */ +static void drain_old(size_t max) +{ + char out[256]; + size_t n; + while ((n = sp1_logring_take_before_standby(&R, data, out, max, &lost)) > 0u) { + memcpy(got + got_n, out, n); + got_n += n; + got[got_n] = '\0'; + } +} + static void reset_ring(void) { sp1_logring_init(&R, RSZ); @@ -304,6 +325,83 @@ static void ring(void) CHECK(strcmp(got, "CNFG logging on\nON2 played\n") == 0 && lost == 0u, "logging off then on: \"%s\" lost %u", got, lost); + /* Every ON a new file (Adara, 2026-10-16): what the last ON printed after its last flush + * goes to ITS file first, then the new file gets this ON only -- STANDBY in neither. */ + reset_ring(); + puts_r("ON1 played\n"); + drain(32u); /* ON1's flushes */ + puts_r("LOG closed\n"); /* after the last one */ + sp1_logring_pause(&R); + puts_r("[STANDBY] a\n"); + sp1_logring_resume(&R); + puts_r("ON2\n"); + got_n = 0u; + got[0] = '\0'; + drain_old(32u); + CHECK(strcmp(got, "LOG closed\n") == 0, "catch-up: the old file gets \"%s\"", got); + drain_old(32u); + CHECK(strcmp(got, "LOG closed\n") == 0, "catch-up: stops at STANDBY: \"%s\"", got); + got_n = 0u; + got[0] = '\0'; + drain(32u); + CHECK(strcmp(got, "ON2\n") == 0 && lost == 0u, "catch-up: the new file gets \"%s\" lost %u", + got, lost); + + /* A STANDBY that printed nothing (no gap to jump): the boundary still holds. */ + reset_ring(); + puts_r("tail\n"); + sp1_logring_pause(&R); + sp1_logring_resume(&R); + puts_r("new\n"); + drain_old(32u); + CHECK(strcmp(got, "tail\n") == 0, "empty STANDBY, old: \"%s\"", got); + got_n = 0u; + got[0] = '\0'; + drain(32u); + CHECK(strcmp(got, "new\n") == 0, "empty STANDBY, new: \"%s\"", got); + + /* Nothing owed (the last flush took everything): the old file gets nothing. */ + reset_ring(); + puts_r("all flushed\n"); + drain(32u); + sp1_logring_pause(&R); + puts_r("[STANDBY]\n"); + sp1_logring_resume(&R); + puts_r("new\n"); + got_n = 0u; + got[0] = '\0'; + drain_old(32u); + CHECK(got_n == 0u, "nothing owed: \"%s\"", got); + drain(32u); + CHECK(strcmp(got, "new\n") == 0, "nothing owed, new: \"%s\"", got); + + /* A line STANDBY cut (the backstop mid-print) ends the old file as it is; still in + * STANDBY, nothing is taken. */ + reset_ring(); + puts_r("PWR 29 s\nhal"); + sp1_logring_pause(&R); + drain_old(32u); + CHECK(strcmp(got, "PWR 29 s\nhal") == 0, "cut line while paused: \"%s\"", got); + puts_r("[STANDBY]\n"); + sp1_logring_resume(&R); + puts_r("new\n"); + drain_old(32u); + CHECK(strcmp(got, "PWR 29 s\nhal") == 0, "cut line: nothing more: \"%s\"", got); + + /* The old lines partly overwritten: counted, and the rest still goes to the old file. */ + reset_ring(); + for (int i = 0; i < 12; i++) { + char l[16]; + snprintf(l, sizeof(l), "old %02d\n", i); /* 7 bytes each: 84 > 64 */ + puts_r(l); + } + sp1_logring_pause(&R); + sp1_logring_resume(&R); + drain_old(32u); + CHECK(lost > 0u && got_n > 0u && strncmp(got, "old ", 4) == 0 && + strcmp(got + got_n - 7u, "old 11\n") == 0 && lost + got_n == 84u, + "old overrun: lost %u, got \"%s\"", lost, got); + /* After a reset: a cursor ahead of the writer is pulled back; a bad header fails. */ reset_ring(); puts_r("kept\n"); diff --git a/tools/host-tests/hostbuild.sh b/tools/host-tests/hostbuild.sh index 3c86bdc..53e413c 100644 --- a/tools/host-tests/hostbuild.sh +++ b/tools/host-tests/hostbuild.sh @@ -39,10 +39,18 @@ pickup_ini() { grep -Eq "^pickup = $1\$" "$2" || { echo "hostbuild: no pickup line in config/midi.cnfg" >&2; exit 1; } } pickup_ini sum "$GEN/midi-sum.ini" -# ...and its legato forced to `off`, Yarns' default, whatever the shipped script is set to for -# a hardware test: miditest.cc checks legato off; miditest_alt.cc checks legato on. -sed -i -E 's/^legato[[:space:]]*=.*/legato = off/' "$GEN/midi-sum.ini" -grep -Eq '^legato = off$' "$GEN/midi-sum.ini" || { echo "hostbuild: no legato line in config/midi.cnfg" >&2; exit 1; } +# ...and four more lines forced, whatever the shipped script says: miditest.cc checks exact +# pitch steps (legato off, portamento 0), the channel filter (channel 1) and the velocity maths +# (velocity = level). miditest_alt.cc checks legato on, a glide, omni and the bindings, and +# miditest_pickup.cc the shipped settings themselves (legato auto, portamento, omni, velocity). +force_line() { # $1 = key, $2 = value + sed -i -E "s/^[[:space:]]*$1[[:space:]]*=.*/$1 = $2/" "$GEN/midi-sum.ini" + grep -Eq "^$1 = $2\$" "$GEN/midi-sum.ini" || { echo "hostbuild: no $1 line in config/midi.cnfg" >&2; exit 1; } +} +force_line legato off +force_line portamento 0 +force_line channel 1 +force_line velocity level python3 "$ROOT/tools/gen_midi.py" "$GEN/midi-sum.ini" "$GEN/sp1_midi_gen.h" >/dev/null INC="-I$OVR -I$SRC/plaits_ovr -I$SRC/plaits_shim -I$ER -I$SRC -I$GEN" diff --git a/tools/host-tests/miditest.cc b/tools/host-tests/miditest.cc index 71280e1..cf9de23 100644 --- a/tools/host-tests/miditest.cc +++ b/tools/host-tests/miditest.cc @@ -1,5 +1,7 @@ // wakes-sp1 M5a: host checks of MIDI in, against the shipped script (config/midi.cnfg) with -// its pickup set to SUM (hostbuild.sh): this suite checks the offset maths. +// its pickup set to SUM (hostbuild.sh): this suite checks the offset maths. hostbuild.sh also +// sets legato off, portamento 0, channel 1 and velocity = level, whatever the shipped script +// says, for the exact pitch steps, the channel filter and the velocity maths below. // Drives the real sp1_midi core directly, then through sp1_synth / both UIs. // miditest_alt.cc covers the settings this script leaves at their defaults; // miditest_pickup.cc the shipped script under pickup shared and takeover. @@ -98,7 +100,7 @@ int main() { block(); CHECK(!any_trig(), "TRIG struck twice for one note"); - // ---- §3 Yarns mono, legato off (the script's default): last-note priority, every new + // ---- §3 Yarns mono, legato off (as hostbuild.sh sets it): last-note priority, every new // note strikes, and so does falling back to a key still held (C4) ---- printf("§3 last-note priority, legato off\n"); on(67); @@ -179,10 +181,10 @@ int main() { CHECK(last().gate == 0.0f, "pedal up: the held note should end"); reset(); - // ---- §4b velocity -> LEVEL, the shipped script's [bind] ---- + // ---- §4b velocity -> LEVEL (hostbuild.sh sets it; the shipped script has none) ---- printf("§4b velocity opens LEVEL\n"); static_assert(SP1_MIDI_VELOCITY_DEST == SP1_MIDI_D_LEVEL, - "the shipped script: velocity = level"); + "hostbuild.sh builds this suite with velocity = level"); on(60, 64); block(); CHECK(fabsf(last().gate - 64.0f / 127.0f) < 1e-4f, "velocity 64 opens LEVEL to 64/127, %.3f", diff --git a/tools/host-tests/miditest_pickup.cc b/tools/host-tests/miditest_pickup.cc index fe31234..350aced 100644 --- a/tools/host-tests/miditest_pickup.cc +++ b/tools/host-tests/miditest_pickup.cc @@ -1,7 +1,7 @@ // wakes-sp1 M5a round 4: host checks of the MIDI script's `pickup` = shared and takeover // (Adara), against the shipped script with only that line changed. hostbuild.sh builds this // file twice: miditest_pickup_shared and miditest_pickup_takeover. (Pickup sum is the offset -// maths, miditest.cc.) +// maths, miditest.cc.) Both end with §S, the shipped script's other defaults as they are. // // Drives the real MIDI core, both UIs and their pickup the way main.c's control loop does: // audio block, UI tick, sp1_midi_main_tick, sp1_pui_midi / sp1_mui_midi, then the params. @@ -80,6 +80,109 @@ static void start() { run(60); } +// ---- the shipped defaults (Adara, 2026-10-16): omni, legato auto, portamento t9, no velocity. +// miditest.cc builds with channel 1, legato off, portamento 0 and velocity = level for its own +// maths; these are the settings a Wakes ships with, checked as they are. Change the defaults in +// config/midi.cnfg and the static_assert below says this section needs the same change. +static const uint32_t kSBlocks = 240u / SP1_SYNTH_BLOCK; // Plaits blocks per 5 ms +static sp1_midi_frame sf[kSBlocks]; + +static void note(uint8_t status, uint8_t n, uint8_t v) { + const uint8_t m[3] = { status, n, v }; + sp1_midi_push(m, 3, 0); +} +// One audio block of the MIDI core alone, every Plaits block's frame kept. +static void sblock(float lpg = 1.0f) { + const bool work = sp1_midi_audio_begin(0, kSBlocks, kCentre, moff); + for (uint32_t j = 0; j < kSBlocks; ++j) { + sf[j] = sp1_midi_frame{ false, false, 0.0f, 0.0f }; + if (work) { + sp1_midi_audio_block(j, &sf[j]); + sp1_midi_audio_lpg(lpg, false); + } + } +} +static bool strikes() { + for (uint32_t j = 0; j < kSBlocks; ++j) { if (sf[j].trig) return true; } + return false; +} +static const sp1_midi_frame& slast() { return sf[kSBlocks - 1]; } + +static void shipped() { + static_assert(SP1_MIDI_CHANNEL == SP1_MIDI_OMNI && SP1_MIDI_LEGATO == 1 && + SP1_MIDI_PORTAMENTO == 9 && SP1_MIDI_VELOCITY_DEST == -1 && + SP1_MIDI_AFTERTOUCH_DEST == -1, + "config/midi.cnfg's defaults changed: update this section (and hostbuild.sh)"); + printf("§S the shipped defaults: omni, legato auto, portamento t9, velocity none\n"); + sp1_midi_port(false); // whatever the pickup checks left: neutral + sp1_midi_port(true); + for (int i = 0; i < 40; ++i) sblock(0.0f); + + // Omni, and velocity binds nothing: a soft note on channel 11 opens LEVEL fully. + note(0x9A, 64, 20); + sblock(); + CHECK(sf[0].trig, "omni: a note on channel 11 must strike"); + CHECK(slast().gate == 1.0f, "velocity = none: velocity 20 must open LEVEL fully, %.3f", + slast().gate); + CHECK(fabsf(slast().note - 4.0f) < 1e-4f, "the first note jumps (nothing to glide from): " + "%.3f", slast().note); + + // Legato auto, an overlapping note: no strike, and a t9 glide that lands on the note at + // Yarns' time, t(18) = (tmin^.25 + (tmax^.25 - tmin^.25) * 18/127)^4 with 0.75 ms / 6 s. + const float a = powf(3.0f / 4000.0f, 0.25f), b = powf(6.0f, 0.25f); + const float r = a + (b - a) * 18.0f / 127.0f; + const float t9_ms = r * r * r * r * 1000.0f; + const float block_ms = static_cast(SP1_SYNTH_BLOCK) / 48.0f; + note(0x90, 67, 127); + int landed = -1; + bool struck = false; + bool between = false; + for (int k = 0; k < 20 && landed < 0; ++k) { + sblock(); + struck = struck || strikes(); + for (uint32_t j = 0; j < kSBlocks && landed < 0; ++j) { + between = between || (sf[j].note > 4.01f && sf[j].note < 6.99f); + if (fabsf(sf[j].note - 7.0f) < 1e-4f) { + landed = k * static_cast(kSBlocks) + static_cast(j); + } + } + } + CHECK(!struck, "legato auto: an overlapping note must not strike"); + CHECK(between, "portamento t9: the pitch must pass between E4 and G4, not jump"); + const float landed_ms = static_cast(landed + 1) * block_ms; + CHECK(landed >= 0 && fabsf(landed_ms - t9_ms) <= 2.0f * block_ms, + "t9 lands on G4 after %.1f ms (Yarns: %.1f ms)", landed_ms, t9_ms); + + // Back to the key still held: a glide again, still no strike. + note(0x80, 67, 0); + sblock(); + CHECK(!strikes(), "legato auto: falling back to a held key must not strike"); + CHECK(slast().note > 4.01f, "falling back glides, not jumps: %.3f", slast().note); + for (int i = 0; i < 20; ++i) sblock(); + CHECK(fabsf(slast().note - 4.0f) < 1e-4f, "...and lands on E4: %.3f", slast().note); + + // Every key up, then a detached note: it strikes and jumps (no glide in auto). + note(0x80, 64, 0); + for (int i = 0; i < 4; ++i) sblock(0.0f); + note(0x90, 60, 90); + sblock(); + CHECK(sf[0].trig, "legato auto: a detached note strikes"); + CHECK(fabsf(sf[0].note) < 1e-4f, "legato auto: a detached note jumps to C4, %.3f", sf[0].note); + + // The same pitch again before its note-off (a sequencer's long step): tied, one note. + note(0x90, 60, 90); + sblock(); + CHECK(!strikes(), "legato auto: the same pitch again before its note-off is tied"); + note(0x80, 60, 0); + sblock(); + CHECK(slast().gate > 0.0f, "the first note-off must not end the tied note"); + note(0x80, 60, 0); + sblock(); + CHECK(slast().gate == 0.0f, "the last note-off ends it"); + sp1_midi_port(false); + for (int i = 0; i < 4; ++i) sblock(0.0f); +} + int main() { #if SP1_MIDI_PICKUP == SP1_MIDI_PICKUP_SHARED printf("pickup = shared\n"); @@ -242,6 +345,7 @@ int main() { #else #error "miditest_pickup.cc is for pickup = shared or takeover (hostbuild.sh)" #endif + shipped(); printf("\n%s (%d failure%s)\n", fails ? "FAILED" : "all checks passed", fails, fails == 1 ? "" : "s"); From f3fff7beac524d14c3bf094a82a10c57020aadaf Mon Sep 17 00:00:00 2001 From: Worldwave Date: Fri, 16 Oct 2026 00:51:39 -0400 Subject: [PATCH 06/10] Manual for v0.8.2 (Adara) Co-Authored-By: Claude Opus 5.5 --- docs/Wakes - Manual.pdf | Bin 409687 -> 428224 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/Wakes - Manual.pdf b/docs/Wakes - Manual.pdf index f7f2ae49f194e1fe06f3328ba652b02286036754..1331005a392104ce106c6a55a1e55e880babd14c 100644 GIT binary patch delta 234298 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̯X-~6O5}j{ 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

5Kw)jy>AVP_J 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 delta 217828 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
WUul=fE0z#+>? za+ulZiZT4S4j=<`FLmnfZ(jyP*M57U=%8RY8BIVSXwj5Y)!^M3U%xT#J8G0e27!HR4imV z?RH?IB_jY>AiItK2GG@4G34on8<65G4XUHYhUU|$3E;NM2|2W7JzdQ^x0h;(TJS!+ z4+-g90#PYj>9s8TL<_hP@t2ks721BaR9rDx-4hvC6`JO&!4>VqlOi%LpqU^a+a_{omu67LalSfIAKJo zlwkWhguP|xTToD|kYW(cWRy-IaLs4D6O7WgloZ%fQP4|ciU8&#T|h-G1;}z=#1dtM zfGm4uWWiD?tG6u%9MwiT=2XN@el+OJ~qw zm;vGBFJbG!$7plzu3vb3t}LusOMjLm0;gfs0M64R z10f*G1zp!MDba*xL*yoNT1KW(i|?i6;ZiYFBiw8h3+oJ3S|uZD=AKx%u!RhsG*Z3< z@C~6L|A86o-ys$ z7b#=`eWg$*6$e(WrCYcC0=sO&I&08!%5r!~QvT*O=LC9VCB(I@6`oRvUEpyP1guFg znnX-_RUoMoE76?$A4&_-O8iR>2y;=vOqT1kXo_C6@(56ha%$;@;E>%mP+Zjl850>7 zSuX}GwC5*yED#9PJqE(hep(JN72{}Z!*maZs?-C^t*i?*>`Wi5( zwz?-YT_N-=%di7dahJpv>CCGoE09Fos`FHbp|V2uZ^oWCDfGK=N)xzoQF+k>`voD> z95;wxi*BB0uhLxvXN$1@0(&SBkcBLyW)U57e0GGX22__%eMfj+L^mPecQlodzR3i| z?)vpvWl&BkW1P#T+jtmFs#q{%!i7zjitaIo(8u`f5#N{!UKq)oQ27;990c%`h@xc8 zV(!b5kc#o--(=)b`22HHgccI27wSgx0JRWxE++JFWM=WpITbVk^n&cyLs4`tLm#d}cr zAC-y>W6U8Fcu2N0BteBNGiTBw3`Qc@0*Hm;e!rpHB4}YKIu zZz0S?E@eH3$^EI{)=NM&=?;($YU~W`P%ypTz=e%?G~31lZbStScS$&PQlOpNWcrLP zX+}(I)vCpfbJT`m(@h%MHFOtJaX}qv?-I!b9tH)k&4S-)9m8brJK!|G(R#pgJx_u) zZJ=|lWX3(}3`Jv0gxP9c4F?robA3?KEc7Xr3G!bEj8*lG;}MFj5sR{=CQkBFrj3D* zH^es<$=QNHoZMESYIU9n;~?2bzXHJrP`CvwEms}G(F9yB+yJ-2jR93=g4|>QDbF}3 z&(4K;*p?+R12!(v&^l#?XFFbP62oKS1Uj2$skuDngBOpVRV_skvJkZe89)&pnV>5# zIOz*O5t@)B@}4lhk#E9PHA@>@LrtIG@9-04x^5N72SIrkGzOw%Ez4$S$P+^jkN!fC zD#2o+klB#bA~yT9Q#ovR?l=t5rQf4rl)pRW8~!t=D@R38QgLxiO$tWS?rsp|Q3A`w z%bTu!0HqTKOB7XqzrBbhl){$M6$59%SYya5zv1jTHfYvE5&~`UlWdP=dYN-jiHb%Y zyEY%#Uqjk5Lj)&3o1`vt$mmx0H6dwmKyrj|S?cf4rjv8gF5(w@_W>Do8&blIGtWGyp z{HQRe_ZzZPpQ7!-8I1ts&uUBu%HZXmh-Gf6`F_u-oP@QIH5vG^gF4V9=%f^sLv7~TG zp1<6U8z=q{+@WoY05#dRc7w11jcI8x9JLvf#OX?dq;r0z{3Xq=PHjU2D8D1iDp&yA zs(q*(u7A~Gt}TM=bC~+Z%@#Ig(tx6Fl)|}kuYW;;$2+W8{hRrei{Z6(vmaNkrf0q~ z&8KUV%ys>0f8s0)P>U1urJAAkopvyH_hmQXIZ)4{0qRn8NmPGCr(7q)is&Psv)Lmf zS!oRTao+dwME-e0{uyB2`*!sV{DcPz{6kYzMOY0IU(EkQQy<^EU*4b9``*!Q_69N; z{yYQs)ptJQ%Re8_c9R|R>(R)J`;y6AJ#TKZfMkh(U3Nap%Rg^K4gRp-#b3OPsEwu> zbW7Xvs$@+5LsKLaL9vVrPizaggN-kW*Rv;}i=G{hF*DSQG9rfScF%;~5THB35HX9oAJyD#xTniaBoQKQ`s(lbu+2A2cqq4Ch@06k8IH5Y{{VM-H;3Dj+t1Thehh~gJ$QNH z=%=l4p9W)}!Z29iF()Y^Gw_vMTus$EpzC|l{%Eb#OpBy*fQeBioB0oKp!ut&BnqeZ zx>|<2N?&F@lk|JM`X0HtHMFGQkVC*`3Y=&+3;ks3;BRX|ihC|~lQd3rzUOYINn85r z&xg@+W7Np#&j?ef0L=PvLOE{Ief#Tthl2hhuIa%Q9M6Aj%HC}}2$cmR6}_TPA@ECoPJAcpH~Ld&i$&Hjc)_|(L8~l?K>P76dZTPK39Y+ZSQQAk zEMe}Q#RIP4?2g5Ky-i!%%!Ie%rHVMVZ19=yAYOcUSTC;*X(dY=V(_3LH^b{rm!T=_lUE#3krXpYFn>JIj^L!`^r%_= zQhwI+_3=#Uv8WPdn$u0M%1gaAuC0DagE0Ogn}j~~RzV&uxr<^I^tUtj+(P&o26F@< z!oPgn?{;t8ER#M$q!J}*a4#S}H4%9*>|ibRv^#CLF`?7)D=?r@?($lfmI6w9p@b=j z@cyce3G%de>`F6r+DkHF{gQgjuJ za#3K}-UFO%+}IXpSi9JE8H`Gzr7-(mJ@sVx-6&IX!kL-7V(stv5H9ZoA!J=HQ*%hx z*0PO8^Ts-lC@|YJ(^=rz{uEQ~lfm*gNARb+>r1L%>p6@Q*xBS(%t|gVvk%nqWO5Pk z<1+MTy&UlVYc}HKaa#?7p3riB>V_xwAZzAjxLt`Jbj`kH}GJgJ!vU26+wTwC0h} zqS7c?SQU|u6fbk*yk0;Rb_Y?rF+A%GmH@|3}FyZLa}GIrQ40#u=1HvVFcO3{tZeqaYB zB{_mL(?y!Jd4}@lL!r(19E5)1TV(rS;miV=0ALeXxY^|ye_=P*^)E_*L&K;_B^pQu z)~$dh8;&}ZDZv>@fl=OmZ!<7r9SzZb?iEd!2r#Hf_37OIWTk$B))Mm1qjaZPuhQw`*ie z32@mM=fyC4_=IRC%$+VwM~hkQNR8@bt3~9W+s1)rY@V8=+uxkWTdC=)e+@xeWFfvm zADCSmbs57n5p@X{cs0r72oRjG{=Sl@5Xx(FB~L-~kQ0=UwB|EZzOb0O>@#qr3$%Dd zGs5Xc{0Tjo=y)?Nv}#MUV;^Y<@TbNKUMAe&J$k8YHQ_yGhU+88(2a-*&^U$9Z5^E7 z3aTbwb&lv&JyAnv(bKIdIPl9=U|^L@i3dP?QJo_3;6;J1YFe@t_B5=rBz42+TNoL- zuzg^K_yOfa7>trPq;_h%Vm&qlz+|~L*wX}@oz$0W* zsks|1@N*n_L+ZXKsHbeuONV%IMP|~f?d7i5rO9P5NUQ=`1m%La9iZ_n5)nJmCZzgH=uKwHYt46Rn1_@Khp}olRven(G?{t7=qm8dxkldl0bClVZ9W?8~|e zdZmpD@orFPl$-!aI`|e%2vWT{#btZuVw#P{R8se#ZYkj)I?thgrq!z0uc>&TS+$t2 z9nfPk33ND-`3&php}(7GfDO3Kwo2l<3b_`-nGNx!V?`7u`6f%M|{k+p}T5O$XtD3HYp7V>;oca-BCB0ZrrKJ3&Xp$**v@UUfGCn zo4mFv3cu3l+M(vqcYJTCiXY(eAQGsy8m2C7S(qFb4Oe;+X1c=)pbQEGSphElIj?3Y zEgw@C_JQCD_<^>%MZiyE1AolEi^{>=c!M#PMz19Nvi!6*k$ zi%3SK`3_x>%;*4s4o*7if!@}zKd6SoyzHDY|A(=!j;iYU-sS?*-O>%xmrHjy2!eEX zhf;!YK@gBqB#uafN+TW83ew#nEunyt0;0Z0!0%7_=vuG;+{K*Pd-i^weP-tD-TJtjqiPS|GhX+!xnK;H?=e`(<5hNu>ikhIF!9q&N%hEVQKb_d0sQTvh?OhOa} zoTmPTC&FR*_>sH4TR1OSuM06`M%@$R?+C)x@t(9#l?d9jv-ImskdP8D-GZ#tE3UTI zPy{JMItk&e-h(BdO8LB}oSh`L5mbR%yAeHL|uhc|!g;XIj0eQG5Vga2eVj9c zNtE9psRg(5a+iAe2Irw|EMkwb6==t&P-Ke07&Px-m`bORL9E_uzVvhePp`Wh5^U(u zbKfiN&vs=?MOhL__S+!FjCw4!fU`chj+g8C;Lef4qkM+oG$rRHiqv6K6Ek;3b35wP z_nO4`@Sap!rFnL21owIJ`aY%4?pm32J9Vs?CyE-l;yzzWF%X$5E8I_{2JN))5jH;& z_2dZ-R$Lj(ie=pW;I&k6MauUzPyBw<&{m)#PcWtk&t9-xr=5bR6*t~9vq%So2#iYU zNSci@Efq&5Hp?qPw(*7xB3JIRdB>@@e054u$%OYQq4=wcwr}FN{=k3@;leex-%Z;S}JerX?Be?Q4c)UPxA4m0`UL{LAs^I~#fL2Cc!Atcy^3WUR^s4xLBSmon6!)Dik&Qd>~L4+BUEgGsFo~+aN2#W zOfGyYV%?jLtkuYxi5b2XU@wl#ScS&OarI zl9#?gDddWrMvUeffl}PrV;2tfBtxl*EWI8GN4)7^qL7xpVEGa6`5nf5FSfAC(0)3$ z&3M{@LVe!>Qcovj<06U*hVCHUv8YvVHzCC6}KgbrSo)98l}q>6f^L2_;zGv4x5vK?FHAp*;!IEiu14CIX95*7AN6ec7*B0Se&m0`wv9Gnj$hjNn0s!8c-V#GS5sAA_7wk? z{QOnqQ_t0qyWUG;QI6CJsrz`^K3ZDoQ76o72oiV) z(iaQ$=}cwu80jWt=F3{o3+iMJbSL^?5cFb=SWQJ*Q?#~owd-aIwk#ukhI!~+QNP0k z|E$fz%Yhzws`iRNlYfwgu*0F=IfaivEdTlu#C;=iBhOxijzX_RS>B*3 zMq4#D4bHe$!-CemFY=D1*nA}WE0>%GBfN{PN=5Z9($^0nN)AHT6+DKA`B`6jyCp;r zk38;_kA1<%kdMtbiwj*r`9`HH&ygZz@#DtepkgW648pT4U7e`J77B8{8vOuEwn=}F z3{ycVZ6SuQ$}5MVZN`QgFvK*L8mA<1r~`m*+0$7q8A#(<{RzvjK3# zpsThn3a)QSIDs!gUn`~O5g7S>SzWf;3M{xjz(1$GVBIGC-jMSRadV`K3Auxo)*>Ty z)}tBYwFCtAk;6XdKpjnjVNS?ix`T zC9)ulZIP%33%&N@dwOLZb`8NOfsi;e+{qf^X8tV8-3ko_$1r?UOU)zdIrb^JN7l?W zKAi`(1AJmxGxk%OPt%4u+j>izl%Aq}$QlrBcT(8I=!rBews#!>eDEvthzs^1=J5 z%^MwC*P{imsNhL~iqEq*A7*fw=E(QCAXgB_if2+r?#r>h9T{P&eEyaWIl`q2?*SaD zEB>m;C{kEPQp*3`joyw!DIGi(LF6~6h|l#nf~OKwtTexO;}6}}(#pUJ(A^%(;e6rs zblfj>pDgAB(szBKW!$zc{D}xEF(s!2Ze6CdZ6*C^Ln$>!OWjEp=ENsvzLth*Diw~_ z*pT7s50;*}sx1;jmAFsnmhBzVIu(C9ADUIBVmh-)mw7gNrbA+6%Nk`8+*GsJ6GhNjt@ z7gLa!dl}ju$Y&#FV(RsYPxwWgaKK&7bp@OG#y5OJlyI~%4ElJ+c^{k=CX zXC`784AU1EeOArb9}uxKI!{sUmKnD!{Vcmgr&Fp0|LUWGBHQ#k;`%M-$aQdcgJ^rD zvBppozv%bV%zz^xjas-?-4`$4MM+?jG^QOdW&2p}h+&f^X1AK!&Y)cFy7)Zt=9 zKT$9zI>0FmlHL~@SkK$d3=|S1b?Vf~SxxLW)D5lH6RRB8j-ecPCpyL8K~r)Tk{)E) zr{U&%6{Ry)6|mGAwT;oP;}QhF+3C$`Yzx*K$ud zc`^F|m2=?W+TaN#Vq{azRR3V<>sJ(lqzP&F#MJ%o)#>KNxQ$o2Jaja&4EEjE`sik8 zUleT4*}ycYMk6Jp_f^u_4+&MV5VJe=QIIaLBj;TQ3)YZt=9R=VRMJLq@DD>b{VR_W zL-4iYLsdphoent1-(BVE#Xd$42stP=h|5@xWO?Id;3M?8jfq`@@EuvR6)wBZc>NCg z&4<=1Mit)5Wf@p$H*qGqohcYf?UmM9WM9#Lc-DE{q$OQ9J3KH@$gaF+l~hnM0eY?B zr8DlQuP4*wnVrrJBDIVh+pF;0fZ$9>my6WC1vT#Gt?;b<8CvPGIlBI^mo)d(sjDdG zGfJ!wD!K8z`DpkzUOC_0*jJUzbdrp;mZbL^HgMG{Ug&y7zwt0scs3$^Hj~LelU4k7 zPD3{9V%e9QA9#12#_QS?i-upVPN6;bG^Z84e`A;&N*S?0jU%yxKqaIFr`ojW=Fw|H z{U+29t*O%fvRk@hpjR6v37+SI*> zV#dOF!3MfLJWR2yd0HI;+gqf0&w2`(d#j4vs>mnNI^4T9x96vXx(Y+gKE=J5TPBWv zFEaie3+~Or9v~OmFqQFs8Xh${*mH#}d}^aP|O8JDXnFf{-6*CxJB49^78I?>fVx^MllrZKk7&4|SP!cq#N(MSBD8 z36F+^PqZ3~`<<@%QB%Bo6sp8IaCf#X%q+BCP0aUbeK91N=93~Goa5T6zeE#T2up^9 za9ik)_0?P-Sn@iDByX0D{%ohLp-VVwhFAj1(Y}Z&Rrdk@QQh&z(Ue-C?hCtQRvaFk zO@ULjzELDR%q6A?{(_p4^#WDkMT9(eqMLpHt&&b zI#*Urn$~R6zkD--I$##b+()csmsDJvDu#F4|LQlx_jm`m_xF#FqXfh4fO*O$zq{W` zLZ4@Jq|9fkPs%%+NI50eq-5Y(i%G!g2t?|{n#JJkSQe1O57zKnUvIztrQP<8_C-zi z(=m51@4J41P`vOpH|_!4fx`mLNlm(t=jFw0`xuQ&pR2wLi;BUsZmQf=7%7bEdD$cr zfP1jEN4m@{t3DktEZ{cqr9j!(EdHL(o%);VgN)&Vl8wU6r+piXQ>u$^xtGTPfP1d8 zXM$zZi)8@kPN6rv^>C&OvpP>K(03?O)4f42Z8%KCV{M6lXlqP_%2f1rqSh4&Gn*@@Pn`D}UO1IxJ z9lhbM0Hs(G^JyO`_jPLV!0%f*1Gcw@u%(GH16o~HvfbJW;o%jtGu8q+)S~hqW5bOe z-t~XFKkCNPO}MaUtE+o(v{O}~>T|HVQe-kzM48d#xB@GCK4PZ9W%%W^Dye_j--h+I z%8K~imyw^H_AtL%n zEdA@ncU&sF?|R??MK06kE`)+y2BKx_SC3Bh?A)FWBqYbYGw6MN@S`+2_~F=OT5?gO z?9;p6x2@pNiZcHcG7n?lsip#1E8tGO!=bCMXoYL|3kiQ0TMgw~pDZcbwLWS3j2j#J z&wcSP4112JSMBu4toPK`t)moBN*kKhW7#KPtM+#rr*uz;djQ_ecWwJueRgIkgmI6a z{iyKSN!9JZmr|*5+*^aq+_f1ngsy*iGQ#ij-JQliUCg-$GNp-;`7=fiWPO2 z0ohBQL@~+;51Cx*{h_JPZ?0OYeQ+vV3#iod5|HC9MQl+=txors@DI2f*on@{!X1?6 z_bLMQ{U!Mua)N#gXVXy2NHW z5A5W~lMcFR(u@V_3>ioBn+pJzElcY7#y$ZhiQbfCV}9dY`?8wXvwdT^f)ltr6?aab z?Rf7a%zevAM%;9%-_!p-Eg!^TNx65y?DkJo;VV}*8!}F ze3g{MKMd^|$Y8C=l_gE?Fp}h@{haj8c23vmXmw3-9t{(h$1bf)PEsxN+8c31Lz|@` zQXH2ox?safi zt=xWVt&s?qQeaGo3PtJB;7Smwt0Q?g{E>S;wUWJRc(49-*bs6)me5zbD8CO0U(=2> zDUhs=ww7v5)}z1O%)trIBA(z|h^d`r$I=(XViD3QZ*w6!q9{E+EPOc^=n-jq)EAG6 zllI|wBgE`RE{*ur9J=eVTW4m;)Zrj{>l`^ zR_UP1o1qjq_xEa(=mOK;u{XK`ucB^oRypXgLv~kv`(Dn5S@a_6R@#=iRo(hwT0loV z-@dlSG63gt3-l{${BpXr_$Ikv7S|Nvc9OsD)V5ZEpRYu1k4VFC28sHe0N?UjG5FUT z8+Yy=E*ohf^x+g5p{@53-H?2CGabDl>d{kH!%r)FV%qlh=Uq%aYsi9U8TD5(5+O?a7lBG!I@To@vdQJhxZl*a=IZe`elO`6T z;Y*vU7(1W&ixjGILVd5jlVP^2*;6IaAie4}6w_{&|5%J-Jt|%=im%4>+xpmto28U8UvZzSi!AWLFzWL7HZgS;(TK4sYrKVS6 zcRcRgjlHix)NlQY#;r8P#Umxzl%^wPCiPpL)?31irjX93a^vl>hxXlpK@REUruWOX`R!@58i9= zLX?%P8}O#&s+oCiv-Nq*0PmOR*<05ikh9gwQdVJW2T66Udj$@0T@RzrKjz_ zijV1^@7tU_!0#G$Ja(+c`3cvhyfY`?f%ICV^OA1>#+w#Z0Y)wjvzn;B?AhE0g3%7M zy<=|gSDT^Swk1|G-!++{T<&>&N<1(#OP+*7oh;#QUy&Y#IfjS2gm_1p1c{$gg_azO{6QH{l!eQExRgZc+<)sBHnO zueY+gC{QRurQbXidRt)M4-ZFcFRUy1*u5w>yC>{yZJt(W)tFJQ>+*FujN>qk+hO;c z`o|==;%!1LXWWSz^j!88st>1Wx`t~TwdE{!Zu=^zvUR?NLopM@cV)@n-yPeC`x^4W zms+N@QP5u7paLsm*y9~`n_cCW!|Hxf#|{I}vZsIKL2n7$2{*~w_b&eEtzOwTeh3mv zFku(&m&vMo)rws+h6pUFfxZ>71HB!k;^`^3;ZJToY?)xM6Pmvd4KVGqwrSrd*^VtU zni){TuM+>@x5LANSxT>WU;SL0=CtCm}i3tk6q(%HZbC=KXHEY?rUqB zn@1{`JMwWH%Xt)D?LPTT5*zJEy`z5~Xg;a8d!p0$v`5cPC4Nmyim*w7kw31tYo;~h zDZESGjRAI8@hUuuA6kT(Q6*p00Y8vyOmy?iI!u{zA^AG@F-Zz%lQsqD^ElbeY!HmfqMzPY9Gnigwio-XJaTzmp6>dqnL0(LH)6eQVmx1 z@y!{$)v~&@#Dm3xMk-naUVBMV@%quRHF!>kESg0%uXDuE!e(7LlZ0*W^EyJ5CtcUw zW(fseaits^jM((1%=ex8;Wk%IlG(CYh^2oN_@Zf)65lKRW`8CH6-Yh~tVSJG>DjA& zLB%G9#pU*JrrlWAFUo`v2RfU-=;rd?nAz_Mhc{j8@vWI|t5uBVExK}zBGdM;0T?{V zN>cR2M@hlru0th*HIJirCZ-Ztm?kdiq=4B#+WdjJ0cnuhE7axM7gm9c{97jToqN%T zB>gU7-NtWE_(wtmn6}Ky$Nbid2;;-BjlWoJuz8v|kBnPr3<&3m5%+VIHuFBbdN}E{ zyaqRDE}r;?6=MSa@A-PH-MO#x!sUGMJQx4jrO9yTFDnj%EsM`5r?|s#8$CxKrWNoC zEPjSMXRPXFOzX;SqEvvV``2Q32B6}c=A6z!2{BA=IN^`%*`J8s_~LFC9usrGw-~$; zIPvmfcwM=8=2ZKuHsMgCsLc;u4Ri&l)S{`rWV5kj=^yj=%`E_TW1VSv?IsE%c%XJ5 z@cq@iio!z#YMoc3*i#HnQk8CQflWdIpLdUExUEH^S!Ly4eC|8wiH{pk?cg?Ln?Cd` z(fR7Z|C}jSYO-_lL=1IjXp7GvVgLOxg6X6n*L27|#keq+ccNa!4Z9v#O_`(4{@C}qtZogB(b)UlshxI*o-5NYO}}OGjXL?m89zU> zQx_0CT7qitULRNsyY8>Q-(nEyW8wKFl)kQ%vUhCO*9$k^TaJ138m5uGmrTEVl-!OV zGwj=EqSCTMlBFP`Q)BcZESLf`0mjHeO_aGj!|D0Qx(AUxpawb+I;X7K-CQ^A*c*ID7F^usH|ZWEQZ2i0Tg_<^ zd|G8@|5ECtSL#Vn1GLX789%J2esu+RxyvF2vOLi|?bfnxG1;$3Jttsc!44Nh!yDg= z@)nLyoKr%9`|}Mo4hP|_#*&J=Ps=|f)VCXj$1D%*wpJ`F=)SBoA$qWSdhN&ucX`_C znIb2z*r0o1S^~9IDns{|3YLfS-%0f5Qze?~NPhUOHYrpqYKT$_6AM&SaoITDx$Cz> z=EtNlo!`47gwpFZ;FqvZn~Mkct?o%Jtzj-(diGrTFn^e3Edv*@w>Rxu@n^yaA=Fq3 z{RGxLS+x^A$g~HFWO{0drf1PKaeckJ_I#Jp*u(`9Mv>C4HdoH*8IDZ%-n!>_a~O-% zE7<4S#BBHe7alXfbZD+EQLB3D@XsYO`iYK2X%m@9lrFb1pr;TO!tgVF`9cx!@5@0Que$rGg9_le!odLMN> zZ)+xx>JAYned}M#Lm7^^@|81}#?f%QAHC%+W^=Ppz}Vr9u^ZMo)jd#|vA{{vKo@_a z9aj4g-;cVR^IbHE_Z;>);m3!blP~s;8onJ0n$=(vD1F~M3~-oxVf-umk{8+b!RwMf*U91^jOApcV&ST zb>Mw7=~g~a`y*~P_RWX}j>hriatQ2r1GquXnUOT_8kn?5Q6wh(2&II*J)?WXtovau zs@V=~4V82^*sN>Jsc8>ilH1Y;-I!}7Sn)=pb{$y0P%;s&D1(WK3I_rx_6z6Bn3snw z50)~%AB`$fmPPcLVhoSZRnU$lMaAs7E5RPj-AuJfj_zerwql!#9sPjw>5=~Pl^HG_wrZcdbSo=pIj%Hm9iTn)<123d62@DGyGTNh4kf0gt4g zX?1IU@23p<88hZQAunOMR0$Z-0%aq4Zur0{+<|wD5!m^LOn4Q_3!Y~ES&bjcCj{g9 zbwZXO3I(7VNF+l4zei;McP^G&L4cMY$_t)_)r0>O{;ArCmKS<XbFL6}1~m9L^jskfdae-0d#(`1d#(`1d!Z0^p%8YV5O!`L40fT9@7zEb z--W&lL|}Xu@_a%-iy#Drfd4}O1wt@>{u+5i$V+6L^M3r$vvEuSvuI=%U=S7Y3ii3h z+?sYET~J^M6+!}Jqe7^FAV~-+HvjqYXKq!HWgY;CM&>*dBE2{(eJ=EqE3n7UuQ^bn zL9U%i;`3jetOg~|Pg4Ug&>-AcXKw!*thEh71RS72m@t292DGdZi2)IG2ov3Jt!HkX z4I&^R@xQnQ7QGPZabWzvcLW}_gIe1_`9B9MMF*SFF(6FzzxV#1?Xdq-%O@NkoJvRb zr`rE@I2o77_;ZF(KT4pfP9*qLGXF4>W`X ze^(th{BP9)01Fm`o8)iy3GoBY|GdTrl>PG>3^)X@{RuOE7YMUF_9aeR?LjXh!PdV5 zB=iSBT7LiKbm6B~BAiQ{CgFgv8{t40{z|Ff@7M^%XJ!72Qb7S=3g@yP13z`M;r@eC zLB8K{559}^pD5J2i9`gH<6go+$_d2b3)uQs90Z}iYlTewlTAS$zz6RiYzhbi4gb6* z1VHfrB_{|dfY<(H)1nW=JrVzs7f=__i)pa+uU-iJflX`Rf7#^e2en!gTw)W@Bmf~V zB=`s90)K$B7>4|>yGVcsxJG!{5gI~Jw;$m@bn^@S0X+9Vb@K}XN1*OM?$A;<5Di75 zf1tt7|GR3BnSXN1&j)l6{ev5R7=T55*(E75WFo+b7{c_|o0=aAB>hLEYzPGYJt*>r z16dxR18gLh=`gUaB3bI>rTqw+t^nIs^n%A1NKjL_@ICi*(G*pJwfLHvVX7x6aI~z_@S2n z+{V(4;B8EI^^%G4bSXrD?d4Wr=x66bu=%fy!1#gHtCvZHjDu+MlV4&4-y1aA4{ZGt zubn2Op9okaBL5A|!Jn#-DJ}~IH-kngUv7?vrV%0X!Q#uZ=`OFI_${Eo$YlYbnF3^m zoboa&SzvF_rbWSjvck&`JfXbA$|GOU!8OW%u)_QMVhnhQKp3$9T;f|>K@&ZwF1Z>n zok0XtUv34oUW1*#g3W(r1^jH40QF^7w5CBQ?^9o5CD;!%x*Kf$lNFCQNFbEFKrs4c zY-nddH99nx1t4vpLCKe!He`h;`x0kh5lShFPkX+7BsOHl>Y;pc#9k&0EPZiD=_r4vnts9 zS4MbXKp6dHMzZEWD91pNKW46-K+tM(hRgbQI({<30}Nq97>NI};{i9SPZ%zb@Q?vQ z46HN!LqZUsW&9H{Kr0CGEb{-m1&!Z%P6(7ULYV$KI3KVHs`~3C7{J2>;imnY$-MtJ zQNaLdqyH|d9^FWUz-y+P!Mpx_IGjwe|si@0cB?YC1=>&`SOfL!kf~`(^Ncuz{}WvtK3%9}TqY zDf?w0TDg%4e-8082L2@4<2EuOK+kbm0G9()Z_n{}g9P}2OpZ%V;6FIy<}bU$c>EGV zfS2>~2sE7F2)>;E7y$~Da{iqgf#04jU;v%dCq=mYX& z$#ZF*q)R{~0$%VyXwEiae>03v7zjv1K7V!x=k~KK1h=XY?L`8i2pQYtw+V><=Mn(k zx@XCRi>LXE2V^i2K`HOeAszn?@Zen_dtQj1z^~`XBn+u?q`XBq4a+zv2s{dsXg86pe{ z1ie7M3jUtoKhVF#5R4bV&HY~tfk`*XTo9IF@n5i9B;+n&kq!Xwsj=Muxph&v5VY<* ztp}(}{0i8MeB2)a3*!O8^DYLXgk6+H{3(3q&I1c!hx0{PTg)Aws}TKIr4BB!uRt0JiWSkpi6s zT?{WccM%=J4-^-Got>n9b^aqv1_Qw-N|ZwI`3MXvbnu z!hZw_9R!gOfSMql%}{7~Lg$A66hDsV{4_q z91{=%u**Ql$mB0b7Wh3P;>#Mrsi5qlGljsp{h*2G$^PF-rV9d>dtQOxLnMBu@r*3) z3m5SO{ud+yXU+m-3cqapJvic_O@zQqIXLQ|A_N^G3_vPC3v(4NEad+^BH}&3zCgvV zz5+la*cXhDtQznp;^qHsngBk(09R)1%8RbJ=az!LoWI!sauv^Qp*zp(|2YXme|sk2 z1O&LOccH5u7 z>i9KYnKHOOdj9kYypz%JE*8(9xkWzOs4j$}(@p1lk3242L zq&a`r@~7l)JNYD+i-~{&_P-E0UvqzV7EF9F5TC!j`BM`=&{6-(hKnT>wEld#1-ewv zt;afl|8p)0lof*WPglb)MtB8)PYoa=dTQs4fWDutDt}JlzZ)Y>{p-%VSUtfJ&)>NL zLuwazoxg$l(^g*KW798Qz;d}1%^)upFMhIkzR3OA8w$|0{OS!A1g^J$HZH6GT%bsi zQ80g-PJq^8#Gf}Cn2I>3k>_HG1kE~MNB_@w{m2P?__DwW-eS&6>(^hHKaw<`Z#VY#K zFKKJm@1hjmxvG8HqVAr~d{N;}lWg$w-<=QNcVEI!YknMa|JZu?qxxuT{>SzP_mAz2 zUa&syz@PPTli)P}sgL{c$LYS=_tX5ukB%DcJBljLt!EdsjgySuTeAO{ZZ~pJ?jakV zT+%iLKM7v>rLfZA#R@6>u1ICAjb}S&6Ai@*r0Z!V8BN`Oe{Ct5+4Q=kgjdf>cD>W_ z_k5FaeP>FeP2S1PcSpU!uH4_2N8mg6-cEdB=j=W{>SUfe8dmtRv+*P7#dnhFrdY+AK&~p@ zo%b3N+9HIW-sql>zoSyAbNVUrj%By&6@JRQ7LUWvfl?y%b<{Ktk=tDwe&@5L2CY^7 z95U)OvzdqNJ<9_Os37#^5~V?Mbl|o$BPQK(0;17K&50 zBBpgk?d%Qqw?f1H!h`&pww03{^v|9zHtX8--+~_o`(&=&HYSgEu1EUD%n6mI@J?1g z%(QX-jINC3td%+&7cL4{`E37SSJTu&UTjd9?dnKDAP@U?Ih{B+|Ej*~(XB;7k0 znc25Zxd-Z)CuLa47UST9%~7iRveK5p5wcr4F4q=6FnN%Td1T)l|aKkMUKg7tAF zv;#RBu=Fy%Vd$CmvQ)>d%E6wcH4)DGH78J2F;%EzCJ^;}ui3$7vhIzlUQ z##31M)qO@4!s$J9cfvRyYbe{aN`iC@CIR)88T4UX8Niy}zOLz=ruwtBxRNCH$moRZ z$~+84kS|8*oo?hP>2 zh#F@qa+m5#(9L*#_l{BAraWxR@}X|dz<+UDL9$TIHqC4AhTv^4*vtp`tdHO`%J5Od z9~S!&aO@@2$7;jwwr)cNX=MIOm7L_EF)YtRj>NOrU%j?0%^9G78>em$HPt7W7Jb0> zSgoJ;-J{rbzmQME9Gzv4*KD9>q@VH}VA!F%CIjHQz`2 zi0eV7 zE3dpEtt^tHRe#$+VEuN7EiIa-lcMN@DIZ>&8)rl9Age1ToFNC}WoB{rC+N2Pb1(E9 z;w#7xBc!<&5C{&CHK~UfPQz5CxqaMk4R^Tr)fzLi9(p9kb*!o47U|!w^eyA@SS1jQ zW6-0jvP;Y&V(3#lLC5mwE*u3v6MjEBYcNTbNRmzEQJD;BqL>SXV^=cO$_~(yJQMHD zYs6~Ok}#R;2KSNkxJ|^cixH|-X^fZtz2hV8a1W<-OY<)6AX<{ro6}e6PE>5#w~6aX zRWSreHm>toM@P`dKQQ|I$%W+haAT&`QiEP&Yt%s)v*@a>mT7Edkt2Rzl&a^o541M! z44h*!yjnh7AyZ5(T!mMERXBR zE7pKqi_fl?$L6;Mmd7oy+~cB0E$Ni!jGsff-uuFR?0VUUjajGJ9a|U&Z|;u1mj&~n8S+(9GZ+as&6B^>>q|GxIbOgA#~85f?w6H zC^c%kPppN#&Wcn}c`&Wi6U0v0BCDF@fZtEZhiE=bk7_?8`}P$SXClg~N1sKvJXH9G z5@|xx)p>ze_6z#HOhyFss{N*!HU-EIh%|%7k(Iuo@Ou0FT@B-4^b}9^m{oQRM7ufs zHp|FRHGTTe5KER!n617LOY%k*vM)^|1a{4En!T+Lnk_JOt#O+8T|p>3$#B>zA%q*$2zx^6_|r<#9QMBSb3Oo%Af;;*)<5_KR&m@=*L((2dEK zbbp%vXL;O`*GpqK?1@1^lc*bDdEA$B7{gNzW_Q@w%#)l0nAD_To(Jpf*Ke}q7UuY; z4Tab1-=s6*|3+t}v3lddI+-zJ(dT*kyhq6_@Mumn@H;QNZd}t`IMN~5FSTirD(}&v zIf3PIV`_tR!1A~wwV|gGD*IuKC$~H2d>f$=vOW=>JdLPwDJszH&x3Mb*$J*dyYlBl`voUc!$gVn@zHL_hG(>}ic^jm` zwQw?|IR+W`9q~$JP_7*9ma#j&(x#^d+FN!>BFo}xHsaX1j*7EMz$(^Ddu{wIy z*<)>$63JmE-HXE~=I4APIzJS{G}lVvZE0=19Y=$d)=tG6>$6#bClfUSvqiIK&{sI5 zZ*Y9mGIJYUN3SwCX}Sc>K#vcNRH~!*ffltbrv!AmT58dL7wt2h&j>}biVq*+8%o6x zoTCa8e&7WeVg&qCnD@&ex@{SPt_fm!RfNZQ*_uQ2bmIlj^Rf$veHnyp5FUn!U~P6{ z((@7H)q%I;qr=43U1a~W%TS%o38g> zSiF}9%ncz$5N-h52vUVua~)_if`lXUb2ZWcF_ehD*nZcy6U{47m_P6)*|`Cu#*ig= z(~Oq;B<`wB*%qt*CT5#1=2EF!k^?YHJX1`WKU)vtg|DI<)t8FWYA8(eRGE|e!I5nwGB3G@%Pef&K(_F)mRwWqY5b#I94hB=b#7wy5vk**Gz_ZU3Hm!T83$tB9Sm7jR6uJBS# zx&U2M#52sa))J*;&}Z#ldysaRZL4P-Mg>7VL^n0*s%1uP0E{$< z9&mZ?FL_0HSVi6^vI+OU5$?a5v-V<+V69oSvSGt;@lSY(or*!vr`{ywpd5v(CG4X` zy41zrs${t0A}%-)FwnV z1T~81viANav-(L%H$LMS$N9=jKN`mj6eNb5bJ;n0xG_$F8Jo(PkpYoMKiFsHs9922jhz{ZK zR%UVWn{QPHt=K&$cN6eR9=ASAc}8|{3-X1g4A%3=2-&;t-NGmWt0&*LT0X zbNjLCgEsYEGU~2s%c0hN**ChQGxbv|HO+ANNzV^^66(|kRX@I)9p%pd_>v2+6+T%Q zUrWhRta)j}I!hVg+XI)NKQ@E^$jJD<^{J~{vJ-CIA?Phq-Mhr^*H)U!YegDma1U8P zH@W&ta>Xt#@~KI{KD*8d?qWso3h`z^p$%f^eALD=-oSjY#HY-58L zjJ_Qc%iMg;NjHr-^G;;6)Yplr=ZZhOJUcor<`+~PNch_7IR5nH&Ao;>TJ#wkN<*Q& z3F@9io~sZKdey}HQ_^w<6LdcY^;Vpdt&Q`vSjCWgFdAP;RMhQnkI+R!F#$ov$`qmZ#U| zFIB)YqsouAtd$(U9LYodyxT&agppp$sHTFWI!gUfKy<{655a1M4`v8wCgpA<4=bf2 zkpu>VB$i;J9p*?oN2^u*ZAAkKGpoZd^5~uYqm}e3=KPKIgiM)4LQ~>$8}y`%?z8az zZ@caFU++I4;9PclP5Uz9;3F%R?%MT|M)prdsE27oh zxUIt(1Iu|Sj!5@j`yqrqlWlG^3K6-UmSy(R4pqD)MVXVgNPs$Qs+o+m|8#Aw#;36U zPVXV?Imd@bm_nVJcjVP$kyfjC>r>P6+$Y;fu)A+qUu9v}nCMH8;Ea#A->V{aYSoZv ze|n#sS!k$cLfSuVF^W_4R~aCZ3{0z?BbV z4R26fWj`~wcN0_>aZ2rk^kWl88w)!6={^suTFnzP7Y(g6g_LSZy0Z}bQ1_|5zr)34 zfr`Ic>oE$9F0|%VM0b{JT066$U)jH6Rw5GHhR1q?Byr0@7{Mx7hMwv{2BjSb4@2LUilqGiMzWUCKFxB4=H=iB+co31_XhBE1sdo+m1u#hMybV(%Qo zbVf-@+{_Rb;pse0>pPVo-ERqs2M#XVS1NY&T4@aLnUBo!~TsK zj$ui(W~Z66gieGRnRwqMxF4In5J%3i)Bxhlp;>AAu}V3|`@W}AWKvJbJ85IWNA~wg zS0JKB2^xlxZZYG|Ij`$)Dv=4@7DJeMp4Z>Km6#Q5V?fYPl51|TrKifGrp9zCdFaSM z7h2WIS9T3G!FZTlcTgEpOC6CI_m;XT9oVviu&euj6HXAZd^k5VuErPfp1H=7Gj6ba z_JPhc>z0e=Gmafnd-S9McZ6~O@muV2neL8zf-P!C8l5* z@e`)})XVO&wLFM0KTWbQ!CR{&cUtOXm2V+6L3zDGYlrz3KS6K z;Oy2US7aMx*sE$8Mtv3rU!oi;4KkJZ^(YaP5z$pBTlE#Nh?`44gYzZnfZzR!u&oVw zVi4`iP(xmPw<`2ijzZ^0`!S)8(id{jiaL`;Vpx0XdQ8jC#c z5?KV`0uf9l+$nd@(1B~q@+i)`=0$qndJ=MkFrzt;X9F>r5yn`Mx3WT)S~Sw(G6z$RsfH zqSOzGT%6X(1)4_mAu6MBc#KATYVw0p2^^RPjr37N1ZW}P_adm4*i0;`=kTpJl%8;O zw;dtpR!$6(&f+ttgqsWNw3Ajm!I=J{f~4{8%Uf4=f>~ptYUN58x&8OJ9@&A48$~jX z=n0(05_mF3I#+~5;H}qqb-2x~F(;L%lo^ve7YndkdR{}%${YGA+J|9^K=;Dr5L^@_ zm#vA3Dk7Z_7_lp*TNyXXv{f8A3oP%CfaMKYMD7o;5hR$jd~`BW$s7Qy8!C#*OW_9O zxf|SDIYPKUf-;f*h)7)YDSBDCme+%;>1_Khb(O(5y=oevrRkI;M&K z-OU;3aDoWKo9pR!OoFEHS<%tp%)SByv{{@O=}d3&D($>V^afu_vNQhd+Oh;o|Hbx}U5j0C$E+!}YQJ7_JM%R$AR$vmZ%+ z54RaJz9SQ}bd^8dd{U4|<(}>k1xX}lE4z2n2c+UdjEp=VovMi!Zt61EdW|yB2dC^~ zSVN+{#!S;*HPo{+e%EI8g2M@zxAjNQ^xv(DS zXU{z%ALY*@8-_ow!o9|#!as9`@3TgQ6=PC(y4y)oL@3qU5wy_O?ok|KjjC~*H@qoH zQS!1kbi}#9a)Y{V5yiz)!tO0(C|I)k@_3wP5UuG)LzyhKlPGcy_{xqUk=Ho0Zbx8b z+vtz2*W(Wv5=oY5Y3MTCLK7i7s4b#3>=V429+k&q81n|+8(A&FzlEGFPe1-XvsPu5 zaS$)k(mvic<7y3Uaj5oHN1MpUWQMVN8$#6j5uUJg400h~OZy%SY^-9LV?#`y3S`V6 z*C*3$Dkk*e5l^steJh^ZW8yEcQaY0v${b7SJtr;?O@ioRN{KlzZ4gK&>H59}uav%0 zR3$6Pi_C)mKfbOyAd0VxN+_ZrNJ^)G(y>dIqy?fPB@&WKNJzs1N{I-FGSaD1($XE$ zDIFr+(kaOI2o?OX-(TX~z31L{@0*#ovv1C+JdvoJnc>Vf5kzlLTK0N0ZT3w4W0tfS z%FB#8Wd^mU{1_jIfl*aMZja8m1ql;%6e>}k>mKo1Vr+U5Y zoS)t|T}@QUIuyI&?EKtd67xzfQu-~+Q8ddF3K>$YIMQ-<)$#dp?^JH`rb#Jedf5a& zN8FEkFxW%!ndt=_=gaIe1?ISc|Gl=y3FNnwS((RL+h{W8$iB4dkJbvh-PijtnPx1N z-tc`0(tg~07Iy(fI>biWE$}qHbmCc(EcD72hJMVr;0a%^rA+lKI(AH{cEPO^8Y{Jy zca1J*5lp}x$_>WEPu(GC2o8DEWk>Tekc<|w_EWo}rR)+9x+%K37+UaP1F3ICSF#u_ zh8os`o#dKV)tMZI3=ye13eQtwh)aX(m|wz2tuSbkA3#523G>vJ3B0S_=vCe;8hV>H z8}?&d!iLqc$f@R?df74PL$sjXgO^*=@=}lf^E3D9DEB_+w(?|8U1G-2Q)fw6PZK>1 zK{)fYpGjjv4{vsEtem1qeBp>IHNC>ef6~J|RFZO47Cmv4i;kn3<`mJiBQ>du#>r3D zP6|XDT-Wn6wY?@iws_gkYV;R{GgVqWY|$X!Ah!^M;1l*H`uEmS2}66vdlVKe>(82a zK(Rf?DYl8lGLwyI_!v+yqeq8ceMI0&o<%elb$(SOkW7>~yK(ZXW~NlcC1$Bsuatt1 z@tb{l4s;h998JQ^0xmAR|=z4MyV#^TKn)Afkv(e+5r z_;za!MPkc_RT7+3?Wss1A$AYDQvSv>`er$W9a9kY`;AM&ehpYZy<@#(sJ;~3S$KYQYlh?YiU>X zkaG$pEzV0tJX86uw&S1|u2n)qLJ*8zwl~?k#Xsh(BqdkKuLG zxp$Ihf1njf3q96s3}hOO#qCMxBu>=#d-Q=5u^4LN*4&z5+aZK|rOsG4h3T%C0Zjcx zBWtaMkj+^VWO{Zq6!!%!b}qPCabPiB~U8=hlnF7Jp^MWPJ7hPh8GKglS~8i?k00O?ciN z8hjLeof8HbdA1!ZnrP2RM#_vi%VeK6yoyH?r^54AwAH>}n~~V=9W&u4t9X+=Qc67H z>SK32UqR}Q&tu@R4#o3TmmW5g_=>y)mP`b?BQ|b?otxtNMfWKE+PfrQzlV-z!{$>I zBI-`FF`xd%JaXSnsma5KqLLWxHX5G39eBbh?t(!o9G5udE=sc|h4W3jQjl6yC!gp? zu4{af*u8#XhFiE=2fiUw0++ST=v zZ;LULD4x+!HL3kxO)*<(CDr^Ow!u<+jY;(f>-6dLpj1mci}q)g$wC2Mxq}8;KJyJQ z=2upIIJ#Wy(}sBA7oJEJYWoe(@v&pwwg=z6qO4xuFcj=zyYxEH>vL_*{ah37(^&+V zvAShSmf-|4iM_pvSC++ktf7=uPt<3Ya?BbhvB*Xf+etpe%l2 zOtPipiu*p{}~dwCOF}H#l+K>YN$O1*3*3F-``E>4MuG zeJ8|mJ2V>gGuYR%-Dyx$saT#mA~=LcbS28Os0G&oSx?F^$MmtM1y>C*5xY(D3!gA?bD}*gEiwytCcuiN05@MrhHf z)qWv&V|W@9@{0ma$#m14dB=LwLv;Szf@eX0tSztSndu=bkqPRT<0cyk9N|^gb2K-6 z#ZKS2KFd^3M15JPtH)j)zrg*hb?b9yU)>p+2J}xdT^k8%e7LG9Bt0+i4cxPa(1W8I z5LT!~5iSdy(T}X(=-ErCo&Nx=91YE5XYo5P1b2UaY{ijDXc!#zN%kw2aS_ipK_m8x zxwGNoFhl&;$;G$7mPWVu8dHM6CFx7lx|K*Go-ukQJ`Ee*qYEM#Dzo}eJsRGu|58@x zg=gt}j))X~9ru6 zHI*C%ZB|d8hBAcPNB@tuJ5_ams(&x~0$6@~ngzZ#=|S_N$Z4a%l*auP9<; znT}(z+sluefARzRF%XUg-}j-$5YBtA%1mZXv7gUiu^KX zpen=||5+oQ*89ZlUGh6VeTSh^W1W~e%+RMi7>gA4N@OP(E+@|Qk5wdlsgP3%i)^k> z=!A1=kKg644S8}8mVV!?LFE?SmNga&f@+}X3sG~!XpFp*xl7~5gbknoiPB4w^9>1F zz}I_a`ZfJqfk1H^mA>dn(T~^eKPcwQ-3l%qPwS+5c&eVxYKS*YNnq7Pk5q1Az?!EAMJsZdD4!<__Gz!0^oXIu8Cz^2QiI5zAzhSws;pDgobX7-tRtLVg z!SV5_6j>fbm= zF5%8#&9!*sM&($ob`}dkmGVm7ZwOJZ-*nz9oGQ^ighXKcTl~Ux^WN#9v5h1)rb790 z52G2q5VhgH6n0e!c9C2ztHB zY)Kz@%d7aQQjCVKe-%P5x#>Ze(0CIxJ`g%zmHMh;Ctt_=eul3#o8hyk(hkB7WP$wB zjT+8hJBdoTgQ(sQ)>PJvb}f#rZmf7!a%?Wcr5YK_spM3h`vY@7sn=w9k1O%4cD$gT zwq!S4I%T-9LMHs)vG=Xey6caW6vTu3h$q`aLt8aBh*dUa31mbE>jFY-1a1l4?#R)* zaYt}s=-u^NmD`=)Bm~KAvNlFBRPowHCMr5T>f}y6aUh;+3O%2oX6lBixMb)}xq}A( zF#j3do}2rm#x_0AnG?;Vh$dez0ijb)m@q3iXNiU8drX<;i z{G6QBu%O_r;c@-)lmLBV`QHwV=h?>p*yxF^EOCh%5F*i^d&z@ebwa204Zx`?iT~{2K z)!jDv)?NK!tx=L}PR~^IiRXRTFv9$5e*OmY4)gXx2(iFYgoY6RPt}kjm~T-CzgSW? zt}aHT;1{%4U6;)(Cd1SIK~_G4=zDi%W?=3x0h>`148E=;7jkfv+sWQ3mcG{n7ca#Ga+fXFEv!< z{TQ}5-f3#W-k6+5Ahk59WKUwUv+}0&2?})b!dCwbg1f@yrnA0hHa(u`DShssDg08R zaT-(YNwGw>UPPKCsZI6Nhc!8jrpfw8JiUkq=*$hP4Yi-_P-wPqMA<7LW`uBj?dNKL zTqh=%x9w8x=DzbIYX{ZiDPNA;x z^~!;cECk-!XT;u*;EEY~E)U&P>6&>j8u7FBS9xH%XJyTzVD)xC^}2vegJ_@P>&)o~ zVG-f#Xxmm6Y-ewebh#HhS|FS&GiF6yIlJD_`B^hZg;UGZ-@)v?vKM7t1koXmPa)6x+=JInK5|~zZOTfl17_+3Tpf{QR|W2UX3prdO=wG+y9d zWUp&rZ>Mb#q3wpn1!aV4-y|_*^ zPMzc_{#tt;vifB5uArG^O84j2i~#+QO(_T$Hd^6pFbk};Ti3krM4fpY5T>CNzkSPi zu`Z=JtWKILj?sOw4wG6oZinNGJ zi^(n)3$?td457-g=FDswNy3>pD^fIQmG)BD{Dg2p)3r#qR40r=2hJ(oh8NaU#LZ12 z<$i;M_tcEzL;)!fOoYc+9R9=T}V#zFEnU`p~I#pHcl$ z%VbV{{#)VdqOazryDlRKJQy&WX2o>$Fb% zSyTCL*)*-AlS@>V!d3`ck5eM0)Clj%#4hVHe0P;Bjz9; zC?E}vOfNiDg1*yf#4?yEluuY^?fre&p3HXm3##z+25h=9y!c8@Rd=F(hSDwkk?$pG zRk?ZgFJG+0Xccc5qH?q;q}5L6OINP6dqczIZY?hCntgHBhRC*ElEd7Gzpd9ZK&398NrV|t$+!#P5#)d?wY_ToX$_M7Y?cf~|d z$jbblB-E`w8epW3_>Q5wfR(guue6SSx!RX$HhMlNUk*P>^PHshkLV};GC2a2*uNTZ z?9opO>pda2mGk{1!uQP*LABQT>{Q54wb7L@ag=K=7v-?V+_h+nyx{>s--w3=u|`o$ z&XJNWSBoc2&)b$$SaNz6Gt9-#T4OeL%m=(|jSya{!xz%Z;B!c5{P^j%L?Y+n!iBab zt1bLktx}rLy4*5f!*6IYpw`NXxk=RD2?8OK*dyZ0)b96W|5KdJhxj9OXZ_1pwS3_sY z;wGEM01+P}qqU+-usg~bzS_|wk8$6H)+*6TUFEx2h}R|S%c_jM0a3FT(|DE~HGS>L z?OgSrnnG{YZmK-#{56f}ex~)>?ULQ82?o7$gzhVvvh>l9nZOAXmt*Z}TOSy)(JQ{K z(b&FJEpV5;aVlL86EhtlltIV9c1!f?=d#W*ZJ*qWo5IpKci8KGW+_SI=gHVU9_}yI zr2niPA*vt|-;*yu*5iC3LePJOuQ*MOwMh1}dXc4i_O&}_Ea+A#*F220twL-Ca5cMD zb3{YtTgt=Uw2XwS+qadUP^cTcqoS*o!QYgmYlVLr2q5JCpk1|ohUml2N~z%e_&B6J zR6oRHdI3RH)%*QxWp7UvmC3Kg1y;y~o8%qKW?EpMlt$Nupk9?iy5zS57CnQrU7w_> zpb(8PQ7Y@oRe_DF6`PV$e`SZ(Hlw%Fq3S534D-boHo#BD>=CLJHQCBI4g%cXQ+7F& z^}QpR-s@G|j_%Xqb_n?UQQ>Z0`V}s|Fur9)501r^-TQzoc3)fv5&CXLfpfqRqhlV#nHpdeZ+;eytSoL5x>jT1M! z+2YsSFsUxu@7VoNKzKcoUT6B*VHcjwJ#M#5?QmYiwz$v>(QV|wF(+}s9*2Scv=K&3 zh&A=6>4j&>6Ea`3mA-h~#9%df7x8vd!7WA&t4=c;ZCO-M>g_!%)zuP$IbKEyTZqS3 z-z}5bC?jJ9_X(*y-FG}ZEnXC z%`CKRzvTV#&i9XF`bym6Ih4;P&J@!Xc}LAch?z9cXYchLOcN+h&hOMQGT-;ruw0+{ zn7#JSkzKl#j<`~(Mc&k5p-r}EdyAL5wBKYgzKB|m?FV%h=~dRH#w3dX)8&)f+S}jY z>6qd<7$!9<$}+@X5nOHUBRiG>zIMsM z^0@`wPdD#0h)B0e?0kvWbL(EyrWbZL4SfVJw0T4iu{ZRow<0KCdPrXG=u`9lB&{tG zyz%RsmwP5pH`O=kbI$H&!UpGTB_8%ilt|lId&~PlVMZgHK|zAu%Le=`fs>*;ci~)D z@v0Yj3S`K-t9+Mn1(P1%-@xyZ#YrpIc}8boo$B9Iv@sJC1aBRl;p<+{@%EW{+W2N# z>*=u0!@w3}Yw{UH1ik|-KPS4XmY*@hu{MOC?=I#0s!FY?vL7wyqMJU=Sqfi1m!ZV8 z*8XefW@8janU*?XXup&~6?W->9C7#KkbId^Efj?-{ogcoP_#s{Ee1pu5_An)(M(0} z5=!H^l1V=*^Kkibd5uyG^*##0Mm!O%a8aequwEmJF#WmwW&~$a`r7;_7fM{Mz_@-{VUZP-$;{Th2cjq>Ojz(`$&cuv%&P^H9 z%zV;WX?CH-ZCVc;Emjj?k;y8E`wc>)jVmQtEtX|mSCv1%MF`Gul-X0xP1t3UjeVX! zA>*;gg3qDG(U&o>J|w}vg82^Hgyy6ArlxPXP9J&`(M9tctJ};DuKML8tchN;gd$&q zPj{I&FfQYRxKsgF=qtU`cZ=8*iCKP`aHuJVD0|#wZb}MtncgPE%X$Iv+eUI@E^ZQ-n1EOQFKC8k!Z!z z!0dg1W?}Ku302{&9qA7?*By`Cx$rmC7fq^mu8xGW)YqkdpYfy^aS~qZ52&CQ68rVF zTKKA5?Tz!Ta^^ejeb(}{VhenmwwcDG-x#Tbsa;Sxv4nAdviX0}}9 zBEPg#OjkBA6A%WeM!s{Wa>egR^QBZi$B?%9HPbLlcOulu>{rWu8SYZTlZhX1_n9rR zHE7MOGmg*Rm?xf1s+?v{uF#LDnPO~?`M{_a$Yun!D5JeX_@F`K6e=T(k@O3mp92+N z!6|PqV42M?5DofY_uBHuKyhpYBX2a)MIxmqle z^xEf7Abv#EIiWs1qi5J4XWrx?uz}fzS;abzk!OE%O4o!>P@JEH}kqoNun9&jB z#9yhxV;F`aZ+9G@kj*r- zWW?}_M$ZPQvA2Dkb;2|oiD(+3@%0rE-MsS4y5q+tUMGScs`C^S5Y78;TqOf7evFWP ztYdch*Xo$e0>0+xLd%kx8e;=hUBBpC(Ff#?m7Vt~3jK(;Za5W=aElI2>!OfGf=4f`%V7|QKT9|HJ0ctMF_qsmWbTshNHhM>D!=4 zT`on{(9%;*^ZW#q?2G}%#(9b2IJeH?`7(XN$g5OUoMOsU(Mwy$pq!Q>Id^S2Ubu7k zW~=K`vv3pP)z}zgK$c5^7@?q%&bkn?eCBytWMOMNze6}L8CK4hn!s}FMIb$aC_}AD z;k)}5(R1tl+)so@sTwhgOzn&GwFps$0ZyH(*4=JlnXkf@f@W?!`UDYO9NT%&Gf9U< z{)nbrUt{)uz0OB(u7a*C<%Qx9tGq6>N*eyk!p|1`0by+9UeaIU2fQeXUxf`ko!JuI zn%H#OWf--vG}qNK{=+r8$K-0NjR&}M;cy=K@8kS%o;~hdo&8t0r8%j&4tNx#xxkUDyG`F8qLD7ke!#E`KVaB}@4xm=4O+Z6Q1}7EE`0yxd1^RR>yL7tX0O}S@cnoB z!M}Tb2LJAt2@d1W-ttFTJ1w&RfBpknUjBo!@*jMjAGRNaAGSXze)!(Y?V#0r`0CIl zFF?~9nTUFl?trEMy!#FN^Aa^T&!N}V`QiIa9Q^R#qzeZqkbLMa2M7Sc-cN7$ZEgS( z7zzj?Tv||QFYq5ZzB}w)ViX=8D0tU%m!O4#|A62CPy+pv>>*wtekh6%g_e&0FT=s% zTn~}@fe!*I1Q7Sn3+;zL2v~H&4&svW|D_`Or)cWX#_p$f$3^^?i0Cj5Cp72<-c#Qn z`93Ma{>Y)ZFu0AWNYU6@J zklHw*@4$Anxc(nN`ilWby9Ed;AALlU2nQdO0&GVCH9w*d1<-z?J^ozdfJ6Lo$lzd* z6R;hHV~+#*xg;VfFCeHq9ghr-3%UtxN8x_$!o99Q2FC$)B7x)DrBqKiJ`@)};0Qu$ zV7sxvy0Yath4vOJTD3=j^<1KSb6z*K;j zu7R{&fWNXEDIPaOnf4DJ)RYQV9txiT2VLrWlvBsHnU@oa1AfQbIH1}8V1}oGB)J-p z^b9acS*Ig`gY!ZKNNsSy^MuR~21z5e@j%{4ZQM{ZupKEeRYzYD=tDtqHa6FK3*6~Xa zF4&Hr!J@+5D$Q&>k{0&fPk6+9HYAwh%7a1TYR0M2C%Ve4h z@(WcEAmLxayFL3TOsRK9Xhty3+gk$fEE-QAlmv z&=^u17sOnE43iUj0&GW9q$vQI-#&}GzzRlw*b9p91bGd)Bl~8-3FC*lfYWi;BTlf|q-g#Zu(1gM zqOzm^=R`^~1x-q8Mv@#@YR&+xjNp9WC~rj!tC@vQV6Xt^axe869vh zA^dN9S_nZ&-?Rd{_QRJWXirI}`#*<)k`B=>#r}T=543a$pod=p0mC7f0Nfx#C=MJv zioL6$119>O!Va>p4xBvP5L4T~quABcfvns91*B{PS($VHw<7_4j&Dm4k3h^|2YUX?|zi90~t6By4CS-{y;hhJVYY-Z~16QLHR}i z*5Rj6$cmu%DZPkADN6I9jpZ$>6vAfqAP|2Dwi1~fpS8%d48((q;XKM_hwL4;o5abyHy z5rhzR&(VX>tupXYU2yc+lM1W|BYXaB08q&Rk8vpf+W<34&;Xv^e zh~$6;FD42N_L1vTUHQt(8dmrHQyS_@fKS~2 zZ#G4JAe-Al|1Ca>BPf0p`24Z;0n5F<{(mBfeE|`ezx^`;%@{)H$v+37=G~8e21kzv z=Z5CL{abt>hy%VO(*E~0UP=p!|7_rBSZKZqM5qEsj~4&Q06@Y14zv>vowxfx%7C9U z4w3vr{!h{9h>vvW&&PNnukS#w;Wz|1)BsFJX5ajK0*GwzXnFyhA9gQdX7Q-BNMdk9 zL4!zQfUiBkbT|g|q!tJaF%O|!q&_aGLy92qw+qNZf(MQ9L&t~Y1Zh|E~)&(q6z(6oY{%u?8FzE4(5fu94+QxTi)eE86 zA!{2SCsZ?nWPBVD_UO@)zD@vIbE8MI3lL8rKmiZPoPmtbu`>fK^tu7gaWeyGE>esg z4FP>`1cQA%c6`?kD=xyJ(km#)Vsb;10QlILToCK{zisZss4B zR)j;lg#5?P74X3E()978g25qUU^;rbQBQ-u6;2=DH`pQ77dW&ly7+J3_JnmLW&mmV ze{TEY?O-@`ZvYGXe@x%4(FssN{ekq-zHkW1rPYG#X|)DtHpC@YX+3*k3xS~k_gTNBvt6J{>WwQ z<_9Ep2qDIegH~a~_xHSj-|4|#56A~XX9XFaB>F4M^Y<5cAl(zWaj*pe8@|71X4ela za?ifo_oF$`6*#&f!6@m@IT@^a4twF6rF9i4>W&ecMiE7`e^_TMcw>U&p#?WVA~IrA9~QrzXCjm zAh@9F?Z1)tcWHr)Iiaku{m9sVWq5W=x+kfl^y|+c_Z72u+rY^MWrQDe|E~y0QMs?*Jc;J~V>2kN0&gfVwyT-u9&3v2k!fbkPScM1KW% z{tk`{{&oy?e=`v9`#o2{b}dLf=D-h|f4{m1^BJh=5JJ`{sK2Ge`G3zAu-6MxiT&er zWM|Ht8vZ-JSu39el{^kkkH1b^~!iQgH`PSiJj1 z-m3~k^9`JGu-zX&FJi;~X!3wva*$~JABX+w?mLw1D(VEF|HsmqYU+fTIXJ#yIsi%AZ*Q7BBkAe_RgDihw7; z1>D4cC$_&?ZZ|P-7DuJ*yByMF+Uv~+a6YAB{K@S1ZJHYFWQ0Oe4}6Z?p3+=FrQxUl zy8M{~;BixX+HaRbx0nEw5&|gykjI}10Di3WO+Oe5&0pD_zo!%Dp=$+f_wM?8a0gq> zz~I0-peo}41N*NS&t88q!I#l5n14>KKWaQ+A173vdEi9&SAyqnU_MCX%%Ai4K*Vl0 z7&pY5b>K(+SBdAZ-ysE97!<{a0;caDO&+kD6k7Q0eMpe!uQwc$KKm!?A4MLp8xWLq{HwnMuEz=!;Bq&D{b!s9_fF6du*2+Y$$<~eUlpFe<2*cpINzqBUgSKug97LM z8|>ekKmVQ(*HLjD{@t@W;v^lS(DA3m{i-xdsq+M4sgf_KPv1dpfZYfwQOpTmEAI?s zcDk>0`)T6q$J=@%9&gMY1Kz|XFlArfaoYT8*Vx_Pt^Q=~#A`)16P(7Fj~_qgfBaa? zud!W4^=likyIhP^2wM0ebxB?XicNcFD$mp5GEM?W#_r;Ff5A|Uc-9q%zadUG= z)CvW2WOOvC$7fLeT4@>B8T3CQtP=|D3+r^-8(v-76V?eQ+ZEQS%MAKBqCX%)s@f-% zH>5Y;B*BWr=$YdJQIZLIvkyo^WNMPp0(M=+|nxHnO?Mas7&niIsZ6hrB} ziEf-Ve$*;TMuEquozR0vZQyS+hF@6Dmy;_`^N312zchHF#kEM~zR4xRhvbIif*LGAqyxyKLdz&jNEx8R->LRm{v~D1R`O zB4RGqO4z!+{o&H6Q1ebt%1*j5% zk(z>Rt3t#jQN0Hr5}Ta7nAxZBdv93KlC;VVV44(0)L}ctk2mir>qPG>>!@V%JPkp? zz4N%eZBJRJ_dr=EuSmCNPgy6}s|6_QoGv(xBb~~_`4KA$DC@`}Fv>h{zvu?aI>B!A zS9X)at_ol*ZNpsZ65lyyAM(BFuRd#EtGr>qmbudHL~ zANb%6eR?DXiRx>n1m)a?7bkECiL901`I16E`~tx^`OqgG6MW=`r17#ij17)2{GTcX$bv^-Q9nA^J5OwaSiXM&Lnrde;pnJrb zFIQRim31=qm35@pn|GCUZmwEAllpcAbh3rtQR{gh_ivkL(lG&_y&tCyyoh~4(<6fqn{;-~Q?69y7pS~Gy zES>u|&1ls^iKogu+|?XsDXuA~Qqt?Z2@>=kVtw&A#Z%4(2(`@TP+vFtT3tqVrvA*h zX&ad<`a{i*kP_Ys>SqXwDIv9w)}F?}ZY;COnSzf3yJ>0s2?^aa6DB@1s~AnQlqsOM z!ic$aaTnjH;J$x;l~Ca7{b%}iX`yHH>M7m?Tc=*UGABh+Or{n)PIM2eY5CnOt>6Va z+eFJZt%0^B`pqPFdT6}Qo=~qmZIL77@mN=^wU(7{@Ld5wQ+w&qU1O{oR zBGqdg{BJnbqZux6$Z0a%{pSCDl4D+bO#DM_(cKHSx#E@;g0CJsS1vT;4ss5PM`K2! zNgI+IWNFHo>DaoR^%_=sCQBuc9q1$Z^k@#O!ez4eKsOf}; z>7N$L6vMlBH?%49jimb^LEiJ|VRBRoTQ{#!1F^C1T*Iec1}?`?HNoq}`@AaT+e+W0 zzSO+lN_0b`IsKQIDc9CDT;Ji()?DSy1DcAfv@XUptw&kG}{a@6PLPmG=yE;Gp?ST@I?V|-@qlad6u-x+QM|UZlcdaK3jvI;Z#l7B0PVHNa zZf7FjSt%f)Af}cp!w>f~z3%Ve~-ax9^p964QbXiKp3R9^L!wIaW!Z zNAUDDSB`(+qZaP-d%8O0xbnppXWu<)RgB<^2D&<`CY-yvIu~XI5WBiM@q4;D>VYnM zx;nHb3cI>G&Dia`x;pi^tT%A8-LO~M_H=dbXK*QSTvzmcKYX%7I$SH^PK%DR4dxTN zd&#(p%L1rhcoi!3)MKe~Xo=fzsFDeBhQLSiUY1fsYqq{lSP#(35$oWXmQL}xG^Bz? zRSslz5WjVG#(=I4`B|>-Dm=IBY6D*q2DF^V@cGVD9>>u7!F-GB{;sahbHejLR|kJz zSLZo%DA3g*%04}eNs7W@IEi84f1s^1MIY#%mKKB5OTfzPX7e>|gWJMc1Mu7dDMSM1|QJQ@nPd`qvWN$=3>l;OGH;0mLJ4QgqHR(zE> zoho97CbTE3Q@<~(BSdf@tK&T&_9lsLv{E{zvL=!Lb{Uz$;w%5xgG2&SR8{_G47|8v z%Q>8RbiJgP%eLy9U3J4NUJKmPHhP;}F2%}JmnrmYVhJB z#(9q{8;Z*|_(YmJhdIG6~VQ{CXiNe!^eNUG_z7UAYwTi{#0R>rfpX7D?x__B88*p|rR*4D`|B ziztuMXZ*0zrG$nCmoQM4X&)_0QM1)LugNkZa@HwTQBj`+H)=;lqNor&#r5B0{&4AW z-z=)&z0_Cu4?`{5UhS#sbhS^Jw_NDay5vd3a*~ej@-@{D)(@KZRCUh%QPm*_sygKR zsyagGvFBOn>?aGZm6!AYRUIhyu&U0DDy9eC@-MRxthe|=gisxp^J{!=yg%tv!cnCV zh4#w`QY4JRie}8D_qmeb-hs!))#`N*qk|f=L5#lE4m*$fG22Ha$w%^M6t9je-nq0; z5{ob6d7a@Sv#p|(S0-2eRAd~b*&_q`As)=K_&6BXt&H|eeaI@8_3hO8M6DUdj`%5~ z)A9ZOq==uhr_`_J#6^A3OP5NPdRU`X#?VyZo#{E)?0cvlF{sM>jcest;bL;}w@SviuDn5c93f{U)Fub!0rp=inx>!|xAQi0(8#p|~! z#4wrp!q1p2!%~!lzkDVW4 zxzRmNps~AqNwyl5s6IW_?$W1=KTK*n)smh{YOB1w3s+8ztW+@;pXzAsC2S5f)OmJS zhc=Aw4s%&m1rZvF)}(Wr&6msSLe;VlS00kjH3zx|c|8x!p_QD7#gD+1G88Aa0k;-O z0VDB1ai05#OvuZ?`%Tycmo|}K9#@=fgQuCq*$yMZ8dDOj*6Qx+5S{mEJ%&Yv+SsO< zmBbwWsnz(cb@#Jw!LD=J2;gKA)b(X2^_#iK%=_N8iMuySa5W2df~Zp3V%&2@9D20k zUWO(56~{rsxW>Z6h@bCru&{MnI>e>kDm(5609dMwi+Yz2Czp{9wJ|QhHYy>quS% z)MA5_Ssr>s!N3}7Z6Hzr5 z6H7M5B6N8!ubN%JNq4g~SP*oGWV($);r~JhT`^}EH^z|HCg*%+Ngk$*`TK9@@r>P{ z_g<6f+|-Qz@RP*rmS34efj8Dq>bniiM9xKz)KOjz&6u1NO-aNi5D{+&Q+i3YsHXj1L?cCI_2;} znd@RRc>EE#f{HOsQ4(lAh=Thg&wWS*dy=#YjqMfK9-|xU8hY5=yzxo8&84^CWhaaE zc^0^WY-gOM){RTyH!QBxb`hB~TxWajUqcZ|8y?2mB|xOQ^|bB$tz@h~8FKtQ_14cm zLGI7%wke4OJ#o))TXD(L5eeeT=sn{0>flt<;A2U%W0-q?_QnRGgy>5Ik*Uqewb0a5 z4!1fq4_myObul!hJSnB z&%M=?CD;7fdvwB^rtGqeHNm@(v(?_q+Ye@#_+~Jc(z~n(SXNJJC!RFx;;n1D{^OOv zjlf4w&F;GEvbu6;bzFHiib;qFI?oY-x<-x4f4?~82 zv&U|Aq~hDs$%7(M@qxco}5>^#p1b{EN=^|N;t;zdJG~u z_sn-DB9S&QX)ujAU#B`^w@LMA8b8{$$rAeN7jTi$ zz$>roYBlwln@;b{US*1X_&{X-=s{#cs+h#W)BX@uagSEF+r*~Sfn^Db7MZj6vW2i# z>jugFdRJui%|5>(yoX0)8*Jcs^4@HuV+Rl4>%aoK%ko~2XI)>D3t%j8&$v}s>vpW! zWAV;MR3lERUA&;Vov#=}rJz#I=-G*B%=pIibmnFYbtekZL_}<*N8F9PxW_+6RH*w90Uz36(Gc)IX6Tk|c6vn~aA&dLPb9Hajq2RaE(7&gwOAY-;u}QC#Wm z7@|zieB)~U{Y3@ynW40z;j@W2*$o{-!7bUls$mGSRFr2;;|UvBp0_vj1ny+Eb-gCE zlUclZ6IakxI^m?C?g!lfNzxw28y2Lz5(~;EF9osPsex=5wr{F1E@zfvQuVHEn6N@z zkJ7$un1K7Hb-nuX>vP7RzY5-D>S7qJseKnO7^sp~6o5WaqqK23D@r8MbV)&_`~Pd3g`jnJXE>*se_*)t-h=2$Lt!&dcU- zHGi|-OHtN`d5u`FvZb!U2v8x&Or2%M$2@HyKVV0B1nB~PKl^jTh;UFx>#4x@` z{aW(+Wszg8L{z`2xT_f^bIm-}B{A93%En5I=7u<&*{1Q%1ws~d75+r`4<$47*ZFJnk-R)RNB z___`$ubo#ozfH+XqLo-s5ZMPtdXC|8+RON^yAaGF`^V_#A5wRME@>0STh6&ZpqTxZ z7{yKbo|>QS>6aKdoMq)?5IcdzY(JFVL#&fe>snQ~xwu^JSQ;pC&NiN%>8>;r->Q_; z1ru$#+3V`F*XO(L^kyKKBOIG~FzC@9sZL$hT*y*erjK0Y>7Eo$Q}=XraOt&I4tKOs z&SC3JSm+>$O-sE`D)2C!G*Szlj(H$h*X4DcQ-au4nXa_GuaEFPmose#`QDWng zzQICF>|}n&D3>lVj8|rimAGS&vrr&R5tF~DcykOPuNlA8UA?TGGQ+04>0wCz)C5k= zlw@7vhcym)pY&aN6GS|vz3CkId7dRkWL@r^j}j|+#@OOFFTA-A89nw_RSF+=+cJI~ z!5+17Y_Iq!7Zf&Eh+qgu3s<>)<;6t*`q_rLTcpn0;3;1A3gL&1c{~f~X)im|Y*mko zR#<_V8Nx#8oAKn?Ufml1v`dSP-bEGZ9ncC4@s@JnsuG-4+**;Qb3-g-45bA1ZZvn{ zO+szd=pAcKMYb=G5}y;^+xZ`BXBkjM)5USPG}2wtjliWtB&3lL0i{d2QMxYOg5;&7 z5fD&1rMp293F%ZC5fBmHCG=6$Z|^79+4;|$IcH{f?=1T}*?pb@8Z|mALuA{s-P6RT zCW5B*5NAWd-2tLx8%*t$uwp+1+EG@4y5onYd+uh%j_?{8sXU1433r8h6k%Ut$b>=z zktGtTwQkJa!*>swsfZr|d*vx0Tz_wNySUuR+6={??i2pYVVtAr`}!K?@^%(??op~+ z3_84Skv1A3eE=VUjT91}H^k8i(x9SYx67aMeg?rZd>1;6wIa)IH+CI&Q(Vo8lvfGe zBK|dX5UB?uU6HJwxAuz?Jp7X8E+W!w-y)}$F(;%=I$k0|qLEq_exgU9>oV_Unx0h_ z6HONn;FN>K?7)d2yI?wPRCXSi2p%)=oB4F(B~dfG(Qjq(;>2qmHw)vrjI+1DO0jw~ zKY65)H1neMOI|K4HxYzNK_478*`;*f%x-_<$dH7ah=s>bgs02uxhfKO0myqOTEQ>< zHogoWLUwFcxSdV9+Vvp+Xg5#9o9ML$Rwd4ccZJ{Ht=6;){~qQ9y9iyS1FC+z zMP&`yh=EdS<`PMfIvoT_cbk&7mzbeO^dM1KM`#W`2n?xF)FMK9S=_3?GCMw)Gy*(x z#Q9(-+qZ7uH)%g;N05#)Zdb+^MKq1$d7fe%5@_j6d)ts}uoMf&P0`G*o9tGqwW!L2 ziB*JTt+012R?4&N>loV>FU9=U^wX59^I0v1zl1Q-Pa0YAB`l~}*4qrcNAudk8r6~7 zQgzEM8)m&#B=~Z=gjIWn*QhwCbs&_>vF{bOWG-u0Z;VZoKHj=d2R%(xbDR_Il1Qip zcV5?ye>;LCqWCM(l|Z!naL{N55cvAT2qgVZq6#1*3MaQ2_}c9FJRV8mf`z$%2xY)` z=nMmh3DRv2=68{NrUwF2L}(tWUgaH8f7Y7_US9&|irT$hmattv_!Bkc9` zl8mQ*W>K^CqFi}mGQCsx%Uy^`kL?QkNt$e?&^aG+l#6*AeB)Q9u=<62EKb#IIHYn_a;Ir z&fe!s0HxKVP>f|+cDyGUbD4App)2B{FVUtlw@G&j^BM01QN%Z9m6Cx+y3ir+gW?Ll)V{<`Y7t=U=3wku))?x*icLJ$ z`P;z`?d4fY$~SJTVIYynWO09J+BHupgw>`ar)0kE=5o6t6nV7e5V2#hkX|j-_dyf8 zkba@V7da>aCrCV>HA;-`g$XhW8_9EOGfMgd<2qgY5i=BcPaljY81{*59GF|kr4FFO8T}XGj9m1ZRDhT+WRwHd-_6UZ{F=>v%SAuwrvdsQVJu_R&N<4iQ&$Gn-ki z%a#EeKAF4>B}Mw|-0TEyv|)fW4;3f>iyL!uOt)v^@7xhDhGkg4D_460*J`TvIxnb_ zgt_?y`i=!ehons@lb|o&2Zg->5{Gc0dxiSA-Uk~FzjLvKRV7lnrWHHQtXkbZr#Kf` zQ4|0p{5TXpq83JsjsZ3riv{&gnOrOGTtLFOrJqmoycjiVO`Ea;&6LX{Z)+Ey>m7*}*oE@+fci0;oCTEgB=7(yOG z7fVrx%4=WSY4#zut;DmYn!cVKh|VEDOTGG{98^BU=^YG#J!L4ORiN&A!%UHgE`II) zff-6Gz8ZFGfguIL)jF_^9VALU8E>d?xj)1sAZC1f>hiu=>f&xdBLOCTVk# z)a(X42c$)k2UG4Ms~NJvSynTS){xZ<{~t-sO!zT-&XStt21eZvw|$Xvmej0eNOT4XP@en~C(| z?dZaL1?BC0>D8Nlv4Pko1PuK;em-k^Qeo;G)*&Aj&E&YE1tFrXU$De&igyeiv^@&O z9cVy6_k<5C5ujA4$kbW~lA7sH0ZGkzee1Eg*1v2E1++X$l_0m4ef{zxso6Z?n&&K^ z&nQCCZ3NNmi=<}sGUrLnjK5%{fVu?Ny8Mnam-flQt-Pza-YrO&IUCQ^dHN(5FooaZ zwWC33Qk~27ywU0^17;K8X^j%XZl*fk?gB?JZo9>Y-wt%NplZ}7F{@tXGR~0^+=*j} zo;cQqE7b~%^)Nnq9phsu=B3PHDB@=o-%I+@Y}mC zdC0g(*0)~}s`Oc!N9b{}q1_A!WX9%73B0)nLFOfuD^qbhP9feWl*RQF>2u9hp9#hd z7*{U1uFzl0=Ip_=zW0*n0s77U*K_t{aLR*D;%5RG4LhM=oONd!clBjl25z zJrF$sYEB+z!-V|7p2w*UZRJY6_2h)Nq{@!G2MAss!f~XvwaxDlzDZgNQB?q#Gqnbur6*Q<$V7?pwZ5OLU74|EU2QYbsVkXkSS^PI8IF%}E1;c9k%g zI%~`5Y=#9j3#+E(OwRE|AJ(V(_^MhTs>dNs5!5_y9X-sent8TMI7&8n)!UJ!sbO4w z19}*^u0@I?aVzI_9@*Duq!FOLlEGl;oBcdbm?w^c*ez0A>%H}>*sa_W{BuZ{qj4~{#(vM;Q#zK?pJ}qa%C)M2 zRMug_Qw-Pn2xu9W#()9~boB~Tt6wB`bg6XXgXMddH9m_rfve)`4Q*hFMjeqS&6c?2jIb_NvEDu+xIc(ULlr9@d!TQyh)ADYT2WrZ+n45T!(c?G02E7q9; zp4QR9WI#$YceZ%`n0FEE;~s1#)#eaGq-2Uc;c#Ic(cu-|Nn(-#ZKX#mfu$Q%;jw`y&+cyo)Z3c0#We7DW})%XeOcID}p14#mTTX^3W=FQndL}I&N z7n+*7P*3A8gvmxUE;w)px76)msHGaoO%6NB+PBIVstG>cko!zIc8}I70Y#5EI6Kc^ zYFc+w0+aN_uH8tF*_MvHGl))qs%LX(D1+_2RBS4op56EF*1+fPIktz0F!#TTwmaju zyAtAYIEmBZ?R*h`I++#t==g*g5i(2Vi`7}hbYpYa3^9QBD+XO%{<^CnU2U1raZ13d zOub|DOJ|j!>Ec9Nt?~VuXmeYt8TFt|4X&jMjO$Sz?};0ARh77#rX1*P*ZT;B%5Q9F zEQ<+oD`0W?cOA^#6eMq=VmR`pu}}Qk!zY>$6oidgWH!7Hp3k_W>qfLQGz^(K278bP z$~I;rt<#Qiw>+Ec6C+*2+YEPkKJ0(9>b0R|H^~9IQr9s(>gJF$))v}iHRkmAfvAur zQ5@_>`=@yd%=j=>7c(`+7>bEVXYuIo!(nBq%*Db*y44!+{><6;iMaGUW=%=zkh2nlaHST zdw6VddT$$P%LQ@4tNtt43MW6<31(x6cn}n@G~kko2?-l;c#1-ifbyY?>t+-Ej=trC zKzbMSNrHM5SiOfelD0>7f!%kitOz!d(hp4j(^q*hl9LxiLt`FTe~;r_`u zO$qsyw;E)rk03DDegg7MS0iY)%a=kSkJK;Xy6Z+{iI@iKKsZ6FJCR$Qxypbt0raZZ`SOOK?nb z4e5dGykBov+5SQ~^q!Wj6q%D)W~3#j zj(;gCEW$jtjbOlVfdnVa1))1bdzM;d8C=^&8VM`p-M>^Tu0!liV|J`rpnTOR;=50-2NCg`5%Sc7bK_;B{7(iau8rF-7_+41JSd2y&sXDI^Sidbu{lpHVeho_Y5S{a@HmOr zOOkvobdw3gt!s)9iJqJGbylh$>m*R3=7ohtGHl2x&^Js8Z3mSi2M~7``#*NSVO1vQ zd`jWt_SJ~8aR}*FgPPJ*d@2d`f>Xi0Kq9+e!~# ziHyE&6KISr4XA&jxnS4VvP68y@0$5I&oZC^pc<2YTtu`Wfy~s;Y}W=g)Tv`OxP06H z`jLXF>!WsCzh4+U5Az2n{e>{3gEZaK?b)}cN|8;Wj)u|fjV|urTMGyQ&aL~mJ^lIW zeZ>yg0Nkp_mBPh1kk@4x2ybwFZ+JzjEE7DYw#6oW@uF3+uLAkSc!trZ91+3#bZf{c ziEi495EqZGUKt2jy_q6Xuae^ZgDNf~t=IQ@7z1bWSsK0U-Mk*{upIRz+`6HfOfFY1 zEQo*9EhFM(@08(Z$6cwDVo71%6fxHOQRjtL?cxLwJjc@r&tHatZGO}pAYZ) z`9Ekm8FO(uTq6uxv8cuDuC7c=eIg=~D=8qT`F(Qn#JH>m0ukM#3aSx5#TZngQx}~f zPfHaM;Ex|#Uh;A2e_IxrtMLAHJ4L1pcl?t(`$cPMP+Sdlz0<>e`w3yxrn<&I=)}1{ZsWyZhW4&aJ?Z|^B#hKX|WOK$&>J1|BM&R>PxSo8&E?Vu) z*irW-FBc+4-!nq_VoD*H%3fOMf8zA@j(Yse37b;#P>x<>x(P#&r^FWztlshDR@17` z8$ARu>pn7&aci}2UlCY03;eRK@zfv{cj9J+mKwYI%FUO)r8Y-nR>bIM2QFZV+GO(3 z?@si*A2}o98jh#h4h|%}$X%yi@12xL74(`x+_t*g9yoQB&xePXN=G)@=m@({&96Q% zEeh}oY7DfJemvdfHiXNO-^XIJ64DcI3`3BoiF?ot+0Icz=)ah$`fuCt34)zDg&bH|3(*5_UJgc5kipT1E_X9_HzlfwV zhD_U+Q_YUEW&kgVg6K+y>2Cub-vyh#lJ`Q65F|bWbiDf32AG+%F69 zn}(=#KNpntIo$O8?q;axUIulw8{K3-Aq@+du5f&I?Cx}=4oR`N`FLp|jUhCb?+GH& zUg@*mn>|buC!`V>D?*3WkuIu?gs(7c3HkQYh)7Hs8SDFhu@K2bVj@xQf%!bfMIQ)@S+AH<^b|;d{kxX#A$F=IfAm5btmH*d9=vL?O@( zqo^2xM{YBXcQ$Hb?N}Uteit*h!V2d#37Ik-`sD9-+N$W8UhnF0czC!JQ-H_Lz@}k+ zYMmN|n~GhdqV4tFFBrkmP`7>jKJnIic?;xr-H8Tyx@oUdJnzW(_uUm-=*!B}y@+

`Uq&~FAQ=YnWtzlFb6CaBpC%`r$au7r7 zTk`%xx{XH#0_6nFFP7&Ylekv#ye|mL*;9SkHOD>D`?j<51KNGL#P>5{_uBL@tZ~0? zK|~rYZipn6#hp6xK%Bm}!fCiy%(_#P=I9~Pefmaj_*!i^bOU>Nfgcp#Fe$fa`l_M2 zA!+QC9M{JFSa7IqQnyh+Cs4^rK6Uq2CNY&r1m?Ine4{JhmnqB9%2f_S+@ry#>JW=% z+3O#_PKwhtlAji$@EoUfIojqFq)IjfwLwxv+&QqZ4c+mIxeNv(Q%+(9-@?V&aVL)} znbMEWOp;ry6)rgE(69A5tPL+1A+0q>K3uQ7H!PQix@g0p$)YlICms;aB zH^aR*?DM<4;W%FhF=7~T^A3K<-!aA%yWWYkQkVTKVFE`_anZDYBvbRH)ym4tc$-@g zi`XP=8FvF^K^9k{=INm zMc@<7hn`oR$M6f&LHYQ4M`I7i7@qUE6Rm)Egc<`X-{O3>VVF)b9to+6OLOdXIiwqM zRHEMun;`E($!UB4;^1jlv#RaXL%xzc7Rd44_QTDMGCK>WicXV>@XxyYAGfY6wUFn3 zM9!JIgP{8X5@-$WCM&e&og3*QRj)4iIMzz{EQWC5#`=`li!|~o)UtffEgC5=9;#Qx z+XgT@hzW1o*`F_8cazAuw&A}$mBY!ry1`wh7rtQiN!5lmc}6JPfwmOwmgyu0A}Jok zFU_Zni!85i3)Nlq?(z1kWXz4)#2WkTNiKUk%2)MY6KU>?U+1s~x4i0+;{kbjr!5B8b5*ZoXK1Ytf>d;qtg=b`y$`2& z%FDxkTK4b1@q3V9rAdspOf4_o5}t6Cr3HOf&1Tqrd$W4+up)3Ohets6?L!_NIU$Iv z`vYb9)T(+}g@Clgv8-MdF3MXlZ{}h=OuiNH<(4`g64F5Ul7{>UuM2OO_6`^(2FsM( z5*@}*k!lDckwkrJt0e{nsdqE_$Qz8ycx?bA~JVc)&BxsR-tZBV-f z)H;4A0b&X8_s9%PgDC{hk%*4k#+?~RNZ&p$|EQ~+f%CZHv&mbCLp$G^CTHq|t04Bg z_BIDFq6uYoZ|kb$H?{J*lEhe#JEn`&jP8c?zu=4-pGIBjd!>AQ$XsgTM<>DLL~-49 z_j4H^ZbdfI$?(LS%FS=)-Fx4I$zk~uZh460(K@@+jThd)P28~N9+=;D3K*x5gvh#W zr?pl+oO}?^+u))jJD{5!A{{?YzOe#R8@=kfVp9-3`%nXyc(tEVg#0@VWA}?vd810c z*HL=;-%w(WSQ)bP`X|L@*~pXgPo4*X-ptHOd`Xj+brWaaq~~{cmfIcffaG#aW__Kt z@i^LX%XJ%dtvC(&)+d#+N|#@a>(MV z@`Gv^?sqCjRQNl8=A6`h{gO=2Yrl>?m$_5ZhBPf|GIvrXE~_dTR!^haeX2SPTp_*D zTr+lro7bT!$Fuv^(><@_ZIu#(p^i3Y;A5t~CtheSRW@tHdgQs`ii_!0$xM)iwPJS% zNbR`8t>wNYf6U{Jx8E}kiWb8~Y&BvxM!n7alzBcUI8BCY3O2%rOoNr6ge$M~!rQ20 zBp!Vc1@k_8&ELomDad{1b8_6@9u+_P;iausX(c27K^H z*U}^+DwEIm?HwO&FSRd-#}j;pPy&ClFZVL2{mG*i=P82r_Z0r#o&xSJJf6jFaGNv@ zZ4GU0Na6G4a#ZhW=2AKt4%gqfi&W2X5~D7=jgeMj?z~IZx%s`S_m%OR;6Cy4$?g0K;s5WxboBD1PXY!GMD6&@psXc?X^A~v%=h~f)umeO0r4d z$)i%LGuDBTu3}@c+(=S*j7y7*Fw=aFTXfbv6?Pr{jZ#R|z@9qw2gl~&T- zKYTKpc9-5VU(3UQXPq6ly-^;RR!&3d)B8XkvFebB^1;@ zyS~i4=TIfi%^{5F(0VZ1CaHP z_NR}IL>+b9z9AjkCYkKJ&ypSsGn)v1u>QCqqOf6Y%Lyk;Oys=98izZ%USNzdQO+N% z_3`ao=bQ1Q2~ni)Sq6x7vnihi2V72a%3G^98L`#SBcmBx(5Q3TI1N4%yX^wL$+L2!~vnMw?hR z_x@u~KI_7a?ROrm_u@;4j`93Di`BSQk?gu3^R01Ude9n=KO-n@S&Z}?#j)lJB^=GK zIvjS~w%lT1B4xL6tgc?mfVez7Frq77fMU)1#)}|xltgrW2^O-#&Tw#R?&j4wUhj@c z8yv{}^f0oc)oS(uwliUK^CaQCJEk4;XVufmthGR&CgKcp2AB8hcmjB=pRJ6;Fg5is zatqP9G3ISVKEiKXQqNdAVkheD=x*0rce)xz#c7Gp(Xm9M-n?UBcmjD-M715AwqVwW z>Etjk-K-s1CXSZ2e=o!!ypt>e$Tj4XCE!qT^vUUdY3J;d3CopfOaESx{;d3Ve^RnL zUT&U_6idO4g3sJu$E_*5_E}2Q_4NnQ2BC0z(az1P`7P?CaJ}Ub=-P~O^-Cx$l>21k zGc$3c)3iJHne@7wK6xg@hGK*Brj~(NWQlOHi(A8*k1P1g=%nXjlMQCnyaP(1Zr?xEobcD3ejMEMcSogYP)za9_GTC5KdGkR|chsaViSym`J8+djwb3b9UA-`sL*OYcRN zvR$2?dWJabHj>_}+(=YgXBM=1n(;lMt1IxR;#PoN*!36W%&T&#q>WIb=hV-2F!9^w zKm=6jH+sL{-JkP}=Q%ox^hx7i6CMk#2(APEUTwM)xKptUPd7TdY^^dItARncNAd3VbT5n6`y`R5IuWQyL-hfI-ea$=xYx5QyK6jYU%g*J z^_%JJ1Y$_ZWgh5uAv9tg0S|jJW(IT9?MR{z4h`e&%_~n9^iCkVU7do?_+bU0*>!hb z%4O`LeF8mP%KpLfT1{hrT6Mk%?tyT~-h1?IdTlr%far$!{Wi~Sk3j-ki)EGQ2EN5l zvV<>paPEU9DM+naoqEK#)o(&&{RlMr+s2)>wzv@J9oUq|nlPMJwqZZ}em-0hkmA0^ zeOE8t`jK2``4b9=2Tvt+SBccvz419Ny$ETE*u*!f4uxv&*8`-+E5?~`)%1pe$^2JU z+}Wb5&2|n?{D;I^n1_aWCysU^Y+a>;qgXrW>p`%@X0IF^k7XWpq)_nJm>(sL-$WrY zDs9G}D`fUUkLj&=S2G1!5;VxG|G?Tn&OgG_>bu1bT{PZ+)NnqF)Y@o&a1^r5e*eVv z!^xOTqPpCvocUWBFGdae8M!RA-S?yo5%t3EzOM$Jj~`*q39F^Zo0=-4(e#W?i}Vmw zi;098q!t~X3%8$~!jfvDzxy+35b%vH@R9J@ceflo+#Ecp#>h5C=l|n^ zvMa(7DPDYG{(s0Bbe<^aJUb8v*ZFtHXT1QaS}te-z`y68JOf0p^Doqaf6sdc{yqQ5 z8Tj`y|I7uWfl}ZC@BsXKk-vrm3_kztof0@W{{s5#;G#(m@C6_PDB%DaB?giN0Y?|j z0tXlEa)5!)nTI;yi6NKyh&aHP35kG%AMISGB;o*H<|G0Rel&BLm52j;nLh_OxJbAI z9Q?5GBJB;(Iqwe(d4IHgnVX0M%x8TuZs6!g)0g>)IKY<)ihzS3O<$%c;s9UfC;|?C zG<}(+hy!rL*;n9{z`t5V_@JT+AR4kCCobqDK-G)yw9gLss~`%XFNm0zW8k{@ zHe3g)7Yfe^ZK8lfME?(_A^;FZ0o*wultm5r?!PGmgp9#;;a-4*07RVwnivYeEzVSg z|FKj6)sN5A0UCO~8i@H^io^Ajpu)j*@pU>lw;N1ALL^r<(0T6)~a1QO)b5Pd% zfGKb8gJ}OQ;e(<*xGDiC>3ARj+???kj)sWi(ts;n@j#OR-QU{;h(mw0`SbyZ0LrZn zqWil9NF}6x)eLfV!17l0e_0NOeg`DfzYg|?2f2R1`vBu8L58I!2BP@as{GI}4G;&- zU(fx*QsCeMzQQ*I(f;mSfTT_crPut2i2zAmU-RmyFf{?%N~tD@{;!VU;(~7eA$g_= z^a7;e_HJH=4Yk(!M+AR`!~nxM!yx}Fg1{B)+drG(_>ZjsG&2_m5P z)E^SPIS@W9CsY~x-*E$YNtT9JyV|0E+MsMECo6AoGB6cOHW1 ze=puL1cn*=@alraTmWj1|55uKsZL=8V)(t0w6of#MpxSgXzJ%-fn|rM#=LS}xge_V z0ZsjFeRBZG-#Cn~4tmxIur@kTaRSNz>G9(umb)kr990!HoF{38+o(T&yi zY6mlb1Xvf?VgHB(fS{`TLu9*kwk|mT@-zUj&W|tb!xxcI7Wzvh&f(`0kFGX#4nGh3qZs@M7}UE* zR|j>DJ|}*BrI8qHfPHT8_^R<|>~m=D)yh!4&*$!^8u;^Kf6hGTak$bvbPG^`IDtiL za@8IHdQJ%KaJX6w*#rD@&GD*1VrLZddsmBNr~u-5;?+{<@LA>AKZ?`708KMEU2WO` zz?Z`UjBCybx_vZr?06Zsv^0;1|%BO$`>h5~A z_vSO$dCS$}7%_l$j^cK;vNC`>k10u_`QtuIaRf9D{iFUIP#*-aCaF?E)K{M%&T;3o z?pOV9f5tnva=+R$mOJ483iqr2hdtw+A6=~-qnv>c74x{-M$}p5;6IA>j?cXbaEkx% zKh+uToWS#HLtB6X#KHHMn=!yUCxkxtylN)oJK&zRKiUyH1DJDqU1>hXAPXSAUoC|W z1C?WjQ~&gR+6mA&668uNPy>Kn4&va24k!NU`*YfP4CJcscg}F<6MwYi4FM(;wfEIQ zd3OQCUlVT-J^ruH@0Y*&0K#R4_mwMrOfdj4-vtD}-7;f#fKq-R5Ixo3n)wAu4DjgB z^X^`G#{1DB7qrIbN{7&5SinS7-zz;r?ax5xcY)%+S`LPW`GPq9b_#%-5C7{FKa|k# zA1VO$37qCW6Uya(V9}s_E!oS>Gw$C`| z9sYkGCqOcX4Y*=fOjAA{^j^S~j$>c}jCsP(s3{oUCBlRWBQr+A_7|8!SF)o8LD#b)fQbAP%aZ{M!FE5xIYXmIIf+45V{E z{Kr5(+ua;?0SsA)1H$yT26&<5@qi8BIAELQ*Yg(`a+(OhMSq-&#{^o8i3dD;W;zkD zqx_%gSN3Ts00$*Tz+ZOos}rEj0Jj_js7hBfdz$(_Ap|hwdkC`E1i08h5EfME?)Cd={v? z?!aUQUoe&d$D*MBL@Wcl=loFosEh6Z*@eF^CmL)Lu%fk+E_Sa0(ZwLnYy=?7asP>a z5_Zq}%HRhk`Fzq3hg`hCICDO*VGqTR26{?Q0cOPc4*KQ5pvoTbxMu-7qby?rd;RC{ z0nRl5XF2Yt=C@fSIsr_TgXD{;f`axFvkb_gcrgI~^{kt}Ee>F7)hXqN|IRt9XUt?k z#s!UwxpV}l1kA z0AzrQyA)CJ{$+M>{ep|-h-U{D`+4Aa|C=YkPvxi|O`!AsI#JHx-2zP-vZW`Z`P0X^%JxVh`6D)0IdG9r{5+-vo}00+}YJHgZeB^KPk&V5eM{R zIv^6w0T$(N^8sLz<3XX>Kjy!Zd*mUp8{c*Xt%sz1585sJw;D?D9_p~3E!Hn6n#RQCb|6d9OXw0GG6l!k?Po zrbA>NVByES9~NFF95@$oLl<6NitsO9d;WeS5r7)!0|uTYqQDTi%sOx`x?&vcX*?`?nA{gTy00JDdU1d3jgcv@}Ucm zaY1G409kPn2$AA16Xh2ixxiWe%S*7lz-1bOGkbwO%ZAGq@P565{J5P!gNlB3%=hCa z1N;pERO5_De%3MGuao9d28QZlfCyvAnu)mtF4GYJon72We|cTTb-wb?{ysrSh+W>; z#?-;=?DcgN6%n-Y8$24M-}B>RQrUP4x==h9i96INcaivSKOUzBTu@ZTRl__1{bF8?vO+E&03AEj0oqYI?l3BlaSM|Gbby0 zr)!v}ykDpEfIk7-NITU~IQeo)R#3Cw@rhgcF}^Q{*Be9O)3uVMJV*$-`DR?Qne_?) z%UU`0I)1N5ZYjv#`4o-9|LMIp1l~i}&_u=2y$4FdIP`t>*H}9O`5!oN>RUn$crcq4 zz4&dwCYuVJF%(+xQi*+%_G`pVynh zL4!{0KBV4VJ+eokiG@^E-AJjxWZlN>JcWxsqRIAD+P5J8D1_Ag4vF@5+Op5f0jHN` zJ+xxC53SzNlDg?5OQ3+6O!aZ>xeWL}g4RH|FUnFG1?AzFNx({fLK@s#Y7}<~} z-6h%w@Nqm~UQ1Ugj3@)>RCWexG5QjA^A1V}3VM7WN;>-rizx(VO`nSm8LKcwY*}hK zF5CczCzxJ+iBg0`IfRPCxS1b0iI)6p#Hc8yiH+aq7C&}Evn5vWtipmr|2^d%uvIv0 z%Jt7^;Sp`O6If0P0#;<+ORpWGnh77(+!KScr1P~L!kDkRst$vmmoz&g8|lXwt%il>+P8>|j!4i_wrsRvi#FpDmGV)PF-4(r{e8X0w#E233;ybeXwb(wXQk!imY(C%BHcN?u z5t}oc8h<yx#^J$;%7_`K#?!}lG~qgsYOoeHaOjTF^+_hZ6+(|GNqUMcTGXpauogJ= zu(7Hj=~9m-V8l&yIkkCpL`kXwD;8%(ZtN*=BYp_pLmi8%C9rsiCWTy}Fc7>*err*@ zZD&h!#3cC|cLz9RkXNPvoJ-& zak4M<(aihR6_rTQ4&NAgc_{UJNb>Xe#@xx|fvoU%nN*9!v(h3n)3AB3heT@Llr)df zzO}?_rA$THZYqz37D%A~0=-GWf6y5Zz0gj26w~V&fowE9+1J<*x`XBJoTdS;VN~^N zrvwk9C6ZRaVmRJq!OMx{1_=VJD@a=!xwKL#gTvHZTt-Ure$FB246cvFBxs1~BRBQO zpF%_(!*7U$>A}#TZzDV2)opjiMnZTdPxEwdwp@u8oszmn;gJr(R}wGwlkul^FyETU zZ)qXiTk^e4l8LxOaBGduaxs6ATz=cIn5+^dhNp(U7Kx4?pob+Bycteh#{g#r1P}J$ zW6LqXA`vBY=vUpav&F9M3g;e&LA$Fep-KlqyH*?2Bem+ZUfUH@C)@6Xjd+g?LAsqO z;(hd-(MvjIDPQ%_y=+bC=uleoOkWOc*>W6ZSg8ga4o7*`2?ngLL=wokX zrm4G~hoZ06(G*48d&TrlpZXnMqMvV9IpplE)!q_31#77ZWAqmt~8B z9LjgV(~_=(U}G8)^2lb=)j17ra8l}X-oiC)TH{I)_xXyAQiG>ACzBkK$yh4Y0Q(Wk z&Of;$A>9thZLdN;Hyh!@6q!EUE*l>zHEXP<8p3=k&*V+#9MC4qZQRWR^Kf;zkSP-# z{1!tYsul%f`slt229Xl8^$5(}96BN@$kRLfh<<%(Z>}lh)o}Sd&SLbFcw0q?wIkKq zdQ%y{J8l+v>uuf(AB`KsQT*@^CDrU40G5AA$}K&gSvA$Tum0h3VyX-91GQ@SpNOYu zUttJDJ7&j_Nj_*pXdMoIdE;77vjCwEHuh7rI`C>wX`Ww{|JPK`PiV*?yd*>gNZgR+ zt^gHHee4WSXhS426mLX3ETi#5d3qxU$}}x09dqc)5@Q;cta2b&W^ma;yV480N`gO<#_Wo2QRTz7wW zw$EL%7D8>A15Zi$Ga5$%1k6l=V+$eJh^)62XuLHgBpYH~B{>m=f)Zxk3Y(uYE7Rko z;GvCV6fZAgDx!L1lhL_yMG)VS*jS8XzbSL_`XDKSG*-a61~dVTVgIa~xXrO%tbtCf!}JDXddmvc0<{Y=^HOHz%F@*<8KmaK(akK2}+G9 zR`+)9Zl`!iaCf^fQZ}2`4UTrij6@J+&wE(P zSbZWtl(Z7weUmG_8Tec%p{??T@*J#_GD&fik(Aw#&~2aY<00=p?D2Zk<1X(p^s$~T z<&p|mxD`~igJ2jfFL;O)E*(EATdbJ*s@vYTLx){>conpj8QfCSKv`1aBF_ON;?^SB z(3>9OoZ0YWSvT8>Rp;r;4_;{NV@rAaIMal#%Gb0Y>=Vb@Tw7O|6Lb9t^O(NHmv)|u zWP(kR8TcecL$S`QCN36``c z2U#&#pR(=F7sYrynwgk2wG^?EGy|9Gfe&#s1#(Q~83m;u;Ty5RlYqBlSMl=ha!1qc zaKxqu58zc*bz9sUrV?*vduBVl=h%<{lQ!5dNQ53Iho;pDQc?tARgFnBAvO@mjeLmO zPteShoP?*8=Rm}Ve4KWeWqd!ki`B1Um>Bp>%yM?Yo>I?@;~P%5qlycCLMbWw7{Z8{ z1fv{^cT)1(Jr8bPVsRl(?E&v_(8O5H2k$T5IHU;J213gTFf@sD{7*M#QJ>^fKgIHN zMf|#i#woA{6D}8H5dEm>HTp+k6O>d3gg2sZwCD58YF;Uz2tsC&kto2lIH#LEU-xdn zCCK|ilvWpE_Zg9y#VT?R{IF5XOJldNjkl$i$fj(lCJaU z44ro3GWx?JH&h^Z5Z`Lc2FVM@#TN-?!iu%OgzPv@N~gQB}>uN z-rF5i7X8gm6fWE=W(9VQ&Ur-njhoJM2KiVtO%?MXk0;tiMnL9*6Mnt7AJj)z3%FA1 zn?fGTg&HMtS>ag83iz2Y`(`$8=u^ihDkLb-Cd^k5q9dz8P?xaR{9D;tYgXm&wHP-f z8zK?kp1)7{L?zM?X<%1}`=Ebn+D?J29XcL)L;KT||&lX|=9Ha9%#wYX{_FcCxQ z1C;HUI19Nbv}SCn$9yT9-m(vdq*{r<#F=BJj9+3~Z^Lt&DErubyA|x8!9_oi^X8-T zy*jf|VF7AY0mz&92=D7h)I2j`mF3NNRB6k1v^2A7)_Zqh{PJVFoVsyM5dG*ZnIi6~ zj8db}81mdm*nB!n47<~8Pczy4xv7bJFgC*?qy?-&&R1GCAg}G)$I9M^Wq6&T+ia*K zA>fwzEXn5JV~tky5AGh^shNq~D8Wh|#P<|jw8J*jOynWd4ANl914_F^CV{ZmuzdGR zs>Mq+Sk*lBox5Tl=?@Az1;ytr@xESp&Q!y`k&SlS1nX&;3%zeF5iF^C>|BK1P7twI zq$8z-kvi7nAd^u~Hq@9V%|RVo+_CIA>0wLW^}_^iIb#hdeJ1X@kuHqqWAg<#+-Qe4 z9QhR0sU^XXil`QzR&5-qkQ5IDdVMDT7%YOLCZLyT3KJ`e{!&8*kwr0whc4<)!xygme2_zT{&vokq`u@6)DhAzB zY=bC)0c_yhohi~Dvc{&69K~U8p#XwcCSz4u*x_1+5LEnT*m|8XCxQoSdBq@2wPutE}?8;qpb6*F$*Kql)S|&CNdZXphCd>LiVLuzS=8=^_-hzjrSznZ3p|R?QjK z!RNHTUVl3bPHDMVf@tmakjd-ViDtYv#3QSHnyJba#z#KiJf1R2^1FO0Y+uPbUYrmz zN$i~MCW63I5(yokFqU&*x9CJ{f1%VwS=UaKm>ZX9$@Vv$4R11~%{Jg!xMmt@)<0$x z`s)2?mt#D`7Ma7q0sgCxPg8bd1Oh=Zo*$LF@S6$NM0=2lt`o>lXUL{Y<$?|dne-IL831I z(G8_{+4wu3HTd7R=hEJHZ}CNS62qoTZ6DF(3XrPNFsb#GuQlL*iz1X3kSIKm6QYFM ziy*b9$W+*8y4>eWRTe+>`6u#XT(q^7^u{ zPx1vc@8aVwGbG-9o%$q`X?bb~^PcPVlKTq`2?AIMWIbuQyQalFEY}P-JPk`Sm#-0b zH

|$J-*iqrx=W#MEFL>FuSoq@k!j_i!b}bBeI~o4Jqk+6!cHwvTMtlkqP#u;zp41 z@V(N?K0I0Ah^Ce|O~(yF?2k;2Z{_6+gGDISs?~5%_aTJZ5GWtNK(ZNqX=!rr^mAII zD{7n43A>m5VZc46tm**sA&GDQqwOr?s_44EPdA6|ZbXpol2%YcrMp8yx;ZE*DIy%C z5eexA>268s?(XhqP%rcf*?B+I#Jqna^gg?{Q(Cf<`w9kpjPY-0I8U^&&PB z{RzBt$s~dmJC^mde5@cQ;vqBB)DqSzlAX_L5&`IpK}Ji>wtG@SW+=QRYm;vf4d9w!cHa79-99C=h~Tpm&}Y$qqHKd zQ$C@tUXEf5(w~znL!*MZx3P|tQx?VqBBsilkDdGpi0M9fk!MGU!r&-T^flo`A6&Xv zVsgN+3djm98eeR;>geeAW_Ppj>oh#x6s{jqa?T?*VaCsvtZNQwseDo1jH(f$=2pth zS}7~vr+U~vQf{z(roidbk+3?C&8bEgvRP&955iR-I5A0=)rbeT94!rzR_r{yb29vkp>$Y)yUL2-IvBMz%vlEuGAcR^RcxPznjZsIEkpvz=Zu% zZYdt8X3W@|xYlkk{v@v8M(-26UKW+yxH>DLx-~LdN39N#Hws1dnBO)NGRe50wKJKU z+paqT@(e0lgv?67au!XX?9oZP8K4EV6DpA>sjQ`@OR-8;4JCl6`j!WsJo~BvD3hHgU;LJ!@ z0D(-e+B3x|#z(5_%XDCsh5DucU4?vvv=lpp5Y-$+iY8|qlKc7hwEI3zt+u~N*7{P+&U zCGOr-Zj;|uj#zx+N`Bt2HbK5e^I0Ke2=)rBD<%jr^9!c{L!I=aGg-i@0^eJjlMTxu64+xfHv^r6;nqa zl+@J{A*CRK(QWh9r`}BN+#5j0^0}r@yw*ft-ate5oz99UL9A}U84ItpD*j^lZKz0+^@)&j;(ZnE3# z9j~;q2nKleYl*8rn%nWFrXHy5j-Zm2)IO^pr0S;80VjpYI}<(Wu`JNAWM)rT^@5{t zN&!( z2@vTyI_Y}Rg96R>(i-*B+iMf4RARj-&1xs2u!lvAu-Ll779w1* z3_F2|dD7|Xh(qYu*QDO6-oN*@C8#{~L(WrygtfTP)5`Hi6)D*gNMap7iR<*i$LuaG zG*;Tr5M{;(w&&yhgDeFg)54v_oHy8YY(BUHvEYP z!R(T<>S2q?6k?8#{aS`PZD?}ZY#6!uF7nDBt$W2dR!7^SMr;y1?&j}h_Vm}bxH=Swrm-GmU;pgz2=2q&u+fb z!NSUvc6O(2`_0C+wO7}pLp$iUIPVjepiNjq-@nlM#nh(@O0je*&xC{x|5YVopW4&~f^Yd(MVmY_b%cjA0 zlkZv<=o|_)zlv5aUit{BX^>C7ncZUvpi`Jzm;PP zqz07p)@$1&|IsGu$Y8NvkmL8cEn5(d8UkzcM3LTkRpN{95r`LthSN`41SVR}GiryP zC;Ur? zx~rD(q|!EsPb%*Ro%v_PMbr_~Iq8*+=4#6O^d+Di*?{fE4=Xv(1>>e{H28*6=;5mQ zm&t`icdB1yHG!sQ$(neuncfqD6XgQzX(JKxWwnO0x=+e++B`VQozHfy%bxQ@sFYc} z4Ju@iT9QX&W-dRxDh+;aZ~sgU)1{*nikXO-BCJp^nct@El79%RP#@xk4}N|T zkndeiGiHpG6;#AvhL;VGK( zzL;pk;&`3uW^mX9(sB;olff10pBgjzi@f`4DgSA4I|gO?^$t38fNmg7)oZV!rozDzjXVjsX$P`R z6PRI!zF}z&7*0M>2yO737u--G)qeG=3icWqwjCKZV{nOxHBG1r;TD)0x)&5lF|tsl zAVVWxglaNMdh|KhZWsYR&DFa?S)Huf^>PTl<362KgTt7kA-hBG-t!$d8^;Rsm+eg2 z;0m|P%lXZT+Q_|1@N|y#t{Zz~*<`}}E*bt89E7F=C3UTl>)rWk;hbnKc5Cw?yrzZ7 z$ZRL2SKyr&J6bkr6Rx7I`xZKw?_KU0*?ZI}#iuhYESrszYRL*Zef(I$7142% zNcl9LHM34iYL)1zF8)jN8AEmF_-nV*EOqGKm;3M&k}Z*YUcv6RUS*osN;}v#QRxCU z8H~?`BMhYDgqv&QhBv;=#+-qc$@yuANpYQ&M-b6NtxFM4E8Momuj+)&b7=yb!p5sZ zH$e*1)#kpcT3{#;#3^%=mygwtL4T}?Yjxvb{d_vTph&wqMjXvW_f-a7vQ10J0WsZ| zbggx5;has96;`9uZ-+S_lOETd1z}59H-$<-K_^@Vk@ioe=w_Z1v!7|^vAV=gxf^%9hW9E6zqDppRrQ)TZ8U=1j$Spg*2pyW2u$;2%#>);B zK6$(0mRiwZz;*z|{_^Q@xM!*Ah23^@g_UGO^-02~{v#)wh27Zxr4<{VvBZsQ$C}cK z*{kVs>!w4*IX5nmI+6Dh+p`O^D(eg7ybu`O=||aS43W9KU|#y*owe5GsQ8;YxUX&y z-e~7t0(LMYa0`DCZMuKjI)rIc41E_d1a@|Fw)=m&{B;{PefHHlO1F zJIW|-&_%!2juNlh3ggUyn%qIwz7tr?JC8RfF3|aV1`C|(XC^ zr88W>s%qP1`Xz_vE_h*Wo5$C}W*<8g!O=WWy;eV?cb-Lq$_bJ<@0oU<~|qivJVb9!npJoRzuGa4tN zS5^Ro*OD8pL*7uN`hv@i?&HO&)<8+qoPk{#IDRPd8ZUom`IPjSexJguVcU$`5sFd8 zhm|76acm@(o;#m$*?hJ(((Gv1WYJqm^kIv?bA0m0!RMGqi6-5&glBqv(uQi9I`=yAS{p7n9aK-? z00+Bk%XWTikBjb*UOTJ9ezAAp(TJ^RfKjSbmcLW zIrK3PF#H#Mpmo4Fy>#IE39{+19#%ITbuc_^Fv|BuD>x_Oo7$bG4d){H%HdHCs zAtTmxgt8~<^~YAo@i<}5F@5kOaBF_p5t;E6sp6|@X;pMJe6xw`3G8pk zshjLC?{+NM_*eODx^X(vl=k4*DkM@Q9O>*lv-w=cG~Xnhu)=$hCzQ!6XGrVrp$9JI zoCwf0Xb`K37$a^$-(=A#chbI!^fdo+$*jU*;UQL5{Aju{RG4J9H6fAfJ1F`Y zej3kUfi$^i*R-2VQJS6H*wX8QuiL9%b#zBaB3MKY(|9%KDvMw_kA;(Jr*)mc+SK{^ z%Q38v2bUh&(dJB9oJeSEL;NzIZaoLjYwBigST&#zO);>Ou-@!D(P9zUe}{la;wZJl z^*so^PVUW~cWLT=64cotZyl(gEsKFkBtJeVKg!dWqa&&nEZJ*#SuMA@p}fA;gg+D4 zr8)Lw=kw?3)tC3Ml+U_YFx716fahLKew!&V7-2!JL+wZ?vmn&=uvcv(w`v&7;E{T? z!X9=+?&5lW9{eOn_#CEHX(ytzvv*H_rw0|)jaa6JAliW={P;B@_;Ih2jeF_%KKa?U z){UV;-b?V8DdjE36xoK zgq861I>SqAghWP@qCa8dTIAF8@Ys1^kJd@fik~m#A?CM%@cxTe~dKt!v z^>D2}zVY)x>>1Hhfm*WaN)ajBw&$}jtmXU;vlPPOVPSDa~X7bX(b={HsK&2=Q& zhUaHG_rZmdXZ!OH(=(+o7;JVmZ45@LED4rHoa4k+5NJ^^RE~)@PtuKB=vG{t8OC|B ziq~nqdluf1y<`d@uBq&E5e>z%|jy)PxH({v!&B)0+P3C zgGy=1T(~=Y6?7>=f@(pkh7S9+qa|;@@EYPreB>L+n$Yw&V%pl8V`dEEznO#7S+CG& zW}RTTkaQxkqFZ~Bc7olB17vFM>FykKP}Xc8yQQS*eV>?LUm_6qZCw#)a^mmU*;{7` zflWN#nK0xz0x4vFn*;!f>x3@pUhLavyF(as&+Vei-nTUjoMgFSE4jZScI#}mlJw54 z@zge|5gruq*b}y*fhE3Sut8k#sqh2$#E`A&bglDT`O^9fN!zDac5GRsJB zNt$Ty8hwB}>v7L&-GSW@d=I#&?OyNnE1PBr*{1e@0xR;ySBq8~=Oj~NsHVF z-aw5myb`$!eF6?M-kzEK!Fgiiutfo{632gu9e{COf9 zxcGUV`}X3;InLXQe_%sgKaP|F7Oo#hQg1JQ0h2hnf1HQ~EI&`+-(LJUCwhDFz0AU`7?_FxcHd{aeMJk(Z2vx?3}*{RKNuQ&}oAs!u^GuV(0wDoB}R* zAQq!AG@u`6Vkz0VexjAiFL7Yq5fFbK*42j0+#-^Ige7<)?q5kOK;8k+@PCfiasVf) zzs~$TFpY%G{gdT%o0!4Ss42NaAJc{ z&E0VV5GMfAVh)D(e>(w;lft`B0OW)Kf-wJ|PCO8?`8zcMgcE#7)I1E`Utt4y6FkV| zJPiF`c7SgJAchuTX#cVUfD<5VdEt&8Ae<0D%I@laAWkk8U>N=?2Vk5KK%^J%lz$63 zfdnt!(a#|P_Cdh@KYQvHaDugTr_li61P@}gbSKy!h?DH4JCy*869UNb(tq^qE#!oK z`A#JO<%9s@zxrQw5z?}>N_W!5^;GJyWsRRI?0Lx_iPQ*WmC)wL~Dglruz%tqX&z1nlvYk7X z0MHX)ne6D|3c0Jl1)o4r_wVR`Fi)P}wf}&g#ND+6)DvKF?B8kE5A4bP z10d)6-!Gj=%#ZjGhl4xnAKa5FK>gP<7XY6CFOI`It^GkgkvqJj2e2mqpzN+5fSv#= z;_yzr0QCe|5l1kzsQ-!*B3c7W0I@s*lCJ+{<%pz=!-tdr)<3kpx7tg<`d8!t^aLLw zbqquIhg!E5P=_4fQU3s*3?9QU{Gr~tRg<3FQ3JpeVDl%R4 zHv#pZaX(A~Fo@@WwNarF(0TyYzj_;BoB*@@{I8N{Zq;ZPcho=dCeJVa>TR1QKplTq z4d6|H84lS0=y+!1`B>0M!I| z#NYf?vThro4!OCb{sA-@xcRHMcK~%1G3?((13VMlD1F#JHm_ROJ@5B$#OYk6)aDTN{uN#On2=0y=pqJo6`T_eNeY1V5CWMEj zr~aRj{~IL91xYFY9|KhP1t2E@1^h8U@3Zh=xVRx=AXwTz?2%$wcn~gxzk*Qe0fKM` ztbeu}0&q+4Au410(S`{%1erymdp zBLBxA@o@hueUS^YSM@&zsTUxd;G_IiTO?*49yAw3{}vCr3kQq%M<|g>d3cb|fXg4# zrC|VwWaICGAo`9#*zBl(g{?3Mh+R?d^awdBU~feIkCg;aO)gRYW01K2l^)B^#R|nEzW?iQ38DY{8NkH{aR=Rr{FXif!^IJ`_aEH`JXer0VA=l|E%p&0Bu$LJ z!iQB0L1w_T^=Zg0}^@5 zD!Hv0?bjCDk0wJXr-6DM$$mTi&Xxx@{s7X?EokJ{3H>K*{We7(XfCAQ8xA1t09c7f zaP%O~U-TGY&yEwwmG8afjQnWgPg46YA7G>77Az4={(n{d4F884kSiba(+v^rcdk58 zQ)EF6E(DJP_9r?C#Q8fp{&s^B0(%Pp0jl~J&-vD87w}2`m(M?$@xV4GF9duG^7!HN zJ2n2+hpiSDa-Z`5>iNxE0k%dV?zbS1A3ne78n-^L0H3n|^Z8A1zui}b?A>xa03QUj zpLqM9-2lOw1^Qc@>USsn0>|8T0xBLjj{i@87ryz~-&EcJfAMyLgE)V| zV}3YtLuPKd96ufZJt-og>v18f)W4hc3m5ali32ipOXj$BBKQgC|7WEB!3(fKMyX+c z(xgC~zo0RDXnyw+_y0{5ZcfPFEk`4n7WQ8#Ctx`KDVZ1IMEg7HUoe>;QL{l9Zn+q@ zj;OzB3cw`3nFGEaQR#kH#`S;mg^L$LQ25IS?T`7g*N6l8K=-?2f5BvK>j6HQP>X;0 zQ2l$p{1f260fRteh<&actoge21cZssq(%&jLU zAB3*rx91;Euzwyy5Jrao^ZePWAD-M0_v&AsXg`1d;b)x?#Z`c5$_W9uzW&=G3%~l)u?I$0BKFSA#!g|~SICm_ac z9cHA6kz+n3$Y`Qj>2VrX2!N=ZwiybB^NdP$DYTjBi1X;1vD@3cFK*&=uc$q2TbT0? z0*@%ju>_s%w#$y~4xrq)T#7b)nemx$cA5DWIl0pC^;leua9>DvXMQ=|L5hzNJ!Mpg zMMZ}&Rqsu-7K%oZA}3w^Q@^Kve(h}KJ@5@iW_#lKhl`w2G2W4(-l^>ruU2J;$qVlz zu;dYX%DjDB!0I(_2tV3#9<=J}a}?x*;|PW!T)#>v_kQXCPex6c?HpM7*3J0k+fUE~ zFwS)Ay$M0hC~-k$E^HcniKmjLREUDk{fKE)-$Ci9AeQ8BvrZCu4heLYx$s&-=F-8B z#l_>DFJFFGroD1M z?krEE@_UN|^%XKY*Wg zr$6lZ? zXFA_G5Xh1!Hz+E1xPY@1)=CL;*n|U|r6;ATP*=Tsn+%< z{q}^tVQs6wfXeZ;vu2#R_R=2FCmgG?q3?Kj2{^68_$Uw+f`Uix#6gFv?;C5!SK=)& zHq84uOQIAWEsMCjhf7(b9S4coFneuasd!3nD63TWczS)=(+V}!JoXHxGUopbPCpIk zr#T)9CJUVZtlvGILZ_y5{HUCT)Hh7VuVz&EHL9dO+bC7Bx2+Mih5!R2@@9@Co>F{q z1xX|HryVxM&|^h1{BMWUCa*nvP`Z5J&^YWe#Hyvrj_?{#Kn-2!AYR(HR!lKtR82Xr zE)lk7=?Gzq@(w&CcBw6Ompjz9z*J@C>yafBTJ9fcQ>DbIX_!!2ar>XX1|B%(-l@C3 za-EV{677*0Iv=p&baf2XkC=l^`u4sG#*a5N1GW%YZGaglH&9+z_3~LRjlf zcLT+Z?9~$7W-FTz!q&GDy061G+hYARA*PSg1eGQgDbG7}V25qnFU=SXO2b2N2?!Lk zo`u3bc6kWur`hxm)v+lDNDYQDCX)|9K^zY__D?+`>fft83dTXlF??W)!(P<#-d!3i zh)VIBr2NCc2l?+bKh4u}oIcU+5!=jU6Kh3z`oiJ6RRJ9xO8XoE@M=KP+`~sPrKCGw zvk0d&2{VG5e$5sXi(20gzUCv7bgP0!KfR9u6QcK)?R$QN7G7q>GPN6P?BdgQY6ULZ zkU-|1X8AMsBLkIYR6fb`nt6e0HNh9-bDDmx_Y{kR#JE`L`&*NJJ~V`u;KFwLPBpBP zrKdh5y^1a|%tZe3;Mu2DEE<+_LZ#z}%+gh$&!bc?@CwGM;75(Ie8G$L)lDc>QhrbN zP$YO?v}tXwsV+g>n8Tucld|*K)dY*xe7&6P%kSX1$opOn-Rh%5x;%lsrK1&J9 zG~!|9ZCq~*nysaKtLeK37XlSi&PX8In!+RBZ z77hb-fi{u+iT6=IX!o<(mwZglw!lg`l{sT2E_GyZv`g>XnTH>8-rE_Z_8Tk>efTho z5K|%XjN1CO;Vb=jA7tb(BaRKAMwjRa`%yPIJy8dQ-qI;68d%~zs7Yon3Sx7>T+DrK zf6T-*mtBu+olKyN5ea7LKou-$`I0$n3+L}inFQ-jxt;lmsXB#{BZOgzth@KJiVzN+C%*C_f*Fw*rkySkGs~b%8=Q2~5tc7SeK{dMVG^P&Y}g z*B&z%oXhL-R^r(gjNKqG3(Nh4D1nqb6UF&48$8kKB`UHkv*i9C%N+Pox7sYmDGs%9A(o=Dl zatwU#36GWW7*k$~<@M{>d)l5(dF63hndB)BAy>@;cx31zz$efrT|qN?eINf=jSl=; zlTf+~Xc971)&Xj;zXaXfQpcNu=7!*uDZ7&JDn&^<^_ZftiB|E%a-Qv(|;;;*NW<*QM{|vRUtvwnfB);xF;36LVfZWJC z;>safxP;Eo=o2MF9uk(oTss4tl14odd6e*{R{<=U9D)A9$3>V{ibXiu(%mqMoIY;` zLI`rmrSAkY8o$J z+^%S#I+eLMNs#J+0{0T+{kdXroZrB+{wv|uJM}r!v)49^r7qS=EQr$T*(*G_&+awR zfnIeYeR{stfd3+RwkyqO*{2l4{Q~!}=_8V> zXx6AD7MK`$M6fZYyn%}iwPK{hFY2z1U!hw4k8(~0? zkcg$xznmZnV>cQ-oxvHHbw+|^HjpvzD8VA)d2ms8wmd6!;+&Jn4o2`BdY zd7iMA{+_QgYc=fN{i#|pzXy~EDC;K@GNTR2$fWf;-}|v7iUTCv-mJfU1#1!r&s`|$ zNZzl(BJx&s8=b&peK%;+yrMY@D0$8rV6qo5LCOJ#fgC9lbXr;6T(ny0RSHg+R7NVBM)3%= zf_gFr=A1#pg&Ilsq7_MlPsCy5yuPMVNC$7YAc9xo->Er#TzlQZhpe5Ono|EggW8Xd z5o0I)4AW%vbsU;u{indJB=#dt3Ku^~NoKWyO~wE!PU;o=gyFr|DneOZG^`@h1SLJI zp40~e12r*91u+=QRw+G*@9LQ>l$_5As2_u;i0z79c6pP?MvG<#(I~l)bL8 z5&;&BCW(d`!XNyGXw()1zfEnTLZ=u^pop#Vrqy-)TJQy08F^ujSZ+oQ zSW%M#>ziP7RgQnWmff4^WMJz&PeQPLX&EYm=_|9)HDW-oz(; zykF%zGVu!&vW#BsgmnD`3{pG{L^OjmNs52Dk6cFn z$Qi|5*R+_=k(q^mfvkdNKP-eTht5NPb1ru*)~fWVRefuPZ)cs#UPLuFUFKCM?;tqf zQ<|?vY9D#O^47z4Btks=C+{3f18FA}_t`7W2L+1SUWrUvpur)~KY!}%-2olU9%tZd zlklct5c=#>NhK*R9VAGZXnlvUDEYnD=7WAz3Ejh7>Cc~>Y8jW($3HwNH0`b(grocH z0a4dC-RQL>wB#83Mt`{AntX^6;`^S%HcOHGv8&>{@`g@o@FBNiC}YY=bCd*n-ulz>?^qMp&CtT8-WWw)?a@xx*^XIX`kjFrV7q~t>nR}m2wvP*_6(Z zpFpMSG4$15X^&cu zC_hg!ysNW;+&fX|)pGct#D5r;juTD#m{;{nkk8E;p%T_Ir(%$V-*SdyaMA@hAT1DW zj8&M~HK+WE9EM!GR~3ekrCN*pi<>!{aDGJW^c##imrLrx4_j(YC7GXU1c&#%q1lJ2 z8gZ=}KO5%_b&yAg2=Wh$1w_LM?xbJg_`lkm@3FomCV$JFUF?i=N(Dso%b=gWuY!*+({F zvx9=)U175@vKtId4wuBx^NDG*Q|inF#q^5GqtQFRSCDJgd(8J~=QZKiRX%N@*cf`V zJAqL{+6)wU-rIYB2rq=TU?& z&>}v9n)OP@(MMz41@b;HbxB&Ph@%A4oT`h8DU-Ml%<;3vuI)t zz8rfKqw}p52S?>QGu?;MGHMf4ZcW9(?6EhoS*8nb%_qOo25B`MCyQ_d64ZHu4JCH& z$+$j>RIzLH&c#euDRLG+T5XkWcXeEVo12JZO65(Z!5FNtCvbG`@R%ONQ*-4 zk7J(7VlQeB6a)>ax+^v(*`+nXhbP^-%)fZFoI7r$) z-}b!$dqP{IZ%=AtO>C-q2l)Wm2U^|jJPOgTds9aY7l^zIeP)*=7T+gNDnRJGN6ry0 zmy3}M;WD+8`Ghs?0td@rA->bYSxgxIO3$0Ph({&XpY^_Ox{=Ojk&=s6Ub)^Bn%pR~FOq@n%~= zAeqb)#y#HMJiZ#b{zei`dwM>TP*YLE53>Mb&^^vwz_fZ&!;Y^Bw%wtuM8442bT-m8 z97LC`QNt?bzd+Eb5peh9gDU6kT@;X`xS?pA$~`~lHo#En~cfe!t+A)Ll%z+ zQAahmj`+2S{8p~pK7QBP>lhvyv7z9>CTm*!P*g^>6o$tu8erz_sFcElkmfp~x8jC7 zh3~K~+@loAeK8Qd;oy_3jR( znbtq-Z5%|ZWpm>YRQ#tpYp48G9<^P1Coea7OpvOlkiK+` z4N4FV7^E!KnKpqb>x9O@kH6H6-b}TNZC_orOX-syD_L{5=hu=GDV;f4XE$|j7m)|M zBf7TIej63rCW+L7ae6Uoj6006-z!sFoFKVY(Bw>#H3Kr5AzK(PBV0h4;cPu?;#-^; zowPr@T8`y(3Mua|Z=+(=A>(K5ES3D@8o zdhNy`H4kPKzsxG@t6Q)R^XlBPdj_tGt--I;eH}?4*l#r4*IepB(k}_0lgV*Bn$)eM z8&9^S0F~8Arc*6a6C1*%+%O$ZquLznK9GmeO4AFHF_=?%qWr~Fa5B8*YA^8gpnva? znJPEmW>*=wi!p~+SvSOEWqlo%{H73o%m%SC&c)YCZVzehVjk<7t!g5i_#{)hicmS^ zdmDx?cLYC=*}P)((|GP9?RP?w0*-vpmF?x!VZ#-PGep#$8#E!?srK}N<8~^r=j2{) z99$s`)=wqF2N5?-{DM0+=RNE=s)Ph#9+PJ%YTpEaB_6%4rWlV#9*Bk)L!m&n`OM-x zA}FOwm7jtf=e?szP%JyR7CbiAvT;Du;_ndUa;0vg4LwOEGfQUx7n>>GWO*=e$MB}} z3hpc4itNXyzK2~0L9>fz*Js(Ww29iA6b}%(T592<@-5EhMR#-)cK7W*TZO&!pvEsV ztl3s61D{Rg%MiDYKEPhw9;zS@zBuq?W}tW(XIRzTtN$%SQ(C{q>e_BmP!sausJ@(~ z-Ak~~bA;#RL?h3AkBjT|MI$@Ddee-iB~?{U7WnYtn+kfGhDJ9_(=o}LUK^VSrr{IJ>}1Y)=cChk zhnzGE`v=x=`;60?@dst0X>P|X4hth-`&ZBBg+e4UzI`gdK&*N>k}|k2fi@Jw%v7fS z;&2qqUwS$1=(KKTSs6FpVf=XPl}FEVNiCVwON(r!FN602Luc-P8L!|iKVr0`!O$l$ zem+%sy^&=>!#|U^)T1`|o_7U`lxB}G_@N-@JDl*D(MMC#>C9hPt_hm(1~oCS%AP&t zJUe$39piK>$#8mY6EMgv$_Aryl(H^1-mv`H30#QLb9$s15+JH`V%$b1Bxb>)YZF*F z$Nf1J#yP>r-Vnl8&cjBVcv_C{Gdb=jlbR!Ly+s)&@2F4Gd4CMI!3AM)n9UCH0ufXF z-rUs@A3})<*2KkA;wJBo&1b2&b_)i6tk`EY)yUoJPP2nSXU)eI7@6zm`hq zx54YAO$B4Zlf=@+Z_0t>IzhkPucg&jecOkWM^A?#diNwh_#VD%Pe`Ch5YcZUU_CQM zk}@38Ff|u*xet~+z7*^WC<|^nk2|gz|MKbm#F22+v%P%KL;-JBrWW?(VTL%_X?2g{60WiEmtkx4(ry%urWu!sq2xXDxbs zylR>Lwsq8X^*m*kgP^eFtA(snkdQo!#$$N@mB$j!tLq^ib{CgfNb+{mu`w`XT0avn$ zGv92@dIc6K7!B^_Ca{iz^~&_e>tP<#I~z6xX)lj0#~sXukFYkw5EiDplEUO_Z@+4M zGUiXju#%DAqj2#tVz08g^`T5W@+NO1c=1?+1}eVQ({mpsvM>@lPx;X1!rxXCs&d%K z^hsirpjuDOJvFmBxBk>^)h)Fu@YVKAM0;6u%`DW{YIHfoV=^?=aE!{fx-s*_Hiz7r z9b+q6=K>Sw2W4RAd4ml`Y7n%o^Sdh~0t|AB%c%YCw@96jgftApX=sD54%oN)!4ICi zw5no6l@}fNHwU{wCFYL061V61`bF;ph*x?@FA;`&y zL4y#-uN^&`7cK!}HoY2pbg8MS19p*}<(aH1RR9xa+sjWEuP0M$BO*3Xd-*n?a5J-SsZ`y-#J+MSBaSb7{ zlS0OmsxIeb5Mr&BN?a8~QjykVNxXu2*XN$q>DnC#dXZ~{$=K4+i{1c#RRKgHJDC*o z6T}nAd9(*r>QV|4UbvO@r<~F^3<|ySrk~PctVCeWdaVsA$hXBlHD~9W=%KKdF85~Z zOD%3R4Ngf`m@qZ!8}^wv)q}|rj!*|*G4U?)Nu)(UwPLX*_B<$f=RNY?CHZ^XM#mW1 z%kHCP$dLh~?K;c%h%xKzi6>QLUo&uD@-~{Jr_0yTv^KJrTw%XKsSy~UTNloO5#TrN z$$rYzjS{a*YT)eRR{El5@^x+0RhO_QUmTe8`EvsKw=+I`>M^;-s9N#h_;qT4rtRMG z1#!nBDZ_N~hHjULK(RZl=R8!GCfGB5>dMlVsa9^IoOrs}eVyP<*MfcWUPmoOuuN6) z*EU#9eI89?-c3TO)+yGcCPVz-HKePH^AmZf#^}eTxHaJh3mL2K>A?=?Wsw?~866W} zU@TRRpQ$!-f}GJva#hvAMc<}%Z}znidN&CwdqL>jtNS#;s9Rny?>C@=1~h_aVU?So zRJD!o`@GjD>3IQS4ifWh3Qph~kS}8J;AXb&i4fJHNEE%^|4LbMqiWbD7Z-hGv9L2U zTOQQNJ4LWOYvK^mSE8Ab+l0t7uYpExrX69~w8tPO65~gCnI<)bdl7ppMEGxp^?>TJemyru;#^muR$Wu6eI* z*x)9wsm@ZXb(h$as+zA99GaHAcn>c1nF%yFgD^

ZW*}`(Qj@trp0S^}!tF!>++I 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 Date: Fri, 16 Oct 2026 01:08:22 -0400 Subject: [PATCH 07/10] engines.cnfg: say that an unusable file means the built-in stack Co-Authored-By: Claude Opus 5.5 --- config/engines.cnfg | 2 ++ 1 file changed, 2 insertions(+) diff --git a/config/engines.cnfg b/config/engines.cnfg index ee5984f..d5355bf 100644 --- a/config/engines.cnfg +++ b/config/engines.cnfg @@ -22,6 +22,8 @@ ; - This file is the whole stack: a slot that is not listed here is empty. ; - Engines that are not in the stack will still be usable if a PRST uses them. ; You'll know an engine is not in your stack by a flashing glyph across all four face LEDs. +; - If Wakes can't use this file (a misspelled engine, an engine used twice, or no engines at +; all), it ignores the whole file and plays the 16 built-in engines. The log says which line. ; ; Remember: in ini files, text following a ; or a # is a comment. From 5b91d988f11359ec9bbd127a28fd5f819ea310ba Mon Sep 17 00:00:00 2001 From: Worldwave Date: Fri, 16 Oct 2026 13:39:03 -0400 Subject: [PATCH 08/10] Manual for v0.8.2: review fixes (Adara) Co-Authored-By: Claude Opus 5.5 --- docs/Wakes - Manual.pdf | Bin 428224 -> 431939 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/Wakes - Manual.pdf b/docs/Wakes - Manual.pdf index 1331005a392104ce106c6a55a1e55e880babd14c..5be36a1b7e1ad2af7b9a08a469e6fa5f46840f57 100644 GIT binary patch delta 186546 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%0D&NOr>J0Zgc~ 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ʣkmIKjh)gci(QIYUDSWqoz$AGwvO9iSI4x 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 F{{f+~S3Cd! delta 186045 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%0A)csxxn* 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 From a0b4b017ef4c6c1cd8d6ef0a01e1d10e4135a121 Mon Sep 17 00:00:00 2001 From: Worldwave Date: Fri, 16 Oct 2026 13:43:05 -0400 Subject: [PATCH 09/10] README: v0.8.2, the config files on the drive Co-Authored-By: Claude Opus 5.5 --- README.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b9a0beb..34904e7 100644 --- a/README.md +++ b/README.md @@ -15,11 +15,11 @@ The development of Wakes is unaffiliated with Teenage Engineering or Mutable Ins ## 📖 Manual -**[Wakes – Manual (PDF)](docs/Wakes%20-%20Manual.pdf)**: The manual details the layout of each page, with every control and how how to use them, in an aesthetically pleasing and readable format. Once you've installed Wakes on your SP-1 using the Flashing section below, start here. +**[Wakes – Manual (PDF)](docs/Wakes%20-%20Manual.pdf)**: The manual details the layout of each page, with every control and how to use them, in an aesthetically pleasing and readable format. Once you've installed Wakes on your SP-1 using the Flashing section below, start here. ## Status -**v0.8.0, pre-release for beta testing.** Report problems with the bug form under [Issues](https://github.com/Worldwave/Wakes/issues). +**v0.8.2, pre-release for beta testing.** Report problems with the bug form under [Issues](https://github.com/Worldwave/Wakes/issues). ## Flashing @@ -36,6 +36,17 @@ The T1+T4 recovery trigger in step 4 lives in Teenage Engineering's bootloader, works with whatever firmware is installed. Wakes never writes below the flash memory's `0x20000` (and neither should your CFW's), because that's where the bootloader lives. +## Configuration + +Wakes keeps its settings as `.cnfg` files on its own drive, in `WAKES/CNFG/`: the engine stack +(`engines.cnfg`), MIDI (`midi.cnfg`), USB audio (`audio.cnfg`) and logging (`logs.cnfg`). Plug the +SP-1 into a computer while it's in STANDBY (OFF, with USB plugged in), edit a file in a text editor, +eject, and turn Wakes ON: it reads them at every ON. Each file explains its own settings. Delete a +file to reset it; Wakes writes a fresh copy with the defaults at the next ON. No fork or build needed. + +The files in [`config/`](config/) are the defaults built into the firmware, not your device's +settings. Edit them only to build Wakes with different defaults ([`config/README.md`](config/README.md)). + ## Building Zephyr **v4.3.1** and Zephyr SDK **0.17.4**, both pinned. The workspace path must not contain From 363acb4186852f828de987cd8a2b4c0158645b88 Mon Sep 17 00:00:00 2001 From: Worldwave <65657072+Worldwave@users.noreply.github.com> Date: Fri, 16 Oct 2026 13:45:00 -0400 Subject: [PATCH 10/10] Update README.md --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 34904e7..e4b73d3 100644 --- a/README.md +++ b/README.md @@ -5,13 +5,15 @@ Wakes is a semimodular synthesizer, built as a custom firmware for the SP-1, an unreleased Teenage Engineering stem player that was turned into a dev board by its community. -Wakes combines two Mutable Instruments modules: +Wakes combines code from three Mutable Instruments modules: - **Plaits**: A macro-synthesizer voice, featuring multiple sound engines - **Marbles**: A playful random sequencer +- **Yarns**: A MIDI translator The development of Wakes is unaffiliated with Teenage Engineering or Mutable Instruments. -**IMPORTANT:** Flash custom firmware on the SP-1 at your own risk. SP-1s are abandonware, they do not have manufacturer support. There is no way to go back to the base firmware once you've flashed it away. + +**CRITICAL:** Flash custom firmware on the SP-1 at your own risk. SP-1s are abandonware, they do not have manufacturer support. There is no way to go back to the base firmware once you've flashed it away. ## 📖 Manual