構建一款基于 ESP32-C5 的空氣質量監(jiān)測設備

時間：2026-01-21 17:30:44

關鍵字： OLED 顯示屏 ESP32-C5 Wi-Fi

手機看文章

掃描二維碼
隨時隨地手機看文章

[導讀]室內空氣質量(IAQ)常常被忽視，但它卻直接影響著認知功能和長期健康狀況。二氧化碳含量過高會導致困倦和注意力不集中，而甲醛(HCHO)——通常來自家具和建筑材料——是一種已知的刺激物。AtmosGuard C5 是一款基于 Seeed Studio XIAO ESP32-C5 構建的高精度、聯(lián)網監(jiān)測設備。它利用雙頻 Wi-Fi 提供 OLED 顯示屏上的實時監(jiān)測，并通過無縫的 Captive Portal 設置將歷史數(shù)據(jù)記錄到 Google Sheets 中。

1. 簡介

室內空氣質量(IAQ)常常被忽視，但它卻直接影響著認知功能和長期健康狀況。二氧化碳含量過高會導致困倦和注意力不集中，而甲醛(HCHO)——通常來自家具和建筑材料——是一種已知的刺激物。AtmosGuard C5 是一款基于 Seeed Studio XIAO ESP32-C5 構建的高精度、聯(lián)網監(jiān)測設備。它利用雙頻 Wi-Fi 提供 OLED 顯示屏上的實時監(jiān)測，并通過無縫的 Captive Portal 設置將歷史數(shù)據(jù)記錄到 Google Sheets 中。

2. 特點/特征

?微環(huán)境感應技術：集成了非分散紅外線二氧化碳檢測與電化學甲醛檢測功能，從而實現(xiàn)全面的空氣安全監(jiān)測。

?雙頻連接：利用 ESP32-C5 芯片，在現(xiàn)代 5GHz 無線網絡環(huán)境下運行。

?captive portal 配置：不使用固定密碼;采用 WiFiManager 進行便攜式設置。

?云集成：實時數(shù)據(jù)記錄至 Google 表格，以便進行長期趨勢分析。

?智能狀態(tài)：根據(jù)世界衛(wèi)生組織的指導方針，動態(tài) OLED 頭部顯示屏會自動更新(良好/一般/較差)。

3. 連接步驟

?安裝 XIAO：將 XIAO ESP32-C5 的引腳與 XIAO 擴展板上的母頭對齊，并用力按下。

?SCD30 連接：將一根格羅夫電纜的一端連接至 SCD30，另一端連接至擴展板上可用的任何 I2C 格羅夫接口。

?SFA3x 連接：將第二根格羅夫電纜連接到 SFA3x 以及其余的 I2C 格羅夫接口。

?顯示設置：請確保擴展板上標有“OLED”的小開關處于開啟狀態(tài)。

?電源：將 USB-C 數(shù)據(jù)線連接至 XIAO ESP32-C5。請注意，擴展板也可通過底部的 JST 連接器由 3.7V 鋰電池供電，以便于攜帶使用。

因為 SSD1306 OLED、SCD30 和 SFA3x 都通過 I2C 協(xié)議進行通信，所以它們共用兩條數(shù)據(jù)線(SDA 和 SCL)。而 ESP32-C5 則通過它們各自獨特的 I2C 地址來區(qū)分它們：

?OLED：0x3C

?SFA3x: 0x5D

?SCD30: 0x61

這種并行連接使得該系統(tǒng)能夠“可擴展”，而無需增加更多的引腳。

4. 代碼分解

該代碼的結構設計旨在確保在新的小愛 ESP32-C5 RISC-V 內核上運行的穩(wěn)定性：

?I2C 穩(wěn)定性：在經過 2 秒的啟動延遲后以 100kHz 的頻率進行初始化，以防止總線出現(xiàn)卡頓現(xiàn)象。

?非阻塞邏輯：傳感器讀數(shù)與云端記錄間隔(60 秒)相分離，以保持顯示屏的響應能力。

?持久數(shù)據(jù)：全局變量會保存“最后已知的正?！弊x數(shù)，以防止在傳感器預熱期間顯示屏出現(xiàn)驟降至零的情況。

