Ascend C API列表

Ascend C提供一组类库API，开发者使用标准C++语法和类库API进行编程。Ascend C编程类库API示意图如下所示，分为：

基础数据结构：kernel API中使用到的基础数据结构，比如GlobalTensor和LocalTensor。
语言拓展层C API：纯C接口，开放芯片完备编程能力，支持数组分配内存，一般基于指针编程，提供与业界一致的C语言编程体验。
基础API：实现对硬件能力的抽象，开放芯片的能力，保证完备性和兼容性。标注为ISASI（Instruction Set Architecture Special Interface，硬件体系结构相关的接口）类别的API，不能保证跨硬件版本兼容。
高阶API：实现一些常用的计算算法，用于提高编程开发效率，通常会调用多种基础API实现。高阶API包括数学库、Matmul、Softmax等API。高阶API可以保证兼容性。
SIMT API：单指令多线程API。以单条指令多个线程的形式来实现并行计算。SIMT编程主要用于向量计算，特别适合处理离散访问、复杂控制逻辑等场景。
Utils API（公共辅助函数）：丰富的通用工具类，涵盖标准库、平台信息获取、运行时编译及日志输出等功能，支持开发者高效实现算子开发与性能优化。

基础数据结构

表 1 基础数据结构列表

接口名	功能描述
LocalTensor	LocalTensor用于存放AI Core中Local Memory（内部存储）的数据，支持逻辑位置TPosition为VECIN、VECOUT、VECCALC、A1、A2、B1、B2、CO1、CO2。
GlobalTensor	GlobalTensor用来存放Global Memory（外部存储）的全局数据。
Coordinate	Coordinate本质上是一个元组（tuple），用于表示张量在不同维度的位置信息，即坐标值。
Layout	Layout<Shape, Stride>数据结构是描述多维张量内存布局的基础模板类，通过编译时的形状（Shape）和步长（Stride）信息，实现逻辑坐标空间到一维内存地址空间的映射，为复杂张量操作和硬件优化提供基础支持。
TensorTrait	TensorTrait数据结构是描述Tensor相关信息的基础模板类，包含Tensor的数据类型、逻辑位置和Layout内存布局。

基础API

表 2 标量计算API列表

接口名	功能描述
GetBitCount	获取一个uint64_t类型数字的二进制中0或者1的个数。
CountLeadingZero	计算一个uint64_t类型数字前导0的个数（二进制从最高位到第一个1一共有多少个0）。
Cast（float转half、int32_t）	将一个scalar的类型转换为指定的类型。
CountBitsCntSameAsSignBit	计算一个uint64_t类型数字的二进制中，从最高数值位开始与符号位相同的连续比特位的个数。
GetSFFValue	获取一个uint64_t类型数字的二进制中第一个0或1出现的位置。
Cast（float转bfloat16_t）	float类型标量数据转换成bfloat16_t类型标量数据。
Cast（bfloat16_t转float）	bfloat16_t类型标量数据转换成float类型标量数据。

表 3 Memory矢量计算API列表

分类	接口名	功能描述
基础算术	Exp	按元素取自然指数。
	Ln	按元素取自然对数。
	Abs	按元素取绝对值。
	Reciprocal	按元素取倒数。
	Sqrt	按元素做开方。
	Rsqrt	按元素做开方后取倒数。
	Relu	按元素做线性整流Relu。
	Add	按元素求和。
	Sub	按元素求差。
	Mul	按元素求积。
	Div	按元素求商。
	Max	按元素求最大值。
	Min	按元素求最小值。
	Adds	矢量内每个元素与标量求和。
	Muls	矢量内每个元素与标量求积。
	Maxs	源操作数矢量内每个元素与标量相比，如果比标量大，则取源操作数值，比标量的值小，则取标量值。
	Mins	源操作数矢量内每个元素与标量相比，如果比标量大，则取标量值，比标量的值小，则取源操作数值。
	LeakyRelu	按元素做带泄露线性整流Leaky ReLU。
基础算术	Subs	矢量内每个元素和标量间做减法，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。
基础算术	Divs	矢量内每个元素和标量间做除法，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。
逻辑计算	Not	按元素做按位取反。
	And	针对每对元素执行按位与运算。
	Or	针对每对元素执行按位或运算。
	ShiftLeft	对源操作数中的每个元素进行左移操作，左移的位数由输入参数scalarValue决定。
	ShiftRight	对源操作数中的每个元素进行右移操作，右移的位数由输入参数scalarValue决定。
逻辑计算	Ands	矢量内每个元素和标量间做与操作，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。
逻辑计算	Ors	矢量内每个元素和标量间做或操作，支持标量在前和标量在后两种场景，其中标量输入支持配置LocalTensor单点元素。
复合计算	Axpy	源操作数中每个元素与标量求积后和目的操作数中的对应元素相加。
	CastDequant	对输入做量化并进行精度转换。
	AddRelu	按元素求和，结果和0对比取较大值。
	AddReluCast	按元素求和，结果和0对比取较大值，并根据源操作数和目的操作数Tensor的数据类型进行精度转换。
	AddDeqRelu	依次计算按元素求和、结果进行deq量化后再进行relu计算（结果和0对比取较大值）。
	SubRelu	按元素求差，结果和0对比取较大值。
	SubReluCast	按元素求差，结果和0对比取较大值，并根据源操作数和目的操作数Tensor的数据类型进行精度转换。
	MulAddDst	按元素将src0Local和src1Local相乘并和dstLocal相加，将最终结果存放进dstLocal中。
	MulCast	按元素求积，并根据源操作数和目的操作数Tensor的数据类型进行精度转换。
	FusedMulAdd	按元素将src0Local和dstLocal相乘并加上src1Local，最终结果存放入dstLocal。
	MulAddRelu	按元素将src0Local和dstLocal相乘并加上src1Local，将结果和0作比较，取较大值，最终结果存放进dstLocal中。
比较与选择	Compare	逐元素比较两个tensor大小，如果比较后的结果为真，则输出结果的对应比特位为1，否则为0。
	Compare（结果存放入寄存器）	逐元素比较两个tensor大小，如果比较后的结果为真，则输出结果的对应比特位为1，否则为0。Compare接口需要mask参数时，可以使用此接口。计算结果存放入寄存器中。
	Compares	逐元素比较一个tensor中的元素和另一个Scalar的大小，如果比较后的结果为真，则输出结果的对应比特位为1，否则为0。
	Select	给定两个源操作数src0和src1，根据selMask（用于选择的Mask掩码）的比特位值选取元素，得到目的操作数dst。选择的规则为：当selMask的比特位是1时，从src0中选取，比特位是0时从src1选取。
	GatherMask	以内置固定模式对应的二进制或者用户自定义输入的Tensor数值对应的二进制为gather mask（数据收集的掩码），从源操作数中选取元素写入目的操作数中。
精度转换指令	Cast	根据源操作数和目的操作数Tensor的数据类型进行精度转换。
归约计算	ReduceMax	在所有的输入数据中找出最大值及最大值对应的索引位置。
	ReduceMin	在所有的输入数据中找出最小值及最小值对应的索引位置。
	ReduceSum	对所有的输入数据求和。
	WholeReduceMax	每个repeat内所有数据求最大值以及其索引index。
	WholeReduceMin	每个repeat内所有数据求最小值以及其索引index。
	WholeReduceSum	每个repeat内所有数据求和。
	BlockReduceMax	对每个repeat内所有元素求最大值。
	BlockReduceMin	对每个repeat内所有元素求最小值。
	BlockReduceSum	对每个repeat内所有元素求和。源操作数相加采用二叉树方式，两两相加。
	PairReduceSum	PairReduceSum：相邻两个（奇偶）元素求和。
	RepeatReduceSum	每个repeat内所有数据求和。和WholeReduceSum接口相比，不支持mask逐bit模式。建议使用功能更全面的WholeReduceSum接口。
数据转换	Transpose	可实现16*16的二维矩阵数据块的转置和[N,C,H,W]与[N,H,W,C]互相转换。
数据转换	TransDataTo5HD	数据格式转换，一般用于将NCHW格式转换成NC1HWC0格式。特别的，也可以用于二维矩阵数据块的转置。
数据填充	Duplicate	将一个变量或一个立即数，复制多次并填充到向量。
	Brcb	给定一个输入张量，每一次取输入张量中的8个数填充到结果张量的8个datablock（32Bytes）中去，每个数对应一个datablock。
	CreateVecIndex	以firstValue为起始值创建向量索引。
数据分散/数据收集	Gather	给定输入的张量和一个地址偏移张量，Gather指令根据偏移地址将输入张量按元素收集到结果张量中。
掩码操作	SetMaskCount	设置mask模式为Counter模式。该模式下，不需要开发者去感知迭代次数、处理非对齐的尾块等操作，可直接传入计算数据量，实际迭代次数由Vector计算单元自动推断。
	SetMaskNorm	设置mask模式为Normal模式。该模式为系统默认模式，支持开发者配置迭代次数。
	SetVectorMask	用于在矢量计算时设置mask。
	ResetMask	恢复mask的值为默认值（全1），表示矢量计算中每次迭代内的所有元素都将参与运算。
