手机设备配网

fastbee2025年5月28日大约 4 分钟

移动端支持多种配网模式。只需要通过简单参数的传入，即可实现在移动端中嵌入配网的功能，简单又方便。

一、配网方式

截止目前，移动端能够支持 Wifi 热点配网（AP 配网）、扫码配网、蓝牙配网、关联设备配网。

二、Wifi 热点配网

Wi-Fi 热点配网也称 AP 配网。其工作原理在于，设备处于热点模式下，手机通过连接设备的热点，使得手机和设备处于同一局域网中，手机把令牌、路由器的 SSID 和密码等信息加密后发给设备，同时从设备那边拿到 MAC 地址，然后发送到云端绑定。

1. 在 SDK 初始化时填写设备端接入的 WIFI 名称和密码，设备进入配网模式，选择"fastbee-device"打头的设备热点。

提示

本示例仅供参考，开发者需理解其实现逻辑。本示例代码适配的是 WeMOS D1 R1（8266WIFI 模块）设备，不同芯片相关的操作可能都存在差异。完整流程可参考快速上手-入门参考。

String randomName="wumei-device"+(String)random(1000);
const char *ap_ssid =randomName.c_str();
const char *ap_password = ""; //开放式网络

char sta_ssid[32] = {0};
char sta_password[64] = {0};
char sta_user_id[32] = {0};

IPAddress local_IP(192, 168, 4, 1);
IPAddress gateway(192, 168, 4, 1);
IPAddress subnet(255, 255, 255, 0);

void initApConfig();

/**
 * AP模式
 */
void initApConfig()
{
  WiFi.mode(WIFI_AP_STA);
  WiFi.softAPConfig(local_IP, gateway, subnet);
  WiFi.softAP(ap_ssid, ap_password);
  printMsg("已启动AP配网，IP地址：" + WiFi.softAPIP().toString()+"， 热点名称："+(String)ap_ssid);
}

2. 打开移动端选择配网添加，填写 Wifi 名称和密码，等待等待设备联网后，开始配网。

3. AP 配网分为单设备和多设备，若需要同时配置多个设备，可以切换到多设备界面，勾选相应的设备进行配网。

三、扫码配网

在管理端生成二维码，移动端通过扫描并识别二维码信息，完成设备绑定。

1. 管理端生成二维码，也可以利用二维码工具批量生成二维码，格式如下

{
    "type":1,  // 扫码关联设备
    "deviceNumber":"53030200001310000001",  // 设备编号
    "productId":147,  // 产品ID
    "productName":"★海康监控产品"  // 产品名称
}

四、蓝牙配网

1. 设备广播 BLE 信号

设备上电后，进入 BLE 广播模式，开始发送广播包（Advertising Packet），让手机 App 能够发现它。
广播包通常包含以下信息：
1. 设备名称（Device Name）（如 BLE_Device_XXXX）
2. 设备 UUID（用于唯一标识设备）（MAC 地址 / SN 号）
3. 设备类型（如智能窗帘电机、Hub）
4. 信号强度（RSSI）
5. 其他厂商自定义字段（可选，比如是否已经配网）

2. App 发现设备并建立连接

APP 打开 BLE 扫描，查找匹配设备

匹配设备，确认设备身份（根据 MAC / SN 号匹配）
选择设备，App 发送连接请求，进入已连接状态
其他
a. 如果无法获取到广播可以选择“手动添加”或者“扫一扫”来进行设备连接
提示
手动添加需要输入蓝牙设备 ID，设备 ID 在 Android 和 IOS 环境下不一样。
b. 扫描添加可以自己定义二维码格式，目前代码中的解析格式为
```
{
    name: "FBDevice",
    deviceId: 'EC3D43A0-4D81-03A3-71FE-DE03D818694A'
}
```
若需要展示其他属性，需要在移动端代码中进行相对于的修改