Files
PS2Recomp/ps2xTest/src/code_generator_tests.cpp
T
Ranieri cad1ca0bb5 Feature/added execution guess gs psmt (#104)
* fix: CRITICAL fix on code gen on generating BEQ translation, I added a small yeld because goto could spin forever and monopolize guest execution

* feat: add scratchpad alias base and improve scratchpad address handling

* feat: added debug logging on GifArbiter for submit and drain operations

* feat: add interrupt and thread management syscall implementations
fix: change some IDs calls to match ps2sdk

* feat: added vif1 logs

* feat: added logs on gs gpu
feat: added performLocalToLocalTransfer to GS emulation path for TRXDIR = 2. (emulates the PS2 GS “copy this rectangle from one place in VRAM to another”)

* feat: added PSMT8 and refactor PSMT4

* feat: some identation on vu1
feat: added some logs on vu1

* feat: added GuestExecutionScope to temporarily stop owning guest execution, then restore it exactly as it was.
feat: added vsync wizardry
feat: added some regression test

* fix: fix gs logger

* feat: remove extra logs I think they will help no one
feat: move join all threads to prevent the app to get stuck on close, but now it random crash on closing
feat: one more small test on psmt4 to try fix ghosting on re code veronica

* feat: added a small case for exporter from ghidra for metal slug 3

* feat: added ugly code to pass on test
2026-03-18 19:14:40 -03:00

1207 lines
52 KiB
C++

#include "MiniTest.h"
#include "ps2recomp/code_generator.h"
#include "ps2recomp/instructions.h"
#include "ps2recomp/ps2_recompiler.h"
#include "ps2recomp/types.h"
#include <filesystem>
#include <fstream>
#include <regex>
#include <sstream>
using namespace ps2recomp;
static Instruction makeBranch(uint32_t address, uint32_t targetOffsetWords)
{
Instruction inst;
inst.address = address;
inst.raw = 0x10000000 | (address & 0xFFFF); // arbitrary debug value
inst.opcode = OPCODE_BEQ;
inst.rs = 1;
inst.rt = 1; // always equal
inst.simmediate = static_cast<uint32_t>(targetOffsetWords);
inst.isBranch = true;
inst.hasDelaySlot = true;
return inst;
}
static Instruction makeNop(uint32_t address)
{
Instruction inst;
inst.address = address;
inst.raw = 0;
inst.opcode = OPCODE_ADDIU;
inst.rt = 0; // encode as nop in translator
inst.hasDelaySlot = false;
return inst;
}
static std::string readFileFromCandidates(const std::vector<std::string> &candidates)
{
for (const auto &path : candidates)
{
std::ifstream file(path);
if (file)
{
std::ostringstream ss;
ss << file.rdbuf();
return ss.str();
}
}
return {};
}
static std::vector<uint32_t> parseEnumValues(const std::string &text, const std::string &prefix)
{
std::vector<uint32_t> values;
std::regex re("\\b(" + prefix + "[A-Za-z0-9_]+)\\b\\s*=\\s*0x([0-9A-Fa-f]+)");
for (auto it = std::sregex_iterator(text.begin(), text.end(), re); it != std::sregex_iterator(); ++it)
{
const auto &match = *it;
uint32_t value = static_cast<uint32_t>(std::stoul(match[2].str(), nullptr, 16));
values.push_back(value);
}
return values;
}
static Instruction makeJal(uint32_t address, uint32_t target)
{
Instruction inst{};
inst.address = address;
inst.opcode = OPCODE_JAL;
inst.target = (target >> 2) & 0x3FFFFFF;
inst.hasDelaySlot = true;
inst.raw = (OPCODE_JAL << 26) | inst.target;
return inst;
}
static Instruction makeJalr(uint32_t address, uint8_t rs, uint8_t rd)
{
Instruction inst{};
inst.address = address;
inst.opcode = OPCODE_SPECIAL;
inst.function = SPECIAL_JALR;
inst.rs = rs;
inst.rd = rd; // Destination for link address (default 31)
inst.hasDelaySlot = true;
inst.raw = (OPCODE_SPECIAL << 26) | (rs << 21) | (0 << 16) | (rd << 11) | (0 << 6) | SPECIAL_JALR;
return inst;
}
static Instruction makeJr(uint32_t address, uint8_t rs)
{
Instruction inst{};
inst.address = address;
inst.opcode = OPCODE_SPECIAL;
inst.function = SPECIAL_JR;
inst.rs = rs;
inst.hasDelaySlot = true;
inst.raw = (OPCODE_SPECIAL << 26) | (rs << 21) | SPECIAL_JR;
return inst;
}
static void printGeneratedCode(const std::string& name, const std::string& code)
{
#ifdef PRINT_GENERATED_CODE
std::cout << "=== Generated Code for " << name << " ===" << std::endl;
std::cout << code << std::endl;
std::cout << "========================================" << std::endl;
#endif
}
void register_code_generator_tests()
{
MiniTest::Case("CodeGenerator", [](TestCase &tc)
{
tc.Run("R5900 MULT writes rd when rd is non-zero", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction mult{};
mult.opcode = OPCODE_SPECIAL;
mult.function = SPECIAL_MULT;
mult.rs = 4;
mult.rt = 5;
mult.rd = 3;
std::string generated = gen.translateInstruction(mult);
printGeneratedCode("R5900 MULT writes rd when rd is non-zero", generated);
t.IsTrue(generated.find("SET_GPR_S32(ctx, 3, (int32_t)result);") != std::string::npos,
"MULT should write low product to rd on R5900");
mult.rd = 0;
generated = gen.translateInstruction(mult);
t.IsTrue(generated.find("SET_GPR_S32(") == std::string::npos,
"MULT should not write rd when rd is zero");
});
tc.Run("R5900 MMI MULT1 writes rd when rd is non-zero", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction mult1{};
mult1.opcode = OPCODE_MMI;
mult1.isMMI = true;
mult1.function = MMI_MULT1;
mult1.rs = 8;
mult1.rt = 9;
mult1.rd = 10;
std::string generated = gen.translateInstruction(mult1);
printGeneratedCode("R5900 MMI MULT1 writes rd when rd is non-zero", generated);
t.IsTrue(generated.find("SET_GPR_S32(ctx, 10, (int32_t)result);") != std::string::npos,
"MULT1 should write low product to rd on R5900");
});
tc.Run("emits labels and gotos for internal branches", [](TestCase &t) {
Function func;
func.name = "test_func";
func.start = 0x1000;
func.end = 0x1020;
func.isRecompiled = true;
func.isStub = false;
// Build a small function:
// 0x1000: nop
// 0x1004: beq $1,$1, target (0x100c) with delay slot at 0x1008
// 0x1008: nop (delay slot)
// 0x100c: nop (branch target)
// 0x1010: nop (fallthrough)
std::vector<Instruction> instructions;
instructions.push_back(makeNop(0x1000));
instructions.push_back(makeBranch(0x1004, 1)); // target = 0x1004 + 4 + (1<<2) = 0x100c
instructions.push_back(makeNop(0x1008)); // delay slot
instructions.push_back(makeNop(0x100c)); // branch target
instructions.push_back(makeNop(0x1010)); // extra
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, instructions, false);
printGeneratedCode("emits labels and gotos for internal branches", generated);
t.IsTrue(generated.find("label_100c:") != std::string::npos, "branch target should emit a label");
t.IsTrue(generated.find("goto label_100c;") != std::string::npos, "internal branch should jump via goto");
t.IsTrue(generated.find("label_1008:") == std::string::npos, "delay slot without incoming branch should not get a label");
});
tc.Run("labels delay slot when it is a branch target", [](TestCase &t) {
Function func;
func.name = "delay_slot_label";
func.start = 0x2000;
func.end = 0x2020;
func.isRecompiled = true;
func.isStub = false;
// Branch at 0x2000 targets 0x2004 (its own delay slot)
std::vector<Instruction> instructions;
instructions.push_back(makeBranch(0x2000, 0)); // target = 0x2004
instructions.push_back(makeNop(0x2004)); // delay slot and target
instructions.push_back(makeNop(0x2008)); // extra
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, instructions, false);
printGeneratedCode("labels delay slot when it is a branch target", generated);
t.IsTrue(generated.find("label_2004:") != std::string::npos, "delay slot that is a target should emit a label");
t.IsTrue(generated.find("goto label_2004;") != std::string::npos, "branch to delay slot should use goto");
});
tc.Run("branches outside function still set pc", [](TestCase &t) {
Function func;
func.name = "external_branch";
func.start = 0x3000;
func.end = 0x3020;
func.isRecompiled = true;
func.isStub = false;
// Branch targets outside the function range
std::vector<Instruction> instructions;
instructions.push_back(makeBranch(0x3000, 4)); // target = 0x3014 (inside) -> make it outside by adjusting end? easier: set end smaller? Instead use large offset
instructions.clear();
Instruction br = makeBranch(0x3000, 0x100); // target far outside
instructions.push_back(br);
instructions.push_back(makeNop(0x3004)); // delay slot
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, instructions, false);
printGeneratedCode("branches outside function still set pc", generated);
t.IsTrue(generated.find("ctx->pc = 0x") != std::string::npos, "external branch should set ctx->pc");
t.IsTrue(generated.find("goto label_") == std::string::npos, "external branch should not use goto");
});
tc.Run("jumps to known symbols call by name", [](TestCase &t) {
Function func;
func.name = "call_symbol";
func.start = 0x4000;
func.end = 0x4018;
func.isRecompiled = true;
func.isStub = false;
Symbol targetSym;
targetSym.name = "target_func";
targetSym.address = 0x5000;
targetSym.isFunction = true;
Instruction j{};
j.address = 0x4000;
j.opcode = OPCODE_J;
j.target = (targetSym.address >> 2) & 0x3FFFFFF;
j.hasDelaySlot = true;
j.raw = 0x08000000 | (j.target & 0x3FFFFFF);
Instruction delay = makeNop(0x4004);
std::vector<Instruction> instructions{j, delay, makeNop(0x4008)};
CodeGenerator gen({targetSym}, {});
std::string generated = gen.generateFunction(func, instructions, false);
printGeneratedCode("jumps to known symbols call by name", generated);
t.IsTrue(generated.find("target_func(rdram, ctx, runtime); return;") != std::string::npos,
"jump to known function should emit direct call");
});
tc.Run("jump to unknown target sets pc", [](TestCase &t) {
Function func;
func.name = "jump_unknown";
func.start = 0x6000;
func.end = 0x6010;
func.isRecompiled = true;
func.isStub = false;
Instruction j{};
j.address = 0x6000;
j.opcode = OPCODE_J;
j.target = 0x001234; // target = 0x00048d0
j.hasDelaySlot = true;
j.raw = (OPCODE_J << 26) | (j.target & 0x3FFFFFF);
Instruction delay = makeNop(0x6004);
std::vector<Instruction> instructions{j, delay};
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, instructions, false);
printGeneratedCode("jump to unknown target sets pc", generated);
t.IsTrue(generated.find("ctx->pc = 0x") != std::string::npos, "unknown jump target should set ctx->pc");
t.IsTrue(generated.find("goto label_") == std::string::npos, "external jump should not use goto");
});
tc.Run("renamed function used in jump table", [](TestCase &t) {
Function func;
func.name = "jt_func";
func.start = 0x7000;
func.end = 0x7010;
func.isRecompiled = true;
func.isStub = false;
JumpTableEntry entry;
entry.index = 0;
entry.target = 0x8000;
std::vector<JumpTableEntry> entries{entry};
Instruction inst{};
inst.opcode = OPCODE_REGIMM;
CodeGenerator gen({}, {});
gen.setRenamedFunctions({{0x8000, "renamed_target"}});
std::string sw = gen.generateJumpTableSwitch(inst, 0x0, entries);
printGeneratedCode("renamed function used in jump table", sw);
t.IsTrue(sw.find("renamed_target(rdram, ctx, runtime);") != std::string::npos,
"jump table should use renamed function name");
});
tc.Run("reserved identifiers are sanitized and used in calls", [](TestCase &t) {
Function func;
func.name = "__is_pointer";
func.start = 0x9000;
func.end = 0x9010;
func.isRecompiled = true;
func.isStub = false;
Symbol targetSym;
targetSym.name = "__is_pointer";
targetSym.address = func.start;
targetSym.isFunction = true;
Instruction j{};
j.address = 0x8000;
j.opcode = OPCODE_J;
j.target = (targetSym.address >> 2) & 0x3FFFFFF;
j.hasDelaySlot = true;
j.raw = (OPCODE_J << 26) | (j.target & 0x3FFFFFF);
Instruction delay = makeNop(0x8004);
std::vector<Instruction> instructions{j, delay};
CodeGenerator gen({targetSym}, {});
gen.setRenamedFunctions({{targetSym.address, "ps2___is_pointer"}});
std::string generated = gen.generateFunction(func, instructions, false);
printGeneratedCode("reserved identifiers are sanitized and used in calls", generated);
t.IsTrue(generated.find("void ps2___is_pointer(") != std::string::npos,
"definition should use sanitized name");
t.IsTrue(generated.find("ps2___is_pointer(rdram, ctx, runtime); return;") != std::string::npos,
"call should use sanitized name but got: " + generated);
});
tc.Run("COP0 MFC0/MTC0 translate to COP0 register access", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction mfc0{};
mfc0.opcode = OPCODE_COP0;
mfc0.rs = COP0_MF;
mfc0.rt = 5;
mfc0.rd = COP0_REG_STATUS;
std::string mfc0Code = gen.translateInstruction(mfc0);
printGeneratedCode("COP0 MFC0/MTC0 translate to COP0 register access (MFC0)", mfc0Code);
t.IsTrue(mfc0Code.find("SET_GPR_S32(ctx, 5") != std::string::npos, "MFC0 should write to rt");
t.IsTrue(mfc0Code.find("ctx->cop0_status") != std::string::npos, "MFC0 STATUS should read cop0_status");
t.IsTrue(mfc0Code.find("Unimplemented COP0 register") == std::string::npos, "MFC0 should not hit unimplemented COP0 register path");
t.IsTrue(mfc0Code.find("Unhandled COP0") == std::string::npos, "MFC0 should not hit unhandled COP0 path");
Instruction mtc0{};
mtc0.opcode = OPCODE_COP0;
mtc0.rs = COP0_MT;
mtc0.rt = 7;
mtc0.rd = COP0_REG_STATUS;
std::string mtc0Code = gen.translateInstruction(mtc0);
printGeneratedCode("COP0 MFC0/MTC0 translate to COP0 register access (MTC0)", mtc0Code);
t.IsTrue(mtc0Code.find("ctx->cop0_status") != std::string::npos, "MTC0 STATUS should write cop0_status");
t.IsTrue(mtc0Code.find("GPR_U32(ctx, 7)") != std::string::npos, "MTC0 should read from rt");
t.IsTrue(mtc0Code.find("Unimplemented MTC0") == std::string::npos, "MTC0 should not hit unimplemented path");
t.IsTrue(mtc0Code.find("Unhandled COP0") == std::string::npos, "MTC0 should not hit unhandled COP0 path");
});
tc.Run("FCR access uses CFC1/CTC1", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction cfc1{};
cfc1.opcode = OPCODE_COP1;
cfc1.rs = COP1_CF;
cfc1.rt = 4;
cfc1.rd = 31;
std::string cfc1Code = gen.translateInstruction(cfc1);
printGeneratedCode("FCR access uses CFC1/CTC1 (CFC1)", cfc1Code);
t.IsTrue(cfc1Code.find("SET_GPR_U32(ctx, 4") != std::string::npos, "CFC1 should write to rt");
t.IsTrue(cfc1Code.find("ctx->fcr31") != std::string::npos, "CFC1 FCR31 should read fcr31");
t.IsTrue(cfc1Code.find("Unimplemented FCR") == std::string::npos, "CFC1 should not hit unimplemented FCR path");
Instruction ctc1{};
ctc1.opcode = OPCODE_COP1;
ctc1.rs = COP1_CT;
ctc1.rt = 4;
ctc1.rd = 31;
std::string ctc1Code = gen.translateInstruction(ctc1);
printGeneratedCode("FCR access uses CFC1/CTC1 (CTC1)", ctc1Code);
t.IsTrue(ctc1Code.find("ctx->fcr31 = GPR_U32(ctx, 4) & 0x0183FFFF") != std::string::npos,
"CTC1 FCR31 should mask and write fcr31");
t.IsTrue(ctc1Code.find("ignored") == std::string::npos, "CTC1 FCR31 should not be ignored");
});
tc.Run("VU CReg access uses CFC2/CTC2", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction cfc2{};
cfc2.opcode = OPCODE_COP2;
cfc2.rs = COP2_CFC2;
cfc2.rt = 2;
cfc2.rd = VU0_CR_STATUS;
std::string cfc2Code = gen.translateInstruction(cfc2);
printGeneratedCode("VU CReg access uses CFC2/CTC2 (CFC2)", cfc2Code);
t.IsTrue(cfc2Code.find("SET_GPR_U32(ctx, 2") != std::string::npos, "CFC2 should write to rt");
t.IsTrue(cfc2Code.find("ctx->vu0_status") != std::string::npos, "CFC2 STATUS should read vu0_status");
t.IsTrue(cfc2Code.find("Unimplemented CFC2 VU CReg") == std::string::npos, "CFC2 should not hit unimplemented CReg path");
Instruction ctc2{};
ctc2.opcode = OPCODE_COP2;
ctc2.rs = COP2_CTC2;
ctc2.rt = 3;
ctc2.rd = VU0_CR_ITOP;
std::string ctc2Code = gen.translateInstruction(ctc2);
printGeneratedCode("VU CReg access uses CFC2/CTC2 (CTC2)", ctc2Code);
t.IsTrue(ctc2Code.find("ctx->vu0_itop") != std::string::npos, "CTC2 ITOP should write vu0_itop");
t.IsTrue(ctc2Code.find("GPR_U32(ctx, 3) & 0x3FF") != std::string::npos, "CTC2 ITOP should mask to 10 bits");
t.IsTrue(ctc2Code.find("Unimplemented CTC2 VU CReg") == std::string::npos, "CTC2 should not hit unimplemented CReg path");
});
tc.Run("scalar logical immediates emit low64 operations", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction andi{};
andi.opcode = OPCODE_ANDI;
andi.rs = 4;
andi.rt = 5;
andi.immediate = 0xABCD;
std::string andiCode = gen.translateInstruction(andi);
t.IsTrue(andiCode.find("SET_GPR_U64(ctx, 5, GPR_U64(ctx, 4) & (uint64_t)(uint16_t)43981);") != std::string::npos,
"ANDI should use low64 scalar emission");
t.IsTrue(andiCode.find("SET_GPR_VEC") == std::string::npos,
"ANDI should not use vector emission");
Instruction ori{};
ori.opcode = OPCODE_ORI;
ori.rs = 6;
ori.rt = 7;
ori.immediate = 0x1234;
std::string oriCode = gen.translateInstruction(ori);
t.IsTrue(oriCode.find("SET_GPR_U64(ctx, 7, GPR_U64(ctx, 6) | (uint64_t)(uint16_t)4660);") != std::string::npos,
"ORI should use low64 scalar emission");
t.IsTrue(oriCode.find("SET_GPR_VEC") == std::string::npos,
"ORI should not use vector emission");
Instruction xori{};
xori.opcode = OPCODE_XORI;
xori.rs = 8;
xori.rt = 9;
xori.immediate = 0x00FF;
std::string xoriCode = gen.translateInstruction(xori);
t.IsTrue(xoriCode.find("SET_GPR_U64(ctx, 9, GPR_U64(ctx, 8) ^ (uint64_t)(uint16_t)255);") != std::string::npos,
"XORI should use low64 scalar emission");
t.IsTrue(xoriCode.find("SET_GPR_VEC") == std::string::npos,
"XORI should not use vector emission");
});
tc.Run("scalar logical register ops emit low64 operations", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction andInst{};
andInst.opcode = OPCODE_SPECIAL;
andInst.function = SPECIAL_AND;
andInst.rs = 2;
andInst.rt = 3;
andInst.rd = 1;
std::string andCode = gen.translateInstruction(andInst);
t.IsTrue(andCode.find("SET_GPR_U64(ctx, 1, GPR_U64(ctx, 2) & GPR_U64(ctx, 3));") != std::string::npos,
"AND should use low64 scalar emission");
Instruction orInst{};
orInst.opcode = OPCODE_SPECIAL;
orInst.function = SPECIAL_OR;
orInst.rs = 4;
orInst.rt = 5;
orInst.rd = 6;
std::string orCode = gen.translateInstruction(orInst);
t.IsTrue(orCode.find("SET_GPR_U64(ctx, 6, GPR_U64(ctx, 4) | GPR_U64(ctx, 5));") != std::string::npos,
"OR should use low64 scalar emission");
Instruction xorInst{};
xorInst.opcode = OPCODE_SPECIAL;
xorInst.function = SPECIAL_XOR;
xorInst.rs = 7;
xorInst.rt = 8;
xorInst.rd = 9;
std::string xorCode = gen.translateInstruction(xorInst);
t.IsTrue(xorCode.find("SET_GPR_U64(ctx, 9, GPR_U64(ctx, 7) ^ GPR_U64(ctx, 8));") != std::string::npos,
"XOR should use low64 scalar emission");
Instruction norInst{};
norInst.opcode = OPCODE_SPECIAL;
norInst.function = SPECIAL_NOR;
norInst.rs = 10;
norInst.rt = 11;
norInst.rd = 12;
std::string norCode = gen.translateInstruction(norInst);
t.IsTrue(norCode.find("SET_GPR_U64(ctx, 12, ~(GPR_U64(ctx, 10) | GPR_U64(ctx, 11)));") != std::string::npos,
"NOR should use low64 scalar emission");
t.IsTrue(norCode.find("SET_GPR_VEC") == std::string::npos,
"SPECIAL logical ops should not use vector emission");
});
tc.Run("SC requires matching LL reservation address", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction sc{};
sc.opcode = OPCODE_SC;
sc.rs = 9;
sc.rt = 10;
sc.simmediate = static_cast<uint32_t>(static_cast<int16_t>(4));
std::string out = gen.translateInstruction(sc);
t.IsTrue(out.find("ctx->llbit && ctx->lladdr == addr") != std::string::npos,
"SC must require both llbit and matching lladdr");
t.IsTrue(out.find("ctx->llbit = 0; ctx->lladdr = 0;") != std::string::npos,
"SC must clear reservation state after attempting the store");
});
tc.Run("QFSRV translation uses runtime helper macro", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction qfsrv{};
qfsrv.isMMI = true;
qfsrv.opcode = OPCODE_MMI;
qfsrv.function = MMI_MMI1;
qfsrv.sa = MMI1_QFSRV;
qfsrv.rd = 3;
qfsrv.rs = 4;
qfsrv.rt = 5;
std::string out = gen.translateInstruction(qfsrv);
t.IsTrue(out.find("PS2_QFSRV(GPR_VEC(ctx, 4), GPR_VEC(ctx, 5), ctx->sa & 0x7F)") != std::string::npos,
"QFSRV should map to PS2_QFSRV with rs/rt ordering");
});
tc.Run("PCPYLD and PEXEW use runtime helper macros", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction pcpyld{};
pcpyld.isMMI = true;
pcpyld.opcode = OPCODE_MMI;
pcpyld.function = MMI_MMI2;
pcpyld.sa = MMI2_PCPYLD;
pcpyld.rd = 6;
pcpyld.rs = 7;
pcpyld.rt = 8;
std::string pcpyldOut = gen.translateInstruction(pcpyld);
t.IsTrue(pcpyldOut.find("PS2_PCPYLD(GPR_VEC(ctx, 7), GPR_VEC(ctx, 8))") != std::string::npos,
"PCPYLD should use PS2_PCPYLD helper");
Instruction pexew{};
pexew.isMMI = true;
pexew.opcode = OPCODE_MMI;
pexew.function = MMI_MMI2;
pexew.sa = MMI2_PEXEW;
pexew.rd = 9;
pexew.rs = 10;
std::string pexewOut = gen.translateInstruction(pexew);
t.IsTrue(pexewOut.find("PS2_PEXEW(GPR_VEC(ctx, 10))") != std::string::npos,
"PEXEW should use PS2_PEXEW helper");
});
tc.Run("VU0 macro mappings cover all S1/S2 enums", [](TestCase &t) {
const std::vector<std::string> candidates = {
"ps2xRecomp/include/ps2recomp/instructions.h",
"../ps2xRecomp/include/ps2recomp/instructions.h",
"../../ps2xRecomp/include/ps2recomp/instructions.h"
};
std::string text = readFileFromCandidates(candidates);
t.IsTrue(!text.empty(), "instructions.h should be readable from the test working directory");
std::vector<uint32_t> s1 = parseEnumValues(text, "VU0_S1_");
std::vector<uint32_t> s2 = parseEnumValues(text, "VU0_S2_");
t.IsTrue(!s1.empty(), "VU0_S1 enum list should not be empty");
t.IsTrue(!s2.empty(), "VU0_S2 enum list should not be empty");
CodeGenerator gen({}, {});
for (uint32_t value : s1)
{
Instruction inst;
inst.opcode = OPCODE_COP2;
inst.rs = COP2_CO; // format
inst.rt = 2;
inst.rd = 3;
inst.function = value;
inst.vectorInfo.vectorField = 0xF;
std::string out = gen.translateInstruction(inst);
std::ostringstream msg;
msg << "VU0 S1 0x" << std::hex << value << " should be mapped";
t.IsTrue(out.find("Unhandled VU0 Special1") == std::string::npos, msg.str().c_str());
}
for (uint32_t value : s2)
{
Instruction inst;
inst.opcode = OPCODE_COP2;
inst.rs = COP2_CO; // format
inst.rt = 2;
inst.rd = 3;
inst.function = 0x3C; // force Special2 path
inst.vectorInfo.vectorField = 0xF;
uint32_t upper = (value >> 2) & 0x1F;
uint32_t lower = value & 0x3;
inst.raw = (upper << 6) | lower;
std::string out = gen.translateInstruction(inst);
std::ostringstream msg;
msg << "VU0 S2 0x" << std::hex << value << " should be mapped";
t.IsTrue(out.find("Unhandled VU0 Special2") == std::string::npos, msg.str().c_str());
}
});
tc.Run("VU0 S1 uses fd/fs/ft fields (sa/rd/rt)", [](TestCase &t) {
Instruction inst{};
inst.opcode = OPCODE_COP2;
inst.rs = COP2_CO | 0xB; // format + destination mask bits, not a VF register index
inst.rt = 7;
inst.rd = 11;
inst.sa = 3;
inst.function = VU0_S1_VADD;
inst.vectorInfo.vectorField = 0xF;
CodeGenerator gen({}, {});
std::string out = gen.translateInstruction(inst);
t.IsTrue(out.find("ctx->vu0_vf[11]") != std::string::npos, "S1 fs should come from rd");
t.IsTrue(out.find("ctx->vu0_vf[7]") != std::string::npos, "S1 ft should come from rt");
t.IsTrue(out.find("ctx->vu0_vf[3]") != std::string::npos, "S1 fd should come from sa");
t.IsTrue(out.find("ctx->vu0_vf[27]") == std::string::npos, "S1 must not use rs(format) as register index");
});
tc.Run("VU0 S1 q/i forms keep mask and use sa as destination", [](TestCase &t) {
Instruction inst{};
inst.opcode = OPCODE_COP2;
inst.rs = COP2_CO | 0x9; // format + destination mask bits
inst.rt = 5;
inst.rd = 13;
inst.sa = 4;
inst.function = VU0_S1_VADDq;
inst.vectorInfo.vectorField = 0x9;
CodeGenerator gen({}, {});
std::string out = gen.translateInstruction(inst);
t.IsTrue(out.find("_mm_blendv_ps") != std::string::npos, "S1 q/i form should honor destination mask");
t.IsTrue(out.find("ctx->vu0_vf[13]") != std::string::npos, "S1 q/i source should come from rd");
t.IsTrue(out.find("ctx->vu0_vf[4]") != std::string::npos, "S1 q/i destination should come from sa");
t.IsTrue(out.find("ctx->vu0_vf[25]") == std::string::npos, "S1 q/i must not use rs(format) as register index");
});
tc.Run("VU0 S2 vector ops use rd as source and rt as destination", [](TestCase &t) {
Instruction inst{};
inst.opcode = OPCODE_COP2;
inst.rs = COP2_CO | 0x6; // format + destination mask bits
inst.rt = 8;
inst.rd = 12;
inst.function = 0x3C; // force Special2 path
inst.vectorInfo.vectorField = 0xF;
uint32_t upper = (VU0_S2_VABS >> 2) & 0x1F;
uint32_t lower = VU0_S2_VABS & 0x3;
inst.raw = (upper << 6) | lower;
CodeGenerator gen({}, {});
std::string out = gen.translateInstruction(inst);
t.IsTrue(out.find("ctx->vu0_vf[12]") != std::string::npos, "S2 source VF should come from rd");
t.IsTrue(out.find("ctx->vu0_vf[8]") != std::string::npos, "S2 destination VF should come from rt");
t.IsTrue(out.find("ctx->vu0_vf[22]") == std::string::npos, "S2 must not use rs(format) as register index");
});
tc.Run("VU0 S2 VI memory ops use rd as VI base register", [](TestCase &t) {
Instruction inst{};
inst.opcode = OPCODE_COP2;
inst.rs = COP2_CO | 0x4; // format + destination mask bits
inst.rt = 6;
inst.rd = 14;
inst.function = 0x3C; // force Special2 path
inst.vectorInfo.vectorField = 0xF;
uint32_t upper = (VU0_S2_VLQI >> 2) & 0x1F;
uint32_t lower = VU0_S2_VLQI & 0x3;
inst.raw = (upper << 6) | lower;
CodeGenerator gen({}, {});
std::string out = gen.translateInstruction(inst);
t.IsTrue(out.find("ctx->vi[14]") != std::string::npos, "S2 VLQI base VI should come from rd");
t.IsTrue(out.find("ctx->vu0_vf[6]") != std::string::npos, "S2 VLQI destination VF should come from rt");
t.IsTrue(out.find("ctx->vi[20]") == std::string::npos, "S2 VLQI must not use rs(format) as VI index");
});
tc.Run("JAL to known function emits call and check", [](TestCase &t) {
Function func;
func.name = "jal_test";
func.start = 0xA000;
func.end = 0xA020;
func.isRecompiled = true;
func.isStub = false;
Symbol targetSym;
targetSym.name = "some_func";
targetSym.address = 0xB000;
targetSym.isFunction = true;
// 0xA000: JAL 0xB000
// 0xA004: NOP (delay slot)
Instruction jal = makeJal(0xA000, 0xB000);
Instruction delay = makeNop(0xA004);
CodeGenerator gen({targetSym}, {});
std::string generated = gen.generateFunction(func, {jal, delay}, false);
printGeneratedCode("JAL to known function emits call and check", generated);
// Expect:
// SET_GPR_U32(ctx, 31, 0xA008u);
// ctx->pc = 0xA004u;
// ... delay slot ...
// some_func(rdram, ctx, runtime);
// if (ctx->pc != 0xA008u) { return; }
t.IsTrue(generated.find("SET_GPR_U32(ctx, 31, 0xA008u);") != std::string::npos, "JAL should set RA");
t.IsTrue(generated.find("some_func(rdram, ctx, runtime);") != std::string::npos, "JAL should call function");
t.IsTrue(generated.find("const uint32_t __entryPc = ctx->pc;") != std::string::npos,
"JAL should capture entry PC before call");
t.IsTrue(generated.find("if (ctx->pc == __entryPc) { ctx->pc = 0xA008u; }") != std::string::npos,
"JAL should recover fallthrough when callee leaves ctx->pc unchanged");
t.IsTrue(generated.find("if (ctx->pc != 0xA008u) { return; }") != std::string::npos, "JAL should check return PC");
});
tc.Run("trailing JAL without decoded delay slot still emits call flow", [](TestCase &t) {
Function func;
func.name = "jal_truncated";
func.start = 0xA100;
func.end = 0xA108;
func.isRecompiled = true;
func.isStub = false;
Symbol targetSym;
targetSym.name = "some_func";
targetSym.address = 0xB000;
targetSym.isFunction = true;
Instruction jal = makeJal(0xA100, 0xB000);
CodeGenerator gen({targetSym}, {});
std::string generated = gen.generateFunction(func, {jal}, false);
printGeneratedCode("trailing JAL without decoded delay slot still emits call flow", generated);
t.IsTrue(generated.find("SET_GPR_U32(ctx, 31, 0xA108u);") != std::string::npos,
"truncated trailing JAL should still set RA");
t.IsTrue(generated.find("some_func(rdram, ctx, runtime);") != std::string::npos,
"truncated trailing JAL should still emit the call");
t.IsTrue(generated.find("if (ctx->pc != 0xA108u) { return; }") != std::string::npos,
"truncated trailing JAL should still enforce fallthrough");
t.IsTrue(generated.find("// JAL 0xB000 - Handled by branch logic") == std::string::npos,
"truncated trailing JAL must not degrade to comment-only output");
});
tc.Run("JAL to internal target becomes goto", [](TestCase &t) {
Function func;
func.name = "jal_internal";
func.start = 0xC000;
func.end = 0xC020;
func.isRecompiled = true;
func.isStub = false;
// 0xC000: JAL 0xC010
// 0xC004: NOP
// ...
// 0xC010: NOP
Instruction jal = makeJal(0xC000, 0xC010);
Instruction delay = makeNop(0xC004);
Instruction targetInst = makeNop(0xC010);
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, {jal, delay, targetInst}, false);
printGeneratedCode("JAL to internal target becomes goto", generated);
t.IsTrue(generated.find("SET_GPR_U32(ctx, 31, 0xC008u);") != std::string::npos, "Internal JAL should set RA");
t.IsTrue(generated.find("goto label_c010;") != std::string::npos, "Internal JAL should use goto");
});
tc.Run("JALR emits indirect call", [](TestCase &t) {
Function func;
func.name = "jalr_test";
func.start = 0xD000;
func.end = 0xD020;
func.isRecompiled = true;
func.isStub = false;
// 0xD000: JALR $4, $31 (call addr in $4, link to $31)
// 0xD004: NOP
Instruction jalr = makeJalr(0xD000, 4, 31);
Instruction delay = makeNop(0xD004);
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, {jalr, delay}, false);
printGeneratedCode("JALR emits indirect call", generated);
t.IsTrue(generated.find("uint32_t jumpTarget = GPR_U32(ctx, 4);") != std::string::npos, "JALR should read target from RS");
t.IsTrue(generated.find("SET_GPR_U32(ctx, 31, 0xD008u);") != std::string::npos, "JALR should set link register");
t.IsTrue(generated.find("auto targetFn = runtime->lookupFunction(jumpTarget);") != std::string::npos, "JALR should lookup function");
t.IsTrue(generated.find("targetFn(rdram, ctx, runtime);") != std::string::npos, "JALR should call function");
t.IsTrue(generated.find("const uint32_t __entryPc = ctx->pc;") != std::string::npos,
"JALR should capture entry PC before indirect call");
t.IsTrue(generated.find("if (ctx->pc == __entryPc) { ctx->pc = 0xD008u; }") != std::string::npos,
"JALR should recover fallthrough when callee leaves ctx->pc unchanged");
t.IsTrue(generated.find("if (ctx->pc != 0xD008u) { return; }") != std::string::npos, "JALR should check return PC");
});
tc.Run("backward BEQ yields cooperatively on sign-extended internal loop", [](TestCase &t) {
Function func;
func.name = "backward_branch";
func.start = 0x1100;
func.end = 0x1120;
func.isRecompiled = true;
func.isStub = false;
// 0x1100: nop
// 0x1104: beq $1,$1, target 0x1100 (offset = -2 words)
// 0x1108: nop (delay)
std::vector<Instruction> instructions;
instructions.push_back(makeNop(0x1100));
Instruction br = makeBranch(0x1104, 0);
br.simmediate = static_cast<uint32_t>(static_cast<int16_t>(-2));
instructions.push_back(br);
instructions.push_back(makeNop(0x1108));
instructions.push_back(makeNop(0x110c));
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, instructions, false);
printGeneratedCode("backward BEQ yields cooperatively on sign-extended internal loop", generated);
t.IsTrue(generated.find("label_1100:") != std::string::npos, "target should emit a label");
t.IsTrue(generated.find("ctx->pc = 0x1100u;") != std::string::npos,
"backward internal branch should preserve the loop target in ctx->pc");
t.IsTrue(generated.find("runtime->cooperativeGuestYield();") != std::string::npos,
"backward internal branch should yield guest execution before re-entering the loop");
t.IsTrue(generated.find("goto label_1100;") != std::string::npos,
"backward internal branch should re-enter the in-function label after yielding");
t.IsTrue(generated.find("ctx->pc = 0x1100u;\n return;") == std::string::npos,
"backward internal branch should not return to the dispatcher for a non-entry internal label");
});
tc.Run("branch-likely places delay slot only in taken path", [](TestCase &t) {
Function func;
func.name = "branch_likely";
func.start = 0x1200;
func.end = 0x1220;
func.isRecompiled = true;
func.isStub = false;
Instruction br{};
br.address = 0x1200;
br.opcode = OPCODE_BEQL; // likely
br.rs = 1;
br.rt = 2;
br.simmediate = 1; // target = 0x1208
br.isBranch = true;
br.hasDelaySlot = true;
br.raw = 0;
Instruction delay{};
delay.address = 0x1204;
delay.opcode = OPCODE_ADDIU;
delay.rs = 0;
delay.rt = 7; // make it non-nop so translation is distinctive
delay.simmediate = 123;
delay.raw = 0;
Instruction target = makeNop(0x1208);
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, { br, delay, target }, false);
printGeneratedCode("branch-likely places delay slot only in taken path", generated);
t.IsTrue(generated.find("SET_GPR_S32(ctx, 7,") != std::string::npos, "delay slot should be translated");
t.IsTrue(generated.find("if (branch_taken_0x1200)") != std::string::npos, "should generate branch_taken variable and if for likely branch");
});
tc.Run("JR $31 emits switch for internal return targets", [](TestCase &t) {
Function func;
func.name = "jr_ra_switch";
func.start = 0x1300;
func.end = 0x1340;
func.isRecompiled = true;
func.isStub = false;
// Create an internal JAL with an explicit instruction at returnAddr (0x1308).
Instruction jal = makeJal(0x1300, 0x1310);
Instruction jalDelay = makeNop(0x1304);
Instruction atReturn = makeNop(0x1308);
Instruction atTarget = makeNop(0x1310);
// JR $31 at 0x1314 with delay slot at 0x1318
Instruction jr = makeJr(0x1314, 31);
Instruction jrDelay = makeNop(0x1318);
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, { jal, jalDelay, atReturn, atTarget, jr, jrDelay }, false);
printGeneratedCode("JR $31 emits switch for internal return targets", generated);
t.IsTrue(generated.find("switch (jumpTarget)") != std::string::npos, "JR $31 should emit switch for internal targets");
t.IsTrue(generated.find("case 0x1308u: goto label_1308;") != std::string::npos, "switch should include return address from internal JAL");
});
tc.Run("trailing JR $31 without decoded delay slot still emits return flow", [](TestCase &t) {
Function func;
func.name = "jr_ra_truncated";
func.start = 0x1500;
func.end = 0x1540;
func.isRecompiled = true;
func.isStub = false;
Instruction jal = makeJal(0x1500, 0x1510);
Instruction jalDelay = makeNop(0x1504);
Instruction atReturn = makeNop(0x1508);
Instruction atTarget = makeNop(0x1510);
Instruction jr = makeJr(0x1514, 31);
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, {jal, jalDelay, atReturn, atTarget, jr}, false);
printGeneratedCode("trailing JR $31 without decoded delay slot still emits return flow", generated);
t.IsTrue(generated.find("uint32_t jumpTarget = GPR_U32(ctx, 31);") != std::string::npos,
"truncated trailing JR should still read the return target");
t.IsTrue(generated.find("switch (jumpTarget)") != std::string::npos,
"truncated trailing JR should still emit the return-target switch");
t.IsTrue(generated.find("case 0x1508u: goto label_1508;") != std::string::npos,
"truncated trailing JR should still include internal return targets");
t.IsTrue(generated.find("// JR $31 - Handled by branch logic") == std::string::npos,
"truncated trailing JR must not degrade to comment-only output");
});
tc.Run("JR non-RA emits switch for in-function jump targets", [](TestCase &t) {
Function func;
func.name = "jr_non_ra_switch";
func.start = 0x1400;
func.end = 0x1420;
func.isRecompiled = true;
func.isStub = false;
// 0x1400: nop
// 0x1404: jr $16 (register jump)
// 0x1408: nop (delay slot)
// 0x140c: nop
Instruction i0 = makeNop(0x1400);
Instruction jr = makeJr(0x1404, 16);
Instruction delay = makeNop(0x1408);
Instruction i3 = makeNop(0x140c);
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, {i0, jr, delay, i3}, false);
printGeneratedCode("JR non-RA emits switch for in-function jump targets", generated);
t.IsTrue(generated.find("switch (jumpTarget)") != std::string::npos,
"JR via non-RA register should emit switch for internal targets");
t.IsTrue(generated.find("case 0x1400u: goto label_1400;") != std::string::npos,
"switch should include in-function entry label");
t.IsTrue(generated.find("case 0x140Cu: goto label_140c;") != std::string::npos,
"switch should include other in-function labels");
});
tc.Run("configured jump table addresses drive JR dispatch targets", [](TestCase &t) {
Function func;
func.name = "jr_configured_jump_table";
func.start = 0x1600;
func.end = 0x1640;
func.isRecompiled = true;
func.isStub = false;
constexpr uint32_t tableAddress = 0x00200000u;
Instruction lui{};
lui.address = 0x1600;
lui.opcode = OPCODE_LUI;
lui.rt = 9;
lui.immediate = static_cast<uint16_t>((tableAddress >> 16) & 0xFFFFu);
Instruction addiu{};
addiu.address = 0x1604;
addiu.opcode = OPCODE_ADDIU;
addiu.rs = 9;
addiu.rt = 9;
addiu.immediate = static_cast<uint16_t>(tableAddress & 0xFFFFu);
addiu.simmediate = addiu.immediate;
Instruction sll{};
sll.address = 0x1608;
sll.opcode = OPCODE_SPECIAL;
sll.function = SPECIAL_SLL;
sll.rd = 8;
sll.rt = 4;
sll.sa = 2;
Instruction addu{};
addu.address = 0x160C;
addu.opcode = OPCODE_SPECIAL;
addu.function = SPECIAL_ADDU;
addu.rs = 9;
addu.rt = 8;
addu.rd = 9;
Instruction lw{};
lw.address = 0x1610;
lw.opcode = OPCODE_LW;
lw.rs = 9;
lw.rt = 10;
lw.immediate = 0;
lw.simmediate = 0;
Instruction jr = makeJr(0x1614, 10);
Instruction jrDelay = makeNop(0x1618);
Instruction target0 = makeNop(0x1620);
Instruction target1 = makeNop(0x1630);
JumpTable configured{};
configured.address = tableAddress;
configured.entries.push_back({0u, 0x1620u});
configured.entries.push_back({1u, 0x1630u});
CodeGenerator gen({}, {});
gen.setConfiguredJumpTables({configured});
std::string generated = gen.generateFunction(
func,
{lui, addiu, sll, addu, lw, jr, jrDelay, target0, target1},
false);
printGeneratedCode("configured jump table addresses drive JR dispatch targets", generated);
t.IsTrue(generated.find("switch (jumpTarget)") != std::string::npos,
"JR should emit a switch");
t.IsTrue(generated.find("case 0x1620u: goto label_1620;") != std::string::npos,
"configured table target 0x1620 should be emitted");
t.IsTrue(generated.find("case 0x1630u: goto label_1630;") != std::string::npos,
"configured table target 0x1630 should be emitted");
t.IsTrue(generated.find("case 0x1600u: goto label_1600;") == std::string::npos,
"configured table should avoid broad JR fallback labels");
});
tc.Run("JALR includes switch and fallback/guard pair", [](TestCase &t) {
Function func;
func.name = "jalr_switch_and_fallback";
func.start = 0x1500;
func.end = 0x1530;
func.isRecompiled = true;
func.isStub = false;
// A call-like setup so there are multiple in-function labels to dispatch to.
Instruction jal = makeJal(0x1500, 0x1510);
Instruction jalDelay = makeNop(0x1504);
Instruction atReturn = makeNop(0x1508);
Instruction atTarget = makeNop(0x1510);
Instruction jalr = makeJalr(0x1514, 4, 31);
Instruction jalrDelay = makeNop(0x1518);
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(func, {jal, jalDelay, atReturn, atTarget, jalr, jalrDelay}, false);
printGeneratedCode("JALR includes switch and fallback/guard pair", generated);
t.IsTrue(generated.find("switch (jumpTarget)") != std::string::npos,
"JALR should emit switch when in-function register-jump targets exist");
t.IsTrue(generated.find("case 0x1508u: goto label_1508;") != std::string::npos,
"switch should include internal return label from JAL in same function");
t.IsTrue(generated.find("if (ctx->pc == __entryPc) { ctx->pc = 0x151Cu; }") != std::string::npos,
"JALR should contain unchanged-PC fallback to fallthrough");
t.IsTrue(generated.find("if (ctx->pc != 0x151Cu) { return; }") != std::string::npos,
"JALR should retain non-fallthrough guard");
});
tc.Run("JALR fallback should not expose epilogue tail-jump labels", [](TestCase &t) {
Function func;
func.name = "jalr_epilogue_guard";
func.start = 0x2000;
func.end = 0x2030;
func.isRecompiled = true;
func.isStub = false;
Instruction prolog{};
prolog.address = 0x2000;
prolog.opcode = OPCODE_ADDIU;
prolog.rs = 29;
prolog.rt = 29;
prolog.simmediate = static_cast<uint32_t>(static_cast<int32_t>(-0x20));
prolog.raw = 0;
Instruction saveRa{};
saveRa.address = 0x2004;
saveRa.opcode = OPCODE_SD;
saveRa.rs = 29;
saveRa.rt = 31;
saveRa.simmediate = 0x10;
saveRa.raw = 0;
// Dynamic callback entry point.
Instruction jalr = makeJalr(0x2008, 2, 31);
Instruction jalrDelay = makeNop(0x200C);
Instruction restoreRa{};
restoreRa.address = 0x2010;
restoreRa.opcode = OPCODE_LD;
restoreRa.rs = 29;
restoreRa.rt = 31;
restoreRa.simmediate = 0x10;
restoreRa.raw = 0;
// Tail jump sequence that must not be reachable from jalr fallback dispatch.
Instruction tailJump{};
tailJump.address = 0x2014;
tailJump.opcode = OPCODE_J;
tailJump.target = (0x3000u >> 2) & 0x3FFFFFFu;
tailJump.hasDelaySlot = true;
tailJump.raw = 0;
Instruction tailDelay{};
tailDelay.address = 0x2018;
tailDelay.opcode = OPCODE_ADDIU;
tailDelay.rs = 29;
tailDelay.rt = 29;
tailDelay.simmediate = 0x20;
tailDelay.raw = 0;
CodeGenerator gen({}, {});
std::string generated = gen.generateFunction(
func,
{prolog, saveRa, jalr, jalrDelay, restoreRa, tailJump, tailDelay},
false);
printGeneratedCode("JALR fallback should not expose epilogue tail-jump labels", generated);
t.IsTrue(generated.find("case 0x2014u: goto label_2014;") == std::string::npos,
"jalr fallback should not dispatch directly to epilogue tail-jump block");
t.IsTrue(generated.find("case 0x2018u: goto label_2018;") == std::string::npos,
"jalr fallback should not dispatch directly to tail-jump delay slot");
});
tc.Run("VU random helpers emit line comments on separate lines", [](TestCase &t) {
CodeGenerator gen({}, {});
Instruction inst{};
inst.rd = 7;
inst.vectorInfo.fsf = 2;
std::string vrnext = gen.translateVU_VRNEXT(inst);
printGeneratedCode("VU random helpers emit line comments on separate lines - VRNEXT", vrnext);
t.IsTrue(vrnext.find("// Simple LFSR-based random number generation (PS2-like behavior)\n"
" uint32_t feedback") != std::string::npos,
"VRNEXT should place the generated line comment on its own line");
std::string vrinit = gen.translateVU_VRINIT(inst);
printGeneratedCode("VU random helpers emit line comments on separate lines - VRINIT", vrinit);
t.IsTrue(vrinit.find("// PS2 uses a specific LFSR initialization pattern\n"
" if (seed == 0) seed = 1;") != std::string::npos,
"VRINIT should place the generated line comment on its own line");
std::string vrxor = gen.translateVU_VRXOR(inst);
printGeneratedCode("VU random helpers emit line comments on separate lines - VRXOR", vrxor);
t.IsTrue(vrxor.find("// XOR the current random value with the data from the VU vector register\n"
" __m128i xored") != std::string::npos,
"VRXOR should keep the XOR comment on its own line");
t.IsTrue(vrxor.find("// Apply a simple mixing function similar to PS2's LFSR\n"
" __m128i mixed") != std::string::npos,
"VRXOR should keep the LFSR comment on its own line");
});
tc.Run("resolveStubTarget allows leading underscore alias", [](TestCase &t) {
t.Equals(PS2Recompiler::resolveStubTarget("_rand"), StubTarget::Stub,
"_rand should resolve via rand stub alias");
t.Equals(PS2Recompiler::resolveStubTarget("_GetThreadId"), StubTarget::Syscall,
"_GetThreadId should resolve via GetThreadId syscall alias");
t.Equals(PS2Recompiler::resolveStubTarget("_DefinitelyNotARealCall"), StubTarget::Unknown,
"unknown names must still stay unknown");
});
});
}