量化设置	SetDeqScale	设置DEQSCALE寄存器的值。

表 4 数据搬运API列表

接口名	功能描述
DataCopy	数据搬运接口，包括普通数据搬运、增强数据搬运、切片数据搬运、随路格式转换。
Copy	VECIN、VECCALC、VECOUT之间的搬运指令，支持mask操作和 DataBlock间隔操作。

表 5 资源管理API列表

接口名	功能描述
TPipe	TPipe是用来管理全局内存等资源的框架。通过TPipe类提供的接口可以完成内存等资源的分配管理操作。
GetTPipePtr	获取框架当前管理全局内存的TPipe指针，用户获取指针后，可进行TPipe相关的操作。
TBufPool	TPipe可以管理全局内存资源，而TBufPool可以手动管理或复用 Unified Buffer/L1 Buffer物理内存，主要用于多个stage计算中 Unified Buffer/L1 Buffer物理内存不足的场景。
TQue	提供入队出队等接口，通过队列（Queue）完成任务间同步。
TQueBind	TQueBind绑定源逻辑位置和目的逻辑位置，根据源位置和目的位置，来确定内存分配的位置、插入对应的同步事件，帮助开发者解决内存分配和管理、同步等问题。
TBuf	使用 Ascend C编程的过程中，可能会用到一些临时变量。这些临时变量占用的内存可以使用TBuf数据结构来管理。
InitSpmBuffer	初始化SPM Buffer。
WriteSpmBuffer	将需要溢出暂存的数据拷贝到SPM Buffer中。
ReadSpmBuffer	从SPM Buffer读回到local数据中。
GetUserWorkspace	获取用户使用的workspace指针。
SetSysWorkSpace	在进行融合算子编程时，由于框架通信机制需要使用到workspace，也就是系统workspace，所以在该场景下，开发者要调用该接口，设置系统workspace的指针。
GetSysWorkSpacePtr	获取系统workspace指针。

表 6 同步控制API列表

接口名	功能描述
TQueSync	TQueSync类提供同步控制接口，开发者可以使用这类API来自行完成同步控制。
IBSet	当不同核之间操作同一块全局内存且可能存在读后写、写后读以及写后写等数据依赖问题时，通过调用该函数来插入同步语句来避免上述数据依赖时可能出现的数据读写错误问题。调用IBSet设置某一个核的标志位，与IBWait成对出现配合使用，表示核之间的同步等待指令，等待某一个核操作完成。
IBWait	当不同核之间操作同一块全局内存且可能存在读后写、写后读以及写后写等数据依赖问题时，通过调用该函数来插入同步语句来避免上述数据依赖时可能出现的数据读写错误问题。IBWait与IBSet成对出现配合使用，表示核之间的同步等待指令，等待某一个核操作完成。
SyncAll	当不同核之间操作同一块全局内存且可能存在读后写、写后读以及写后写等数据依赖问题时，通过调用该函数来插入同步语句来避免上述数据依赖时可能出现的数据读写错误问题。目前多核同步分为硬同步和软同步，硬件同步是利用硬件自带的全核同步指令由硬件保证多核同步，软件同步是使用软件算法模拟实现。
InitDetermineComputeWorkspace	初始化GM共享内存的值，完成初始化后才可以调用WaitPreBlock和NotifyNextBlock。
WaitPreBlock	通过读GM地址中的值，确认是否需要继续等待，当GM的值满足当前核的等待条件时，该核即可往下执行，进行下一步操作。
NotifyNextBlock	通过写GM地址，通知下一个核当前核的操作已完成，下一个核可以进行操作。
SetNextTaskStart	在SuperKernel的子Kernel中调用，调用后的指令可以和后续其他的子Kernel实现并行，提升整体性能。
WaitPreTaskEnd	在SuperKernel的子Kernel中调用，调用前的指令可以和前序其他的子Kernel实现并行，提升整体性能。

表 7 缓存处理API列表

接口名	功能描述
DataCachePreload	从源地址所在的特定DDR地址预加载数据到data cache中。
DataCacheCleanAndInvalid	该接口用来刷新Cache，保证Cache的一致性。

表 8 系统变量访问API列表

接口名	功能描述
GetBlockNum	获取当前任务配置的Block数，用于代码内部的多核逻辑控制等。
GetBlockIdx	获取当前core的index，用于代码内部的多核逻辑控制及多核偏移量计算等。
GetDataBlockSizeInBytes	获取当前芯片版本一个datablock的大小，单位为byte。开发者根据datablock的大小来计算API指令中待传入的repeatTime 、DataBlock Stride、Repeat Stride等参数值。
GetArchVersion	获取当前AI处理器架构版本号。
InitSocState	由于AI Core上存在一些全局状态，如原子累加状态、Mask模式等，在实际运行中，这些值可以被前序执行的算子修改而导致计算出现不符合预期的行为，在静态Tensor编程的场景中用户必须在Kernel入口处调用此函数来初始化AI Core状态。

表 9 原子操作接口列表

接口名	功能描述
SetAtomicAdd	设置接下来从VECOUT到GM，L0C到GM，L1到GM的数据传输是否进行原子累加，可根据参数不同设定不同的累加数据类型。
SetAtomicType	通过设置模板参数来设定原子操作不同的数据类型。
DisableDmaAtomic	原子操作函数，清空原子操作的状态。
AtomicAdd	调用该接口后，可在指定GM地址上进行原子加操作。
AtomicMin	调用该接口后，可在指定GM地址上进行原子比较取小操作。
AtomicMax	调用该接口后，可在指定GM地址上进行原子取大操作。
AtomicCas	调用该接口后，可在指定GM地址上进行原子比较，如果和value1相等，则把value2的值赋值到GM上；如果和value1不相等，则GM上的值不变。
AtomicExch	在GM内存中执行原子交换操作。具体来说，它读取指定GM地址上的数据，并将新的值存储回同一地址。函数返回旧值。

表 10 调试接口列表

接口名	功能描述
DumpTensor	基于算子工程开发的算子，可以使用该接口Dump指定Tensor的内容。
printf	基于算子工程开发的算子，可以使用该接口实现CPU侧/NPU侧调试场景下的格式化输出功能。
ascendc_assert	ascendc_assert提供了一种在CPU/NPU域实现断言功能的接口。当断言条件不满足时，系统会输出断言信息并格式化打印在屏幕上。
assert	基于算子工程开发的算子，可以使用该接口实现CPU/NPU域assert断言功能。
DumpAccChkPoint	基于算子工程开发的算子，可以使用该接口Dump指定Tensor的内容。该接口可以支持指定偏移位置的Tensor打印。
PrintTimeStamp	提供时间戳打点功能，用于在算子Kernel代码中标记关键执行点。
Trap	当软件产生异常后，使用该指令使kernel中止运行。
GmAlloc	进行核函数的CPU侧运行验证时，用于创建共享内存：在/tmp目录下创建一个共享文件，并返回该文件的映射指针。
ICPU_RUN_KF	进行核函数的CPU侧运行验证时，CPU调测总入口，完成CPU侧的算子程序调用。
ICPU_SET_TILING_KEY	用于指定本次CPU调测使用的tilingKey。调测执行时，将只执行算子核函数中该tilingKey对应的分支。
GmFree	进行核函数的CPU侧运行验证时，用于释放通过GmAlloc申请的共享内存。
SetKernelMode	CPU调测时，设置内核模式为单AIV模式，单AIC模式或者MIX模式，以分别支持单AIV矢量算子，单AIC矩阵算子，MIX混合算子的CPU调试。
TRACE_START	通过CAModel进行算子性能仿真时，可对算子任意运行阶段打点，从而分析不同指令的流水图，以便进一步性能调优。用于表示起始位置打点，一般与TRACE_STOP配套使用。
TRACE_STOP	通过CAModel进行算子性能仿真时，可对算子任意运行阶段打点，从而分析不同指令的流水图，以便进一步性能调优。用于表示终止位置打点，一般与TRACE_START配套使用。
MetricsProfStart	用于设置性能数据采集信号启动，和MetricsProfStop配合使用。使用工具进行算子上板调优时，可在kernel侧代码段前后分别调用MetricsProfStart和MetricsProfStop来指定需要调优的代码段范围。
MetricsProfStop	设置性能数据采集信号停止，和MetricsProfStart配合使用。使用工具进行算子上板调优时，可在kernel侧代码段前后分别调用MetricsProfStart和MetricsProfStop来指定需要调优的代码段范围。

表 11 工具函数接口列表

接口名	功能描述
Async	Async提供了一个统一的接口，用于在不同模式下（AIC或AIV）执行特定函数，从而避免代码中直接的硬件条件判断（如使用ASCEND_IS_AIV或ASCEND_IS_AIC）。
NumericLimits	NumericLimits工具类，用于查询指定数据类型的最大值/最小值等属性。
GetTaskRatio	适用于Cube/Vector分离模式，用来获取Cube/Vector的配比。
GetUBSizeInBytes	获取UB空间的大小，单位为byte。
GetRuntimeUBSize	获取运行时UB空间的大小，单位为byte。开发者根据UB的大小来计算循环次数等参数值。

