MQTT 即時儀表板:學習地圖

這一頁是「MQTT 即時儀表板」系列的學習地圖。它不取代文章,而是幫你在開始前看清全貌:這個系列會帶你走到哪裡、每一篇要做出什麼、怎麼確認自己過關了,以及卡關時該回頭看哪一篇。

系列一句話
用免費的 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 篇會帶你做)。

二、學習地圖:四個階段

六篇文章分成四個階段,每個階段結束時,你的專案都會多出一項能力。

MQTT 即時儀表板的四個學習階段 1 階段 1 認識與準備 第 01 篇 觀念、建立 Broker 2 階段 2 讓資料流動 第 02–03 篇 發布、訂閱、除錯 3 階段 3 雙向與畫面 第 04–05 篇 遠端控制、儀表板 4 階段 4 安全與可靠 第 06 篇 權限、憑證、離線偵測 建議依序進行,每個階段都有過關檢查

三、逐篇導覽

每一篇都列出:你會做出什麼、大約要花多久、怎麼確認過關,以及最容易卡關的地方。

階段 1 第 01 篇:認識 MQTT 並建立雲端 Broker
難度:入門 時間:約 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 發布到 iot/esp32-01/telemetry,斷線會自動重連。
過關檢查:Web Client 每 5 秒收到一則 {"temp":…,"hum":…,"ts":…};暫時關掉路由器再打開,資料會自己恢復。
容易卡關:連線狀態碼 -2、4、5;Client ID 重複造成不停斷線。
階段 2 第 03 篇:訂閱、除錯與保留訊息
難度:入門到中等 時間:約 40 分鐘 硬體:ESP32、DHT11(只改一行程式)
你會做出:學會「三步除錯法」,並讓資料啟用 Retained,新連線的訂閱者一連上就拿到最新值。
過關檢查:把 Web Client 斷線再重連並訂閱,不用等下一次更新就立刻看到最近一筆資料。
容易卡關:舊的保留訊息清不掉、被過期資料誤導。
階段 3 第 04 篇:讓 ESP32 接收指令,遠端控制 LED
難度:中等 時間:約 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 秒後,畫面顯示資料已過期。
容易卡關:連線網址(需用 wss://、埠號 8884、路徑 /mqtt)、CDN 載入失敗、帳號密碼錯誤。
階段 4 第 06 篇:連線安全與斷線偵測
難度:中等到進階 時間:約 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 溝通:

MQTT 即時儀表板的整體架構 ESP32 DHT11、LED device 帳號 Broker HiveMQ Cloud 儀表板 viewer/operator 帳號 資料、狀態 資料、狀態 指令 指令 綠色:由 ESP32 發布,儀表板訂閱 紅色:由儀表板發布,ESP32 訂閱

主題一覽

主題(前綴 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/telemetry01
Publish/Subscribe發布訊息/訂閱想收的主題01
萬用字元 + #+ 代表一層,# 代表後面所有層,只用於訂閱01
Payload訊息的內容,可以是文字、數字或 JSON01、02
TLS加密連線,保護傳輸內容;也能驗證對方身分02、06
Client ID每條連線的名字,不可重複,否則會互相踢下線02、03
Retained(保留訊息)Broker 記住主題的最後一則,新訂閱者立刻拿到03
QoS送達保證等級:0 最多一次、1 至少一次、2 剛好一次01、03、04
回呼函式(Callback)收到訂閱的訊息時,自動被呼叫的處理函式04
WebSocket(wss)讓瀏覽器能連上 Broker 的連線方式,加密版本是 wss05
最小權限每個帳號只拿到它需要的權限,外洩時傷害有限06
根憑證用來驗證伺服器身分的憑證,ESP32 要內建一份06
LWT(遺囑訊息)裝置意外斷線時,由 Broker 代為發布的預設訊息06

七、走完之後

完成六篇、通過每個階段的檢查後,你的專案已經具備:即時資料、雙向控制、網頁儀表板,以及基本的權限與離線偵測。可以接著往這些方向發展:

  • 擴充裝置:增加第二台 ESP32,為它建立獨立的帳號與主題,讓儀表板切換顯示。
  • 擴充感測器:在 JSON 中加入新的欄位,並更新儀表板。
  • 資料落地:把 MQTT 的資料存進資料庫或試算表,銜接系列一的圖表與 PySpark 分析。
  • 互動升級:結合 LINE Bot,用對話查詢與控制裝置(系列三構想中)。

相關頁面


準備好了嗎?從第 01 篇開始 →

留言

熱門文章