用STM32CubeMX快速配置BH1750光照传感器，OLED实时显示并串口打印数据（附完整工程）

STM32CubeMX实战：BH1750光照数据采集与OLED动态显示系统

1. 项目概述与环境搭建

在智能家居和工业监测领域，光照强度检测是一个基础但关键的功能需求。BH1750作为一款数字式环境光传感器，以其高精度和简单接口受到开发者青睐。传统开发方式需要手动配置大量底层寄存器，而STM32CubeMX工具的出现彻底改变了这一局面。

硬件准备清单：

• STM32F103C8T6核心板（Blue Pill）
• BH1750光照传感器模块（I2C接口）
• 0.96寸OLED显示屏（SSD1306驱动）
• USB转TTL串口模块
• 杜邦线若干

提示：所有模块建议选择3.3V工作电压版本，若使用5V模块需注意电平转换

开发环境配置步骤：

1. 安装STM32CubeMX最新版（当前为6.6.1）
2. 安装对应IDE（Keil MDK或STM32CubeIDE）
3. 准备串口调试工具（如Putty或Serial Monitor）

2. CubeMX工程配置详解

2.1 时钟树配置

启动CubeMX后，选择STM32F103C8型号，首先配置时钟源：

• HSE选择Crystal/Ceramic Resonator
• 在Clock Configuration标签页设置系统时钟为72MHz

// 生成的时钟初始化代码片段 RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1; RCC_OscInitStruct.HSIState = RCC_HSI_ON; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;

2.2 I2C外设配置

由于BH1750和OLED共用I2C总线，需要特别注意地址冲突问题：

1. 在Connectivity下启用I2C1
2. 模式选择I2C
3. 参数保持默认（100kHz标准模式）
4. 在NVIC Settings中启用中断（可选）

关键参数对比表：

2.3 USART配置

为实时监控数据，配置USART1：

• 波特率：115200
• 字长：8位
• 停止位：1
• 无校验位

// 串口重定向代码示例 int __io_putchar(int ch) { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY); return ch; }

3. 传感器驱动开发

3.1 BH1750驱动实现

BH1750支持三种测量模式，通过不同指令码选择：

驱动核心函数：

#define BH1750_ADDR 0x23 << 1 void BH1750_Init(I2C_HandleTypeDef *hi2c) { uint8_t cmd = 0x01; // 电源开启 HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR, &cmd, 1, 100); cmd = 0x10; // 连续H分辨率模式 HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR, &cmd, 1, 100); } float BH1750_ReadLux(I2C_HandleTypeDef *hi2c) { uint8_t data[2]; HAL_I2C_Master_Receive(hi2c, BH1750_ADDR, data, 2, 100); uint16_t raw = (data[0] << 8) | data[1]; return raw / 1.2f; // 转换为lux值 }

3.2 OLED显示优化

使用u8g2库驱动SSD1306显示屏，实现动态刷新：

U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0); void OLED_Init() { u8g2.begin(); u8g2.setFont(u8g2_font_ncenB08_tr); u8g2.setContrast(255); } void OLED_Update(float lux) { char buf[20]; u8g2.clearBuffer(); u8g2.drawStr(0, 15, "Light Sensor"); sprintf(buf, "Lux: %.2f", lux); u8g2.drawStr(0, 35, buf); // 添加动态进度条 uint8_t width = map(lux, 0, 1000, 0, 128); u8g2.drawBox(0, 50, width, 10); u8g2.sendBuffer(); }

4. 系统集成与调试

4.1 主程序逻辑设计

构建状态机架构，实现数据采集、显示和串口输出的协同工作：

typedef enum { STATE_MEASURE, STATE_DISPLAY, STATE_SERIAL_OUT } SystemState; void main() { // 初始化代码... SystemState state = STATE_MEASURE; float lux_values[10]; uint8_t index = 0; while(1) { switch(state) { case STATE_MEASURE: lux_values[index] = BH1750_ReadLux(&hi2c1); index = (index + 1) % 10; state = STATE_DISPLAY; break; case STATE_DISPLAY: OLED_Update(lux_values[(index+9)%10]); state = STATE_SERIAL_OUT; break; case STATE_SERIAL_OUT: printf("Lux: %.2f\r\n", lux_values[(index+9)%10]); state = STATE_MEASURE; HAL_Delay(500); break; } } }

4.2 常见问题排查

I2C通信失败排查步骤：

1. 用逻辑分析仪检查SCL/SDA信号
2. 确认上拉电阻（通常4.7kΩ）已连接
3. 验证设备地址是否正确
4. 检查电源稳定性

性能优化技巧：

• 将I2C时钟提升至400kHz（快速模式）
• 使用DMA传输减少CPU占用
• 实现双缓冲机制避免显示闪烁

5. 功能扩展与进阶应用

5.1 数据持久化存储

添加SPI Flash存储历史数据：

#define FLASH_PAGE_SIZE 256 void SaveToFlash(uint32_t addr, float *data, uint8_t count) { HAL_FLASH_Unlock(); FLASH_EraseInitTypeDef erase; erase.TypeErase = FLASH_TYPEERASE_PAGES; erase.PageAddress = addr; erase.NbPages = 1; uint32_t error; HAL_FLASHEx_Erase(&erase, &error); uint64_t *p = (uint64_t*)data; for(int i=0; i<count*sizeof(float)/8; i++) { HAL_FLASH_Program(FLASH_TYPEPROGRAM_DOUBLEWORD, addr + i*8, p[i]); } HAL_FLASH_Lock(); }

5.2 无线传输集成

通过ESP-01模块实现WiFi数据传输：

void ESP_SendData(float lux) { char cmd[64]; sprintf(cmd, "AT+CIPSEND=%d\r\n", strlen(data)); HAL_UART_Transmit(&huart2, (uint8_t*)cmd, strlen(cmd), 100); sprintf(cmd, "lux=%.2f\r\n", lux); HAL_UART_Transmit(&huart2, (uint8_t*)cmd, strlen(cmd), 100); }

5.3 蜂鸣器报警功能

根据光照阈值触发蜂鸣器：

#define LUX_THRESHOLD 500 void CheckAlarm(float lux) { static uint8_t alarm_state = 0; if(lux > LUX_THRESHOLD && !alarm_state) { HAL_GPIO_WritePin(BUZZER_GPIO_Port, BUZZER_Pin, GPIO_PIN_SET); alarm_state = 1; } else if(lux <= LUX_THRESHOLD && alarm_state) { HAL_GPIO_WritePin(BUZZER_GPIO_Port, BUZZER_Pin, GPIO_PIN_RESET); alarm_state = 0; } }