表 12 Kernel Tiling接口列表

接口名	功能描述
GET_TILING_DATA	用于获取算子kernel入口函数传入的tiling信息，并填入注册的Tiling结构体中，此函数会以宏展开的方式进行编译。如果用户注册了多个TilingData结构体，使用该接口返回默认注册的结构体。
GET_TILING_DATA_WITH_STRUCT	使用该接口指定结构体名称，可获取指定的tiling信息，并填入对应的Tiling结构体中，此函数会以宏展开的方式进行编译。
GET_TILING_DATA_MEMBER	用于获取tiling结构体的成员变量。
TILING_KEY_IS	在核函数中判断本次执行时的tiling_key是否等于某个key，从而标识tiling_key==key的一条kernel分支。
REGISTER_TILING_DEFAULT	用于在kernel侧注册用户使用标准C++语法自定义的默认TilingData结构体。
REGISTER_TILING_FOR_TILINGKEY	用于在kernel侧注册与TilingKey相匹配的TilingData自定义结构体；该接口需提供一个逻辑表达式，逻辑表达式以字符串“TILING_KEY_VAR”代指实际TilingKey，表达TIlingKey所满足的范围。
REGISTER_NONE_TILING	在Kernel侧使用标准C++语法自定义的TilingData结构体时，若用户不确定需要注册哪些结构体，可使用该接口告知框架侧需使用未注册的标准C++语法来定义TilingData，并配套GET_TILING_DATA_WITH_STRUCT，GET_TILING_DATA_MEMBER，GET_TILING_DATA_PTR_WITH_STRUCT来获取对应的TilingData。
KERNEL_TASK_TYPE_DEFAULT	设置全局默认的kernel type，对所有的tiling key生效。
KERNEL_TASK_TYPE	设置某一个具体的tiling key对应的kernel type。

表 13 ISASI接口列表

分类	接口名	功能描述
标量计算	WriteGmByPassDCache	不经过DCache向GM地址上写数据。
标量计算	ReadGmByPassDCache	不经过DCache从GM地址上读数据。
矢量计算	VectorPadding	根据padMode（pad模式）与padSide（pad方向）对源操作数按照datablock进行填充操作。
	BilinearInterpolation	双线性插值操作，分为垂直迭代和水平迭代。
	GetCmpMask	获取Compare（结果存入寄存器）指令的比较结果。
	SetCmpMask	为Select不传入mask参数的接口设置比较寄存器。
	GetReduceRepeatSumSpr	获取ReduceSum（针对tensor前n个数据计算）接口的计算结果。
	GetReduceRepeatMaxMinSpr	获取ReduceMax、ReduceMin连续场景下的最大/最小值以及相应的索引值。
	ProposalConcat	将连续元素合入Region Proposal内对应位置，每次迭代会将16个连续元素合入到16个Region Proposals的对应位置里。
	ProposalExtract	与ProposalConcat功能相反，从Region Proposals内将相应位置的单个元素抽取后重排，每次迭代处理16个Region Proposals，抽取16个元素后连续排列。
	RpSort16	根据Region Proposals中的score域对其进行排序（score大的排前面），每次排16个Region Proposals。
	MrgSort4	将已经排好序的最多4 条region proposals队列，排列并合并成1条队列，结果按照score域由大到小排序。
	Sort32	排序函数，一次迭代可以完成32个数的排序。
	MrgSort	将已经排好序的最多4 条队列，合并排列成 1 条队列，结果按照score域由大到小排序。
	GetMrgSortResult	获取MrgSort或MrgSort4已经处理过的队列里的Region Proposal个数，并依次存储在四个List入参中。
	Gatherb	给定一个输入的张量和一个地址偏移张量，Gatherb指令根据偏移地址将输入张量收集到结果张量中。
	Scatter	给定一个连续的输入张量和一个目的地址偏移张量，Scatter指令根据偏移地址生成新的结果张量后将输入张量分散到结果张量中。
矢量计算	Prelu	源操作数src0大于0的情况下直接将src0写入目的操作数dst，否则将源操作数src0 * src1的结果写入dst。
	Mull	对前count个输入数据src0、src1按元素相乘操作，将结果写入dst0Local，溢出部分写入dst1Local。
	AbsSub	将src0Local与src1相减再求绝对值，并将计算结果写入dst。
	FusedExpSub	src0与src1相减，将差值作为指数计算自然常数e的幂次，并将计算结果写入dst。
	MulsCast	将矢量源操作数前count个数据与标量相乘再按照CAST_ROUND模式转换成half类型，并将计算结果写入dst，此接口支持标量在前和标量在后两种场景。
	Truncate	将源操作数的浮点数元素截断到整数位，同时源操作数的数据类型保持不变。
	Interleave	给定源操作数src0和src1，将src0和src1中的元素交织存入结果操作数dst0和dst1中。
	DeInterleave	给定源操作数src0和src1，将src0和src1中的元素解交织存入结果操作数dst0和dst1中。
数据搬运	DataCopyPad	该接口提供数据非对齐搬运的功能。
数据搬运	SetPadValue	设置DataCopyPad接口填充的数值。
矩阵计算	Mmad	完成矩阵乘加操作。
	MmadWithSparse	完成矩阵乘加操作，传入的左矩阵A为稀疏矩阵，右矩阵B为稠密矩阵。
	SetHF32Mode	此接口同SetHF32TransMode、SetMMRowMajor以及SetMMColumnMajor一样，都用于设置寄存器的值。SetHF32Mode接口用于设置MMAD的HF32模式。
	SetHF32TransMode	此接口同SetHF32Mode、SetMMRowMajor以及SetMMColumnMajor一样，都用于设置寄存器的值。SetHF32TransMode用于设置MMAD的HF32取整模式，仅在MMAD的HF32模式生效时有效。
	SetMMRowMajor	此接口同SetHF32Mode、SetHF32TransMode一样，都用于设置寄存器的值，本接口用于设置MMAD 计算时优先通过M方向。
	SetMMColumnMajor	此接口同SetHF32Mode、SetHF32TransMode一样，都用于设置寄存器的值，本接口用于设置MMAD 计算时优先通过N方向。
	Conv2D	计算给定输入张量和权重张量的2-D卷积，输出结果张量。Conv2d卷积层多用于图像识别，使用过滤器提取图像中的特征。
	Gemm	根据输入的切分规则，将给定的两个输入张量做矩阵乘，输出至结果张量。将A和B两个输入矩阵乘法在一起，得到一个输出矩阵C。
	SetFixPipeConfig	DataCopy（CO1->GM、CO1->A1）过程中进行随路量化时，通过调用该接口设置量化流程中tensor量化参数。
	SetFixpipeNz2ndFlag	DataCopy（CO1->GM、CO1->A1）过程中进行随路格式转换（NZ2ND）时，通过调用该接口设置NZ2ND相关配置。
	SetFixpipePreQuantFlag	DataCopy（CO1->GM、CO1->A1）过程中进行随路量化时，通过调用该接口设置量化流程中scalar量化参数。
	SetFixPipeClipRelu	DataCopy（CO1->GM）过程中进行随路量化后，通过调用该接口设置ClipRelu操作的最大值。
	SetFixPipeAddr	DataCopy（CO1->GM）过程中进行随路量化后，通过调用该接口设置element-wise操作时LocalTensor的地址。
	Fill	初始化LocalTensor（TPosition为A1/A2/B1/B2）为某一个具体的数值。
	LoadData	LoadData包括Load2D和Load3D数据加载功能。
	LoadDataWithTranspose	该接口实现带转置的2D格式数据从A1/B1到A2/B2的加载。
	SetAippFunctions	设置图片预处理（AIPP，AI core pre-process）相关参数。
	LoadImageToLocal	将图像数据从GM搬运到A1/B1。搬运过程中可以完成图像预处理操作：包括图像翻转，改变图像尺寸（抠图，裁边，缩放，伸展），以及色域转换，类型转换等。
	LoadUnZipIndex	加载GM上的压缩索引表到内部寄存器。
	LoadDataUnzip	将GM上的数据解压并搬运到A1/B1/B2上。
	LoadDataWithSparse	用于搬运存放在B1里的512B的稠密权重矩阵到B2里，同时读取128B的索引矩阵用于稠密矩阵的稀疏化。
	SetFmatrix	用于调用Load3Dv1/Load3Dv2时设置FeatureMap的属性描述。
	SetLoadDataBoundary	设置Load3D时A1/B1边界值。
	SetLoadDataRepeat	用于设置Load3Dv2接口的repeat参数。设置repeat参数后，可以通过调用一次Load3Dv2接口完成多个迭代的数据搬运。
	SetLoadDataPaddingValue	设置padValue，用于Load3Dv1/Load3Dv2。
	Fixpipe	矩阵计算完成后，对结果进行处理，例如对计算结果进行量化操作，并把数据从CO1搬迁到Global Memory中。
