• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 分布式软总线子系统<a name="ZH-CN_TOPIC_0000001090266209"></a>
2
3-   [简介](#section11660541593)
4-   [系统架构](#section342962219551)
5-   [目录](#section161941989596)
6-   [约束](#section119744591305)
7-   [使用说明](#section1312121216216)
8    -   [进程间通信](#section129654513264)
9    -   [软总线](#section36252592710)
10
11-   [相关仓](#section1371113476307)
12
13## 简介<a name="section11660541593"></a>
14
15分布式软总线子系统旨在为OpenHarmony系统提供的通信相关的能力，包括：WLAN服务能力、蓝牙服务能力、软总线、进程间通信RPC（Remote Procedure Call）等通信能力。
16
17WLAN服务：为用户提供WLAN基础功能、P2P（peer-to-peer）功能和WLAN消息通知的相应服务，让应用可以通过WLAN和其他设备互联互通。
18
19蓝牙服务：为应用提供传统蓝牙以及低功耗蓝牙相关功能和服务。
20
21软总线：为应用和系统提供近场设备间分布式通信的能力，提供不区分通信方式的设备发现，连接，组网和传输功能。
22
23进程间通信：提供不区分设备内或设备间的进程间通信能力。
24
25## 系统架构<a name="section342962219551"></a>
26
27**图 1**  分布式软总线子系统架构图<a name="fig4460722185514"></a>
28
29
30![](figures/zh-cn_image_0000001162307895.png)
31
32## 目录<a name="section161941989596"></a>
33
34分布式软总线子系统主要代码目录结构如下：
35
36```
37/foundation/communication
38├── bluetooth       # 蓝牙功能代码
39├── dsoftbus        # 软总线功能代码
40├── ipc             # 进程间通信代码
41└── wifi            # WLAN功能代码
42```
43
44## 约束<a name="section119744591305"></a>
45
46-   组网限制：必须确保设备在同一个局域网中。
47
48## 使用说明<a name="section1312121216216"></a>
49
50### 进程间通信<a name="section129654513264"></a>
51
52在使用RPC时，请求服务的一端进程可获取提供服务一端所在进程的代理 （Proxy），并通过此代理读写数据来实现进程间的数据通信，其详细过程如下：
53
541.  实现服务端及其提供的能力。
552.  请求服务的一端会建立一个服务提供端的代理对象，这个代理对象具备和服务提供端一样的功能，若想访问服务提供端中的某个方法，只需要访问代理对象中对应的方法即可。
563.  服务提供端处理接收到的请求，处理完之后通过驱动返回处理结果给代理对象。
574.  代理对象将请求结果进一步返回给请求服务端。
58
59### 软总线<a name="section36252592710"></a>
60
61-   组网
62
631.  服务启动之后，获取已经在线的设备列表。
642.  注册上下线监听，通过回调通知感知设备列表变化。
653.  获取设备的Id、设备名称、设备类型。
664.  获取指定设备的设备类型，组网类型，设备能力等更多信息。
675.  进程退出时，删除上下线监听。
68
69-   传输
70
711.  创建会话服务并注册监听回调函数。
722.  待组网设备上线后，建立与指定设备的会话。
733.  若会话获取成功，可发送数据。
744.  待会话不使用时，关闭已打开的会话通道。
755.  业务明确不使用分布式传输（如进程退出）时，移除已创建的会话服务。
76
77## 相关仓<a name="section1371113476307"></a>
78
79**分布式软总线子系统**
80
81[communication\_bluetooth](https://gitee.com/openharmony/communication_bluetooth)
82
83[communication\_dsoftbus](https://gitee.com/openharmony/communication_dsoftbus)
84
85[communication\_ipc](https://gitee.com/openharmony/communication_ipc)
86
87[communication\_wifi](https://gitee.com/openharmony/communication_wifi)
88
89