ReadGmByPassDCache(ISASI)

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	x
Atlas 推理系列产品AI Core	x
Atlas 推理系列产品Vector Core	x
Atlas 训练系列产品	x

功能说明

头文件路径为："basic_api/kernel_operator_scalar_intf.h"。

不经过DCache从GM地址上读数据。使用场景：

• 当多个核写入的数据落在同一条Cache Line内时，经过DCache的读写将以64B为粒度，可能引发多核数据随机覆盖问题（参考DataCacheCleanAndInvalid调用示例3）。使用该接口不经过DCache直接按操作数大小读GM，可避免此问题。
• 经过DCache写GM时可能导致多核间的数据不一致问题（详细原因请参考Cache写策略与Cache一致性问题），使用该接口不经过DCache直接向GM写数据，可避免此问题。

函数原型

template <typename T>
__aicore__ inline T ReadGmByPassDCache(__gm__ T* addr)

参数说明

表 1 模板参数说明

参数名	描述
T	操作数的数据类型。

表 2 接口参数说明

参数名	输入/输出	含义
addr	输入	源GM地址。

数据类型

支持的数据类型为int8_t、uint8_t、int16_t、uint16_t、int32_t、uint32_t、int64_t、uint64_t。

返回值说明

源GM地址上的数据。

约束说明

标量单元连续读取相同GM地址时，会长期占用总线（Bus），导致其他核无法向该地址写入数据，进而引发系统卡死。在此场景下，建议在标量读指令后插入若干空操作指令（Nop）释放总线，插入Nop指令的数量可按"需同步的核数×200"估算（如4个核时建议插入800条）。

调用示例

__gm__ int32_t *addr = const_cast<__gm__ int32_t *>(srcGlobal.GetPhyAddr());
int32_t value = AscendC::ReadGmByPassDCache<int32_t>(addr);

// 通过Scalar读写相同GM时，需要让读操作，空出总线，避免长时占用。
int target = -1;
while (target != 0) {
     target = ReadGmByPassDCache(addr);
     Nop<800>();
}

完整样例请参考GmByPassDCache类样例。