sPMP or sMPU Functions

Functions that related to the RISCV supervisor-mode Phyiscal Memory Protection. More...

Data Structures
struct	spmp_config

Macros
#define	__get_SMPUCFGx   __get_sPMPCFGx
#define	__set_SMPUCFGx   __set_sPMPCFGx
#define	__get_SMPUxCFG   __get_sPMPxCFG
#define	__set_SMPUxCFG   __set_sPMPxCFG
#define	__get_SMPUADDRx   __get_sPMPADDRx
#define	__set_SMPUADDRx   __set_sPMPADDRx
#define	__set_SMPUENTRYx   __set_sPMPENTRYx
#define	__get_SMPUENTRYx   __get_sPMPENTRYx

Typedefs
typedef spmp_config	smpu_config
	sPMP has upgraded to S-mode Memory Protection Unit, renamed as SMPU, but still share the apis with sPMP's More...

Functions
__STATIC_INLINE rv_csr_t	__get_sPMPCFGx (uint32_t csr_idx)
	Get sPMPCFGx Register by csr index. More...
__STATIC_INLINE void	__set_sPMPCFGx (uint32_t csr_idx, rv_csr_t spmpcfg)
	Set sPMPCFGx by csr index. More...
__STATIC_INLINE uint8_t	__get_sPMPxCFG (uint32_t entry_idx)
	Get 8bit sPMPxCFG Register by sPMP entry index. More...
__STATIC_INLINE void	__set_sPMPxCFG (uint32_t entry_idx, uint8_t spmpxcfg)
	Set 8bit sPMPxCFG by spmp entry index. More...
__STATIC_INLINE rv_csr_t	__get_sPMPADDRx (uint32_t csr_idx)
	Get sPMPADDRx Register by CSR index. More...
__STATIC_INLINE void	__set_sPMPADDRx (uint32_t csr_idx, rv_csr_t spmpaddr)
	Set sPMPADDRx by CSR index. More...
__STATIC_INLINE void	__set_sPMPENTRYx (uint32_t entry_idx, const spmp_config *spmp_cfg)
	Set sPMP entry by entry idx. More...
__STATIC_INLINE int	__get_sPMPENTRYx (unsigned int entry_idx, spmp_config *spmp_cfg)
	Get sPMP entry by entry idx. More...
__STATIC_INLINE void	__set_SMPUSWITCHx (uint64_t val)
	Set SMPU each entry's on/off status. More...
__STATIC_INLINE uint64_t	__get_SMPUSWITCHx (void)
	Get SMPU each entry's on/off status. More...

Detailed Description

Functions that related to the RISCV supervisor-mode Phyiscal Memory Protection.

Optional superviosr physical memory protection (sPMP) unit provides per-hart supervisor-mode control registers to allow physical memory access privileges (read, write, execute) to be specified for each physical memory region. The sPMP values are checked after the physical address to be accessed pass PMP checks described in the RISC-V privileged spec.

Like PMP, the sPMP can supports region access control settings as small as four bytes.

Macro Definition Documentation

__get_SMPUADDRx

#define __get_SMPUADDRx   __get_sPMPADDRx

Definition at line 401 of file core_feature_spmp.h.

__get_SMPUCFGx

#define __get_SMPUCFGx   __get_sPMPCFGx

Definition at line 397 of file core_feature_spmp.h.

__get_SMPUENTRYx

#define __get_SMPUENTRYx   __get_sPMPENTRYx

Definition at line 404 of file core_feature_spmp.h.

__get_SMPUxCFG

#define __get_SMPUxCFG   __get_sPMPxCFG

Definition at line 399 of file core_feature_spmp.h.

__set_SMPUADDRx

#define __set_SMPUADDRx   __set_sPMPADDRx

Definition at line 402 of file core_feature_spmp.h.

__set_SMPUCFGx

#define __set_SMPUCFGx   __set_sPMPCFGx

Definition at line 398 of file core_feature_spmp.h.

__set_SMPUENTRYx

#define __set_SMPUENTRYx   __set_sPMPENTRYx

Definition at line 403 of file core_feature_spmp.h.

__set_SMPUxCFG

#define __set_SMPUxCFG   __set_sPMPxCFG

Definition at line 400 of file core_feature_spmp.h.

