// Copyright lowRISC contributors. // Copyright 2017 ETH Zurich and University of Bologna, see also CREDITS.md. // Licensed under the Apache License, Version 2.0, see LICENSE for details. // SPDX-License-Identifier: Apache-2.0 /** * Package with constants used by Ibex */ package cve2_pkg; //////////////// // IO Structs // //////////////// typedef struct packed { logic [31:0] current_pc; logic [31:0] next_pc; logic [31:0] last_data_addr; logic [31:0] exception_addr; } crash_dump_t; typedef struct packed { logic dummy_instr_id; logic [4:0] raddr_a; logic [4:0] waddr_a; logic we_a; logic [4:0] raddr_b; } core2rf_t; ///////////////////// // Parameter Enums // ///////////////////// typedef enum integer { RV32MNone = 0, RV32MSlow = 1, RV32MFast = 2, RV32MSingleCycle = 3 } rv32m_e; typedef enum integer { RV32BNone = 0, RV32BBalanced = 1, RV32BOTEarlGrey = 2, RV32BFull = 3 } rv32b_e; ///////////// // Opcodes // ///////////// typedef enum logic [6:0] { OPCODE_LOAD = 7'h03, OPCODE_MISC_MEM = 7'h0f, OPCODE_OP_IMM = 7'h13, OPCODE_AUIPC = 7'h17, OPCODE_STORE = 7'h23, OPCODE_OP = 7'h33, OPCODE_LUI = 7'h37, OPCODE_BRANCH = 7'h63, OPCODE_JALR = 7'h67, OPCODE_JAL = 7'h6f, OPCODE_SYSTEM = 7'h73 } opcode_e; //////////////////// // ALU operations // //////////////////// typedef enum logic [6:0] { // Arithmetics ALU_ADD, ALU_SUB, // Logics ALU_XOR, ALU_OR, ALU_AND, // RV32B ALU_XNOR, ALU_ORN, ALU_ANDN, // Shifts ALU_SRA, ALU_SRL, ALU_SLL, // RV32B ALU_SRO, ALU_SLO, ALU_ROR, ALU_ROL, ALU_GREV, ALU_GORC, ALU_SHFL, ALU_UNSHFL, ALU_XPERM_N, ALU_XPERM_B, ALU_XPERM_H, // Address Calculations // RV32B ALU_SH1ADD, ALU_SH2ADD, ALU_SH3ADD, // Comparisons ALU_LT, ALU_LTU, ALU_GE, ALU_GEU, ALU_EQ, ALU_NE, // RV32B ALU_MIN, ALU_MINU, ALU_MAX, ALU_MAXU, // Pack // RV32B ALU_PACK, ALU_PACKU, ALU_PACKH, // Sign-Extend // RV32B ALU_SEXTB, ALU_SEXTH, // Bitcounting // RV32B ALU_CLZ, ALU_CTZ, ALU_CPOP, // Set lower than ALU_SLT, ALU_SLTU, // Ternary Bitmanip Operations // RV32B ALU_CMOV, ALU_CMIX, ALU_FSL, ALU_FSR, // Single-Bit Operations // RV32B ALU_BSET, ALU_BCLR, ALU_BINV, ALU_BEXT, // Bit Compress / Decompress // RV32B ALU_BCOMPRESS, ALU_BDECOMPRESS, // Bit Field Place // RV32B ALU_BFP, // Carry-less Multiply // RV32B ALU_CLMUL, ALU_CLMULR, ALU_CLMULH, // Cyclic Redundancy Check ALU_CRC32_B, ALU_CRC32C_B, ALU_CRC32_H, ALU_CRC32C_H, ALU_CRC32_W, ALU_CRC32C_W } alu_op_e; typedef enum logic [1:0] { // Multiplier/divider MD_OP_MULL, MD_OP_MULH, MD_OP_DIV, MD_OP_REM } md_op_e; ////////////////////////////////// // Control and status registers // ////////////////////////////////// // CSR operations typedef enum logic [1:0] { CSR_OP_READ, CSR_OP_WRITE, CSR_OP_SET, CSR_OP_CLEAR } csr_op_e; // Privileged mode typedef enum logic[1:0] { PRIV_LVL_M = 2'b11, PRIV_LVL_H = 2'b10, PRIV_LVL_S = 2'b01, PRIV_LVL_U = 2'b00 } priv_lvl_e; // Constants for the dcsr.xdebugver fields typedef enum logic[3:0] { XDEBUGVER_NO = 4'd0, // no external debug support XDEBUGVER_STD = 4'd4, // external debug according to RISC-V debug spec XDEBUGVER_NONSTD = 4'd15 // debug not conforming to RISC-V debug spec } x_debug_ver_e; ////////////// // WB stage // ////////////// // Type of instruction present in writeback stage typedef enum logic[1:0] { WB_INSTR_LOAD, // Instruction is awaiting load data WB_INSTR_STORE, // Instruction is awaiting store response WB_INSTR_OTHER // Instruction doesn't fit into above categories } wb_instr_type_e; ////////////// // ID stage // ////////////// // Operand a selection typedef enum logic[1:0] { OP_A_REG_A, OP_A_FWD, OP_A_CURRPC, OP_A_IMM } op_a_sel_e; // Immediate a selection typedef enum logic { IMM_A_Z, IMM_A_ZERO } imm_a_sel_e; // Operand b selection typedef enum logic { OP_B_REG_B, OP_B_IMM } op_b_sel_e; // Immediate b selection typedef enum logic [2:0] { IMM_B_I, IMM_B_S, IMM_B_B, IMM_B_U, IMM_B_J, IMM_B_INCR_PC, IMM_B_INCR_ADDR } imm_b_sel_e; // Regfile write data selection typedef enum { RF_WD_EX, RF_WD_CSR, RF_WD_COPROC // Only used when XInterface = 1 } rf_wd_sel_e; ////////////// // IF stage // ////////////// // PC mux selection typedef enum logic [2:0] { PC_BOOT, PC_JUMP, PC_EXC, PC_ERET, PC_DRET, PC_BP } pc_sel_e; // Exception PC mux selection typedef enum logic [1:0] { EXC_PC_EXC, EXC_PC_IRQ, EXC_PC_DBD, EXC_PC_DBG_EXC // Exception while in debug mode } exc_pc_sel_e; // Interrupt requests typedef struct packed { logic irq_software; logic irq_timer; logic irq_external; logic [15:0] irq_fast; // 16 fast interrupts } irqs_t; // Exception cause typedef enum logic [6:0] { EXC_CAUSE_IRQ_SOFTWARE_M = {1'b1, 6'd03}, EXC_CAUSE_IRQ_TIMER_M = {1'b1, 6'd07}, EXC_CAUSE_IRQ_EXTERNAL_M = {1'b1, 6'd11}, // EXC_CAUSE_IRQ_FAST_0 = {1'b1, 6'd16}, // EXC_CAUSE_IRQ_FAST_15 = {1'b1, 6'd31}, EXC_CAUSE_IRQ_NM = {1'b1, 6'd32}, EXC_CAUSE_INSN_ADDR_MISA = {1'b0, 6'd00}, EXC_CAUSE_INSTR_ACCESS_FAULT = {1'b0, 6'd01}, EXC_CAUSE_ILLEGAL_INSN = {1'b0, 6'd02}, EXC_CAUSE_BREAKPOINT = {1'b0, 6'd03}, EXC_CAUSE_LOAD_ACCESS_FAULT = {1'b0, 6'd05}, EXC_CAUSE_STORE_ACCESS_FAULT = {1'b0, 6'd07}, EXC_CAUSE_ECALL_UMODE = {1'b0, 6'd08}, EXC_CAUSE_ECALL_MMODE = {1'b0, 6'd11} } exc_cause_e; // Debug cause typedef enum logic [2:0] { DBG_CAUSE_NONE = 3'h0, DBG_CAUSE_EBREAK = 3'h1, DBG_CAUSE_TRIGGER = 3'h2, DBG_CAUSE_HALTREQ = 3'h3, DBG_CAUSE_STEP = 3'h4 } dbg_cause_e; // PMP constants parameter int unsigned PMP_MAX_REGIONS = 16; parameter int unsigned PMP_CFG_W = 8; // PMP acces type parameter int unsigned PMP_I = 0; parameter int unsigned PMP_I2 = 1; parameter int unsigned PMP_D = 2; typedef enum logic [1:0] { PMP_ACC_EXEC = 2'b00, PMP_ACC_WRITE = 2'b01, PMP_ACC_READ = 2'b10 } pmp_req_e; // PMP cfg structures typedef enum logic [1:0] { PMP_MODE_OFF = 2'b00, PMP_MODE_TOR = 2'b01, PMP_MODE_NA4 = 2'b10, PMP_MODE_NAPOT = 2'b11 } pmp_cfg_mode_e; typedef struct packed { logic lock; pmp_cfg_mode_e mode; logic exec; logic write; logic read; } pmp_cfg_t; // Machine Security Configuration (ePMP) typedef struct packed { logic rlb; // Rule Locking Bypass logic mmwp; // Machine Mode Whitelist Policy logic mml; // Machine Mode Lockdown } pmp_mseccfg_t; // CSRs typedef enum logic[11:0] { // Machine information CSR_MVENDORID = 12'hF11, CSR_MARCHID = 12'hF12, CSR_MIMPID = 12'hF13, CSR_MHARTID = 12'hF14, CSR_MCONFIGPTR = 12'hF15, // Machine trap setup CSR_MSTATUS = 12'h300, CSR_MISA = 12'h301, CSR_MIE = 12'h304, CSR_MTVEC = 12'h305, CSR_MCOUNTEREN= 12'h306, CSR_MSTATUSH = 12'h310, CSR_MENVCFG = 12'h30A, CSR_MENVCFGH = 12'h31A, // Machine trap handling CSR_MSCRATCH = 12'h340, CSR_MEPC = 12'h341, CSR_MCAUSE = 12'h342, CSR_MTVAL = 12'h343, CSR_MIP = 12'h344, // Physical memory protection CSR_PMPCFG0 = 12'h3A0, CSR_PMPCFG1 = 12'h3A1, CSR_PMPCFG2 = 12'h3A2, CSR_PMPCFG3 = 12'h3A3, CSR_PMPADDR0 = 12'h3B0, CSR_PMPADDR1 = 12'h3B1, CSR_PMPADDR2 = 12'h3B2, CSR_PMPADDR3 = 12'h3B3, CSR_PMPADDR4 = 12'h3B4, CSR_PMPADDR5 = 12'h3B5, CSR_PMPADDR6 = 12'h3B6, CSR_PMPADDR7 = 12'h3B7, CSR_PMPADDR8 = 12'h3B8, CSR_PMPADDR9 = 12'h3B9, CSR_PMPADDR10 = 12'h3BA, CSR_PMPADDR11 = 12'h3BB, CSR_PMPADDR12 = 12'h3BC, CSR_PMPADDR13 = 12'h3BD, CSR_PMPADDR14 = 12'h3BE, CSR_PMPADDR15 = 12'h3BF, // ePMP control CSR_MSECCFG = 12'h747, CSR_MSECCFGH = 12'h757, // Debug trigger CSR_TSELECT = 12'h7A0, CSR_TDATA1 = 12'h7A1, CSR_TDATA2 = 12'h7A2, CSR_TDATA3 = 12'h7A3, CSR_MCONTEXT = 12'h7A8, CSR_SCONTEXT = 12'h7AA, // Debug/trace CSR_DCSR = 12'h7b0, CSR_DPC = 12'h7b1, // Debug CSR_DSCRATCH0 = 12'h7b2, // optional CSR_DSCRATCH1 = 12'h7b3, // optional // Machine Counter/Timers CSR_MCOUNTINHIBIT = 12'h320, CSR_MHPMEVENT3 = 12'h323, CSR_MHPMEVENT4 = 12'h324, CSR_MHPMEVENT5 = 12'h325, CSR_MHPMEVENT6 = 12'h326, CSR_MHPMEVENT7 = 12'h327, CSR_MHPMEVENT8 = 12'h328, CSR_MHPMEVENT9 = 12'h329, CSR_MHPMEVENT10 = 12'h32A, CSR_MHPMEVENT11 = 12'h32B, CSR_MHPMEVENT12 = 12'h32C, CSR_MHPMEVENT13 = 12'h32D, CSR_MHPMEVENT14 = 12'h32E, CSR_MHPMEVENT15 = 12'h32F, CSR_MHPMEVENT16 = 12'h330, CSR_MHPMEVENT17 = 12'h331, CSR_MHPMEVENT18 = 12'h332, CSR_MHPMEVENT19 = 12'h333, CSR_MHPMEVENT20 = 12'h334, CSR_MHPMEVENT21 = 12'h335, CSR_MHPMEVENT22 = 12'h336, CSR_MHPMEVENT23 = 12'h337, CSR_MHPMEVENT24 = 12'h338, CSR_MHPMEVENT25 = 12'h339, CSR_MHPMEVENT26 = 12'h33A, CSR_MHPMEVENT27 = 12'h33B, CSR_MHPMEVENT28 = 12'h33C, CSR_MHPMEVENT29 = 12'h33D, CSR_MHPMEVENT30 = 12'h33E, CSR_MHPMEVENT31 = 12'h33F, CSR_MCYCLE = 12'hB00, CSR_MINSTRET = 12'hB02, CSR_MHPMCOUNTER3 = 12'hB03, CSR_MHPMCOUNTER4 = 12'hB04, CSR_MHPMCOUNTER5 = 12'hB05, CSR_MHPMCOUNTER6 = 12'hB06, CSR_MHPMCOUNTER7 = 12'hB07, CSR_MHPMCOUNTER8 = 12'hB08, CSR_MHPMCOUNTER9 = 12'hB09, CSR_MHPMCOUNTER10 = 12'hB0A, CSR_MHPMCOUNTER11 = 12'hB0B, CSR_MHPMCOUNTER12 = 12'hB0C, CSR_MHPMCOUNTER13 = 12'hB0D, CSR_MHPMCOUNTER14 = 12'hB0E, CSR_MHPMCOUNTER15 = 12'hB0F, CSR_MHPMCOUNTER16 = 12'hB10, CSR_MHPMCOUNTER17 = 12'hB11, CSR_MHPMCOUNTER18 = 12'hB12, CSR_MHPMCOUNTER19 = 12'hB13, CSR_MHPMCOUNTER20 = 12'hB14, CSR_MHPMCOUNTER21 = 12'hB15, CSR_MHPMCOUNTER22 = 12'hB16, CSR_MHPMCOUNTER23 = 12'hB17, CSR_MHPMCOUNTER24 = 12'hB18, CSR_MHPMCOUNTER25 = 12'hB19, CSR_MHPMCOUNTER26 = 12'hB1A, CSR_MHPMCOUNTER27 = 12'hB1B, CSR_MHPMCOUNTER28 = 12'hB1C, CSR_MHPMCOUNTER29 = 12'hB1D, CSR_MHPMCOUNTER30 = 12'hB1E, CSR_MHPMCOUNTER31 = 12'hB1F, CSR_MCYCLEH = 12'hB80, CSR_MINSTRETH = 12'hB82, CSR_MHPMCOUNTER3H = 12'hB83, CSR_MHPMCOUNTER4H = 12'hB84, CSR_MHPMCOUNTER5H = 12'hB85, CSR_MHPMCOUNTER6H = 12'hB86, CSR_MHPMCOUNTER7H = 12'hB87, CSR_MHPMCOUNTER8H = 12'hB88, CSR_MHPMCOUNTER9H = 12'hB89, CSR_MHPMCOUNTER10H = 12'hB8A, CSR_MHPMCOUNTER11H = 12'hB8B, CSR_MHPMCOUNTER12H = 12'hB8C, CSR_MHPMCOUNTER13H = 12'hB8D, CSR_MHPMCOUNTER14H = 12'hB8E, CSR_MHPMCOUNTER15H = 12'hB8F, CSR_MHPMCOUNTER16H = 12'hB90, CSR_MHPMCOUNTER17H = 12'hB91, CSR_MHPMCOUNTER18H = 12'hB92, CSR_MHPMCOUNTER19H = 12'hB93, CSR_MHPMCOUNTER20H = 12'hB94, CSR_MHPMCOUNTER21H = 12'hB95, CSR_MHPMCOUNTER22H = 12'hB96, CSR_MHPMCOUNTER23H = 12'hB97, CSR_MHPMCOUNTER24H = 12'hB98, CSR_MHPMCOUNTER25H = 12'hB99, CSR_MHPMCOUNTER26H = 12'hB9A, CSR_MHPMCOUNTER27H = 12'hB9B, CSR_MHPMCOUNTER28H = 12'hB9C, CSR_MHPMCOUNTER29H = 12'hB9D, CSR_MHPMCOUNTER30H = 12'hB9E, CSR_MHPMCOUNTER31H = 12'hB9F, CSR_CPUCTRL = 12'h7C0, CSR_SECURESEED = 12'h7C1 } csr_num_e; // CSR pmp-related offsets parameter logic [11:0] CSR_OFF_PMP_CFG = 12'h3A0; // pmp_cfg @ 12'h3a0 - 12'h3a3 parameter logic [11:0] CSR_OFF_PMP_ADDR = 12'h3B0; // pmp_addr @ 12'h3b0 - 12'h3bf // CSR status bits parameter int unsigned CSR_MSTATUS_MIE_BIT = 3; parameter int unsigned CSR_MSTATUS_MPIE_BIT = 7; parameter int unsigned CSR_MSTATUS_MPP_BIT_LOW = 11; parameter int unsigned CSR_MSTATUS_MPP_BIT_HIGH = 12; parameter int unsigned CSR_MSTATUS_MPRV_BIT = 17; parameter int unsigned CSR_MSTATUS_TW_BIT = 21; // CSR machine ISA parameter logic [1:0] CSR_MISA_MXL = 2'd1; // M-XLEN: XLEN in M-Mode for RV32 // CSR interrupt pending/enable bits parameter int unsigned CSR_MSIX_BIT = 3; parameter int unsigned CSR_MTIX_BIT = 7; parameter int unsigned CSR_MEIX_BIT = 11; parameter int unsigned CSR_MFIX_BIT_LOW = 16; parameter int unsigned CSR_MFIX_BIT_HIGH = 31; // CSR Machine Security Configuration bits parameter int unsigned CSR_MSECCFG_MML_BIT = 0; parameter int unsigned CSR_MSECCFG_MMWP_BIT = 1; parameter int unsigned CSR_MSECCFG_RLB_BIT = 2; // Machine Vendor ID - OpenHW JEDEC ID is '2 decimal (bank 13)' parameter MVENDORID_OFFSET = 7'h2; // Final byte without parity bit parameter MVENDORID_BANK = 25'hC; // Number of continuation codes // Machine Architecture ID (https://github.com/riscv/riscv-isa-manual/blob/master/marchid.md) parameter MARCHID = 32'd35; localparam logic [31:0] CSR_MVENDORID_VALUE = {MVENDORID_BANK, MVENDORID_OFFSET}; localparam logic [31:0] CSR_MARCHID_VALUE = MARCHID; // Implementation ID // 0 indicates this field is not implemeted. cve2 implementors may wish to indicate an RTL/netlist // version here using their own unique encoding (e.g. 32 bits of the git hash of the implemented // commit). localparam logic [31:0] CSR_MIMPID_VALUE = 32'b0; // Machine Configuration Pointer // 0 indicates the configuration data structure does not eixst. cve2 implementors may wish to // alter this to point to their system specific configuration data structure. localparam logic [31:0] CSR_MCONFIGPTR_VALUE = 32'b0; // RVFI CSR element typedef struct packed { bit [63:0] rdata; bit [63:0] rmask; bit [63:0] wdata; bit [63:0] wmask; } rvfi_csr_elmt_t; // RVFI CSR structure typedef struct packed { rvfi_csr_elmt_t fflags; rvfi_csr_elmt_t frm; rvfi_csr_elmt_t fcsr; rvfi_csr_elmt_t ftran; rvfi_csr_elmt_t dcsr; rvfi_csr_elmt_t dpc; rvfi_csr_elmt_t dscratch0; rvfi_csr_elmt_t dscratch1; rvfi_csr_elmt_t sstatus; rvfi_csr_elmt_t sie; rvfi_csr_elmt_t sip; rvfi_csr_elmt_t stvec; rvfi_csr_elmt_t scounteren; rvfi_csr_elmt_t sscratch; rvfi_csr_elmt_t sepc; rvfi_csr_elmt_t scause; rvfi_csr_elmt_t stval; rvfi_csr_elmt_t satp; rvfi_csr_elmt_t mstatus; rvfi_csr_elmt_t mstatush; rvfi_csr_elmt_t misa; rvfi_csr_elmt_t medeleg; rvfi_csr_elmt_t mideleg; rvfi_csr_elmt_t mie; rvfi_csr_elmt_t mtvec; rvfi_csr_elmt_t mcounteren; rvfi_csr_elmt_t mscratch; rvfi_csr_elmt_t mepc; rvfi_csr_elmt_t mcause; rvfi_csr_elmt_t mtval; rvfi_csr_elmt_t mip; rvfi_csr_elmt_t menvcfg; rvfi_csr_elmt_t menvcfgh; rvfi_csr_elmt_t mvendorid; rvfi_csr_elmt_t marchid; rvfi_csr_elmt_t mhartid; rvfi_csr_elmt_t mcountinhibit; rvfi_csr_elmt_t mcycle; rvfi_csr_elmt_t mcycleh; rvfi_csr_elmt_t minstret; rvfi_csr_elmt_t minstreth; rvfi_csr_elmt_t cycle; rvfi_csr_elmt_t cycleh; rvfi_csr_elmt_t instret; rvfi_csr_elmt_t instreth; rvfi_csr_elmt_t dcache; rvfi_csr_elmt_t icache; rvfi_csr_elmt_t acc_cons; rvfi_csr_elmt_t pmpcfg0; rvfi_csr_elmt_t pmpcfg1; rvfi_csr_elmt_t pmpcfg2; rvfi_csr_elmt_t pmpcfg3; rvfi_csr_elmt_t pmpaddr0; rvfi_csr_elmt_t pmpaddr1; rvfi_csr_elmt_t pmpaddr2; rvfi_csr_elmt_t pmpaddr3; rvfi_csr_elmt_t pmpaddr4; rvfi_csr_elmt_t pmpaddr5; rvfi_csr_elmt_t pmpaddr6; rvfi_csr_elmt_t pmpaddr7; rvfi_csr_elmt_t pmpaddr8; rvfi_csr_elmt_t pmpaddr9; rvfi_csr_elmt_t pmpaddr10; rvfi_csr_elmt_t pmpaddr11; rvfi_csr_elmt_t pmpaddr12; rvfi_csr_elmt_t pmpaddr13; rvfi_csr_elmt_t pmpaddr14; rvfi_csr_elmt_t pmpaddr15; } rvfi_csr_t; // CV-X-IF parameter int unsigned X_NUM_RS = 2; parameter int unsigned X_ID_WIDTH = 4; parameter int unsigned X_RFR_WIDTH = 32; parameter int unsigned X_RFW_WIDTH = 32; parameter int unsigned X_HARTID_WIDTH = 1; parameter int unsigned X_DUAL_READ = 0; parameter int unsigned X_DUAL_WRITE = 0; typedef logic [X_NUM_RS+X_DUAL_READ-1:0] readregflags_t; typedef logic [X_DUAL_WRITE:0] writeregflags_t; typedef logic [X_ID_WIDTH-1:0] id_t; typedef logic [X_HARTID_WIDTH-1:0] hartid_t; // Issue Interface typedef struct packed { logic [31:0] instr; hartid_t hartid; id_t id; } x_issue_req_t; typedef struct packed { logic accept; writeregflags_t writeback; readregflags_t register_read; } x_issue_resp_t; // Register Interface typedef struct packed { hartid_t hartid; id_t id; logic [X_NUM_RS-1:0][X_RFR_WIDTH-1:0] rs; readregflags_t rs_valid; } x_register_t; // Commit Interface typedef struct packed { hartid_t hartid; id_t id; logic commit_kill; } x_commit_t; // Result Interface typedef struct packed { hartid_t hartid; id_t id; logic [X_RFW_WIDTH-1:0] data; logic [4:0] rd; writeregflags_t we; } x_result_t; endpackage