mpu_armv7.h File Reference

Go to the source code of this file.

Classes
struct	ARM_MPU_Region_t
	Struct for a single MPU Region. More...

Macros
#define	ARM_MPU_ARMV7_H
#define	ARM_MPU_REGION_SIZE_32B   ((uint8_t)0x04U)
#define	ARM_MPU_REGION_SIZE_64B   ((uint8_t)0x05U)
#define	ARM_MPU_REGION_SIZE_128B   ((uint8_t)0x06U)
#define	ARM_MPU_REGION_SIZE_256B   ((uint8_t)0x07U)
#define	ARM_MPU_REGION_SIZE_512B   ((uint8_t)0x08U)
#define	ARM_MPU_REGION_SIZE_1KB   ((uint8_t)0x09U)
#define	ARM_MPU_REGION_SIZE_2KB   ((uint8_t)0x0AU)
#define	ARM_MPU_REGION_SIZE_4KB   ((uint8_t)0x0BU)
#define	ARM_MPU_REGION_SIZE_8KB   ((uint8_t)0x0CU)
#define	ARM_MPU_REGION_SIZE_16KB   ((uint8_t)0x0DU)
#define	ARM_MPU_REGION_SIZE_32KB   ((uint8_t)0x0EU)
#define	ARM_MPU_REGION_SIZE_64KB   ((uint8_t)0x0FU)
#define	ARM_MPU_REGION_SIZE_128KB   ((uint8_t)0x10U)
#define	ARM_MPU_REGION_SIZE_256KB   ((uint8_t)0x11U)
#define	ARM_MPU_REGION_SIZE_512KB   ((uint8_t)0x12U)
#define	ARM_MPU_REGION_SIZE_1MB   ((uint8_t)0x13U)
#define	ARM_MPU_REGION_SIZE_2MB   ((uint8_t)0x14U)
#define	ARM_MPU_REGION_SIZE_4MB   ((uint8_t)0x15U)
#define	ARM_MPU_REGION_SIZE_8MB   ((uint8_t)0x16U)
#define	ARM_MPU_REGION_SIZE_16MB   ((uint8_t)0x17U)
#define	ARM_MPU_REGION_SIZE_32MB   ((uint8_t)0x18U)
#define	ARM_MPU_REGION_SIZE_64MB   ((uint8_t)0x19U)
#define	ARM_MPU_REGION_SIZE_128MB   ((uint8_t)0x1AU)
#define	ARM_MPU_REGION_SIZE_256MB   ((uint8_t)0x1BU)
#define	ARM_MPU_REGION_SIZE_512MB   ((uint8_t)0x1CU)
#define	ARM_MPU_REGION_SIZE_1GB   ((uint8_t)0x1DU)
#define	ARM_MPU_REGION_SIZE_2GB   ((uint8_t)0x1EU)
#define	ARM_MPU_REGION_SIZE_4GB   ((uint8_t)0x1FU)
#define	ARM_MPU_AP_NONE   0U
#define	ARM_MPU_AP_PRIV   1U
#define	ARM_MPU_AP_URO   2U
#define	ARM_MPU_AP_FULL   3U
#define	ARM_MPU_AP_PRO   5U
#define	ARM_MPU_AP_RO   6U
#define	ARM_MPU_RBAR(Region, BaseAddress)
	MPU Region Base Address Register Value.
#define	ARM_MPU_ACCESS_(TypeExtField, IsShareable, IsCacheable, IsBufferable)
	MPU Memory Access Attributes.
#define	ARM_MPU_RASR_EX(DisableExec, AccessPermission, AccessAttributes, SubRegionDisable, Size)
	MPU Region Attribute and Size Register Value.
#define	ARM_MPU_RASR(DisableExec, AccessPermission, TypeExtField, IsShareable, IsCacheable, IsBufferable, SubRegionDisable, Size)    ARM_MPU_RASR_EX(DisableExec, AccessPermission, ARM_MPU_ACCESS_(TypeExtField, IsShareable, IsCacheable, IsBufferable), SubRegionDisable, Size)
	MPU Region Attribute and Size Register Value.
#define	ARM_MPU_ACCESS_ORDERED   ARM_MPU_ACCESS_(0U, 1U, 0U, 0U)
	MPU Memory Access Attribute for strongly ordered memory.
#define	ARM_MPU_ACCESS_DEVICE(IsShareable)   ((IsShareable) ? ARM_MPU_ACCESS_(0U, 1U, 0U, 1U) : ARM_MPU_ACCESS_(2U, 0U, 0U, 0U))
	MPU Memory Access Attribute for device memory.
#define	ARM_MPU_ACCESS_NORMAL(OuterCp, InnerCp, IsShareable)   ARM_MPU_ACCESS_((4U | (OuterCp)), IsShareable, ((InnerCp) & 2U), ((InnerCp) & 1U))
	MPU Memory Access Attribute for normal memory.
