多裝置與多感測器 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)裡放多個檔案,顯示成分頁。做法是:

  1. 打開你原本 esp32-01 用的 .ino 檔案。
  2. 點編輯器右上角的向下箭頭圖示(或選單「草稿碼 → 新增標籤」),新增一個檔案,命名為 config.h。
  3. 存檔後,你會看到編輯器上方多了一個 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 前要注意
如果你有把程式碼放到 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。

為什麼 DHT11 不能自動偵測?
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 的寫法。

六、整理後的開機流程

開機流程 讀取config.h 連上WiFi/MQTT 掃描 I2C偵測感測器 發布info(保留) 進入主迴圈

七、測試步驟

  1. 在 esp32-01 的資料夾裡建立 config.h,填入 esp32-01 的實際設定,上傳程式。
  2. 打開序列埠監控視窗,確認看到「感測器偵測結果」區塊,DHT11 和 BME280 都顯示「有」。
  3. 用 Web Client 訂閱 iot/esp32-01/info,確認收到的 JSON 裡 sensors 陣列包含 dht11 和 bme280。
  4. 驗證設定確實分離:把 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

留言

熱門文章