Typedef Documentation

smpu_config

typedef spmp_config smpu_config

sPMP has upgraded to S-mode Memory Protection Unit, renamed as SMPU, but still share the apis with sPMP's

Definition at line 396 of file core_feature_spmp.h.

Function Documentation

__get_SMPUSWITCHx()

__STATIC_INLINE uint64_t __get_SMPUSWITCHx

(

void

)

Get SMPU each entry's on/off status.

Get the value of the SMPUSWITCHx Register.

Remarks

• Each bit of this register holds on/off status of the corresponding SMPU entry respectively.
• An SMPU entry is activated only when both corresponding bits in smpuswitch and A field of smpuicfg are set. (i.e., smpuswitch[i] & smpu[i]cfg.A).

Definition at line 435 of file core_feature_spmp.h.

{
#if __RISCV_XLEN == 32
    uint32_t lo, hi = 0;
    lo = __RV_CSR_READ(CSR_SMPUSWITCH0);
    hi = __RV_CSR_READ(CSR_SMPUSWITCH1);
    return (uint64_t)((((uint64_t)hi) << 32) | lo);
#elif __RISCV_XLEN == 64
    return (uint64_t)__RV_CSR_READ(CSR_SMPUSWITCH0);
#else
    // TODO Add RV128 Handling
#endif
}

References __RV_CSR_READ, CSR_SMPUSWITCH0, and CSR_SMPUSWITCH1.

__get_sPMPADDRx()

__STATIC_INLINE rv_csr_t __get_sPMPADDRx

(

uint32_t

csr_idx

)

Get sPMPADDRx Register by CSR index.

Return the content of the sPMPADDRx Register.

Parameters

[in]

csr_idx

sPMP region CSR index(0-15)

Returns

sPMPADDRx Register value

Definition at line 216 of file core_feature_spmp.h.

{
    switch (csr_idx) {
        case 0: return __RV_CSR_READ(CSR_SPMPADDR0);
        case 1: return __RV_CSR_READ(CSR_SPMPADDR1);
        case 2: return __RV_CSR_READ(CSR_SPMPADDR2);
        case 3: return __RV_CSR_READ(CSR_SPMPADDR3);
        case 4: return __RV_CSR_READ(CSR_SPMPADDR4);
        case 5: return __RV_CSR_READ(CSR_SPMPADDR5);
        case 6: return __RV_CSR_READ(CSR_SPMPADDR6);
        case 7: return __RV_CSR_READ(CSR_SPMPADDR7);
#if __SPMP_ENTRY_NUM > 8
        case 8: return __RV_CSR_READ(CSR_SPMPADDR8);
        case 9: return __RV_CSR_READ(CSR_SPMPADDR9);
        case 10: return __RV_CSR_READ(CSR_SPMPADDR10);
        case 11: return __RV_CSR_READ(CSR_SPMPADDR11);
        case 12: return __RV_CSR_READ(CSR_SPMPADDR12);
        case 13: return __RV_CSR_READ(CSR_SPMPADDR13);
        case 14: return __RV_CSR_READ(CSR_SPMPADDR14);
        case 15: return __RV_CSR_READ(CSR_SPMPADDR15);
#endif
        default: return 0;
    }
}

References __RV_CSR_READ, CSR_SPMPADDR0, CSR_SPMPADDR1, CSR_SPMPADDR10, CSR_SPMPADDR11, CSR_SPMPADDR12, CSR_SPMPADDR13, CSR_SPMPADDR14, CSR_SPMPADDR15, CSR_SPMPADDR2, CSR_SPMPADDR3, CSR_SPMPADDR4, CSR_SPMPADDR5, CSR_SPMPADDR6, CSR_SPMPADDR7, CSR_SPMPADDR8, and CSR_SPMPADDR9.

Referenced by __get_sPMPENTRYx().

__get_sPMPCFGx()

__STATIC_INLINE rv_csr_t __get_sPMPCFGx

(

uint32_t

csr_idx

)

Get sPMPCFGx Register by csr index.

Return the content of the sPMPCFGx Register.

Parameters

[in]

csr_idx

sPMPCFG CSR index(0-3)

Returns

sPMPCFGx Register value

Remarks