#define	ARM_MPU_CACHEP_NOCACHE   0U
	MPU Memory Access Attribute non-cacheable policy.
#define	ARM_MPU_CACHEP_WB_WRA   1U
	MPU Memory Access Attribute write-back, write and read allocate policy.
#define	ARM_MPU_CACHEP_WT_NWA   2U
	MPU Memory Access Attribute write-through, no write allocate policy.
#define	ARM_MPU_CACHEP_WB_NWA   3U
	MPU Memory Access Attribute write-back, no write allocate policy.

Functions
__STATIC_INLINE void	ARM_MPU_Enable (uint32_t MPU_Control)
	Enable the MPU.
__STATIC_INLINE void	ARM_MPU_Disable (void)
	Disable the MPU.
__STATIC_INLINE void	ARM_MPU_ClrRegion (uint32_t rnr)
	Clear and disable the given MPU region.
__STATIC_INLINE void	ARM_MPU_SetRegion (uint32_t rbar, uint32_t rasr)
	Configure an MPU region.
__STATIC_INLINE void	ARM_MPU_SetRegionEx (uint32_t rnr, uint32_t rbar, uint32_t rasr)
	Configure the given MPU region.
__STATIC_INLINE void	orderedCpy (volatile uint32_t *dst, const uint32_t *__RESTRICT src, uint32_t len)
	Memcopy with strictly ordered memory access, e.g.
__STATIC_INLINE void	ARM_MPU_Load (ARM_MPU_Region_t const *table, uint32_t cnt)
	Load the given number of MPU regions from a table.

Macro Definition Documentation

ARM_MPU_ACCESS_

#define ARM_MPU_ACCESS_	(		TypeExtField,
			IsShareable,
			IsCacheable,
			IsBufferable
	)

Value:

  ((((TypeExtField ) << MPU_RASR_TEX_Pos) & MPU_RASR_TEX_Msk)                 | \
   (((IsShareable ) << MPU_RASR_S_Pos) & MPU_RASR_S_Msk)                      | \
   (((IsCacheable ) << MPU_RASR_C_Pos) & MPU_RASR_C_Msk)                      | \
   (((IsBufferable ) << MPU_RASR_B_Pos) & MPU_RASR_B_Msk))

MPU Memory Access Attributes.

Parameters

TypeExtField	Type extension field, allows you to configure memory access type, for example strongly ordered, peripheral.
IsShareable	Region is shareable between multiple bus masters.
IsCacheable	Region is cacheable, i.e. its value may be kept in cache.
IsBufferable	Region is bufferable, i.e. using write-back caching. Cacheable but non-bufferable regions use write-through policy.

ARM_MPU_ACCESS_DEVICE

#define ARM_MPU_ACCESS_DEVICE

(

IsShareable

)

((IsShareable) ? ARM_MPU_ACCESS_(0U, 1U, 0U, 1U) : ARM_MPU_ACCESS_(2U, 0U, 0U, 0U))

MPU Memory Access Attribute for device memory.

• TEX: 000b (if non-shareable) or 010b (if shareable)
• Shareable or non-shareable
• Non-cacheable
• Bufferable (if shareable) or non-bufferable (if non-shareable)

Parameters

IsShareable

Configures the device memory as shareable or non-shareable.

ARM_MPU_ACCESS_NORMAL

#define ARM_MPU_ACCESS_NORMAL	(		OuterCp,
			InnerCp,
			IsShareable
	)		ARM_MPU_ACCESS_((4U | (OuterCp)), IsShareable, ((InnerCp) & 2U), ((InnerCp) & 1U))

MPU Memory Access Attribute for normal memory.

• TEX: 1BBb (reflecting outer cacheability rules)
• Shareable or non-shareable
• Cacheable or non-cacheable (reflecting inner cacheability rules)
• Bufferable or non-bufferable (reflecting inner cacheability rules)

Parameters

OuterCp	Configures the outer cache policy.
InnerCp	Configures the inner cache policy.
IsShareable	Configures the memory as shareable or non-shareable.

ARM_MPU_ACCESS_ORDERED

#define ARM_MPU_ACCESS_ORDERED   ARM_MPU_ACCESS_(0U, 1U, 0U, 0U)

MPU Memory Access Attribute for strongly ordered memory.

• TEX: 000b
• Shareable
• Non-cacheable
• Non-bufferable

ARM_MPU_AP_FULL

#define ARM_MPU_AP_FULL   3U

ARM_MPU_AP_NONE

#define ARM_MPU_AP_NONE   0U

ARM_MPU_AP_PRIV

#define ARM_MPU_AP_PRIV   1U

ARM_MPU_AP_PRO

#define ARM_MPU_AP_PRO   5U

