xref: /openbmc/qemu/target/riscv/cpu.h (revision 43dc93af)
1 /*
2  * QEMU RISC-V CPU
3  *
4  * Copyright (c) 2016-2017 Sagar Karandikar, sagark@eecs.berkeley.edu
5  * Copyright (c) 2017-2018 SiFive, Inc.
6  *
7  * This program is free software; you can redistribute it and/or modify it
8  * under the terms and conditions of the GNU General Public License,
9  * version 2 or later, as published by the Free Software Foundation.
10  *
11  * This program is distributed in the hope it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
14  * more details.
15  *
16  * You should have received a copy of the GNU General Public License along with
17  * this program.  If not, see <http://www.gnu.org/licenses/>.
18  */
19 
20 #ifndef RISCV_CPU_H
21 #define RISCV_CPU_H
22 
23 #include "hw/core/cpu.h"
24 #include "hw/registerfields.h"
25 #include "exec/cpu-defs.h"
26 #include "fpu/softfloat-types.h"
27 #include "qom/object.h"
28 #include "qemu/int128.h"
29 #include "cpu_bits.h"
30 
31 #define TCG_GUEST_DEFAULT_MO 0
32 
33 #define TYPE_RISCV_CPU "riscv-cpu"
34 
35 #define RISCV_CPU_TYPE_SUFFIX "-" TYPE_RISCV_CPU
36 #define RISCV_CPU_TYPE_NAME(name) (name RISCV_CPU_TYPE_SUFFIX)
37 #define CPU_RESOLVING_TYPE TYPE_RISCV_CPU
38 
39 #define TYPE_RISCV_CPU_ANY              RISCV_CPU_TYPE_NAME("any")
40 #define TYPE_RISCV_CPU_BASE32           RISCV_CPU_TYPE_NAME("rv32")
41 #define TYPE_RISCV_CPU_BASE64           RISCV_CPU_TYPE_NAME("rv64")
42 #define TYPE_RISCV_CPU_BASE128          RISCV_CPU_TYPE_NAME("x-rv128")
43 #define TYPE_RISCV_CPU_IBEX             RISCV_CPU_TYPE_NAME("lowrisc-ibex")
44 #define TYPE_RISCV_CPU_SHAKTI_C         RISCV_CPU_TYPE_NAME("shakti-c")
45 #define TYPE_RISCV_CPU_SIFIVE_E31       RISCV_CPU_TYPE_NAME("sifive-e31")
46 #define TYPE_RISCV_CPU_SIFIVE_E34       RISCV_CPU_TYPE_NAME("sifive-e34")
47 #define TYPE_RISCV_CPU_SIFIVE_E51       RISCV_CPU_TYPE_NAME("sifive-e51")
48 #define TYPE_RISCV_CPU_SIFIVE_U34       RISCV_CPU_TYPE_NAME("sifive-u34")
49 #define TYPE_RISCV_CPU_SIFIVE_U54       RISCV_CPU_TYPE_NAME("sifive-u54")
50 #define TYPE_RISCV_CPU_HOST             RISCV_CPU_TYPE_NAME("host")
51 
52 #if defined(TARGET_RISCV32)
53 # define TYPE_RISCV_CPU_BASE            TYPE_RISCV_CPU_BASE32
54 #elif defined(TARGET_RISCV64)
55 # define TYPE_RISCV_CPU_BASE            TYPE_RISCV_CPU_BASE64
56 #endif
57 
58 #define RV(x) ((target_ulong)1 << (x - 'A'))
59 
60 #define RVI RV('I')
61 #define RVE RV('E') /* E and I are mutually exclusive */
62 #define RVM RV('M')
63 #define RVA RV('A')
64 #define RVF RV('F')
65 #define RVD RV('D')
66 #define RVV RV('V')
67 #define RVC RV('C')
68 #define RVS RV('S')
69 #define RVU RV('U')
70 #define RVH RV('H')
71 #define RVJ RV('J')
72 
73 /* S extension denotes that Supervisor mode exists, however it is possible
74    to have a core that support S mode but does not have an MMU and there
75    is currently no bit in misa to indicate whether an MMU exists or not
76    so a cpu features bitfield is required, likewise for optional PMP support */
77 enum {
78     RISCV_FEATURE_MMU,
79     RISCV_FEATURE_PMP,
80     RISCV_FEATURE_EPMP,
81     RISCV_FEATURE_MISA,
82     RISCV_FEATURE_AIA
83 };
84 
85 #define PRIV_VERSION_1_10_0 0x00011000
86 #define PRIV_VERSION_1_11_0 0x00011100
87 
88 #define VEXT_VERSION_1_00_0 0x00010000
89 
90 enum {
91     TRANSLATE_SUCCESS,
92     TRANSLATE_FAIL,
93     TRANSLATE_PMP_FAIL,
94     TRANSLATE_G_STAGE_FAIL
95 };
96 
97 #define MMU_USER_IDX 3
98 
99 #define MAX_RISCV_PMPS (16)
100 
101 typedef struct CPURISCVState CPURISCVState;
102 
103 #if !defined(CONFIG_USER_ONLY)
104 #include "pmp.h"
105 #endif
106 
107 #define RV_VLEN_MAX 1024
108 
109 FIELD(VTYPE, VLMUL, 0, 3)
110 FIELD(VTYPE, VSEW, 3, 3)
111 FIELD(VTYPE, VTA, 6, 1)
112 FIELD(VTYPE, VMA, 7, 1)
113 FIELD(VTYPE, VEDIV, 8, 2)
114 FIELD(VTYPE, RESERVED, 10, sizeof(target_ulong) * 8 - 11)
115 
116 struct CPURISCVState {
117     target_ulong gpr[32];
118     target_ulong gprh[32]; /* 64 top bits of the 128-bit registers */
119     uint64_t fpr[32]; /* assume both F and D extensions */
120 
121     /* vector coprocessor state. */
122     uint64_t vreg[32 * RV_VLEN_MAX / 64] QEMU_ALIGNED(16);
123     target_ulong vxrm;
124     target_ulong vxsat;
125     target_ulong vl;
126     target_ulong vstart;
127     target_ulong vtype;
128     bool vill;
129 
130     target_ulong pc;
131     target_ulong load_res;
132     target_ulong load_val;
133 
134     target_ulong frm;
135 
136     target_ulong badaddr;
137     uint32_t bins;
138 
139     target_ulong guest_phys_fault_addr;
140 
141     target_ulong priv_ver;
142     target_ulong bext_ver;
143     target_ulong vext_ver;
144 
145     /* RISCVMXL, but uint32_t for vmstate migration */
146     uint32_t misa_mxl;      /* current mxl */
147     uint32_t misa_mxl_max;  /* max mxl for this cpu */
148     uint32_t misa_ext;      /* current extensions */
149     uint32_t misa_ext_mask; /* max ext for this cpu */
150     uint32_t xl;            /* current xlen */
151 
152     /* 128-bit helpers upper part return value */
153     target_ulong retxh;
154 
155     uint32_t features;
156 
157 #ifdef CONFIG_USER_ONLY
158     uint32_t elf_flags;
159 #endif
160 
161 #ifndef CONFIG_USER_ONLY
162     target_ulong priv;
163     /* This contains QEMU specific information about the virt state. */
164     target_ulong virt;
165     target_ulong geilen;
166     target_ulong resetvec;
167 
168     target_ulong mhartid;
169     /*
170      * For RV32 this is 32-bit mstatus and 32-bit mstatush.
171      * For RV64 this is a 64-bit mstatus.
172      */
173     uint64_t mstatus;
174 
175     target_ulong mip;
176 
177     uint32_t miclaim;
178 
179     target_ulong mie;
180     target_ulong mideleg;
181 
182     target_ulong satp;   /* since: priv-1.10.0 */
183     target_ulong stval;
184     target_ulong medeleg;
185 
186     target_ulong stvec;
187     target_ulong sepc;
188     target_ulong scause;
189 
190     target_ulong mtvec;
191     target_ulong mepc;
192     target_ulong mcause;
193     target_ulong mtval;  /* since: priv-1.10.0 */
194 
195     /* Machine and Supervisor interrupt priorities */
196     uint8_t miprio[64];
197     uint8_t siprio[64];
198 
199     /* Hypervisor CSRs */
200     target_ulong hstatus;
201     target_ulong hedeleg;
202     target_ulong hideleg;
203     target_ulong hcounteren;
204     target_ulong htval;
205     target_ulong htinst;
206     target_ulong hgatp;
207     target_ulong hgeie;
208     target_ulong hgeip;
209     uint64_t htimedelta;
210 
211     /* Hypervisor controlled virtual interrupt priorities */
212     uint8_t hviprio[64];
213 
214     /* Upper 64-bits of 128-bit CSRs */
215     uint64_t mscratchh;
216     uint64_t sscratchh;
217 
218     /* Virtual CSRs */
219     /*
220      * For RV32 this is 32-bit vsstatus and 32-bit vsstatush.
221      * For RV64 this is a 64-bit vsstatus.
222      */
223     uint64_t vsstatus;
224     target_ulong vstvec;
225     target_ulong vsscratch;
226     target_ulong vsepc;
227     target_ulong vscause;
228     target_ulong vstval;
229     target_ulong vsatp;
230 
231     target_ulong mtval2;
232     target_ulong mtinst;
233 
234     /* HS Backup CSRs */
235     target_ulong stvec_hs;
236     target_ulong sscratch_hs;
237     target_ulong sepc_hs;
238     target_ulong scause_hs;
239     target_ulong stval_hs;
240     target_ulong satp_hs;
241     uint64_t mstatus_hs;
242 
243     /* Signals whether the current exception occurred with two-stage address
244        translation active. */
245     bool two_stage_lookup;
246 
247     target_ulong scounteren;
248     target_ulong mcounteren;
249 
250     target_ulong sscratch;
251     target_ulong mscratch;
252 
253     /* temporary htif regs */
254     uint64_t mfromhost;
255     uint64_t mtohost;
256     uint64_t timecmp;
257 
258     /* physical memory protection */
259     pmp_table_t pmp_state;
260     target_ulong mseccfg;
261 
262     /* machine specific rdtime callback */
263     uint64_t (*rdtime_fn)(uint32_t);
264     uint32_t rdtime_fn_arg;
265 
266     /* machine specific AIA ireg read-modify-write callback */
267 #define AIA_MAKE_IREG(__isel, __priv, __virt, __vgein, __xlen) \
268     ((((__xlen) & 0xff) << 24) | \
269      (((__vgein) & 0x3f) << 20) | \
270      (((__virt) & 0x1) << 18) | \
271      (((__priv) & 0x3) << 16) | \
272      (__isel & 0xffff))
273 #define AIA_IREG_ISEL(__ireg)                  ((__ireg) & 0xffff)
274 #define AIA_IREG_PRIV(__ireg)                  (((__ireg) >> 16) & 0x3)
275 #define AIA_IREG_VIRT(__ireg)                  (((__ireg) >> 18) & 0x1)
276 #define AIA_IREG_VGEIN(__ireg)                 (((__ireg) >> 20) & 0x3f)
277 #define AIA_IREG_XLEN(__ireg)                  (((__ireg) >> 24) & 0xff)
278     int (*aia_ireg_rmw_fn[4])(void *arg, target_ulong reg,
279         target_ulong *val, target_ulong new_val, target_ulong write_mask);
280     void *aia_ireg_rmw_fn_arg[4];
281 
282     /* True if in debugger mode.  */
283     bool debugger;
284 
285     /*
286      * CSRs for PointerMasking extension
287      */
288     target_ulong mmte;
289     target_ulong mpmmask;
290     target_ulong mpmbase;
291     target_ulong spmmask;
292     target_ulong spmbase;
293     target_ulong upmmask;
294     target_ulong upmbase;
295 #endif
296     target_ulong cur_pmmask;
297     target_ulong cur_pmbase;
298 
299     float_status fp_status;
300 
301     /* Fields from here on are preserved across CPU reset. */
302     QEMUTimer *timer; /* Internal timer */
303 
304     hwaddr kernel_addr;
305     hwaddr fdt_addr;
306 
307     /* kvm timer */
308     bool kvm_timer_dirty;
309     uint64_t kvm_timer_time;
310     uint64_t kvm_timer_compare;
311     uint64_t kvm_timer_state;
312     uint64_t kvm_timer_frequency;
313 };
314 
315 OBJECT_DECLARE_TYPE(RISCVCPU, RISCVCPUClass,
316                     RISCV_CPU)
317 
318 /**
319  * RISCVCPUClass:
320  * @parent_realize: The parent class' realize handler.
321  * @parent_reset: The parent class' reset handler.
322  *
323  * A RISCV CPU model.
324  */
325 struct RISCVCPUClass {
326     /*< private >*/
327     CPUClass parent_class;
328     /*< public >*/
329     DeviceRealize parent_realize;
330     DeviceReset parent_reset;
331 };
332 
333 struct RISCVCPUConfig {
334     bool ext_i;
335     bool ext_e;
336     bool ext_g;
337     bool ext_m;
338     bool ext_a;
339     bool ext_f;
340     bool ext_d;
341     bool ext_c;
342     bool ext_s;
343     bool ext_u;
344     bool ext_h;
345     bool ext_j;
346     bool ext_v;
347     bool ext_zba;
348     bool ext_zbb;
349     bool ext_zbc;
350     bool ext_zbs;
351     bool ext_counters;
352     bool ext_ifencei;
353     bool ext_icsr;
354     bool ext_zfh;
355     bool ext_zfhmin;
356     bool ext_zve32f;
357     bool ext_zve64f;
358 
359     /* Vendor-specific custom extensions */
360     bool ext_XVentanaCondOps;
361 
362     char *priv_spec;
363     char *user_spec;
364     char *bext_spec;
365     char *vext_spec;
366     uint16_t vlen;
367     uint16_t elen;
368     bool mmu;
369     bool pmp;
370     bool epmp;
371     uint64_t resetvec;
372 };
373 
374 typedef struct RISCVCPUConfig RISCVCPUConfig;
375 
376 /**
377  * RISCVCPU:
378  * @env: #CPURISCVState
379  *
380  * A RISCV CPU.
381  */
382 struct RISCVCPU {
383     /*< private >*/
384     CPUState parent_obj;
385     /*< public >*/
386     CPUNegativeOffsetState neg;
387     CPURISCVState env;
388 
389     char *dyn_csr_xml;
390     char *dyn_vreg_xml;
391 
392     /* Configuration Settings */
393     RISCVCPUConfig cfg;
394 };
395 
396 static inline int riscv_has_ext(CPURISCVState *env, target_ulong ext)
397 {
398     return (env->misa_ext & ext) != 0;
399 }
400 
401 static inline bool riscv_feature(CPURISCVState *env, int feature)
402 {
403     return env->features & (1ULL << feature);
404 }
405 
406 static inline void riscv_set_feature(CPURISCVState *env, int feature)
407 {
408     env->features |= (1ULL << feature);
409 }
410 
411 #include "cpu_user.h"
412 
413 extern const char * const riscv_int_regnames[];
414 extern const char * const riscv_int_regnamesh[];
415 extern const char * const riscv_fpr_regnames[];
416 
417 const char *riscv_cpu_get_trap_name(target_ulong cause, bool async);
418 void riscv_cpu_do_interrupt(CPUState *cpu);
419 int riscv_cpu_write_elf64_note(WriteCoreDumpFunction f, CPUState *cs,
420                                int cpuid, void *opaque);
421 int riscv_cpu_write_elf32_note(WriteCoreDumpFunction f, CPUState *cs,
422                                int cpuid, void *opaque);
423 int riscv_cpu_gdb_read_register(CPUState *cpu, GByteArray *buf, int reg);
424 int riscv_cpu_gdb_write_register(CPUState *cpu, uint8_t *buf, int reg);
425 int riscv_cpu_hviprio_index2irq(int index, int *out_irq, int *out_rdzero);
426 uint8_t riscv_cpu_default_priority(int irq);
427 int riscv_cpu_mirq_pending(CPURISCVState *env);
428 int riscv_cpu_sirq_pending(CPURISCVState *env);
429 int riscv_cpu_vsirq_pending(CPURISCVState *env);
430 bool riscv_cpu_fp_enabled(CPURISCVState *env);
431 target_ulong riscv_cpu_get_geilen(CPURISCVState *env);
432 void riscv_cpu_set_geilen(CPURISCVState *env, target_ulong geilen);
433 bool riscv_cpu_vector_enabled(CPURISCVState *env);
434 bool riscv_cpu_virt_enabled(CPURISCVState *env);
435 void riscv_cpu_set_virt_enabled(CPURISCVState *env, bool enable);
436 bool riscv_cpu_two_stage_lookup(int mmu_idx);
437 int riscv_cpu_mmu_index(CPURISCVState *env, bool ifetch);
438 hwaddr riscv_cpu_get_phys_page_debug(CPUState *cpu, vaddr addr);
439 void  riscv_cpu_do_unaligned_access(CPUState *cs, vaddr addr,
440                                     MMUAccessType access_type, int mmu_idx,
441                                     uintptr_t retaddr) QEMU_NORETURN;
442 bool riscv_cpu_tlb_fill(CPUState *cs, vaddr address, int size,
443                         MMUAccessType access_type, int mmu_idx,
444                         bool probe, uintptr_t retaddr);
445 void riscv_cpu_do_transaction_failed(CPUState *cs, hwaddr physaddr,
446                                      vaddr addr, unsigned size,
447                                      MMUAccessType access_type,
448                                      int mmu_idx, MemTxAttrs attrs,
449                                      MemTxResult response, uintptr_t retaddr);
450 char *riscv_isa_string(RISCVCPU *cpu);
451 void riscv_cpu_list(void);
452 
453 #define cpu_list riscv_cpu_list
454 #define cpu_mmu_index riscv_cpu_mmu_index
455 
456 #ifndef CONFIG_USER_ONLY
457 bool riscv_cpu_exec_interrupt(CPUState *cs, int interrupt_request);
458 void riscv_cpu_swap_hypervisor_regs(CPURISCVState *env);
459 int riscv_cpu_claim_interrupts(RISCVCPU *cpu, uint32_t interrupts);
460 uint32_t riscv_cpu_update_mip(RISCVCPU *cpu, uint32_t mask, uint32_t value);
461 #define BOOL_TO_MASK(x) (-!!(x)) /* helper for riscv_cpu_update_mip value */
462 void riscv_cpu_set_rdtime_fn(CPURISCVState *env, uint64_t (*fn)(uint32_t),
463                              uint32_t arg);
464 void riscv_cpu_set_aia_ireg_rmw_fn(CPURISCVState *env, uint32_t priv,
465                                    int (*rmw_fn)(void *arg,
466                                                  target_ulong reg,
467                                                  target_ulong *val,
468                                                  target_ulong new_val,
469                                                  target_ulong write_mask),
470                                    void *rmw_fn_arg);
471 #endif
472 void riscv_cpu_set_mode(CPURISCVState *env, target_ulong newpriv);
473 
474 void riscv_translate_init(void);
475 void QEMU_NORETURN riscv_raise_exception(CPURISCVState *env,
476                                          uint32_t exception, uintptr_t pc);
477 
478 target_ulong riscv_cpu_get_fflags(CPURISCVState *env);
479 void riscv_cpu_set_fflags(CPURISCVState *env, target_ulong);
480 
481 #define TB_FLAGS_PRIV_MMU_MASK                3
482 #define TB_FLAGS_PRIV_HYP_ACCESS_MASK   (1 << 2)
483 #define TB_FLAGS_MSTATUS_FS MSTATUS_FS
484 #define TB_FLAGS_MSTATUS_VS MSTATUS_VS
485 
486 typedef CPURISCVState CPUArchState;
487 typedef RISCVCPU ArchCPU;
488 #include "exec/cpu-all.h"
489 
490 FIELD(TB_FLAGS, MEM_IDX, 0, 3)
491 FIELD(TB_FLAGS, LMUL, 3, 3)
492 FIELD(TB_FLAGS, SEW, 6, 3)
493 /* Skip MSTATUS_VS (0x600) bits */
494 FIELD(TB_FLAGS, VL_EQ_VLMAX, 11, 1)
495 FIELD(TB_FLAGS, VILL, 12, 1)
496 /* Skip MSTATUS_FS (0x6000) bits */
497 /* Is a Hypervisor instruction load/store allowed? */
498 FIELD(TB_FLAGS, HLSX, 15, 1)
499 FIELD(TB_FLAGS, MSTATUS_HS_FS, 16, 2)
500 FIELD(TB_FLAGS, MSTATUS_HS_VS, 18, 2)
501 /* The combination of MXL/SXL/UXL that applies to the current cpu mode. */
502 FIELD(TB_FLAGS, XL, 20, 2)
503 /* If PointerMasking should be applied */
504 FIELD(TB_FLAGS, PM_MASK_ENABLED, 22, 1)
505 FIELD(TB_FLAGS, PM_BASE_ENABLED, 23, 1)
506 
507 #ifdef TARGET_RISCV32
508 #define riscv_cpu_mxl(env)  ((void)(env), MXL_RV32)
509 #else
510 static inline RISCVMXL riscv_cpu_mxl(CPURISCVState *env)
511 {
512     return env->misa_mxl;
513 }
514 #endif
515 
516 #if defined(TARGET_RISCV32)
517 #define cpu_recompute_xl(env)  ((void)(env), MXL_RV32)
518 #else
519 static inline RISCVMXL cpu_recompute_xl(CPURISCVState *env)
520 {
521     RISCVMXL xl = env->misa_mxl;
522 #if !defined(CONFIG_USER_ONLY)
523     /*
524      * When emulating a 32-bit-only cpu, use RV32.
525      * When emulating a 64-bit cpu, and MXL has been reduced to RV32,
526      * MSTATUSH doesn't have UXL/SXL, therefore XLEN cannot be widened
527      * back to RV64 for lower privs.
528      */
529     if (xl != MXL_RV32) {
530         switch (env->priv) {
531         case PRV_M:
532             break;
533         case PRV_U:
534             xl = get_field(env->mstatus, MSTATUS64_UXL);
535             break;
536         default: /* PRV_S | PRV_H */
537             xl = get_field(env->mstatus, MSTATUS64_SXL);
538             break;
539         }
540     }
541 #endif
542     return xl;
543 }
544 #endif
545 
546 static inline int riscv_cpu_xlen(CPURISCVState *env)
547 {
548     return 16 << env->xl;
549 }
550 
551 /*
552  * Encode LMUL to lmul as follows:
553  *     LMUL    vlmul    lmul
554  *      1       000       0
555  *      2       001       1
556  *      4       010       2
557  *      8       011       3
558  *      -       100       -
559  *     1/8      101      -3
560  *     1/4      110      -2
561  *     1/2      111      -1
562  *
563  * then, we can calculate VLMAX = vlen >> (vsew + 3 - lmul)
564  * e.g. vlen = 256 bits, SEW = 16, LMUL = 1/8
565  *      => VLMAX = vlen >> (1 + 3 - (-3))
566  *               = 256 >> 7
567  *               = 2
568  */
569 static inline uint32_t vext_get_vlmax(RISCVCPU *cpu, target_ulong vtype)
570 {
571     uint8_t sew = FIELD_EX64(vtype, VTYPE, VSEW);
572     int8_t lmul = sextract32(FIELD_EX64(vtype, VTYPE, VLMUL), 0, 3);
573     return cpu->cfg.vlen >> (sew + 3 - lmul);
574 }
575 
576 void cpu_get_tb_cpu_state(CPURISCVState *env, target_ulong *pc,
577                           target_ulong *cs_base, uint32_t *pflags);
578 
579 void riscv_cpu_update_mask(CPURISCVState *env);
580 
581 RISCVException riscv_csrrw(CPURISCVState *env, int csrno,
582                            target_ulong *ret_value,
583                            target_ulong new_value, target_ulong write_mask);
584 RISCVException riscv_csrrw_debug(CPURISCVState *env, int csrno,
585                                  target_ulong *ret_value,
586                                  target_ulong new_value,
587                                  target_ulong write_mask);
588 
589 static inline void riscv_csr_write(CPURISCVState *env, int csrno,
590                                    target_ulong val)
591 {
592     riscv_csrrw(env, csrno, NULL, val, MAKE_64BIT_MASK(0, TARGET_LONG_BITS));
593 }
594 
595 static inline target_ulong riscv_csr_read(CPURISCVState *env, int csrno)
596 {
597     target_ulong val = 0;
598     riscv_csrrw(env, csrno, &val, 0, 0);
599     return val;
600 }
601 
602 typedef RISCVException (*riscv_csr_predicate_fn)(CPURISCVState *env,
603                                                  int csrno);
604 typedef RISCVException (*riscv_csr_read_fn)(CPURISCVState *env, int csrno,
605                                             target_ulong *ret_value);
606 typedef RISCVException (*riscv_csr_write_fn)(CPURISCVState *env, int csrno,
607                                              target_ulong new_value);
608 typedef RISCVException (*riscv_csr_op_fn)(CPURISCVState *env, int csrno,
609                                           target_ulong *ret_value,
610                                           target_ulong new_value,
611                                           target_ulong write_mask);
612 
613 RISCVException riscv_csrrw_i128(CPURISCVState *env, int csrno,
614                                 Int128 *ret_value,
615                                 Int128 new_value, Int128 write_mask);
616 
617 typedef RISCVException (*riscv_csr_read128_fn)(CPURISCVState *env, int csrno,
618                                                Int128 *ret_value);
619 typedef RISCVException (*riscv_csr_write128_fn)(CPURISCVState *env, int csrno,
620                                              Int128 new_value);
621 
622 typedef struct {
623     const char *name;
624     riscv_csr_predicate_fn predicate;
625     riscv_csr_read_fn read;
626     riscv_csr_write_fn write;
627     riscv_csr_op_fn op;
628     riscv_csr_read128_fn read128;
629     riscv_csr_write128_fn write128;
630 } riscv_csr_operations;
631 
632 /* CSR function table constants */
633 enum {
634     CSR_TABLE_SIZE = 0x1000
635 };
636 
637 /* CSR function table */
638 extern riscv_csr_operations csr_ops[CSR_TABLE_SIZE];
639 
640 void riscv_get_csr_ops(int csrno, riscv_csr_operations *ops);
641 void riscv_set_csr_ops(int csrno, riscv_csr_operations *ops);
642 
643 void riscv_cpu_register_gdb_regs_for_features(CPUState *cs);
644 
645 #endif /* RISCV_CPU_H */
646