// 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 .
// File path: tb/unit/tb_id_ex_reg.cc
// Description: ID/EX Pipeline Register unit test
#include
#include
#include
#include
#include
#include "Vid_ex_reg.h"
int pass_count = 0;
void tick(Vid_ex_reg* dut) {
dut->clk = 0;
dut->eval();
dut->clk = 1;
dut->eval();
dut->clk = 0;
dut->eval();
}
void check(bool cond, const char* name) {
if (cond) {
std::cout << "\033[32m[PASS] " << name << "\033[0m" << std::endl;
pass_count++;
} else {
std::cout << "\033[31m[FAIL] " << name << "\033[0m" << std::endl;
assert(false);
}
}
// Emulate rv64_pkg::alu_op_t
enum AluOp { ALU_ADD = 0, ALU_SUB = 8, ALU_SLL = 1, ALU_SLT = 2, ALU_SLTU = 3,
ALU_XOR = 4, ALU_SRL = 5, ALU_SRA = 13, ALU_OR = 6, ALU_AND = 7 };
int main(int argc, char** argv) {
Verilated::commandArgs(argc, argv);
Vid_ex_reg* dut = new Vid_ex_reg;
std::cout << "----------------------------------" << std::endl;
std::cout << " ID/EX Register Test" << std::endl;
std::cout << "----------------------------------" << std::endl;
// 1. Init / Reset
dut->stall_en = 0;
dut->flush_en = 0;
// Set some random ID stage inputs with dangerous states
dut->id_pc = 0x80001000;
dut->id_rs1_rdata = 0x11111111;
dut->id_rs2_rdata = 0x22222222;
dut->id_imm = 0x1A2B3C;
dut->id_alu_op = ALU_XOR;
dut->id_reg_write_en = 1;
dut->id_is_store = 1;
dut->id_is_load = 1;
dut->id_is_branch = 1;
dut->id_is_jump = 1;
dut->id_is_csr = 1;
dut->id_illegal_instr = 1;
dut->rst = 1;
tick(dut);
dut->rst = 0;
// Verify reset clears out dangerous signals
check(dut->ex_pc == 0, "Reset_Clears_PC");
check(dut->ex_reg_write_en == 0, "Reset_Clears_RegWrite");
check(dut->ex_is_store == 0, "Reset_Clears_IsStore");
check(dut->ex_is_load == 0, "Reset_Clears_IsLoad");
check(dut->ex_is_branch == 0, "Reset_Clears_IsBranch");
check(dut->ex_is_jump == 0, "Reset_Clears_IsJump");
check(dut->ex_is_csr == 0, "Reset_Clears_IsCSR");
check(dut->ex_illegal_instr == 0, "Reset_Clears_IllegalInstr");
// 2. Normal Propagation
dut->id_pc = 0x80002000;
dut->id_rs1_rdata = 0xAAAAAAAA;
dut->id_rs2_rdata = 0xBBBBBBBB;
dut->id_imm = 42;
dut->id_alu_op = ALU_ADD;
dut->id_reg_write_en = 1;
dut->id_rd_addr = 5;
dut->id_is_load = 1;
dut->id_is_branch = 0;
tick(dut);
check(dut->ex_pc == 0x80002000, "Propagate_PC");
check(dut->ex_rs1_rdata == 0xAAAAAAAA, "Propagate_RS1");
check(dut->ex_rs2_rdata == 0xBBBBBBBB, "Propagate_RS2");
check(dut->ex_imm == 42, "Propagate_IMM");
check(dut->ex_alu_op == ALU_ADD, "Propagate_ALU_OP");
check(dut->ex_reg_write_en == 1, "Propagate_RegWriteEn");
check(dut->ex_rd_addr == 5, "Propagate_RdAddr");
check(dut->ex_is_load == 1, "Propagate_IsLoad");
// 3. Stall (Freeze)
// Change input, but assert stall
dut->stall_en = 1;
dut->id_pc = 0x80003000;
dut->id_rd_addr = 10;
dut->id_reg_write_en = 0;
dut->id_is_load = 0;
tick(dut);
check(dut->ex_pc == 0x80002000, "Stall_Maintains_PC");
check(dut->ex_rd_addr == 5, "Stall_Maintains_RdAddr");
check(dut->ex_reg_write_en == 1, "Stall_Maintains_RegWriteEn");
check(dut->ex_is_load == 1, "Stall_Maintains_IsLoad");
// Release Stall
dut->stall_en = 0;
tick(dut);
check(dut->ex_pc == 0x80003000, "ReleaseStall_Captures_PC");
check(dut->ex_rd_addr == 10, "ReleaseStall_Captures_RdAddr");
check(dut->ex_reg_write_en == 0, "ReleaseStall_Captures_RegWriteEn");
// 4. Flush (Insert Bubble/NOP)
// Change input, but assert flush
dut->flush_en = 1;
dut->id_pc = 0x80004000;
dut->id_reg_write_en = 1;
dut->id_is_store = 1;
dut->id_is_branch = 1;
tick(dut);
check(dut->ex_pc == 0x0, "Flush_Clears_PC");
check(dut->ex_reg_write_en == 0, "Flush_Clears_RegWrite");
check(dut->ex_is_store == 0, "Flush_Clears_StoreEn");
check(dut->ex_is_branch == 0, "Flush_Clears_BranchEn");
// 5. Flush Overrides Stall
dut->flush_en = 0;
dut->id_pc = 0x80005000;
dut->id_reg_write_en = 1;
tick(dut);
check(dut->ex_pc == 0x80005000, "Pre_FlushStall_Setup");
dut->flush_en = 1;
dut->stall_en = 1;
dut->id_pc = 0x80006000;
tick(dut);
check(dut->ex_pc == 0x0, "Flush_Overrides_Stall_PC");
check(dut->ex_reg_write_en == 0, "Flush_Overrides_Stall_RegWrite");
std::cout << "----------------------------------" << std::endl;
std::cout << "\033[32mAll " << pass_count << " tests passed!\033[0m" << std::endl;
std::cout << "----------------------------------" << std::endl;
delete dut;
return 0;
}