使用riscv-tests进行指令测试（二）

本文属于《 TinyEMU模拟器基础系列教程》之一，欢迎查看其它文章。

1 测试用例命名规则

用例名称 = TVM Name + “-” + Target Environment Name + “-” + “指令”

比如，rv64ui-p-add，表示在用户模式下，测试riscv 64位整型指令集中add指令，运行环境条件为：未打开虚拟内存，仅从core0启动。

TVM Name	Description
rv32ui	RV32 user-level, integer only
rv32si	RV32 supervisor-level, integer only
rv64ui	RV64 user-level, integer only
rv64uf	RV64 user-level, integer and floating-point
rv64uv	RV64 user-level, integer, floating-point, and vector
rv64si	RV64 supervisor-level, integer only
rv64sv	RV64 supervisor-level, integer and vector
…	…

Target Environment Name	Description
p	virtual memory is disabled, only core 0 boots up
pm	virtual memory is disabled, all cores boot up
pt	virtual memory is disabled, timer interrupt fires every 100 cycles
v	virtual memory is enabled

在riscv-tests/isa目录下，有若干TVM Name，如下：

比如，rv64ui目录下，又有若干指令的S文件，如下：

在编译时，会自动按上述命名规则，生成可执行文件名称。

2 测试用例dump文件介绍

我们以rv64ui-p-add.dump为例，其执行流程，如下所示：

在每个测试程序中，都包含了若干个测试点。
gp寄存器保存了，当前测试点的编号。

• 从入口开始执行，再跳转到<reset_vector>位置；
• 在<reset_vector>位置，开始做一些初始化操作，主要包括x系列寄存器、mtvec、stvec、satp、medeleg、mideleg、mstatus、mepc等寄存器；
• 其中，mepc寄存器初始化最关键，这里将地址0x80000190，保存到mepc寄存器中，以确保mret指令执行模式返回时（M模式切到U模式），PC可直接跳转到0x80000190处，即<test_2>处，我们的第一个测试点；这里切换到U模式运行，也与我们rv64ui-p-add.dump名称中的u对应上了；
• 随后，便依次顺序执行<test_2> 至 <test_38>测试点，只要发现某个测试点失败，则忽略剩余测试点，立即跳转到 < fail > 标签；除非所有测试点均成功，才跳转到 < pass > 标签；
• 在 < fail > 和 < pass > 标签，会对a7、a0、gp寄存器进行相应设置（前面介绍过），以便模拟器依据这些寄存器值，来判断测试成功与否。

无论进入哪个标签，最后都会执行ecall指令，陷入M模式，PC跳转到<trap_vector>处，如下所示：

最终，在<write_tohost>标签中，形成死循环，反复执行，模拟器也就停在这里了。

因此，rv64ui-p-add.bin执行完后，TinyEMU打印出Test Pass，后续就是“停止”的状态，不会有其他打印信息。

其他测试用例，可类比本例，自行查看，不再赘述。