ble_cfg_wifi 配网 App

ble cfg wifi ble_cfg_wifi cfg_wifi

ble_cfg_wifi — Android 手机配网 App，通过 BLE 连接开发板上的 WS73（SDIO BLE/WiFi/SLE 三合一模组），向 Hi3516CV610 开发板下发 2.4G WiFi 凭据（SSID / 密码）完成配网，面向无屏设备的网络初始化场景。

工具获取与安装

App 位于项目 tools/ble_cfg_wifi/ 目录：

tools/ble_cfg_wifi/app-release.apk

将 app-release.apk 安装到 Android 手机（需允许安装未知来源应用）。

前提条件

• 本说明以 cv610_ev_board 单板烧录 ble_wifi 案例镜像为例（构建命令：bash scripts/build.sh build --target cv610_ev_board samples ble_wifi，烧录见 BurnTool）；其他板型（如 cv610_lampbot_board、cv610_qinuo_pico_board）的 ble_wifi 案例板端脚本路径一致，操作步骤相同。

• 开发板已加载 WS73 驱动并启动 BLE 配网服务：

  # 1. 启动 wpa_supplicant（WS73 驱动由开机脚本 S99ws73 自动加载）
  sh /root/start_wifi.sh &
  # 2. 启动配网服务（后台启动 BLE GATT Server，等待手机配网）
  sh /root/ble_wifi_prov.sh &
  

• 手机开启蓝牙，且开发板在 BLE 覆盖范围内

• 一个 2.4G WiFi 热点（WS73 不支持 5G）

操作指南

1. 手机打开配网 App，开启蓝牙

   

2. 点击 重新扫描，可以在筛选框中输入 Ble 筛选出该设备

   

3. 扫描并选中名为 Ble-Wifi 的设备, 点击 进入配网 连接 Ble-Wifi

   

4. 配对蓝牙（仅首次配对该蓝牙需要），点击 配对 连接 Ble-Wifi的蓝牙

   

5. 填入 WiFi SSID 和密码，点击 配网

   

6. 设备状态显示连接成功后退出配网 App，配网结束

配网状态通过 BLE 以 JSON 形式回传手机，可区分密码错误、SSID 不可达、超时等失败原因。

相关文档

文档	说明
ble_wifi 参考案例	BLE 配网完整案例说明