Showing changes from revision #1 to #2:
Added | Removed | Changed
Entry | |
---|---|
R0 | Overlay ID |
R1 | Buffer number |
Exit | |
---|---|
R0 | Pointer to array giving buffer addresses: |
Word 0: Plane 0 base logical address | |
Word 1: Plane 0 stride between image rows | |
Words 2+: Logical addresses and strides for any additional planes | |
- | All other registers preserved |
Maps an overlay bank/buffer into logical address space, potentially allocating the memory for it if the driver hasn’t already done so.
If this is a freshly-allocated buffer, the contents are undefined. Otherwise Otherwise, the contents will be preserved.
Drivers may have limited logical address space available for mapping overlays, so in Wimp situations situations, it’s recommended to unmap your overlay(s) before allowing the Wimp to swap out your task.
The array returned in R0 will remain valid until the bank is unmapped.