跳到內容
快速入門 產品說明

疑難排解

WizDash 連線與元件疑難排解快速核對圖:涵蓋 BLE 與同區網 WiFi 搜尋、MQTT 主題路徑、JSON Key 大小寫與方案額度
遇到連線、收不到資料或元件沒有反應時,可依此核對圖快速檢查設定。

確認開發板已燒錄 BLE 範本,而且正在執行。確認手機的藍牙已開啟。Android 11 以前的版本,還需要允許位置權限。讓手機靠近開發板,並確認它沒有被另一支手機連著。

確認手機與 ESP32 連在同一個 WiFi 網路。傳統 ESP32 只支援 2.4 GHz 網路。訪客網路或啟用用戶端隔離的路由器,可能會阻擋裝置互相連線。也可以從序列埠監控視窗查到 IP,改用手動輸入。

WizDash 藍牙裝置掃描畫面,列出廣播中的 ESP32 裝置與訊號強度
BLE 掃描排查:確認開發板正在廣播且未被其他手機佔用連線。
WizDash WiFi 區網連線畫面,提供自動搜尋與下方手動輸入 IP 位址
WiFi 掃描排查:若路由器阻擋區網廣播,可直接在下方「手動輸入 IP」填入序列埠顯示的位址與埠號 81。

測試連線只代表手機連得上 broker,請另外確認開發板也連得上。檢查裝置 ID、帳號、TLS 與連接埠,是否和燒錄進開發板的設定完全一致。有設定帳號時,主題路徑會帶上帳號;沒有帳號時,這一段會省略。兩邊只要有一處不同,就無法互通。

WizDash MQTT 連線設定下半部,顯示連接埠 8883、TLS 開關與測試連線成功
核對 Broker 設定:「測試連線成功」僅確認手機連得上 Broker,仍須確認開發板端之帳號、連接埠與 TLS 設定一致。
WizDash 裝置資訊面板,顯示目前已綁定的裝置 ID 與伺服器位址
核對裝置資訊:開啟「裝置資訊」檢查裝置 ID 是否與開發板序列埠印出的 ID 完全相符。

確認 JSON key 與韌體一字不差,大小寫也要相同。確認開發板送出的是完整的 JSON 物件。確認數值型別符合元件需求,例如儀表類元件需要數字,不能是文字。

免費版每個專案最多 10 個功能元件。同一種元件最多 20 個。

WizDash 元件設定對話框,檢查 JSON 鍵值 (co2) 是否與韌體大小寫一致
檢查 JSON Key:雙擊元件開啟設定,確認 JSON 鍵值(區分大小寫)與韌體程式完全一致。
WizDash 新增元件面板,右上角顯示免費版功能元件已用額度
檢查元件額度:開啟新增元件面板時,右上角會即時顯示目前專案已使用的功能元件數量。

確認檔案不超過 2 MB,而且是由 WizDash 匯出的版面配置。功能元件超過 10 個的版面配置,需要完整版才能匯入。

「貼上韌體網址」出現在 MQTT 專案的選單,手機尚未連上時也看得到。送出更新時,手機必須已經連上這個專案的 broker。開發板必須燒錄含 OTA 的範本版本。