From 03a94fc4a89c469db7adc53aff6dde5169e59528 Mon Sep 17 00:00:00 2001 From: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com> Date: Mon, 25 May 2026 09:01:35 -0400 Subject: [PATCH 1/2] [esp32_hosted] Document use_psram option --- src/content/docs/components/esp32_hosted.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/content/docs/components/esp32_hosted.mdx b/src/content/docs/components/esp32_hosted.mdx index 754fb21851..fed64e03d2 100644 --- a/src/content/docs/components/esp32_hosted.mdx +++ b/src/content/docs/components/esp32_hosted.mdx @@ -70,6 +70,10 @@ wifi: - **sdio_frequency** (*Optional*, frequency): Set the speed of communication between the host and the co-processor. If you experience loss of communication, or reboots, then try reducing this value. The value can be between 400kHz and 50MHz, with a default of 40MHz. +- **use_psram** (*Optional*, boolean): Place the transport buffer pool in PSRAM instead of + internal RAM. Recommended on host chips with DMA-capable PSRAM (ESP32-P4, ESP32-S3) when the + host firmware uses most of internal RAM (for example, a large LVGL UI). Without this, boot can + fail with an `sdio_mempool_create` assert. Defaults to `false`. ## SPI Transport @@ -110,6 +114,10 @@ wifi: - **frequency** (*Optional*, frequency): The SPI clock frequency. Maximum depends on variant: 10MHz for ESP32, 40MHz for all other variants. Defaults to the maximum for each variant. - **handshake_active_high** (*Optional*, boolean): Polarity of the handshake signal. Defaults to `true`. - **data_ready_active_high** (*Optional*, boolean): Polarity of the data ready signal. Defaults to `true`. +- **use_psram** (*Optional*, boolean): Place the transport buffer pool in PSRAM instead of + internal RAM. Recommended on host chips with DMA-capable PSRAM (ESP32-P4, ESP32-S3) when the + host firmware uses most of internal RAM (for example, a large LVGL UI). Without this, boot can + fail with an `sdio_mempool_create` assert. Defaults to `false`. ## Updating co-processor firmware From cf2994c5b70a2ec395465db6c2b1b3a7623d3866 Mon Sep 17 00:00:00 2001 From: Jonathan Swoboda <154711427+swoboda1337@users.noreply.github.com> Date: Mon, 25 May 2026 09:07:16 -0400 Subject: [PATCH 2/2] [esp32_hosted] Clarify use_psram PSRAM requirement and transport assert name --- src/content/docs/components/esp32_hosted.mdx | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/content/docs/components/esp32_hosted.mdx b/src/content/docs/components/esp32_hosted.mdx index fed64e03d2..0d91d80b44 100644 --- a/src/content/docs/components/esp32_hosted.mdx +++ b/src/content/docs/components/esp32_hosted.mdx @@ -70,10 +70,10 @@ wifi: - **sdio_frequency** (*Optional*, frequency): Set the speed of communication between the host and the co-processor. If you experience loss of communication, or reboots, then try reducing this value. The value can be between 400kHz and 50MHz, with a default of 40MHz. -- **use_psram** (*Optional*, boolean): Place the transport buffer pool in PSRAM instead of - internal RAM. Recommended on host chips with DMA-capable PSRAM (ESP32-P4, ESP32-S3) when the - host firmware uses most of internal RAM (for example, a large LVGL UI). Without this, boot can - fail with an `sdio_mempool_create` assert. Defaults to `false`. +- **use_psram** (*Optional*, boolean): Place the SDIO transport buffer pool in PSRAM instead of + internal RAM. Requires the host MCU to have DMA-capable PSRAM enabled (ESP32-P4, ESP32-S3). + Recommended when the host firmware uses most of internal RAM (for example, a large LVGL UI); + without it, boot can fail with an `sdio_mempool_create` assert. Defaults to `false`. ## SPI Transport @@ -114,10 +114,10 @@ wifi: - **frequency** (*Optional*, frequency): The SPI clock frequency. Maximum depends on variant: 10MHz for ESP32, 40MHz for all other variants. Defaults to the maximum for each variant. - **handshake_active_high** (*Optional*, boolean): Polarity of the handshake signal. Defaults to `true`. - **data_ready_active_high** (*Optional*, boolean): Polarity of the data ready signal. Defaults to `true`. -- **use_psram** (*Optional*, boolean): Place the transport buffer pool in PSRAM instead of - internal RAM. Recommended on host chips with DMA-capable PSRAM (ESP32-P4, ESP32-S3) when the - host firmware uses most of internal RAM (for example, a large LVGL UI). Without this, boot can - fail with an `sdio_mempool_create` assert. Defaults to `false`. +- **use_psram** (*Optional*, boolean): Place the SPI transport buffer pool in PSRAM instead of + internal RAM. Requires the host MCU to have DMA-capable PSRAM enabled (ESP32-P4, ESP32-S3). + Recommended when the host firmware uses most of internal RAM (for example, a large LVGL UI); + without it, boot can fail with an `spi_mempool_create` assert. Defaults to `false`. ## Updating co-processor firmware