esp-idf/examples/storage/partition_api/partition_mmap
Martin Vychodil af81bd1b0a Storage: Partition APIs moved to the new component 'esp_partition'
All the partition handling API functions and data-types were moved from the 'spi_flash' component to the new one named 'esp_partition'. See Storage 5.x migration guide for more details
2022-11-02 21:49:08 +01:00
..
main Storage: Partition APIs moved to the new component 'esp_partition' 2022-11-02 21:49:08 +01:00
CMakeLists.txt tools: Increase the minimal supported CMake version to 3.16 2022-06-01 06:35:02 +00:00
partitions_example.csv global: update note in the partition tables 2019-07-27 10:28:16 +02:00
pytest_partition_mmap_example.py storage examples migrated to pytest 2022-07-22 10:23:53 +02:00
README.md docs: changes docs supported targets tables 2022-07-14 08:26:32 +08:00
sdkconfig.ci example_tests: Deletes usage esp32c3 ECO0 in CI (by default ECO3) 2021-09-24 13:55:07 +08:00
sdkconfig.defaults examples: remove non-existent options from sdkconfig.defaults 2019-07-29 04:57:38 +02:00

Supported Targets ESP32 ESP32-C3 ESP32-S2 ESP32-S3

Partition Memory Map Example

This example demonstrates how to use esp_partition_mmap to configure MMU and map a partition into memory address space for read operations.

Example Flow

The example uses a custom partition table, with a data partition storage used for demonstration. Before mapping this partition to memory, data is written to the partition used for verification.

The partition API function esp_partition_mmap is used to get a pointer to the mapped memory region and a handle to the mapping. The pointer is used to transparently read back the verification data written previously. Once the data written and read are verified to be the same, the function spi_flash_munmap is used to release the mapping.

Output

I (309) example: Written sample data to partition: ESP-IDF Partition Memory Map Example
I (309) example: Mapped partition to data memory address 0x3f410000
I (319) example: Read sample data from partition using mapped memory: ESP-IDF Partition Memory Map Example
I (329) example: Data matches
I (329) example: Unmapped partition from data memory
I (339) example: Example end

Others

Detailed functional description of partition API is provided in documentation.

See the README.md file in the upper level 'examples' directory for more information about examples.