Region based Address Translate

Table of Contents

• Features Supported
• Features NOT Supported
• Important Usage Guidelines
• Example Usage
• API

Features Supported

• APIs to setup region based address translation using RAT HW on supported SOCs
• APIs to translate 48b SOC view system addr to 32b local CPU view address.
• When no address mapping is specified, no translation is done.

Features NOT Supported

NA

Important Usage Guidelines

• The translation API AddrTranslateP_getLocalAddr is meant to be used to translate SOC specified peripheral MMR base addresses to local CPU accesible addresses, within device drivers. The API internally searches through a small array to find the address translations, hence to be efficient, this API should typically be called once during driver init to find the local address that CPU should use.

Example Usage

Include the below file to access the APIs,

#include <kernel/dpl/AddrTranslateP.h>

Example to translate a system address to local CPU address,

    uint64_t systemAddr = 0x029060000ul;
    void *localAddr;
 
    localAddr = AddrTranslateP_getLocalAddr(systemAddr);
 

API

APIs for Region based address translation (RAT) module