首页分享 ESP32

ESP32

来源：花匠小妙招时间：2026-03-15 17:10

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（地）、SCL（I2C时钟线）、SDA（I2C数据线）和ADDR（地址选择线）。ADDR引脚的电平决定了传感器的I2C设备地址，这个后面配置代码时会用到。

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

接线是第一步，也是最容易出错的一步。ESP32-S3的I2C接口引脚是灵活的，我们可以自己定义。为了演示方便，我这里假设使用GPIO1作为SCL，GPIO2作为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"

#define BH1750_SCL_PIN 1

#define BH1750_SDA_PIN 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))

#define SlaveAddress 0x46

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"

void delay_ms(unsigned int ms) {

vTaskDelay(ms / portTICK_PERIOD_MS);

}

void delay_us(unsigned int us) {

esp_rom_delay_us(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);

SCL(1);

SDA(1);

}

第二步：实现I2C基础时序。I2C通信就像两个人对话，有固定的“开场白”、“结束语”和“应答规矩”。我们需要用代码模拟出这些时序。

起始信号（START）：SCL为高电平时，SDA产生一个下降沿。

void IIC_Start(void) {

SDA_OUT();

SDA(1);

delay_us(5);

SCL(1);

delay_us(5);

SDA(0);

delay_us(5);

SCL(0);

delay_us(5);

}

停止信号（STOP）：SCL为高电平时，SDA产生一个上升沿。

void IIC_Stop(void) {

SDA_OUT();

SCL(0);

SDA(0);

delay_us(5);

SCL(1);

delay_us(5);

SDA(1);

delay_us(5);

}

发送一个字节：从最高位（MSB）开始，在SCL低电平时准备数据，在SCL高电平时保持数据稳定。

void Send_Byte(uint8_t dat) {

SDA_OUT();

SCL(0);

for(int i = 0; i < 8; i++) {

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();

for(int i = 0; i < 8; i++) {

SCL(0);

delay_us(5);

SCL(1);

delay_us(5);

receive <<= 1;

if(SDA_GET()) {

receive |= 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_IN();

delay_us(5);

SCL(1);

delay_us(5);

while((SDA_GET() == 1) && (ack_flag)) {

ack_flag--;

delay_us(5);

}

if(ack_flag <= 0) {

IIC_Stop();

return 1;

} else {

SCL(0);

SDA_OUT();

return 0;

}

发送应答（ACK/NACK）：主机接收完一个字节后，需要发送一个应答信号给从机。

void IIC_Send_Ack(unsigned char ack) {

SDA_OUT();

SCL(0);

if(!ack) {

SDA(0);

} else {

SDA(1);

}

delay_us(5);

SCL(1);

delay_us(5);

SCL(0);

SDA(1);

}

第三步：封装传感器操作函数。有了上面的“积木”，我们现在来搭建针对BH1750的具体操作。

发送命令函数：向BH1750发送一个指令（如开机、启动测量）。

char Single_Write_BH1750(uint8_t REG_Address) {

IIC_Start();

Send_Byte(SlaveAddress);

if(I2C_WaitAck() != 0) return 1;

Send_Byte(REG_Address);

if(I2C_WaitAck() != 0) return 2;

IIC_Stop();

return 0;

}

读取光照数据函数：从BH1750读取两个字节的光照数据，并转换为lx值。

float Multiple_read_BH1750(void) {

uint16_t dis_data = 0;

uint8_t dat_buff[2];

IIC_Start();

Send_Byte(SlaveAddress + 1);

I2C_WaitAck();

dat_buff[0] = Read_Byte();

IIC_Send_Ack(0);

dat_buff[1] = Read_Byte();

IIC_Send_Ack(1);

IIC_Stop();

dis_data = (dat_buff[0] << 8) + dat_buff[1];

return ((float)dis_data / 1.2);

}

传感器初始化函数：初始化GPIO，并发送上电命令。

void GY30_Init(void) {

GY30_GPIO_Init();

Single_Write_BH1750(0x01);

}

4. 实战应用：在主程序中读取光照值

驱动函数都准备好了，现在让我们在app_main函数里把它们用起来。代码逻辑非常清晰：初始化 -> 发送测量命令 -> 等待测量完成 -> 读取数据 -> 打印结果 -> 循环。

#include <stdio.h>

#include "bsp_bh1750.h"

void app_main(void) {

float illuminance;

GY30_Init();

printf("BH1750 Sensor Test Start!rn");

while(1) {

Single_Write_BH1750(0x10);

delay_ms(180);

illuminance = Multiple_read_BH1750();

printf("Illuminance = %.2f lxrn", illuminance);

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，地址是0x23（7位），我们代码中用的写地址0x46是正确的。如果接VCC，地址则是0x5C（7位），需要修改头文件中的SlaveAddress为0xB8（0x5C << 1）。

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

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

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

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

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