Skip to content

Commit bae43ed

Browse files
committed
Merge branch 'docs/update_LiteMesh' into 'master'
docs: update LiteMesh See merge request ae_group/esp-gateway!72
2 parents 4458f08 + bc23e92 commit bae43ed

File tree

3 files changed

+23
-13
lines changed

3 files changed

+23
-13
lines changed

doc/LiteMesh.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,33 @@
22

33
## 1.概述
44

5-
Wi-Fi 路由器以及无线网卡方案均可使能 LiteMesh 功能,该功能主要是为了实现一种简单的 Wi-Fi Mesh 组网,在 SoftAP beacon 包中增加 Vendor IE 信息来表示该结点的信息和状态。
6-
7-
## 2.Vendor IE 信息内容及含义
8-
9-
| | max connect number | station number | router rssi | connect router status | level |
10-
| ---- | ---------------------- | ----------------------------- | ----------- | -------------------------------------- | -------------- |
11-
| 长度 | 1 Byte | 1 Byte | 1 Byte | 1 Byte | 1 Byte |
12-
| 含义 | 本节点允许的最大连接数 | 已连接到本结点的 Station 个数 | 父结点 RSSI | 本结点或父级结点是否已连接到外部路由器 | 本结点所属层级 |
5+
LiteMesh 为简化版的 Wi-Fi mesh 功能,其基于 Wi-Fi 层实现 Mesh 组网,父节点对子节点数据进行透传转发,达到子节点连接互联网的目的。Wi-Fi 路由器以及无线网卡方案,均可使能 LiteMesh 功能。
6+
7+
## 2.LiteMesh 格式定义及含义说明
8+
9+
| 参数名称 | 长度 | 含义 |
10+
| --------------------------------- | ------ | ------------------------------------------------------------ |
11+
| Version | 1 byte | LiteMesh 版本号 |
12+
| Max connect number | 4 bit | 本节点作为 SoftAP 允许连接的最大个数 |
13+
| Connected station number | 4 bit | 本节点作为 SoftAP 已经连接的 Station 个数 |
14+
| Connect router status | 1 bit | 本节点或者父节点是否已经连接到外部路由器 |
15+
| Reserved | 3 bit | 暂未使用 |
16+
| Level | 4 bit | 本节点所属层级 |
17+
| Router SSID len | 1 byte | 路由器 SSID 长度,具体 SSID 信息在 Router SSID 字段 |
18+
| Trace router number | 4 bit | 根节点记录的路由器个数,具体网段信息在 Router network segment list 字段 |
19+
| Extern netif number | 4 bit | 连接外部网络的网络接口个数,具体网段信息在 Extern netif network segment list 字段 |
20+
| Router SSID | m byte | 路由器 SSID |
21+
| Router network segment list | n byte | 记录的路由器 IP 网段列表 |
22+
| Extern netif network segment list | k byte | 连接外部网络的网络接口 IP 网段列表 |
1323

1424
## 3.流程介绍
1525

16-
- ESP 设备上电后会首先进行扫描,如果扫描到有对应 VENDOR_OUI 的 Vendor IE 信息,便会进行记录
17-
- ESP 设备会优先连接到层级最高的且 Station 连接个数未到最大连接数的结点,连接成功后启动 SoftAP
18-
- 若未扫描到对应 VENDOR_OUI 的 Vendor IE 信息,则自己会作为一个根节点并启动 SoftAP,外部设备连接至该热点后可以给该组网配网,使其连接至外部路由器
26+
- ESP 设备上电后会首先进行扫描,如果扫描到有对应 LiteMesh 节点信息,便会自动连接对应的节点;如果未扫描到 LiteMesh 节点信息,则直接连接路由器。
27+
- 当根节点移除后,Level 2 的节点会选择连接到路由器,作为新的根节点
28+
- 当父节点(非根节点)被移除后,对应的子节点会重现选择节点位置,并进行连接
1929

2030
## 4.示例
2131

22-
以下为采用 44 台 ESP32-C3 进行的组网测试
32+
<img src="./_static/LiteMesh_Network_Architecture.png" alt="LiteMesh_Network_Architecture" style="zoom:50%;" />
2333

24-
![vendor_ie](./_static/vendor_ie.png)
34+
<center>ESP-LiteMesh Network Architecture</center>
171 KB
Loading

doc/_static/vendor_ie.png

-82.6 KB
Binary file not shown.

0 commit comments

Comments
 (0)