同步控制	SetFlag/WaitFlag	同一核内不同流水线之间的同步指令。具有数据依赖的不同流水指令之间需要插此同步。
	PipeBarrier	阻塞相同流水，具有数据依赖的相同流水之间需要插此同步。
	DataSyncBarrier	用于阻塞后续的指令执行，直到所有之前的内存访问指令（需要等待的内存位置可通过参数控制）执行结束。
	CrossCoreSetFlag	针对分离模式，AI Core上的Cube核（AIC）与Vector核（AIV）之间的同步设置指令。
	CrossCoreWaitFlag	针对分离模式，AI Core上的Cube核（AIC）与Vector核（AIV）之间的同步等待指令。
同步控制	Mutex	Mutex用于核内异步流水指令之间的同步处理，其功能类似于传统CPU中的锁机制。通过锁定指定流水再释放流水来完成流水间的同步依赖。每个锁有固定的一个MutexID，该ID可通过用户自定义（范围为0-27）或者通过AllocMutexID/ReleaseMutexID进行申请释放。
	AllocMutexID	从框架获取并占用一个MutexID，与ReleaseMutexID配合使用，管理MutexID的获取和释放。
	ReleaseMutexID	从框架释放一个MutexID，与AllocMutexID配合使用。
缓存处理	ICachePreLoad	从指令所在DDR地址预加载指令到ICache中。
缓存处理	GetICachePreloadStatus	获取ICACHE的PreLoad的状态。
系统变量访问	GetProgramCounter	获取程序计数器的指针，程序计数器用于记录当前程序执行的位置。
	GetSubBlockNum	获取AI Core上Vector核的数量。
	GetSubBlockIdx	获取AI Core上Vector核的ID。
	GetSystemCycle	获取当前系统cycle数，若换算成时间需要按照50MHz的频率，时间单位为us，换算公式为：time = (cycle数/50) us 。
系统变量访问	SetCtrlSpr	对CTRL寄存器（控制寄存器）的特定比特位进行设置。
	GetCtrlSpr	读取CTRL寄存器（控制寄存器）特定比特位上的值。
	ResetCtrlSpr	对CTRL寄存器（控制寄存器）的特定比特位做重置。
原子操作	SetAtomicMax	原子操作函数，设置后续从VECOUT传输到GM的数据是否执行原子比较，将待拷贝的内容和GM已有内容进行比较，将最大值写入GM。
	SetAtomicMin	原子操作函数，设置后续从VECOUT传输到GM的数据是否执行原子比较，将待拷贝的内容和GM已有内容进行比较，将最小值写入GM。
	SetStoreAtomicConfig	设置原子操作使能位与原子操作类型。
	GetStoreAtomicConfig	获取原子操作使能位与原子操作类型的值。
调试接口	CheckLocalMemoryIA	监视设定范围内的UB读写行为，如果监视到有设定范围的读写行为则会出现EXCEPTION报错，未监视到设定范围的读写行为则不会报错。
Cube分组管理	CubeResGroupHandle	CubeResGroupHandle用于在分离模式下通过软同步控制AIC和AIV之间进行通讯，实现 AI Core计算资源分组。
	GroupBarrier	当同一个CubeResGroupHandle中的两个AIV任务之间存在依赖关系时，可以使用GroupBarrier控制同步。
	KfcWorkspace	KfcWorkspace为通信空间描述符，管理不同CubeResGroupHandle的消息通信区划分，与CubeResGroupHandle配合使用。KfcWorkspace的构造函数用于创建KfcWorkspace对象。

高阶API

表 14 数学计算API列表

接口名	功能描述
Acos	按元素做反余弦函数计算。
Acosh	按元素做双曲反余弦函数计算。
Asin	按元素做反正弦函数计算。
Asinh	按元素做反双曲正弦函数计算。
Atan	按元素做三角函数反正切运算。
Atanh	按元素做反双曲正切余弦函数计算。
Axpy	源操作数中每个元素与标量求积后和目的操作数中的对应元素相加。
Ceil	获取大于或等于x的最小的整数值，即向正无穷取整操作。
ClampMax	将srcTensor中大于scalar的数替换为scalar，小于等于scalar的数保持不变，作为dstTensor输出。
ClampMin	将srcTensor中小于scalar的数替换为scalar，大于等于scalar的数保持不变，作为dstTensor输出。
Cos	按元素做三角函数余弦运算。
Cosh	按元素做双曲余弦函数计算。
CumSum	对数据按行依次累加或按列依次累加。
Digamma	按元素计算x的gamma函数的对数导数。
Erf	按元素做误差函数计算，也称为高斯误差函数。
Erfc	返回输入x的互补误差函数结果，积分区间为x到无穷大。
Exp	按元素取自然指数。
Floor	获取小于或等于x的最小的整数值，即向负无穷取整操作。
Fmod	按元素计算两个浮点数相除后的余数。
Frac	按元素做取小数计算。
Hypot	按元素计算两个浮点数平方和的平方根。
IsFinite	按元素判断输入的浮点数是否非NAN、非±INF。
Lgamma	按元素计算x的gamma函数的绝对值并求自然对数。
Log	按元素以e、2、10为底做对数运算。
Power	实现按元素做幂运算功能。
Round	将输入的元素四舍五入到最接近的整数。
Sign	按元素执行Sign操作，Sign是指返回输入数据的符号。
Sin	按元素做正弦函数计算。
Sinh	按元素做双曲正弦函数计算。
Tan	按元素做正切函数计算。
Tanh	按元素做逻辑回归Tanh。
Trunc	按元素做浮点数截断操作，即向零取整操作。
Xor	按元素执行Xor（异或）运算。
Fma	按元素计算两个输入相乘后与第三个输入相加的结果。
IsNan	按元素判断输入的浮点数是否为nan。
IsInf	按元素判断输入的浮点数是否为±INF。
Rint	获取与输入数据最接近的整数。
SinCos	按元素进行正弦计算和余弦计算，分别获得正弦和余弦的结果。
LogicalNot	按元素进行取反操作。
LogicalAnd	按元素进行与操作。
LogicalAnds	输入矢量内的每个元素与标量进行与操作。
LogicalOr	按元素进行或操作。
LogicalOrs	输入矢量内的每个元素与标量进行或操作。
LogicalXor	按元素进行逻辑异或操作。
BitwiseNot	逐比特对输入进行取反。
BitwiseAnd	逐比特对两个输入进行与操作。
BitwiseOr	逐比特对两个输入进行或操作。
BitwiseXor	逐比特对两个输入进行异或操作。
Where	根据指定的条件，从两个源操作数中选择元素，生成目标操作数。

表 15 量化操作API列表

接口名	功能描述
AntiQuantize	按元素做伪量化计算，比如将int8_t数据类型伪量化为half数据类型。
AscendAntiQuant	按元素做伪量化计算，比如将int8_t数据类型伪量化为half数据类型。
Dequantize	按元素做反量化计算，比如将int32_t数据类型反量化为half/float等数据类型。
AscendDequant	按元素做反量化计算，比如将int32_t数据类型反量化为half/float等数据类型。
Quantize	按元素做量化计算，比如将half/float数据类型量化为int8_t数据类型。
AscendQuant	按元素做量化计算，比如将half/float数据类型量化为int8_t数据类型。

表 16 归一化操作API列表

接口名	功能描述
BatchNorm	对于每个batch中的样本，对其输入的每个特征在batch的维度上进行归一化。
DeepNorm	在深层神经网络训练过程中，可以替代LayerNorm的一种归一化方法。
GroupNorm	将输入的C维度分为groupNum组，对每一组数据进行标准化。
LayerNorm	将输入数据收敛到[0, 1]之间，可以规范网络层输入输出数据分布的一种归一化方法。
LayerNormGrad	用于计算LayerNorm的反向传播梯度。
LayerNormGradBeta	用于获取反向beta/gmma的数值，和LayerNormGrad共同输出pdx, gmma和beta。
Normalize	LayerNorm中，已知均值和方差，计算shape为[A，R]的输入数据的标准差的倒数rstd和归一化输出y。
RmsNorm	实现对shape大小为[B，S，H]的输入数据的RmsNorm归一化。
WelfordUpdate	实现Welford算法的前处理。
WelfordFinalize	实现Welford算法的后处理。

表 17 激活函数API列表

接口名	功能描述
AdjustSoftMaxRes	用于对SoftMax相关计算结果做后处理，调整SoftMax的计算结果为指定的值。
FasterGelu	FastGelu化简版本的一种激活函数。
FasterGeluV2	实现FastGeluV2版本的一种激活函数。
GeGLU	采用GeLU作为激活函数的GLU变体。
Gelu	GELU是一个重要的激活函数，其灵感来源于relu和dropout，在激活中引入了随机正则的思想。
LogSoftMax	对输入tensor做LogSoftmax计算。
ReGlu	一种GLU变体，使用Relu作为激活函数。
Sigmoid	按元素做逻辑回归Sigmoid。
Silu	按元素做Silu运算。
SimpleSoftMax	使用计算好的sum和max数据对输入tensor做softmax计算。
SoftMax	对输入tensor按行做Softmax计算。
SoftmaxFlash	SoftMax增强版本，除了可以对输入tensor做softmaxflash计算，还可以根据上一次softmax计算的sum和max来更新本次的softmax计算结果。
SoftmaxFlashV2	SoftmaxFlash增强版本，对应FlashAttention-2算法。
SoftmaxFlashV3	SoftmaxFlash增强版本，对应Softmax PASA算法。
SoftmaxGrad	对输入tensor做grad反向计算的一种方法。
SoftmaxGradFront	对输入tensor做grad反向计算的一种方法。
SwiGLU	采用Swish作为激活函数的GLU变体。
Swish	神经网络中的Swish激活函数。

