多裝置與多感測器 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)上,因為位址不同,不會互相干擾。

二、接線

esp32-02 接線圖(BH1750 與 OLED) ESP32 esp32-02 3V3 GND GPIO 22(SCL) GPIO 21(SDA) VCC GND SCL SDA BH1750 位址 0x23 VCC GND SCL SDA OLED SSD1306,位址 0x3C SDA 另接 GPIO 21

兩顆模組的 VCC、GND、SCL、SDA 都接到 ESP32 相同的腳位(並接)。腳位請以你的開發板與模組上的標示為準。

ESP32 BH1750 OLED(SSD1306)
3V3VCCVCC
GNDGNDGND
GPIO 22SCLSCL
GPIO 21SDASDA
接線前注意
・大多數 BH1750、OLED 模組都是 3.3V~5V 皆可用,但請先看模組上的標示,沒寫清楚就接 3V3 最安全。
・OLED 模組有些會多一個 RES(重置)或 RST 腳,I2C 版通常不需要接它,若有疑問請查模組說明。
・先只接 BH1750,確認能讀到資料,再接上 OLED,一次排除一種問題,比較好除錯。

三、安裝函式庫

  1. 搜尋並安裝 BH1750(作者 Christopher Laws)。這是目前最常用的 BH1750 函式庫。
  2. 搜尋並安裝 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();
  }
別讓畫面更新卡住 MQTT
OLED 透過 I2C 更新畫面需要一點時間,雖然通常很快,但如果你之後想做更複雜的畫面(例如畫圖表),要避免在同一次呼叫裡畫太多東西,否則可能讓 client.loop() 隔太久才被呼叫一次,導致 MQTT 連線不穩。保持畫面簡單、更新頻率和 telemetry 一樣(每幾秒一次)就不會有問題。

七、測試步驟

  1. 把 esp32-01 的主程式複製一份到 esp32-02 的資料夾(如第 03 篇說明,.ino 要一致,config.h 不要覆蓋),確認 config.h 裡 DEVICE_ID 是 esp32-02、MQTT_USER 是 esp32-02-device。
  2. 上傳後看序列埠的「感測器偵測結果」,確認 BH1750 和 OLED 都顯示「有」,DHT11 和 BME280 顯示「無」。
  3. 確認 OLED 螢幕上顯示裝置名稱、光照度,以及 MQTT 連線狀態(連上後應該變成 online)。
  4. 用 Web Client 訂閱 iot/esp32-02/telemetry 與 iot/esp32-02/info,確認收到的資料只有 lux、沒有 temp、hum,info 的 sensors 陣列是 ["bh1750","oled"]。
  5. 把 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 量光照並有自己的螢幕。下一篇要把系列二的儀表板升級,讓它能同時顯示所有裝置、自動發現新裝置上線,而不是只能看單一台。


系列:多裝置與多感測器
目錄:系列總整理 | 學習地圖:多裝置學習地圖 | 上一篇:設定與程式分離 | 下一篇:多裝置儀表板

留言

熱門文章