ESP32-S3驱动ROHM BH1750FVI光照传感器I2C通信与高精度光照采集实战最近在做一个智能农业大棚的环境监测项目需要实时采集光照数据。选来选去最终用了ROHM原装的BH1750FVI光照传感器。这玩意儿精度高、接口简单用I2C总线就能直接读取数字光照值非常适合ESP32-S3这种带Wi-Fi的物联网MCU。今天我就把整个驱动过程从硬件连接到软件代码手把手地分享给大家帮你快速搞定高精度光照采集。1. 认识我们的主角BH1750FVI传感器在动手接线写代码之前咱们先花几分钟了解一下BH1750FVI到底是个啥以及它为啥好用。BH1750FVI是ROHM公司生产的一款数字式环境光传感器。它最大的特点就是“省心”——内部集成了16位的模数转换器ADC直接把光照强度转换成数字信号输出我们单片机拿到手的就是一个0到65535之间的数字省去了外部ADC和复杂校准的麻烦。它的核心参数我整理成了下面这个表格一目了然参数规格/说明工作电压3.3V - 5V (和ESP32-S3的3.3V完美匹配)工作电流约200uA (非常省电)测量范围1 - 65535 lx (勒克斯光照度单位)输出方式I2C数字接口引脚数量5 Pin通信协议标准NXP I2C协议特点内置ADC直接数字输出光谱特性接近人眼视觉灵敏度提示勒克斯lx是光照度的单位。简单理解白天室内的光照度大概在100-1000 lx而晴朗的户外中午可能超过10000 lx。BH1750的65535 lx量程完全覆盖了日常应用场景。传感器模块通常有5个引脚VCC电源、GND地、SCLI2C时钟线、SDAI2C数据线和ADDR地址选择线。ADDR引脚的电平决定了传感器的I2C设备地址这个后面配置代码时会用到。2. 硬件连接把传感器接到ESP32-S3上接线是第一步也是最容易出错的一步。ESP32-S3的I2C接口引脚是灵活的我们可以自己定义。为了演示方便我这里假设使用GPIO1作为SCLGPIO2作为SDA。你可以根据自己板子的实际情况调整。准备好你的ESP32-S3开发板和BH1750模块按照下表连接ESP32-S3引脚BH1750模块引脚连接线说明3.3VVCC电源正极给传感器供电GNDGND电源地共地非常重要GPIO1SCLI2C时钟信号线GPIO2SDAI2C数据信号线(不接或接GND)ADDR地址选择。接GND时地址为0x23接VCC时为0x5C。我们代码里按接GND来写(0x46是7位地址左移一位后的写地址)。注意I2C总线需要上拉电阻。如果你的传感器模块上没有集成通常4.7KΩ或10KΩ的上拉电阻你需要在ESP32-S3的SCL和SDA引脚上分别连接到3.3V的上拉电阻。很多开发板已经内置了如果通信不稳定首先检查这里。连接好之后硬件部分就搞定了是不是很简单接下来就是重头戏——软件驱动。3. 软件驱动手把手编写I2C底层代码很多朋友喜欢直接用Arduino的Wire库或者ESP-IDF的i2c_master驱动这当然方便。但为了让大家彻底理解I2C通信的时序咱们这次用GPIO模拟I2C也叫“软件I2C”的方式来驱动。这样即使换到没有硬件I2C外设的单片机上你也能轻松移植。我们的代码工程需要两个核心文件bsp_bh1750.c源文件和bsp_bh1750.h头文件。3.1 头文件定义与宏配置先来看头文件bsp_bh1750.h。这里主要完成三件事包含必要的系统头文件、定义我们使用的引脚、声明所有要用到的函数。#ifndef _BSP_BH1750_H_ #define _BSP_BH1750_H_ #include stdio.h #include inttypes.h #include driver/gpio.h #include freertos/FreeRTOS.h #include freertos/task.h #include esp_rom_sys.h // 1. 引脚定义根据你的实际接线修改这里 #define BH1750_SCL_PIN 1 // I2C时钟线接在GPIO1 #define BH1750_SDA_PIN 2 // I2C数据线接在GPIO2 // 2. 引脚操作宏定义让代码更清晰 #define SDA_OUT() gpio_set_direction(BH1750_SDA_PIN, GPIO_MODE_OUTPUT) #define SDA_IN() gpio_set_direction(BH1750_SDA_PIN, GPIO_MODE_INPUT) #define SDA_GET() gpio_get_level(BH1750_SDA_PIN) #define SDA(x) gpio_set_level(BH1750_SDA_PIN, (x?1:0)) #define SCL(x) gpio_set_level(BH1750_SCL_PIN, (x?1:0)) // 3. 传感器I2C地址 (7位地址为0x23左移一位后写地址为0x46读地址为0x47) #define SlaveAddress 0x46 // 4. 函数声明 void GY30_Init(void); char Single_Write_BH1750(uint8_t REG_Address); float Multiple_read_BH1750(void); void delay_us(unsigned int us); void delay_ms(unsigned int ms); #endif代码解释第9-10行这是你需要根据实际接线修改的地方。如果SCL接GPIO10SDA接GPIO11就把1和2改成10和11。第13-17行定义了控制SDA引脚输入输出模式、读取电平和设置电平的宏后面写时序代码时非常简洁。第20行SlaveAddress是传感器的I2C写地址。BH1750的7位设备地址是0x23ADDR引脚接GND时。在I2C通信中实际发送的地址字节是7位地址左移一位最低位表示读写0写/1读。所以写地址就是0x23 1 0x46。3.2 核心驱动函数实现接下来是bsp_bh1750.c文件这里包含了所有I2C时序和传感器操作的函数。咱们一个一个来啃。首先是一些基础工具函数延时函数。I2C通信对时序有要求所以我们需要微秒和毫秒级的延时。#include bsp_bh1750.h // 毫秒延时基于FreeRTOS void delay_ms(unsigned int ms) { vTaskDelay(ms / portTICK_PERIOD_MS); } // 微秒延时ESP32-S3内置函数 void delay_us(unsigned int us) { esp_rom_delay_us(us); // 注意原文是ets_delay_us在ESP-IDF中推荐用esp_rom_delay_us }第一步初始化GPIO引脚。把SCL和SDA引脚设置为输出模式并初始化电平。void GY30_GPIO_Init(void) { gpio_config_t io_config { .pin_bit_mask (1ULL BH1750_SCL_PIN) | (1ULL BH1750_SDA_PIN), // 要配置的引脚 .mode GPIO_MODE_OUTPUT, // 初始化为输出模式 .pull_up_en GPIO_PULLUP_ENABLE, // 使能内部上拉电阻很重要 .pull_down_en GPIO_PULLDOWN_DISABLE, .intr_type GPIO_INTR_DISABLE // 禁用中断 }; gpio_config(io_config); // 初始化后将总线拉高I2C空闲时SCL和SDA都为高电平 SCL(1); SDA(1); }第二步实现I2C基础时序。I2C通信就像两个人对话有固定的“开场白”、“结束语”和“应答规矩”。我们需要用代码模拟出这些时序。起始信号STARTSCL为高电平时SDA产生一个下降沿。void IIC_Start(void) { SDA_OUT(); SDA(1); delay_us(5); SCL(1); delay_us(5); SDA(0); // SDA产生下降沿 delay_us(5); SCL(0); // 钳住总线准备发送数据 delay_us(5); }停止信号STOPSCL为高电平时SDA产生一个上升沿。void IIC_Stop(void) { SDA_OUT(); SCL(0); SDA(0); delay_us(5); SCL(1); delay_us(5); SDA(1); // SDA产生上升沿 delay_us(5); }发送一个字节从最高位MSB开始在SCL低电平时准备数据在SCL高电平时保持数据稳定。void Send_Byte(uint8_t dat) { SDA_OUT(); SCL(0); // 拉低时钟线允许SDA变化 for(int i 0; i 8; i) { // 取出最高位右移7位后其值非0即1 SDA((dat 0x80) 7); delay_us(1); SCL(1); // 时钟线拉高数据被采样 delay_us(5); SCL(0); // 拉低时钟线为下一位数据做准备 delay_us(5); dat 1; // 数据左移次高位变为最高位 } }接收一个字节过程与发送相反我们在SCL高电平时读取SDA线上的数据。unsigned char Read_Byte(void) { unsigned char receive 0; SDA_IN(); // 设置SDA为输入模式准备读取 for(int i 0; i 8; i) { SCL(0); delay_us(5); SCL(1); // 时钟线拉高此时数据有效 delay_us(5); receive 1; // 左移一位为接收新数据腾出最低位 if(SDA_GET()) { // 读取SDA引脚电平 receive | 1; // 如果为高电平最低位置1 } delay_us(5); } SCL(0); return receive; }等待应答ACK主机发送完一个字节地址或数据后需要释放SDA线并检测从机是否拉低SDA作为应答。unsigned char I2C_WaitAck(void) { unsigned char ack_flag 10; // 超时计数 SCL(0); SDA(1); // 主机释放SDA线 SDA_IN(); // 设置SDA为输入检测从机应答 delay_us(5); SCL(1); // 产生一个时钟脉冲 delay_us(5); // 等待SDA被从机拉低ACK while((SDA_GET() 1) (ack_flag)) { ack_flag--; delay_us(5); } if(ack_flag 0) { // 超时无应答 IIC_Stop(); return 1; // 返回1表示失败 } else { SCL(0); SDA_OUT(); // 恢复SDA为输出模式 return 0; // 返回0表示成功收到应答 } }发送应答ACK/NACK主机接收完一个字节后需要发送一个应答信号给从机。void IIC_Send_Ack(unsigned char ack) { SDA_OUT(); SCL(0); if(!ack) { SDA(0); // 发送ACK低电平 } else { SDA(1); // 发送NACK高电平 } delay_us(5); SCL(1); // 产生时钟脉冲应答信号被从机采样 delay_us(5); SCL(0); SDA(1); // 释放SDA线 }第三步封装传感器操作函数。有了上面的“积木”我们现在来搭建针对BH1750的具体操作。发送命令函数向BH1750发送一个指令如开机、启动测量。char Single_Write_BH1750(uint8_t REG_Address) { IIC_Start(); // 1. 发送起始信号 Send_Byte(SlaveAddress); // 2. 发送设备地址写位 (0x46) if(I2C_WaitAck() ! 0) return 1; // 等待传感器应答失败则返回1 Send_Byte(REG_Address); // 3. 发送命令字节 if(I2C_WaitAck() ! 0) return 2; // 等待传感器应答失败则返回2 IIC_Stop(); // 4. 发送停止信号 return 0; // 成功返回0 }读取光照数据函数从BH1750读取两个字节的光照数据并转换为lx值。float Multiple_read_BH1750(void) { uint16_t dis_data 0; uint8_t dat_buff[2]; IIC_Start(); // 1. 起始信号 Send_Byte(SlaveAddress 1); // 2. 发送设备地址读位 (0x47) I2C_WaitAck(); // 等待应答 dat_buff[0] Read_Byte(); // 3. 读取高8位数据 IIC_Send_Ack(0); // 4. 主机发送ACK要求继续读 dat_buff[1] Read_Byte(); // 5. 读取低8位数据 IIC_Send_Ack(1); // 6. 主机发送NACK表示读取结束 IIC_Stop(); // 7. 停止信号 // 合并两个字节的数据 dis_data (dat_buff[0] 8) dat_buff[1]; // 根据数据手册原始数据除以1.2得到以lx为单位的光照度 return ((float)dis_data / 1.2); }传感器初始化函数初始化GPIO并发送上电命令。void GY30_Init(void) { GY30_GPIO_Init(); // 初始化I2C引脚 Single_Write_BH1750(0x01); // 发送Power On命令唤醒传感器 }4. 实战应用在主程序中读取光照值驱动函数都准备好了现在让我们在app_main函数里把它们用起来。代码逻辑非常清晰初始化 - 发送测量命令 - 等待测量完成 - 读取数据 - 打印结果 - 循环。#include stdio.h #include bsp_bh1750.h void app_main(void) { float illuminance; // 用于存储光照度值 GY30_Init(); // 初始化传感器 printf(BH1750 Sensor Test Start!\r\n); while(1) { // 发送“连续高分辨率测量”命令 (0x10) Single_Write_BH1750(0x10); // 等待测量完成。数据手册指出高分辨率模式测量时间约120ms这里给180ms更稳妥 delay_ms(180); // 读取光照数据 illuminance Multiple_read_BH1750(); // 打印结果 printf(Illuminance %.2f lx\r\n, illuminance); // 延时500ms进行下一次测量 delay_ms(500); } }代码运行流程GY30_Init()初始化I2C引脚并发送0x01命令让传感器上电。进入循环每次先发送0x10命令告诉传感器“开始一次连续高分辨率测量”。等待至少120ms我们给了180ms让传感器完成光信号采集和AD转换。调用Multiple_read_BH1750()函数通过I2C读取两个字节的原始数据并换算成lx值。通过串口打印出光照度值。延时500ms后开始下一轮测量。把代码编译、下载到ESP32-S3开发板打开串口监视器波特率通常为115200你应该能看到类似下面的输出BH1750 Sensor Test Start! Illuminance 245.67 lx Illuminance 250.12 lx Illuminance 18.45 lx ...用手电筒照射传感器或用手遮住传感器数值应该会有明显变化。5. 常见问题与调试心得最后分享几个我在调试过程中踩过的坑希望能帮你节省时间。I2C通信失败读不到数据首先检查接线VCC、GND、SCL、SDA一根都不能错。尤其是GND一定要共地。检查上拉电阻这是最常见的问题。SCL和SDA线上必须各有1个4.7KΩ - 10KΩ的上拉电阻接到3.3V。用万用表量一下SCL和SDA引脚在空闲时是否是高电平接近3.3V。检查I2C地址确认你的BH1750模块的ADDR引脚接法。如果接GND地址是0x237位我们代码中用的写地址0x46是正确的。如果接VCC地址则是0x5C7位需要修改头文件中的SlaveAddress为0xB80x5C 1。读到的数据一直是0或者65535测量时间不足发送测量命令后必须等待足够的时间高分辨率模式约120ms才能去读数据。如果没等够就去读会读到无效数据。命令错误确保发送的是正确的测量命令。0x10是连续测量模式0x20是单次测量模式。单次测量模式读一次后传感器会自动进入休眠需要重新发送0x01Power On和0x20命令才能再次测量。数值变化不灵敏或范围不对传感器表面有遮挡确保传感器的感光窗口清洁没有贴纸或污渍遮挡。量程选择BH1750还有低分辨率模式0x13命令量程更大但精度低。高分辨率模式0x10精度是1lx更适合室内光照测量。按照上面的步骤操作你应该能顺利驱动BH1750传感器了。这套模拟I2C的代码结构清晰稍作修改就能移植到其他单片机平台上希望对你有所帮助。在实际项目中你可以把读取到的光照数据通过ESP32-S3的Wi-Fi上传到服务器轻松构建一个物联网光照监测节点。