ESP32’s Family Memory Map 101
The performance and memory capabilities of the microcontrollers are increasing, and so is their complexity, especially when the users are responsible for mapping external memory chips such as Flash or SPIRAM by configuring a memory management unit.
When I started to use Espressif ESP32’s series SoC’s with the Zephyr RTOS, quickly I realized that these SoC’s are a very different world, compared to my previous MCU experiences, which were mostly ARM-related. ARM Cortex-M’s - in most cases - uses Von-Neumann memory architecture, while the ESP32’s series of microcontrollers uses the Harvard memory architecture, which adds complexity.
The primary source of knowledge about any SoC was always the datasheet or Technical Reference Manual of the part. Indeed it still is, but I found the ESP32's TRM — although very useful — quite challenging to read. Especially because there is a significant portion of important information buried in the long textual descriptions.
This sparked the motivation to compile a visually rich and informative depiction of crucial information from the current versions of a TRM. This is intended to be used together with the SoC’s datasheets and TRM to help with a better understanding of the ESP32's family SoCs internals, which is crucial during the system and driver development - for example when porting to other platforms such as Zephyr RTOS.
Table of contents:
· ESP32
∘ ROM
∘ SRAM
∘ RTC-SRAM
∘ Instruction & data cache
∘ Peripherals
∘ eFuse blocks
· ESP32-S2
∘ ROM
∘ SRAM
∘ RTC-SRAM
∘ Instruction & data cache
∘ Peripherals
∘ eFuse blocks
· ESP32-S3
∘ ROM
∘ SRAM
∘ RTC-SRAM
∘ Instruction & data cache
∘ Peripherals
∘ eFuse blocks
· ESP32-C3
∘ ROM
∘ SRAM
∘ RTC-SRAM
∘ Instruction & data cache
∘ Peripherals
∘ eFuse blocks
· ESP32-C6
∘ ROM
∘ SRAM
∘ Instruction & data cache
∘ Peripherals
∘ eFuse blocks
· Downloads
· Conclusion
ESP32
The ESP32 is the Xtensa LX6 dual-core microcontroller, and it is the oldest SoC from the ESP32’s family of MCUs.
The SoC has access to external Flash memory using the SPI interface. It can also access the external SPIRAM, but only on the data bus.
Zephyr-RTOS support for the ESP32 devkit board can be found here.
ROM
ROM memories hold the primary bootloader code and other library functions available to the end users. The content of the ROM memories is baked during the manufacturing process and cannot be changed. Please refer to the ECO versions of the ESP32 microcontroller for more detailed information. TLDR is to use the last ECOv3 and later ESP32 chip versions.
SRAM
The ESP32 has three internal SRAM modules. The SRAM0 is 192kB, and it can be configured to use the first 64kB as MMU cache for the external memory access. When not used as a cache, the first 64kB can be read and written by either CPU from the instruction bus.
The capacity of Internal SRAM1 is 128 KB. Either CPU can read and write this memory using the data and instruction bus.
The address ranges of the instruction and the data bus are in reverse order (word-wise).
RTC-SRAM
RTC-Fast Memory can be read and written by PRO_CPU only, at a given address range on the data bus or at the instruction bus. Unlike most other memory regions, RTC Fast memory cannot be accessed by the APP_CPU.
RTC-Slow memory is r/w memory that can be accessed by either CPU via the instruction and data bus.
The RTC memories can hold the data during the deep sleep period.
Instruction & data cache
The instruction and data cache address space is a virtual address space where the external memories such as Flash or SPIRAM modules can be accessed by the instruction or the data bus.
Peripherals
The ESP32 has 41 peripherals. Nearly all peripheral modules can be accessed by either CPU at the same address with a single exception of the PID controller which exists for each CPU and can be accessed only by its own CPU.
eFuse blocks
The eFuse memory is the OTP memory where hardware and encryption settings are stored. Fundamentally, an eFuse is a single bit of non-volatile memory with the restriction that once an eFuse bit is programmed to 1, it can never be reverted to 0.
For further information and all the details about the ESP32 SoC please refer to the latest ESP32 Technical Reference Manual.
ESP32-S2
The ESP32-S2 microcontroller is the successor of ESP32 and although very similar it has a single core and slightly different memory composition.
One of the improvements from ESP32 is the ability to access external SPI-ram on data and instruction buses, which means it can run programs and access the data.
Zephyr-RTOS support for the ESP32-S2 devkit board can be found here.
ROM
ROM memories hold the primary bootloader code and other library functions available to the end users. The content of the ROM memories is baked during the manufacturing process and cannot be changed.
SRAM
The ESP32-S2 consists of SRAM0 which can be configured as a hardware cache to access external memories. SRAM1 is r/w memory space addressed by the CPU on the data and instruction bus in the same order.
RTC-SRAM
RTC-Slow memory can be accessed by the CPU via the instruction and data bus. But is also accessible via the peripheral bus 1 and 2.
RTC-Fast is r/w memory that can be accessed by the CPU via the instruction and data bus.
Instruction & data cache
The CPU accesses the external memories using the cache. Up to 7.5MB of address space can be accessed via the I-cache. Up to 4MB of address space can be used to access the I-Cache as read-only via the data bus. Up to 10.5MB of address space can be used to access the external Flash or SPIRAM.
Peripherals
Peripherals on ESP32-S2 are accessed using two peripheral busses: PeriBus1 and PeriBus2. Each has its own address space at the data bus.
The PeriBus1 features speculative reads to improve performance. This also means that not every access is valid. Therefore we need to use the volatile statement, or access registers such as FIFOs using the PeriBus2, which is slower but safe.
eFuse blocks
The eFuse memory consists of 4096 bits of OTP memory where hardware and encryption settings are stored. Fundamentally, an eFuse is a single bit of non-volatile memory with the restriction that once an eFuse bit is programmed to 1, it can never be reverted to 0.
For further information and all the details about the ESP32-S2 SoC please refer to the latest ESP32-S2 Technical Reference Manual.
ESP32-S3
The ESP32-S3 is the latest Xtensa LX7 CPU with a dual-core design. Besides two main cores, it has two ultra-low-power coprocessors based on Risc-V architecture. The SoC has a built-in JTAG debugger accessible via a USB interface. It can access external SPIRAM on data and instruction buses, which means it can run programs and access the data.
Zephyr-RTOS support for the ESP32-S3 devkit board can be found here.
ROM
ROM memories hold the primary bootloader code and other library functions available to the end users. The content of the ROM memories is baked during the manufacturing process and cannot be changed.
SRAM
There are three internal SRAM modules. The SRAM0 can be configured as an I-Cache buffer to access instructions from external memory or be used as static r/w memory via the instruction bus. SRAM1 is the r/w memory which can be accessed via the instruction and data bus. SRAM2 can be configured as D-Cache, or it can be accessed as static r/w memory via the data bus
RTC-SRAM
RTC-Slow is r/w memory that can be accessed via the instruction and data bus. RTC-Fast is the r/w memory that can be accessed via the instruction and data bus on a given address range.
Instruction & data cache
The CPUs can access external memories via the cached MMU address space. Memories can be accessed using I-Cache or D-Dache via instruction or data bus respectively.
Peripherals
The peripherals (modules) can be accessed at their address range using the data and instruction bus. Each peripheral module has its own memory boundaries given by its base address and block size. Blocks size is usually 4kB long. For more details refer to device TRM.
eFuse blocks
The eFuse memory consists of 4096 bits of OTP memory where hardware and encryption settings are stored. Fundamentally, an eFuse is a single bit of non-volatile memory with the restriction that once an eFuse bit is programmed to 1, it can never be reverted to 0.
For further information and all the details about the ESP32-S3 SoC please refer to the latest ESP32-S3 Technical Reference Manual.
ESP32-C3
The ESP32-C3 is a 32-bit RISC-V microcontroller with the “IMC” extensions. The address space of ESP32-C3 is significantly simpler compared to its Xtensa counterparts. It supports JTAG debugging via the on-chip USB interface.
Zephyr-RTOS support for the ESP32-C3 devkit board can be found here.
ROM
ROM memories hold the primary bootloader code and other library functions available to the end users. The content of the ROM memories is baked during the manufacturing process and cannot be changed.
SRAM
The ESP32-C3 has two SRAM modules. SRAM1 can be configured as the instruction cache buffer, or accessed as static r/w memory. The SRAM1 is a general-purpose r/w memory that can be accessed via instruction and data bus.
RTC-SRAM
RTC-Fast memory is r/w memory that can be accessed via CPU instruction and data bus.
Instruction & data cache
The ESP32-C3 supports SPI, dual-SPI, quad-SPI, and QPI interfaces to access the external Flash memory. It supports manual encryption and automatic decryption. The external flash can be accessed by the I-Cache or D-Cache on instruction or data bus respectively.
Peripherals
The CPU can access the peripherals (modules) using the data or instruction bus on a given address space. Each peripheral has its own memory boundaries given by the base address and block size, which is usually 4kB. For details please refer to the TRM.
eFuse blocks
The eFuse memory consists of 4096 bits of OTP memory where hardware and encryption settings are stored. Fundamentally, an eFuse is a single bit of non-volatile memory with the restriction that once an eFuse bit is programmed to 1, it can never be reverted to 0.
For further information and all the details about the ESP32-C3 SoC please refer to the latest ESP32-C3 Technical Reference Manual.
ESP32-C6
The ESP32-C6 is a 32-bit RISC-V microcontroller with the “IMAC” extensions. The address space of ESP32-C6 is also significantly simpler compared to its Xtensa counterparts. It supports JTAG debugging via the on-chip USB interface.
Zephyr-RTOS support for the ESP32-C6 devkit board is in progress.
ROM
ROM memories hold the primary bootloader code and other library functions available to the end users. The content of the ROM memories is baked during the manufacturing process and cannot be changed.
SRAM
The ESP32-C6 has two SRAM modules.
HP-SRAM is static r/w memory that can be accessed by the HP CPU or LP CPU via the data bus or instruction bus in the same order.
LP-SRAM is static r/w memory that can be accessed by the HP CPU or LP CPU via the data bus or instruction bus. It can be accessed using high-speed more or low-speed more.
Instruction & data cache
ESP32-C6 supports SPI, dual-SPI, quad-SPI, or QPI interface to connect external Flash memory. It also supports manual encryption and automatic decryption to protect user data and code.
Peripherals
The CPU can access the peripherals (modules) using the data or instruction bus on a given address space. Each peripheral has its own memory boundaries given by the base address and block size, which is usually 4kB. For details please refer to the TRM.
eFuse blocks
The eFuse memory consists of 4096 bits of OTP memory where hardware and encryption settings are stored. Fundamentally, an eFuse is a single bit of non-volatile memory with the restriction that once an eFuse bit is programmed to 1, it can never be reverted to 0.
For further information and all the details about the ESP32-C6 SoC please refer to the latest ESP32-C6 Technical Reference Manual.
Downloads
Printable versions of the images in PDF format can be downloaded here:
Conclusion
Sometimes, when we need to understand something in-depth, we need to do a deep dive into very technical documents and extract the information in a way that we can use. Technical documents can be challenging to understand, especially when you are not familiar with a particular architecture or if you are not from that specific area. I hope that with this article, you will be able to easily understand the memory map of the ESP32 family and use it as a guide when diving deep into the TRMs and datasheets.
