OpenHarmony 4.0 分布式软总线解析：设备发现与传输

OpenHarmony 的分布式软总线子系统为 OpenHarmony 系统提供的通信相关的能力，包括：WLAN 服务能力、蓝牙服务能力、软总线、进程间通信 RPC（Remote Procedure Call）等通信能力。下面我们通过阅读 OpenHarmony 4.0 的源码，来解读一下 OpenHarmony 软总线当前的一个实现情况。

Android小贾

2646人浏览 · 2024-04-10 22:34:45

Android小贾 · 2024-04-10 22:34:45 发布

OpenHarmony 的分布式软总线子系统为 OpenHarmony 系统提供的通信相关的能力，包括：WLAN 服务能力、蓝牙服务能力、软总线、进程间通信 RPC（Remote Procedure Call）等通信能力。

其中主要包括：

WLAN 服务：为用户提供 WLAN 基础功能、P2P（peer-to-peer）功能和 WLAN 消息通知的相应服务，让应用可以通过 WLAN 和其他设备互联互通。
蓝牙服务：为应用提供传统蓝牙以及低功耗蓝牙相关功能和服务。
软总线：为应用和系统提供近场设备间分布式通信的能力，提供不区分通信方式的设备发现，连接，组网和传输功能。
进程间通信：提供不区分设备内或设备间的进程间通信能力。

下面我们通过阅读 OpenHarmony 4.0 的源码，来解读一下 OpenHarmony 软总线当前的一个实现情况。

设备发现与传输模块

代码框架分析

分布式软总线组件主要代码目录结构如下：/foundation/communication/dsoftbus

├── adapter                # 操作系统适配层代码
├── core                   # 核心代码
│   ├── common          # 通用代码
│   ├── authentication      # 设备认证机制和设备知识库管理代码
│   ├── bus_center         # 组网代码
│   ├── connection         # 连接代码
│   ├── discovery          # 基于coap协议的设备发现代码
│   ├── transmission        # 传输代码
│   └── frame              # 框架代码
├── sdk                     # 运行业务进程代码
│   ├── bus_center          # 组网代码
│   ├── discovery           # 发现代码
│   ├── transmission         # 传输代码
│   └── frame               # 框架代码
└── components               # 依赖组件代码

其中 interfaces 是提高给外接的接口，比较重要。

softbus_bus_center.h： 声明软总线组网的函数和常量。函数可用于执行以下操作：在 LNN 中添加设备和从 LNN 中删除设备，监听在线设备、离线和信息更改事件。

重要函数说明：

JoinLNN: 此函数将当前设备加入指定设备所在的 LNN。
JoinMetaNode: 此函数将当前设备加入指定设备所在的 MetaNode。
LeaveLNN: 此函数将当前设备从 LNN 中移除。
LeaveMetaNode: 此函数将当前设备从 MetaNode 中移除。
RegNodeDeviceStateCb: 此函数注册设备状态更改的回调。
PubLNN: 此函数在 LNN 上发布服务。
SubLNN: 此函数在 LNN 上订阅服务。

softbus_common.h： 它定义了一些用于通信和服务管理的常量和结构体，例如：网络 ID 长度等常量。

ConnectionAddr 结构体定义了设备在 LNN（Logical Network）中的地址信息。它包括地址类型、连接地址和 peerUid 字段。地址类型指示了地址的类型，例如 WLAN、BR 或 BLE。连接地址包含设备的 MAC 地址、UDID 哈希值或 IP 地址。peerUid 字段是设备的 account hash code。
DiscoverMode 枚举定义了服务发布的模式。它包括被动模式（PASSIVE）和主动模式（ACTIVE）。被动模式表示设备等待其他设备发现它。主动模式表示设备主动搜索其他设备。
ExchangeMedium 枚举定义了服务发布的介质。它包括自动选择（AUTO）、BLE、WLAN、USB 和 HiLink。AUTO 表示所有可用的介质都会被调用。
ExchangeFreq 枚举定义了服务发布的频率。它包括低频（LOW）、中频（MID）、高频（HIGH）和超高频（SUPER_HIGH）。
DataBitMap 枚举定义了设备支持的功能。它包括 MeeTime、Profile Capability、HomevisionPic Capability、CastPlus、AA Capability、DVKIT Capability、DDMP Capability、Osd Capability 和 Share Capability。
PublishInfo 结构体定义了服务发布的信息。它包括服务 ID、发布模式、发布介质、发布频率、发布能力、能力数据、最大能力数据长度和是否主动范围。
SubscribeInfo 结构体定义了服务订阅的信息。它包括服务 ID、订阅模式、订阅介质、订阅频率、相同账户、唤醒远程设备、订阅能力、能力数据和最大能力数据长度。
ModeCycle 枚举定义了单个心跳周期参数。它包括高频周期（HIGH_FREQ_CYCLE）、中频周期（MID_FREQ_CYCLE）和低频周期（LOW_FREQ_CYCLE）。
ModeDuration 枚举定义了心跳保持活跃参数的持续时间。它包括默认持续时间（DEFAULT_DURATION）、正常持续时间（NORMAL_DURATION）和长持续时间（LONG_DURATION）。
DeviceType 枚举定义了设备类型。它包括智能音箱（SMART_SPEAKER）、PC、笔记本电脑（LAPTOP）、智能手机（SMART_PHONE）、平板电脑（SMART_PAD）、智能手表（SMART_WATCH）、智能汽车（SMART_CAR）、儿童手表（CHILDREN_WATCH）和智能电视（SMART_TV）。
DeviceInfo 结构体定义了设备信息。它包括设备 ID、帐户哈希码、设备类型、设备名称、在线状态、可用连接数、连接信息、能力位图数组、自定义数据和距离。
InnerDeviceInfoAddtions 结构体定义了内部使用的设备附加信息。它包括发现设备的介质。