[esp32][openthread] Document ESP32-S31/H4/H21 variants#6846
Open
swoboda1337 wants to merge 4 commits into
Open
[esp32][openthread] Document ESP32-S31/H4/H21 variants#6846swoboda1337 wants to merge 4 commits into
swoboda1337 wants to merge 4 commits into
Conversation
This was referenced Jun 24, 2026
swoboda1337
changed the title
18 tasks
Contributor
There was a problem hiding this comment.
Pull request overview
Documents new ESP-IDF 6.1 ESP32 variants (ESP32-S31 / ESP32-H4 / ESP32-H21) across the ESP32 platform docs and related component pages, aligning hardware capability notes (802.15.4, CAN/TWAI controllers, octal SPI) with the new variants.
Changes:
- Extend
esp32.variantandcpu_frequencydocumentation to include ESP32-S31/H4/H21, and add per-variant capability sections. - Update OpenThread and Zigbee docs to list ESP32-S31/H4/H21 as 802.15.4-capable platforms.
- Update CAN bus and SPI docs to reflect ESP32-S31’s additional CAN controller and octal SPI support.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| src/content/docs/components/zigbee.mdx | Updates supported ESP32 hardware list to include H4/H21/S31 as 802.15.4-capable. |
| src/content/docs/components/spi.mdx | Adds ESP32-S31 to the list of variants supporting octal SPI. |
| src/content/docs/components/openthread.mdx | Expands ESP32 802.15.4 radio variant list to include H4/H21/S31. |
| src/content/docs/components/esp32.mdx | Adds new variant identifiers, CPU frequency options, and detailed capability sections for S31/H4/H21. |
| src/content/docs/components/canbus/esp32_can.mdx | Notes ESP32-S31 has multiple TWAI controllers and adds it to the multi-controller list. |
4 tasks
Adds the three IDF 6.1 variants to the esp32 platform variant list and cpu_frequency table, adds per-variant capability sections, and lists them as Thread/Zigbee-capable (all three have an 802.15.4 radio per soc_caps). Companion to esphome/esphome#16700 and esphome/esphome#17186.
swoboda1337
force-pushed
the
esp32-new-variants-docs
branch
from
b4e2f08 to
7b5bd26
Compare
swoboda1337
changed the title
✅ Deploy Preview for esphome ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
esphome
Bot
added
component: openthread
component: wifi
component: zigbee
and removed
component: logger
component: esp32
labels
✅ Deploy Preview for esphome ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for esphome ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for esphome ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview for esphome ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
swoboda1337
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Documents the new ESP-IDF 6.1 ESP32 variants (ESP32-S31, ESP32-H4, ESP32-H21) on the radio-related pages: the
esp32variant list /cpu_frequencyranges / per-variant capability sections, and OpenThread support (all three have an 802.15.4 radio).Zigbee was dropped:
esp-zigbee-lib/esp-zboss-libhave no prebuilt library for these variants yet (the lib errorstarget ... is not supported), so zigbee can't build on them — matching the esphome PR which also dropped zigbee.Related issue (if applicable): N/A
Pull request in esphome with YAML changes (if applicable):
Checklist
I am merging into
nextbecause this is new documentation that has a matching pull-request in esphome as linked above.or
I am merging into
currentbecause 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.mdxwhen creating new documents for new components or cookbook.