// 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_branch.cc
// Description: Branch Unit test
#include
#include
#include
#include
#include
#include "Vbranch_unit.h"
// Enums must match rv64_pkg::branch_op_t
enum BranchOp {
BRANCH_EQ = 0b000,
BRANCH_NE = 0b001,
BRANCH_LT = 0b100,
BRANCH_GE = 0b101,
BRANCH_LTU = 0b110,
BRANCH_GEU = 0b111
};
void test_branch(Vbranch_unit* dut, uint8_t is_branch, uint8_t op, uint64_t a, uint64_t b, uint8_t expected, const char* name) {
dut->is_branch = is_branch;
dut->branch_op = op;
dut->operand_a = a;
dut->operand_b = b;
dut->eval();
if (dut->branch_taken == expected) {
std::cout << "\033[32m[PASS] " << name << " | Expected: " << (int)expected << " Got: " << (int)dut->branch_taken << "\033[0m" << std::dec << std::endl;
} else {
std::cout << "\033[31m[FAIL] " << name << " | Expected: " << (int)expected << " Got: " << (int)dut->branch_taken << "\033[0m" << std::endl;
assert(false);
}
}
int main(int argc, char** argv) {
Verilated::commandArgs(argc, argv);
Vbranch_unit* dut = new Vbranch_unit;
std::cout << "----------------------------------" << std::endl;
std::cout << " Branch Unit Test" << std::endl;
std::cout << "----------------------------------" << std::endl;
// --- Not a branch ---
test_branch(dut, 0, BRANCH_EQ, 10, 10, 0, "Not_A_Branch");
// --- BEQ / BNE ---
test_branch(dut, 1, BRANCH_EQ, 10, 10, 1, "BEQ_Equal");
test_branch(dut, 1, BRANCH_EQ, 10, 20, 0, "BEQ_Not_Equal");
test_branch(dut, 1, BRANCH_NE, 10, 20, 1, "BNE_Not_Equal");
test_branch(dut, 1, BRANCH_NE, 10, 10, 0, "BNE_Equal");
uint64_t minus_one = (uint64_t)-1; // 0xFFFFFFFFFFFFFFFF
uint64_t one = 1;
// --- BLT / BGE (Signed) ---
// -1 is less than 1 (Signed)
test_branch(dut, 1, BRANCH_LT, minus_one, one, 1, "BLT_Signed_Negative_vs_Positive");
test_branch(dut, 1, BRANCH_GE, minus_one, one, 0, "BGE_Signed_Negative_vs_Positive");
// 1 is greater than -1 (Signed)
test_branch(dut, 1, BRANCH_LT, one, minus_one, 0, "BLT_Signed_Positive_vs_Negative");
test_branch(dut, 1, BRANCH_GE, one, minus_one, 1, "BGE_Signed_Positive_vs_Negative");
// Equal signed
test_branch(dut, 1, BRANCH_LT, minus_one, minus_one, 0, "BLT_Signed_Equal");
test_branch(dut, 1, BRANCH_GE, minus_one, minus_one, 1, "BGE_Signed_Equal");
// --- BLTU / BGEU (Unsigned) ---
// 0xFFFFFFFFFFFFFFFF is NOT less than 1 (Unsigned)
test_branch(dut, 1, BRANCH_LTU, minus_one, one, 0, "BLTU_Unsigned_Max_vs_1");
// 0xFFFFFFFFFFFFFFFF is greater than or equal to 1 (Unsigned)
test_branch(dut, 1, BRANCH_GEU, minus_one, one, 1, "BGEU_Unsigned_Max_vs_1");
// Equal unsigned
test_branch(dut, 1, BRANCH_LTU, minus_one, minus_one, 0, "BLTU_Unsigned_Equal");
test_branch(dut, 1, BRANCH_GEU, minus_one, minus_one, 1, "BGEU_Unsigned_Equal");
std::cout << "----------------------------------" << std::endl;
std::cout << "\033[32mAll tests passed!\033[0m" << std::endl;
std::cout << "----------------------------------" << std::endl;
delete dut;
return 0;
}