当前位置：首页 > news >正文

STM32 CubeMX HAL库驱动GY-302（BH1750）光照传感器，告别模拟I2C的繁琐配置

news 2026/4/27 12:44:55

STM32 CubeMX HAL库驱动GY-302（BH1750）光照传感器实战指南

在物联网和智能家居应用中，精确测量环境光照强度是一个常见需求。BH1750作为一款数字型光强度传感器，以其高精度和简单易用的特性受到开发者青睐。本文将详细介绍如何利用STM32CubeMX和HAL库快速构建硬件I2C驱动，彻底告别繁琐的模拟I2C配置。

1. 硬件准备与传感器基础

GY-302模块搭载ROHM原装BH1750FVI芯片，采用标准的I2C通信协议。与传统的模拟传感器不同，它内置16位ADC转换器，直接输出数字信号，省去了复杂的模拟电路设计和校准过程。

模块关键参数：

工作电压：3.3V-5V
测量范围：0-65535 lx
分辨率：最小1 lx
接口类型：I2C（默认地址0x23）

注意：模块上的ADDR引脚可改变设备地址，接地时为0x23，接VCC时为0x5C。这在多设备系统中非常有用。

传感器支持三种测量模式：

#define CONTINUE_H_MODE 0x10 // 高精度连续测量 #define CONTINUE_L_MODE 0x13 // 低精度连续测量 #define ONE_TIME_H_MODE 0x20 // 高精度单次测量

2. CubeMX工程配置

2.1 时钟树配置

打开CubeMX，选择对应STM32型号
在RCC配置中启用外部晶振（HSE）
配置时钟树，确保I2C外设时钟不超过最大频率（通常400kHz）

2.2 I2C外设设置

在"Connectivity"选项卡中选择I2C1（或其它可用I2C）
配置为"I2C"模式
参数设置：
- Timing参数：选择"Standard Mode"（100kHz）或"Fast Mode"（400kHz）
- 启用"I2C Fast Mode Plus"（如果支持）

// 自动生成的I2C初始化代码片段 hi2c1.Instance = I2C1; hi2c1.Init.ClockSpeed = 100000; hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 = 0; hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; hi2c1.Init.OwnAddress2 = 0; hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;

2.3 GPIO配置

定位I2C的SCL和SDA引脚（如PB6/PB7）
设置为"I2C"功能模式
上拉电阻选择：
- 如果模块已有上拉电阻，选择"No pull-up/pull-down"
- 否则选择"Pull-up"

3. HAL库驱动实现

3.1 基础驱动函数

创建bh1750.h头文件，定义常用宏：

#define BH1750_ADDR_L (0x23 << 1) // ADDR引脚接地 #define BH1750_ADDR_H (0x5C << 1) // ADDR引脚接VCC #define BH1750_POWER_ON 0x01 #define BH1750_POWER_OFF 0x00 #define BH1750_RESET 0x07

实现初始化函数：

HAL_StatusTypeDef BH1750_Init(I2C_HandleTypeDef *hi2c) { uint8_t cmd = BH1750_POWER_ON; HAL_StatusTypeDef status; status = HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR_L, &cmd, 1, HAL_MAX_DELAY); if(status != HAL_OK) return status; cmd = 0x10; // 连续高精度模式 return HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR_L, &cmd, 1, HAL_MAX_DELAY); }

3.2 数据读取实现

光照强度读取函数：

float BH1750_ReadLightIntensity(I2C_HandleTypeDef *hi2c) { uint8_t data[2]; uint16_t raw_value; if(HAL_I2C_Master_Receive(hi2c, BH1750_ADDR_L, data, 2, HAL_MAX_DELAY) != HAL_OK) { return -1.0f; // 错误返回值 } raw_value = (data[0] << 8) | data[1]; return raw_value / 1.2f; // 转换为lux值 }

3.3 测量模式切换

typedef enum { BH1750_CONTINUOUS_HIGH_RES_MODE = 0x10, BH1750_CONTINUOUS_HIGH_RES_MODE_2 = 0x11, BH1750_CONTINUOUS_LOW_RES_MODE = 0x13, BH1750_ONE_TIME_HIGH_RES_MODE = 0x20, BH1750_ONE_TIME_HIGH_RES_MODE_2 = 0x21, BH1750_ONE_TIME_LOW_RES_MODE = 0x23 } BH1750_Mode; HAL_StatusTypeDef BH1750_SetMode(I2C_HandleTypeDef *hi2c, BH1750_Mode mode) { uint8_t cmd = (uint8_t)mode; return HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR_L, &cmd, 1, HAL_MAX_DELAY); }

4. 实际应用与优化

4.1 数据滤波处理

在实际应用中，建议对读取值进行滑动平均滤波：

#define FILTER_SIZE 5 float light_filter[FILTER_SIZE]; uint8_t filter_index = 0; float BH1750_GetFilteredLight(I2C_HandleTypeDef *hi2c) { float current = BH1750_ReadLightIntensity(hi2c); light_filter[filter_index] = current; filter_index = (filter_index + 1) % FILTER_SIZE; float sum = 0; for(int i = 0; i < FILTER_SIZE; i++) { sum += light_filter[i]; } return sum / FILTER_SIZE; }

4.2 低功耗优化

对于电池供电设备：

使用单次测量模式
测量间隔期间关闭传感器电源

void BH1750_LowPowerMeasurement(I2C_HandleTypeDef *hi2c) { uint8_t cmd; // 唤醒传感器 cmd = BH1750_POWER_ON; HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR_L, &cmd, 1, 10); // 单次高精度测量 cmd = BH1750_ONE_TIME_HIGH_RES_MODE; HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR_L, &cmd, 1, 10); // 延时等待测量完成 HAL_Delay(180); // 读取数据 float light = BH1750_ReadLightIntensity(hi2c); // 关闭传感器 cmd = BH1750_POWER_OFF; HAL_I2C_Master_Transmit(hi2c, BH1750_ADDR_L, &cmd, 1, 10); }

4.3 多设备管理

当系统中需要多个光照传感器时：

typedef struct { I2C_HandleTypeDef *hi2c; uint8_t address; BH1750_Mode mode; } BH1750_Device; void BH1750_InitDevice(BH1750_Device *dev) { uint8_t cmd; cmd = BH1750_POWER_ON; HAL_I2C_Master_Transmit(dev->hi2c, dev->address, &cmd, 1, 10); cmd = (uint8_t)dev->mode; HAL_I2C_Master_Transmit(dev->hi2c, dev->address, &cmd, 1, 10); } float BH1750_ReadDevice(BH1750_Device *dev) { uint8_t data[2]; if(HAL_I2C_Master_Receive(dev->hi2c, dev->address, data, 2, 100) != HAL_OK) { return -1.0f; } return ((data[0] << 8) | data[1]) / 1.2f; }