ESP_MMU_MMAP_FLAG_PADDR_SHARED macro

MMU Memory Mapping Driver APIs for MMU supported memory Driver Backgrounds: -------------------------------------------------------------------------------------------------------- Memory Pool | -------------------------------------------------------------------------------------------------------- | Memory Region 0 | Memory Region 1 | ... | -------------------------------------------------------------------------------------------------------- | Block 0 | Slot 0 | Block 1 | Block 2 | ... | Slot 1 (final slot) | ... | -------------------------------------------------------------------------------------------------------- - A memory pool stands for the whole virtual address range that can be mapped to physical memory - A memory region is a range of virtual address with same attributes - A block is a piece of vaddr range that is dynamically mapped. - A Slot is the vaddr range between 2 blocks. MMAP flags Share this mapping - If this flag is set, a paddr block can be mapped to multiple vaddr blocks. 1. This happens when: - the to-be-mapped paddr block is overlapped with an already mapped paddr block. - the to-be-mapped paddr block encloses an already mapped paddr block. 2. If the to-be-mapped paddr block is enclosed by an already mapped paddr block, no new mapping will happen, return ESP_ERR_INVALID_STATE. The out pointer will be the already mapped paddr corresponding vaddr. 3. If the to-be-mapped paddr block is identical with an already mapped paddr block, no new mapping will happen, return ESP_ERR_INVALID_STATE. The out pointer will be the corresponding vaddr. - If this flag isn't set, overlapped, enclosed or same to-be-mapped paddr block will lead to ESP_ERR_INVALID_ARG.