简介
本项目提供了C++和Python的调用样例，请开发者根据实际情况参考对应实现。
目录说明
├── examples
│ ├── cpp # C++样例
│ ├── python # Python样例
│ ├── third_parties # 对接三方库样例
│ ├── README.md # 样例说明文档
开发样例
| 样例名称 | 样例介绍 | 开发语言 |
|---|---|---|
| cppSamples | C++样例 | C++ |
| pythonSamples | Python样例 | Python |
| thirdPartiesSamples | Hixl对接其他社区样例 | C++/Python |
环境要求
1. 硬件和软件准备
- 芯片：Atlas A3 训练/推理系列产品、Atlas 800I A2 推理产品/A200I A2 Box 异构组件、Ascend 950PR/Ascend 950DT
- 参考 环境准备 完成昇腾AI软件栈在运行环境上的部署
2. Device连通性检查
在执行样例前，请先使用驱动包提供的 hccn_tool工具 检查两个device之间的连通性。以A2场景为例，检查示例如下：
容器环境下，若hccn_tool命令找不到，通常是由于创建容器时没有指定软链接
-v /usr/bin/hccn_tool:/usr/bin/hccn_tool。可通过如下方式解决：在CANN驱动包安装目录下搜索hccn_tool可执行文件(默认路径为
/usr/local/Ascend/driver/tools/hccn_tool)，并通过ln -s /usr/local/Ascend/driver/tools/hccn_tool /usr/bin/hccn_tool手动建立软链。
- step1：查询所需device的ip信息，以8卡为例：
for i in {0..7}; do hccn_tool -i $i -ip -g; done
- step2：检查两个device之间的连通性，以设备a和b连通性检查为例：
# 检查设备a是否能ping通设备b
hccn_tool -i ${device_id_a} -ping -g address ${ip_address_b}
# 检查设备b是否能ping通设备a
hccn_tool -i ${device_id_b} -ping -g address ${ip_address_a}
其中device_id为设备id，可通过npu-smi info查询；ip_address为上一步查询的设备ip地址，如：
hccn_tool -i 0 -ping -g address 10.10.10.1
hccn_tool -i 1 -ping -g address 10.10.10.0
若返回recv time out seq字样，说明两个设备之间不连通，请尝试其他设备。
注意： A3环境为一卡双die架构，两个die共用一个os，即dev-os-0包含了device-0和device-1。
单卡双die之间不互通，如device-0和device-1不通，device-2和device-3不通，以此类推，在A3环境执行样例时，请注意传入的device id是否满足连通要求。
- step3：检查设备之间TLS证书配置的一致性
# 检查设备的TLS状态
for i in {0..7}; do hccn_tool -i $i -tls -g; done | grep switch
打印的结果中 tls switch[0](0:disable, 1:enable) 表示TLS证书使能情况，请确保需要连通的设备的TLS证书配置一致。
TLS使能的设备和TLS不使能的设备无法建链，建议使用如下命令统一保持TLS关闭：
# 关闭TLS证书
for i in {0..7}; do hccn_tool -i $i -tls -s enable 0; done
注意： 如果执行上述命令出现hccn_tool is busy, please try again，请确保没有其他进行并发执行该命令，然后重试。