asc_time_stamp
【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit
产品支持情况
- Ascend 950PR/Ascend 950DT：支持
- Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持
- Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持
- Atlas 200I/500 A2 推理产品：不支持
- Atlas 推理系列产品AI Core：不支持
- Atlas 推理系列产品Vector Core：不支持
- Atlas 训练系列产品：不支持
功能说明
提供时间戳打点功能，用于在算子Kernel代码中标记关键执行点。调用后会打印如下信息：
- descId：用户自定义标识符，用于区分不同打点位置。
- rsv：保留值，默认为0，无需关注。
- timeStamp：当前系统cycle数，用于计算时间差，时间换算规则可参考GetSystemCycle(ISASI).md)。
- pcPtr：pc指针数值，若无特殊需求，用户无需关注。
- entry：算子开始执行的cycle数，若无特殊需求，用户无需关注。
打印示例如下：
descId is 11, rsv is 0, timeStamp is 815603975350485, pcPtr is 19792358553124, entry is 815603975328116.[!CAUTION]注意 该功能主要用于调试和性能分析，开启后会对算子性能产生一定影响，生产环境建议关闭。 默认情况下，该功能关闭，开发者可以按需通过增加-DASCENDC_TIME_STAMP_ON编译选项的方式，开启打点功能。
函数原型
__aicore__ inline void asc_time_stamp(uint32_t desc_id)参数说明
| 参数名 | 输入/输出 | 描述 |
|---|---|---|
| desc_id | 输入 | 用户自定义标识符（自定义数字），用于区分不同打点位置。 注意： [0, 0xffff]是预留给Ascend C内部各个模块使用的id值，用户自定义的desc_id建议使用大于0xffff的数值。 |
返回值说明
无
约束说明
该功能仅用于NPU上板调试。
暂不支持算子入图场景的打印。
单次调用本接口打印的数据总量不可超过1MB（还包括少量框架需要的头尾信息，通常可忽略）。使用时应注意，如果超出这个限制，则数据不会被打印。在使用自定义算子工程进行工程化算子开发时，一个算子所有使用Dump功能的接口在每个核上Dump的数据总量不可超过1MB。请开发者自行控制待打印的内容数据量，超出则不会打印。
调用示例
asc_time_stamp(11);打印结果如下（Dump信息头等仅在使用自定义算子工程时才会打印）：
opType=AddCustom, DumpHead: AIV-0, CoreType=AIV, block dim=8, total_block_num=8, block_remain_len=1047136, block_initial_space=1048576, rsv=0, magic=5aa5bccd ...// 一些框架内部的打点信息 descId is 11, rsv is 0, timeStamp is 815603975350485, pcPtr is 19792358553124, entry is 815603975328116.【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
