使用riscv-tests进行指令测试(二)
- [1 测试用例命名规则](#1 测试用例命名规则)
- [2 测试用例dump文件介绍](#2 测试用例dump文件介绍)
本文属于《 TinyEMU模拟器基础系列教程》之一,欢迎查看其它文章。
1 测试用例命名规则
cpp
用例名称 = 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,后续就是"停止"的状态,不会有其他打印信息。
其他测试用例,可类比本例,自行查看,不再赘述。