CANN/hcomm 通道状态查询

HcommChannelGetStatus

【免费下载链接】hcommHCOMM（Huawei Communication）是HCCL的通信基础库，提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm

产品支持情况

• Ascend 950PR/Ascend 950DT：支持
• Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
• Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持

功能说明

该接口用于查询通信通道的状态，支持批量查询多个通道的连接状态，用于在通道创建后、通信操作前确认通道是否已就绪。

该接口采用轮询机制，调用方需要持续调用直到所有通道都返回READY状态。

该接口主要用于通道连接建立阶段的同步等待。

函数原型

HcommResult HcommChannelGetStatus(const ChannelHandle *channelList, uint32_t listNum, int32_t *statusList);

参数说明

返回值

HcommResult：接口成功返回0，其他失败。

约束说明

• channelList数组长度需要与listNum 参数一致。
• statusList[i]与channelList[i]一一对应，表示第i个通道的状态。
• 支持的通信协议包括：RoCE、UBC_TP、UBC_CTP、UBoE。

调用示例

uint32_t channelNum = 50; std::vector<ChannelHandle> channels(channelNum); // 参考 HcommChannelCreate 进行 Channel 创建 ... uint32_t timeOut = 0; while (timeOut < 1000) { CHK_RET(HcommChannelGetStatus(channels, channelNum, statuses)); result = 0; for (int i = 0; i < channelNum; i++) { result |= statuses[i]; } if (result == 0) {break;} timeOut += 10; } // 通道就绪，执行通信操作 // ...

【免费下载链接】hcommHCOMM（Huawei Communication）是HCCL的通信基础库，提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm