Files
desklock/firmware/components/esp_hosted/common/mempool/include/mempool.h
T
jpmschweitzerandClaude Fable 5 cb5826e02b
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
Fork fix: the SDIO wedge is FIXED (esp-hosted-mcu #167)
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>
2026-07-15 09:50:27 +02:00

55 lines
1.5 KiB
C

/*
* SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
#ifndef __MEMPOOL_H__
#define __MEMPOOL_H__
#include <string.h>
#include <stdio.h>
#include <sys/queue.h>
#include <stdint.h>
#include "sdkconfig.h"
#define MEMPOOL_OK 0
#define MEMPOOL_FAIL -1
#define MEMSET_REQUIRED 1
#define MEMSET_NOT_REQUIRED 0
typedef struct hosted_mempool_t hosted_mempool_t;
// memory capability requested by mempool
typedef enum {
HOSTED_MEM_CAP_NONE, // generic memory allocation
HOSTED_MEM_CAP_DMA, // memory allocated must be DMA capable
HOSTED_MEM_CAP_MAX
} hosted_mem_cap_t;
typedef struct {
// pointer and size of preallocated memory to use. If NULL, mempool allocates internally
void *pre_allocated_mem;
size_t pre_allocated_mem_size;
size_t num_blocks;
size_t block_size;
int alignment_in_bytes;
// required functions to malloc, calloc, memset and free memory using capability based allocs
void * (*malloc)(size_t size, hosted_mem_cap_t cap);
void * (*calloc)(size_t num_elem, size_t size_elem, hosted_mem_cap_t cap);
void * (*memset)(void *s, int c, size_t n);
void (*free)(void *ptr);
} hosted_mempool_config_t;
hosted_mempool_t * hosted_mempool_create(hosted_mempool_config_t * config);
void hosted_mempool_destroy(struct hosted_mempool_t *mempool);
void * hosted_mempool_alloc(struct hosted_mempool_t *mempool,
size_t nbytes, uint8_t need_memset);
int hosted_mempool_free(struct hosted_mempool_t *mempool, void *mem);
#endif