The component was vendored byte-identical in idf_zacus/components/ and
box3_voice/components/ (documented drift risk). Hoist the single copy
to lib/scenario_mesh, referenced from both projects via
EXTRA_COMPONENT_DIRS in their root CMakeLists. The two deliberate
frame-format reimplementations (puzzle demux in espnow_common, PLIP's
Arduino scenario_now) are now called out in the receiver-patch doc.
All 3 firmwares rebuilt green (p7_coffre, idf_zacus, box3_voice).
PLIP_FIRMWARE now has its own ESP-NOW receiver
(src/scenario_now.{h,cpp}); update the receiver-patch status and the
PLIP section accordingly. HTTP stays the recommended push path once
PLIP's REST server lands.
- scenario_mesh: ESP-NOW frame protocol component (master + box3_voice):
chunking, per-source reassembly, deferred apply off the Wi-Fi callback.
- game_endpoint: POST /game/scenario/relay (master) + shared scenario_apply.
- box3_voice: scenario receiver wiring (scenario_mesh_init).
- espnow_slave (shared by all puzzles): demux scenario frames inside the single
recv callback so a misrouted relay can't corrupt the MSG_* stream; reassemble
per source MAC; optional consumer hook (logs+drops by default, puzzles have no
scenario engine). Add missing esp_mac.h include for MACSTR/MAC2STR.
- CMakeLists (scenario_mesh + 4 puzzle mains): drop invalid `esp_now` REQUIRES;
the ESP-NOW API lives in esp_wifi. Fixes "Failed to resolve component esp_now".
- docs: scenario-mesh receiver patch note (puzzles done via defensive demux;
PLIP out of scope — Wi-Fi/HTTP-only, no ESP-NOW stack).
Builds green under ESP-IDF 5.4.4: idf_zacus, box3_voice, p7_coffre.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Mirrors the master's hot-load endpoint on the BOX-3 with a
self-contained httpd (no shared component) since box3_voice is
a separate IDF project. Storage uses the existing SPIFFS
partition; behaviour matches the master (validate, .bak rotate,
write, deferred restart).
main.c hooks scenario_server_start() after wifi_init_sta(); the
http server binds once the STA gets an IP.
Move idf_component.yml to main/ so the IDF Component Manager
actually fetches the managed dependencies. Pin button to 2.5.x
and esp_codec_dev to 1.2.0 to stay compatible with esp-box 1.x
legacy i2c. Set CONFIG_I2C_ENABLE_LEGACY_DRIVERS=y for the same
reason; a residual upstream BSP conflict still aborts boot on
hardware (esp-box 1.x vs driver_ng) - tracked separately.
sdkconfig.defaults documents that WiFi credentials must be set
via menuconfig and never committed.
game_endpoint gains a /game/scenario handler that accepts a Runtime 3
IR JSON (<=64 KiB), validates schema_version + non-empty steps array,
rotates the existing scenario to .bak, writes to LittleFS at
/littlefs/scenario.json on partition 'storage', and reboots after
the HTTP response flushes so the engine picks up the new IR.
ota_server bumps max_uri_handlers 8 -> 16 to fit the extra handlers
(/game/scenario plus headroom).
sdkconfig.qemu disables PSRAM + esp-sr so the firmware boots inside
qemu-system-xtensa without crashing on the unemulated octal PSRAM.
QEMU_HOWTO.md documents the workflow and the WiFi/Ethernet gap that
still blocks full HTTP smoke under emulation.
Bump factory + ota_0 + ota_1 from 0x180000 to 0x200000 (2 MB each)
to give voice_pipeline / STT / hints_client / esp-sr slices ~25% free
margin (was 7%). OTA dual-bank rollback symmetry preserved (all three
app slots same size). Storage (LittleFS) grows from 2 MB to 5 MB to
host MP3 cue pool; model (esp-sr SPIFFS) stays at 1 MB. Layout uses
12.1 MB of the 16 MB flash, leaves 3.87 MB unused for future growth.
idf.py build reports zacus_master.bin = 0x1639a0 (1.39 MB), 31% free
in 0x200000 partition. Reordered model before storage in CSV so auto
offsets cascade as planned (model at 0x620000, storage at 0x720000).
No sdkconfig change. Migration only requires erasing flash on first
deploy because partition table changed.
Context:
The PLIP retro-telephone annex (Si3210 SLIC + RJ9 combine) needs a
way to drive the master ESP32 voice pipeline directly from the hook
switch, so the escape-room narrative "le telephone sonne, decroche
pour parler a Zacus" works without relying on the wake-word.
Approach:
- Expose the existing ota_server httpd_handle_t via a new getter so a
second component can register routes on the same listener (port 80)
instead of standing up a parallel httpd.
- New voice_hook_endpoint component attaches POST /voice/hook +
GET /voice/hook/state to that shared handle. Off-hook arms the
pipeline (LISTENING + capture + WS streaming, bypassing wake-word);
on-hook tears it down (stop streaming + stop capture + IDLE).
- Enable enable_tts_playback so TTS frames received over the bridge
WS land on the MAX98357A DAC. Wake-word stays enabled (mixed mode:
hook is primary, "hi esp" is fallback).
Changes:
- ota_server: add ota_server_get_handle() returning the static
httpd_handle_t for late URI handler registration.
- voice_hook_endpoint: new component (CMakeLists, header, .c, README).
POST handler validates body (<=256 B), parses cJSON, dispatches
state on/off (idempotent), returns JSON status. GET state handler
exposes voice_state + wake_word_active + streaming for debugging.
Explicit GET on /voice/hook returns 405 with Allow: POST so PLIP
integrators see an actionable error instead of a 404.
- main.c: include header, init voice_hook_endpoint after ota_server
succeeds, flip voice_cfg.enable_tts_playback = true.
- main/CMakeLists.txt: add voice_hook_endpoint to REQUIRES.
- README.md: document the wire protocol PLIP must call (state values,
response codes, curl examples, mixed-mode behaviour).
Impact:
- PLIP firmware can now drive the Zacus voice loop over Wi-Fi via
REST without any code change on the master side beyond this slice.
- TTS replies from the MacStudio voice-bridge are audible on the
master speaker (slice 9 shipped the API; slice 10 turns it on).
- App size 0x1639a0 (1.39 MB) in 0x180000 partition — 7% headroom,
no partitions.csv resize needed.
Slice 6 of the IDF migration: bring up the Espressif AFE + WakeNet9
pipeline on top of the existing slice-5 I2S capture stub. The active
wake word is the standard wn9_hiesp ("Hi ESP") model — custom
"Professeur Zacus" needs an Espressif training round-trip and is
tracked under P4 of the voice spec. The capture task feeds AFE,
fetches results, fires a user callback on WAKENET_DETECTED and
auto-transitions to VOICE_STATE_LISTENING. If esp-sr fails to init
(model partition missing, PSRAM exhausted, AFE alloc OOM) the
pipeline falls back to the slice-5 stub so the rest of the firmware
still boots.
- main/idf_component.yml: managed dep on espressif/esp-sr ~2.0
- partitions.csv: new 1 MB SPIFFS "model" partition for srmodels.bin
- sdkconfig.defaults: enable wn9_hiesp; disable MultiNet (off-device)
- voice_pipeline.h: new wake callback API + enable_wake_word config
- main.c: enable wake word, log + restart capture from callback
Built green on ESP-IDF 5.4 with esp-sr 2.0.5. App size 1.27 MB
(18% free in 1.5 MB factory partition); srmodels.bin 284 KB
(72% free in 1 MB model partition). No partition table grow needed
this slice.
voice_pipeline: I2S capture stub (i2s_std driver), state machine. hints_client: separate component (avoids cycle), POST /hints/ask via esp_http_client + cJSON, sync + async wrappers. npc_engine.request_hint now routes through hints_client when init'd, falls back to local stub otherwise. Build green: 876 KB app, 44% free.
P1 first slice of the voice pipeline migration (spec
docs/superpowers/specs/2026-05-03-voice-pipeline-esp-sr-design.md).
Adds idf_zacus/ alongside the Arduino tree (ui_freenove_allinone/
keeps building unchanged). The scaffold targets ESP32-S3, octal
PSRAM 80 MHz, custom partition table with OTA + 2 MB LittleFS.
main/main.c boots, initializes NVS, mounts LittleFS on /littlefs,
logs heap stats (internal + PSRAM), and idles with a 60 s
heartbeat. The orphaned 2026-04-03 ota_server component
(HTTP :80, rate-limited OTA upload, 30 s rollback watchdog) is
folded in under components/ota_server/ and its header is fixed
to include esp_http_server.h (matches the .c, port 80 = HTTP).
Not yet wired: ota_server_init() boot, Wi-Fi STA, voice/NPC
modules. Stubs for puzzle_get_battery_pct() and
puzzle_get_espnow_peer_count() let the OTA component link.
Add HTTP client module for BOX-3 to communicate with Audio Kit ESP32
telephone module over LAN. Supports TTS playback, SD card playback,
ring patterns, status polling, and health checks via JSON/HTTP API.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Owner TaskHandle_t fields were read without holding the mutex (deadlock
detection check). While safe on ESP32 (32-bit atomic pointer writes),
volatile is not the correct C++ primitive for cross-thread visibility.
Replaced with std::atomic<TaskHandle_t> using proper memory ordering:
- acquire on reads (deadlock check, release validation)
- release on writes (after semaphore take, before give)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Device no longer boots as open WiFi hotspot. Default AP password
set to "zacus-setup-42" (overridable via APP_WIFI.json config).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace naive `.replace("..", "_")` with proper sanitization that decodes
percent-encoded bytes (%2e%2e) before stripping traversal sequences.
Handles URL-encoding bypass, backslash normalization, and repeated slashes.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Unify AppRegistry/AppRuntimeManager APIs with current source, keep legacy workbench compatibility, and remove conflicting include causing IAppModule redefinition.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Move alternate root PlatformIO file under docs/legacy and document single-entrypoint policy for release/CI.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
PROBLEM:
- AmigaUI Shell initialized (g_amiga_shell.init/onStart) but NEVER DISPLAYED
- loop() only called g_app_coordinator.tick() which renders story scenario
- Device booted to story instead of Amiga UI grid launcher despite init
SOLUTION:
- Modified loop() to route to g_amiga_shell.onTick() when g_amiga_shell_mode_boot=true
- Now renders AmigaUI Shell grid (4x4 with 20 apps) instead of story scenario
- Touch emulation (P1.1) now works with proper UI rendering
RESULT:
✅ Device boots directly to AmigaUI Shell grid launcher
✅ Touch emulation integrated and visible
✅ App icons and grid navigation ready for user input
✅ Fixed:
- Removed duplicate src/main.cpp (135K) that was causing confusion
- src/app/main.cpp (303K) is now the only main entry point
- Added g_amiga_shell_mode_boot flag to force UI Amiga Shell at startup
- Modified boot sequence to skip story scenario routing when AmigaUI mode active
- Device now boots directly to Amiga UI Shell grid launcher
📦 Deployment:
- Firmware compiled with corrected source
- Device upload: SUCCESS (14:29:48 UTC)
- Serial test: PING/PONG responding ✓
🎯 Status:
- UI Amiga Shell: ACTIVE
- Touch emulation: INTEGRATED
- Device: LIVE & RESPONDING
- Commenté refreshSceneIfNeeded(true) et startPendingAudioIfAny() dans setup()
- Le système démarre maintenant directement sur la grille d'applications Amiga
- Améliore l'UX: accès immédiat aux 8 apps actives au boot
- Le chargement de scénario DEFAULT.json n'écrase plus l'UI au démarrage
Tests:
- ✓ Compilation: 35s, RAM 87.5%, Flash 41.1%
- ✓ Upload firmware: 93s
- ✓ Device PONG: opérationnel
Claude Worker claude2