指南)
1. 從零上手GY-30為什么選它做ESP32的光照搭檔如果你剛開始玩ESP32想找一個便宜、好用、資料多、接線又簡單的傳感器來練手GY-30幾乎是繞不開的一個選擇。它本質(zhì)上是一塊基于BH1750FVI芯片的光照強度采集模塊輸出的是直接可讀的數(shù)字量單位是勒克斯lx。和光敏電阻那種模擬量方案比起來GY-30不需要你自己標定也不受ADC精度和參考電壓漂移的折磨插上I2C就能讀數(shù)對新手非常友好。我當初選它的原因很直接一是價格低幾塊錢就能拿到二是它走I2C總線只需要兩根信號線就能和ESP32通信省下來的引腳可以接別的外設(shè)三是BH1750FVI這顆芯片本身精度不錯量程覆蓋0到65535 lx室內(nèi)照明、室外陰天、甚至晴天直射光都能測日常做智能家居、自動調(diào)光、植物補光監(jiān)控這些場景完全夠用。對于“零基礎(chǔ)學(xué)ESP32”這個階段的人來說能快速看到串口打印出真實的光照數(shù)值這種正反饋比什么都重要。不過便宜好用的東西往往也有它的脾氣。GY-30模塊在市面上版本很多有的帶電平轉(zhuǎn)換有的不帶有的地址引腳默認拉低有的懸空供電電壓標稱3.3V到5V但實際接ESP32時到底怎么接才穩(wěn)很多人第一次都會踩坑。這篇文章我就按自己實際調(diào)試的順序把GY-30和ESP32配合使用的完整流程拆開講清楚包括I2C的底層邏輯、接線細節(jié)、代碼實現(xiàn)、參數(shù)計算以及那些文檔里不會寫但實際一定會遇到的問題。適合讀這篇內(nèi)容的人有三類完全沒碰過I2C傳感器的新手、已經(jīng)會點Arduino但想搞懂底層原理的進階玩家、以及想把光照數(shù)據(jù)接入自己ESP32項目比如自動窗簾、補光燈、環(huán)境監(jiān)測的開發(fā)者。不管你是哪一類只要跟著把接線和代碼走一遍基本都能讓GY-30在ESP32上穩(wěn)定跑起來。2. GY-30與BH1750FVI的核心原理拆解2.1 BH1750FVI到底是怎么測光的很多人拿到GY-30只知道它能讀光照但不知道它內(nèi)部干了什么。BH1750FVI的核心是一個接近人眼視覺響應(yīng)曲線的高精度光電二極管配合一個16位ADC把光電流轉(zhuǎn)換成數(shù)字量。它內(nèi)部有一套固定的轉(zhuǎn)換流程光電二極管接收光線產(chǎn)生電流電流經(jīng)過積分放大再由ADC量化最后通過I2C把16位數(shù)據(jù)吐出來。這里有個關(guān)鍵點BH1750FVI的輸出不是線性的原始ADC值而是已經(jīng)經(jīng)過內(nèi)部計算、直接對應(yīng)勒克斯的數(shù)值。也就是說你讀到的兩個字節(jié)拼起來除以1.2基本就是當前光照的lx值。這個1.2是芯片手冊里給出的典型換算系數(shù)后面講代碼時我會具體說怎么用。它的測量模式主要有幾種連續(xù)高分辨率模式、連續(xù)低分辨率模式、單次高分辨率模式、單次低分辨率模式。高分辨率模式下最小能分辨1 lx左右轉(zhuǎn)換時間典型值120ms低分辨率模式轉(zhuǎn)換時間只要16ms左右但精度降到4 lx。對于大多數(shù)環(huán)境監(jiān)測場景我建議用連續(xù)高分辨率模式讀出來的數(shù)值穩(wěn)定響應(yīng)也夠快。2.2 I2C通信在GY-30上的具體體現(xiàn)GY-30模塊對外只有四個引腳VCC、GND、SCL、SDA。SCL是時鐘線SDA是數(shù)據(jù)線ESP32作為主機GY-30作為從機。I2C的通信過程其實很像兩個人打電話主機先撥號發(fā)送從機地址從機接聽應(yīng)答然后主機說指令命令字節(jié)從機執(zhí)行并返回數(shù)據(jù)。BH1750FVI的7位從機地址是0x23前提是模塊上的ADDR引腳接地。如果ADDR接VCC地址變成0x5C。市面上大部分GY-30模塊默認ADDR是懸空或者下拉的所以實際用0x23居多。這里要注意Arduino的Wire庫使用的是7位地址所以代碼里寫0x23就行不需要左移。I2C的時序里有兩個關(guān)鍵概念起始條件和停止條件。起始條件是SCL高電平時SDA從高變低停止條件是SCL高電平時SDA從低變高。數(shù)據(jù)位在SCL低電平時變化在SCL高電平時被采樣。這些底層細節(jié)你不需要手動去翻轉(zhuǎn)GPIOWire庫已經(jīng)封裝好了但理解它們有助于你在通信失敗時判斷問題出在哪。還有一個容易被忽略的點I2C總線需要上拉電阻。GY-30模塊板上通常已經(jīng)自帶了4.7kΩ或10kΩ的上拉電阻所以直接接ESP32一般能通信。但如果你接的線比較長或者總線上掛了多個從機上拉電阻的阻值可能需要調(diào)整。線長超過20厘米時我建議把上拉電阻換成2.2kΩ左右波形會更干凈。2.3 為什么ESP32和GY-30是低門檻組合ESP32的I2C外設(shè)非常靈活幾乎任意GPIO都可以通過矩陣映射成SCL和SDA。Arduino核心默認用GPIO21做SDA、GPIO22做SCL這兩個引腳在大多數(shù)ESP32開發(fā)板上都引出來了接線方便。而且ESP32的IO口是3.3V電平GY-30模塊在3.3V供電時I2C電平也是3.3V兩者天然匹配不需要額外的電平轉(zhuǎn)換。對比一下用STM32或者51單片機STM32的I2C硬件外設(shè)配置起來步驟多新手容易卡在時鐘配置和引腳復(fù)用上51單片機沒有硬件I2C得用軟件模擬時序容易出錯。ESP32用Arduino框架Wire庫幾行代碼就能跑起來這就是它適合零基礎(chǔ)的地方。另外ESP32的算力和內(nèi)存足夠你在讀取光照的同時跑WiFi、藍牙或者OLED顯示不會因為一個傳感器就把資源吃滿。我實測過在讀取GY-30的同時開WiFi上傳數(shù)據(jù)到本地服務(wù)器循環(huán)周期穩(wěn)定在200ms左右完全不影響光照采集。3. 接線與硬件準備別讓第一步就翻車3.1 物料清單與選型建議開始之前先把東西備齊。下面這張表是我實際用過的配置供你參考物料型號/規(guī)格數(shù)量備注主控板ESP32 DevKit V11任意ESP32開發(fā)板均可光照模塊GY-30 / BH17501注意看板載是否有上拉電阻杜邦線母對母4根建議用短一點的減少干擾數(shù)據(jù)線Micro USB或Type-C1根根據(jù)開發(fā)板接口選電腦任意1臺裝好Arduino IDE選GY-30的時候有個細節(jié)有些模塊標的是GY-30但實際芯片是BH1750FVI這是正常的GY-30就是基于BH1750FVI的模塊代號。你拿到手可以看模塊背面芯片絲印上如果有BH1750字樣就沒問題。如果買到的是BH1750的裸芯片自己焊的板子要確認有沒有加上拉電阻沒有的話得自己補兩個4.7kΩ電阻到3.3V。3.2 接線步驟與引腳對應(yīng)關(guān)系接線本身不復(fù)雜但順序和對應(yīng)關(guān)系要記牢。我按ESP32 DevKit V1的默認I2C引腳來說GY-30的VCC接到ESP32的3.3V引腳GY-30的GND接到ESP32的GNDGY-30的SCL接到ESP32的GPIO22GY-30的SDA接到ESP32的GPIO21這里有個非常重要的提醒不要把VCC接到5V。雖然GY-30模塊標稱支持3.3V到5V但ESP32的IO口是3.3V電平如果模塊用5V供電I2C信號線可能被模塊內(nèi)部電路拉到5V長期下來會損傷ESP32的IO。穩(wěn)妥起見統(tǒng)一用3.3V供電。接完線之后先別急著上電。用萬用表蜂鳴檔測一下VCC和GND之間有沒有短路確認沒有再接USB。我見過有人把VCC和GND接反上電瞬間模塊就發(fā)燙雖然GY-30一般有保護但沒必要冒這個險。3.3 上電前的檢查清單上電之前按下面這幾條過一遍確認VCC接的是3.3V不是5V確認GND和ESP32的GND共地確認SCL和SDA沒有接反確認杜邦線插緊沒有虛接確認ESP32開發(fā)板沒有其他短路如果用的是帶OLED的擴展板還要注意I2C地址沖突。GY-30默認0x23常見OLED是0x3C或0x3D一般不沖突。但如果你的OLED模塊地址可調(diào)最好確認一下避免兩個設(shè)備搶總線。4. Arduino IDE環(huán)境搭建與庫的選擇4.1 ESP32開發(fā)板支持包的安裝如果你還沒裝ESP32的Arduino支持這一步不能跳過。打開Arduino IDE進“文件”-“首選項”在“附加開發(fā)板管理器網(wǎng)址”里填入ESP32的板管理器地址。然后進“工具”-“開發(fā)板”-“開發(fā)板管理器”搜索esp32安裝最新版本。這里有個實際經(jīng)驗安裝過程對網(wǎng)絡(luò)環(huán)境比較敏感如果一直卡在下載階段可以嘗試換一個時間段或者手動下載離線包。網(wǎng)上有現(xiàn)成的ESP32離線包下載后放到Arduino的硬件目錄里也能用。我自己的做法是先用在線安裝如果超過十分鐘沒動靜就換離線方案不浪費時間。安裝完成后在“工具”-“開發(fā)板”里選擇“ESP32 Dev Module”。端口選擇你實際插上的那個COM口。如果看不到端口檢查數(shù)據(jù)線是不是只能充電不能傳數(shù)據(jù)的那種換一根線試試。4.2 BH1750庫的安裝與替代方案讀取GY-30最省事的方法是裝一個現(xiàn)成的庫。在Arduino IDE的“庫管理器”里搜索BH1750會出來好幾個版本。我常用的是Christopher Laws維護的那個名字就叫BH1750接口簡單支持連續(xù)和單次模式。裝好庫之后直接調(diào)用lightMeter.begin()和lightMeter.readLightLevel()就能讀數(shù)。但如果你想搞懂底層我建議也試著自己用Wire庫直接寫一遍不依賴第三方庫。這樣你能清楚每一步在干什么遇到問題時也知道從哪排查。如果你不想裝庫用Wire庫手動實現(xiàn)也不難。核心就是三個操作發(fā)送電源開啟命令、發(fā)送測量模式命令、讀取兩個字節(jié)并換算。后面我會給出完整的手動實現(xiàn)代碼。4.3 串口監(jiān)視器的配置代碼燒錄進去之后需要看串口輸出。Arduino IDE的串口監(jiān)視器波特率要和代碼里Serial.begin()設(shè)置的一致我一般用115200。打開監(jiān)視器之后如果看到一堆亂碼八成是波特率不對如果什么都沒有檢查代碼里有沒有加Serial.print以及開發(fā)板有沒有復(fù)位。還有一個細節(jié)ESP32有些開發(fā)板在打開串口監(jiān)視器時會自動復(fù)位這是正常現(xiàn)象。如果你不想讓它復(fù)位可以在代碼里加上Serial.setTimeout()或者用外部電源供電。不過對于調(diào)試光照傳感器來說復(fù)位一下反而方便每次打開監(jiān)視器都能看到從頭開始的數(shù)據(jù)。5. 代碼實現(xiàn)從最簡讀到穩(wěn)定讀5.1 使用BH1750庫的最簡代碼先上最簡版本讓你五分鐘內(nèi)看到數(shù)據(jù)#include Wire.h #include BH1750.h BH1750 lightMeter; void setup() { Serial.begin(115200); Wire.begin(21, 22); if (!lightMeter.begin()) { Serial.println(BH1750初始化失敗檢查接線); while (1); } Serial.println(BH1750初始化成功); } void loop() { float lux lightMeter.readLightLevel(); Serial.print(光照: ); Serial.print(lux); Serial.println( lx); delay(1000); }這段代碼的邏輯很直白初始化I2C初始化傳感器然后每秒讀一次。Wire.begin(21, 22)顯式指定了SDA和SCL引腳避免不同開發(fā)板默認引腳不一樣導(dǎo)致的困惑。lightMeter.begin()如果返回false說明I2C通信沒建立起來這時候先查接線再查地址。5.2 不依賴庫的Wire底層實現(xiàn)想搞懂原理的看這段手動實現(xiàn)#include Wire.h #define BH1750_ADDR 0x23 void setup() { Serial.begin(115200); Wire.begin(21, 22); Wire.beginTransmission(BH1750_ADDR); Wire.write(0x01); // 電源開啟 Wire.endTransmission(); delay(10); Wire.beginTransmission(BH1750_ADDR); Wire.write(0x10); // 連續(xù)高分辨率模式 Wire.endTransmission(); delay(180); } void loop() { Wire.requestFrom(BH1750_ADDR, 2); if (Wire.available() 2) { uint16_t raw Wire.read() 8 | Wire.read(); float lux raw / 1.2; Serial.print(原始值: ); Serial.print(raw); Serial.print( 光照: ); Serial.print(lux); Serial.println( lx); } delay(1000); }這里的關(guān)鍵是命令字節(jié)。0x01是電源開啟0x10是連續(xù)高分辨率模式。讀取時一次讀兩個字節(jié)高字節(jié)在前拼成16位整數(shù)再除以1.2得到勒克斯。這個1.2就是前面提到的換算系數(shù)芯片手冊里寫的典型值。5.3 參數(shù)計算與模式選擇不同測量模式的參數(shù)對比如下模式命令字節(jié)分辨率轉(zhuǎn)換時間適用場景連續(xù)高分辨率0x101 lx120ms常規(guī)環(huán)境監(jiān)測連續(xù)高分辨率20x110.5 lx120ms需要更高精度連續(xù)低分辨率0x134 lx16ms快速刷新單次高分辨率0x201 lx120ms低功耗場景如果你做的是電池供電的項目單次模式更省電需要讀數(shù)時發(fā)一次命令等轉(zhuǎn)換完讀一次然后讓傳感器進入斷電模式。連續(xù)模式雖然方便但芯片一直在轉(zhuǎn)換功耗會高一些。換算公式再強調(diào)一遍lux raw / 1.2。這個1.2是典型值實際芯片會有個體差異但誤差在可接受范圍內(nèi)。如果你需要更精確的絕對值可以用標準光源標定不過對于大多數(shù)DIY項目沒必要做到那個程度。6. 實測數(shù)據(jù)與常見問題排查6.1 典型場景下的讀數(shù)參考我在幾個常見環(huán)境下實測了一輪數(shù)據(jù)如下場景讀數(shù)范圍lx說明夜晚室內(nèi)關(guān)燈0 - 5接近傳感器下限室內(nèi)日光燈150 - 300與燈的距離有關(guān)室內(nèi)靠窗白天500 - 2000陰天和晴天差異大室外陰天3000 - 8000無直射陽光室外晴天陰影處8000 - 20000避免直射室外晴天直射30000 - 60000接近量程上限這些數(shù)值不是絕對標準但可以幫你判斷讀數(shù)是否合理。如果你在室內(nèi)開燈的情況下讀到0或者室外晴天讀到幾百那基本可以確定通信有問題或者模式設(shè)置錯了。6.2 常見問題速查表現(xiàn)象可能原因排查方法串口無輸出代碼沒燒錄成功檢查開發(fā)板選擇和端口初始化失敗接線錯誤或地址不對用I2C掃描程序找地址讀數(shù)一直是0模式命令沒發(fā)對確認發(fā)送了0x10或0x20讀數(shù)跳變嚴重電源不穩(wěn)或線太長縮短線長加濾波電容讀數(shù)明顯偏高傳感器被強光直射加柔光罩或改變安裝角度I2C掃描不到設(shè)備上拉電阻缺失檢查模塊是否有上拉I2C掃描程序很簡單幾行就能跑#include Wire.h void setup() { Serial.begin(115200); Wire.begin(21, 22); for (byte addr 1; addr 127; addr) { Wire.beginTransmission(addr); if (Wire.endTransmission() 0) { Serial.print(發(fā)現(xiàn)設(shè)備地址: 0x); Serial.println(addr, HEX); } } } void loop() {}跑一遍這個如果能看到0x23說明硬件連接沒問題問題在后面的代碼邏輯如果什么都掃不到那就是接線或者供電的問題。6.3 實操避坑經(jīng)驗第一個坑杜邦線質(zhì)量。我買過一批便宜的杜邦線插上去看著沒問題實際內(nèi)部斷芯時通時斷。表現(xiàn)就是串口數(shù)據(jù)偶爾正常偶爾報錯。后來換了好一點的線問題消失。所以如果你遇到莫名其妙的通信失敗先換線試試。第二個坑供電不足。有些ESP32開發(fā)板用USB供電時3.3V輸出能力有限如果同時接了OLED、溫濕度傳感器和GY-30可能出現(xiàn)電壓跌落。表現(xiàn)是GY-30讀數(shù)不穩(wěn)定或者初始化失敗。解決辦法是用外部3.3V穩(wěn)壓供電或者減少同時掛載的設(shè)備。第三個坑光照角度。BH1750FVI的感光面有方向性如果你把它裝在殼子里開孔太小或者角度不對讀數(shù)會明顯偏低。我建議安裝時讓感光面朝上或者朝向主要光源方向避免遮擋。第四個坑I2C地址沖突。如果你同時接了多個I2C設(shè)備一定要確認地址不重復(fù)。GY-30是0x23有些氣壓傳感器是0x76或0x77OLED是0x3C一般不會沖突但如果你用了地址可調(diào)的模塊就要仔細核對。7. 從讀數(shù)到應(yīng)用光照數(shù)據(jù)的進階用法7.1 自動調(diào)光與閾值控制讀到光照值之后最簡單的應(yīng)用就是做閾值控制。比如當光照低于100 lx時打開補光燈高于300 lx時關(guān)閉。代碼邏輯就是加一個if判斷if (lux 100) { digitalWrite(LED_PIN, HIGH); } else if (lux 300) { digitalWrite(LED_PIN, LOW); }這里要注意加一個遲滯區(qū)間避免在閾值附近來回抖動。比如開燈閾值設(shè)100關(guān)燈閾值設(shè)300中間200的區(qū)間就是遲滯。如果不加遲滯光照在100附近波動時燈會頻繁開關(guān)既影響壽命又看著難受。7.2 數(shù)據(jù)平滑與濾波處理原始讀數(shù)偶爾會有跳變尤其是電源不穩(wěn)或者光線突變時。我常用的方法是滑動平均濾波開一個數(shù)組存最近10次讀數(shù)每次取平均值輸出。這樣數(shù)據(jù)曲線會平滑很多代價是響應(yīng)速度稍微變慢。const int N 10; float buf[N]; int idx 0; float smooth(float newVal) { buf[idx] newVal; idx (idx 1) % N; float sum 0; for (int i 0; i N; i) sum buf[i]; return sum / N; }如果你想要更快的響應(yīng)可以用中值濾波取最近幾次讀數(shù)的中間值對脈沖干擾的抑制效果更好。7.3 接入物聯(lián)網(wǎng)平臺的思路光照數(shù)據(jù)上傳到本地服務(wù)器或者云平臺是很多人的下一步。ESP32自帶WiFi用HTTP或者MQTT協(xié)議都能發(fā)。我一般用MQTT因為數(shù)據(jù)量小、實時性好。流程是ESP32連WiFi連MQTT服務(wù)器每隔一段時間把lux值發(fā)布到指定主題服務(wù)器端訂閱后存數(shù)據(jù)庫或者展示在網(wǎng)頁上。這里不展開具體平臺的操作因為不同平臺配置差異大。核心思路就是采集-濾波-打包-發(fā)送。發(fā)送頻率不用太高光照變化本身是慢過程一分鐘發(fā)一次足夠了。發(fā)太快除了增加網(wǎng)絡(luò)負擔(dān)沒有實際意義。8. 我踩過的坑與最后分享的幾個技巧第一個技巧先用I2C掃描確認地址。不管你多自信接線沒問題跑一遍掃描程序只要幾秒鐘能省掉后面大量排查時間。我現(xiàn)在的習(xí)慣是任何I2C設(shè)備第一次上電先掃描再寫業(yè)務(wù)代碼。第二個技巧給GY-30加一個遮光罩。如果你發(fā)現(xiàn)讀數(shù)在室內(nèi)燈光下偏高可以用一段黑色熱縮管套在傳感器上只留頂部感光孔。這樣能減少側(cè)面雜散光的干擾讀數(shù)更接近實際環(huán)境照度。第三個技巧注意ESP32的I2C引腳可以重映射。默認是21和22但如果你這兩個引腳被其他外設(shè)占了可以在Wire.begin()里換成別的引腳比如Wire.begin(18, 19)。ESP32的IO矩陣幾乎支持任意引腳非常靈活。第四個技巧長時間運行要加看門狗。如果你把ESP32放在無人值守的環(huán)境里連續(xù)采集光照建議開啟硬件看門狗防止I2C總線死鎖導(dǎo)致程序卡死。Arduino核心里有esp_task_wdt相關(guān)接口配置一下就行。第五個技巧讀數(shù)單位統(tǒng)一。有些庫返回的是float有些返回uint16混用的時候注意類型轉(zhuǎn)換。我一般統(tǒng)一用float存lux值顯示和上傳都用這個避免整數(shù)除法丟精度。最后說一個我自己的體會GY-30這個模塊雖然簡單但它把I2C通信、傳感器數(shù)據(jù)讀取、參數(shù)換算這幾個嵌入式開發(fā)的核心環(huán)節(jié)都串起來了。你把它玩透后面換別的I2C傳感器比如溫濕度、氣壓、加速度計基本就是換個地址和命令字節(jié)的事。所以別急著跳過基礎(chǔ)把這一套流程走扎實后面學(xué)什么都快。 ESP32搭配GY-30光照傳感器：從接線到代碼的完整實戰(zhàn)指南
1. 從零上手GY-30為什么選它做ESP32的光照搭檔如果你剛開始玩ESP32想找一個便宜、好用、資料多、接線又簡單的傳感器來練手GY-30幾乎是繞不開的一個選擇。它本質(zhì)上是一塊基于BH1750FVI芯片的光照強度采集模塊輸出的是直接可讀的數(shù)字量單位是勒克斯lx。和光敏電阻那種模擬量方案比起來GY-30不需要你自己標定也不受ADC精度和參考電壓漂移的折磨插上I2C就能讀數(shù)對新手非常友好。我當初選它的原因很直接一是價格低幾塊錢就能拿到二是它走I2C總線只需要兩根信號線就能和ESP32通信省下來的引腳可以接別的外設(shè)三是BH1750FVI這顆芯片本身精度不錯量程覆蓋0到65535 lx室內(nèi)照明、室外陰天、甚至晴天直射光都能測日常做智能家居、自動調(diào)光、植物補光監(jiān)控這些場景完全夠用。對于“零基礎(chǔ)學(xué)ESP32”這個階段的人來說能快速看到串口打印出真實的光照數(shù)值這種正反饋比什么都重要。不過便宜好用的東西往往也有它的脾氣。GY-30模塊在市面上版本很多有的帶電平轉(zhuǎn)換有的不帶有的地址引腳默認拉低有的懸空供電電壓標稱3.3V到5V但實際接ESP32時到底怎么接才穩(wěn)很多人第一次都會踩坑。這篇文章我就按自己實際調(diào)試的順序把GY-30和ESP32配合使用的完整流程拆開講清楚包括I2C的底層邏輯、接線細節(jié)、代碼實現(xiàn)、參數(shù)計算以及那些文檔里不會寫但實際一定會遇到的問題。適合讀這篇內(nèi)容的人有三類完全沒碰過I2C傳感器的新手、已經(jīng)會點Arduino但想搞懂底層原理的進階玩家、以及想把光照數(shù)據(jù)接入自己ESP32項目比如自動窗簾、補光燈、環(huán)境監(jiān)測的開發(fā)者。不管你是哪一類只要跟著把接線和代碼走一遍基本都能讓GY-30在ESP32上穩(wěn)定跑起來。2. GY-30與BH1750FVI的核心原理拆解2.1 BH1750FVI到底是怎么測光的很多人拿到GY-30只知道它能讀光照但不知道它內(nèi)部干了什么。BH1750FVI的核心是一個接近人眼視覺響應(yīng)曲線的高精度光電二極管配合一個16位ADC把光電流轉(zhuǎn)換成數(shù)字量。它內(nèi)部有一套固定的轉(zhuǎn)換流程光電二極管接收光線產(chǎn)生電流電流經(jīng)過積分放大再由ADC量化最后通過I2C把16位數(shù)據(jù)吐出來。這里有個關(guān)鍵點BH1750FVI的輸出不是線性的原始ADC值而是已經(jīng)經(jīng)過內(nèi)部計算、直接對應(yīng)勒克斯的數(shù)值。也就是說你讀到的兩個字節(jié)拼起來除以1.2基本就是當前光照的lx值。這個1.2是芯片手冊里給出的典型換算系數(shù)后面講代碼時我會具體說怎么用。它的測量模式主要有幾種連續(xù)高分辨率模式、連續(xù)低分辨率模式、單次高分辨率模式、單次低分辨率模式。高分辨率模式下最小能分辨1 lx左右轉(zhuǎn)換時間典型值120ms低分辨率模式轉(zhuǎn)換時間只要16ms左右但精度降到4 lx。對于大多數(shù)環(huán)境監(jiān)測場景我建議用連續(xù)高分辨率模式讀出來的數(shù)值穩(wěn)定響應(yīng)也夠快。2.2 I2C通信在GY-30上的具體體現(xiàn)GY-30模塊對外只有四個引腳VCC、GND、SCL、SDA。SCL是時鐘線SDA是數(shù)據(jù)線ESP32作為主機GY-30作為從機。I2C的通信過程其實很像兩個人打電話主機先撥號發(fā)送從機地址從機接聽應(yīng)答然后主機說指令命令字節(jié)從機執(zhí)行并返回數(shù)據(jù)。BH1750FVI的7位從機地址是0x23前提是模塊上的ADDR引腳接地。如果ADDR接VCC地址變成0x5C。市面上大部分GY-30模塊默認ADDR是懸空或者下拉的所以實際用0x23居多。這里要注意Arduino的Wire庫使用的是7位地址所以代碼里寫0x23就行不需要左移。I2C的時序里有兩個關(guān)鍵概念起始條件和停止條件。起始條件是SCL高電平時SDA從高變低停止條件是SCL高電平時SDA從低變高。數(shù)據(jù)位在SCL低電平時變化在SCL高電平時被采樣。這些底層細節(jié)你不需要手動去翻轉(zhuǎn)GPIOWire庫已經(jīng)封裝好了但理解它們有助于你在通信失敗時判斷問題出在哪。還有一個容易被忽略的點I2C總線需要上拉電阻。GY-30模塊板上通常已經(jīng)自帶了4.7kΩ或10kΩ的上拉電阻所以直接接ESP32一般能通信。但如果你接的線比較長或者總線上掛了多個從機上拉電阻的阻值可能需要調(diào)整。線長超過20厘米時我建議把上拉電阻換成2.2kΩ左右波形會更干凈。2.3 為什么ESP32和GY-30是低門檻組合ESP32的I2C外設(shè)非常靈活幾乎任意GPIO都可以通過矩陣映射成SCL和SDA。Arduino核心默認用GPIO21做SDA、GPIO22做SCL這兩個引腳在大多數(shù)ESP32開發(fā)板上都引出來了接線方便。而且ESP32的IO口是3.3V電平GY-30模塊在3.3V供電時I2C電平也是3.3V兩者天然匹配不需要額外的電平轉(zhuǎn)換。對比一下用STM32或者51單片機STM32的I2C硬件外設(shè)配置起來步驟多新手容易卡在時鐘配置和引腳復(fù)用上51單片機沒有硬件I2C得用軟件模擬時序容易出錯。ESP32用Arduino框架Wire庫幾行代碼就能跑起來這就是它適合零基礎(chǔ)的地方。另外ESP32的算力和內(nèi)存足夠你在讀取光照的同時跑WiFi、藍牙或者OLED顯示不會因為一個傳感器就把資源吃滿。我實測過在讀取GY-30的同時開WiFi上傳數(shù)據(jù)到本地服務(wù)器循環(huán)周期穩(wěn)定在200ms左右完全不影響光照采集。3. 接線與硬件準備別讓第一步就翻車3.1 物料清單與選型建議開始之前先把東西備齊。下面這張表是我實際用過的配置供你參考物料型號/規(guī)格數(shù)量備注主控板ESP32 DevKit V11任意ESP32開發(fā)板均可光照模塊GY-30 / BH17501注意看板載是否有上拉電阻杜邦線母對母4根建議用短一點的減少干擾數(shù)據(jù)線Micro USB或Type-C1根根據(jù)開發(fā)板接口選電腦任意1臺裝好Arduino IDE選GY-30的時候有個細節(jié)有些模塊標的是GY-30但實際芯片是BH1750FVI這是正常的GY-30就是基于BH1750FVI的模塊代號。你拿到手可以看模塊背面芯片絲印上如果有BH1750字樣就沒問題。如果買到的是BH1750的裸芯片自己焊的板子要確認有沒有加上拉電阻沒有的話得自己補兩個4.7kΩ電阻到3.3V。3.2 接線步驟與引腳對應(yīng)關(guān)系接線本身不復(fù)雜但順序和對應(yīng)關(guān)系要記牢。我按ESP32 DevKit V1的默認I2C引腳來說GY-30的VCC接到ESP32的3.3V引腳GY-30的GND接到ESP32的GNDGY-30的SCL接到ESP32的GPIO22GY-30的SDA接到ESP32的GPIO21這里有個非常重要的提醒不要把VCC接到5V。雖然GY-30模塊標稱支持3.3V到5V但ESP32的IO口是3.3V電平如果模塊用5V供電I2C信號線可能被模塊內(nèi)部電路拉到5V長期下來會損傷ESP32的IO。穩(wěn)妥起見統(tǒng)一用3.3V供電。接完線之后先別急著上電。用萬用表蜂鳴檔測一下VCC和GND之間有沒有短路確認沒有再接USB。我見過有人把VCC和GND接反上電瞬間模塊就發(fā)燙雖然GY-30一般有保護但沒必要冒這個險。3.3 上電前的檢查清單上電之前按下面這幾條過一遍確認VCC接的是3.3V不是5V確認GND和ESP32的GND共地確認SCL和SDA沒有接反確認杜邦線插緊沒有虛接確認ESP32開發(fā)板沒有其他短路如果用的是帶OLED的擴展板還要注意I2C地址沖突。GY-30默認0x23常見OLED是0x3C或0x3D一般不沖突。但如果你的OLED模塊地址可調(diào)最好確認一下避免兩個設(shè)備搶總線。4. Arduino IDE環(huán)境搭建與庫的選擇4.1 ESP32開發(fā)板支持包的安裝如果你還沒裝ESP32的Arduino支持這一步不能跳過。打開Arduino IDE進“文件”-“首選項”在“附加開發(fā)板管理器網(wǎng)址”里填入ESP32的板管理器地址。然后進“工具”-“開發(fā)板”-“開發(fā)板管理器”搜索esp32安裝最新版本。這里有個實際經(jīng)驗安裝過程對網(wǎng)絡(luò)環(huán)境比較敏感如果一直卡在下載階段可以嘗試換一個時間段或者手動下載離線包。網(wǎng)上有現(xiàn)成的ESP32離線包下載后放到Arduino的硬件目錄里也能用。我自己的做法是先用在線安裝如果超過十分鐘沒動靜就換離線方案不浪費時間。安裝完成后在“工具”-“開發(fā)板”里選擇“ESP32 Dev Module”。端口選擇你實際插上的那個COM口。如果看不到端口檢查數(shù)據(jù)線是不是只能充電不能傳數(shù)據(jù)的那種換一根線試試。4.2 BH1750庫的安裝與替代方案讀取GY-30最省事的方法是裝一個現(xiàn)成的庫。在Arduino IDE的“庫管理器”里搜索BH1750會出來好幾個版本。我常用的是Christopher Laws維護的那個名字就叫BH1750接口簡單支持連續(xù)和單次模式。裝好庫之后直接調(diào)用lightMeter.begin()和lightMeter.readLightLevel()就能讀數(shù)。但如果你想搞懂底層我建議也試著自己用Wire庫直接寫一遍不依賴第三方庫。這樣你能清楚每一步在干什么遇到問題時也知道從哪排查。如果你不想裝庫用Wire庫手動實現(xiàn)也不難。核心就是三個操作發(fā)送電源開啟命令、發(fā)送測量模式命令、讀取兩個字節(jié)并換算。后面我會給出完整的手動實現(xiàn)代碼。4.3 串口監(jiān)視器的配置代碼燒錄進去之后需要看串口輸出。Arduino IDE的串口監(jiān)視器波特率要和代碼里Serial.begin()設(shè)置的一致我一般用115200。打開監(jiān)視器之后如果看到一堆亂碼八成是波特率不對如果什么都沒有檢查代碼里有沒有加Serial.print以及開發(fā)板有沒有復(fù)位。還有一個細節(jié)ESP32有些開發(fā)板在打開串口監(jiān)視器時會自動復(fù)位這是正常現(xiàn)象。如果你不想讓它復(fù)位可以在代碼里加上Serial.setTimeout()或者用外部電源供電。不過對于調(diào)試光照傳感器來說復(fù)位一下反而方便每次打開監(jiān)視器都能看到從頭開始的數(shù)據(jù)。5. 代碼實現(xiàn)從最簡讀到穩(wěn)定讀5.1 使用BH1750庫的最簡代碼先上最簡版本讓你五分鐘內(nèi)看到數(shù)據(jù)#include Wire.h #include BH1750.h BH1750 lightMeter; void setup() { Serial.begin(115200); Wire.begin(21, 22); if (!lightMeter.begin()) { Serial.println(BH1750初始化失敗檢查接線); while (1); } Serial.println(BH1750初始化成功); } void loop() { float lux lightMeter.readLightLevel(); Serial.print(光照: ); Serial.print(lux); Serial.println( lx); delay(1000); }這段代碼的邏輯很直白初始化I2C初始化傳感器然后每秒讀一次。Wire.begin(21, 22)顯式指定了SDA和SCL引腳避免不同開發(fā)板默認引腳不一樣導(dǎo)致的困惑。lightMeter.begin()如果返回false說明I2C通信沒建立起來這時候先查接線再查地址。5.2 不依賴庫的Wire底層實現(xiàn)想搞懂原理的看這段手動實現(xiàn)#include Wire.h #define BH1750_ADDR 0x23 void setup() { Serial.begin(115200); Wire.begin(21, 22); Wire.beginTransmission(BH1750_ADDR); Wire.write(0x01); // 電源開啟 Wire.endTransmission(); delay(10); Wire.beginTransmission(BH1750_ADDR); Wire.write(0x10); // 連續(xù)高分辨率模式 Wire.endTransmission(); delay(180); } void loop() { Wire.requestFrom(BH1750_ADDR, 2); if (Wire.available() 2) { uint16_t raw Wire.read() 8 | Wire.read(); float lux raw / 1.2; Serial.print(原始值: ); Serial.print(raw); Serial.print( 光照: ); Serial.print(lux); Serial.println( lx); } delay(1000); }這里的關(guān)鍵是命令字節(jié)。0x01是電源開啟0x10是連續(xù)高分辨率模式。讀取時一次讀兩個字節(jié)高字節(jié)在前拼成16位整數(shù)再除以1.2得到勒克斯。這個1.2就是前面提到的換算系數(shù)芯片手冊里寫的典型值。5.3 參數(shù)計算與模式選擇不同測量模式的參數(shù)對比如下模式命令字節(jié)分辨率轉(zhuǎn)換時間適用場景連續(xù)高分辨率0x101 lx120ms常規(guī)環(huán)境監(jiān)測連續(xù)高分辨率20x110.5 lx120ms需要更高精度連續(xù)低分辨率0x134 lx16ms快速刷新單次高分辨率0x201 lx120ms低功耗場景如果你做的是電池供電的項目單次模式更省電需要讀數(shù)時發(fā)一次命令等轉(zhuǎn)換完讀一次然后讓傳感器進入斷電模式。連續(xù)模式雖然方便但芯片一直在轉(zhuǎn)換功耗會高一些。換算公式再強調(diào)一遍lux raw / 1.2。這個1.2是典型值實際芯片會有個體差異但誤差在可接受范圍內(nèi)。如果你需要更精確的絕對值可以用標準光源標定不過對于大多數(shù)DIY項目沒必要做到那個程度。6. 實測數(shù)據(jù)與常見問題排查6.1 典型場景下的讀數(shù)參考我在幾個常見環(huán)境下實測了一輪數(shù)據(jù)如下場景讀數(shù)范圍lx說明夜晚室內(nèi)關(guān)燈0 - 5接近傳感器下限室內(nèi)日光燈150 - 300與燈的距離有關(guān)室內(nèi)靠窗白天500 - 2000陰天和晴天差異大室外陰天3000 - 8000無直射陽光室外晴天陰影處8000 - 20000避免直射室外晴天直射30000 - 60000接近量程上限這些數(shù)值不是絕對標準但可以幫你判斷讀數(shù)是否合理。如果你在室內(nèi)開燈的情況下讀到0或者室外晴天讀到幾百那基本可以確定通信有問題或者模式設(shè)置錯了。6.2 常見問題速查表現(xiàn)象可能原因排查方法串口無輸出代碼沒燒錄成功檢查開發(fā)板選擇和端口初始化失敗接線錯誤或地址不對用I2C掃描程序找地址讀數(shù)一直是0模式命令沒發(fā)對確認發(fā)送了0x10或0x20讀數(shù)跳變嚴重電源不穩(wěn)或線太長縮短線長加濾波電容讀數(shù)明顯偏高傳感器被強光直射加柔光罩或改變安裝角度I2C掃描不到設(shè)備上拉電阻缺失檢查模塊是否有上拉I2C掃描程序很簡單幾行就能跑#include Wire.h void setup() { Serial.begin(115200); Wire.begin(21, 22); for (byte addr 1; addr 127; addr) { Wire.beginTransmission(addr); if (Wire.endTransmission() 0) { Serial.print(發(fā)現(xiàn)設(shè)備地址: 0x); Serial.println(addr, HEX); } } } void loop() {}跑一遍這個如果能看到0x23說明硬件連接沒問題問題在后面的代碼邏輯如果什么都掃不到那就是接線或者供電的問題。6.3 實操避坑經(jīng)驗第一個坑杜邦線質(zhì)量。我買過一批便宜的杜邦線插上去看著沒問題實際內(nèi)部斷芯時通時斷。表現(xiàn)就是串口數(shù)據(jù)偶爾正常偶爾報錯。后來換了好一點的線問題消失。所以如果你遇到莫名其妙的通信失敗先換線試試。第二個坑供電不足。有些ESP32開發(fā)板用USB供電時3.3V輸出能力有限如果同時接了OLED、溫濕度傳感器和GY-30可能出現(xiàn)電壓跌落。表現(xiàn)是GY-30讀數(shù)不穩(wěn)定或者初始化失敗。解決辦法是用外部3.3V穩(wěn)壓供電或者減少同時掛載的設(shè)備。第三個坑光照角度。BH1750FVI的感光面有方向性如果你把它裝在殼子里開孔太小或者角度不對讀數(shù)會明顯偏低。我建議安裝時讓感光面朝上或者朝向主要光源方向避免遮擋。第四個坑I2C地址沖突。如果你同時接了多個I2C設(shè)備一定要確認地址不重復(fù)。GY-30是0x23有些氣壓傳感器是0x76或0x77OLED是0x3C一般不會沖突但如果你用了地址可調(diào)的模塊就要仔細核對。7. 從讀數(shù)到應(yīng)用光照數(shù)據(jù)的進階用法7.1 自動調(diào)光與閾值控制讀到光照值之后最簡單的應(yīng)用就是做閾值控制。比如當光照低于100 lx時打開補光燈高于300 lx時關(guān)閉。代碼邏輯就是加一個if判斷if (lux 100) { digitalWrite(LED_PIN, HIGH); } else if (lux 300) { digitalWrite(LED_PIN, LOW); }這里要注意加一個遲滯區(qū)間避免在閾值附近來回抖動。比如開燈閾值設(shè)100關(guān)燈閾值設(shè)300中間200的區(qū)間就是遲滯。如果不加遲滯光照在100附近波動時燈會頻繁開關(guān)既影響壽命又看著難受。7.2 數(shù)據(jù)平滑與濾波處理原始讀數(shù)偶爾會有跳變尤其是電源不穩(wěn)或者光線突變時。我常用的方法是滑動平均濾波開一個數(shù)組存最近10次讀數(shù)每次取平均值輸出。這樣數(shù)據(jù)曲線會平滑很多代價是響應(yīng)速度稍微變慢。const int N 10; float buf[N]; int idx 0; float smooth(float newVal) { buf[idx] newVal; idx (idx 1) % N; float sum 0; for (int i 0; i N; i) sum buf[i]; return sum / N; }如果你想要更快的響應(yīng)可以用中值濾波取最近幾次讀數(shù)的中間值對脈沖干擾的抑制效果更好。7.3 接入物聯(lián)網(wǎng)平臺的思路光照數(shù)據(jù)上傳到本地服務(wù)器或者云平臺是很多人的下一步。ESP32自帶WiFi用HTTP或者MQTT協(xié)議都能發(fā)。我一般用MQTT因為數(shù)據(jù)量小、實時性好。流程是ESP32連WiFi連MQTT服務(wù)器每隔一段時間把lux值發(fā)布到指定主題服務(wù)器端訂閱后存數(shù)據(jù)庫或者展示在網(wǎng)頁上。這里不展開具體平臺的操作因為不同平臺配置差異大。核心思路就是采集-濾波-打包-發(fā)送。發(fā)送頻率不用太高光照變化本身是慢過程一分鐘發(fā)一次足夠了。發(fā)太快除了增加網(wǎng)絡(luò)負擔(dān)沒有實際意義。8. 我踩過的坑與最后分享的幾個技巧第一個技巧先用I2C掃描確認地址。不管你多自信接線沒問題跑一遍掃描程序只要幾秒鐘能省掉后面大量排查時間。我現(xiàn)在的習(xí)慣是任何I2C設(shè)備第一次上電先掃描再寫業(yè)務(wù)代碼。第二個技巧給GY-30加一個遮光罩。如果你發(fā)現(xiàn)讀數(shù)在室內(nèi)燈光下偏高可以用一段黑色熱縮管套在傳感器上只留頂部感光孔。這樣能減少側(cè)面雜散光的干擾讀數(shù)更接近實際環(huán)境照度。第三個技巧注意ESP32的I2C引腳可以重映射。默認是21和22但如果你這兩個引腳被其他外設(shè)占了可以在Wire.begin()里換成別的引腳比如Wire.begin(18, 19)。ESP32的IO矩陣幾乎支持任意引腳非常靈活。第四個技巧長時間運行要加看門狗。如果你把ESP32放在無人值守的環(huán)境里連續(xù)采集光照建議開啟硬件看門狗防止I2C總線死鎖導(dǎo)致程序卡死。Arduino核心里有esp_task_wdt相關(guān)接口配置一下就行。第五個技巧讀數(shù)單位統(tǒng)一。有些庫返回的是float有些返回uint16混用的時候注意類型轉(zhuǎn)換。我一般統(tǒng)一用float存lux值顯示和上傳都用這個避免整數(shù)除法丟精度。最后說一個我自己的體會GY-30這個模塊雖然簡單但它把I2C通信、傳感器數(shù)據(jù)讀取、參數(shù)換算這幾個嵌入式開發(fā)的核心環(huán)節(jié)都串起來了。你把它玩透后面換別的I2C傳感器比如溫濕度、氣壓、加速度計基本就是換個地址和命令字節(jié)的事。所以別急著跳過基礎(chǔ)把這一套流程走扎實后面學(xué)什么都快。