Writing flash data with PSRAM XIP enabled causes MMAP flash read errors (IDFGH-14084)

[swilson]

Answers checklist.

• I have read the documentation ESP-IDF Programming Guide and the issue is not addressed there.
• I have updated my IDF branch (master or release) to the latest version and checked that the issue is present there.
• I have searched the issue tracker for a similar issue and not found a similar issue.

IDF version.

v5.3.1

Espressif SoC revision.

ESP32-S3 (QFN56) (revision v0.1)

Operating System used.

macOS

How did you build your project?

Command line with idf.py

If you are using Windows, please specify command line type.

None

Development Kit.

ESP32-S3-DevKitC-1 v1.0

Power Supply used.

USB

What is the expected behavior?

mmap flash reads should return correct data

What is the actual behavior?

mmap read returns garbage randomly. Turning off PSRAM XIP (CONFIG_SPIRAM_FETCH_INSTRUCTIONS & CONFIG_SPIRAM_RODATA) seems to avoid the issue. Perhaps because when PSRAM XIP is enabled (aka SPI_FLASH_CACHE_NO_DISABLE) the regular flash APIs use mutex locking, but the MMAP APIs disable the cache?

Steps to reproduce.

main.c.txt

Debug Logs.

I (1556) example: esp_partition_read deadbeefdeadbeefdeadbeefdeadbeef
I (1557) example: mmap read: ESP-IDF Partition Memory Map Example
I (1659) example: mmap read: ESP-IDF Partition Memory Map Example
I (1759) example: mmap read: ESP-IDF Partition Memory Map Example
I (1859) example: mmap read: ESP-IDF Partition Memory Map Example
I (1959) example: mmap read: ESP-IDF Partition Memory Map Example
I (2059) example: mmap read: ESP-IDF Partition Memory Map Example
I (2138) example: esp_partition_read deadbeefdeadbeefdeadbeefdeadbeef
I (2159) example: mmap read: �������������������������������������

More Information.

partitions_example.csv
sdkconfig.txt

[swilson]

This bug was initially discovered when a call to esp_ota_set_boot_partition() (which uses MMAP flash reads) failed while another thread was writing to to a different partition.