CVA6项目中自定义指令模拟测试问题分析与解决

概述

在RISC-V处理器开发过程中，自定义指令的添加与验证是一个常见需求。本文以openhwgroup/cva6项目为例，详细分析在添加自定义指令时遇到的模拟测试问题及其解决方案。

问题现象

开发者在cva6项目中尝试添加自定义指令时，使用.insn伪指令在custom_test_template.S中定义自定义指令。当运行smoke-test.sh脚本进行验证时，遇到了以下问题：

1. 模拟过程出现错误，返回错误码2
2. 预期的日志文件(.log)和波形文件(.vcd)未能生成
3. 自定义指令被识别为非法指令

深入分析

1. 模拟器执行流程

CVA6项目使用Verilator进行RTL模拟，通过rvfi_tracer.sv模块记录指令执行轨迹。该模块会：

• 记录所有执行的指令
• 检测非法指令并生成异常
• 正常情况下会生成.dasm反汇编文件

2. 问题根源

经过分析，问题主要源于以下几个方面：

1. 非法指令处理机制：CVA6的指令解码器尚未支持新添加的自定义指令，导致处理器将其识别为非法指令(ILLEGAL_INSTR)，触发了异常处理流程。

2. 文件生成机制：当模拟过程中出现异常时，系统会执行清理操作(make -C verif/sim clean_all)，这会删除包括.dasm在内的中间文件。

3. 波形生成配置：默认情况下，VCD波形文件生成功能未启用，需要显式设置TRACE_FAST=1才能生成。

解决方案

1. 自定义指令支持

要使自定义指令被正确识别，需要修改以下部分：

1. 解码器模块：在RTL代码中添加对新指令格式的支持
2. 指令语义：实现指令对应的功能单元
3. CSR配置：确保相关控制和状态寄存器支持新指令

2. 调试信息保留

为了在出现异常时仍能获取调试信息：

1. 临时禁用清理：在调试阶段可以注释掉clean_all相关操作
2. 启用完整跟踪：设置TRACE_FAST=1以生成VCD波形文件
3. 异常处理调试：检查处理器在遇到非法指令时的状态保存机制

3. 验证流程优化

建议采用分阶段验证方法：

1. 单元测试：先单独验证解码器对新指令的识别
2. 功能测试：验证指令执行结果是否符合预期
3. 系统测试：在完整环境中验证指令与其他组件的交互

实践建议

对于RISC-V自定义指令开发，建议遵循以下最佳实践：

1. 增量开发：每次只添加一个指令，逐步验证
2. 交叉验证：使用参考模型(如Spike)进行行为级对比
3. 完备测试：覆盖指令的各种使用场景和边界条件
4. 文档记录：详细记录指令格式、语义和验证结果

总结

在CVA6项目中添加自定义指令是一个系统工程，需要同时考虑硬件实现和验证环境的适配。通过理解处理器异常处理机制和验证流程，可以有效解决自定义指令验证过程中遇到的问题。本文描述的分析方法和解决方案不仅适用于CVA6项目，也可为其他RISC-V处理器开发提供参考。