通訊參考
本頁整理自行撰寫韌體時需要的介面約定。產生的範本已經依照這些約定實作,大多數情況可以直接使用範本,不必從頭撰寫。
開發板送往 App 的是一個 JSON 物件,例如 {"temp": 25.4, "hum": 61, "msg": "OK"}。建議把所有數值放在同一則訊息裡送出,比分成多則更有效率。
App 送往開發板的是每次一組 {"key": 值}。值可能是數字、文字或陣列,例如虛擬搖桿送出的 [x, y]。


| 項目 | 值 |
|---|---|
| Service UUID | 6E400001-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 位址連線。
| 方向 | 主題 |
|---|---|
| 開發板送往 App | wizdash/{帳號}/{裝置ID}/data |
| App 送往開發板 | wizdash/{帳號}/{裝置ID}/cmd |
未設定帳號時,主題省略帳號這一段,例如 wizdash/{裝置ID}/data。
OTA 指令
Section titled “OTA 指令”{ "ota": { "url": "https://example.com/firmware.bin", "version": "1.0.0", "size": 123456, "checksum": "sha256:<64 位十六進位>" }}網址必須是 HTTPS,不可包含帳號密碼。檔案大小以位元組計算。checksum 由 App 轉成小寫後送出。開發板以 ota_status 回報處理進度與結果。