多裝置與多感測器 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(溫濕度氣壓) 內建 LED(可遙控) esp32-02 BH1750(光照) OLED(本機顯示) 內建 LED(可遙控) Broker HiveMQ Cloud 儀表板 看全部裝置 控制單一裝置
裝置 感測器與元件 目的
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溫度°Cesp32-01
hum相對濕度%esp32-01
pressure氣壓hPaesp32-01(BME280)
lux光照強度lxesp32-02(BH1750)
rssiWiFi 訊號強度dBm所有裝置
uptime開機後經過的時間秒所有裝置
ts時間戳記(Epoch)秒所有裝置

三條規則:

  1. 只增不改。已經在用的欄位,不要改名字、不要改單位。要加新資訊,就新增欄位。這樣舊的儀表板與程式永遠不會壞掉。
  2. 欄位是選用的。裝置有哪個感測器,就發布哪些欄位。esp32-02 沒有 DHT11,它的資料裡就不會有 temp,接收端必須能處理「欄位不存在」。
  3. 每個意義只用一個名字。溫度就叫 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 篇,這裡只列步驟:

  1. 進入 HiveMQ Cloud 叢集的 Access Management。
  2. 新增一個權限,名稱例如 iot-all-ro,主題過濾條件 iot/#,類型「Subscribe Only」。
  3. 新增另一個權限,名稱例如 iot-all-rw,主題過濾條件 iot/#,類型「Publish and Subscribe」。
  4. 把 dashboard-viewer 的權限改成 iot-all-ro,dashboard-operator 改成 iot-all-rw。如果現有的憑證無法直接換權限,就刪除後重新建立。
  5. 新增一個權限 esp32-02-rw(過濾條件 iot/esp32-02/#,Publish and Subscribe),並建立憑證 esp32-02-device 套用它。密碼請設定一組全新的強密碼並記下來,第 04 篇會用到。
權限變更需要一點時間
權限有快取,改完後可能要等幾分鐘才生效。另外,免費方案對憑證與權限的數量上限,請以主控台實際顯示的為準,若建立時遇到限制,可以把不用的舊憑證刪除。

驗證權限

  1. 用 Web Client,以 dashboard-viewer 連線,訂閱 iot/#,應該能收到 esp32-01 的資料。
  2. 用 dashboard-viewer 試著發布一則訊息到任何主題,應該不會被接受(Broker 可能直接忽略,也可能中斷連線)。
  3. 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

留言

熱門文章