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

連線方式

每個專案的連線分兩步完成。「連線設定」決定使用哪一種傳輸,以及要寫進範本的參數;「綁定裝置」則記住手機要連接的是哪一塊開發板。變更連線方式時,原本的綁定會解除,避免手機連到不相符的裝置。

WizDash 連線設定畫面,提供 BLE、同區網 WiFi 與自備 MQTT 選項及連接埠 8883 TLS 設定
步驟一「連線設定」:選擇 BLE、WiFi 或 MQTT 並填寫寫入韌體範本的參數。
WizDash 裝置資訊面板,顯示已綁定的連線模式、裝置名稱、裝置 ID、伺服器位址與解除綁定按鈕
步驟二「綁定裝置/裝置資訊」:查看目前已綁定的開發板識別資訊或解除綁定。

BLE 適合手機就在開發板附近的情境。

設定時,裝置名稱可以留空。綁定時,App 會搜尋附近正在廣播的裝置,選定後記住它的藍牙識別碼。已綁定的裝置可在專案選單的「裝置資訊」查看或解除綁定。連線中斷時,只要 App 仍在執行,就會自動嘗試重新連線。

編譯 BLE 範本前,Arduino IDE 需要安裝 NimBLE-Arduino 與 ArduinoJson(v7 以上),詳見必要安裝的函式庫。

WizDash BLE 連線設定畫面,選擇 Bluetooth LE 近端連線並填寫選填的裝置顯示名稱
BLE 連線設定:選擇 Bluetooth LE 近端連線,不需透過路由器即可與開發板直連。
WizDash 藍牙裝置掃描畫面,列出附近廣播中的 ESP32 開發板、MAC 位址與 RSSI 訊號格數
BLE 綁定裝置:燒錄並開機後,點選「開始掃描」即可從清單點選開發板完成綁定。

WiFi 模式下,手機與 ESP32 必須位於同一區網。

設定時填入 ESP32 要加入的 WiFi 名稱與密碼。這些資訊會寫入產生的範本,讓開發板開機後自行連上網路。綁定時可以自動搜尋區網內的裝置、從已知裝置中選擇,或直接輸入 IP 位址。開發板的 IP 若有變動,重新自動搜尋即可。

這種連線只在區域網路內有效。手機連上網際網路,並不代表能連到位於其他網路的開發板。

編譯 WiFi 範本前,Arduino IDE 需要安裝 WebSockets(Markus Sattler)與 ArduinoJson(v7 以上),詳見必要安裝的函式庫。

WizDash WiFi 連線設定畫面,填寫要寫入韌體範本的 2.4 GHz WiFi 名稱 (SSID) 與密碼
WiFi 連線設定:填入 ESP32 要加入的 2.4 GHz WiFi 名稱與密碼,供產生韌體範本使用。
WizDash WiFi 區網連線綁定畫面,包含已知裝置、自動搜尋 (mDNS / UDP) 結果清單與手動輸入 IP 位址
WiFi 綁定裝置:支援區網自動搜尋(mDNS/UDP)、從已知裝置快取點選,或手動輸入 IP 與埠號 81。

MQTT 模式使用你自備的 broker。WizDash 不提供 broker 服務。

需要填寫的項目:

  • 裝置 ID。燒錄後可在序列埠監控視窗中看到,請填回專案設定。
  • Broker 位址。區網 IP 或主機名稱皆可。
  • 連接埠。啟用 TLS 時預設 8883,未啟用時預設 1883,也可以自行修改。
  • 帳號與密碼。如果 broker 需要驗證才填。
  • ESP32 要加入的 WiFi。開發板必須先能上網,才連得到 broker。

「測試連線」只確認手機此刻能否連上 broker,不會完成綁定,也不代表開發板一定連得上。修改任何欄位後,先前的測試結果就不再有效。

遠端操作需要三方的網路都能互通。broker 若架設在家中區網,人在外面時通常無法使用,除非你自行讓手機與開發板都能從外部連到這台 broker。

只有 MQTT 專案提供 OTA 韌體更新,詳見OTA 韌體更新。

編譯 MQTT 範本前,Arduino IDE 需要安裝 PubSubClient 與 ArduinoJson(v7 以上),詳見必要安裝的函式庫。

WizDash MQTT 連線設定上半部,填寫裝置 ID 與 ESP32 連網所需的 WiFi SSID
MQTT 設定(上):填寫與韌體一致的裝置 ID,以及供 ESP32 連網的 WiFi 資訊。
WizDash MQTT 連線設定下半部,顯示 Broker 位址、連接埠 8883、TLS 加密開關與綠色「測試連線成功」提示
MQTT 設定(下):設定自備 Broker 位址、連接埠與 TLS 開關,點選「測試連線」確認手機可連通 Broker。