Skip to content

Conversation

@bdraco
Copy link
Member

@bdraco bdraco commented Dec 28, 2025

Description:

Document the new minimum_chip_revision option for ESP32 and the chip revision logging at startup.

This option allows users to specify the minimum ESP32 chip revision required for their firmware. Setting it to 3.0 or higher:

  • Reduces flash size by excluding workaround code for older chip bugs
  • For PSRAM users: Saves significant IRAM by keeping C library functions in ROM

The chip revision is now also logged at startup (e.g., ESP32 Chip: ESP32 r3.0, 2 core(s)) so users can easily identify their chip revision.

Related issue (if applicable): N/A

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 /components/_index.md when creating new documents for new components or cookbook.

@netlify
Copy link

netlify bot commented Dec 28, 2025

Deploy Preview for esphome ready!

Name Link
🔨 Latest commit 72e37d4
🔍 Latest deploy log https://app.netlify.com/projects/esphome/deploys/6951bc315ec4b2000899244c
😎 Deploy Preview https://deploy-preview-5828--esphome.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@bdraco bdraco marked this pull request as ready for review December 29, 2025 00:10
Copilot AI review requested due to automatic review settings December 29, 2025 00:10
Copy link
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

Documents the new minimum_chip_revision configuration option for ESP32 and the chip revision logging feature added at startup.

Key Changes

  • Added minimum_chip_revision option for ESP32 to specify minimum required chip revision
  • Documented flash size and IRAM savings benefits for revision 3.0+
  • Included instructions for finding chip revision via boot logs or esptool

@swoboda1337 swoboda1337 merged commit 3c3d76e into next Jan 5, 2026
14 checks passed
@swoboda1337 swoboda1337 deleted the min_chip_revision branch January 5, 2026 14:02
@github-actions github-actions bot locked and limited conversation to collaborators Jan 7, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants