PRELOAD

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持

• Atlas 训练系列产品：不支持

• Atlas 推理系列产品 AI Core：支持

• Atlas 推理系列产品 Vector Core：不支持

• Atlas 200I/500 A2 推理产品：不支持

功能说明

头文件路径为："utils/base/sys_macros.h"。

从当前指令所在的GM地址开始，将后续指令预加载到ICache中。

函数原型

#define PRELOAD(len)

参数说明

表 1 参数说明

参数名	输入/输出	描述
len	输入	预取长度。

针对如下型号：

• Ascend 950PR/Ascend 950DT

• Atlas A3 训练系列产品/Atlas A3 推理系列产品

• Atlas A2 训练系列产品/Atlas A2 推理系列产品

len的单位为2K Byte，取值应小于ICache大小除以2K。其中，AIC和AIV的ICache大小分别为32KB和16KB。

• 针对Atlas 推理系列产品 AI Core，len不控制预取长度，预取长度固定为128Byte。

返回值说明

无

约束说明

仅支持在Kernel侧调用。

调用示例

// 从当前指令地址开始预加载4个单位的指令。
PRELOAD(4);