今天給大家介紹一下小程序配網工具-安信可 IoT，近期剛發布了新的版本，新增了服務器地址配置的功能。這個新功能，給我們帶來了不少便利，特別是 HomeAssistant 固件使用這一塊。

在2024 年 7 月 17 號之前，安信可 IoT 小程序只能提供配網程序，用戶能夠利用藍牙功能給 Wi-Fi 模塊進行無線網絡配置，但是隨著 DIY 作品不斷地更新，為了更加方便地使用固件，涉及 TCP 服務器和 MQTT 服務器地址配置只能通過 AT 指令來實現，在某些應用場合根本無法實現。

所以，這次讓前端工程師加了這個功能，在配網的時候，可以選擇配置服務器地址。

01新功能使用說明

02數據格式

小程序下發的服務器配置數據是以 json 格式下發：

{ "server_type": { "addr":"0.0.0.0", "port":"xxxxx" } }

字段名說明示例server_type服務器類型"tcp"addr服務器地址,支持 IPV4 地址和域名"192.168.1.1"port服務器端口號1883

例如：下發一個TCP 服務器，地址為：192.168.3.1，端口號為：8888，則數據為：

{ "tcp": { "addr":"192.168.3.1", "port":"8888" } }

03數據接收

數據接收就是設備端的了，但是前提是要使用 Blufi 配網功能，在 Ai-WB2 的 SDK（Ai-Thinker-WB2）當中，有 Blufi 的 demo。

因為小程序下發的數據是通過 Blufi 的custom data（自定義數據）接口下發，在 blufo demo 當中

的AXK_BLUFI_EVENT_RECV_CUSTOM_DATA事件，可以看到下發的服務器地址數據：

04數據解析

既然是 json 數據，那只要引用 cJSON.h 頭文件，就能實現對服務器地址和端口號的解析，下面寫了函數，大家做個參考

解析服務器地址

static char data_buff[128] = { 0 }; char* get_ip_addr_from_custom_data(const char* server_type, const char* custom_data) { if (custom_data==NULL) { blog_error("custom_data is NULL"); return NULL; } char* cjson_root = custom_data; cJSON* root = cJSON_Parse(cjson_root); if (root==NULL) { blog_error("%s is't json data", cjson_root); cJSON_Delete(root); return NULL; } cJSON* add_type = cJSON_GetObjectItem(root, server_type); if (add_type==NULL) { blog_error("%s not "%s" project ", cjson_root,server_type); cJSON_Delete(root); return NULL; } cJSON* addr = cJSON_GetObjectItem(add_type, "addr"); if (addr==NULL) { blog_error("%s not "addr" project ", cjson_root); cJSON_Delete(root); return NULL; } memset(data_buff, 0, 128); strcpy(data_buff, addr->valuestring); cJSON_Delete(root); return data_buff; }

調用示例：

char* addr=get_ip_addr_from_custom_data("tcp",custom_data); printf("addr=%srn",addr);

解析端口號

uint16_t get_port_from_custom_data(const char* server_type, const char* custom_data) { if (custom_data==NULL) { blog_error("custom_data is NULL"); return NULL; } char* cjson_root = custom_data; cJSON* root = cJSON_Parse(cjson_root); if (root==NULL) { blog_error("%s is't json data", cjson_root); cJSON_Delete(root); return NULL; } cJSON* add_type = cJSON_GetObjectItem(root, server_type); if (add_type==NULL) { blog_error("%s not "%s" project ", cjson_root,server_type); cJSON_Delete(root); return NULL; } cJSON* port_p = cJSON_GetObjectItem(add_type, "port"); if (port_p==NULL) { blog_error("%s not "port" project ", cjson_root); cJSON_Delete(root); return NULL; } uint16_t port = atoi(port_p->valuestring); cJSON_Delete(root); return port; }

調用示例：

uint16_t port=get_port_from_custom_data("tcp",custom_data); printf("port=%drn",port);

這些程序流程我就不解釋，太簡單了，不懂的話，自己去學一下 cjson 的數據解析。

審核編輯 黃宇