多裝置與多感測器 04:啟動 esp32-02,BH1750 光照感測與 OLED 本機顯示
這是「多裝置與多感測器」系列的第 4 篇。esp32-01 已經有 DHT11 和 BME280 在量溫濕度氣壓,這一篇要讓第二台裝置 esp32-02 正式上線:接上 BH1750 光照感測器,再加一顆 SSD1306 OLED 螢幕,讓裝置不需要打開手機或電腦,直接在自己身上就能看到讀數和連線狀態。
・BH1750 光照感測器的接線與讀取
・SSD1306 OLED 的接線與基本顯示
・把本機顯示與第 03 篇的自動偵測、MQTT 發布整合起來
・兩顆 I2C 裝置共用一條匯流排的實測
難度:中等 預估時間:55 分鐘
需要硬體:esp32-02、BH1750 模組、0.96 吋 SSD1306 OLED、麵包板與杜邦線
一、認識這兩個模組
BH1750 和 OLED 都是 I2C 裝置,跟第 2 篇的 BME280 用一樣的介面,一樣要靠位址區分彼此:
- BH1750:量測環境光照度,單位是流明(lux)。數值範圍很大,從完全黑暗的 0,到晴天戶外的數萬 lux 都量得到。常見位址
0x23,把 ADDR 腳接高電位(3V3)則會變成0x5C,多數模組出廠預設是0x23。 - SSD1306 OLED:0.96 吋常見解析度是 128×64 像素,單色(通常是白色或黃藍雙色),不需要背光,省電且在陽光下也看得清楚。常見位址
0x3C,少數模組是0x3D。
兩個都接在同一條 I2C 匯流排(GPIO 21、22)上,因為位址不同,不會互相干擾。
二、接線
兩顆模組的 VCC、GND、SCL、SDA 都接到 ESP32 相同的腳位(並接)。腳位請以你的開發板與模組上的標示為準。
| ESP32 | BH1750 | OLED(SSD1306) |
|---|---|---|
| 3V3 | VCC | VCC |
| GND | GND | GND |
| GPIO 22 | SCL | SCL |
| GPIO 21 | SDA | SDA |
・大多數 BH1750、OLED 模組都是 3.3V~5V 皆可用,但請先看模組上的標示,沒寫清楚就接 3V3 最安全。
・OLED 模組有些會多一個 RES(重置)或 RST 腳,I2C 版通常不需要接它,若有疑問請查模組說明。
・先只接 BH1750,確認能讀到資料,再接上 OLED,一次排除一種問題,比較好除錯。
三、安裝函式庫
- 搜尋並安裝 BH1750(作者 Christopher Laws)。這是目前最常用的 BH1750 函式庫。
- 搜尋並安裝 Adafruit SSD1306,安裝時一併安裝相依的 Adafruit GFX Library。
四、先確認 BH1750 讀得到資料
沿用第 2、3 篇的做法,先用一支簡單的測試程式單獨驗證:
#include <Wire.h>
#include <BH1750.h>
const int SDA_PIN = 21;
const int SCL_PIN = 22;
BH1750 lightMeter;
void setup() {
Serial.begin(115200);
delay(1000);
Wire.begin(SDA_PIN, SCL_PIN);
if (lightMeter.begin(BH1750::CONTINUOUS_HIGH_RES_MODE)) {
Serial.println("BH1750 初始化成功");
} else {
Serial.println("找不到 BH1750,請檢查接線");
}
}
void loop() {
float lux = lightMeter.readLightLevel();
Serial.printf("光照度:%.1f lux\n", lux);
delay(2000);
}
上傳後打開序列埠監控視窗,用手蓋住感測器再放開,應該能看到數值明顯下降再回升。CONTINUOUS_HIGH_RES_MODE 是連續量測、高解析度模式,每次 readLightLevel() 大約要等 120 毫秒才會有新值,對每幾秒讀一次的應用來說完全夠用。
五、加上 OLED 顯示
確認 BH1750 沒問題後,加入 OLED。下面這支程式會在螢幕上顯示裝置名稱、光照度,以及一個簡單的「線上/離線」字樣(這裡先用假資料示意,第七節會接上真正的 WiFi/MQTT 狀態):
#include <Wire.h>
#include <BH1750.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
#define OLED_ADDR 0x3C
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);
BH1750 lightMeter;
void drawScreen(float lux, bool mqttOnline) {
display.clearDisplay();
display.setTextSize(1);
display.setTextColor(SSD1306_WHITE);
display.setCursor(0, 0);
display.println("esp32-02 book-light");
display.setTextSize(2);
display.setCursor(0, 20);
display.printf("%.0f lux", lux);
display.setTextSize(1);
display.setCursor(0, 50);
display.print("MQTT: ");
display.println(mqttOnline ? "online" : "offline");
display.display();
}
void setup() {
Serial.begin(115200);
Wire.begin(21, 22);
if (!display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDR)) {
Serial.println("找不到 OLED,請檢查接線與位址");
while (true) delay(1000); // OLED 是本機顯示的核心,找不到就先停住提醒
}
display.setRotation(0);
lightMeter.begin(BH1750::CONTINUOUS_HIGH_RES_MODE);
}
void loop() {
float lux = lightMeter.readLightLevel();
drawScreen(lux, false); // 第七節會換成真正的連線狀態
delay(2000);
}
幾個重點:
Adafruit_SSD1306建構子最後一個參數-1表示沒有獨立的重置腳,I2C 模組通常這樣接就好。- 每次要更新畫面,固定是「清空、畫新內容、
display()送出」三步。只呼叫display()才會真正更新到螢幕上,之前的print、drawX都只是畫在記憶體裡的畫布。 - 這裡故意讓
display.begin()失敗時卡住不動,因為本機顯示是這台裝置的主要功能,找不到螢幕就該立刻發現,而不是悄悄地沒有畫面卻繼續跑。這跟第 2、3 篇「感測器找不到也要讓裝置繼續運作」的原則不同,因為 OLED 在這篇是核心功能,BME280、DHT11 則是可有可無的感測器,依功能的重要性決定要不要讓程式停下來,是比「一律繼續」或「一律停止」更實際的做法。
六、把本機顯示接上第 03 篇的自動偵測與 MQTT
現在要把前面兩段測試程式,整合進第 03 篇建立的 esp32-02 骨架(config.h+detectSensors()+WiFi/MQTT 連線)。做法與第 2 篇把 BME280 接進 esp32-01 類似:
① detectSensors() 裡加入 BH1750 與 OLED 的偵測。第 03 篇的範例程式已經寫了 capBh1750 和 capOled 兩個旗標,這篇只要確認它們接上真正的函式庫呼叫即可,偵測邏輯本身不用改。
② 全域變數區加入:
BH1750 lightMeter; Adafruit_SSD1306 display(128, 64, &Wire, -1); float lastLux = NAN;
③ setup() 裡,detectSensors() 之後加入:
if (capBh1750) lightMeter.begin(BH1750::CONTINUOUS_HIGH_RES_MODE);
if (capOled) {
display.begin(SSD1306_SWITCHCAPVCC, oledAddr);
display.setTextColor(SSD1306_WHITE);
}
④ buildTelemetry() 加入 lux 欄位。依第 1 篇訂的欄位規則,esp32-02 的 telemetry 不會有 temp、hum,只有 lux:
String buildTelemetry() {
String j = "{";
bool first = true;
if (capBh1750) {
lastLux = lightMeter.readLightLevel();
j += "\"lux\":" + String(lastLux, 1);
first = false;
}
if (!first) j += ",";
j += "\"rssi\":" + String(WiFi.RSSI());
j += ",\"uptime\":" + String(millis() / 1000);
j += ",\"ts\":" + String((long)time(nullptr));
j += "}";
return j;
}
⑤ loop() 裡加入畫面更新。放在和發布 telemetry 差不多的時機即可,不需要每次 loop 都重畫:
if (capOled) {
display.clearDisplay();
display.setTextSize(1);
display.setCursor(0, 0);
display.println(DEVICE_ID);
display.setTextSize(2);
display.setCursor(0, 20);
if (isnan(lastLux)) display.println("---");
else display.printf("%.0f lux", lastLux);
display.setTextSize(1);
display.setCursor(0, 50);
display.print("MQTT: ");
display.println(client.connected() ? "online" : "offline");
display.display();
}
OLED 透過 I2C 更新畫面需要一點時間,雖然通常很快,但如果你之後想做更複雜的畫面(例如畫圖表),要避免在同一次呼叫裡畫太多東西,否則可能讓
client.loop() 隔太久才被呼叫一次,導致 MQTT 連線不穩。保持畫面簡單、更新頻率和 telemetry 一樣(每幾秒一次)就不會有問題。
七、測試步驟
- 把
esp32-01的主程式複製一份到esp32-02的資料夾(如第 03 篇說明,.ino要一致,config.h不要覆蓋),確認config.h裡DEVICE_ID是esp32-02、MQTT_USER是esp32-02-device。 - 上傳後看序列埠的「感測器偵測結果」,確認
BH1750和OLED都顯示「有」,DHT11和BME280顯示「無」。 - 確認 OLED 螢幕上顯示裝置名稱、光照度,以及 MQTT 連線狀態(連上後應該變成
online)。 - 用 Web Client 訂閱
iot/esp32-02/telemetry與iot/esp32-02/info,確認收到的資料只有lux、沒有temp、hum,info的sensors陣列是["bh1750","oled"]。 - 把 LED 控制指令(
iot/esp32-02/cmd/led)也測一次,確認系列二第 04 篇的遠端控制邏輯在第二台裝置上一樣可以運作。
八、常見問題
- OLED 完全沒有反應(不是找不到,是找得到但畫面空白):確認
display.display()真的被呼叫到,這是最常忘記的一步。也檢查對比度,部分模組的預設對比較低,看起來像沒畫面。 - BH1750 一直讀到 0 或讀到異常大的數字:確認感測器沒有被其他東西完全遮住;異常大的數字(例如超過 6 萬多)通常代表讀取失敗,檢查接線與函式庫版本。
- 兩顆模組都接上後,其中一顆忽然讀不到:先確認麵包板上是否有接觸不良,I2C 並接的線路很容易因為麵包板孔位鬆動而斷接。也可以先只接一顆測試,逐一排除。
- 畫面偶爾會閃一下或花掉:通常是因為每次都整個畫面重畫。如果介意,可以研究 Adafruit GFX 的局部更新方式,但這對目前的簡單畫面不是必要的優化。
九、延伸挑戰
- 在 OLED 上加一顆簡單的訊號強度圖示(依
WiFi.RSSI()的範圍畫出 1 到 4 格的格數)。 - 設計一個「低光照警示」:光照度低於某個門檻(例如忘記開燈時)就在 MQTT 發一則通知,接上系列一第 07 篇的 LINE 通知邏輯。
- 幫 OLED 加上簡單的動畫效果,例如數值變化時用捲動或淡入的方式呈現,而不是整張畫面硬切換。
下一篇預告
兩台裝置都上線了,esp32-01 量溫濕度氣壓,esp32-02 量光照並有自己的螢幕。下一篇要把系列二的儀表板升級,讓它能同時顯示所有裝置、自動發現新裝置上線,而不是只能看單一台。
系列:多裝置與多感測器
目錄:系列總整理 | 學習地圖:多裝置學習地圖 | 上一篇:設定與程式分離 | 下一篇:多裝置儀表板
留言
張貼留言