LoongArch单周期CPU设计实践与调试经验分享

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框输入如下内容

   帮我开发一个支持20条指令的LoongArch单周期CPU模拟器，用于计算机组成原理教学演示。系统交互细节：1.支持基础算术逻辑指令 2.实现分支跳转功能 3.包含存储器访问指令 4.提供调试信息输出。注意事项：需处理特殊指令如BL的寄存器写回。

3. 点击'项目生成'按钮，等待项目生成完整后预览效果

实验准备与环境搭建

1. 实验环境基于龙芯架构32位精简版，使用预编译的exp6压缩包可快速搭建验证环境。建议优先下载完整实验包避免交叉编译工具配置问题。

2. 工程目录结构主要包含三个关键部分：仿真波形生成模块gettrace、SoC验证环境soc_verify以及CPU核心实现代码myCPU。新建工程时需注意Vivado版本兼容性，高版本需按文档升级IP核。

核心调试过程详解

1. 第一个遇到的典型错误是调试信号端口连接错误。在mycpu_top.v中，debug_wb_pc等调试信号需要正确映射到CPU内部寄存器，最初版本因信号名拼写错误导致无法捕获执行轨迹。

2. ALU模块的输入源选择逻辑需要特别注意。实验中发现alu_src1错误连接到未定义的final_result信号，修正后应改为来自寄存器堆或PC值的二选一输入。

3. 条件分支指令的寄存器写回使能信号需要特殊处理。BL指令作为带链接的分支，需要单独在gr_we信号中增加例外情况，否则会丢失返回地址存储。

4. 立即数扩展模块存在两处关键修改：UI5类型立即数应取自rk寄存器字段而非立即数段；SLL指令的移位操作需要严格限制在5位范围内。

5. 位运算单元发现OR指令实现不完整，原始代码缺少结果寄存器。补充or_result的线网定义后，所有逻辑运算功能恢复正常。

6. 移位运算单元最复杂的修改在SRA指令。需要区分算术右移和逻辑右移，前者需保留符号位扩展。最终采用64位中间变量确保符号位正确传播。

验证方法与技巧

1. 波形调试时建议重点关注几个关键信号：pc序列变化、rf_wdata写回值、alu_result中间结果。异常值往往能快速定位问题模块。

2. 使用gettrace生成的golden_trace.txt作为参考基准，逐条指令比对寄存器写回结果。差异点通常对应功能实现错误。

3. 对于复杂指令如JIRL，需要同时验证跳转地址计算和链接寄存器写入两个功能点。

平台实践建议

在InsCode(快马)平台上验证CPU设计时，可以利用其即时仿真功能快速测试各个指令模块。平台内置的波形查看器能直观展示信号变化，比本地环境配置更便捷。

对于教学演示场景，可以导出项目作为交互式课件，学生无需配置开发环境就能通过网页观察CPU运行细节。这种轻量化验证方式特别适合计算机组成原理的初期学习阶段。