ARM_MPU_AP_RO

#define ARM_MPU_AP_RO   6U

ARM_MPU_AP_URO

#define ARM_MPU_AP_URO   2U

ARM_MPU_ARMV7_H

#define ARM_MPU_ARMV7_H

ARM_MPU_CACHEP_NOCACHE

#define ARM_MPU_CACHEP_NOCACHE   0U

MPU Memory Access Attribute non-cacheable policy.

ARM_MPU_CACHEP_WB_NWA

#define ARM_MPU_CACHEP_WB_NWA   3U

MPU Memory Access Attribute write-back, no write allocate policy.

ARM_MPU_CACHEP_WB_WRA

#define ARM_MPU_CACHEP_WB_WRA   1U

MPU Memory Access Attribute write-back, write and read allocate policy.

ARM_MPU_CACHEP_WT_NWA

#define ARM_MPU_CACHEP_WT_NWA   2U

MPU Memory Access Attribute write-through, no write allocate policy.

ARM_MPU_RASR

#define ARM_MPU_RASR	(		DisableExec,
			AccessPermission,
			TypeExtField,
			IsShareable,
			IsCacheable,
			IsBufferable,
			SubRegionDisable,
			Size
	)		ARM_MPU_RASR_EX(DisableExec, AccessPermission, ARM_MPU_ACCESS_(TypeExtField, IsShareable, IsCacheable, IsBufferable), SubRegionDisable, Size)

MPU Region Attribute and Size Register Value.

Parameters

DisableExec	Instruction access disable bit, 1= disable instruction fetches.
AccessPermission	Data access permissions, allows you to configure read/write access for User and Privileged mode.
TypeExtField	Type extension field, allows you to configure memory access type, for example strongly ordered, peripheral.
IsShareable	Region is shareable between multiple bus masters.
IsCacheable	Region is cacheable, i.e. its value may be kept in cache.
IsBufferable	Region is bufferable, i.e. using write-back caching. Cacheable but non-bufferable regions use write-through policy.
SubRegionDisable	Sub-region disable field.
Size	Region size of the region to be configured, for example 4K, 8K.

ARM_MPU_RASR_EX

#define ARM_MPU_RASR_EX	(		DisableExec,
			AccessPermission,
			AccessAttributes,
			SubRegionDisable,
			Size
	)

Value:

  ((((DisableExec ) << MPU_RASR_XN_Pos) & MPU_RASR_XN_Msk)                                          | \
   (((AccessPermission) << MPU_RASR_AP_Pos) & MPU_RASR_AP_Msk)                                      | \
   (((AccessAttributes) ) & (MPU_RASR_TEX_Msk | MPU_RASR_S_Msk | MPU_RASR_C_Msk | MPU_RASR_B_Msk)))

MPU Region Attribute and Size Register Value.

Parameters

DisableExec	Instruction access disable bit, 1= disable instruction fetches.
AccessPermission	Data access permissions, allows you to configure read/write access for User and Privileged mode.
AccessAttributes	Memory access attribution, see ARM_MPU_ACCESS_.
SubRegionDisable	Sub-region disable field.
Size	Region size of the region to be configured, for example 4K, 8K.

ARM_MPU_RBAR

#define ARM_MPU_RBAR	(		Region,
			BaseAddress
	)

Value:

  (((BaseAddress) & MPU_RBAR_ADDR_Msk) |  \
   ((Region) & MPU_RBAR_REGION_Msk)    |  \
   (MPU_RBAR_VALID_Msk))

MPU Region Base Address Register Value.

Parameters

Region	The region to be configured, number 0 to 15.
BaseAddress	The base address for the region.

ARM_MPU_REGION_SIZE_128B

#define ARM_MPU_REGION_SIZE_128B   ((uint8_t)0x06U)

ARM_MPU_REGION_SIZE_128KB

#define ARM_MPU_REGION_SIZE_128KB   ((uint8_t)0x10U)

ARM_MPU_REGION_SIZE_128MB

#define ARM_MPU_REGION_SIZE_128MB   ((uint8_t)0x1AU)

ARM_MPU_REGION_SIZE_16KB

#define ARM_MPU_REGION_SIZE_16KB   ((uint8_t)0x0DU)

ARM_MPU_REGION_SIZE_16MB

#define ARM_MPU_REGION_SIZE_16MB   ((uint8_t)0x17U)

ARM_MPU_REGION_SIZE_1GB

#define ARM_MPU_REGION_SIZE_1GB   ((uint8_t)0x1DU)

ARM_MPU_REGION_SIZE_1KB

#define ARM_MPU_REGION_SIZE_1KB   ((uint8_t)0x09U)

ARM_MPU_REGION_SIZE_1MB

#define ARM_MPU_REGION_SIZE_1MB   ((uint8_t)0x13U)

