产品支持情况
产品 |
是否支持 |
|---|---|
Ascend 950PR/Ascend 950DT |
√ |
√ |
|
√ |
|
x |
|
x |
|
x |
|
x |
功能说明
HCCL客户端初始化接口。该接口默认在所有核上工作，用户也可以在调用前通过GetBlockIdx指定其在某一个核上运行。
函数原型
1 | __aicore__ inline void Init(GM_ADDR context, __gm__ void *initTiling = nullptr) |
参数说明
参数名 |
输入/输出 |
描述 |
|---|---|---|
context |
输入 |
通信上下文，包含rankDim，rankID等相关信息。 |
initTiling |
输入 |
可选参数，通信域初始化Mc2InitTiling的地址。Mc2InitTiling在Host侧计算得出，具体请参考表1 Mc2InitTiling参数说明，由框架传递到Kernel函数中使用，完整示例请参考8.13.1.2-调用示例。 |
返回值说明
无
约束说明
- 若调用本接口时传入initTiling参数，则必须与SetCcTiling接口配合使用。
- 同一个程序中不能同时调用传入可选参数initTiling的接口和不传入可选参数initTiling的接口，推荐使用传入initTiling参数的调用方式。
- 若调用本接口时传入initTiling参数，必须使用标准C++语法定义TilingData结构体的开发方式。
- 本接口不支持使用相同的context初始化多个HCCL对象。每个HCCL对象都应获取其自身的通信上下文。