基于RT-Thread的光照强度传感器BH1750FVI 软件包

时间：2023-07-23 15:07:00 光强度传感器bh1750fvi

BH1750FVI 传感器驱动软件包

1 介绍

BH1750FVI 传感器软件包提供光强传感器 BH1750FVI 基本功能，BH1750FVI 它是一种用于两线串行总线接口的数字光强度传感器集成电路。该集成电路可根据收集的光强数据调整液晶或键盘背景灯的亮度。利用其高分辨率，可以探测到大范围的光强度变化。lx-65535lx）。本文介绍了软件包的基本功能和 Finsh/MSH 测试命令等，这里我做了两个版本的软件包，新版本是基于sensor目前最新版本的框架（latest）的是基于sensor以下是基于框架的使用sensor使用新版本的框架软件包，旧版本（非sensor使用框架的方法有：https://github.com/sanjaywu/bh1750_sensor/blob/bh1750-v1.0.0/old_readme.md。

传感器主要是基本功能 BH1750FVI 决定：输入电压为 2.4v-3.6v 测量光强度的范围如下表所示：

功能	量程
光照强度	1lx - 65535lx

BH1750FVI 具体如下表所示：

测量模式	测量时间	分辨率
H-resolution Mode2	Typ. 120ms.	0.5 lx
H-resolution Mode	Typ. 120ms.	1 lx
L-resolution Mode	Typ. 16ms.	4 lx

1.1 目录结构

名称	说明
bh1750.h、sensor_rohm_bh1750.h	传感器使用头文件
bh1750.c、sensor_rohm_bh1750.c	传感器使用源代码
SConscript	RT-Thread 默认构建脚本
README.md	软件包使用说明书
BH1750FVI_datasheet.pdf	官方数据手册

1.2 许可证

BH1750FVI 遵循传感器软件包 Apache-2.0 许可，详见 LICENSE 文件。

1.3 依赖

依赖 RT-Thread I2C 设备驱动框架。

2 获取软件包

使用 BH1750FVI 软件包需要在 RT-Thread 具体路径如下：

RT-Thread online packages --->     peripheral libraries and drivers --->         sensors drivers --->               [*]   bh1750 sensor driver package, support: ambient light.  --->                     Version (latest)  --->

配置说明如下：

bh1750 sensor driver package, support: ambient light：选择使用 BH1750FVI 传感器软件包；
Version：配置软件包版本，默认最新版本；
版本说明：v1.0.0版本是旧版本(不sensor框架）、v2.0.0和latest是新版本(基于sensor框架）。

然后让 RT-Thread 自动更新或使用包管理器 pkgs --update 命令更新包到 BSP 中。

3 使用基于sensor框架软件包

根据前面的介绍，如果你得到的是v2.0.0和latest版本，用的是sensor获取框架 BH1750FVI 软件包完成后，您可以遵循以下内容 API 使用传感器 bh1750 与 Finsh/MSH 命令测试如下。

3.1 API

BH1750FVI 软件包初始化函数如下：

int rt_hw_bh1750_init(const char *name, struct rt_sensor_config *cfg);

函数需要用户调用，函数的主要功能是，

设备配置与初始化(根据传入的配置信息配置接口设备)；
注册相应的传感器设备，完成 bh1750 设备的注册；

3.2 初始化示例

int bh1750_port(void) {     struct rt_sensor_config cfg;      cfg.intf.dev_name = "i2c2";  ////根据传感器挂起的I2C设备修改     cfg.intf.user_data = (void *)BH1750_ADDR;     cfg.irq_pin.pin = RT_PIN_NONE;      rt_hw_bh1750_init("bh1750", &cfg);       return 0; } INIT_APP_EXPORT(bh1750_port);

在使用该传感器之前，应进行上述初始，cfg.intf.dev_name = "i2c2";根据所挂载的i2c打印以下信息的初始化成功启动机会：

 \ | / - RT -     Thread Operating System  / | \     4.0.1 build Apr 30 2019  2006 - 2019 Copyright by rt-thread team [I/sensor] rt_sensor init success [I/sensor.rohm.bh1750] light sensor init success msh >

3.3 Finsh/MSH 测试命令

BH1750FVI 只要项目在，软件包就提供了丰富的测试命令 RT-Thread 上开启 Finsh/MSH 功能就够了。基于功能做一些事情。 BH1750FVI 这些命令在应用开发和调试中非常实用，可以准确读取传感器测量的光强。

3.3.1、输入`list_device`

msh >list_device device           type         ref count -------- ------------------- ----------
li_bh175 Sensor Device        1
i2c2     I2C Bus              0
uart1    Character Device     2
pin      Miscellaneous Device 0
msh >

查看到对应设备以及注册成功。

3.3.2、输入`sensor probe li_bh1750`

msh >sensor probe li_bh1750
[I/sensor.cmd] device id: 0xff!
msh >

3.3.3、输入`sensor read`

msh >sensor read
[I/sensor.cmd] num:  0, light: 494.1, timestamp:2647042
[I/sensor.cmd] num:  1, light: 495.0, timestamp:2647268
[I/sensor.cmd] num:  2, light: 495.0, timestamp:2647494
[I/sensor.cmd] num:  3, light: 490.8, timestamp:2647720
[I/sensor.cmd] num:  4, light: 490.8, timestamp:2647946
msh >

读取到光照强度数据，单位：lux。

4 注意事项

如果使用基于sensor框架的软件包（v2.0.0、latest版本），在执行sensor read之后没有任何打印出光照强度数据，打开\components\drivers\sensors\sensor_cmd.c,在sensor_show_data函数后面自行增加环境光照强度打印代码：

case RT_SENSOR_CLASS_LIGHT:
        LOG_I("num:%3d, light:%4d.%d, timestamp:%5d", num, sensor_data->data.light / 10, sensor_data->data.light % 10, sensor_data->timestamp);
        break;

5 联系方式

维护：Sanjay_Wu
主页：https://github.com/sanjaywu/bh1750_sensor
邮箱：sanjaywu@yeah.net

锐单商城拥有海量元器件数据手册、IC替代型号，打造电子元器件IC百科大全！

基于RT-Thread的光照强度传感器BH1750FVI 软件包

BH1750FVI 传感器驱动软件包

相关文章