用STM32F103C8T6做个智能光控小夜灯：BH1750传感器+OLED显示+蜂鸣器提醒（附完整代码）

基于STM32F103的智能光控夜灯开发实战：从传感器到完整功能实现

深夜起床时刺眼的顶灯总是让人不适？这款自制的智能光控夜灯或许能解决这个问题。它不仅能根据环境光线自动调节亮度，还能在光线过暗时发出蜂鸣提醒，特别适合卧室、走廊等场景。下面我将详细介绍如何用STM32F103C8T6开发板搭配BH1750光感模块、OLED显示屏和蜂鸣器，打造一个实用又智能的小夜灯。

1. 项目规划与硬件选型

在开始动手前，我们需要明确项目的功能需求和选择合适的硬件组件。这个智能夜灯需要实现以下核心功能：

• 环境光检测：实时监测周围光线强度
• 自动亮度调节：根据环境光自动调整LED亮度
• 视觉反馈：通过OLED显示当前光强数值
• 声音提醒：在光线过暗时触发蜂鸣器报警
• 调试接口：通过串口输出传感器数据

硬件选型对比表：

选择STM32F103C8T6是因为它性价比高且资源丰富，BH1750传感器则因其高精度和简单易用脱颖而出。OLED显示屏相比LCD更省电且显示效果更好，特别适合这种低功耗应用。

2. 硬件连接与电路设计

正确的硬件连接是项目成功的基础。下面是各模块与STM32的接线方式：

核心接线清单：

• BH1750传感器：
  • VCC → 3.3V
  • GND → GND
  • SCL → PB6
  • SDA → PB7
• OLED显示屏：
  • VCC → 3.3V
  • GND → GND
  • SCL → PB6(与BH1750共用)
  • SDA → PB7(与BH1750共用)
• 蜂鸣器：
  • VCC → 5V
  • GND → GND
  • I/O → PA0
• LED灯带：
  • VCC → 5V
  • GND → GND
  • DIN → PA1

注意：I2C设备需要上拉电阻，通常4.7KΩ即可。如果模块本身已集成上拉电阻，则无需额外添加。

电路设计时需要考虑以下几点：

1. 电源部分：STM32开发板通常有稳压电路，可以直接从USB取电
2. 信号电平：BH1750和OLED都是3.3V器件，与STM32电平兼容
3. 布线整洁：使用杜邦线连接时，尽量按功能分组捆扎，避免杂乱

3. 软件开发环境搭建

在开始编码前，需要准备好开发环境。我推荐使用以下工具链：

开发工具清单：

• IDE：Keil MDK 或 PlatformIO
• 编译器：ARM-GCC
• 调试工具：ST-Link V2
• 串口工具：Putty或Tera Term

安装步骤概要：

1. 下载并安装Keil MDK
2. 安装STM32F1系列器件支持包
3. 配置ST-Link调试器驱动
4. 准备串口调试终端

关键库文件准备：

#include "stm32f10x.h" #include "bh1750.h" #include "ssd1306.h" #include "delay.h"

项目目录结构建议：

/project /CMSIS // 内核支持文件 /Drivers // 外设驱动 /Middlewares // 中间件 /Src // 主程序源文件 /Inc // 头文件 /Utilities // 工具类

4. 核心功能实现与代码解析

4.1 BH1750光感数据采集

BH1750通过I2C接口通信，我们需要先初始化I2C外设：

