CANN asc-devkit时钟接口文档

clock

【免费下载链接】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 训练系列产品：不支持

• Kirin X90：不支持

• Kirin 9030：不支持

功能说明

本接口在SIMD、SIMD与SIMT混合和SIMT调试场景中提供Clock时间戳功能，用于记录从程序启动到接口调用时刻所经历的时钟周期数（Cycle Count），便于精确分析执行延迟和性能瓶颈。

函数原型

__aicore__ inline uint64_t clock(void)

以下接口为SIMT VF中所使用的clock接口，仅支持Ascend 950PR/Ascend 950DT。

__simt_callee__ inline uint64_t clock(void)

参数说明

无

返回值说明

从程序开始到调用时所经历的时钟周期数。

约束说明

无

需要包含的头文件

使用该接口需要包含"utils/debug/asc_time.h"头文件。

#include "utils/debug/asc_time.h"

调用示例

• SIMT编程场景：

  __global__ __launch_bounds__(1024) void SimtKernel(uint64_t* dst) { int idx = threadIdx.x + blockIdx.x * blockDim.x; dst[idx] = clock(); }

• SIMD与SIMT混合编程场景：

  __simt_vf__ __launch_bounds__(1024) inline void SimtKernel(__gm__ uint64_t* dst) { int idx = threadIdx.x + blockIdx.x * blockDim.x; dst[idx] = clock(); }

• SIMD编程场景：

  __global__ __aicore__ void AicoreKernel(__gm__ uint64_t* dst) { int idx = AscendC::GetBlockIdx(); dst[idx] = clock(); }

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit