在嵌入式系統開發中，環境光照度的監測是一個常見需求，廣泛應用于智能家居、農業物聯網和工業自動化等領域。STM32微控制器憑借其高性能和豐富的外設資源，成為實現此類功能的理想選擇。本教程將詳細介紹如何利用STM32CubeMX圖形化配置工具，快速搭建硬件I2C通信框架，并讀取光照度傳感器（如BH1750）的數據。本指南源于涂鴉開發者社區及電子技術論壇的實踐經驗，旨在為計算機軟硬件技術開發者提供一份清晰、可操作的超級干貨。

一、開發環境與硬件準備

1. 核心硬件：

• 一款STM32系列開發板（如STM32F103C8T6）。

• 光照度傳感器模塊（推薦BH1750，它支持I2C接口，量程0-65535 lux，精度高）。

• 杜邦線若干，用于連接開發板與傳感器。

1. 軟件工具：

• STM32CubeMX：用于初始化配置和代碼生成。

• IDE：Keil MDK或STM32CubeIDE，用于編寫和調試代碼。

• 串口調試助手：用于查看輸出數據。

二、STM32CubeMX項目配置步驟

1. 創建新項目：打開STM32CubeMX，選擇對應的STM32型號，并創建一個新工程。

1. 配置系統時鐘：在“Clock Configuration”選項卡中，根據開發板外部晶振頻率設置系統時鐘（例如，使用8MHz外部晶振，通過PLL倍頻至72MHz）。

1. 啟用硬件I2C：

• 在“Pinout & Configuration”界面，找到“Connectivity”下的I2C模塊（如I2C1）。

• 將I2C模式設置為“I2C”，并配置SCL和SDA引腳（通常自動分配，如PB6和PB7）。

• 在參數設置中，調整I2C速度為標準模式（100kHz）或快速模式（400kHz），根據傳感器規格選擇。

1. 配置串口用于調試：啟用一個USART模塊（如USART1），設置波特率為115200，以便通過串口打印傳感器數據。

1. 生成代碼：點擊“Project Manager”，設置項目名稱、路徑和IDE類型，然后生成代碼。STM32CubeMX將自動生成初始化代碼，包括I2C和USART的HAL庫驅動。

三、代碼實現與傳感器讀取

1. 編寫BH1750驅動函數：在生成的工程中，添加傳感器操作代碼。BH1750的I2C地址通常為0x23（或0x5C），支持連續測量模式。示例代碼如下：

`c // 發送命令函數 void BH1750SendCmd(uint8_t cmd) { HALI2CMasterTransmit(&hi2c1, BH1750ADDR, &cmd, 1, HALMAXDELAY); }

// 讀取光照度數據
float BH1750ReadLight(void) {
uint8t data[2];
float lux;
HALI2CMasterReceive(&hi2c1, BH1750ADDR, data, 2, HALMAX_DELAY);
lux = (data[0] << 8 | data[1]) / 1.2; // 根據傳感器公式計算
return lux;
}
`

1. 初始化傳感器：在main函數中，調用BH1750SendCmd(0x10)設置為連續高分辨率模式。

1. 主循環數據讀取：在while循環中，定期讀取數據并通過串口輸出：

while (1) {
float light = BH1750ReadLight();
printf("Light Intensity: %.2f lux\r\n", light);
HAL_Delay(1000); // 每秒讀取一次
}

四、調試與優化建議

1. 硬件連接檢查：確保I2C線路連接正確，SCL和SDA引腳需加上拉電阻（通常模塊已集成）。

1. 錯誤處理：在實際應用中，添加HAL_I2C函數的返回值檢查，以處理通信失敗情況。

1. 低功耗考慮：對于電池供電設備，可在空閑時切換傳感器到休眠模式，并通過中斷喚醒。

1. 數據濾波：為減少噪聲，可采用滑動平均或中值濾波算法處理原始數據。

五、擴展應用

本教程為基礎實現，開發者可進一步將數據上傳至云平臺（如涂鴉IoT平臺），構建完整的智能光照監測系統。結合其他傳感器（溫濕度、人體感應），可實現更復雜的自動化場景，這正是電子技術論壇中廣受歡迎的開發方向。

通過STM32CubeMX的圖形化配置，開發者能快速上手硬件I2C，避免底層寄存器操作的繁瑣。希望這份干貨教程能幫助您在嵌入式開發中高效實現光照度讀取功能，并激發更多創新應用！