表 18 归约操作API列表

接口名	功能描述
Sum	获取最后一个维度的元素总和。
Mean	根据最后一轴的方向对各元素求平均值。
ReduceXorSum	按照元素执行Xor（按位异或）运算，并将计算结果ReduceSum求和。
ReduceSum	对一个多维向量按照指定的维度进行数据累加。
ReduceMean	对一个多维向量按照指定的维度求平均值。
ReduceMax	对一个多维向量在指定的维度求最大值。
ReduceMin	对一个多维向量在指定的维度求最小值。
ReduceAny	对一个多维向量在指定的维度求逻辑或。
ReduceAll	对一个多维向量在指定的维度求逻辑与。
ReduceProd	对一个多维向量在指定的维度求积。

表 19 排序操作API列表

接口名	功能描述
TopK	获取最后一个维度的前k个最大值或最小值及其对应的索引。
Concat	对数据进行预处理，将要排序的源操作数srcLocal一一对应的合入目标数据concatLocal中，数据预处理完后，可以进行Sort。
Extract	处理Sort的结果数据，输出排序后的value和index。
Sort	排序函数，按照数值大小进行降序排序。
MrgSort	将已经排好序的最多4条队列，合并排列成1条队列，结果按照score域由大到小排序。

表 20 数据过滤API列表

接口名	功能描述
Select	给定两个源操作数src0和src1，根据maskTensor相应位置的值（非bit位）选取元素，得到目的操作数dst。
DropOut	提供根据MaskTensor对源操作数进行过滤的功能，得到目的操作数。

表 21 张量变换API列表

接口名	功能描述
Transpose	对输入数据进行数据排布及Reshape操作。
TransData	将输入数据的排布格式转换为目标排布格式。
Broadcast	将输入按照输出shape进行广播。
Pad	对height * width的二维Tensor在width方向上pad到32B对齐。
UnPad	对height * width的二维Tensor在width方向上进行unpad。
Fill	将Global Memory上的数据初始化为指定值。

表 22 索引计算API列表

接口名	功能描述
Arange	给定起始值，等差值和长度，返回一个等差数列。

表 23 矩阵计算API列表

接口名	功能描述
Matmul	Matmul矩阵乘法的运算。

表 24 HCCL通信类API列表

接口名	功能描述
HCCL通信类	在AI Core侧编排集合通信任务。

表 25 卷积计算API列表

接口名	功能描述
Conv3D	3维卷积正向矩阵运算。
Conv3DBackpropInput	卷积的反向运算，求解特征矩阵的反向传播误差。
Conv3DBackpropFilter	卷积的反向运算，求解权重的反向传播误差。

表 26 随机函数API列表

接口名	功能描述
PhiloxRandom	基于Philox随机数生成算法，给定随机数种子，生成若干的随机数。

SIMT API

表 27 核函数定义API

接口名	功能描述
asc_vf_call	启动SIMT VF（Vector Function）子任务，启动指定数目的线程，执行指定的SIMT核函数。

表 28 同步函数

接口名	功能描述
asc_syncthreads	等待当前thread block内所有thread代码都执行到该函数位置。
asc_threadfence	用于保证不同核对同一份全局、共享内存的访问过程中，写入操作的时序性。

表 29 数学函数

接口名	功能描述
tanf	获取输入数据的三角函数正切值。
tanhf	获取输入数据的三角函数双曲正切值。
htanh	获取输入数据的三角函数双曲正切值。
h2tanh	获取输入数据各元素的三角函数双曲正切值。
tanpif	获取输入数据与π相乘的正切值。
atanf	获取输入数据的反正切值。
atan2f	获取输入数据y/x的反正切值。
atanhf	获取输入数据的反双曲正切值。
expf	指定输入x，获取e的x次方。
hexp	指定输入x，获取e的x次方。
h2exp	指定输入x，对x的各元素，获取e的该元素次方。
exp2f	指定输入x，获取2的x次方。
hexp2	指定输入x，获取2的x次方。
h2exp2	指定输入x，对x的各元素，获取2的该元素次方。
exp10f	指定输入x，获取10的x次方。
hexp10	指定输入x，获取10的x次方。
h2exp10	指定输入x，对x的各元素，获取10的该元素次方。
expm1f	指定输入x，获取e的x次方减1。
logf	获取以e为底，输入数据的对数。
hlog	获取以e为底，输入数据的对数。
h2log	获取以e为底，输入数据各元素的对数。
log2f	获取以2为底，输入数据的对数。
hlog2	获取以2为底，输入数据的对数。
h2log2	获取以2为底，输入数据各元素的对数。
log10f	获取以10为底，输入数据的对数。
hlog10	获取以10为底，输入数据的对数。
h2log10	获取以10为底，输入数据各元素的对数。
log1pf	获取以e为底，输入数据加1的对数。
logbf	计算以2为底，输入数据的对数，并对结果向下取整，返回浮点数。
ilogbf	计算以2为底，输入数据的对数，并对结果向下取整，返回整数。
cosf	获取输入数据的三角函数余弦值。
hcos	获取输入数据的三角函数余弦值。
h2cos	获取输入数据各元素的三角函数余弦值。
coshf	获取输入数据的双曲余弦值。
cospif	获取输入数据与π相乘的余弦值。
acosf	获取输入数据的反余弦值。
acoshf	获取输入数据的双曲反余弦值。
sinf	获取输入数据的三角函数正弦值。
hsin	获取输入数据的三角函数正弦值。
h2sin	获取输入数据各元素的三角函数正弦值。
sinhf	获取输入数据的双曲正弦值。
sinpif	获取输入数据与π相乘的正弦值。
asinf	获取输入数据的反正弦值。
asinhf	获取输入数据的双曲反正弦值。
sincosf	获取输入数据的三角函数正弦值和余弦值。
sincospif	获取输入数据与π相乘的三角函数正弦值和余弦值。
frexpf	将x转换为归一化[1/2, 1)的有符号数乘以2的积分幂。
ldexpf	获取输入x乘以2的exp次幂的结果。
sqrtf	获取输入数据x的平方根。
hsqrt	获取输入数据x的平方根。
h2sqrt	获取输入数据x各元素的平方根。
rsqrtf	获取输入数据x的平方根的倒数。
hrsqrt	获取输入数据x的平方根的倒数。
h2rsqrt	获取输入数据x各元素的平方根的倒数。
hrcp	获取输入数据x的倒数。
h2rcp	获取输入数据x各元素的倒数。
hypotf	获取输入数据x、y的平方和x^2 + y^2的平方根。
rhypotf	获取输入数据x、y的平方和x^2 + y^2的平方根的倒数。
powf	获取输入数据x的y次幂。
norm3df	获取输入数据a、b、c的平方和a^2 + b^2 + c^2的平方根。
rnorm3df	获取输入数据a、b、c的平方和a^2 + b^2 + c^2的平方根的倒数。
norm4df	获取输入数据a、b、c、d的平方和a^2 + b^2+ c^2+ d^2的平方根。
rnorm4df	获取输入数据a、b、c、d的平方和a^2 + b^2 + c^2 + d^2的平方根的倒数。
normf	获取输入数据a中前n个元素的平方和a[0]^2 + a[1]^2 +...+ a[n-1]^2的平方根。
rnormf	获取输入数据a中前n个元素的平方和a[0]^2 + a[1]^2 + ...+ a[n-1]^2的平方根的倒数。
cbrtf	获取输入数据x的立方根。
rcbrtf	获取输入数据x的立方根的倒数。
erff	获取输入数据的误差函数值。
erfcf	获取输入数据的互补误差函数值。
erfinvf	获取输入数据的逆误差函数值。
erfcinvf	获取输入数据的逆互补误差函数值。
erfcxf	获取输入数据的缩放互补误差函数值。
tgammaf	获取输入数据x的伽马函数值。
lgammaf	获取输入数据x伽马值的绝对值并求自然对数。
cyl_bessel_i0f	获取输入数据x的0阶常规修正圆柱贝塞尔函数的值。
cyl_bessel_i1f	获取输入数据x的1阶常规修正圆柱贝塞尔函数的值。
normcdff	获取输入数据x的标准正态分布的累积分布函数值。
normcdfinvf	获取输入数据x的标准正态累积分布的逆函数
j0f	获取输入数据x的0阶第一类贝塞尔函数j0的值。
j1f	获取输入数据x的1阶第一类贝塞尔函数j1的值。
jnf	获取输入数据x的n阶第一类贝塞尔函数jn的值。
y0f	获取输入数据x的0阶第二类贝塞尔函数y0的值。
y1f	获取输入数据x的1阶第二类贝塞尔函数y1的值。
ynf	获取输入数据x的n阶第二类贝塞尔函数yn的值。
fabsf	获取输入数据的绝对值。
__habs	获取输入数据的绝对值。
fmaf	对输入数据x、y、z，计算x与y相乘加上z的结果。
__hfma	对输入数据x、y、z，计算x与y相乘加上z的结果。
fmaxf	获取两个输入数据中的最大值。
__hmax	获取两个输入数据中的最大值。
fminf	获取两个输入数据中的最小值。
__hmin	获取两个输入数据中的最小值。
fdimf	获取输入数据的差值，差值小于0时，返回0。
remquof	获取输入数据x除以y的余数。求余数时，商取最接近x除以y浮点数结果的整数，当x除以y的浮点数结果与左右最接近的整数距离相等时，商取偶数，同时将商赋值给指针变量quo。
fmodf	获取输入数据x除以y的余数。求余数时，商取x除以y浮点数结果的整数部分。
remainderf	获取输入数据x除以y的余数。求余数时，商取最接近x除以y浮点数结果的整数，当x除以y的浮点数结果与左右最接近的整数距离相等时，商取偶数。
copysignf	获取由第一个输入x的数值部分和第二个输入y的符号部分拼接得到的浮点数。
nearbyIntf	获取与输入浮点数最接近的整数，输入浮点数与左右整数的距离相等时，返回偶数。
nextafterf	如果y大于x，返回比x大的下一个可表示的浮点值，即浮点数二进制最低位加1。如果y小于x，返回比x小的下一个可表示的浮点值，即浮点数二进制最低位减1。如果y等于x，返回x。
scalbnf	获取输入数据x与2的n次方的乘积。
scalblnf	获取输入数据x与2的n次方的乘积。

