---
title: HCCL Tiling使用说明
description: "本章节详述通信算子必需的TilingData结构体。本章节提供了三个版本的TilingData，建议使用TilingData结构体，不推荐使用v1版本TilingData（废弃）和v2版本TilingData（废弃）。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_0887.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0887.html
indexId: 964ead677bf4ec4acb1900aee70954871278f0ab2aa8f167e30bf9369b27aa6f76
---
# HCCL Tiling使用说明

本章节详述通信算子必需的TilingData结构体。本章节提供了三个版本的TilingData，建议使用TilingData结构体，不推荐使用v1版本TilingData（废弃）和v2版本TilingData（废弃）。

对于TilingData结构体，在定义通算融合算子的Tiling结构体时，Mc2InitTiling必须定义为算子Tiling结构体的第一个参数，Mc2CcTiling对于在算子Tiling结构体中被定义的位置没有要求。


根据使用标准C++语法定义Tiling结构体(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/Ascendcopdevg/atlas_ascendc_10_00024.html)的方式，Ascend C提供一组HCCL Tiling API，方便用户获取HCCL Kernel计算时所需的Tiling参数。您只需要传入通信的相关信息，调用API接口，即可获取通信相关的Tiling参数。

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

1. 创建一个  Mc2CcTilingConfig
类对象。
  1 2 3 4 5 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. 通过配置接口设置通信信息（可选）。
  1 2 mc2CcTilingConfig.SetSkipLocalRankCopy(0); mc2CcTilingConfig.SetSkipBufferWindowCopy(1);

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

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

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


3. 调用  GetTiling
接口，获取Tiling信息。
  1 2 mc2CcTilingConfig.GetTiling(tiling->mc2InitTiling); // tiling为算子组装的TilingData结构体 mc2CcTilingConfig.GetTiling(tiling->reduceScatterTiling);