Files
DigiRadio/Software/Firmware
micheleandClaude Sonnet 5 3e5cfe814d Integrate DigiRadioFinale DSP program: exclusive source mux, real
Bass Boost1/SPhat1 enhancement blocks

Replaces the 74-parameter ADAU1701 program with the new 224-parameter
SigmaStudio export. The new netlist has no mixer -- MX1 is an
exclusive selector (DC1) passing through exactly one of three stereo
pairs (radio/bluetooth/beep) instead of blending them with independent
gains. core::MixSource/MixerState are gone; core::ActiveSource plus
IDsp::selectSource() replace applyMixer()/setInputVolume() throughout
the driver/service/API stack. AudioProfile.mixer -> activeSource;
the HTTP "mixer" JSON object -> a single "active_source" string.

DC1 turned out to need a raw 32-bit integer (0/1/2), not the 5.23
fixpoint its compiled TYPE_DC1 macro implies -- confirmed live by
writing both encodings and listening for which one actually switched
sources. Documented in Adau1701Driver::selectSource() and
adau1701::paramSourceIndex().

Bass Boost1 and SPhat1 are real ADI algorithm blocks in this revision,
so core::applyEnhancementsToEq() (the old EQ-band-overwrite hack for
bass/stereo enhancement) is deleted; IDsp::setBassBoostLevel()/
setStereoSpreadLevel() scale each block's compiled coefficients toward
identity/unity instead. Confirmed live: Bass Boost audible on real
program content (not a static test tone -- the algorithm is dynamics-
based), Stereo Spread audible but subtle. The EQ "locked" flag from
2026-08-24 (enhancements silently overwriting manually-set bands) no
longer applies to bands 1-5.

A full sweep of all 223 non-DC1 named parameters (writing each back to
its own compiled default) completed with zero failures, confirming the
whole new address space is reachable.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-25 21:53:00 +02:00
..

DigiRadio — companion-chip firmware assets

Binary and SigmaStudio exports loaded by the ESP32 at every boot (fw 0.8.3).

Directory Chip In git? Loaded by
ADAU1701-Firmware/ ADAU1701 SigmaDSP Yes (headers) Adau1701Driver — RAM program every boot
Si4684-Firmware/ Si4684 DAB+/FM README only Si4684Driver — HOST_LOAD embedded blobs

Before first device build

Si4684 application images are proprietary and gitignored. Populate locally:

cd Software
python3 tools/fetch_si4684_firmware.py --dab-only
python3 tools/fetch_si4684_firmware.py --si46xx-dir /path/to/si46xx_firmware
python3 tools/check_si4684_blobs.py
ls Firmware/Si4684-Firmware/*.bin   # expect 3 files

Without blobs, idf.py build fails at embed/link time.

Full procurement and legal notes: Si4684-Firmware/README.md.

Si4684 blobs

File Role
rom_patch_016.bin ROM patch (HOST_LOAD before main image)
dab_firmware.bin DAB+ application (PE5PVB / Skyworks)
fm_firmware.bin FM application (Skyworks eval or community source)

Boot sequence: AN649 — POWER_UP → LOAD_INIT → HOST_LOAD(patch) → LOAD_INIT → HOST_LOAD(image) → BOOT.

ADAU1701 export

SigmaStudio project DigiRadio — exported headers replayed over I2C on every boot (no self-boot EEPROM). Runtime EQ/mixer/enhancements via safeload and the Web UI Audio tab (/api/audio/*).

Details: ADAU1701-Firmware/README.md · manual: docs/manual/ch-adau1701.tex, docs/manual/ch-sigmastudio.tex.

Security note

User settings (Wi-Fi, presets, audio profiles) live in encrypted NVS, not in this folder. See docs/security-flash-nvs.md.