ESP32-S3驱动ROHM BH1750FVI光照传感器：I2C通信与高精度光照采集实战

ESP32-S3驱动ROHM BH1750FVI光照传感器：I2C通信与高精度光照采集实战

最近在做一个智能农业大棚的环境监测项目，需要实时采集光照数据。选来选去，最终用了ROHM原装的BH1750FVI光照传感器。这玩意儿精度高、接口简单，用I2C总线就能直接读取数字光照值，非常适合ESP32-S3这种带Wi-Fi的物联网MCU。今天我就把整个驱动过程，从硬件连接到软件代码，手把手地分享给大家，帮你快速搞定高精度光照采集。

1. 认识我们的主角：BH1750FVI传感器

在动手接线写代码之前，咱们先花几分钟了解一下BH1750FVI到底是个啥，以及它为啥好用。

BH1750FVI是ROHM公司生产的一款数字式环境光传感器。它最大的特点就是“省心”——内部集成了16位的模数转换器（ADC），直接把光照强度转换成数字信号输出，我们单片机拿到手的就是一个0到65535之间的数字，省去了外部ADC和复杂校准的麻烦。

它的核心参数，我整理成了下面这个表格，一目了然：

提示：勒克斯（lx）是光照度的单位。简单理解，白天室内的光照度大概在100-1000 lx，而晴朗的户外中午可能超过10000 lx。BH1750的65535 lx量程完全覆盖了日常应用场景。

传感器模块通常有5个引脚：VCC（电源）、GND（地）、SCL（I2C时钟线）、SDA（I2C数据线）和ADDR（地址选择线）。ADDR引脚的电平决定了传感器的I2C设备地址，这个后面配置代码时会用到。

2. 硬件连接：把传感器接到ESP32-S3上

接线是第一步，也是最容易出错的一步。ESP32-S3的I2C接口引脚是灵活的，我们可以自己定义。为了演示方便，我这里假设使用GPIO1作为SCL，GPIO2作为SDA。你可以根据自己板子的实际情况调整。

准备好你的ESP32-S3开发板和BH1750模块，按照下表连接：

注意：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接GPIO10，SDA接GPIO11，就把1和2改成10和11。
• 第13-17行：定义了控制SDA引脚输入输出模式、读取电平和设置电平的宏，后面写时序代码时非常简洁。
• 第20行：SlaveAddress是传感器的I2C写地址。BH1750的7位设备地址是0x23（ADDR引脚接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通信就像两个人对话，有固定的“开场白”、“结束语”和“应答规矩”。我们需要用代码模拟出这些时序。

1. 起始信号（START）：SCL为高电平时，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); }

2. 停止信号（STOP）：SCL为高电平时，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); }

3. 发送一个字节：从最高位（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; // 数据左移，次高位变为最高位 } }

4. 接收一个字节：过程与发送相反，我们在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; }

5. 等待应答（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表示成功收到应答 } }

6. 发送应答（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的具体操作。

1. 发送命令函数：向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 }

2. 读取光照数据函数：从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); }

3. 传感器初始化函数：初始化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); } }

代码运行流程：

1. GY30_Init()初始化I2C引脚，并发送0x01命令让传感器上电。
2. 进入循环，每次先发送0x10命令，告诉传感器：“开始一次连续高分辨率测量”。
3. 等待至少120ms（我们给了180ms），让传感器完成光信号采集和AD转换。
4. 调用Multiple_read_BH1750()函数，通过I2C读取两个字节的原始数据，并换算成lx值。
5. 通过串口打印出光照度值。
6. 延时500ms后，开始下一轮测量。

把代码编译、下载到ESP32-S3开发板，打开串口监视器（波特率通常为115200），你应该能看到类似下面的输出：

BH1750 Sensor Test Start! Illuminance = 245.67 lx Illuminance = 250.12 lx Illuminance = 18.45 lx ...

用手电筒照射传感器或用手遮住传感器，数值应该会有明显变化。

5. 常见问题与调试心得

最后，分享几个我在调试过程中踩过的坑，希望能帮你节省时间。

1. I2C通信失败，读不到数据

   • 首先检查接线：VCC、GND、SCL、SDA，一根都不能错。尤其是GND，一定要共地。
   • 检查上拉电阻：这是最常见的问题。SCL和SDA线上必须各有1个4.7KΩ - 10KΩ的上拉电阻接到3.3V。用万用表量一下SCL和SDA引脚，在空闲时是否是高电平（接近3.3V）。
   • 检查I2C地址：确认你的BH1750模块的ADDR引脚接法。如果接GND，地址是0x23（7位），我们代码中用的写地址0x46是正确的。如果接VCC，地址则是0x5C（7位），需要修改头文件中的SlaveAddress为0xB8（0x5C << 1）。

2. 读到的数据一直是0或者65535

   • 测量时间不足：发送测量命令后，必须等待足够的时间（高分辨率模式约120ms）才能去读数据。如果没等够就去读，会读到无效数据。
   • 命令错误：确保发送的是正确的测量命令。0x10是连续测量模式，0x20是单次测量模式。单次测量模式读一次后传感器会自动进入休眠，需要重新发送0x01（Power On）和0x20命令才能再次测量。

3. 数值变化不灵敏或范围不对

   • 传感器表面有遮挡：确保传感器的感光窗口清洁，没有贴纸或污渍遮挡。
   • 量程选择：BH1750还有低分辨率模式（0x13命令），量程更大但精度低。高分辨率模式（0x10）精度是1lx，更适合室内光照测量。

按照上面的步骤操作，你应该能顺利驱动BH1750传感器了。这套模拟I2C的代码结构清晰，稍作修改就能移植到其他单片机平台上，希望对你有所帮助。在实际项目中，你可以把读取到的光照数据通过ESP32-S3的Wi-Fi上传到服务器，轻松构建一个物联网光照监测节点。