?HTTPS 重定向：已特別設置為遵循谷歌服務器的重定向操作，以確保數(shù)據(jù)能夠正確傳輸至電子表格。

圖書館的包含內容及定義

?傳感器：Adafruit_SCD30.h 和 SensirionI2cSfa3x.h 負責處理二氧化碳和甲醛傳感器的復雜 I2C 通信協(xié)議。

?顯示：使用 U8g2lib.h 是因為其支持“全緩沖”模式，能夠實現(xiàn)更流暢的屏幕更新和自定義字體。

?網絡：WiFiManager.h 是創(chuàng)建封閉式門戶的關鍵。它使您無需在腳本中硬編碼 Wi-Fi 密碼。

?云：HTTPClient.h 使 ESP32-C5 能夠像網絡瀏覽器一樣“獲取”谷歌腳本的 URL。請確保在 Arduino IDE 中安裝這些庫。

全局變量與實例

C++

我們?yōu)閭鞲衅鲃?chuàng)建“對象”并將其展示在此處，以便它們能夠在 setup() 函數(shù)和 loop() 函數(shù)中被訪問。我們還定義了 lastEntry 和 interval 來管理時間;這樣做可以確保我們不會向 Google Sheets 發(fā)送過多請求，以免導致暫時被封禁。

設置模塊(“早晨的例行程序”)

當設備開機時，此程序會運行一次。

?“Serial.begin(115200)”：啟動與您電腦的通信，以便進行調試。

?“Wire.begin() & Wire.setClock(100000)：這是 ESP32-C5 中最為關鍵的部分。它用于初始化 I2C 總線。我們將速度設置為 100kHz(標準模式)，以確保在多個傳感器共享同一根導線時的穩(wěn)定性?！?

?WiFiManager 類：它會檢查設備是否還記得某個 Wi-Fi 網絡。如果沒有記住，它就會啟動一個名為“AirMonitor-AP”的接入點(AP)。wm.setConfigPortalTimeout(120) 這個方法是一個安全功能;如果在 2 分鐘內沒有人連接到該接入點，設備就會轉而進行本地監(jiān)控，以免永遠停留在這個狀態(tài)。

“循環(huán)塊(恒定循環(huán))”

這個循環(huán)會反復運行，并執(zhí)行三項主要任務：

A. 讀取傳感器數(shù)據(jù)

C++

SCD30 每 2 秒才更新一次數(shù)據(jù)。這個 if 語句確保我們僅在傳感器獲取到新數(shù)據(jù)時才更新變量。這樣可以避免“零值讀數(shù)”的問題。

B. 確定空氣質量狀況

我們采用一種簡單的“如果-否則”邏輯來對空氣進行分類。

?危急情況：若二氧化碳濃度大于 1500ppm 或甲醛濃度大于 100ppb 時。

?警報條件：若二氧化碳濃度大于 1000ppm 或甲醛濃度大于 60ppb 。

?好的：其他方面。這種邏輯會優(yōu)先考慮安全性;只要有一個傳感器檢測到空氣質量不佳，整個狀態(tài)就會變?yōu)椤拜^差”。

C. 更新 OLED 技術

u8g2.clearBuffer() 函數(shù)會清空 ESP32 內存中的“虛擬”屏幕。接下來我們繪制文本和線條，最后調用 u8g2.sendBuffer() 函數(shù)一次性將整個圖像傳輸?shù)轿锢砥聊簧稀＿@樣可以避免在較簡單的庫中出現(xiàn)的“閃爍”現(xiàn)象。

云日志功能(發(fā)送至工作表)

C++

這就是谷歌表格的“秘訣所在”。當小 ESP32C5 跳轉到谷歌腳本的網址時，谷歌會以 302 重定向的方式做出響應。如果沒有這一特定的代碼行，小 ESP32C5 將會在重定向處停止，數(shù)據(jù)也就無法真正傳送到您的電子表格中。此功能會將您的 CO2、HCHO、溫度和濕度值打包成一個單一的網址字符串，并“訪問”該鏈接以記錄數(shù)據(jù)。