void I2C_Configuration(void) { GPIO_InitTypeDef GPIO_InitStructure; I2C_InitTypeDef I2C_InitStructure; // 使能时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); // 配置GPIO GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_OD; GPIO_Init(GPIOB, &GPIO_InitStructure); // 配置I2C I2C_InitStructure.I2C_Mode = I2C_Mode_I2C; I2C_InitStructure.I2C_DutyCycle = I2C_DutyCycle_2; I2C_InitStructure.I2C_OwnAddress1 = 0x00; I2C_InitStructure.I2C_Ack = I2C_Ack_Enable; I2C_InitStructure.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; I2C_InitStructure.I2C_ClockSpeed = 100000; // 100kHz I2C_Init(I2C1, &I2C_InitStructure); I2C_Cmd(I2C1, ENABLE); }

读取光照强度的核心函数：

float BH1750_ReadLightIntensity(void) { uint8_t buffer[2]; uint16_t value = 0; float lux = 0.0; // 发送测量命令 I2C_WriteByte(BH1750_ADDRESS, BH1750_ONE_TIME_H_RESOLUTION_MODE); Delay_ms(180); // 等待转换完成 // 读取数据 I2C_ReadBytes(BH1750_ADDRESS, buffer, 2); value = (buffer[0] << 8) | buffer[1]; lux = value / 1.2; // 转换为lux单位 return lux; }

4.2 OLED显示界面设计

OLED显示需要先初始化，然后定期刷新：

void OLED_Init(void) { SSD1306_Init(); SSD1306_Clear(); SSD1306_SetCursor(0, 0); SSD1306_PrintString("Light Control", Font_11x18, White); SSD1306_UpdateScreen(); } void OLED_UpdateDisplay(float lux) { char buffer[20]; SSD1306_SetCursor(0, 30); sprintf(buffer, "Lux: %.2f", lux); SSD1306_PrintString(buffer, Font_7x10, White); SSD1306_SetCursor(0, 45); if(lux < 10) { SSD1306_PrintString("Status: Dark", Font_7x10, White); } else if(lux < 100) { SSD1306_PrintString("Status: Normal", Font_7x10, White); } else { SSD1306_PrintString("Status: Bright", Font_7x10, White); } SSD1306_UpdateScreen(); }

4.3 蜂鸣器报警逻辑

蜂鸣器控制相对简单，但需要注意不要长时间连续鸣叫：

void Buzzer_Alert(float lux) { static uint32_t lastAlertTime = 0; if(lux < 5.0) { // 光线过暗 if(HAL_GetTick() - lastAlertTime > 2000) { // 每2秒提醒一次 GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_SET); Delay_ms(100); GPIO_WriteBit(GPIOA, GPIO_Pin_0, Bit_RESET); lastAlertTime = HAL_GetTick(); } } }

4.4 主程序逻辑整合

将各个模块整合到主循环中：

int main(void) { float lightIntensity = 0; // 硬件初始化 SystemInit(); Delay_Init(); I2C_Configuration(); BH1750_Init(); OLED_Init(); Buzzer_Init(); LED_Init(); USART_Init(115200); while(1) { // 读取光照强度 lightIntensity = BH1750_ReadLightIntensity(); // 更新显示 OLED_UpdateDisplay(lightIntensity); // 控制蜂鸣器 Buzzer_Alert(lightIntensity); // 调节LED亮度 LED_SetBrightness(lightIntensity); // 串口输出调试信息 printf("Current Light: %.2f lux\r\n", lightIntensity); Delay_ms(500); // 每500ms更新一次 } }

5. 功能优化与扩展

基础功能实现后，我们可以考虑以下优化方向：

性能优化点：

1. 增加光强变化平滑处理，避免数值跳动
2. 实现自适应采样频率，在光线稳定时降低采样率
3. 添加低功耗模式，在夜间固定时段进入睡眠

功能扩展建议：

• 增加WiFi/蓝牙模块，实现手机远程控制
• 添加人体感应功能，无人时自动关闭
• 实现光强数据记录和统计功能
• 增加多种灯光模式（阅读模式、夜灯模式等）

一个实用的优化示例 - 光强平滑算法：

#define SAMPLE_SIZE 5 float SmoothLightIntensity(void) { static float samples[SAMPLE_SIZE] = {0}; static uint8_t index = 0; float sum = 0.0; // 获取新样本 samples[index] = BH1750_ReadLightIntensity(); index = (index + 1) % SAMPLE_SIZE; // 计算移动平均 for(uint8_t i = 0; i < SAMPLE_SIZE; i++) { sum += samples[i]; } return sum / SAMPLE_SIZE; }

6. 常见问题排查

在开发过程中可能会遇到以下典型问题：

I2C通信失败：

1. 检查接线是否正确，特别是SCL/SDA不要接反
2. 确认上拉电阻是否正常工作（通常4.7KΩ）
3. 用逻辑分析仪抓取I2C波形，检查时序

OLED显示异常：

• 现象：屏幕全白或全黑
  • 检查复位信号是否正确
  • 确认初始化序列完整
  • 尝试降低I2C时钟速度

BH1750读数不稳定：

• 可能原因：
  • 电源噪声干扰
  • 环境光快速变化
  • 传感器被遮挡
• 解决方案：
  • 增加电源滤波电容
  • 软件端增加平滑滤波
  • 确保传感器暴露在检测环境中

蜂鸣器不响：

1. 确认是有源蜂鸣器（只需电平触发）
2. 检查驱动三极管是否正常工作
3. 测量蜂鸣器两端是否有电压变化

7. 项目部署与实际应用

完成开发和测试后，可以考虑将项目部署到实际环境中：

外壳选择建议：

• 3D打印定制外壳
• 使用现成的塑料防水盒改装
• 亚克力激光切割制作

安装位置考量：

• 避免阳光直射影响光感准确性
• 确保LED光线不会直接照射到BH1750
• 选择儿童和宠物不易触碰的位置

参数校准方法：

1. 在完全黑暗环境中读取传感器值作为零点
2. 在已知光照条件下（如100lux）记录传感器读数
3. 根据实际测量值调整校准系数

实际使用中我发现，将夜灯安装在床头柜上方约1.5米处效果最佳，既能提供足够的照明，又不会影响睡眠。LED灯带最好向下照射，避免直射眼睛。