在使用機智云APP進行一鍵配網時，常見的失敗原因之一是WiFi頻段不匹配。許多機智云入門設備（如ESP8266）僅支持2.4GHz的WiFi，而如果連接的是5GHz WiFi，配網就無法成功。判斷WiFi頻段的方法很簡單：查看手機WiFi名稱，若含有“5G”字樣，則為5GHz頻段。解決辦法是切換到2.4GHz WiFi，通常可以通過另一臺手機開啟2.4GHz模式的熱點來實現。

PART.01設備程序問題問題

檢查設備的代碼是不是正確的，可以從以下幾個方面入手：

代碼里有沒有設置wifi模式？如相關代碼gizwitsSetMode(WIFI_AIRLINK_MODE);

代碼里有沒有開啟定時器中斷、串口中斷？如相關代碼 HAL_TIM_Base_Start_IT();HAL_UART_Receive_IT();

代碼里有沒有機智云初始化的調用？如相關代碼gizwitsInit();

PART.02硬件設備的問題

WiFi模塊接線是否正確？對應端口不能接錯

WiFi模塊是需要燒錄機智云的固件才可以使用機智云的SDK聯網的，機智云固件可以去機智云官網下載中心下載

如果排查了以上問題均找不出原因的話，可以使用熱點配網來解決，可以先試試熱點配網。

熱點配網沒問題再回頭去試試一鍵配網，以下介紹熱點配網以及詳細步驟。

熱點配網介紹：

熱點配網（也叫AP 配網），是機智云設備的一種備用配網方式

PART.03熱點配網和一鍵配網的區別

一鍵配網

你（手機）→ 把 WiFi 密碼告訴路由器 → 路由器再傳給設備（容易因為信號差、頻段錯出現問題）；

熱點配網

你（手機）→ 直接走到設備身邊 “貼耳說話” → 把 WiFi 密碼直接告訴設備（干擾少，不容易出現問題）。

專業點介紹

熱點配網本質是設備端啟動 （軟件接入點）模式，構建本地無線局域網，移動端（手機/ 平板）作為 Station 接入該局域網后，通過 TCP/UDP 協議向設備端透傳目標 WiFi 網絡參數（SSID、Password），最終設備端切換至 Station 模式接入目標網絡并完成云端鑒權的技術流程。

快速入門配網可以看這期教程

《快速入門手把手》機智云上云（STM32 HAL篇）上篇

以下熱點配網詳細流程：

1、連接好硬件設備之后，我們修改一下代碼里面。把WiFi配網設置模式改為熱點配網（SoftAP模式）

main函數中添加代碼：

gizwitsSetMode(WIFI_SOFTAP_MODE); //設置配網模式

2、重新編譯燒錄代碼之后，打開機制云APP，開始AP熱點配網

首先、這里我用一部手機來打開機智云來配網，然后另一部手機打開2.4G熱點給第一步手機連接。

把這個熱點的自動連接關閉

接下來打開打開機智云APP后，直接跳過登錄界面。

添加設備

這里選擇熱點配網

這里會自動填好當前連接的熱點和密碼，下面是后面需要連接的，這里我們默認即可。

這里選擇樂鑫然后給板子斷電，點擊按鈕后再供電。

點擊跳轉到wifi界面

這里選擇這個開頭的wifi，輸入剛剛的默認密碼123456789

然后返回機智云APP，可以看到正在連接中了

連接成功，如果這里顯示連接超時的話，就大退機智云APP，清除后臺重新進。

這個時候就配網成功了，可以正常顯示數據和控制了