BH1750 数字光传感器项目教程

1. 项目的目录结构及介绍

BH1750 数字光传感器项目的目录结构如下：

BH1750/
├── examples/
│   ├── BH1750test/
│   │   ├── BH1750test.ino
│   ├── LightSensor/
│   │   ├── LightSensor.ino
├── src/
│   ├── BH1750.cpp
│   ├── BH1750.h
├── keywords.txt
├── library.properties
├── LICENSE
├── README.md

目录结构介绍

• examples/: 包含示例代码，帮助用户快速上手。
  • BH1750test/: 包含一个基本的测试示例。
  • LightSensor/: 包含一个更复杂的示例，展示如何使用传感器读取光线强度。
• src/: 包含库的核心源代码。
  • BH1750.cpp: 库的主要实现文件。
  • BH1750.h: 库的头文件，定义了库的接口。
• keywords.txt: 定义了Arduino IDE中的关键字高亮显示。
• library.properties: 库的元数据文件，用于Arduino IDE的库管理器。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件位于 examples/ 目录下，具体为 BH1750test/BH1750test.ino 和 LightSensor/LightSensor.ino。

BH1750test.ino

这是一个基本的测试示例，展示了如何初始化传感器并读取光线强度。

#include <BH1750.h>
#include <Wire.h>

BH1750 lightSensor;

void setup() {
  Serial.begin(9600);
  lightSensor.begin();
  Serial.println("BH1750 Test");
}

void loop() {
  float lux = lightSensor.readLightLevel();
  Serial.print("Light: ");
  Serial.print(lux);
  Serial.println(" lx");
  delay(1000);
}

LightSensor.ino

这是一个更复杂的示例，展示了如何使用传感器读取光线强度并在LCD显示屏上显示。

#include <BH1750.h>
#include <Wire.h>
#include <LiquidCrystal.h>

BH1750 lightSensor;
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);

void setup() {
  lcd.begin(16, 2);
  lightSensor.begin();
  lcd.print("BH1750 Sensor");
}

void loop() {
  float lux = lightSensor.readLightLevel();
  lcd.setCursor(0, 1);
  lcd.print("Light: ");
  lcd.print(lux);
  lcd.print(" lx");
  delay(1000);
}

3. 项目的配置文件介绍

项目的配置文件主要是 library.properties 和 keywords.txt。

library.properties

这个文件包含了库的元数据，用于Arduino IDE的库管理器。

name=BH1750
version=1.2.0
author=claws
maintainer=claws
sentence=An Arduino library for the digital light sensor breakout boards containing the BH1750FVI IC.
paragraph=This library provides an easy-to-use interface for the BH1750FVI digital light sensor, supporting various measurement modes and precisions.
category=Sensors
url=https://github.com/claws/BH1750
architectures=*

keywords.txt

这个文件定义了Arduino IDE中的关键字高亮显示。

BH1750	KEYWORD1
begin	KEYWORD2
readLightLevel	KEYWORD2
setMode	KEYWORD2

通过这些配置文件，用户可以更好地理解和使用BH1750数字光传感器库。