IPC@CHIP® RTOS-PPC – API Documentation

Header image

Main page


DWORD RTX_PhysAddr ( const void *  virtAddr,
DWORD *  lenPtr 
)

This API translates an effective address (virtual) to the corresponding physical address.

All addresses used within application programs are "Effective Addresses", to use the PowerPC architecture terminology. Roughly speaking, these are vitual addresses.

Under normal circumstances, a program will have no need to know the underlying physical addresses. This API is provided to cover for the exceptional cases where perhaps some hardware device must access memory directly at its physical address.

Parameters:
virtAddr Object's virtual address whose physical address is desired
lenPtr Optional output parameter is a pointer to location that will receive the length of the contiguous physical memory in bytes which starts at 'virtAddr'. This parameter can be set to NULL if this output is not desired.
Returns:
Corresponding physical address, else NO_PHY_ADDRESS if virtAddr does not map to any physical address. That is to say that virtAddr does not lie in the system's current effective address space.
Compatibility:
The API does not exists in the SC1x, SC2x and SC1x3 C-Library.
Since:
SC2x3 V1.00 - CLIB V1.00





Top of page | Main page

Copyright © 2017 Beck IPC GmbH
Generated on Thu Jan 26 16:21:37 2017 by Doxygen 1.6.1