Skip to content

esp32: Update the README details to account for newer chips. #17777

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

projectgus
Copy link
Contributor

Summary

Noted while adding C2 support in #15906 that some of the points in the README are a little out of date. spun out to its own PR to avoid clogging up that PR, but should be merged after #15906 as it refers to ESP32-C2 in the new text.

This PR also adds some recommendation on which ESP32 board to pick, as we occasionally see issues or questions that would be non-issues on a board with more RAM (and for small production or personal projects the savings of picking a cheaper ESP32 chip are basically neglible).

This work was funded through GitHub Sponsors.

Noted while adding C2 support that some of these comments are a bit out of
date. Spun out to its own commit.

This work was funded through GitHub Sponsors.

Signed-off-by: Angus Gratton <angus@redyak.com.au>
@projectgus projectgus force-pushed the esp32/readme_tweaks branch from f83e250 to c0648b8 Compare July 29, 2025 00:29
- The machine module with GPIO, UART, SPI, software I2C, ADC, DAC, PWM,
TouchPad, WDT and Timer.
- The network module with WLAN (WiFi) support.
- Bluetooth low-energy (BLE) support via the bluetooth module.

Initial development of this ESP32 port was sponsored in part by Microbric Pty Ltd.

Choosing Correct Chip
Copy link
Member

Choose a reason for hiding this comment

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

Suggest "Choosing the correct chip" or "Choosing a chip"

ESP32 chips are not all the same. The different ESP32 families have different
capabilities and resources available. In particular, the ESP32-C2 and ESP32-S2
(without external SPIRAM) have the least RAM. They can still run MicroPython
well but may run out of RAM if a program uses a lot of resources (i.e. if it
Copy link
Member

Choose a reason for hiding this comment

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

Suggest removing the parenthesis for this last sentence (it's important information), and changing "ie" to "eg".


The supported ESP32 chip with the most hardware resources is the ESP32-S3 with
external SPIRAM included (usually 2MB, 4MB, or 8MB).

Copy link
Member

Choose a reason for hiding this comment

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

Is it worth mentioning some other higher-level items, eg native USB, WiFi and BLE support? Also the CPU architecture?

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