diff options
Diffstat (limited to 'rv64cpu/rtl/core/include/csr_pkg.sv')
| -rw-r--r-- | rv64cpu/rtl/core/include/csr_pkg.sv | 232 |
1 files changed, 0 insertions, 232 deletions
diff --git a/rv64cpu/rtl/core/include/csr_pkg.sv b/rv64cpu/rtl/core/include/csr_pkg.sv deleted file mode 100644 index d1f9416..0000000 --- a/rv64cpu/rtl/core/include/csr_pkg.sv +++ /dev/null @@ -1,232 +0,0 @@ -// Richard CPU -// Copyright (C) 2026 Richard Qin - -// This program is free software: you can redistribute it and/or modify -// it under the terms of the GNU General Public License as published by -// the Free Software Foundation, either version 3 of the License, or -// (at your option) any later version. - -// This program is distributed in the hope that it will be useful, -// but WITHOUT ANY WARRANTY; without even the implied warranty of -// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -// GNU General Public License for more details. - -// You should have received a copy of the GNU General Public License -// along with this program. If not, see <https://www.gnu.org/licenses/>. - -// File path: rtl/core/include/csr_pkg.sv -// Description: Global enumerations, address definitions, and exception reason constants related to CSR and privilege-level architecture - -package csr_pkg; - import rv64_pkg::*; - - typedef enum logic [2:0] { - CSR_OP_NONE = 3'b000, - CSR_OP_WRITE = 3'b001, - CSR_OP_SET = 3'b010, - CSR_OP_CLEAR = 3'b011 - } csr_op_t; - - // --------------------------------- - // Floating-Point CSRs - // --------------------------------- - localparam logic [11:0] CSR_FFLAGS = 12'h001; // Floating-Point accrued exception flags - localparam logic [11:0] CSR_FRM = 12'h002; // Floating-Point dynamic rounding mode - localparam logic [11:0] CSR_FCSR = 12'h003; // Combined fflags/frm register - - // --------------------------------- - // Machine Mode CSRs (M-Mode) - // --------------------------------- - localparam logic [11:0] CSR_MVENDORID = 12'hF11; // Vendor ID - localparam logic [11:0] CSR_MARCHID = 12'hF12; // Architecture ID - localparam logic [11:0] CSR_MIMPID = 12'hF13; // Implementation ID - localparam logic [11:0] CSR_MHARTID = 12'hF14; // Hart ID - localparam logic [11:0] CSR_MCONFIGPTR= 12'hF15; // Machine Configuration Pointer - - localparam logic [11:0] CSR_MSTATUS = 12'h300; // Machine Status Register - localparam logic [11:0] CSR_MISA = 12'h301; // Machine ISA Register - localparam logic [11:0] CSR_MEDELEG = 12'h302; // Exception Delegation - localparam logic [11:0] CSR_MIDELEG = 12'h303; // Interrupt Delegation - localparam logic [11:0] CSR_MIE = 12'h304; // Machine Interrupt Enable Register - localparam logic [11:0] CSR_MTVEC = 12'h305; // Machine Trap Vector Register - localparam logic [11:0] CSR_MCOUNTEREN= 12'h306; // Machine Counter Enable Register - - localparam logic [11:0] CSR_MENVCFG = 12'h30A; // Machine Environment Configuration - localparam logic [11:0] CSR_MSTATEEN0 = 12'h30C; // Machine State Enable 0 - localparam logic [11:0] CSR_MSTATEEN1 = 12'h30D; // Machine State Enable 1 - localparam logic [11:0] CSR_MSTATEEN2 = 12'h30E; // Machine State Enable 2 - localparam logic [11:0] CSR_MSTATEEN3 = 12'h30F; // Machine State Enable 3 - - localparam logic [11:0] CSR_PMPCFG0 = 12'h3A0; // PMP Configuration Register 0 - localparam logic [11:0] CSR_PMPCFG15 = 12'h3AF; // PMP Configuration Register 15 - localparam logic [11:0] CSR_PMPADDR0 = 12'h3B0; // PMP Address Register 0 - localparam logic [11:0] CSR_PMPADDR63 = 12'h3EF; // PMP Address Register 63 - - localparam logic [11:0] CSR_MSCRATCH = 12'h340; // Machine Scratch Register - localparam logic [11:0] CSR_MEPC = 12'h341; // Machine Exception Program Counter - localparam logic [11:0] CSR_MCAUSE = 12'h342; // Machine Cause Register - localparam logic [11:0] CSR_MTVAL = 12'h343; // Machine Trap Value Register - localparam logic [11:0] CSR_MIP = 12'h344; // Machine Interrupt Pending Register - localparam logic [11:0] CSR_MTINST = 12'h34A; // Machine Trap Instruction - localparam logic [11:0] CSR_MTVAL2 = 12'h34B; // Machine Second Trap Value - - localparam logic [11:0] CSR_MCOUNTINHIBIT = 12'h320; // Machine Counter-Inhibit Register - localparam logic [11:0] CSR_MCYCLE = 12'hB00; // Machine Cycle Counter - localparam logic [11:0] CSR_MINSTRET = 12'hB02; // Machine Instruction Retired Counter - localparam logic [11:0] CSR_MHPMCOUNTER3 = 12'hB03; // Machine HPM Counter 3 - localparam logic [11:0] CSR_MHPMCOUNTER31 = 12'hB1F; // Machine HPM Counter 31 - localparam logic [11:0] CSR_MHPMEVENT3 = 12'h323; // Machine HPM Event Selector 3 - localparam logic [11:0] CSR_MHPMEVENT31 = 12'h33F; // Machine HPM Event Selector 31 - - // --------------------------------- - // Supervisor Mode CSRs (S-Mode) - // --------------------------------- - localparam logic [11:0] CSR_SSTATUS = 12'h100; // Supervisor Status Register - localparam logic [11:0] CSR_SIE = 12'h104; // Supervisor Interrupt Enable Register - localparam logic [11:0] CSR_STVEC = 12'h105; // Supervisor Trap Vector Register - localparam logic [11:0] CSR_SCOUNTEREN= 12'h106; // Supervisor Counter Enable Register - localparam logic [11:0] CSR_SENVCFG = 12'h10A; // Supervisor Environment Configuration - localparam logic [11:0] CSR_SSTATEEN0 = 12'h10C; // Supervisor State Enable 0 - localparam logic [11:0] CSR_SSTATEEN1 = 12'h10D; // Supervisor State Enable 1 - localparam logic [11:0] CSR_SSTATEEN2 = 12'h10E; // Supervisor State Enable 2 - localparam logic [11:0] CSR_SSTATEEN3 = 12'h10F; // Supervisor State Enable 3 - localparam logic [11:0] CSR_SSCRATCH = 12'h140; // Supervisor Scratch Register - localparam logic [11:0] CSR_SEPC = 12'h141; // Supervisor Exception Program Counter - localparam logic [11:0] CSR_SCAUSE = 12'h142; // Supervisor Cause Register - localparam logic [11:0] CSR_STVAL = 12'h143; // Supervisor Trap Value Register - localparam logic [11:0] CSR_SIP = 12'h144; // Supervisor Interrupt Pending Register - localparam logic [11:0] CSR_SATP = 12'h180; // Supervisor Address Translation and Protection Register - - // --------------------------------- - // Hypervisor CSRs (H-Extension) - // --------------------------------- - localparam logic [11:0] CSR_HSTATUS = 12'h600; // Hypervisor Status - localparam logic [11:0] CSR_HEDELEG = 12'h602; // Hypervisor Exception Delegation - localparam logic [11:0] CSR_HIDELEG = 12'h603; // Hypervisor Interrupt Delegation - localparam logic [11:0] CSR_HIE = 12'h604; // Hypervisor Interrupt Enable - localparam logic [11:0] CSR_HTIMEDELTA = 12'h605; // Hypervisor Timer Delta - localparam logic [11:0] CSR_HCOUNTEREN = 12'h606; // Hypervisor Counter Enable - localparam logic [11:0] CSR_HGEIE = 12'h607; // Hypervisor Guest External Interrupt Enable - localparam logic [11:0] CSR_HENVCFG = 12'h60A; // Hypervisor Environment Configuration - localparam logic [11:0] CSR_HSTATEEN0 = 12'h60C; // Hypervisor State Enable 0 - localparam logic [11:0] CSR_HSTATEEN1 = 12'h60D; // Hypervisor State Enable 1 - localparam logic [11:0] CSR_HSTATEEN2 = 12'h60E; // Hypervisor State Enable 2 - localparam logic [11:0] CSR_HSTATEEN3 = 12'h60F; // Hypervisor State Enable 3 - localparam logic [11:0] CSR_HTVAL = 12'h643; // Hypervisor Trap Value - localparam logic [11:0] CSR_HIP = 12'h644; // Hypervisor Interrupt Pending - localparam logic [11:0] CSR_HVIP = 12'h645; // Hypervisor Virtual Interrupt Pending - localparam logic [11:0] CSR_HTINST = 12'h64A; // Hypervisor Trap Instruction - localparam logic [11:0] CSR_HGATP = 12'h680; // Hypervisor Guest Address Translation and Protection - localparam logic [11:0] CSR_HGEIP = 12'hE12; // Hypervisor Guest External Interrupt Pending - - localparam logic [11:0] CSR_VSSTATUS = 12'h200; // Virtual Supervisor Status - localparam logic [11:0] CSR_VSIE = 12'h204; // Virtual Supervisor Interrupt Enable - localparam logic [11:0] CSR_VSTVEC = 12'h205; // Virtual Supervisor Trap Vector - localparam logic [11:0] CSR_VSSCRATCH = 12'h240; // Virtual Supervisor Scratch - localparam logic [11:0] CSR_VSEPC = 12'h241; // Virtual Supervisor Exception PC - localparam logic [11:0] CSR_VSCAUSE = 12'h242; // Virtual Supervisor Cause - localparam logic [11:0] CSR_VSTVAL = 12'h243; // Virtual Supervisor Trap Value - localparam logic [11:0] CSR_VSIP = 12'h244; // Virtual Supervisor Interrupt Pending - localparam logic [11:0] CSR_VSATP = 12'h280; // Virtual Supervisor Address Translation and Protection - - // --------------------------------- - // User Mode CSRs (U-Mode / URW) - // --------------------------------- - localparam logic [11:0] CSR_CYCLE = 12'hC00; // Cycle Counter - localparam logic [11:0] CSR_TIME = 12'hC01; // Timer Counter - localparam logic [11:0] CSR_INSTRET = 12'hC02; // Instruction Retired Counter - localparam logic [11:0] CSR_HPMCOUNTER3 = 12'hC03; // HPM Counter 3 - localparam logic [11:0] CSR_HPMCOUNTER31 = 12'hC1F; // HPM Counter 31 - - // --------------------------------- - // Exception Cause Codes (mcause.Interrupt == 0) - // --------------------------------- - localparam logic [XLEN-1:0] EXC_INST_ADDR_MISALIGNED = 64'd0; // Instruction Address Misaligned - localparam logic [XLEN-1:0] EXC_INST_FAULT = 64'd1; // Instruction Access Fault - localparam logic [XLEN-1:0] EXC_INST_ILLEGAL = 64'd2; // Illegal Instruction - localparam logic [XLEN-1:0] EXC_BREAKPOINT = 64'd3; // Breakpoint - localparam logic [XLEN-1:0] EXC_LOAD_ADDR_MISALIGNED = 64'd4; // Load Address Misaligned - localparam logic [XLEN-1:0] EXC_LOAD_FAULT = 64'd5; // Load Access Fault - localparam logic [XLEN-1:0] EXC_STORE_ADDR_MISALIGNED = 64'd6; // Store Address Misaligned - localparam logic [XLEN-1:0] EXC_STORE_FAULT = 64'd7; // Store Access Fault - localparam logic [XLEN-1:0] EXC_ECALL_FROM_U = 64'd8; // Environment Call from U-Mode - localparam logic [XLEN-1:0] EXC_ECALL_FROM_S = 64'd9; // Environment Call from S-Mode - localparam logic [XLEN-1:0] EXC_ECALL_FROM_M = 64'd11; // Environment Call from M-Mode - localparam logic [XLEN-1:0] EXC_INSTR_PAGE_FAULT = 64'd12; // Instruction Page Fault - localparam logic [XLEN-1:0] EXC_LOAD_PAGE_FAULT = 64'd13; // Load Page Fault - localparam logic [XLEN-1:0] EXC_STORE_PAGE_FAULT = 64'd15; // Store Page Fault - - localparam logic [XLEN-1:0] MEDELEG_WRITABLE_MASK = - (64'h1 << EXC_INST_ADDR_MISALIGNED) | - (64'h1 << EXC_INST_FAULT) | - (64'h1 << EXC_INST_ILLEGAL) | - (64'h1 << EXC_BREAKPOINT) | - (64'h1 << EXC_LOAD_ADDR_MISALIGNED) | - (64'h1 << EXC_LOAD_FAULT) | - (64'h1 << EXC_STORE_ADDR_MISALIGNED) | - (64'h1 << EXC_STORE_FAULT) | - (64'h1 << EXC_ECALL_FROM_U) | - (64'h1 << EXC_ECALL_FROM_S) | - (64'h1 << EXC_INSTR_PAGE_FAULT) | - (64'h1 << EXC_LOAD_PAGE_FAULT) | - (64'h1 << EXC_STORE_PAGE_FAULT); - - localparam logic [XLEN-1:0] MEDELEG_READ_ONLY_ONE_MASK = '0; - - // --------------------------------- - // Interrupt Cause Codes (mcause.Interrupt == 1) - // --------------------------------- - // User Mode Interrupts - localparam logic [XLEN-1:0] INTERRUPT_U_SOFTWARE = 64'd0; // User Mode Software Interrupt - localparam logic [XLEN-1:0] INTERRUPT_U_TIMER = 64'd4; // User Mode Timer Interrupt - localparam logic [XLEN-1:0] INTERRUPT_U_EXTERNAL = 64'd8; // User Mode External Interrupt - // Supervisor Mode Interrupts - localparam logic [XLEN-1:0] INTERRUPT_S_SOFTWARE = 64'd1; // Supervisor Mode Software Interrupt - localparam logic [XLEN-1:0] INTERRUPT_S_TIMER = 64'd5; // Supervisor Mode Timer Interrupt - localparam logic [XLEN-1:0] INTERRUPT_S_EXTERNAL = 64'd9; // Supervisor Mode External Interrupt - // Machine Mode Interrupts - localparam logic [XLEN-1:0] INTERRUPT_M_SOFTWARE = 64'd3; // Machine Mode Software Interrupt - localparam logic [XLEN-1:0] INTERRUPT_M_TIMER = 64'd7; // Machine Mode Timer Interrupt - localparam logic [XLEN-1:0] INTERRUPT_M_EXTERNAL = 64'd11; // Machine Mode External Interrupt - - localparam logic [XLEN-1:0] MIDELEG_WRITABLE_MASK = - (64'h1 << INTERRUPT_S_SOFTWARE) | - (64'h1 << INTERRUPT_S_TIMER) | - (64'h1 << INTERRUPT_S_EXTERNAL); - - // --------------------------------- - // Physical Memory Protection (PMP) - // --------------------------------- - localparam int PMP_ENTRY_COUNT = 64; - localparam int PMP_CFG_CSR_COUNT = 16; - localparam int PMP_CFG_ENTRIES_PER_RV64_CSR = 8; - - typedef logic [7:0] pmpcfg_entry_t; - typedef logic [XLEN-1:0] pmpaddr_entry_t; - - localparam int PMPCFG_R_BIT = 0; - localparam int PMPCFG_W_BIT = 1; - localparam int PMPCFG_X_BIT = 2; - localparam int PMPCFG_A_LO = 3; - localparam int PMPCFG_A_HI = 4; - localparam int PMPCFG_L_BIT = 7; - - localparam logic [1:0] PMP_MODE_OFF = 2'b00; - localparam logic [1:0] PMP_MODE_TOR = 2'b01; - localparam logic [1:0] PMP_MODE_NA4 = 2'b10; - localparam logic [1:0] PMP_MODE_NAPOT = 2'b11; - - // --------------------------------- - // Environment Configuration / State Enable - // --------------------------------- - localparam int ENVCFG_FIOM_BIT = 0; - localparam int ENVCFG_CBIE_LO = 4; - localparam int ENVCFG_CBIE_HI = 5; - localparam int ENVCFG_CBCFE_BIT = 6; - localparam int ENVCFG_CBZE_BIT = 7; - localparam int ENVCFG_PMM_LO = 32; - localparam int ENVCFG_PMM_HI = 33; - localparam int STATEEN0_ENVCFG_BIT = 62; - localparam int STATEEN_SE0_BIT = 63; - -endpackage |