• For RV64, only csr_idx = 0 and csr_idx = 2 is allowed. spmpcfg0 and spmpcfg2 hold the configurations for the 16 sPMP entries, spmpcfg1 and spmpcfg3 are illegal
• For RV32, spmpcfg0–spmpcfg3, hold the configurations spmp0cfg–spmp15cfg for the 16 sPMP entries

Definition at line 95 of file core_feature_spmp.h.

{
    switch (csr_idx) {
        case 0: return __RV_CSR_READ(CSR_SPMPCFG0);
        case 1: return __RV_CSR_READ(CSR_SPMPCFG1);
#if __SPMP_ENTRY_NUM > 8
        case 2: return __RV_CSR_READ(CSR_SPMPCFG2);
        case 3: return __RV_CSR_READ(CSR_SPMPCFG3);
#endif
        default: return 0;
    }
}

References __RV_CSR_READ, CSR_SPMPCFG0, CSR_SPMPCFG1, CSR_SPMPCFG2, and CSR_SPMPCFG3.

Referenced by __get_sPMPENTRYx(), __get_sPMPxCFG(), __set_sPMPENTRYx(), and __set_sPMPxCFG().

__get_sPMPENTRYx()

__STATIC_INLINE int __get_sPMPENTRYx	(	unsigned int	entry_idx,
		spmp_config *	spmp_cfg
	)

Get sPMP entry by entry idx.

Write the given value to the sPMPxCFG Register and sPMPADDRx.

Parameters

[in]	entry_idx	sPMP entry index(0-15)
[out]	spmp_cfg	structure of L, U, X, W, R, A field of sPMP configuration register, memory region base address and size of memory region as power of 2

Returns

-1 failure, else 0 success

Remarks

• If the size of memory region is 2^12(4KB) range, spmp_cfg->order makes 12, and the like.
• TOR of A field in PMP configuration register is not considered here.

Definition at line 344 of file core_feature_spmp.h.

{
    unsigned int cfg_shift, cfg_csr_idx, addr_csr_idx = 0;
    unsigned long cfgmask, spmpcfg, prot = 0;
    unsigned long t1, addr, spmpaddr, len = 0;
    uint8_t csr_cfg_num = 0;
    /* check parameters */
    if (entry_idx >= __SPMP_ENTRY_NUM || !spmp_cfg) return -1;
 
    /* calculate sPMP register and offset */
#if __RISCV_XLEN == 32
    csr_cfg_num = 4;
    cfg_csr_idx = entry_idx >> 2;
#elif __RISCV_XLEN == 64
    csr_cfg_num = 8;
    cfg_csr_idx = (entry_idx >> 2) & ~1;
#else
// TODO Add RV128 Handling
    return -1;
#endif
 
    cfg_shift = (entry_idx & (csr_cfg_num - 1)) << 3;
    addr_csr_idx = entry_idx;
 
    /* decode sPMP config */
    cfgmask = (0xFFUL << cfg_shift);
    spmpcfg = (__get_sPMPCFGx(cfg_csr_idx) & cfgmask);
    prot    = spmpcfg >> cfg_shift;
 
    /* decode sPMP address */
    spmpaddr = __get_sPMPADDRx(addr_csr_idx);
    if (SPMP_A_NAPOT == (prot & SPMP_A)) {
        t1 = __CTZ(~spmpaddr);
        addr = (spmpaddr & ~((1UL << t1) - 1)) << SPMP_SHIFT;
        len = (t1 + SPMP_SHIFT + 1);
    } else {
        addr = spmpaddr << SPMP_SHIFT;
        len = SPMP_SHIFT;
    }
 
    /* return details */
    spmp_cfg->protection = prot;
    spmp_cfg->base_addr = addr;
    spmp_cfg->order = len;
 
    return 0;
}

References __CTZ(), __get_sPMPADDRx(), __get_sPMPCFGx(), spmp_config::base_addr, spmp_config::order, spmp_config::protection, SPMP_A, SPMP_A_NAPOT, and SPMP_SHIFT.

__get_sPMPxCFG()

__STATIC_INLINE uint8_t __get_sPMPxCFG

(

uint32_t

entry_idx

)

Get 8bit sPMPxCFG Register by sPMP entry index.

Return the content of the sPMPxCFG Register.

Parameters

[in]

entry_idx

