概述

AliOS Things 3.3提供ble_netconfig組件，用BLE功能傳遞配置信息，包括Wi-Fi配網需要的SSID和密碼信息，連接阿里云需要的設備證書（ProductKey、DeviceName、DeviceSecret）信息。

功能支持

ble_netconfig組件主要支持如下功能：

• 開啟和關閉BLE配置通道功能

• 在BLE配置通道上傳遞消息給手機支付寶小程序功能

目錄結構

|-- ble_netconfig.c          #BLE網絡配置核心代碼
|-- ble_netconfig.h          #BLE網絡配置頭文件
|-- example                  #BLE網絡配置實例
|    |-- netcfg_example.c
|-- package.yaml             #makefile
|-- README.md                #README文檔

依賴組件

• osal_aos

• ble_host

• netmgr

常用配置

無

API說明

BLE_NETCFG_STATE BLE_NetCfg_init(BLE_netCfg_callck callback)

BLE_NETCFG_STATE BLE_NetCfg_start(void)

BLE_NETCFG_STATE BLE_NetCfg_stop(void)

BLE_NETCFG_STATE BLE_NetCfg_notificate(const uint8_t *data, uint16_t size)

BLE_NETCFG_STATE BLE_NetCfg_wifi_get(char **ssid, char **passwd)

BLE_NETCFG_STATE BLE_NetCfg_wifi_set(char *ssid, char *passwd)

BLE_NETCFG_STATE BLE_NetCfg_devinfo_get(char **pk, char **dn, char **ds)

BLE_NETCFG_STATE BLE_NetCfg_devinfo_set(char *pk, char *dn, char *ds)

使用示例

組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具，所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》，下載安裝。 待開發環境搭建完成后，可以按照以下步驟進行示例的測試。

步驟1 創建或打開工程

打開已有工程

如果用于測試的案例工程已存在，可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。

創建新的工程

組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例（solution）來運行，這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。

步驟2 添加組件

案例下載完成后，需要在helloworld_demo組件的package.yaml中添加對組件的依賴：

depends:
  - ble_netconfig: dev_aos

步驟3 下載組件

在已安裝了的開發環境工具欄中，選擇Terminal -> New Terminal啟動終端，并且默認工作路徑為當前工程的workspace，此時在終端命令行中輸入：

aos install ble_netconfig

上述命令執行成功后，組件源碼則被下載到了./components/ble_netconfig路徑中。

步驟4 添加示例

ble_netconfig組件的package.yaml中添加示例代碼

source_file:
  - ble_netconfig.c
  - example/netcfg_example.c

步驟5 編譯固件

在示例代碼已經添加至組件的配置文件，并且helloworld_demo已添加了對該組件的依賴后，就可以編譯helloworld_demo案例來生成固件了，具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。

步驟6 燒錄固件

helloworld_demo案例的固件生成后，可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。

步驟7 打開串口

固件燒錄完成后，可以通過串口查看示例的運行結果，打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。

當串口終端打開成功后，可在串口中輸入help來查看已添加的測試命令。

步驟8 測試示例

CLI命令行輸入：netcfg_example

案例工具

• 串口工具

• 支付寶HaaS小程序

打開支付寶，搜索"HaaS小程序"進入小程序操作界面

多個待配網設備

當存在多個待配網設備時，在小程序界面點擊“選擇設備”，會彈出設備選擇列表。在列表中選擇待配網設備。

在CLI命令行輸入以下命令，可以查看設備名稱和藍牙地址

(ash)# ble_netCfg name
netconfig device name HaaS-0000004333c5
BT address 6c-33-33-22-11-11

netconfig device name和小程序待配網設備列表是對應的。

這里要注意藍牙地址BT address一定要不一樣。如果藍牙地址一樣，則小程序待配網列表只會出現一個設備。此時說明該開發板藍牙地址沒有燒錄，需要手動燒錄藍牙地址。

aos_mac WIFI xx:xx:xx:xx:xx:xx
aos_mac BT xx:xx:xx:xx:xx:xx

設置成功后，輸入ble_netCfg name確認藍牙地址設置成功。重啟設備，小程序待配網設備列表會出現多臺設備。