PC 可视化演示工具(Gravitation)

测试环境

AP 和 PC 通过网络连接,Gravitation 运行于 PC 上,如下图所示:

../../../_images/rmesh_demo_tool_connection.svg

Wi-Fi R-Mesh 测试环境

概述

Gravitation 可以用于显示所有接入 AP 的 R-Mesh 节点及其拓扑结构,其主要特点如下:

  • 及时显示网络拓扑及其改变

  • 可以做 ping 测试

../../../_images/rmesh_demo_tool.png

Gravitation 工具界面

每个节点会显示 MAC_Addr:IP(更新时间)。比如: CE:192.168.1.100(5:6) 代表 MAC 地址为 XX:XX:XX:XX:0xCE,IP 地址为 192.168.1.100。节点之间的连线上显示的两个红色数字表示当前父节点的得分以及最优候选节点的得分,该得分是以信号强度为基础计算得到的。

Gravitation 和 R-Mesh 节点之间是通过 socket 进行通信的,节点定期将自己的 IP 地址、父节点 MAC 地址等信息通过 socket 发给 Gravitation 所在的 PC,Gravitation 解析后显示拓扑的实时情况。

用户可以参考此设计重新开发自己的应用,用于获取并显示 R-Mesh 网络的拓扑情况。

使用指南

Gravitation 工具位于: {sdk}/tools/R-Mesh_Demo_Tool.

使用步骤如下:

  1. 将 AP 和 PC 通过网络连接,执行 gravitation.exe

  2. 打开 gravitation 文件夹下的文件 config.yaml,配置所要测试的 AP MAC 地址。

    ap_mac_list:
    
    - 00:11:22:33:44:55
    

    备注

    配置建议:

    1. 使用 AT+WLSCAN 或 AT+WLCONN 可以方便的获知 AP 的 MAC 地址。

    2. 可以同时配置多个 AP 的 MAC 地址

    3. 其他信息如 AP SSID 等按需配置,不配置也不会影响使用

  3. 配置 ping 间隔和 ping 包长度(不配置则使用默认参数)。

    ping:
    interval: 500
    packet_size: 64
    

其中,ping 间隔也可以通过 Gravitation 界面直接配置。

此时,Gravitation 配置完成。关闭 Gravitation 并重新运行 gravitation.exe,所有配置即刻生效。

  1. 参考 Wi-Fi R-Mesh 使用指南 建立一个 R-Mesh 网络。节点信息会自动上传到 Gravitation, 可以在 Gravitation 观察到每个节点的连接状况及网络拓扑。

  2. 若需手动拖动节点来自行布局,请取消勾选界面右下角的 自动布局 选项。因为 Gravitation 默认采用自动布局的方式,默认情况下可以拖动 AP,但是无法拖动 R-Mesh 节点。

  3. Gravitation 默认采用自动显示信息的方式,每个节点的部分信息会自动显示在节点的右上角,可以通过取消勾选界面右下角的 显示信息 选项来取消信息的自动显示。

    此模式下,当点击某一个节点时,会在该节点的右上方显示完整的 MAC 地址和 IP 地址,同时还会显示一个扫描清单,记录该节点所扫描到的周围节点的 MAC 地址最后一个字节、信号强度等信息。

    ../../../_images/rmesh_demo_manual_display.png

    手动显示信息