sPMP region index(0-15)

Returns

sPMPxCFG Register value

Definition at line 139 of file core_feature_spmp.h.

{
    rv_csr_t spmpcfgx = 0;
    uint8_t csr_cfg_num = 0;
    uint16_t csr_idx = 0;
    uint16_t cfg_shift = 0;
 
    if (entry_idx >= __SPMP_ENTRY_NUM) return 0;
 
#if __RISCV_XLEN == 32
    csr_cfg_num = 4;
    csr_idx = entry_idx >> 2;
#elif __RISCV_XLEN == 64
    csr_cfg_num = 8;
    /* For RV64, spmpcfg0 and spmpcfg2 each hold 8 sPMP entries, align by 2 */
    csr_idx = (entry_idx >> 2) & ~1;
#else
    // TODO Add RV128 Handling
    return 0;
#endif
    spmpcfgx = __get_sPMPCFGx(csr_idx);
    /*
     * first get specific spmpxcfg's order in one CSR composed of csr_cfg_num spmpxcfgs,
     * then get spmpxcfg's bit position in one CSR by left shift 3(each spmpxcfg size is one byte)
     */
    cfg_shift = (entry_idx & (csr_cfg_num - 1)) << 3;
 
    /* read specific spmpxcfg register value */
    return (uint8_t)(__RV_EXTRACT_FIELD(spmpcfgx, 0xFF << cfg_shift));
}

References __get_sPMPCFGx().

__set_SMPUSWITCHx()

__STATIC_INLINE void __set_SMPUSWITCHx

(

uint64_t

val

)

Set SMPU each entry's on/off status.

Write the given value to the SMPUSWITCHx Register.

Parameters

[in]

val

activate each entry(max to 64) or not

Remarks

• Each bit of this register holds on/off status of the corresponding SMPU entry respectively.
• An SMPU entry is activated only when both corresponding bits in smpuswitch and A field of smpuicfg are set. (i.e., smpuswitch[i] & smpu[i]cfg.A).

Definition at line 415 of file core_feature_spmp.h.

{
#if __RISCV_XLEN == 32
    __RV_CSR_WRITE(CSR_SMPUSWITCH0, (uint32_t)val);
    __RV_CSR_WRITE(CSR_SMPUSWITCH1, (uint32_t)(val >> 32));
#elif __RISCV_XLEN == 64
    __RV_CSR_WRITE(CSR_SMPUSWITCH0, val);
#else
    // TODO Add RV128 Handling
#endif
}

References __RV_CSR_WRITE, CSR_SMPUSWITCH0, and CSR_SMPUSWITCH1.

__set_sPMPADDRx()

__STATIC_INLINE void __set_sPMPADDRx	(	uint32_t	csr_idx,
		rv_csr_t	spmpaddr
	)

Set sPMPADDRx by CSR index.

Write the given value to the sPMPADDRx Register.

Parameters

[in]	csr_idx	sPMP region CSR index(0-15)
[in]	spmpaddr	sPMPADDRx Register value to set

Definition at line 247 of file core_feature_spmp.h.

{
    switch (csr_idx) {
        case 0: __RV_CSR_WRITE(CSR_SPMPADDR0, spmpaddr); break;
        case 1: __RV_CSR_WRITE(CSR_SPMPADDR1, spmpaddr); break;
        case 2: __RV_CSR_WRITE(CSR_SPMPADDR2, spmpaddr); break;
        case 3: __RV_CSR_WRITE(CSR_SPMPADDR3, spmpaddr); break;
        case 4: __RV_CSR_WRITE(CSR_SPMPADDR4, spmpaddr); break;
        case 5: __RV_CSR_WRITE(CSR_SPMPADDR5, spmpaddr); break;
        case 6: __RV_CSR_WRITE(CSR_SPMPADDR6, spmpaddr); break;
        case 7: __RV_CSR_WRITE(CSR_SPMPADDR7, spmpaddr); break;
#if __SPMP_ENTRY_NUM > 8
        case 8: __RV_CSR_WRITE(CSR_SPMPADDR8, spmpaddr); break;
        case 9: __RV_CSR_WRITE(CSR_SPMPADDR9, spmpaddr); break;
        case 10: __RV_CSR_WRITE(CSR_SPMPADDR10, spmpaddr); break;
        case 11: __RV_CSR_WRITE(CSR_SPMPADDR11, spmpaddr); break;
        case 12: __RV_CSR_WRITE(CSR_SPMPADDR12, spmpaddr); break;
        case 13: __RV_CSR_WRITE(CSR_SPMPADDR13, spmpaddr); break;
        case 14: __RV_CSR_WRITE(CSR_SPMPADDR14, spmpaddr); break;
        case 15: __RV_CSR_WRITE(CSR_SPMPADDR15, spmpaddr); break;
#endif
        default: return;
    }
}

