CANN/asc-tools msobjdump样例-三亩地-编程学习日记

msobjdump样例

【免费下载链接】asc-toolsAscend C Tools仓是CANN基于Ascend C编程语言推出的配套调试工具仓。项目地址: https://gitcode.com/cann/asc-tools

概述

本样例基于MatmulLeakyRelu算子，演示融合编译场景下msobjdump工具的使用方式。样例通过编译matmul_leakyrelu.asc生成融合编译产物，再对生成的ELF文件执行解析。msobjdump工具的详细说明请参考msobjdump工具。

支持的产品

Ascend 950PR/Ascend 950DT
Atlas A3 训练系列产品/Atlas A3 推理系列产品
Atlas A2 训练系列产品/Atlas A2 推理系列产品

目录结构介绍

├── 04_msobjdump │ ├── CMakeLists.txt // 编译工程文件 │ ├── data_utils.h // 数据读入写出函数 │ ├── matmul_leakyrelu.asc // Ascend C算子实现 & 调用样例 │ └── scripts │ ├── gen_data.py // 输入数据和真值数据生成脚本文件 │ └── verify_result.py // 真值对比文件

算子描述

样例功能：
MatmulLeakyRelu的计算公式为：
```
C = A * B + Bias C = C > 0 ? C : C * 0.001
```
样例参数M = 1024，K = 256，N = 640，样例规格如下表所示：
样例类型(OpType) MatmulLeakyRelu
样例输入 name shape data type format
A [M, K] float16 ND
B [K, N] float16 ND
Bias [N] float ND
样例输出 C [M, N] float ND
核函数名 matmul_leakyrelu_custom
样例实现：
- 实现流程
  - 通过GenerateTiling实现host侧的Tiling计算
  - 通过CalcGMOffset完成分核计算
  - 通过Iterate接口完成矩阵乘计算
  - 通过LeakyRelu实现激活函数计算
- 调用实现
  使用内核调用符<<<>>>调用核函数。

编译运行

在本样例根目录下执行如下步骤，编译并执行算子。

配置环境变量
请根据当前环境上CANN开发套件包的安装方式，选择对应配置环境变量的命令。
- 默认路径，root用户安装CANN软件包
```
source /usr/local/Ascend/cann/set_env.sh
```
- 默认路径，非root用户安装CANN软件包
```
source $HOME/Ascend/cann/set_env.sh
```
- 指定路径install_path，安装CANN软件包
```
source ${install_path}/cann/set_env.sh
```
执行如下命令，若能正常显示-h信息，则表示工具环境正常，功能可正常使用。
```
msobjdump -h
```

样例执行

mkdir -p build && cd build; # 创建并进入build目录 cmake ..;make -j; # 编译工程 python3 ../scripts/gen_data.py # 生成测试输入数据 ./demo # 执行编译生成的可执行程序，执行样例 python3 ../scripts/verify_result.py output/output.bin output/golden.bin # 验证输出结果是否正确，确认算法逻辑正确

执行结果如下，说明精度对比成功。

test pass!

调用msobjdump工具解析
样例中的demo为融合编译生成的ELF文件。若该ELF中包含.aicore_binary段，msobjdump会自动提取该段内容并继续解析，无需手工拆分中间文件。

解析融合编译产物

msobjdump --dump-elf ./demo

本样例实际输出如下：

.ascend.meta META INFO RUNTIME_IMPLICIT_INFO: DOUBLE_PAGE_TABLE_ADDR RUNTIME_IMPLICIT_INFO: FFTS_ADDR VERSION: 1 RUNTIME_IMPLICIT_INFO: DOUBLE_PAGE_TABLE_ADDR RUNTIME_IMPLICIT_INFO: FFTS_ADDR VERSION: 1 RUNTIME_IMPLICIT_INFO: SIMD_TRACE_SPACE .ascend.meta. [0]: _Z23matmul_leakyrelu_customPhS_S_S_S_N7AscendC6tiling11TCubeTilingE_mix_aic KERNEL_TYPE: MIX_AIC_MAIN CROSS_CORE_SYNC: USE_SYNC MIX_TASK_RATION: [1:2] .ascend.meta. [0]: _Z23matmul_leakyrelu_customPhS_S_S_S_N7AscendC6tiling11TCubeTilingE_mix_aiv KERNEL_TYPE: MIX_AIC_MAIN CROSS_CORE_SYNC: USE_SYN

全量打印融合编译产物中的device信息

msobjdump --dump-elf ./demo --verbose