2 * QEMU RISC-V PMP (Physical Memory Protection)
4 * Author: Daire McNamara, daire.mcnamara@emdalo.com
5 * Ivan Griffin, ivan.griffin@emdalo.com
7 * This provides a RISC-V Physical Memory Protection implementation
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms and conditions of the GNU General Public License,
11 * version 2 or later, as published by the Free Software Foundation.
13 * This program is distributed in the hope it will be useful, but WITHOUT
14 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
18 * You should have received a copy of the GNU General Public License along with
19 * this program. If not, see <http://www.gnu.org/licenses/>.
23 * PMP (Physical Memory Protection) is as-of-yet unused and needs testing.
26 #include "qemu/osdep.h"
28 #include "qapi/error.h"
32 static void pmp_write_cfg(CPURISCVState
*env
, uint32_t addr_index
,
34 static uint8_t pmp_read_cfg(CPURISCVState
*env
, uint32_t addr_index
);
35 static void pmp_update_rule(CPURISCVState
*env
, uint32_t pmp_index
);
38 * Accessor method to extract address matching type 'a field' from cfg reg
40 static inline uint8_t pmp_get_a_field(uint8_t cfg
)
47 * Check whether a PMP is locked or not.
49 static inline int pmp_is_locked(CPURISCVState
*env
, uint32_t pmp_index
)
52 if (env
->pmp_state
.pmp
[pmp_index
].cfg_reg
& PMP_LOCK
) {
56 /* Top PMP has no 'next' to check */
57 if ((pmp_index
+ 1u) >= MAX_RISCV_PMPS
) {
61 /* In TOR mode, need to check the lock bit of the next pmp
62 * (if there is a next)
64 const uint8_t a_field
=
65 pmp_get_a_field(env
->pmp_state
.pmp
[pmp_index
+ 1].cfg_reg
);
66 if ((env
->pmp_state
.pmp
[pmp_index
+ 1u].cfg_reg
& PMP_LOCK
) &&
67 (PMP_AMATCH_TOR
== a_field
)) {
75 * Count the number of active rules.
77 static inline uint32_t pmp_get_num_rules(CPURISCVState
*env
)
79 return env
->pmp_state
.num_rules
;
83 * Accessor to get the cfg reg for a specific PMP/HART
85 static inline uint8_t pmp_read_cfg(CPURISCVState
*env
, uint32_t pmp_index
)
87 if (pmp_index
< MAX_RISCV_PMPS
) {
88 return env
->pmp_state
.pmp
[pmp_index
].cfg_reg
;
96 * Accessor to set the cfg reg for a specific PMP/HART
97 * Bounds checks and relevant lock bit.
99 static void pmp_write_cfg(CPURISCVState
*env
, uint32_t pmp_index
, uint8_t val
)
101 if (pmp_index
< MAX_RISCV_PMPS
) {
102 if (!pmp_is_locked(env
, pmp_index
)) {
103 env
->pmp_state
.pmp
[pmp_index
].cfg_reg
= val
;
104 pmp_update_rule(env
, pmp_index
);
106 qemu_log_mask(LOG_GUEST_ERROR
, "ignoring pmpcfg write - locked\n");
109 qemu_log_mask(LOG_GUEST_ERROR
,
110 "ignoring pmpcfg write - out of bounds\n");
114 static void pmp_decode_napot(target_ulong a
, target_ulong
*sa
, target_ulong
*ea
)
117 aaaa...aaa0 8-byte NAPOT range
118 aaaa...aa01 16-byte NAPOT range
119 aaaa...a011 32-byte NAPOT range
121 aa01...1111 2^XLEN-byte NAPOT range
122 a011...1111 2^(XLEN+1)-byte NAPOT range
123 0111...1111 2^(XLEN+2)-byte NAPOT range
131 target_ulong t1
= ctz64(~a
);
132 target_ulong base
= (a
& ~(((target_ulong
)1 << t1
) - 1)) << 2;
133 target_ulong range
= ((target_ulong
)1 << (t1
+ 3)) - 1;
139 void pmp_update_rule_addr(CPURISCVState
*env
, uint32_t pmp_index
)
141 uint8_t this_cfg
= env
->pmp_state
.pmp
[pmp_index
].cfg_reg
;
142 target_ulong this_addr
= env
->pmp_state
.pmp
[pmp_index
].addr_reg
;
143 target_ulong prev_addr
= 0u;
144 target_ulong sa
= 0u;
145 target_ulong ea
= 0u;
147 if (pmp_index
>= 1u) {
148 prev_addr
= env
->pmp_state
.pmp
[pmp_index
- 1].addr_reg
;
151 switch (pmp_get_a_field(this_cfg
)) {
158 sa
= prev_addr
<< 2; /* shift up from [xx:0] to [xx+2:2] */
159 ea
= (this_addr
<< 2) - 1u;
163 sa
= this_addr
<< 2; /* shift up from [xx:0] to [xx+2:2] */
167 case PMP_AMATCH_NAPOT
:
168 pmp_decode_napot(this_addr
, &sa
, &ea
);
177 env
->pmp_state
.addr
[pmp_index
].sa
= sa
;
178 env
->pmp_state
.addr
[pmp_index
].ea
= ea
;
181 void pmp_update_rule_nums(CPURISCVState
*env
)
185 env
->pmp_state
.num_rules
= 0;
186 for (i
= 0; i
< MAX_RISCV_PMPS
; i
++) {
187 const uint8_t a_field
=
188 pmp_get_a_field(env
->pmp_state
.pmp
[i
].cfg_reg
);
189 if (PMP_AMATCH_OFF
!= a_field
) {
190 env
->pmp_state
.num_rules
++;
195 /* Convert cfg/addr reg values here into simple 'sa' --> start address and 'ea'
196 * end address values.
197 * This function is called relatively infrequently whereas the check that
198 * an address is within a pmp rule is called often, so optimise that one
200 static void pmp_update_rule(CPURISCVState
*env
, uint32_t pmp_index
)
202 pmp_update_rule_addr(env
, pmp_index
);
203 pmp_update_rule_nums(env
);
206 static int pmp_is_in_range(CPURISCVState
*env
, int pmp_index
, target_ulong addr
)
210 if ((addr
>= env
->pmp_state
.addr
[pmp_index
].sa
)
211 && (addr
<= env
->pmp_state
.addr
[pmp_index
].ea
)) {
226 * Check if the address has required RWX privs to complete desired operation
228 bool pmp_hart_has_privs(CPURISCVState
*env
, target_ulong addr
,
229 target_ulong size
, pmp_priv_t privs
, target_ulong mode
)
236 pmp_priv_t allowed_privs
= 0;
238 /* Short cut if no rules */
239 if (0 == pmp_get_num_rules(env
)) {
244 if (riscv_feature(env
, RISCV_FEATURE_MMU
)) {
246 * If size is unknown (0), assume that all bytes
247 * from addr to the end of the page will be accessed.
249 pmp_size
= -(addr
| TARGET_PAGE_MASK
);
251 pmp_size
= sizeof(target_ulong
);
257 /* 1.10 draft priv spec states there is an implicit order
259 for (i
= 0; i
< MAX_RISCV_PMPS
; i
++) {
260 s
= pmp_is_in_range(env
, i
, addr
);
261 e
= pmp_is_in_range(env
, i
, addr
+ pmp_size
- 1);
263 /* partially inside */
265 qemu_log_mask(LOG_GUEST_ERROR
,
266 "pmp violation - access is partially inside\n");
272 const uint8_t a_field
=
273 pmp_get_a_field(env
->pmp_state
.pmp
[i
].cfg_reg
);
276 * If the PMP entry is not off and the address is in range, do the priv
279 if (((s
+ e
) == 2) && (PMP_AMATCH_OFF
!= a_field
)) {
280 allowed_privs
= PMP_READ
| PMP_WRITE
| PMP_EXEC
;
281 if ((mode
!= PRV_M
) || pmp_is_locked(env
, i
)) {
282 allowed_privs
&= env
->pmp_state
.pmp
[i
].cfg_reg
;
285 if ((privs
& allowed_privs
) == privs
) {
295 /* No rule matched */
298 ret
= 1; /* Privileged spec v1.10 states if no PMP entry matches an
299 * M-Mode access, the access succeeds */
301 ret
= 0; /* Other modes are not allowed to succeed if they don't
302 * match a rule, but there are rules. We've checked for
303 * no rule earlier in this function. */
307 return ret
== 1 ? true : false;
312 * Handle a write to a pmpcfg CSP
314 void pmpcfg_csr_write(CPURISCVState
*env
, uint32_t reg_index
,
320 trace_pmpcfg_csr_write(env
->mhartid
, reg_index
, val
);
322 if ((reg_index
& 1) && (sizeof(target_ulong
) == 8)) {
323 qemu_log_mask(LOG_GUEST_ERROR
,
324 "ignoring pmpcfg write - incorrect address\n");
328 for (i
= 0; i
< sizeof(target_ulong
); i
++) {
329 cfg_val
= (val
>> 8 * i
) & 0xff;
330 pmp_write_cfg(env
, (reg_index
* 4) + i
, cfg_val
);
336 * Handle a read from a pmpcfg CSP
338 target_ulong
pmpcfg_csr_read(CPURISCVState
*env
, uint32_t reg_index
)
341 target_ulong cfg_val
= 0;
342 target_ulong val
= 0;
344 for (i
= 0; i
< sizeof(target_ulong
); i
++) {
345 val
= pmp_read_cfg(env
, (reg_index
* 4) + i
);
346 cfg_val
|= (val
<< (i
* 8));
348 trace_pmpcfg_csr_read(env
->mhartid
, reg_index
, cfg_val
);
355 * Handle a write to a pmpaddr CSP
357 void pmpaddr_csr_write(CPURISCVState
*env
, uint32_t addr_index
,
360 trace_pmpaddr_csr_write(env
->mhartid
, addr_index
, val
);
361 if (addr_index
< MAX_RISCV_PMPS
) {
362 if (!pmp_is_locked(env
, addr_index
)) {
363 env
->pmp_state
.pmp
[addr_index
].addr_reg
= val
;
364 pmp_update_rule(env
, addr_index
);
366 qemu_log_mask(LOG_GUEST_ERROR
,
367 "ignoring pmpaddr write - locked\n");
370 qemu_log_mask(LOG_GUEST_ERROR
,
371 "ignoring pmpaddr write - out of bounds\n");
377 * Handle a read from a pmpaddr CSP
379 target_ulong
pmpaddr_csr_read(CPURISCVState
*env
, uint32_t addr_index
)
381 target_ulong val
= 0;
383 if (addr_index
< MAX_RISCV_PMPS
) {
384 val
= env
->pmp_state
.pmp
[addr_index
].addr_reg
;
385 trace_pmpaddr_csr_read(env
->mhartid
, addr_index
, val
);
387 qemu_log_mask(LOG_GUEST_ERROR
,
388 "ignoring pmpaddr read - out of bounds\n");
395 * Calculate the TLB size if the start address or the end address of
396 * PMP entry is presented in thie TLB page.
398 static target_ulong
pmp_get_tlb_size(CPURISCVState
*env
, int pmp_index
,
399 target_ulong tlb_sa
, target_ulong tlb_ea
)
401 target_ulong pmp_sa
= env
->pmp_state
.addr
[pmp_index
].sa
;
402 target_ulong pmp_ea
= env
->pmp_state
.addr
[pmp_index
].ea
;
404 if (pmp_sa
>= tlb_sa
&& pmp_ea
<= tlb_ea
) {
405 return pmp_ea
- pmp_sa
+ 1;
408 if (pmp_sa
>= tlb_sa
&& pmp_sa
<= tlb_ea
&& pmp_ea
>= tlb_ea
) {
409 return tlb_ea
- pmp_sa
+ 1;
412 if (pmp_ea
<= tlb_ea
&& pmp_ea
>= tlb_sa
&& pmp_sa
<= tlb_sa
) {
413 return pmp_ea
- tlb_sa
+ 1;
420 * Check is there a PMP entry which range covers this page. If so,
421 * try to find the minimum granularity for the TLB size.
423 bool pmp_is_range_in_tlb(CPURISCVState
*env
, hwaddr tlb_sa
,
424 target_ulong
*tlb_size
)
428 target_ulong tlb_ea
= (tlb_sa
+ TARGET_PAGE_SIZE
- 1);
430 for (i
= 0; i
< MAX_RISCV_PMPS
; i
++) {
431 val
= pmp_get_tlb_size(env
, i
, tlb_sa
, tlb_ea
);
433 if (*tlb_size
== 0 || *tlb_size
> val
) {
439 if (*tlb_size
!= 0) {