References __RV_CSR_WRITE, CSR_SPMPADDR0, CSR_SPMPADDR1, CSR_SPMPADDR10, CSR_SPMPADDR11, CSR_SPMPADDR12, CSR_SPMPADDR13, CSR_SPMPADDR14, CSR_SPMPADDR15, CSR_SPMPADDR2, CSR_SPMPADDR3, CSR_SPMPADDR4, CSR_SPMPADDR5, CSR_SPMPADDR6, CSR_SPMPADDR7, CSR_SPMPADDR8, and CSR_SPMPADDR9.

Referenced by __set_sPMPENTRYx().

__set_sPMPCFGx()

__STATIC_INLINE void __set_sPMPCFGx	(	uint32_t	csr_idx,
		rv_csr_t	spmpcfg
	)

Set sPMPCFGx by csr index.

Write the given value to the sPMPCFGx Register.

Parameters

[in]	csr_idx	sPMPCFG CSR index(0-3)
[in]	spmpcfg	sPMPCFGx Register value to set

Remarks

• For RV64, only csr_idx = 0 and csr_idx = 2 is allowed. spmpcfg0 and spmpcfg2 hold the configurations for the 16 sPMP entries, spmpcfg1 and spmpcfg3 are illegal
• For RV32, spmpcfg0–spmpcfg3, hold the configurations spmp0cfg–spmp15cfg for the 16 sPMP entries

Definition at line 120 of file core_feature_spmp.h.

{
    switch (csr_idx) {
        case 0: __RV_CSR_WRITE(CSR_SPMPCFG0, spmpcfg); break;
        case 1: __RV_CSR_WRITE(CSR_SPMPCFG1, spmpcfg); break;
#if __SPMP_ENTRY_NUM > 8
        case 2: __RV_CSR_WRITE(CSR_SPMPCFG2, spmpcfg); break;
        case 3: __RV_CSR_WRITE(CSR_SPMPCFG3, spmpcfg); break;
#endif
        default: return;
    }
}

References __RV_CSR_WRITE, CSR_SPMPCFG0, CSR_SPMPCFG1, CSR_SPMPCFG2, and CSR_SPMPCFG3.

Referenced by __set_sPMPENTRYx(), and __set_sPMPxCFG().

__set_sPMPENTRYx()

__STATIC_INLINE void __set_sPMPENTRYx	(	uint32_t	entry_idx,
		const spmp_config *	spmp_cfg
	)

Set sPMP entry by entry idx.

Write the given value to the sPMPxCFG Register and sPMPADDRx.

Parameters

[in]	entry_idx	sPMP entry index(0-15)
[in]	spmp_cfg	structure of L,U,X,W,R field of sPMP configuration register, memory region base address and size of memory region as power of 2

Remarks

• If the size of memory region is 2^12(4KB) range, spmp_cfg->order makes 12, and the like.
• Suppose the size of memory region is 2^X bytes range, if X >=3, the NA4 mode is not selectable, NAPOT is selected.
• TOR of A field in sPMP configuration register is not considered here.

Definition at line 283 of file core_feature_spmp.h.

