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.
• This module is needed for M4F to access peripherals on the MainSS side of the SOC.

Example Usage

Include the below file to access the APIs,

#include <kernel/dpl/AddrTranslateP.h>
#include <kernel/dpl/DebugP.h>

Example to translate a system address to local CPU address,

    uint64_t systemAddr = 0x029060000ul;
    void *localAddr;
 
    localAddr = AddrTranslateP_getLocalAddr(systemAddr);
 
    DebugP_log("System Addr:%x => Local Address:%x\n", systemAddr, localAddr);

API

APIs for Region based address translation (RAT) module