Skip to content

esp32: Enable SPIRAM & disable free_ram optimisation for ESP32_GENERIC_C5. #19303

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.

Sign up for GitHub

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
projectgus wants to merge 4 commits into
base: master
Choose a base branch
from
+18 −17
Open

esp32: Enable SPIRAM & disable free_ram optimisation for ESP32_GENERIC_C5. #19303

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
4f12e57
esp32: Remove ESP32-S2 & S3-specific default spiram config items.
projectgus Jun 4, 2026
b721ee4
esp32: Don't enable the free_ram config for ESP32_GENERIC_C5.
projectgus Jun 4, 2026
9b0344f
esp32: Enable PSRAM support on ESP32_GENERIC_C5.
projectgus Jun 4, 2026
3f5247a
esp32: Rename the sdkconfig.spiram_xxx config snippets.
projectgus Jun 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion ports/esp32/boards/ESP32_GENERIC/mpconfigvariant_SPIRAM.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
list(APPEND SDKCONFIG_DEFAULTS
boards/sdkconfig.spiram
boards/sdkconfig.spiram_esp32
)

list(APPEND MICROPY_DEF_BOARD
Expand Down
6 changes: 5 additions & 1 deletion ports/esp32/boards/ESP32_GENERIC_C5/board.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,2 +1,6 @@
The following files are firmware images that should work on most ESP32-C5-based
boards with at least 4MiB of flash and 40MHz/48MHz crystal frequency.
boards with at least 4MiB of flash and 40MHz/48MHz crystal frequency.

This firmware supports configurations with and without SPIRAM (also known as
PSRAM) and will auto-detect a connected SPIRAM chip at startup and allocate
the MicroPython heap accordingly.
2 changes: 1 addition & 1 deletion ports/esp32/boards/LILYGO_T3_S3/mpconfigboard.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ set(SDKCONFIG_DEFAULTS
boards/sdkconfig.base
boards/sdkconfig.ble
boards/sdkconfig.240mhz
boards/sdkconfig.spiram_sx
boards/sdkconfig.spiram_quad
boards/sdkconfig.flash_qio_80m
${MICROPY_BOARD_DIR}/sdkconfig.board
)
Expand Down
2 changes: 1 addition & 1 deletion ports/esp32/boards/M5STACK_ATOMS3_LITE/mpconfigboard.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@ include(boards/mpconfigboard_esp32s3_common.cmake)
list(APPEND SDKCONFIG_DEFAULTS boards/sdkconfig.flash_qio_80m)

# This board has no PSRAM
list(REMOVE_ITEM SDKCONFIG_DEFAULTS boards/sdkconfig.spiram_sx)
list(REMOVE_ITEM SDKCONFIG_DEFAULTS boards/sdkconfig.spiram_quad)
2 changes: 1 addition & 1 deletion ports/esp32/boards/SIL_MANT1S/mpconfigboard.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
include(boards/mpconfigboard_esp32_common.cmake)

list(APPEND SDKCONFIG_DEFAULTS
boards/sdkconfig.spiram
boards/sdkconfig.spiram_esp32
boards/sdkconfig.240mhz
boards/sdkconfig.flash_qio_80m
boards/SIL_MANT1S/sdkconfig.board
Expand Down
3 changes: 1 addition & 2 deletions ports/esp32/boards/SPARKFUN_THINGPLUS_ESP32C5/mpconfigboard.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
include(boards/mpconfigboard_esp32c5_common.cmake)

list(APPEND SDKCONFIG_DEFAULTS
boards/sdkconfig.flash_qio_80m
boards/sdkconfig.spiram)
boards/sdkconfig.flash_qio_80m)

set(MICROPY_FROZEN_MANIFEST ${MICROPY_BOARD_DIR}/manifest.py)
2 changes: 1 addition & 1 deletion ports/esp32/boards/UM_TINYPICO/mpconfigboard.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ include(boards/mpconfigboard_esp32_common.cmake)

list(APPEND SDKCONFIG_DEFAULTS
boards/sdkconfig.240mhz
boards/sdkconfig.spiram
boards/sdkconfig.spiram_esp32
boards/sdkconfig.flash_qio_80m
boards/UM_TINYPICO/sdkconfig.board
)
Expand Down
2 changes: 1 addition & 1 deletion ports/esp32/boards/mpconfigboard_esp32c5_common.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,5 @@ set(SDKCONFIG_DEFAULTS
boards/sdkconfig.riscv
boards/sdkconfig.ble
boards/sdkconfig.240mhz
boards/sdkconfig.free_ram
boards/sdkconfig.spiram_quad
)
2 changes: 1 addition & 1 deletion ports/esp32/boards/mpconfigboard_esp32s2_common.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@ set(IDF_TARGET esp32s2)

set(SDKCONFIG_DEFAULTS
boards/sdkconfig.base
boards/sdkconfig.spiram_sx
boards/sdkconfig.spiram_quad
)
2 changes: 1 addition & 1 deletion ports/esp32/boards/mpconfigboard_esp32s3_common.cmake
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,5 @@ set(IDF_TARGET esp32s3)
set(SDKCONFIG_DEFAULTS
boards/sdkconfig.base
boards/sdkconfig.ble
boards/sdkconfig.spiram_sx
boards/sdkconfig.spiram_quad
)
3 changes: 2 additions & 1 deletion ports/esp32/boards/sdkconfig.spiram → ports/esp32/boards/sdkconfig.spiram_esp32
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
# MicroPython on ESP32, ESP IDF configuration with SPIRAM support
# Extra ESP-IDF config for PSRAM (SPIRAM) support on original ESP32
# (includes workarounds not needed on other chips, which should use sdkconfig.spiram_quad.)

CONFIG_SPIRAM=y
CONFIG_SPIRAM_CACHE_WORKAROUND=y
Expand Down
2 changes: 1 addition & 1 deletion ports/esp32/boards/sdkconfig.spiram_oct
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# MicroPython on ESP32-S2 and ESP32-PAD1_subscript_3, ESP IDF configuration with SPIRAM support in Octal mode
# Extra ESP-IDF config for Octal mode PSRAM (SPIRAM) support on ESP32-S3
CONFIG_SPIRAM_MODE_QUAD=
CONFIG_SPIRAM_MODE_OCT=y
5 changes: 1 addition & 4 deletions ports/esp32/boards/sdkconfig.spiram_sx → ports/esp32/boards/sdkconfig.spiram_quad
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# MicroPython on ESP32-S2 and ESP32-PAD1_subscript_3, ESP IDF configuration with SPIRAM support
# Extra ESP-IDF config for Quad mode PSRAM (SPIRAM) support on ESP32-C5, ESP32-S2 & ESP32-S3
CONFIG_SPIRAM_MODE_QUAD=y
CONFIG_SPIRAM_TYPE_AUTO=y
CONFIG_SPIRAM_CLK_IO=30
CONFIG_SPIRAM_CS_IO=26
CONFIG_SPIRAM_SPEED_80M=y
CONFIG_SPIRAM=y
CONFIG_SPIRAM_BOOT_INIT=y
Expand Down
Loading