MQTT 即時儀表板:學習地圖
這一頁是「MQTT 即時儀表板」系列的學習地圖。它不取代文章,而是幫你在開始前看清全貌:這個系列會帶你走到哪裡、每一篇要做出什麼、怎麼確認自己過關了,以及卡關時該回頭看哪一篇。
系列一句話
用免費的 HiveMQ Cloud 當 Broker,讓 ESP32 即時發布溫濕度、接收遠端指令,並做出單一 HTML 檔的網頁儀表板,最後補強連線安全與離線偵測。
共 6 篇 實作時間約 5 個多小時 硬體沿用系列一(ESP32 加 DHT11)
用免費的 HiveMQ Cloud 當 Broker,讓 ESP32 即時發布溫濕度、接收遠端指令,並做出單一 HTML 檔的網頁儀表板,最後補強連線安全與離線偵測。
共 6 篇 實作時間約 5 個多小時 硬體沿用系列一(ESP32 加 DHT11)
一、出發前:先確認你的起點
系列二建立在系列一的基礎上。對照下表,確認每一項你都做得到;做不到的,先回頭看對應的文章。
| 你需要會 | 怎麼確認 | 做不到的話 |
|---|---|---|
| 上傳程式到 ESP32 | 能讓內建 LED 閃爍 | 系列一 第 01 篇 |
| 讀取 DHT11 溫濕度 | 序列埠能看到數值 | 系列一 第 02 篇 |
| 讓 ESP32 連上 WiFi | 序列埠顯示 IP 位址 | 系列一 第 03 篇 |
| NTP 對時(建議) | 序列埠能印出正確的現在時間 | 系列一 第 05 篇(系列二第 02 篇起會用到時間戳記) |
另外需要:一個瀏覽器、一個能存成 UTF-8 的文字編輯器,以及願意註冊 HiveMQ Cloud 免費帳號(第 01 篇會帶你做)。
二、學習地圖:四個階段
六篇文章分成四個階段,每個階段結束時,你的專案都會多出一項能力。
三、逐篇導覽
每一篇都列出:你會做出什麼、大約要花多久、怎麼確認過關,以及最容易卡關的地方。
階段 1 第 01 篇:認識 MQTT 並建立雲端 Broker
難度:入門 時間:約 40 分鐘 硬體:不需要
你會做出:一個 HiveMQ Cloud 免費叢集、一組連線帳號,並用網頁客戶端完成第一次收發訊息。
過關檢查:在 Web Client 訂閱
容易卡關:Web Client 連不上(帳密或網路擋 WebSocket)、忘記記下叢集網址。
難度:入門 時間:約 40 分鐘 硬體:不需要
你會做出:一個 HiveMQ Cloud 免費叢集、一組連線帳號,並用網頁客戶端完成第一次收發訊息。
過關檢查:在 Web Client 訂閱
iot/esp32-01/#,發布一則 hello 到 iot/esp32-01/test,自己收得到。容易卡關:Web Client 連不上(帳密或網路擋 WebSocket)、忘記記下叢集網址。
階段 2 第 02 篇:讓 ESP32 發布溫濕度
難度:中等 時間:約 45 分鐘 硬體:ESP32、DHT11
你會做出:ESP32 用加密連線接上 Broker,每 5 秒把溫濕度組成 JSON 發布到
過關檢查:Web Client 每 5 秒收到一則
容易卡關:連線狀態碼 -2、4、5;Client ID 重複造成不停斷線。
難度:中等 時間:約 45 分鐘 硬體:ESP32、DHT11
你會做出:ESP32 用加密連線接上 Broker,每 5 秒把溫濕度組成 JSON 發布到
iot/esp32-01/telemetry,斷線會自動重連。過關檢查:Web Client 每 5 秒收到一則
{"temp":…,"hum":…,"ts":…};暫時關掉路由器再打開,資料會自己恢復。容易卡關:連線狀態碼 -2、4、5;Client ID 重複造成不停斷線。
階段 2 第 03 篇:訂閱、除錯與保留訊息
難度:入門到中等 時間:約 40 分鐘 硬體:ESP32、DHT11(只改一行程式)
你會做出:學會「三步除錯法」,並讓資料啟用 Retained,新連線的訂閱者一連上就拿到最新值。
過關檢查:把 Web Client 斷線再重連並訂閱,不用等下一次更新就立刻看到最近一筆資料。
容易卡關:舊的保留訊息清不掉、被過期資料誤導。
難度:入門到中等 時間:約 40 分鐘 硬體:ESP32、DHT11(只改一行程式)
你會做出:學會「三步除錯法」,並讓資料啟用 Retained,新連線的訂閱者一連上就拿到最新值。
過關檢查:把 Web Client 斷線再重連並訂閱,不用等下一次更新就立刻看到最近一筆資料。
容易卡關:舊的保留訊息清不掉、被過期資料誤導。
階段 3 第 04 篇:讓 ESP32 接收指令,遠端控制 LED
難度:中等 時間:約 50 分鐘 硬體:ESP32、DHT11、內建 LED
你會做出:ESP32 訂閱
過關檢查:發布
容易卡關:斷線重連後沒有重新訂閱、LED 腳位或亮滅邏輯不同、誤把指令加上 Retain。
難度:中等 時間:約 50 分鐘 硬體:ESP32、DHT11、內建 LED
你會做出:ESP32 訂閱
cmd/led 接收指令,並把實際狀態回報到 state/led。過關檢查:發布
on,LED 亮且 state/led 變成 on;斷線重連後再發指令仍然有效。容易卡關:斷線重連後沒有重新訂閱、LED 腳位或亮滅邏輯不同、誤把指令加上 Retain。
階段 3 第 05 篇:用 HTML 與 JavaScript 做即時網頁儀表板
難度:中等 時間:約 60 分鐘 硬體:ESP32、DHT11、內建 LED
你會做出:單一 HTML 檔的儀表板:即時溫濕度、趨勢圖、資料過期警示,以及控制 LED 的按鈕,Broker 密碼不寫死在網頁裡。
過關檢查:資料每 5 秒更新;按按鈕能控制 LED;拔掉 ESP32 電源約 30 秒後,畫面顯示資料已過期。
容易卡關:連線網址(需用
難度:中等 時間:約 60 分鐘 硬體:ESP32、DHT11、內建 LED
你會做出:單一 HTML 檔的儀表板:即時溫濕度、趨勢圖、資料過期警示,以及控制 LED 的按鈕,Broker 密碼不寫死在網頁裡。
過關檢查:資料每 5 秒更新;按按鈕能控制 LED;拔掉 ESP32 電源約 30 秒後,畫面顯示資料已過期。
容易卡關:連線網址(需用
wss://、埠號 8884、路徑 /mqtt)、CDN 載入失敗、帳號密碼錯誤。
階段 4 第 06 篇:連線安全與斷線偵測
難度:中等到進階 時間:約 75 分鐘 硬體:ESP32、DHT11、內建 LED
你會做出:三組權限分離的帳號、ESP32 驗證伺服器根憑證,以及用 LWT 遺囑訊息偵測上線與離線;儀表板升級成顯示裝置狀態,並加入唯讀模式。
過關檢查:唯讀帳號無法控制 LED;拔掉電源約 20 到 30 秒後,儀表板顯示離線;故意用錯誤憑證,ESP32 會連線失敗而不是照常連上。
容易卡關:根憑證貼上不完整、ESP32 尚未對時就驗證憑證、權限變更需要一點時間才生效。
難度:中等到進階 時間:約 75 分鐘 硬體:ESP32、DHT11、內建 LED
你會做出:三組權限分離的帳號、ESP32 驗證伺服器根憑證,以及用 LWT 遺囑訊息偵測上線與離線;儀表板升級成顯示裝置狀態,並加入唯讀模式。
過關檢查:唯讀帳號無法控制 LED;拔掉電源約 20 到 30 秒後,儀表板顯示離線;故意用錯誤憑證,ESP32 會連線失敗而不是照常連上。
容易卡關:根憑證貼上不完整、ESP32 尚未對時就驗證憑證、權限變更需要一點時間才生效。
四、卡關時,該看哪一篇?
依症狀找到對應的段落,比從頭重讀更有效率:
| 症狀 | 先看 |
|---|---|
| ESP32 連不上 Broker(狀態碼 -2、4、5) | 第 02 篇「連線狀態碼對照」 |
| 連上後不停斷線、又重連 | 第 02 篇與第 03 篇:Client ID 重複 |
| 明明有發布,卻收不到訊息 | 第 03 篇「三步除錯法」 |
| 看到的是很舊的資料 | 第 03 篇「過期資料」與「清除保留訊息」 |
| 按了控制,ESP32 沒有反應 | 第 04 篇「常見問題」 |
| 斷線重連後就收不到指令 | 第 04 篇:每次連線後都要重新訂閱 |
| 重新啟動後 LED 自己亮起來 | 第 04 篇:指令不要加 Retained |
| 儀表板連不上或沒有資料 | 第 05 篇「常見問題」 |
| 一直顯示「資料已過期」 | 第 05 篇:確認 ESP32 有對時、電腦時間正確 |
| 換成憑證驗證後連不上 | 第 06 篇「常見問題」:憑證完整性與對時 |
| 裝置狀態沒有跳成離線 | 第 06 篇:LWT 偵測需要 20 到 30 秒 |
| WiFi 或 DHT11 本身的問題 | 系列一的第 03 篇與第 02 篇 |
五、系列全貌:架構與主題
走完整個系列,你會得到下面這套架構。裝置與儀表板彼此不直接連線,都只跟 Broker 溝通:
主題一覽
| 主題(前綴 iot/esp32-01/) | 誰發布 | 內容 | Retained | 首次出現 |
|---|---|---|---|---|
telemetry |
ESP32 | 溫濕度 JSON(含時間戳記) | 是(第 03 篇起) | 第 02 篇 |
cmd/led |
儀表板 | on、off、toggle |
否 | 第 04 篇 |
state/led |
ESP32 | on 或 off(實際狀態) |
是 | 第 04 篇 |
status |
ESP32 與 Broker(LWT) | online 或 offline |
是 | 第 06 篇 |
設計原則:指令與狀態分開(儀表板顯示的是裝置真實的狀態,不是你送出的指令),以及指令不保留、狀態可保留。
六、MQTT 名詞對照表
系列中會反覆出現這些詞,忘記時回來查:
| 名詞 | 白話說明 | 哪一篇 |
|---|---|---|
| Broker | 訊息中繼站,像郵局,所有裝置只跟它連線 | 01 |
| Client | 連到 Broker 的任何東西:ESP32、網頁、手機 | 01 |
| Topic(主題) | 訊息的頻道,用斜線分層,如 iot/esp32-01/telemetry | 01 |
| Publish/Subscribe | 發布訊息/訂閱想收的主題 | 01 |
萬用字元 + # | + 代表一層,# 代表後面所有層,只用於訂閱 | 01 |
| Payload | 訊息的內容,可以是文字、數字或 JSON | 01、02 |
| TLS | 加密連線,保護傳輸內容;也能驗證對方身分 | 02、06 |
| Client ID | 每條連線的名字,不可重複,否則會互相踢下線 | 02、03 |
| Retained(保留訊息) | Broker 記住主題的最後一則,新訂閱者立刻拿到 | 03 |
| QoS | 送達保證等級:0 最多一次、1 至少一次、2 剛好一次 | 01、03、04 |
| 回呼函式(Callback) | 收到訂閱的訊息時,自動被呼叫的處理函式 | 04 |
| WebSocket(wss) | 讓瀏覽器能連上 Broker 的連線方式,加密版本是 wss | 05 |
| 最小權限 | 每個帳號只拿到它需要的權限,外洩時傷害有限 | 06 |
| 根憑證 | 用來驗證伺服器身分的憑證,ESP32 要內建一份 | 06 |
| LWT(遺囑訊息) | 裝置意外斷線時,由 Broker 代為發布的預設訊息 | 06 |
七、走完之後
完成六篇、通過每個階段的檢查後,你的專案已經具備:即時資料、雙向控制、網頁儀表板,以及基本的權限與離線偵測。可以接著往這些方向發展:
- 擴充裝置:增加第二台 ESP32,為它建立獨立的帳號與主題,讓儀表板切換顯示。
- 擴充感測器:在 JSON 中加入新的欄位,並更新儀表板。
- 資料落地:把 MQTT 的資料存進資料庫或試算表,銜接系列一的圖表與 PySpark 分析。
- 互動升級:結合 LINE Bot,用對話查詢與控制裝置(系列三構想中)。
相關頁面
準備好了嗎?從第 01 篇開始 →
留言
張貼留言