GlobalTensor
============

#### 功能说明

GlobalTensor用来存放Global Memory（外部存储）的全局数据。

#### 定义原型

template <typename T> class GlobalTensor : public BaseGlobalTensor<T> {
public:
    using PrimType = PrimT<T>;
    \_\_aicore\_\_ inline GlobalTensor<T>() {}
    \_\_aicore\_\_ inline void SetGlobalBuffer(\_\_gm\_\_ PrimType\* buffer, uint64\_t bufferSize); // 传入全局数据的指针，并手动设置一个buffer size，初始化GlobalTensor
    \_\_aicore\_\_ inline void SetGlobalBuffer(\_\_gm\_\_ PrimType\* buffer); // 传入全局数据的指针，初始化GlobalTensor,可以不传入buffer size,但此时使用GetSize获取的长度是随机值
    \_\_aicore\_\_ inline const \_\_gm\_\_ PrimType\* GetPhyAddr() const; // 返回全局数据的地址
    \_\_aicore\_\_ inline \_\_gm\_\_ PrimType\* GetPhyAddr(const uint64\_t offset) const; // 返回全局数据(指定偏移offset个元素)的地址
    \_\_aicore\_\_ inline \_\_inout\_pipe\_\_(S) PrimType GetValue(const uint64\_t offset) const; // 获取Tensor的相应偏移位置的值
    \_\_aicore\_\_ inline \_\_inout\_pipe\_\_(S) \_\_gm\_\_ PrimType& operator()(const uint64\_t offset) const; // 返回某个index位置的元素的引用
    \_\_aicore\_\_ inline void SetValue(const uint64\_t offset, PrimType value); // 设置Tensor相应偏移位置的值。
    \_\_aicore\_\_ inline uint64\_t GetSize() const; // 返回Tensor中的element个数
    \_\_aicore\_\_ inline GlobalTensor operator\[\](const uint64\_t offset) const; // 指定偏移返回一个GlobalTensor，offset单位为element
    \_\_aicore\_\_ inline void SetShapeInfo(const ShapeInfo& shapeInfo);
    \_\_aicore\_\_ inline ShapeInfo GetShapeInfo() const;
    template<CacheRwMode rwMode = CacheRwMode::RW> 
    \_\_aicore\_\_ inline void SetL2CacheHint(CacheMode mode); // 设置Tensor写入L2 Cache的模式（允许/禁止）
    // ...
};

#### 函数说明

类型T支持基础数据类型，但需要遵循使用此GlobalTensor的指令的数据类型支持情况。

**表1** 函数说明

| 函数名称 | 入参说明 | 含义 |
| :-- | :-- | :-- |
| GetValue | offset：偏移量，单位为element | 获取GlobalTensor中的某个值，返回T类型的立即数。 |
| SetGlobalBuffer | 
buffer：主机侧传入的全局数据指针

bufferSize：所包含的类型为T的数据个数，单位为element，需自行保证不会超出实际数据的长度

 | 设置GlobalTensor的存储位置：buffer指向外部存储的起始地址，bufferSize为Tensor所占外部存储的大小，如指向的外部存储有连续256个int32\_t，则其bufferSize为256。 |
| GetPhyAddr | \- | 返回GlobalTensor的地址，如果传入offset，则表示偏移offset个元素。 |
| GetSize | \- | 返回GlobalTensor的element个数。 |
| operator\[\] | offset：开发者指定的偏移位置 | 根据输入的offset偏移返回新的Tensor，offset的单位为element的个数。 |
| operator() | index: 下标索引 | 获取本GlobalTensor的第index个变量的引用。与[LocalTensor](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cannkit-localtensor)的operator()类似。 |
| SetShapeInfo | shapeInfo：ShapeInfo结构体 | 设置GlobalTensor的shapeInfo。 |
| GetShapeInfo | 无 | 

获取GlobalTensor的shapeInfo。

**说明：** Shape信息没有默认值，只有通过SetShapeInfo设置过Shape信息后，才可以调用该接口获取正确的ShapeInfo。

 |

#### 调用示例

void Init(\_\_gm\_\_ uint8\_t \*src\_gm, \_\_gm\_\_ uint8\_t \*dst\_gm)
{
    uint64\_t dataSize = 256; // 设置input\_global的大小为256
 
    AscendC::GlobalTensor<int32\_t> inputGlobal; // 类型为int32\_t
    inputGlobal.SetGlobalBuffer(reinterpret\_cast<\_\_gm\_\_ int32\_t \*>(src\_gm), dataSize); // 设置源操作数在Global Memory上的起始地址为src\_gm，所占外部存储的大小为256个int32\_t
 
    AscendC::LocalTensor<int32\_t> inputLocal = inQueueX.AllocTensor<int32\_t>();
    AscendC::DataCopy(inputLocal, inputGlobal, dataSize); // 将Global Memory上的inputGlobal拷贝到Local Memory的inputLocal上
    // ...
}