表 30 精度转换

接口名	功能描述
rintf	获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。
hrint	获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。
h2rint	获取与输入数据各元素最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。
lrintf	获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。
llrintf	获取与输入数据最接近的整数，若存在两个同样接近的整数，则获取其中的偶数。
roundf	获取对输入数据四舍五入后的整数。
lroundf	获取对输入数据四舍五入后的整数。
llroundf	获取对输入数据四舍五入后的整数。
floorf	获取小于或等于输入数据的最大整数值。
hfloor	获取小于或等于输入数据的最大整数值。
h2floor	获取小于或等于输入数据各元素的最大整数值。
ceilf	获取大于或等于输入数据的最小整数值。
hceil	获取大于或等于输入数据的最小整数值。
h2ceil	获取大于或等于输入数据各元素的最小整数值。
truncf	获取对输入数据的浮点数截断后的整数。
htrunc	获取对输入数据的浮点数截断后的整数。
h2trunc	获取对输入数据各元素的浮点数截断后的整数。

表 31 比较函数

接口名	功能描述
isfinite	判断浮点数是否为有限数（非inf、非nan）。
isnan	判断浮点数是否为nan。
__hisnan	判断浮点数是否为nan。
isinf	判断浮点数是否为无穷。
__hisinf	判断浮点数是否为无穷。

表 32 Atomic函数

接口名	功能描述
asc_atomic_add	对 Unified Buffer或 Global Memory上的数据与指定数据执行原子加操作，即将指定数据累加到 Unified Buffer或 Global Memory的数据中。
asc_atomic_sub	对 Unified Buffer或 Global Memory上的数据与指定数据执行原子减操作，即在 Unified Buffer或 Global Memory的数据上减去指定数据。
asc_atomic_exch	对 Unified Buffer或 Global Memory地址做原子赋值操作，即将指定数据赋值到 Unified Buffer或 Global Memory地址中。
asc_atomic_max	对 Unified Buffer或 Global Memory数据做原子求最大值操作，即将 Unified Buffer或 Global Memory的数据与指定数据中的最大值赋值到 Unified Buffer或 Global Memory地址中。
asc_atomic_min	对 Unified Buffer或 Global Memory数据做原子求最小值操作，即将 Unified Buffer或 Global Memory的数据与指定数据中的最小值赋值到 Unified Buffer或 Global Memory地址中。
asc_atomic_inc	对 Unified Buffer或 Global Memory上address的数值进行原子加1操作，如果address上的数值大于等于指定数值val，则对address赋值为0，否则将address上数值加1。
asc_atomic_dec	对 Unified Buffer或 Global Memory上address的数值进行原子减1操作，如果address上的数值等于0或大于指定数值val，则对address赋值为val，否则将address上数值减1。
asc_atomic_cas	对 Unified Buffer或 Global Memory上address的数值进行原子比较赋值操作，如果address上的数值等于指定数值compare，则对address赋值为指定数值val，否则address的数值不变。
asc_atomic_and	对 Unified Buffer或 Global Memory上address的数值与指定数值val进行原子与（&）操作，即将address数值与（&）val的结果赋值到 Unified Buffer或 Global Memory上。
asc_atomic_or	对 Unified Buffer或 Global Memory上address的数值与指定数值val进行原子或（\|）操作，即将address数值或（\|）val的结果赋值到 Unified Buffer或 Global Memory上。
asc_atomic_xor	对 Unified Buffer或 Global Memory上address的数值与指定数值val进行原子异或（^）操作，即将address数值异或（^）val的结果赋值到 Unified Buffer或 Global Memory上。

表 33 Warp函数

接口名	功能描述
asc_all	判断是否所有活跃线程的输入均不为0。
asc_any	判断是否有活跃线程的输入不为0。
asc_ballot	判断Warp内每个活跃线程的输入是否不为0。
asc_activemask	查看Warp内所有线程是否为活跃状态。
asc_shfl	获取Warp内指定线程srcLane输入的用于交换的var值。
asc_shfl_up	获取Warp内当前线程向前偏移delta（当前线程LaneId-delta）的线程输入的用于交换的var值。
asc_shfl_down	获取Warp内当前线程向后偏移delta（当前线程LaneId+delta）的线程输入的用于交换的var值。
asc_shfl_xor	获取Warp内当前线程LaneId与输入laneMask做异或操作（LaneId^laneMask）得到的dstLaneId对应线程输入的用于交换的var值。
asc_reduce_add	对Warp内所有活跃线程输入的val求和。
asc_reduce_max	对Warp内所有活跃线程输入的val求最大值。
asc_reduce_min	对Warp内所有活跃线程输入val求最小值。

表 34 类型转换

