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

通訊參考

本頁整理自行撰寫韌體時需要的介面約定。產生的範本已經依照這些約定實作,大多數情況可以直接使用範本,不必從頭撰寫。

WizDash 與 ESP32 雙向 JSON 通訊與 BLE、同區網 WiFi、自備 MQTT 三種傳輸規格總覽圖
WizDash 手機 App 與 ESP32 韌體之間的雙向 JSON 資料流,以及 BLE、WiFi WebSocket 與 MQTT 三種傳輸介面約定。

開發板送往 App 的是一個 JSON 物件,例如 {"temp": 25.4, "hum": 61, "msg": "OK"}。建議把所有數值放在同一則訊息裡送出,比分成多則更有效率。

App 送往開發板的是每次一組 {"key": 值}。值可能是數字、文字或陣列,例如虛擬搖桿送出的 [x, y]。

WizDash 創客儀表板與序列埠終端機,顯示即時收發的雙向 JSON 封包
App 端的序列埠監控與控制元件:即時呈現開發板回報的 JSON 物件與手機送出的控制指令。
WizDash 完整 Arduino 程式碼檢視視窗,展示 sendData() 組裝 JSON 物件與 onCommand() 解析指令
韌體端的 sendData() 與 onCommand():自動依儀表板元件的 JSON key 產生雙向收發邏輯。
項目值
Service UUID6E400001-B5A3-F393-E0A9-E50E24DCCA9E
App 寫入6E400002-B5A3-F393-E0A9-E50E24DCCA9E
開發板通知6E400003-B5A3-F393-E0A9-E50E24DCCA9E
MTU建議設為 512。預設封包只有 20 bytes,容易截斷 JSON

開發板在埠號 81 提供 WebSocket 服務。App 會透過 mDNS 與 UDP 在區網內尋找裝置,也可以直接以 IP 位址連線。

方向主題
開發板送往 Appwizdash/{帳號}/{裝置ID}/data
App 送往開發板wizdash/{帳號}/{裝置ID}/cmd

未設定帳號時,主題省略帳號這一段,例如 wizdash/{裝置ID}/data。

{
"ota": {
"url": "https://example.com/firmware.bin",
"version": "1.0.0",
"size": 123456,
"checksum": "sha256:<64 位十六進位>"
}
}

網址必須是 HTTPS,不可包含帳號密碼。檔案大小以位元組計算。checksum 由 App 轉成小寫後送出。開發板以 ota_status 回報處理進度與結果。