TPosition

AscendC管理不同层级的物理内存时，用一种抽象的逻辑位置（TPosition）来表达各级别的存储，代替了片上物理存储的概念，达到隐藏硬件架构的目的。主要的TPosition类型包括：VECIN、VECOUT、VECCALC、A1、A2、B1、B2、CO1、CO2，其中VECIN、VECCALC、VECOUT主要用于矢量编程，A1、A2、B1、B2、C1、C2、CO1、CO2用于矩阵编程。开发者可以参考了解TPosition的基础概念，通过通用约束表1了解TPosition和物理存储的映射关系。

TPosition定义如下。

enum class TPosition : uint8_t {
    GM,
    A1,
    A2,
    B1,
    B2,
    C1,
    C2,
    CO1,
    CO2,
    VECIN,
    VECOUT,
    VECCALC,
    LCM = VECCALC,
    SPM,
    SHM = SPM,
    TSCM,
    C2PIPE2GM,
    C2PIPE2LOCAL,
    MAX,
};

TPosition枚举值的具体定义如下。

表1 TPosition枚举值含义说明

枚举值	具体含义
GM	Global Memory，对应AI Core的外部存储。
VECIN	用于矢量计算，搬入数据的存放位置，在数据搬入Vector计算单元时使用此位置。
VECOUT	用于矢量计算，搬出数据的存放位置，在将Vector计算单元结果搬出时使用此位置。
VECCALC	用于矢量计算/矩阵计算，在计算需要临时变量时使用此位置。
A1	用于矩阵计算，存放整块A矩阵，可类比CPU多级缓存中的二级缓存。
B1	用于矩阵计算，存放整块B矩阵，可类比CPU多级缓存中的二级缓存。
C1	用于矩阵计算，存放整块Bias矩阵，可类比CPU多级缓存中的二级缓存。
A2	用于矩阵计算，存放切分后的小块A矩阵，可类比CPU多级缓存中的一级缓存。
B2	用于矩阵计算，存放切分后的小块B矩阵，可类比CPU多级缓存中的一级缓存。
C2	用于矩阵计算，存放切分后的小块Bias矩阵，可类比CPU多级缓存中的一级缓存。
CO1	用于矩阵计算，存放小块结果C矩阵，可理解为Cube Out。
CO2	用于矩阵计算，存放整块结果C矩阵，可理解为Cube Out。
SPM	当Unified Buffer内存有溢出风险时，用于Unified Buffer的数据暂存。
TSCM	Temp Swap Cache Memory, 用于临时把数据交换到额外空间，进行Matmul运算。
C2PIPE2GM	用于存放FIXPIPE量化参数。
C2PIPE2LOCAL	预留参数。为后续的功能做保留，开发者暂时无需关注。