Memory protection

Memory protection support internals for ARM architecture. More...

Modules
	MPU region names
	Names of ARM MPU regions as being used by CMRX.

Data Structures
struct	MPU_Registers
	ARMv6M/ARMv7M MPU registers for one region (base + size model) More...

Typedefs
typedef struct MPU_Registers	MPU_State[MPU_STATE_SIZE]
	Type handling MPU state as remembered by CMRX thread switcher.

Detailed Description

Memory protection support internals for ARM architecture.

Typedef Documentation

MPU_State

typedef struct MPU_Registers MPU_State[MPU_STATE_SIZE]

Type handling MPU state as remembered by CMRX thread switcher.

Function Documentation

__mpu_expand_class()

uint32_t __mpu_expand_class

(

uint8_t

class

)

hard_fault_handler()

void hard_fault_handler

(

void

)

Handler for hard fault.

mpu_clear_region()

int mpu_clear_region

(

uint8_t

region

)

Disable MPU region.

This function will disable use of MPU region. Address and size will remain configured, but region is not marked as enabled anymore.

Parameters

region

ID of region being deactivated (0 - 7)

Returns

E_OK if region was deactivated

mpu_configure_region()

int mpu_configure_region	(	uint8_t	region,
		const void *	base,
		uint32_t	size,
		uint8_t	cls,
		struct MPU_Registers *	region_def
	)

Create configuration for MPU region.

@TODO

mpu_disable()

static void mpu_disable ( )

inlinestatic

Disable memory protection.

This routine will disable memory protection even for unprivileged code.

mpu_enable()

static void mpu_enable ( )

inlinestatic

Enable memory protection.

This routine enables memory protection with standard memory setup for kernel purposes. This means that any privileged code has full access to memory as if no memory protection was turned on.

Note

It is safe to call this routine in kernel context even if no memory regions are set.

mpu_load()

int mpu_load	(	const MPU_State *	state,
		uint8_t	base,
		uint8_t	count
	)

mpu_restore()

int mpu_restore	(	const MPU_State *	hosted_state,
		const MPU_State *	parent_state
	)

Load MPU settings.

Loads MPU settings for default amount of regions from off-CPU buffer. This is suitable for store-resume during task switching.

Parameters

hosted_state	MPU state buffer for the current host process
parent_state	MPU state buffer for the parent process

mpu_set_region()

int mpu_set_region	(	uint8_t	region,
		const void *	base,
		uint32_t	size,
		uint8_t	cls
	)

Configure and activate MPU region.

Activate given memory region with new base address and size. For now, caller is responsible for providing base address, which is aligned to size of block. If region is already activated, then its base address, size and flags are being overwritten.

Parameters

region	ID of region being activated (0-7)
base	base address of region
size	size of region (256B and more)
cls	region access class, see __MPU_flags for available access classes

Returns

E_OK if region was configured, otherwise error code is returned

mpu_store()

int mpu_store	(	MPU_State *	hosted_state,
		MPU_State *	parent_state
	)

Store MPU settings.

Stores MPU settings for default amount of regions into off-CPU buffer. This is suitable for store-resume during task switching.

Parameters

hosted_state	MPU state buffer for the current host process
parent_state	MPU state buffer for the parent process

Variable Documentation

__MPU_flags

const uint32_t __MPU_flags[]

static

Initial value:

= {
    0,
    MPU_RASR_ATTR_AP_PRW_URO,
    MPU_RASR_ATTR_AP_PRW_URW,
    MPU_RASR_ATTR_XN | MPU_RASR_ATTR_AP_PRW_URO,
    MPU_RASR_ATTR_XN | MPU_RASR_ATTR_AP_PRW_URW,
}

MPU region access rights for ARMv6M/ARMv7M.

This array maps CMRX access modes to ARM RASR attributes See MPU_Flags for meaning of individual indices.