Fork fix: the SDIO wedge is FIXED (esp-hosted-mcu #167)
Test, Build and Push / test-gateway (push) Successful in 12s
Test, Build and Push / release (push) Skipped
Test, Build and Push / build-gateway (push) Skipped

Root cause (verified against our exact IDF tree, not the community guess):
the "258" in "sdio_write_task: Failed to send data: 258" is NOT a timeout
(that is 263). 258 = 0x102 = ESP_ERR_INVALID_ARG. On the ESP32-P4, block-
mode CMD53 writes require the SOURCE buffer to be 64-byte (cache-line)
aligned; the IDF sdmmc driver rejects a misaligned source with INVALID_ARG
BEFORE any bus activity. esp_hosts write loop then declares "Unrecoverable
host sdio state" and reboots the whole P4. The audio TX payload is not
64-aligned, so streaming mic audio wedged on the very FIRST frame (which is
exactly what we saw: listening -> instant Failed to send -> reboot).

This also explains why buffer/queue/clock/retry tuning all did nothing: the
write never reached the bus. And why our symptom was instant, not after
~100 writes (the community block-mode-desync theory) — it is the first
misaligned buffer, every time.

Fix: vendored esp_hosted 2.12.11 as an editable local component (overrides
the registry copy) and bounce a misaligned TX payload through one aligned
DMA scratch buffer in hosted_sdio_write_block (port_esp_hosted_host_sdio.c).
TX is serialized by the bus lock so a single static bounce buffer is safe;
freed in hosted_sdio_deinit. Host-only change — no C6 reflash.

VERIFIED ON HARDWARE (autonomous self-test): 40s of continuous mic-audio
upstream streaming — the traffic that previously wedged on the first frame
— ran clean, zero timeouts, zero reboots. A guarded SDIO_TX_SELFTEST harness
is kept (compiled out) for future SDIO stress testing.

Credit: root cause + patch designed via multi-agent investigation; the
precise 258=INVALID_ARG decode (correcting the upstream community timeout
assumption) came from checking our actual esp_err.h.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-15 09:50:27 +02:00
co-authored by Claude Fable 5
parent ac9d24e0f9
commit cb5826e02b
666 changed files with 216925 additions and 0 deletions
+29
View File
@@ -85,6 +85,35 @@ void app_on_playback_done(void)
face_set(FACE_IDLE);
}
#if SDIO_TX_SELFTEST
/* Temporary autonomous SDIO-TX stress test: stream mic audio upstream for 40s
* right after connecting (no user tap needed) to prove the #167 alignment fix.
* Remove once verified. */
static void sdio_tx_selftest_task(void *arg)
{
(void)arg;
vTaskDelay(pdMS_TO_TICKS(4000));
ESP_LOGW("selftest", "SDIO TX STRESS START: streaming mic audio 40s");
audio_capture_start();
for (int i = 0; i < 40; i++) {
vTaskDelay(pdMS_TO_TICKS(1000));
ESP_LOGW("selftest", "SDIO TX STRESS: alive %ds (no wedge)", i + 1);
}
audio_capture_stop();
ESP_LOGW("selftest", "SDIO TX STRESS SURVIVED 40s — #167 FIX CONFIRMED");
vTaskDelete(NULL);
}
void sdio_tx_selftest_kick(void)
{
static bool started;
if (!started) {
started = true;
xTaskCreate(sdio_tx_selftest_task, "sdiotest", 4096, NULL, 4, NULL);
}
}
#endif
void app_main(void)
{
ESP_LOGI(TAG, "DeskLock starting");
+4
View File
@@ -71,6 +71,10 @@ static void ws_event(void *arg, esp_event_base_t base, int32_t id, void *data)
esp_app_get_description()->version);
gw_send_text(hello);
face_set(FACE_IDLE);
#if SDIO_TX_SELFTEST
extern void sdio_tx_selftest_kick(void);
sdio_tx_selftest_kick();
#endif
break;
}
case WEBSOCKET_EVENT_DISCONNECTED: