README.md

ub2l1样例

概述

本样例基于DataCopy实现UB->L1 Buffer的数据搬运,其中从UB搬运数据至L1 Buffer时,通过硬通道进行搬运。

支持的产品

  • Ascend 950PR/Ascend 950DT

目录结构介绍

├── data_copy_ub2l1
│   ├── scripts
│   │   ├── gen_data.py                   // 输入数据和真值数据生成脚本
│   ├── CMakeLists.txt                    // 编译工程文件
│   └── data_copy_ub2l1.asc               // AscendC算子实现 & 调用样例

算子描述

  • 算子功能:
    将数据从UB搬运到L1 Buffer,然后进行mmad计算,其中UB到L1 Buffer使用硬件通道搬运,对比基于kfc通信实现的软件搬运具有更好的性能。

  • 算子规格:

    算子类型(OpType)MIX算子
    算子输入nameshapedata typeformat
    x32 * 32halfND
    y32 * 32halfND
    算子输出z32 * 32floatND
    核函数名ub2l1
  • 算子实现:

    1. 拷贝GM到UB。
    2. 拷贝UB数据到L1。
    3. 调用基础API mmad进行矩阵计算。
    • 调用实现
      使用内核调用符<<<>>>调用核函数。

编译运行

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

  • 配置环境变量
    请根据当前环境上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
      
  • 样例执行

    mkdir -p build && cd build;                                               # 创建并进入build目录
    cmake ..;make -j;                                                         # 编译工程
    python3 ../scripts/gen_data.py                                            # 生成测试输入数据
    ./demo                                                                    # 执行编译生成的可执行程序,执行样例
    

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

    test pass!