[esp32] Add per-variant reference sections to ESP32 platform docs by Copilot · Pull Request #6301 · esphome/esphome-docs

Copilot · 2026-03-18T18:56:11Z

The ESP32 platform page listed supported variants only as a comma-separated string in the variant config option, with no description of what each chip offers.

Adds a Variants section near the top of the ESP32 platform page with a subsection for each of the 10 supported variants. Each entry includes:

Short prose description (positioning, key differentiators)
Feature bullet list: CPU architecture/speed, Wi-Fi standard, Bluetooth/BLE version, 802.15.4 support, USB type, Ethernet support, GPIO count, peripheral counts (UART/I2C/SPI/I2S), ADC/DAC channels
Notable capabilities called out where relevant (built-in Ethernet MAC, AI vector instructions, MIPI DSI/CSI, capacitive touch, LP coprocessor)

Ethernet is listed for every variant: ESP32 and ESP32-P4 have a built-in Ethernet MAC (requiring an external PHY); all other variants note that only SPI-based Ethernet controllers are supported.

Original prompt

This section details on the original issue you should resolve

<issue_title>Add sections for each ESP32 variant on the ESP32 documentation</issue_title>
<issue_description>Have a section on the ESP32 documentation with a small description and feature list for each supported variant.</issue_description>

<agent_instructions>Create a header for each variant on the esp32 platform page that has a short description of the variant, and a bullet list of the features it has, wifi, bluetooth, ble, usb cdc/tinyusb, number of spi, uart, i2c etc</agent_instructions>

Comments on the Issue (you are @copilot in this section)

Fixes Add sections for each ESP32 variant on the ESP32 documentation backlog#107

📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.

Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

netlify · 2026-03-18T18:59:33Z

✅ Deploy Preview for esphome ready!

Name	Link
🔨 Latest commit	`eaf6626`
🔍 Latest deploy log	https://app.netlify.com/projects/esphome/deploys/69bbce2652eaa200080044f9
😎 Deploy Preview	https://deploy-preview-6301--esphome.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

src/content/docs/components/esp32.mdx

… Ethernet to all variants Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

jesserockz

Lets move these new sections between config and framework

Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

Copilot · 2026-03-18T23:00:13Z

Lets move these new sections between config and framework

Done in 1f86341. The Variants section now sits between Configuration variables and Framework.

Copilot

Pull request overview

Adds a new Variants reference section to the ESP32 platform documentation to provide per-chip guidance beyond the existing comma-separated variant list.

Changes:

Added a new “Variants” section with subsections for each supported ESP32 variant.
Documented key differentiators and a feature/peripheral summary per variant.
Clarified Ethernet support expectations per variant (built-in MAC vs. SPI-based controllers).

You can also share your feedback on Copilot code review. Take the survey.

src/content/docs/components/esp32.mdx

+ESPHome supports the following ESP32 variants. Use the `variant` configuration option to select the correct one
+for your hardware.
+


src/content/docs/components/esp32.mdx

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Keith Burzinski <kbx81x@gmail.com>

clydebarrow · 2026-03-19T02:08:35Z

src/content/docs/components/esp32.mdx

+- **CPU:** Xtensa LX7 single-core, up to 240 MHz
+- **Wi-Fi:** 802.11 b/g/n 2.4 GHz
+- **Bluetooth:** None
+- **USB:** Native USB OTG (CDC/TinyUSB)


The OTG USB doesn't use TinyUSB and isn't restricted to CDC

Suggested change

- **USB:** Native USB OTG (CDC/TinyUSB)

- **USB:** Native USB OTG host mode (Full Speed); CDC/TinyUSB peripheral mode.

Applied in 7a58a2b.

clydebarrow · 2026-03-19T02:09:13Z

src/content/docs/components/esp32.mdx

+- **CPU:** Xtensa LX7 dual-core, up to 240 MHz
+- **Wi-Fi:** 802.11 b/g/n 2.4 GHz
+- **Bluetooth:** BLE 5.0
+- **USB:** Native USB OTG (CDC/TinyUSB) + USB Serial/JTAG


Suggested change

- **USB:** Native USB OTG (CDC/TinyUSB) + USB Serial/JTAG

- **USB:** Native USB OTG host mode (Full Speed); USB Serial/JTAG peripheral mode

Applied in 7a58a2b.

clydebarrow · 2026-03-19T02:10:49Z

src/content/docs/components/esp32.mdx

+- **CPU:** RISC-V HP dual-core @ up to 400 MHz + LP core @ up to 40 MHz
+- **Wi-Fi:** None (requires co-processor via ESP-Hosted)
+- **Bluetooth:** None (requires co-processor via ESP-Hosted)
+- **USB:** Hi-Speed USB OTG (CDC/TinyUSB) + USB Serial/JTAG


