BH1750FVI 传感器驱动软件包
1 介绍
BH1750FVI 传感器软件包提供光强传感器 BH1750FVI 基本功能，BH1750FVI 它是一种用于两线串行总线接口的数字光强度传感器集成电路。该集成电路可根据收集的光强数据调整液晶或键盘背景灯的亮度。利用其高分辨率，可以探测到大范围的光强度变化。lx-65535lx）。本文介绍了软件包的基本功能和 Finsh/MSH 测试命令等，这里我做了两个版本的软件包，新版本是基于sensor目前最新版本的框架（latest）的是基于sensor以下是基于框架的使用sensor使用新版本的框架软件包，
传感器主要是基本功能 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 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