jpmschweitzerandClaude Fable 5
cb5826e02b
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>
66 lines
1.6 KiB
C
66 lines
1.6 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#ifndef __ESP_HOSTED_H__
|
|
#define __ESP_HOSTED_H__
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "esp_hosted_os_abstraction.h"
|
|
#include "esp_hosted_api_types.h"
|
|
#include "esp_hosted_host_fw_ver.h"
|
|
#include "esp_hosted_misc.h"
|
|
#include "esp_hosted_ota.h"
|
|
#include "esp_hosted_event.h"
|
|
#include "esp_hosted_cp_gpio.h"
|
|
#include "esp_hosted_cp_ext_coex.h"
|
|
|
|
typedef struct esp_hosted_transport_config esp_hosted_config_t;
|
|
|
|
/* --------- Hosted Minimal APIs --------- */
|
|
int esp_hosted_init(void);
|
|
int esp_hosted_deinit(void);
|
|
|
|
int esp_hosted_connect_to_slave(void);
|
|
int esp_hosted_get_coprocessor_fwversion(esp_hosted_coprocessor_fwver_t *ver_info);
|
|
int esp_hosted_get_cp_info(uint32_t *cp_chip_id, char *cp_target_name, size_t cp_target_name_len);
|
|
|
|
/* --------- Exhaustive API list --------- */
|
|
/*
|
|
* 1. All Wi-Fi supported APIs
|
|
* File: host/api/src/esp_wifi_weak.c
|
|
*
|
|
* 2. Communication Bus APIs (Set and get transport config)
|
|
* File : host/api/include/esp_hosted_transport_config.h
|
|
*
|
|
* 3. Co-Processor OTA API
|
|
* File : host/api/include/esp_hosted_ota.h
|
|
*
|
|
* 4. Hosted Event API
|
|
* File : host/api/include/esp_hosted_event.h
|
|
*
|
|
* 5. GPIO Expander API
|
|
* File : host/api/include/esp_hosted_cp_gpio.h
|
|
*
|
|
* 6. External Coexistence API
|
|
* File : host/api/include/esp_hosted_cp_ext_coex.h
|
|
*
|
|
* 7. Host Power Save API
|
|
* File : host/api/include/esp_hosted_power_save.h
|
|
*
|
|
* 8. OpenThread RCP API
|
|
* File : host/api/include/esp_hosted_openthread.h
|
|
*
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __ESP_HOSTED_H__ */
|