Suggested change

- **USB:** Hi-Speed USB OTG (CDC/TinyUSB) + USB Serial/JTAG

- **USB:** Native USB OTG host mode (Full Speed + High Speed); USB Serial/JTAG peripheral mode

Applied in 7a58a2b.

jesserockz

See the suggestions above

esphome · 2026-03-19T07:18:57Z

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

…uggestions Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

Copilot · 2026-03-19T07:20:28Z

See the suggestions above

All three USB description suggestions from @clydebarrow applied in 7a58a2b.

Initial plan

a95b0b7

Copilot AI assigned Copilot and jesserockz Mar 18, 2026

Copilot started work on behalf of jesserockz March 18, 2026 18:56 View session

Add Variants section to ESP32 platform documentation

a7e4bb4

Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add sections for each ESP32 variant on documentation~~ [esp32] Add per-variant reference sections to ESP32 platform docs Mar 18, 2026

esphome bot added the current label Mar 18, 2026

Copilot AI requested a review from jesserockz March 18, 2026 19:00

Copilot finished work on behalf of jesserockz March 18, 2026 19:00

jesserockz requested changes Mar 18, 2026

View reviewed changes

src/content/docs/components/esp32.mdx Outdated Show resolved Hide resolved

src/content/docs/components/esp32.mdx Outdated Show resolved Hide resolved

src/content/docs/components/esp32.mdx Outdated Show resolved Hide resolved

Copilot started work on behalf of jesserockz March 18, 2026 19:05 View session

Address PR review: remove span anchor, remove Frameworks bullets, add…

cdde2b1

… Ethernet to all variants Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

Copilot AI requested a review from jesserockz March 18, 2026 19:14

Copilot finished work on behalf of jesserockz March 18, 2026 19:14

jesserockz requested changes Mar 18, 2026

View reviewed changes

Copilot started work on behalf of jesserockz March 18, 2026 22:57 View session

Move Variants section between Configuration variables and Framework

1f86341

Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

Copilot AI requested a review from jesserockz March 18, 2026 23:00

Copilot finished work on behalf of jesserockz March 18, 2026 23:00

jesserockz marked this pull request as ready for review March 18, 2026 23:36

Copilot AI review requested due to automatic review settings March 18, 2026 23:36

jesserockz approved these changes Mar 18, 2026

View reviewed changes

Copilot AI reviewed Mar 18, 2026

View reviewed changes

kbx81 reviewed Mar 19, 2026

View reviewed changes

src/content/docs/components/esp32.mdx Outdated Show resolved Hide resolved

copy

11ab4af

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Keith Burzinski <kbx81x@gmail.com>

clydebarrow reviewed Mar 19, 2026

View reviewed changes

jesserockz requested changes Mar 19, 2026

View reviewed changes

esphome bot marked this pull request as draft March 19, 2026 07:18

Copilot started work on behalf of jesserockz March 19, 2026 07:19 View session

Update USB descriptions for ESP32-S2, ESP32-S3, ESP32-P4 per review s…

7a58a2b

…uggestions Co-authored-by: jesserockz <3060199+jesserockz@users.noreply.github.com>

Copilot AI requested a review from jesserockz March 19, 2026 07:20

Copilot finished work on behalf of jesserockz March 19, 2026 07:20

Merge branch 'current' into copilot/add-esp32-variant-sections

eaf6626

		ESPHome supports the following ESP32 variants. Use the `variant` configuration option to select the correct one
		for your hardware.

	- USB: Native USB OTG (CDC/TinyUSB)
	- USB: Native USB OTG host mode (Full Speed); CDC/TinyUSB peripheral mode.

	- USB: Native USB OTG (CDC/TinyUSB) + USB Serial/JTAG
	- USB: Native USB OTG host mode (Full Speed); USB Serial/JTAG peripheral mode

	- USB: Hi-Speed USB OTG (CDC/TinyUSB) + USB Serial/JTAG
	- USB: Native USB OTG host mode (Full Speed + High Speed); USB Serial/JTAG peripheral mode

Uh oh!

Conversation

Copilot AI commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Comments on the Issue (you are @copilot in this section)

Uh oh!

netlify bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for esphome ready!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jesserockz left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Mar 18, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

clydebarrow Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

clydebarrow Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

clydebarrow Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 19, 2026

Choose a reason for hiding this comment

Uh oh!

jesserockz left a comment

Choose a reason for hiding this comment

Uh oh!

esphome bot commented Mar 19, 2026

Uh oh!

Copilot AI commented Mar 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Copilot AI commented Mar 18, 2026 •

edited

Loading

netlify bot commented Mar 18, 2026 •

edited

Loading