STM32F103C8T6驱动BH1750光照传感器实战指南刚拿到STM32开发板和BH1750传感器时很多初学者会面临这样的困惑如何正确连接硬件为什么我的代码读取不到数据光照强度的单位lx到底代表什么本文将用最直接的方式带你从零开始完成整个项目。1. 硬件连接与准备工作1.1 认识你的硬件设备BH1750传感器模块通常有4个引脚VCC3.3V-5V供电GND接地SCLI2C时钟线SDAI2C数据线ADDR地址选择引脚可选STM32F103C8T6最小系统板蓝板的GPIO资源推荐使用PB6(SCL)和PB7(SDA)这是STM32的硬件I2C1接口也可用任意GPIO模拟I2C本文以PC5(SCL)和PD2(SDA)为例1.2 接线示意图BH1750引脚STM32连接方式VCC3.3VGNDGNDSCLPC5SDAPD2ADDR悬空或接地注意ADDR引脚悬空时器件地址为0x23接VCC时为0x5C。建议初次使用时保持悬空。1.3 所需工具清单STM32F103C8T6开发板 ×1BH1750传感器模块 ×1杜邦线若干USB转TTL模块用于串口调试Keil MDK或STM32CubeIDE开发环境2. 软件环境搭建2.1 工程创建基础使用STM32CubeMX快速配置工程选择STM32F103C8系列开启GPIOPC5推挽输出SCLPD2推挽输出SDA配置USART1用于调试输出115200波特率生成Keil或IAR工程关键配置参数// GPIO初始化代码示例 GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOC_CLK_ENABLE(); __HAL_RCC_GPIOD_CLK_ENABLE(); // SCL配置 (PC5) GPIO_InitStruct.Pin GPIO_PIN_5; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOC, GPIO_InitStruct); // SDA配置 (PD2) GPIO_InitStruct.Pin GPIO_PIN_2; HAL_GPIO_Init(GPIOD, GPIO_InitStruct);2.2 驱动代码移植创建bh1750.c和bh1750.h文件核心函数包括I2C起始/停止信号生成字节读写函数传感器初始化数据读取函数典型错误排查确保所有GPIO时钟已开启检查接线是否正确特别是电源用逻辑分析仪抓取I2C波形可选3. 传感器驱动实现细节3.1 I2C时序精准控制软件模拟I2C的关键时序void I2C_Start(void) { SDA_HIGH(); SCL_HIGH(); Delay_us(5); SDA_LOW(); Delay_us(5); SCL_LOW(); } void I2C_Stop(void) { SDA_LOW(); SCL_HIGH(); Delay_us(5); SDA_HIGH(); Delay_us(5); }时序参数建议操作延时时间起始条件5μs停止条件5μs数据建立2μs时钟高电平4μs3.2 BH1750工作模式选择传感器支持多种测量模式高分辨率模式1 (0x10): 1lx精度120ms高分辨率模式2 (0x11): 0.5lx精度120ms低分辨率模式 (0x13): 4lx精度16ms模式设置代码示例void BH1750_SetMode(uint8_t mode) { I2C_Start(); I2C_WriteByte(0x23 1); // 器件地址写 I2C_WaitAck(); I2C_WriteByte(mode); I2C_WaitAck(); I2C_Stop(); }3.3 数据读取与处理光照强度计算公式实际光照(lx) 原始数据 / 1.2数据读取流程发送启动测量命令等待足够测量时间根据模式不同读取两个字节数据合并为16位数值转换为实际光照强度float BH1750_ReadLight(void) { uint8_t buf[2]; uint16_t val 0; // 启动测量 BH1750_SetMode(BH1750_MODE_HR1); Delay_ms(180); // 等待测量完成 // 读取数据 I2C_Start(); I2C_WriteByte(0x23 1 | 0x01); // 器件地址读 I2C_WaitAck(); buf[0] I2C_ReadByte(1); // 读高字节 buf[1] I2C_ReadByte(0); // 读低字节 I2C_Stop(); val (buf[0] 8) | buf[1]; return val / 1.2f; }4. 数据可视化与优化4.1 串口输出调试通过printf输出光照数据printf(当前光照强度: %.2f lx\r\n, BH1750_ReadLight());串口输出示例[BH1750] 初始化完成 [BH1750] 当前模式: 高分辨率模式1 [BH1750] 光照强度: 358.42 lx [BH1750] 光照强度: 362.15 lx4.2 OLED显示实现SSD1306 OLED显示代码片段void OLED_ShowLight(float lux) { char str[20]; sprintf(str, Light:%.1flx, lux); OLED_ShowString(0, 2, str, 16); }显示效果优化建议添加光照等级提示如太暗/舒适/太亮实现历史数据曲线显示添加单位自动转换lx/fc4.3 实际应用场景扩展基于光照数据的应用示例自动调光LED灯智能窗帘控制系统植物生长监测室内环境质量评估典型光照参考值环境场景典型光照范围(lx)晴天室外10,000-100,000阴天室外1,000-10,000明亮办公室300-500家庭起居室100-300月光下的环境0.1-0.3在完成基础功能后可以尝试将采样间隔设置为30秒连续记录24小时的光照变化观察不同时段的光照规律。实际测试中发现传感器在快速变化的光照环境下需要3-4次采样才能稳定到新值这在设计实时系统时需要特别注意。
STM32F103C8T6驱动BH1750光照传感器，从接线到数据读取的保姆级教程
发布时间：2026/6/2 22:52:57
STM32F103C8T6驱动BH1750光照传感器实战指南刚拿到STM32开发板和BH1750传感器时很多初学者会面临这样的困惑如何正确连接硬件为什么我的代码读取不到数据光照强度的单位lx到底代表什么本文将用最直接的方式带你从零开始完成整个项目。1. 硬件连接与准备工作1.1 认识你的硬件设备BH1750传感器模块通常有4个引脚VCC3.3V-5V供电GND接地SCLI2C时钟线SDAI2C数据线ADDR地址选择引脚可选STM32F103C8T6最小系统板蓝板的GPIO资源推荐使用PB6(SCL)和PB7(SDA)这是STM32的硬件I2C1接口也可用任意GPIO模拟I2C本文以PC5(SCL)和PD2(SDA)为例1.2 接线示意图BH1750引脚STM32连接方式VCC3.3VGNDGNDSCLPC5SDAPD2ADDR悬空或接地注意ADDR引脚悬空时器件地址为0x23接VCC时为0x5C。建议初次使用时保持悬空。1.3 所需工具清单STM32F103C8T6开发板 ×1BH1750传感器模块 ×1杜邦线若干USB转TTL模块用于串口调试Keil MDK或STM32CubeIDE开发环境2. 软件环境搭建2.1 工程创建基础使用STM32CubeMX快速配置工程选择STM32F103C8系列开启GPIOPC5推挽输出SCLPD2推挽输出SDA配置USART1用于调试输出115200波特率生成Keil或IAR工程关键配置参数// GPIO初始化代码示例 GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOC_CLK_ENABLE(); __HAL_RCC_GPIOD_CLK_ENABLE(); // SCL配置 (PC5) GPIO_InitStruct.Pin GPIO_PIN_5; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOC, GPIO_InitStruct); // SDA配置 (PD2) GPIO_InitStruct.Pin GPIO_PIN_2; HAL_GPIO_Init(GPIOD, GPIO_InitStruct);2.2 驱动代码移植创建bh1750.c和bh1750.h文件核心函数包括I2C起始/停止信号生成字节读写函数传感器初始化数据读取函数典型错误排查确保所有GPIO时钟已开启检查接线是否正确特别是电源用逻辑分析仪抓取I2C波形可选3. 传感器驱动实现细节3.1 I2C时序精准控制软件模拟I2C的关键时序void I2C_Start(void) { SDA_HIGH(); SCL_HIGH(); Delay_us(5); SDA_LOW(); Delay_us(5); SCL_LOW(); } void I2C_Stop(void) { SDA_LOW(); SCL_HIGH(); Delay_us(5); SDA_HIGH(); Delay_us(5); }时序参数建议操作延时时间起始条件5μs停止条件5μs数据建立2μs时钟高电平4μs3.2 BH1750工作模式选择传感器支持多种测量模式高分辨率模式1 (0x10): 1lx精度120ms高分辨率模式2 (0x11): 0.5lx精度120ms低分辨率模式 (0x13): 4lx精度16ms模式设置代码示例void BH1750_SetMode(uint8_t mode) { I2C_Start(); I2C_WriteByte(0x23 1); // 器件地址写 I2C_WaitAck(); I2C_WriteByte(mode); I2C_WaitAck(); I2C_Stop(); }3.3 数据读取与处理光照强度计算公式实际光照(lx) 原始数据 / 1.2数据读取流程发送启动测量命令等待足够测量时间根据模式不同读取两个字节数据合并为16位数值转换为实际光照强度float BH1750_ReadLight(void) { uint8_t buf[2]; uint16_t val 0; // 启动测量 BH1750_SetMode(BH1750_MODE_HR1); Delay_ms(180); // 等待测量完成 // 读取数据 I2C_Start(); I2C_WriteByte(0x23 1 | 0x01); // 器件地址读 I2C_WaitAck(); buf[0] I2C_ReadByte(1); // 读高字节 buf[1] I2C_ReadByte(0); // 读低字节 I2C_Stop(); val (buf[0] 8) | buf[1]; return val / 1.2f; }4. 数据可视化与优化4.1 串口输出调试通过printf输出光照数据printf(当前光照强度: %.2f lx\r\n, BH1750_ReadLight());串口输出示例[BH1750] 初始化完成 [BH1750] 当前模式: 高分辨率模式1 [BH1750] 光照强度: 358.42 lx [BH1750] 光照强度: 362.15 lx4.2 OLED显示实现SSD1306 OLED显示代码片段void OLED_ShowLight(float lux) { char str[20]; sprintf(str, Light:%.1flx, lux); OLED_ShowString(0, 2, str, 16); }显示效果优化建议添加光照等级提示如太暗/舒适/太亮实现历史数据曲线显示添加单位自动转换lx/fc4.3 实际应用场景扩展基于光照数据的应用示例自动调光LED灯智能窗帘控制系统植物生长监测室内环境质量评估典型光照参考值环境场景典型光照范围(lx)晴天室外10,000-100,000阴天室外1,000-10,000明亮办公室300-500家庭起居室100-300月光下的环境0.1-0.3在完成基础功能后可以尝试将采样间隔设置为30秒连续记录24小时的光照变化观察不同时段的光照规律。实际测试中发现传感器在快速变化的光照环境下需要3-4次采样才能稳定到新值这在设计实时系统时需要特别注意。