接口名	功能描述
__float2half	将浮点数转换为半精度浮点数，并四舍五入到最接近的偶数，返回转换后的值。
__float2half_rn	将浮点数转换为半精度浮点数，并四舍五入到最接近的偶数，返回转换后的值。
__float2half_rz	将浮点数转换为半精度浮点数，并向零的方向舍入，返回转换后的值。
__float2half_rd	将浮点数转换为半精度浮点数，并在转换过程中向下取整，返回转换后的值。
__float2half_ru	将浮点数转换为半精度浮点数，并在转换过程中向上取整，返回转换后的值。
__float2half_rna	将浮点数转换为半精度浮点数，并向远离零的方向舍入，返回转换后的值。
__float2half_ro	将浮点数转换为半精度浮点数，并四舍五入到最接近的奇数，返回转换后的值。
__float2bfloat16	将浮点数转换为bfloat16精度，并四舍五入到最接近的偶数，返回转换后的值。
__float2bfloat16_rn	将浮点数转换为bfloat16精度，并四舍五入到最接近的偶数，返回转换后的值。
__float2bfloat16_rz	将浮点数转换为bfloat16精度，并向零的方向舍入，返回转换后的值。
__float2bfloat16_rd	将浮点数转换为bfloat16精度，在转换过程中将结果向下舍入，返回转换后的值。
__float2bfloat16_ru	将浮点数转换为bfloat16精度，在转换过程中将结果向上取整，返回转换后的值。
__float2bfloat16_rna	将浮点数转换为bfloat16精度，并向远离零的方向舍入，返回转换后的值。
__float2uint_rn	将浮点数转换为四舍五入至最接近的偶数的无符号整数。
__float2uint_rz	将浮点数转换为向零舍入的无符号整数。
__float2uint_rd	将浮点数转换为向下取整的无符号整数。
__float2uint_ru	将浮点数转换为向上取整的无符号整数。
__float2uint_rna	将浮点数转换为向远离零舍入的无符号整数。
__float2int_rn	将浮点数转换为有符号整数，并四舍五入到最接近的偶数。
__float2int_rz	将浮点数转换为向零舍入的有符号整数。
__float2int_rd	将浮点数转换为向下取整的有符号整数。
__float2int_ru	将浮点数转换为向上取整的有符号整数。
__float2int_rna	将浮点数转换为向远离零舍入的有符号整数。
__float2ull_rn	将浮点数转换为四舍五入到最接近偶数的64位无符号整数。
__float2ull_rz	将浮点数转换为向零舍入的64位无符号整数。
__float2ull_rd	将浮点数转换为向下取整的64位无符号整数。
__float2ull_ru	将浮点数转换为向上取整的64位无符号整数。
__float2ull_rna	将浮点数转换为向远离零舍入的64位无符号整数。
__float2ll_rn	将浮点数转换为有符号64位整数，并四舍五入到最接近的偶数。
__float2ll_rz	将浮点数转换为向零舍入的64位有符号整数。
__float2ll_rd	将浮点数转换为向下取整的64位有符号整数。
__float2ll_ru	将浮点数转换为向上取整的64位有符号整数。
__float2ll_rna	将浮点数转换为向远离零舍入的64位有符号整数。
__half2float	将half转换为浮点数。
__half2bfloat16_rn	将half转换为bfloat16，并四舍五入到最接近的偶数。
__half2bfloat16_rz	将half 转换为向零舍入的bfloat16。
__half2bfloat16_rd	将half转换为向下取整的bfloat16。
__half2bfloat16_ru	将half转换为bfloat16（向上取整）。
__half2bfloat16_rna	将half类型数据转换为向远离零舍入的bfloat16类型数据。
__half2uint_rn	将half转换为无符号整数，并四舍五入到最接近的偶数。
__half2uint_rz	将half转换为向零舍入的无符号整数。
__half2uint_rd	将half转换为向下取整的无符号整数。
__half2uint_ru	将half转换为向上取整的无符号整数。
__half2uint_rna	将half类型数据转换为向远离零舍入的无符号整数。
__half2int_rn	将half转换为有符号整数，并四舍五入到最接近的偶数。
__half2int_rz	将half 转换为向零舍入的有符号整数。
__half2int_rd	将half转换为向下取整的有符号整数。
__half2int_ru	将half转换为有符号整数（向上取整）。
__half2int_rna	将half类型数据转换为向远离零舍入的有符号整数。
__half2ull_rn	将half转换为无符号64位整数，并四舍五入到最接近的偶数。
__half2ull_rz	将half转换为向零舍入的64位无符号整数。
__half2ull_rd	将half转换为向下取整的64位无符号整数。
__half2ull_ru	将half 转换为向上取整的64位无符号整数。
__half2ull_rna	将half类型数据转换为向远离零舍入的64位无符号整数。
__half2ll_rn	将half转换为有符号64位整数，并四舍五入到最接近的偶数位。
__half2ll_rz	将half转换为向零舍入的64位有符号整数。
__half2ll_rd	将half转换为向下取整的64位有符号整数。
__half2ll_ru	将half 转换为向上取整的64位有符号整数。
__half2ll_rna	将half类型数据转换为向远离零舍入的64位有符号整数。
__bfloat162half_rn	将bfloat16转换为half，并四舍五入到最接近的偶数，然后返回转换后的值。
__bfloat162half_rz	将bfloat16转换为向零舍入的half。
__bfloat162half_rd	将bfloat16转换为向下取整的half。
__bfloat162half_ru	将bfloat16转换为向上取整的half。
__bfloat162half_rna	将bfloat16类型数据转换为向远离零舍入的half类型数据。
__bfloat162float	将bfloat16转换为浮点数。
__bfloat162uint_rn	将bfloat16转换为四舍五入到最接近偶数的无符号整数。
__bfloat162uint_rz	将bfloat16转换为向零舍入的无符号整数。
__bfloat162uint_rd	将bfloat16转换为向下取整的无符号整数。
__bfloat162uint_ru	将bfloat16转换为向上取整的无符号整数。
__bfloat162uint_rna	将bfloat16类型数据转换为向远离零舍入的无符号整数。
__bfloat162int_rn	将bfloat16转换为四舍五入到最接近偶数的有符号整数
__bfloat162int_rz	将bfloat16转换为向零舍入的有符号整数。
__bfloat162int_rd	将bfloat16转换为向下取整的有符号整数。
__bfloat162int_ru	将bfloat16转换为向上取整的有符号整数。
__bfloat162int_rna	将bfloat16类型数据转换为向远离零舍入的有符号整数。
__bfloat162ull_rn	将bfloat16转换为四舍五入到最接近偶数的64位无符号整数。
__bfloat162ull_rz	将bfloat16 转换为向零舍入的64位无符号整数。
__bfloat162ull_rd	将 bfloat16转换为向下取整的64位无符号整数。
__bfloat162ull_ru	将bfloat16转换为向上取整的64位无符号整数。
__bfloat162ull_rna	将bfloat16类型数据转换为向远离零舍入的64位无符号整数。
__bfloat162ll_rn	将 bfloat16转换为四舍五入到最接近偶数的64位有符号整数。
__bfloat162ll_rz	将bfloat16转换为向零舍入的64位有符号整数。
__bfloat162ll_rd	将bfloat16转换为向下取整的64位有符号整数。
__bfloat162ll_ru	将 bfloat16转换为向上取整的64位有符号整数。
__bfloat162ll_rna	将bfloat16类型数据转换为向远离零舍入的64位有符号整数。
__uint2float_rn	将uint32转换为浮点数，并四舍五入到最接近的偶数。
__uint2float_rz	将uint32转换为向零舍入的浮点数。
__uint2float_rd	将uint32向下取整转换为浮点数。
__uint2float_ru	将uint32转换为向上取整的浮点数。
__uint2float_rna	将uint32类型数据转换为向远离零舍入的浮点数。
__uint2half_rn	将uint32转换为half（四舍五入到最接近的偶数）。
__uint2half_rz	将uint32转换为向零舍入的half。
__uint2half_rd	将uint32向下取整为half。
__uint2half_ru	将uint32向上取整转换为half。
__uint2half_rna	将uint32类型数据转换为向远离零舍入的half类型数据。
__uint2bfloat16_rn	将uint32转换为bfloat16，并四舍五入到最接近的偶数。
__uint2bfloat16_rz	将uint32转换为向零舍入的bfloat16。
__uint2bfloat16_rd	将uint32向下取整转换为bfloat16。
__uint2bfloat16_ru	将uint32向上取整转换为bfloat16。
__uint2bfloat16_rna	将uint32类型数据转换为向远离零舍入的bfloat16类型数据。
__int2float_rn	将int32转换为浮点数，并四舍五入到最接近的偶数。
__int2float_rz	将int32转换为向零舍入的浮点数。
__int2float_rd	将int32向下取整转换为浮点数。
__int2float_ru	将int32转换为向上取整的浮点数。
__int2float_rna	将int32类型数据转换为向远离零舍入的浮点数。
__int2half_rn	将int32转换为half（四舍五入到最接近的偶数）。
__int2half_rz	将int32转换为向零舍入的half。
__int2half_rd	将int32向下取整为half。
__int2half_ru	将int32向上取整转换为half。
__int2half_rna	将int32类型数据转换为向远离零舍入的half类型数据。
__int2bfloat16_rn	将int32转换为bfloat16，并四舍五入到最接近的偶数。
__int2bfloat16_rz	将int32转换为向零舍入的bfloat16。
__int2bfloat16_rd	将int32向下取整转换为bfloat16。
__int2bfloat16_ru	将int32向上取整转换为bfloat16。
__int2bfloat16_rna	将int32类型数据转换为向远离零舍入的bfloat16类型数据。
__ull2float_rn	将uint64转换为浮点数，并四舍五入到最接近的偶数。
__ull2float_rz	将uint64转换为向零舍入的浮点数。
__ull2float_rd	将uint64向下取整转换为浮点数。
__ull2float_ru	将uint64向上取整转换为浮点数。
__ull2float_rna	将uint64类型数据转换为向远离零舍入的浮点数。
__ull2half_rn	将uint64转换为half，并四舍五入到最接近的偶数。
__ull2half_rz	将uint64转换为向零舍入的half。
__ull2half_rd	将uint64向下取整转换为half。
__ull2half_ru	将uint64向上取整转换为浮点数。
__ull2half_rna	将uint64类型数据转换为向远离零舍入的half类型数据。
__ull2bfloat16_rn	将uint64转换为bfloat16，并四舍五入到最接近的偶数。
__ull2bfloat16_rz	将uint64转换为向零舍入的bfloat16。
__ull2bfloat16_rd	将uint64向下取整转换为bfloat16。
__ull2bfloat16_ru	将uint64向上取整转换为bfloat16。
__ull2bfloat16_rna	将uint64类型数据转换为向远离零舍入的bfloat16类型数据。
__ll2float_rn	将int64转换为四舍五入到最接近偶数的浮点数。
__ll2float_rz	将int64转换为向零舍入的浮点数。
__ll2float_rd	将int64向下取整转换为浮点数。
__ll2float_ru	将int转换为向上取整的浮点数。
__ll2float_rna	将int64类型数据转换为向远离零舍入的浮点数。
__ll2half_rn	将int64转换为四舍五入到最接近偶数的half。
__ll2half_rz	将int64转换为向零舍入的half。
__ll2half_rd	将int64向下取整转换为half。
__ll2half_ru	将int64转换为向上取整的half。
__ll2half_rna	将int64类型数据转换为向远离零舍入的half类型数据。
__ll2bfloat16_rn	将int64转换为四舍五入到最接近偶数的bfloat16。
__ll2bfloat16_rz	将int64转换为向零舍入的bfloat16。
__ll2bfloat16_rd	将int64向下取整转换为bfloat16。
__ll2bfloat16_ru	将int转换为向上取整的bfloat16。
__ll2bfloat16_rna	将int64类型数据转换为向远离零舍入的bfloat16类型数据。
__int_as_float	将整数中的位重新解释为浮点数。
__uint_as_float	将无符号整数中的位重新解释为浮点数。
__float_as_int	将浮点数中的位重新解释为有符号整数。
__float_as_uint	将浮点数中的位重新解释为无符号整数。

