上板时间戳打点功能

功能介绍

算子NPU上板调测时支持时间戳（当前系统cycle数）打点，以获取算子调试各阶段耗时信息。

• 该功能仅在NPU上板调测场景下开启，其他场景不支持，可以与Profiling数据采集功能配套使用。
• 系统cycle数指系统最小的计时单位，它由系统主时钟频率决定，而系统主时钟频率是指每秒钟的cycle数。若换算成时间需要按照50MHz的频率，时间单位为us，换算公式为：time = (cycle数/50) us 。
• 该功能仅在如下产品支持：

  Atlas A2训练系列产品/Atlas 800I A2推理产品

使用方法（命令行）

1. 按需调用AscendCTimeStamp自定义打点标识，接口说明参见表2，样例如下：

    AscendC::AscendCTimeStamp(200000000);

2. NPU调测场景执行命令如下，使能Dump开关。

    ascendebug kernel --backend npu --dump-mode time_stamp ... {其他NPU调测参数}

   --dump-mode设为time_stamp，开启时间戳打点，其他参数参考NPU调测参数按需配置。

3. 查看结果文件，详细说明参见产物说明。

使用方法（API）

1. 按需调用AscendCTimeStamp自定义打点标识，接口说明参见表2，样例如下：

    AscendC::AscendCTimeStamp(200000000);

2. 调用算子NPU编译及运行接口，对应options配置为dump_mode='time_stamp'。

   # 调用编译接口
   compile_npu_options = ascendebug.CompileNpuOptions(dump_mode='time_stamp')
   name, kernel_file, extern = op_executor.compile_custom_npu(customize_path, tiling_info.tiling_key, compile_npu_options)
   # 调用运行接口
   run_npu_options = ascendebug.RunNpuOptions()
   npu_compile_info = ascendebug.NpuCompileInfo(syncall=extern['cross_core_sync'], task_ration=extern['task_ration'], dump_mode='time_stamp')
   op_executor.run_npu(kernel_file, run_npu_options, npu_compile_info=npu_compile_info, tiling_info=tiling_info)

3. 查看结果文件，详细说明参见产物说明。

产物说明

时间戳打点信息存放在${root}/${work_dir}/npu路径下，其中${root}表示当前操作路径，${work_dir}表示调测工作空间，默认为/debug_workspace/${op_type}目录，${op_type}为算子名。目录结构示例如下：

├ ${op_type}    // 算子名
├── npu
│   ├── dump
│       ├── PARSER_${timestamp}
│           ├── dump_data
│               ├──0                                  // core number
│                   ├──time_stamp_core_0.csv         // 时间戳打点落盘文件
│               ├──1
│                   ├──time_stamp_core_1.csv
│           ├── parser.log                           // 调测过程中的log文件

log文件记录了运行过程中的日志信息，示例如下：

[INFO]: ================ block.0 begin ==============
[INFO]: [Meta Info] block num: 10, core type: VEC, isMix: False
[INFO]: ================ block.0 end ================
[INFO]: ================ block.1 begin ==============
[INFO]: [Meta Info] block num: 10, core type: VEC, isMix: False
 [INFO]: ================ block.1 end ================
[INFO]: ================ block.2 begin ==============
[INFO]: [Meta Info] block num: 10, core type: VEC, isMix: False
[INFO]: ================ block.2 end ================
[INFO]: ..........

csv文件记录了内置时间戳打点和用户自定义的200000000时间戳打点信息，样例如表1所示。

接口说明

AscendC::AscendCTimeStamp(200000000);