softbus_tool是OpenHarmony分布式软总线API调用测试工具,文件结构如下图所示。
softbus_tool能够将软总线interfaces目录下的一些常用接口集中起来,供设备间搭建一些场景时使用(比如设备绑定、BR组网,BLE组网, 指定P2P链路传输等)。

softbus_tool一般的使用流程为:
1.使用编译命令生成可执行文件;
2.将生成的可执行文件推送到设备;
3.在hdc shell界面执行,会显示 Softbus Tool Command List命令列表,选择接口前面的序号即可执行相应的接口,有些接口在执行时,需要用户输入参数来实现不同的场景, 这些在下文演示部分做了示例。
下面我们来看一下具体的使用流程。
编译说明
1.将softbus_tool目录代码下载到本地,拷贝到OpenHarmony源码 \foundation\communication\dsoftbus\tools路径 下
2.L2 修改步骤:
在 \foundation 下添加:
修改前为:deps = [ ":SoftBusDumpDeviceInfo" ]
修改后为:deps = [ ":SoftBusDumpDeviceInfo", "softbus_tool:softbus_tool" ]
3.单编softbus_tool编译命令:
RK3568:/build.sh --product-name rk3568 --ccache --build-target softbus
4.编译结果输出路径为:
/out/rk3568/communication/dsoftbus/
使用流程
1.绑定
设备间在组网前,需要绑定,绑定成功才可以进行后续组网,传输功能。
1.启动A,B两端设备,打开设置->WLAN,连接同一WiFi;
2.A端打开计算器,点击右上角“向上→”图标,B端设备上会弹出6位数字的验证图片;
3.在A端输入6位验证码;
4.绑定成功;
2.执行softbus_tool程序
出现如下图,即为执行成功。

3.WiFi组网
确认A,B两端设备均已打开wifi开关,且已连接同一WiFi网络。
- A端执行 0 - PublishService,发布服务。
- B端执行 2 - StartDiscovery,订阅服务。
- B端执行 4 - JoinLNN,组网。



4.WiFi退网
- A端(或B端)执行 6 - GetLocalDeviceInfo,查看本端NetworkId值。
- B端(或A端)执行 5 - LeaveLNN,退网。


5.File传输指定p2p链路
开始传输前,设备间需要WiFi组网成功。
- A端执行14 - CreateSessionServer,创建会话服务。
- B端执行14 - CreateSessionServer,创建会话服务。

- A端(或B端)选择为文件发送端,执行18 - SetFileSendListener, 注册文件发送监听。
- B端(或A端)选择为文件接收端,执行19 - SetFileRecvListener, 注册文件接收监听。


- B端(或A端)执行 6 - GetLocalDeviceInfo,查看本端NetworkId值。

- A端(或B端)执行16 - OpenSession,打开会话。

- A端(或B端)执行23 - SendFile,发送文件。




- A端(或B端)执行17 - CloseSession,关闭会话。

- A端执行15 - RemoveSessionServer,删除会话服务。
- B端执行15 - RemoveSessionServer,删除会话服务。

|