编译玄铁处理器RISC-V指令测试用例

[1 玄铁处理器](#1 玄铁处理器)
[2 下载玄铁RISC-V指令测试用例](#2 下载玄铁RISC-V指令测试用例)
[3 下载玄铁GCC交叉编译器](#3 下载玄铁GCC交叉编译器)
[4 编译步骤](#4 编译步骤)
[5 如何判断一个用例执行结果](#5 如何判断一个用例执行结果)

1 玄铁处理器

XuanTie玄铁，是阿里巴巴达摩院旗下品牌。依托阿里巴巴在云计算、人工智能和大数据领域的领先地位及优势，团队持续深耕 RISC-V 架构的前沿技术创新及开源生态建设，致力于为数字化时代提供强大、智能、安全、开放的新型计算架构和安全可靠的IP。

玄铁C906 处理器，是嵌入式领域的RISC-V 兼容的高能效低成本的64 位处理器。（openc906）采用RV64GC 指令集架构，主要面向视频监控、智能终端、扫脸支付等领域。

2 下载玄铁RISC-V指令测试用例

玄铁C906 处理器开源仓库：https://github.com/XUANTIE-RV/openc906，包含RTL代码和RISC-V指令测试用例。

若无法打开，可从这里下载：https://download.csdn.net/download/u011832525/90557596

3 下载玄铁GCC交叉编译器

从玄铁官网下载：Xuantie-900-gcc-elf-newlib-x86_64-V2.0.3-20210806.tar.gz

4 编译步骤

1. 安装csh

由于配置文件和make时，默认使用csh，而不是bash，因此需要安装这个csh。

cpp 复制代码

sudo apt-get install csh

安装好后，咱们输入命令：csh，进入到csh模式下，后续所有操作都要在csh下进行。

2. 配置CODE_BASE_PATH

cpp 复制代码

cd C906_RTL_FACTORY
source setup/setup.csh
cd ../smart_run

如下所示：
3. 修改smart_cfg.mk

将setup/example_setup.csh文件中，所有**_build标签下（如ISA_THEAD_build、ISA_INT_build等）的第一行命令后，添加/ -r，如下图中所示。

4. 配置TOOL_EXTENSION

按如下描述修改setup/example_setup.csh文件。

cpp 复制代码

vim setup/example_setup.csh

将文件头部的版权声明信息，用#注释掉。
将TOOL_EXTENSION，配置为RISC-V GCC编译器目录。

解压Xuantie-900-gcc-elf-newlib-x86_64-V2.0.3-20210806.tar.gz后，编译器位于Xuantie-900-gcc-elf-newlib-x86_64-V2.0.3\bin\riscv64-unknown-elf-gcc路径。

修改完毕后，使其生效：

cpp 复制代码

source setup/example_setup.csh

5. 编译CASE

创建输出目录：

cpp 复制代码

mkdir work

赋予Srec2vmem执行权限：

cpp 复制代码

chmod 777 tests/bin/Srec2vmem

编译ISA_THEAD用例

cpp 复制代码

make ISA_THEAD_build

执行此命令，就会使用riscv64-unknown-elf-gcc来编译RISC-V测试用例源码，若没有报错，则表示编译成功。

在work目录下，会生成输出文件，如下：

elf为生成的可执行文件；
log文件内记录了make时产生的具体报错原因，发生错误时，可查看此文件。
如果报错：Syntax error: Bad fd number，可参考《Linux执行sh脚本报错: Syntax error: Bad fd number》解决。

注意：

make help可查看帮助，make showcase可查看当前所有有效的case，其他可自行了解。

在编译完毕一个case后，需要先make clean后，才能重新编译下一个。

5 如何判断一个用例执行结果

我们可以看到，用例的反汇编文件中，有如下代码：

cpp 复制代码

0000000000000088 <__exit>:
__exit():
      88:	4501                	li	a0,0
      8a:	05a00093          	li	ra,90
      8e:	06b00113          	li	sp,107
      92:	07c00193          	li	gp,124
      96:	004441b7          	lui	gp,0x444
      9a:	3331819b          	addiw	gp,gp,819 # 444333 <__kernel_stack+0x356333>
      9e:	01b2                	slli	gp,gp,0xc
      a0:	22218193          	addi	gp,gp,546
      a4:	820e                	mv	tp,gp

00000000000000a6 <__fail>:
__fail():
      a6:	4501                	li	a0,0
      a8:	02c00093          	li	ra,44
      ac:	03b00113          	li	sp,59
      b0:	004701b7          	lui	gp,0x470
      b4:	4691819b          	addiw	gp,gp,1129 # 470469 <__kernel_stack+0x382469>
      b8:	01be                	slli	gp,gp,0xf
      ba:	72018193          	addi	gp,gp,1824

当测试成功时，会调用__exit()函数；

当测试失败时，会调用__fail()函数。

因此，可以通过如下寄存器值，来判断执行结果：

当a0 == 0且ra == 90时，测试成功。
当a0 == 0且ra == 44时，测试失败。