MPU FIREWALL

Table of Contents

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

MPU FIREWALL driver provides API to configure different regions in all supported firewalls.

Features Supported

• APIs to setup MPU Firewall regions, including region start address, size, attributes like access permissions and AID configurations

SysConfig Features

Note

It is strongly recommend to use SysConfig where it is available instead of using direct SW API calls. This will help simplify the SW application and also catch common mistakes early in the development cycle.

• MPU Firewall selection
• Region configuration for each firewall
• Start address and Size configuration
• Privilege ID and access permission configuration

Features NOT Supported

• None

Important Usage Guidelines

• None

Example Usage

Include the below file to access the APIs

#include <drivers/mpu_firewall.h>

Example to setup MPU Firewall regions is shown below,

 
    MPU_FIREWALL_RegionParams mpuParams;
 
    /* Initialize the MPU Param structure */
    MPU_FIREWALL_RegionParams_init(&mpuParams);
 
    /* Set the region parameters */
    mpuParams.id = 4;
    mpuParams.regionNumber = 0;
    mpuParams.startAddress = 0x70000000;
    mpuParams.endAddress = 0x70000100;
    mpuParams.aidConfig = (0x1<<PRIV_ID_R5FSS0_0) | (0x1<<PRIV_ID_R5FSS0_1);
    mpuParams.aidxConfig = 0;
    mpuParams.supervisorReadConfig = 1;
    mpuParams.supervisorWriteConfig = 1;
    mpuParams.supervisorExecConfig = 1;
    mpuParams.userReadConfig = 1;
    mpuParams.userWriteConfig = 1;
    mpuParams.userExecConfig = 1;
    mpuParams.nonSecureConfig = 1;
    mpuParams.debugConfig = 1;
 
    /* Program the parameters for the region */
    MPU_FIREWALL_setRegion(&mpuParams);
 

API

APIs for MPU Firewall