ARM_MPU_REGION_SIZE_256B

#define ARM_MPU_REGION_SIZE_256B   ((uint8_t)0x07U)

ARM_MPU_REGION_SIZE_256KB

#define ARM_MPU_REGION_SIZE_256KB   ((uint8_t)0x11U)

ARM_MPU_REGION_SIZE_256MB

#define ARM_MPU_REGION_SIZE_256MB   ((uint8_t)0x1BU)

ARM_MPU_REGION_SIZE_2GB

#define ARM_MPU_REGION_SIZE_2GB   ((uint8_t)0x1EU)

ARM_MPU_REGION_SIZE_2KB

#define ARM_MPU_REGION_SIZE_2KB   ((uint8_t)0x0AU)

ARM_MPU_REGION_SIZE_2MB

#define ARM_MPU_REGION_SIZE_2MB   ((uint8_t)0x14U)

ARM_MPU_REGION_SIZE_32B

#define ARM_MPU_REGION_SIZE_32B   ((uint8_t)0x04U)

ARM_MPU_REGION_SIZE_32KB

#define ARM_MPU_REGION_SIZE_32KB   ((uint8_t)0x0EU)

ARM_MPU_REGION_SIZE_32MB

#define ARM_MPU_REGION_SIZE_32MB   ((uint8_t)0x18U)

ARM_MPU_REGION_SIZE_4GB

#define ARM_MPU_REGION_SIZE_4GB   ((uint8_t)0x1FU)

ARM_MPU_REGION_SIZE_4KB

#define ARM_MPU_REGION_SIZE_4KB   ((uint8_t)0x0BU)

ARM_MPU_REGION_SIZE_4MB

#define ARM_MPU_REGION_SIZE_4MB   ((uint8_t)0x15U)

ARM_MPU_REGION_SIZE_512B

#define ARM_MPU_REGION_SIZE_512B   ((uint8_t)0x08U)

ARM_MPU_REGION_SIZE_512KB

#define ARM_MPU_REGION_SIZE_512KB   ((uint8_t)0x12U)

ARM_MPU_REGION_SIZE_512MB

#define ARM_MPU_REGION_SIZE_512MB   ((uint8_t)0x1CU)

ARM_MPU_REGION_SIZE_64B

#define ARM_MPU_REGION_SIZE_64B   ((uint8_t)0x05U)

ARM_MPU_REGION_SIZE_64KB

#define ARM_MPU_REGION_SIZE_64KB   ((uint8_t)0x0FU)

ARM_MPU_REGION_SIZE_64MB

#define ARM_MPU_REGION_SIZE_64MB   ((uint8_t)0x19U)

ARM_MPU_REGION_SIZE_8KB

#define ARM_MPU_REGION_SIZE_8KB   ((uint8_t)0x0CU)

ARM_MPU_REGION_SIZE_8MB

#define ARM_MPU_REGION_SIZE_8MB   ((uint8_t)0x16U)

Function Documentation

ARM_MPU_ClrRegion()

__STATIC_INLINE void ARM_MPU_ClrRegion

(

uint32_t

rnr

)

Clear and disable the given MPU region.

Parameters

rnr	Region number to be cleared.

ARM_MPU_Disable()

__STATIC_INLINE void ARM_MPU_Disable

(

void

)

Disable the MPU.

ARM_MPU_Enable()

__STATIC_INLINE void ARM_MPU_Enable

(

uint32_t

MPU_Control

)

Enable the MPU.

Parameters

MPU_Control

Default access permissions for unconfigured regions.

ARM_MPU_Load()

__STATIC_INLINE void ARM_MPU_Load	(	ARM_MPU_Region_t const *	table,
		uint32_t	cnt
	)

Load the given number of MPU regions from a table.

Parameters

table	Pointer to the MPU configuration table.
cnt	Amount of regions to be configured.

ARM_MPU_SetRegion()

__STATIC_INLINE void ARM_MPU_SetRegion	(	uint32_t	rbar,
		uint32_t	rasr
	)

Configure an MPU region.

Parameters

rbar	Value for RBAR register.
rsar	Value for RSAR register.

ARM_MPU_SetRegionEx()

__STATIC_INLINE void ARM_MPU_SetRegionEx	(	uint32_t	rnr,
		uint32_t	rbar,
		uint32_t	rasr
	)

Configure the given MPU region.

Parameters

rnr	Region number to be configured.
rbar	Value for RBAR register.
rsar	Value for RSAR register.

orderedCpy()

__STATIC_INLINE void orderedCpy	(	volatile uint32_t *	dst,
		const uint32_t *__RESTRICT	src,
		uint32_t	len
	)

Memcopy with strictly ordered memory access, e.g.

for register targets.

Parameters

dst	Destination data is copied to.
src	Source data is copied from.
len	Amount of data words to be copied.