1. RT-Thread与BH1750的完美组合
第一次接触BH1750光照传感器时，我还在用裸机开发。当时为了调试IIC通讯，整整花了两天时间排查时序问题。后来接触到RT-Thread，发现它的软件包生态简直是为传感器开发量身定制的。就拿BH1750来说，官方提供的驱动包已经把底层通讯封装得相当完善，我们只需要关注业务逻辑就行。
RT-Thread最让我惊喜的是它的sensor框架。这个框架统一了各类传感器的接口，无论是光照传感器、温湿度传感器还是加速度计，在应用层都可以用相同的API来操作。比如要读取数据，统一调用rt_device_read()就行，不用再为每个传感器写特定的代码。
BH1750作为一款数字式环境光传感器，测量范围1-65535 lx，精度±20%，完全能满足大多数场景需求。它通过IIC接口通讯，地址通常是0x23（ADDR引脚接低电平）或0x5C（ADDR接高电平）。在RT-Thread下，我们甚至不需要关心这些细节，软件包已经帮我们处理好了。
2. 环境搭建与工程配置
2.1 开发环境准备
建议使用以下工具组合：
- Keil MDK 5.24+：我测试过5.24到5.37版本都兼容
- RT-Thread Env工具：这是RT-Thread的配置神器
- STM32CubeMX：用于初始化外设（可选）
第一次使用时最容易出问题的是Env工具的环境变量配置。记得把env.exe所在路径添加到系统PATH，否则在命令行输入menuconfig会提示找不到命令。我遇到过有同学因为这个问题卡了半天，最后发现是没重启电脑导致环境变量没生效。
2.2 创建RT-Thread工程
对于STM32F1系列，可以直接使用BSP模板：
# 在env中执行 scons --dist=bsp选择对应的BSP目录后，会生成完整的工程结构。这里有个小技巧：如果使用STM32F103C8T6这种Flash较小的芯片，记得在rtconfig.h中关闭不需要的组件，比如文件系统或网络协议栈。
2.3 添加BH1750软件包
在Env中操作非常简单：
menuconfig -> Hardware Drivers Config -> Sensor Drivers勾选BH1750后保存退出，然后执行pkgs --update下载软件包。
这里有个版本选择的门道：
- v1.0.0：纯驱动版本，适合需要精细控制的场景
- latest：集成sensor框架，推荐新手使用
我建议先用latest版本上手，等熟悉了再考虑是否需要自定义驱动。实测v2.0.0版本的初始化代码比v1.0.0少了近30%，这就是框架带来的优势。
3. 硬件连接与IIC配置
3.1 硬件连线方案
BH1750与STM32的连接只需要4根线：
| BH1750引脚 | STM32引脚 | 备注 |
|---|---|---|
| VCC | 3.3V | 注意不要接5V |
| GND | GND | 共地很重要 |
| SCL | PB6 | 可配置为其他引脚 |
| SDA | PB7 | 需与SCL同一IIC外设 |
曾经有个项目因为VCC接了5V，导致传感器工作不稳定，数据偶尔跳变。后来查手册才发现BH1750的供电范围是2.4V-3.6V，这个坑大家一定要避开。
3.2 IIC外设配置
在board.h中确认IIC引脚定义：
#define BSP_I2C1_SCL_PIN GET_PIN(B, 6) #define BSP_I2C1_SDA_PIN GET_PIN(B, 7)如果使用硬件IIC，需要在CubeMX中配置：
- 选择I2C1模式为I2C
- 时钟速度设为100kHz（BH1750最高支持400kHz）
- 启用I2C中断
更简单的做法是使用软件模拟IIC，在menuconfig中：
Hardware Drivers Config -> On-chip Peripheral Drivers -> Enable Soft I2C Bus软件IIC的优势是引脚可以任意配置，我在资源紧张的项目中经常用PC0和PC1这种非标准引脚做IIC。
4. 应用层开发实战
4.1 传感器初始化
使用sensor框架时的初始化代码：
#include <sensor.h> static rt_device_t light_sensor; void bh1750_init(void) { light_sensor = rt_device_find("li_bh1750"); if (light_sensor == RT_NULL) { rt_kprintf("BH1750 not found!\n"); return; } if (rt_device_open(light_sensor, RT_DEVICE_FLAG_RDONLY) != RT_EOK) { rt_kprintf("Open BH1750 failed!\n"); return; } }如果遇到初始化失败，建议按以下步骤排查：
- 用逻辑分析仪抓取IIC波形
- 检查上拉电阻（通常4.7KΩ）
- 确认供电电压在3.3V左右
4.2 数据读取与处理
创建专门的线程处理传感器数据：
static void bh1750_thread_entry(void *parameter) { struct rt_sensor_data data; rt_size_t res; while (1) { res = rt_device_read(light_sensor, 0, &data, 1); if (res == 1) { rt_kprintf("Light: %d lux\n", data.data.light); } rt_thread_mdelay(1000); // 1秒采样一次 } }对于光照数据，通常需要做滑动平均滤波：
#define FILTER_SIZE 5 static int filter_buf[FILTER_SIZE] = {0}; int filter_data(int new_data) { static int index = 0; int sum = 0; filter_buf[index++] = new_data; if (index >= FILTER_SIZE) index = 0; for (int i = 0; i < FILTER_SIZE; i++) { sum += filter_buf[i]; } return sum / FILTER_SIZE; }4.3 实际应用案例
在智能家居项目中，我这样实现自动调光：
void auto_brightness_control(void) { int light = get_light_level(); if (light > 500) { // 强光环境 set_led_brightness(30); } else if (light > 100) { // 正常光照 set_led_brightness(60); } else { // 弱光环境 set_led_brightness(100); } }这个逻辑虽然简单，但配合RT-Thread的定时器可以做得更智能。比如检测到光照持续低于阈值超过5分钟，才触发调光动作，避免短暂阴影导致频繁调节。
5. 常见问题与优化技巧
5.1 调试经验分享
最常遇到的三个问题：
- IIC无响应：检查引脚配置和上拉电阻，用万用表测量SCL/SDA电压，正常应在3.3V左右
- 数据异常：尝试降低IIC速率，BH1750对时序要求较严格
- 传感器不工作：确认电源电压，检查焊接是否良好
有个很隐蔽的坑：某些STM32的硬件IIC在频繁启停时会出现总线锁死。解决方法是在IIC初始化代码中加入超时重置逻辑：
if (I2C_GetFlagStatus(I2C1, I2C_FLAG_BUSY)) { I2C_GenerateSTOP(I2C1, ENABLE); // 其他恢复操作... }5.2 性能优化建议
- 采样周期优化：BH1750的高精度模式需要120ms测量时间，不要设置过短的采样间隔
- 低功耗处理：在电池供电场景下，调用
bh1750_power_down()进入休眠模式 - 多传感器协同：使用RT-Thread的
rt_sensor框架可以统一管理多个传感器
在最近的一个农业物联网项目中，我们通过优化采样策略，将系统功耗降低了40%：
- 光照变化缓慢时，采样间隔从1秒延长到10秒
- 使用
ONE_TIME_H_RES_MODE模式，测量完成后自动休眠 - 配合RTC唤醒功能实现间歇性工作
6. 进阶开发指导
对于需要更高精度的场景，可以考虑：
- 温度补偿：BH1750的输出受温度影响，可增加DS18B20进行补偿
- 多传感器融合：结合TSL2561等传感器提高测量范围
- 动态调整测量模式：根据环境亮度自动切换高低量程
一个实用的自动量程切换实现：
void auto_range_switch(void) { int light = get_light_level(); if (light > 10000) { bh1750_set_mode(CONTINUOUS_H_RES_MODE2); // 低分辨率模式 } else { bh1750_set_mode(CONTINUOUS_H_RES_MODE); // 高分辨率模式 } }最后分享一个真实案例：在某智慧教室项目中，我们使用F407+RT-Thread+4个BH1750实现了教室光照均匀度检测。通过sensor框架同时管理多个传感器，代码量比裸机开发减少了60%，后期维护也方便很多。
