Mobile Device Pairing

fastbeeAbout 4 min

移動(dòng)端支持多種配網(wǎng)模式。只需要通過簡單參數(shù)的傳入，即可實(shí)現(xiàn)在移動(dòng)端中嵌入配網(wǎng)的功能，簡單又方便。

一、配網(wǎng)方式

截止目前，移動(dòng)端能夠支持 Wifi 熱點(diǎn)配網(wǎng)（AP 配網(wǎng)）、掃碼配網(wǎng)、藍(lán)牙配網(wǎng)、關(guān)聯(lián)設(shè)備配網(wǎng)。

Wi-Fi 熱點(diǎn)配網(wǎng)也稱 AP 配網(wǎng)。其工作原理在于，設(shè)備處于熱點(diǎn)模式下，手機(jī)通過連接設(shè)備的熱點(diǎn)，使得手機(jī)和設(shè)備處于同一局域網(wǎng)中，手機(jī)把令牌、路由器的 SSID 和密碼等信息加密后發(fā)給設(shè)備，同時(shí)從設(shè)備那邊拿到 MAC 地址，然后發(fā)送到云端綁定。

1. 在 SDK 初始化時(shí)填寫設(shè)備端接入的 WIFI 名稱和密碼，設(shè)備進(jìn)入配網(wǎng)模式，選擇"fastbee-device"打頭的設(shè)備熱點(diǎn)。

Tips

本示例僅供參考，開發(fā)者需理解其實(shí)現(xiàn)邏輯。本示例代碼適配的是 WeMOS D1 R1（8266WIFI 模塊）設(shè)備，不同芯片相關(guān)的操作可能都存在差異。完整流程可參考快速上手-入門參考。

String randomName="wumei-device"+(String)random(1000);
const char *ap_ssid =randomName.c_str();
const char *ap_password = ""; //開放式網(wǎng)絡(luò)

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("已啟動(dòng)AP配網(wǎng)，IP地址：" + WiFi.softAPIP().toString()+"， 熱點(diǎn)名稱："+(String)ap_ssid);
}

{
    "type":1,  // 掃碼關(guān)聯(lián)設(shè)備
    "deviceNumber":"53030200001310000001",  // 設(shè)備編號
    "productId":147,  // 產(chǎn)品ID
    "productName":"★?？当O(jiān)控產(chǎn)品"  // 產(chǎn)品名稱
}

四、藍(lán)牙配網(wǎng)

1. 設(shè)備廣播 BLE 信號

設(shè)備上電后，進(jìn)入 BLE 廣播模式，開始發(fā)送廣播包（Advertising Packet），讓手機(jī) App 能夠發(fā)現(xiàn)它。
廣播包通常包含以下信息：
1. 設(shè)備名稱（Device Name）（如 BLE_Device_XXXX）
2. 設(shè)備 UUID（用于唯一標(biāo)識設(shè)備）（MAC 地址 / SN 號）
3. 設(shè)備類型（如智能窗簾電機(jī)、Hub）
4. 信號強(qiáng)度（RSSI）
5. 其他廠商自定義字段（可選，比如是否已經(jīng)配網(wǎng)）

2. App 發(fā)現(xiàn)設(shè)備并建立連接

APP 打開 BLE 掃描，查找匹配設(shè)備

匹配設(shè)備，確認(rèn)設(shè)備身份（根據(jù) MAC / SN 號匹配）
選擇設(shè)備，App 發(fā)送連接請求，進(jìn)入已連接狀態(tài)
其他
a. 如果無法獲取到廣播可以選擇“手動(dòng)添加”或者“掃一掃”來進(jìn)行設(shè)備連接
Tips
手動(dòng)添加需要輸入藍(lán)牙設(shè)備 ID，設(shè)備 ID 在 Android 和 IOS 環(huán)境下不一樣。
b. 掃描添加可以自己定義二維碼格式，目前代碼中的解析格式為
```
{
    name: "FBDevice",
    deviceId: 'EC3D43A0-4D81-03A3-71FE-DE03D818694A'
}
```
若需要展示其他屬性，需要在移動(dòng)端代碼中進(jìn)行相對于的修改