HCCL Tiling使用说明

说明

本章节详述通信算子必需的TilingData结构体。本章节提供了三个版本的TilingData，建议使用TilingData结构体，不推荐使用v1版本TilingData（废弃）和v2版本TilingData（废弃）。 对于TilingData结构体，在定义通算融合算子的Tiling结构体时，Mc2InitTiling必须定义为算子Tiling结构体的第一个参数，Mc2CcTiling对于在算子Tiling结构体中被定义的位置没有要求。

Ascend C提供一组HCCL Tiling API，方便用户获取HCCL Kernel计算时所需的Tiling参数。您只需要传入通信的相关信息，调用API接口，即可获取通信相关的Tiling参数。

HCCL Tiling API获取Tiling参数的流程如下：

1. 创建一个Mc2CcTilingConfig类对象。

   Text

   const char* groupName = "testGroup";
   uint32_t opType = HCCL_CMD_REDUCE_SCATTER;
   std::string algConfig = "ReduceScatter=level0:fullmesh";
   uint32_t reduceType = HCCL_REDUCE_SUM;
   AscendC::Mc2CcTilingConfig mc2CcTilingConfig(groupName, opType, algConfig, reduceType);
   

2. 通过配置接口设置通信信息（可选）。

   Text

   mc2CcTilingConfig.SetSkipLocalRankCopy(0);
   mc2CcTilingConfig.SetSkipBufferWindowCopy(1);
   

   可调用的配置接口列于下表。

   表1 Mc2CcTilingConfig类对象的配置接口列表

   接口	功能
   SetOpType	设置通信任务类型。
   SetGroupName	设置通信任务所在的通信域。
   SetAlgConfig	设置通信算法。
   SetReduceType	设置Reduce操作类型。
   SetStepSize	设置细粒度通信时，通信算法的步长。
   SetSkipLocalRankCopy	设置本卡的通信算法的计算结果是否输出到recvBuf。
   SetSkipBufferWindowCopy	设置通信算法获取输入数据的位置。
   SetDebugMode	设置调测模式。

3. 调用GetTiling接口，获取Tiling信息。

   Text

   mc2CcTilingConfig.GetTiling(tiling->mc2InitTiling); // tiling为算子组装的TilingData结构体
   mc2CcTilingConfig.GetTiling(tiling->reduceScatterTiling);