通过指定Ascend C算子的ST测试用例定义文件（.json）和实现文件kernel_name.cpp，自动生成调用核函数的上板测试框架，进行算子的测试验证，最终查看输出结果确认算子功能是否正确。

请用户完成以下输入文件的准备工作。
- 算子ST测试用例定义文件（*.json文件），具体可参考生成测试用例定义文件。
- kernel侧算子实现文件（*.cpp文件），具体可参考实现样例。

使用msopst工具生成调用kernel函数的测试代码。

进入msopst工具所在目录生成调用kernel函数的测试代码，执行如下命令：

cd /usr/local/Ascend/ascend-toolkit/latest/python/site-packages/bin
./msopst ascendc_test -i xx/OpType_case.json -kernel xx/add_custom.cpp -out ./output_data

root用户安装toolkit包默认路径为“/usr/local/Ascend”，请根据实际环境进行替换。

表1 参数说明
参数名称	参数描述	是否必选
ascendc_test	生成Ascend C算子调用kernel函数的上板测试代码。	是
-i，--input	算子测试用例定义文件（.json文件）的路径，可配置为绝对路径或者相对路径。说明：指定的算子ST测试用例定义文件（.json文件）仅支持配置一个测试用例。测试用例中不支持配置多个type、format及shape。	是
-kernel，--kernel_file	Ascend C算子的kernel侧实现文件（*.cpp文件）路径，可配置为绝对路径或者相对路径。	是
-out，--output	测试框架代码输出路径，可配置为绝对路径或者相对路径，并且工具执行用户具有可读写权限。	否

查看执行结果。

命令执行完成后，会屏显打印"Process finished!"提示信息，并会在-out指定的目录下生成时间戳目录，时间戳目录下将生成以算子的OpType命名的存储测试用例及测试结果的文件夹，目录结构如下所示：

 {time_stamp}
│   ├── OpType
│   │   ├── CMakeLists.txt     // 编译规则文件
│   │   ├── data    
│   │   │   └── xx.bin        
│   │   │   └── xx.bin
│   │   ├── data_utils.h
│   │   ├── main.cpp        // 测试框架
│   │   └── run.sh      // 调用测试框架的脚本文件
│   └── st_report.json        //运行报表

命令运行成功后，会生成报表st_report.json，记录了测试的信息以及各阶段运行情况，用户运行出问题以后，可基于报表查询运行信息，以便问题定位。同时，st_report.json报表可以对比测试结果。st_report.json保存在图1中“The st_report saved in”路径下。

图1 运行结果示例

表2 st_report.json报表主要字段及含义
字段			说明
run_cmd	-	-	命令行命令。
report_list	-	-	报告列表，该列表中可包含多个测试用例的报告。
	trace_detail	-	运行细节。
		st_case_info	测试信息，包含如下内容。 expect_data_path：期望计算结果路径。 case_name：测试用例名称。 input_data_path：输入数据路径。 planned_output_data_paths：实际计算结果输出路径。 op_params：算子参数信息。
		stage_result	运行各阶段结果信息，包含如下内容。 status：阶段运行状态，表示运行成功或者失败。 result：输出结果 stage_name：阶段名称。 cmd：运行命令。
	case_name	-	测试名称。
	status	-	测试结果状态，表示运行成功或者失败。
	expect	-	期望的测试结果状态，表示期望运行成功或者失败。
summary	-	-	统计测试用例的结果状态与期望结果状态对比的结果。
	test case count	-	测试用例的个数。
	success count	-	测试用例的结果状态与期望结果状态一致的个数。
	failed count	-	测试用例的结果状态与期望结果状态不一致的个数。

修改run.sh文件中CANN软件包的安装位置ASCEND_HOME_DIR。

# 指向昇腾软件包安装地址，导出环境变量
if [ ! $ASCEND_HOME_DIR ]; then
    export ASCEND_HOME_DIR=/usr/local/Ascend/ascend-toolkit/latest      
fi
source $ASCEND_HOME_DIR/bin/setenv.bash

进入执行测试框架的脚本文件所在目录，如下命令进行测试框架代码的上板验证。运行结果如图2所示。

bash run.sh <kernel_name> <soc_version> <core_type> <run_mode>

表3 脚本参数介绍
参数名	参数介绍	取值
<kernel_name>	Ascend C算子实现文件的文件名	比如Add算子实现文件为add_custom.cpp，则应传入add_custom。
*<soc_version>*	算子运行的AI处理器型号	Atlas 训练系列产品，配置为“ascend910” Atlas 推理系列产品（Ascend 310P处理器），配置为“ascend310p” Atlas A2训练系列产品，配置方法如下：在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询，在查询到的“Name”前增加Ascend信息，例如“Name”对应取值为xxxyy，应配置为“ascendxxxyy”。
<core_type>	表明算子在AiCore上或者VectorCore上运行	AiCore或VectorCore
<run_mode>	表明算子以cpu模式或npu模式运行	cpu或npu

图2 运行结果示例

生成单算子上板测试框架