表 35 向量类型构造函数

接口名	功能描述
make_int2	从两个int类型数据创建int2类型的向量。
make_int3	从三个int类型数据创建int3类型的向量。
make_int4	从四个int类型数据创建int4类型的向量。
make_uint2	从两个unsigned int类型数据创建uint2类型的向量。
make_uint3	从三个unsigned int类型数据创建uint3类型的向量。
make_uint4	从四个unsigned int类型数据创建uint4类型的向量。
make_ulonglong2	从两个unsigned long long int类型数据创建ulonglong2类型的向量。
make_ulonglong3	从三个unsigned long long int类型数据创建ulonglong3类型的向量。
make_ulonglong4	从四个unsigned long long int类型数据创建ulonglong4类型的向量。
make_longlong2	从两个long long int类型数据创建longlong2类型的向量。
make_longlong3	从三个long long int类型数据创建longlong3类型的向量。
make_longlong4	从四个long long int类型数据创建longlong4类型的向量。
make_ulong2	从两个unsigned long int类型数据创建ulong2类型的向量。
make_ulong3	从三个unsigned long int类型数据创建ulong3类型的向量。
make_ulong4	从四个unsigned long int类型数据创建ulong4类型的向量。
make_long2	从两个long int类型数据创建long2类型的向量。
make_long3	从三个long int类型数据创建long3类型的向量。
make_long4	从四个long int类型数据创建long4类型的向量。
make_float2	从两个float类型数据创建float2类型的向量。
make_float3	从三个float类型数据创建float3类型的向量。
make_float4	从四个float类型数据创建float4类型的向量。
make_short2	从两个short类型数据创建short2类型的向量。
make_short3	从三个short类型数据创建short3类型的向量。
make_short4	从四个short类型数据创建short4类型的向量。
make_ushort2	从两个unsigned short类型数据创建ushort2类型的向量。
make_ushort3	从三个unsigned short类型数据创建ushort3类型的向量。
make_ushort4	从四个unsigned short类型数据创建ushort4类型的向量。
make_uchar2	从两个unsigned char类型数据创建uchar2类型的向量。
make_uchar3	从三个unsigned char类型数据创建uchar3类型的向量。
make_uchar4	从四个unsigned char类型数据创建uchar4类型的向量。
make_char2	从两个signed char类型数据创建char2类型的向量。
make_char3	从三个signed char类型数据创建char3类型的向量。
make_char4	从四个signed char类型数据创建char4类型的向量。
make_half2	从两个half类型数据创建half2类型的向量。
make_bfloat162	从两个bfloat16_t类型数据创建bfloat16x2_t类型的向量。

表 36 使能Cache Hints的Load/Store函数

接口名	功能描述
asc_ldcg	从L2 Cache加载缓存的数据，如果缓存命中，则直接返回数据。若未命中，则从 Global Memory地址预加载数据缓存至L2 Cache，并返回数据。
asc_ldca	首先从Data Cache加载缓存数据，若未命中，则尝试从L2 Cache加载。如果Data Cache和L2 Cache中均未找到所需数据，则从Global Memory中读取数据，然后将其缓存到L2 Cache和Data Cache中。
asc_stcg	将指定数据存储到Global Memory的地址address中，并缓存到L2 Cache，但不缓存至Data Cache。
asc_stwt	将指定数据存储到Global Memory的地址address中，并缓存至Data Cache和L2 Cache。

Utils API

表 37 C++标准库API列表

接口名	功能描述
max	比较相同数据类型的两个数中的最大值。
min	比较相同数据类型的两个数中的最小值。
abs	获取输入数据的绝对值。
sqrt	计算输入数据的平方根。
integer_sequence	用于生成一个整数序列。
tuple	允许存储多个不同类型元素的容器。
get	从tuple容器中提取指定位置的元素。
make_tuple	用于便捷地创建tuple对象。
is_convertible	在程序编译时判断两个类型之间是否可以进行隐式转换。
is_base_of	在程序编译时判断一个类型是否为另一个类型的基类。
is_same	在程序编译时判断两个类型是否完全相同。
is_void	在程序编译时，检测一个类型是否为void类型。
is_integral	在程序编译时，检测一个类型是否为整数类型。
is_floating_point	在程序编译时，检测一个类型是否为浮点类型。
is_array	在程序编译时，检测一个类型是否为数组类型。
is_pointer	在程序编译时，判断一个类型是否为指针类型。
is_reference	在程序编译时，检测一个类型是否为引用类型。
is_const	在程序编译时，检测一个类型是否为const限定的类型。
remove_const	在程序编译时，对传入的模板参数类型移除const限定符。
remove_volatile	在程序编译时，对传入的模板参数类型移除volatile限定符。
remove_cv	在程序编译时，对传入的模板参数类型移除const限定符或volatile限定符，或同时移除这两种限定符。
remove_reference	在程序编译时，从给定类型中移除引用限定符。
remove_pointer	在程序编译时，从给定类型中移除指针限定符。
add_const	在程序编译时，为指定类型添加const限定符。
add_volatile	在程序编译时，为指定类型添加volatile限定符。
add_cv	在程序编译时，为指定类型添加const和volatile限定符。
add_pointer	在程序编译时，为指定类型添加指针限定符。
add_lvalue_reference	在程序编译时，为指定类型添加左值引用限定符。
add_rvalue_reference	在程序编译时，为指定类型添加右值引用限定符。
enable_if	在程序编译时根据某个条件启用或禁用特定的函数模板、类模板或模板特化。
conditional	在程序编译时根据一个布尔条件从两个类型中选择一个类型。
integral_constant	用于封装一个编译时常量整数值，是标准库中许多类型特性和编译时计算的基础组件。

表 38 平台信息获取API列表

接口名	功能描述
PlatformAscendC	在实现Host侧的Tiling函数时，可能需要获取一些硬件平台的信息，来支撑Tiling的计算，比如获取硬件平台的核数等信息。PlatformAscendC类提供获取这些平台信息的功能。
PlatformAscendCManager	基于Kernel Launch算子工程，通过基础调用（Kernel Launch）方式调用算子的场景下，可能需要获取硬件平台相关信息，比如获取硬件平台的核数。PlatformAscendCManager类提供获取平台信息的功能。

表 39 Tiling调测API列表

接口名	功能描述
OpTilingRegistry	OpTilingRegistry类属于context_ascendc命名空间，主要用于加载Tiling实现的动态库，并获取算子的Tiling函数指针以进行调试和验证。
ContextBuilder	ContextBuilder类提供一系列的API接口，支持手动构造类来验证Tiling函数以及KernelContext类用于TilingParse函数的验证。

表 40 Tiling模板编程API列表

接口名	功能描述
模板参数定义	通过该类接口进行模板参数ASCENDC_TPL_ARGS_DECL和模板参数组合ASCENDC_TPL_ARGS_SEL（即可使用的模板）的定义。
GET_TPL_TILING_KEY	Tiling模板编程时，开发者通过调用此接口自动生成TilingKey。该接口将传入的模板参数通过定义的位宽，转成二进制，按照顺序组合后转成uint64数值，即TilingKey。
ASCENDC_TPL_SEL_PARAM	Tiling模板编程时，开发者通过调用此接口自动生成并配置TilingKey。

表 41 RTC API列表

接口名	功能描述
aclrtcCompileProg	编译接口，编译指定的程序。
aclrtcCreateProg	通过给定的参数，创建编译程序的实例。
aclrtcDestroyProg	销毁编译程序的实例。
aclrtcGetBinData	获取编译后的二进制数据。
aclrtcGetBinDataSize	获取编译的二进制数据大小。用于在aclrtcGetBinData获取二进制数据时分配对应大小的内存空间。
aclrtcGetCompileLogSize	获取编译日志的大小。用于在aclrtcGetCompileLog获取日志内容时分配对应大小的内存空间。
aclrtcGetCompileLog	获取编译日志的内容，以字符串形式保存。

表 42 log API列表

接口名	功能描述
ASC_CPU_LOG	提供Host侧打印Log的功能。开发者可以在算子的TilingFunc代码中使用ASC_CPU_LOG_XXX接口来输出相关内容。

表 43 调测接口列表

接口名	功能描述
printf	本接口提供SIMT VF调试场景下的格式化输出功能。在算子Kernel侧的SIMT VF实现代码中，需要输出日志信息时，调用printf接口打印相关内容。
assert	本接口在SIMT VF调试场景下提供assert断言功能。在算子Kernel侧的SIMT VF实现代码中，如果assert的内部条件判断不为真，则会输出assert条件，并将输入的信息格式化打印在屏幕上。
__trap	在SIMT VF实现代码中调用此接口会中断算子的运行。

AI CPU API

表 44 AI CPU API列表

接口名	功能描述
printf	该接口提供AI CPU算子Kernel调试场景下的格式化输出功能，默认将输出内容解析并打印在屏幕上。
assert	该接口实现AI CPU算子Kernel调试场景下的assert断言功能。

C API

C API列表