多裝置與多感測器 01:從單一裝置到多裝置的架構規劃
這是「多裝置與多感測器」系列的第 1 篇。系列二結束時,我們有一台 ESP32 把 DHT11 的資料即時送到儀表板。接下來要把它擴大:多加幾種感測器,再多加一台 ESP32。 但在動手接線之前,先做一件比較不起眼、卻最重要的事:規劃架構。因為裝置從一台變成兩台、三台,原本「寫死」的地方會一個接一個出問題。本篇不需要接任何硬體。
・看清楚從一台擴充到多台時,會爆掉的四個地方
・規劃本系列的裝置配置、命名規則與主題結構
・設計可長期擴充的 JSON 欄位規則
・完成帳號權限的準備工作
難度:入門 預估時間:30 分鐘 本篇不需要接硬體
想先看全貌?可以先看系列三學習地圖,了解六篇的分階段、各篇過關檢查與卡關索引,再回來一篇一篇做。
一、一台的時候很簡單,兩台就開始出問題
回頭看系列二的程式,有幾個地方在單一裝置時沒問題,但擴充時都會變成麻煩:
| 現況 | 擴充時的問題 | 本系列的解法 |
|---|---|---|
| 裝置 ID、帳密都寫在程式裡 | 每多一台就要複製一份程式再手動改,改漏一個就出事 | 設定獨立成檔案,一份程式給所有裝置用(第 03 篇) |
| 程式假設一定有 DHT11 | 不同裝置掛的感測器不同,沒接感測器的裝置會一直報錯 | 開機時偵測有哪些感測器,只發布有的欄位(第 03 篇) |
儀表板只看 esp32-01 |
看第二台要重新輸入、重新連線,也無法一眼比較 | 用萬用字元訂閱所有裝置,並做裝置清單(第 05 篇) |
帳號權限限定在 iot/esp32-01/# |
儀表板帳號看不到其他裝置 | 調整權限範圍,並替每台裝置建立獨立帳號(本篇與第 04 篇) |
二、本系列的硬體配置
你手上有兩片 ESP32、一顆 BME280、一顆 BH1750 與一個 OLED。每種感測器只有一個,所以我們這樣分配:
| 裝置 | 感測器與元件 | 目的 |
|---|---|---|
esp32-01 |
DHT11、BME280 | 兩種感測器量同一個環境,可以直接比較準確度;並認識 I2C(第 02 篇) |
esp32-02 |
BH1750、OLED | 不同的感測器組合,以及不靠網頁、直接在裝置上顯示數據(第 04 篇) |
I2C 位址要注意
BME280、BH1750 和 OLED 都是 I2C 裝置,共用兩條線(SDA 與 SCL),靠「位址」區分彼此。常見的預設位址如下,但不同廠牌的模組可能不同,第 02 篇會教你用掃描程式實際確認:
- BME280:常見是
0x76或0x77 - BH1750:常見是
0x23,也可能是0x5C - SSD1306 OLED:常見是
0x3C,也可能是0x3D
因為我們把它們分在兩台裝置上,位址不會互相衝突。一般的 ESP32 開發板,I2C 預設腳位是 GPIO 21(SDA)與 GPIO 22(SCL),但不同開發板可能有差異,請以你手上的腳位圖為準。
三、裝置命名規則
- 只用小寫英文、數字與連字號,例如
esp32-01、esp32-02。 - 名稱要穩定不改。主題、帳號、保留訊息都綁著裝置名稱,一改名,舊名稱留下的保留訊息會變成「幽靈資料」,必須逐一清除。
- 名稱只負責「辨識」,不要塞太多意義。位置、用途這類會變動的資訊,放進裝置的自我介紹(下一節的
info主題)。
本系列沿用已經在用的 esp32-01,新的一台叫 esp32-02,不需要改名。
四、擴充後的主題結構
我們在系列二的四個主題之外,新增一個 info,讓每台裝置連線時自我介紹:我是誰、在哪裡、有哪些感測器、韌體版本。這樣儀表板就能自動發現新裝置,不需要手動設定清單。
| 主題 | 誰發布 | 內容 | Retained |
|---|---|---|---|
iot/<id>/telemetry |
裝置 | 感測資料 JSON | 是 |
iot/<id>/status |
裝置與 Broker(LWT) | online 或 offline |
是 |
iot/<id>/info(新) |
裝置 | 自我介紹 JSON | 是 |
iot/<id>/cmd/led |
儀表板 | on、off、toggle |
否 |
iot/<id>/state/led |
裝置 | on 或 off |
是 |
其中 <id> 代表裝置名稱。有了統一的結構,儀表板可以用萬用字元一次訂閱所有裝置:
iot/+/telemetry 所有裝置的感測資料 iot/+/status 所有裝置的上下線狀態 iot/+/info 所有裝置的自我介紹 iot/+/state/led 所有裝置的 LED 狀態
回想第 1 篇學的:+ 代表「一層」,所以 iot/+/telemetry 會收到每一台裝置的 telemetry,裝置名稱就在主題的第二層裡,程式可以用它來區分資料是誰送的。
info 長什麼樣子
以 esp32-02 為例(第 03 篇會實際實作):
{
"name": "書桌光照站",
"location": "書房",
"sensors": ["bh1750"],
"fw": "1.0.0"
}
名稱、位置這類會變的資訊放這裡,而不是放在裝置 ID 或主題裡。要改位置,只要改 info 重新發布,不會動到其他東西。
五、感測資料的 JSON 欄位規則
多種感測器、多台裝置,資料欄位最容易亂。我們先訂下規則:
| 欄位 | 意義 | 單位 | 哪些裝置會有 |
|---|---|---|---|
temp | 溫度 | °C | esp32-01 |
hum | 相對濕度 | % | esp32-01 |
pressure | 氣壓 | hPa | esp32-01(BME280) |
lux | 光照強度 | lx | esp32-02(BH1750) |
rssi | WiFi 訊號強度 | dBm | 所有裝置 |
uptime | 開機後經過的時間 | 秒 | 所有裝置 |
ts | 時間戳記(Epoch) | 秒 | 所有裝置 |
三條規則:
- 只增不改。已經在用的欄位,不要改名字、不要改單位。要加新資訊,就新增欄位。這樣舊的儀表板與程式永遠不會壞掉。
- 欄位是選用的。裝置有哪個感測器,就發布哪些欄位。
esp32-02沒有 DHT11,它的資料裡就不會有temp,接收端必須能處理「欄位不存在」。 - 每個意義只用一個名字。溫度就叫
temp,不要在不同裝置裡出現temperature、t、Temp。
兩個例子:
// iot/esp32-01/telemetry
{"temp":26.5,"hum":58.0,"pressure":1012.3,"rssi":-61,"uptime":3600,"ts":1790000000}
// iot/esp32-02/telemetry
{"lux":320.5,"rssi":-67,"uptime":1800,"ts":1790000000}
兩個例子的數值都是示意。第 02 篇會處理 esp32-01 上 DHT11 與 BME280 同時存在時,欄位怎麼取捨。
六、帳號與權限規劃
系列二第 06 篇,我們為儀表板建立了 dashboard-viewer(只能訂閱)與 dashboard-operator(可發布也可訂閱),權限範圍都限定在 iot/esp32-01/#。現在儀表板要看全部裝置,所以範圍要放寬到整個 iot/。裝置則反過來:每台裝置只能碰自己的主題。
| 帳號 | 權限類型 | 主題過濾條件 | 說明 |
|---|---|---|---|
esp32-01-device |
發布與訂閱 | iot/esp32-01/# |
已存在,不用改 |
esp32-02-device(新) |
發布與訂閱 | iot/esp32-02/# |
給第二台裝置專用 |
dashboard-viewer |
只能訂閱 | iot/#(由 iot/esp32-01/# 放寬) |
看全部裝置 |
dashboard-operator |
發布與訂閱 | iot/#(由 iot/esp32-01/# 放寬) |
看全部、並能控制任何一台 |
現在就做的準備工作
操作的畫面與欄位,請參考系列二第 06 篇,這裡只列步驟:
- 進入 HiveMQ Cloud 叢集的 Access Management。
- 新增一個權限,名稱例如
iot-all-ro,主題過濾條件iot/#,類型「Subscribe Only」。 - 新增另一個權限,名稱例如
iot-all-rw,主題過濾條件iot/#,類型「Publish and Subscribe」。 - 把
dashboard-viewer的權限改成iot-all-ro,dashboard-operator改成iot-all-rw。如果現有的憑證無法直接換權限,就刪除後重新建立。 - 新增一個權限
esp32-02-rw(過濾條件iot/esp32-02/#,Publish and Subscribe),並建立憑證esp32-02-device套用它。密碼請設定一組全新的強密碼並記下來,第 04 篇會用到。
權限有快取,改完後可能要等幾分鐘才生效。另外,免費方案對憑證與權限的數量上限,請以主控台實際顯示的為準,若建立時遇到限制,可以把不用的舊憑證刪除。
驗證權限
- 用 Web Client,以
dashboard-viewer連線,訂閱iot/#,應該能收到esp32-01的資料。 - 用
dashboard-viewer試著發布一則訊息到任何主題,應該不會被接受(Broker 可能直接忽略,也可能中斷連線)。 esp32-02-device這個帳號,現階段只要確認建立成功、密碼已記下來即可,等第 04 篇才會實際使用。
七、準備硬體清單
接下來幾篇會用到,先備齊:
- ESP32 開發板 2 片(以下稱為 esp32-01、esp32-02)
- DHT11 模組 1 個(已接在 esp32-01,沿用系列一的接法)
- BME280 模組 1 個、BH1750 模組 1 個、SSD1306 OLED 模組 1 個(I2C 介面)
- 麵包板與杜邦線,盡量備足。兩台各接一塊麵包板會比較好整理
- USB 線 2 條(給兩片 ESP32 供電與上傳)
購買時要確認 BME280 與 OLED 是 I2C 介面(四支腳:VCC、GND、SCL、SDA),有些模組同時提供 SPI,接腳數量不同,請對照規格。BME280 與外型相似的 BMP280 不同,BMP280 沒有濕度,請確認你的是 BME280。
八、系列地圖
| 篇 | 主題 | 硬體 |
|---|---|---|
| 01 | 架構規劃(本篇) | 不需要 |
| 02 | 在 esp32-01 加入 BME280:I2C 與多感測器 | esp32-01、BME280 |
| 03 | 設定與程式分離:一份程式,多台裝置 | esp32-01 |
| 04 | 啟動 esp32-02:BH1750 與 OLED 本機顯示 | esp32-02、BH1750、OLED |
| 05 | 多裝置儀表板:裝置清單、切換與總覽 | 兩台都開著 |
| 06 | 裝置管理:上下線總覽與擴充檢查表 | 兩台都開著 |
九、常見問題
- 權限改了,儀表板仍然看不到 esp32-02:權限有快取,等幾分鐘。也要確認
esp32-02這時還沒上線,所以看不到資料是正常的。 - 我已經把 esp32-01 改過名字,舊主題還有資料:舊名字的保留訊息不會自己消失,請用系列二第 03 篇的方法,對舊主題發布空內容、帶 retain 的訊息,把它們清掉。
- 不確定模組是 I2C 還是 SPI:看接腳數量與標示,I2C 模組通常標示 SDA、SCL;若你的模組有 CS、MOSI、MISO 之類的標示,那是 SPI。
- 只有一片 ESP32 想先跟著做:前三篇用一台就能做;第 04 篇之後,要有第二片才能完整體驗。
十、延伸挑戰
- 用紙筆或試算表,畫出你自己的「裝置清冊」:每台裝置的名稱、位置、感測器、使用的腳位、帳號名稱。裝置越多,這張表越有用。
- 想一想:如果日後要再加第三台裝置,需要改哪些地方?理想的答案是「幾乎不用改程式,只要加設定與帳號」。這就是本系列要達到的目標。
- 為你的裝置想一個命名規則,並說明為什麼要這樣命名。
下一篇預告
架構規劃好了。下一篇我們開始動手:在 esp32-01 接上 BME280,認識 I2C 與位址掃描,並讓 DHT11 與 BME280 同時量測,直接比較兩種感測器的差異。
系列:多裝置與多感測器
目錄:系列總整理 | 學習地圖:多裝置學習地圖 | 下一篇:在 esp32-01 加入 BME280
留言
張貼留言