Skip to content

[esp32_hosted] Document use_psram option#6688

Open
swoboda1337 wants to merge 2 commits into
esphome:nextfrom
swoboda1337:esp32-hosted-use-psram
Open

[esp32_hosted] Document use_psram option#6688
swoboda1337 wants to merge 2 commits into
esphome:nextfrom
swoboda1337:esp32-hosted-use-psram

Conversation

@swoboda1337
Copy link
Copy Markdown
Member

Description

Documents the new `use_psram` boolean option on the `esp32_hosted` component, which places the transport buffer pool in PSRAM instead of internal RAM. Required on memory-tight host configs (e.g. ESP32-P4 with large LVGL UI) where the internal-RAM mempool allocation fails at boot with `sdio_mempool_create` assert.

Related issue (if applicable): fixes esphome/esphome#16574

Pull request in esphome with YAML changes (if applicable):

Checklist

  • I am merging into `next` because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • I am merging into `current` because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • Link added in `/src/content/docs/components/index.mdx` when creating new documents for new components or cookbook.

@netlify
Copy link
Copy Markdown

netlify Bot commented May 25, 2026

Deploy Preview for esphome ready!

Name Link
🔨 Latest commit cf2994c
🔍 Latest deploy log https://app.netlify.com/projects/esphome/deploys/6a144989fd384c0008dc3a5a
😎 Deploy Preview https://deploy-preview-6688--esphome.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation for the new use_psram option on the esp32_hosted component, explaining when to use it to avoid transport buffer pool allocation failures on memory-constrained host builds.

Changes:

  • Documented use_psram for SDIO transport configuration variables.
  • Documented use_psram for SPI transport configuration variables.

Comment thread src/content/docs/components/esp32_hosted.mdx Outdated
Comment thread src/content/docs/components/esp32_hosted.mdx Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants