多裝置與多感測器 03:設定與程式分離,一份程式給多台裝置用
這是「多裝置與多感測器」系列的第 3 篇。第 1 篇規劃了架構,第 2 篇幫 esp32-01 加上了 BME280。但現在程式裡還有一個問題:裝置 ID、WiFi 密碼、MQTT 帳密,全部寫死在同一份 .ino 檔案裡。
如果直接複製這份程式給 esp32-02 用,你勢必要在程式碼裡改好幾個地方,改漏一個,兩台裝置就會互相干擾,甚至用同一個 Client ID 導致不斷斷線重連。這一篇要做的事,就是把「會因裝置而不同的設定」和「對所有裝置都一樣的程式邏輯」徹底分開。
・把裝置設定搬進獨立的 config.h,程式本體不再因裝置而改
・用 Arduino IDE 的「多個分頁」功能管理設定檔
・開機時自動掃描 I2C,偵測掛了哪些感測器
・DHT11 沒有 I2C 位址,仍需要一個設定開關
難度:中等 預估時間:40 分鐘
需要硬體:esp32-01(已接 DHT11、BME280)
一、為什麼不能只複製貼上
回頭看目前的程式,這些東西是「因裝置而不同」的:
- 裝置 ID(
esp32-01或esp32-02),決定了 MQTT 主題前綴 - WiFi 的 SSID、密碼(兩台可能接同一個 WiFi,但帳密仍該各自保存一份,方便之後改用不同網路)
- MQTT 的帳號密碼(每台裝置都有自己的憑證,第 1 篇已經規劃好)
- 這台裝置實際掛了哪些感測器
而「對所有裝置都一樣」的是:怎麼連 WiFi、怎麼連 MQTT、怎麼組 JSON、怎麼處理指令、LWT 怎麼設定。如果把這兩類混在一起,每多一台裝置,出錯的機會就多一次。目標是:同一份 .ino 檔案,不用改一行程式,就能分別燒錄進兩台不同的裝置。
二、用 Arduino IDE 的分頁功能
Arduino IDE 的編輯器其實支援同一個「草稿碼」(sketch)裡放多個檔案,顯示成分頁。做法是:
- 打開你原本
esp32-01用的.ino檔案。 - 點編輯器右上角的向下箭頭圖示(或選單「草稿碼 → 新增標籤」),新增一個檔案,命名為
config.h。 - 存檔後,你會看到編輯器上方多了一個
config.h分頁,和主程式的.ino分頁並排。
編譯時,Arduino IDE 會把同一個草稿碼資料夾裡的所有檔案一起處理,所以主程式只要 #include "config.h" 就能用到裡面定義的內容。這跟真的「多個程式共用一個函式庫」不同,但對兩三台裝置來說已經夠用,也不需要額外安裝工具。
Arduino 沒有「同一份程式切換設定再重新編譯」的內建機制。實際作法是:
esp32-01 和 esp32-02 各自有一個資料夾(例如 esp32-01/esp32-01.ino 與 esp32-02/esp32-02.ino),兩邊的主程式內容完全相同,只有各自資料夾裡的 config.h 不同。要確保兩邊主程式一致,最簡單的辦法是改完一邊,就把同一份 .ino 複製到另一個資料夾蓋過去,config.h 不要覆蓋。
三、config.h 裡放什麼
把所有「因裝置而不同」的東西,用 #define 和常數集中寫在這裡:
// config.h —— esp32-01 專用,請勿覆蓋到 esp32-02 的資料夾 #pragma once // ---- 裝置身分 ---- #define DEVICE_ID "esp32-01" // ---- WiFi ---- #define WIFI_SSID "你的WiFi名稱" #define WIFI_PASS "你的WiFi密碼" // ---- MQTT(HiveMQ Cloud)---- #define MQTT_HOST "你的叢集網址.s1.eu.hivemq.cloud" #define MQTT_PORT 8883 #define MQTT_USER "esp32-01-device" #define MQTT_PASS "esp32-01的密碼" // ---- 這台裝置手動設定的感測器 ---- // DHT11 沒有 I2C 位址,無法自動偵測,只能用開關手動告知 #define HAS_DHT11 true #define DHT_PIN 4 // ---- I2C 腳位(多數 ESP32 開發板的預設值)---- #define SDA_PIN 21 #define SCL_PIN 22
esp32-02 的 config.h 則是這樣,注意 HAS_DHT11 改成 false,因為第二台裝置沒有接 DHT11:
// config.h —— esp32-02 專用 #pragma once #define DEVICE_ID "esp32-02" #define WIFI_SSID "你的WiFi名稱" #define WIFI_PASS "你的WiFi密碼" #define MQTT_HOST "你的叢集網址.s1.eu.hivemq.cloud" #define MQTT_PORT 8883 #define MQTT_USER "esp32-02-device" #define MQTT_PASS "esp32-02的密碼" #define HAS_DHT11 false #define DHT_PIN 4 // 沒有接就不會用到,留著不影響 #define SDA_PIN 21 #define SCL_PIN 22
如果你有把程式碼放到 GitHub 之類的地方備份,
config.h 裡有 WiFi 和 MQTT 密碼,不應該公開。可以在上傳前刪掉密碼欄位的內容,或是把 config.h 整個排除在外(如果你熟悉 Git,就是加進 .gitignore),只上傳一份把密碼換成空字串的範本檔。
四、開機時自動偵測 I2C 感測器
裝置 ID、WiFi、MQTT 帳密可以手動設定,但「這台裝置實際有哪些感測器」,其實可以讓程式自己去問。I2C 感測器都有自己的位址,開機掃一次就知道誰在線上,不需要每次加減感測器都手動改設定。
這是一個可以重複使用的偵測函式,針對第 2 篇遇到的三種 I2C 裝置(BME280、BH1750、OLED)各自檢查:
#include <Wire.h>
// 這三個旗標在開機時由 detectSensors() 填好,之後整個程式都讀它們
bool capBme280 = false;
bool capBh1750 = false;
bool capOled = false;
uint8_t bme280Addr = 0; // 找到時記下實際位址,0x76 或 0x77
uint8_t oledAddr = 0; // 找到時記下實際位址,0x3C 或 0x3D
// 檢查某個 I2C 位址有沒有裝置回應
bool i2cPresent(uint8_t addr) {
Wire.beginTransmission(addr);
return Wire.endTransmission() == 0;
}
void detectSensors() {
Wire.begin(SDA_PIN, SCL_PIN);
// BME280:0x76 或 0x77
if (i2cPresent(0x76)) { capBme280 = true; bme280Addr = 0x76; }
else if (i2cPresent(0x77)) { capBme280 = true; bme280Addr = 0x77; }
// BH1750:0x23 或 0x5C
capBh1750 = i2cPresent(0x23) || i2cPresent(0x5C);
// SSD1306 OLED:0x3C 或 0x3D
if (i2cPresent(0x3C)) { capOled = true; oledAddr = 0x3C; }
else if (i2cPresent(0x3D)) { capOled = true; oledAddr = 0x3D; }
Serial.println("==== 感測器偵測結果 ====");
Serial.printf("DHT11(手動設定): %s\n", HAS_DHT11 ? "有" : "無");
Serial.printf("BME280(自動偵測): %s\n", capBme280 ? "有" : "無");
Serial.printf("BH1750(自動偵測): %s\n", capBh1750 ? "有" : "無");
Serial.printf("OLED(自動偵測) : %s\n", capOled ? "有" : "無");
}
在 setup() 裡,dht.begin() 之前呼叫一次 detectSensors() 即可。之後第 2 篇寫的 buildTelemetry()、第 4 篇要寫的 OLED 顯示邏輯,通通改成看 capBme280、capBh1750、capOled 這幾個旗標,而不是看 config.h 裡有沒有定義某個 #define。
I2C 裝置能被掃到,是因為它們都有一個固定的位址,ESP32 喊一聲就知道有沒有人應答。DHT11 用的是單線通訊協定,沒有位址這個概念,ESP32 只能照著接好的腳位去問,問不到也有可能只是雜訊干擾造成的一次讀取失敗,不能直接當作「沒接」。所以 DHT11 仍然要用
config.h 裡的 HAS_DHT11 手動告知。
五、把 info 主題接上自動偵測的結果
第 1 篇規劃的 info 主題,現在可以真正派上用場。開機偵測完就發布一次,讓儀表板知道這台裝置有什麼:
String buildInfo() {
String j = "{";
j += "\"name\":\"" + String(DEVICE_ID) + "\"";
j += ",\"sensors\":[";
bool first = true;
if (HAS_DHT11) { j += "\"dht11\""; first = false; }
if (capBme280) { if (!first) j += ","; j += "\"bme280\""; first = false; }
if (capBh1750) { if (!first) j += ","; j += "\"bh1750\""; first = false; }
if (capOled) { if (!first) j += ","; j += "\"oled\""; first = false; }
j += "]";
j += ",\"fw\":\"1.1.0\"";
j += "}";
return j;
}
在 MQTT 連線成功、訂閱完指令主題之後,發布一次 info(記得帶 retain = true):
// ★ 新增:連線成功後發布裝置資訊
client.publish(TOPIC_INFO, buildInfo().c_str(), true);
TOPIC_INFO 的組法和其他主題一樣,是 "iot/" + String(DEVICE_ID) + "/info",可以在全域變數區用 String 先組好,或是沿用你原本組 TOPIC_TELEMETRY 的寫法。
六、整理後的開機流程
七、測試步驟
- 在
esp32-01的資料夾裡建立config.h,填入esp32-01的實際設定,上傳程式。 - 打開序列埠監控視窗,確認看到「感測器偵測結果」區塊,
DHT11和BME280都顯示「有」。 - 用 Web Client 訂閱
iot/esp32-01/info,確認收到的 JSON 裡sensors陣列包含dht11和bme280。 - 驗證設定確實分離:把
config.h裡的HAS_DHT11暫時改成false,重新上傳,確認序列埠顯示「無」,info的sensors陣列也不再有dht11。測完記得改回true並重新上傳,恢復正常設定。
八、常見問題
- 編譯時說找不到 config.h:確認 config.h 是用 Arduino IDE 的「新增標籤」建立,和 .ino 檔案在同一個資料夾,不是另外存在別的地方。
- 兩台裝置的程式後來不一致了:這是最容易發生的狀況。建議養成習慣:改動主程式邏輯後,先在原本那台測過,再用檔案總管把
.ino複製覆蓋到另一台的資料夾,不要用 Arduino IDE 的「另存新檔」,以免路徑弄亂。 - 偵測不到已知存在的感測器:先用第 2 篇的 I2C 掃描程式確認位址。如果掃描程式找得到、
detectSensors()卻找不到,檢查兩者的SDA_PIN、SCL_PIN是否一致。 - 想用更嚴謹的方式管理多份設定:如果之後裝置數量變多,可以研究 Arduino IDE 的「開發板管理員」裡是否支援每個草稿碼綁定不同的 board.txt,或改用 PlatformIO 的多環境(environment)功能,但這已經超出本系列的範圍。
九、延伸挑戰
- 把 WiFi 的 SSID、密碼也改成支援兩組備援網路(例如家裡和手機熱點),開機時依序嘗試連線。
- 在
config.h裡加一個DEVICE_LOCATION常數,並讓buildInfo()把它一併發布,呼應第 1 篇提過的「位置放進 info,不要放進裝置 ID」。 - 想一想:如果你想暫時停用某顆已經接著的感測器(不拆線,只是不想讓它影響資料),要怎麼設計一個「停用」旗標?它應該放在
config.h還是讓detectSensors()判斷?
下一篇預告
設定和程式分開了,自動偵測也做好了。下一篇要讓第二台 esp32-02 正式上線:接上 BH1750 光照感測器和 SSD1306 OLED 顯示器,並讓裝置不靠網頁,直接在螢幕上顯示自己的讀數與連線狀態。
系列:多裝置與多感測器
目錄:系列總整理 | 學習地圖:多裝置學習地圖 | 上一篇:在 esp32-01 加入 BME280 | 下一篇:啟動 esp32-02
留言
張貼留言