{
    unsigned int cfg_shift, cfg_csr_idx, addr_csr_idx = 0;
    unsigned long cfgmask, addrmask = 0;
    unsigned long spmpcfg, spmpaddr = 0;
    unsigned long protection, csr_cfg_num = 0;
    /* check parameters */
    if (entry_idx >= __SPMP_ENTRY_NUM || spmp_cfg->order > __RISCV_XLEN || spmp_cfg->order < SPMP_SHIFT) return;
 
    /* calculate sPMP register and offset */
#if __RISCV_XLEN == 32
    csr_cfg_num = 4;
    cfg_csr_idx = (entry_idx >> 2);
#elif __RISCV_XLEN == 64
    csr_cfg_num = 8;
    cfg_csr_idx = ((entry_idx >> 2)) & ~1;
#else
    // TODO Add RV128 Handling
    return;
#endif
    /*
     * first get specific spmpxcfg's order in one CSR composed of csr_cfg_num spmpxcfgs,
     * then get spmpxcfg's bit position in one CSR by left shift 3, each spmpxcfg size is one byte
     */
    cfg_shift = (entry_idx & (csr_cfg_num - 1)) << 3;
    addr_csr_idx = entry_idx;
 
    /* encode sPMP config */
    protection = (unsigned long)spmp_cfg->protection;
    protection |= (SPMP_SHIFT == spmp_cfg->order) ? SPMP_A_NA4 : SPMP_A_NAPOT;
    cfgmask = ~(0xFFUL << cfg_shift);
    spmpcfg = (__get_sPMPCFGx(cfg_csr_idx) & cfgmask);
    spmpcfg |= ((protection << cfg_shift) & ~cfgmask);
 
    /* encode sPMP address */
    if (SPMP_SHIFT == spmp_cfg->order) { /* NA4 */
        spmpaddr = (spmp_cfg->base_addr >> SPMP_SHIFT);
    } else { /* NAPOT */
        addrmask = (1UL << (spmp_cfg->order - SPMP_SHIFT)) - 1;
        spmpaddr = ((spmp_cfg->base_addr >> SPMP_SHIFT) & ~addrmask);
        spmpaddr |= (addrmask >> 1);
    }
    /*
     * write csrs, update the address first, in case the entry is locked that
     * we won't be able to modify it after we set the config csr.
     */
    __set_sPMPADDRx(addr_csr_idx, spmpaddr);
    __set_sPMPCFGx(cfg_csr_idx, spmpcfg);
}

References __get_sPMPCFGx(), __RISCV_XLEN, __set_sPMPADDRx(), __set_sPMPCFGx(), spmp_config::base_addr, spmp_config::order, spmp_config::protection, SPMP_A_NA4, SPMP_A_NAPOT, and SPMP_SHIFT.

__set_sPMPxCFG()

__STATIC_INLINE void __set_sPMPxCFG	(	uint32_t	entry_idx,
		uint8_t	spmpxcfg
	)

Set 8bit sPMPxCFG by spmp entry index.

Set the given spmpxcfg value to the sPMPxCFG Register.

Parameters

[in]	entry_idx	sPMPx region index(0-15)
[in]	spmpxcfg	sPMPxCFG register value to set

Remarks

• For RV32, 4 spmpxcfgs are densely packed into one CSR in order For RV64, 8 spmpxcfgs are densely packed into one CSR in order

Definition at line 179 of file core_feature_spmp.h.

{
    rv_csr_t spmpcfgx = 0;
    uint8_t csr_cfg_num = 0;
    uint16_t csr_idx = 0;
    uint16_t cfg_shift = 0;
    if (entry_idx >= __SPMP_ENTRY_NUM) return;
 
#if __RISCV_XLEN == 32
    csr_cfg_num = 4;
    csr_idx = entry_idx >> 2;
#elif __RISCV_XLEN == 64
    csr_cfg_num = 8;
    /* For RV64, spmpcfg0 and spmpcfg2 each hold 8 sPMP entries, align by 2 */
    csr_idx = (entry_idx >> 2) & ~1;
#else
    // TODO Add RV128 Handling
    return;
#endif
    /* read specific spmpcfgx register value */
    spmpcfgx = __get_sPMPCFGx(csr_idx);
    /*
     * first get specific spmpxcfg's order in one CSR composed of csr_cfg_num spmpxcfgs,
     * then get spmpxcfg's bit position in one CSR by left shift 3(each spmpxcfg size is one byte)
     */
    cfg_shift = (entry_idx & (csr_cfg_num - 1)) << 3;
 
    spmpcfgx = __RV_INSERT_FIELD(spmpcfgx, 0xFFUL << cfg_shift, spmpxcfg);
    __set_sPMPCFGx(csr_idx, spmpcfgx);
}

References __get_sPMPCFGx(), and __set_sPMPCFGx().