BH1730FVC Rust Driver

A Rust no-std driver for the BH1730FVC ambient light sensor.

Description

This library provides a Rust interface to the BH1730FVC ambient light sensor. It is designed to be used in no-std environments, making it suitable for use in embedded systems.

Supported features

• Single-shot and continuous measurement mode
• Configurable integration time and gain
• Reading the part number and revision id of the sensor
• Converting the read raw values into the ambient light intensity in lux

Unsupported features

• Interrupt functionality
• Configuring the thresholds
• Async support

Dependencies

This library depends on the embedded-hal crate for hardware abstraction. It uses the log crate for logging.

For development, it uses the embedded-hal-mock crate for mocking the hardware abstraction layer. For the example, it uses linux-embedded-hal, to be tentatively run on an RPI (not tested yet!).

Usage

To use this library, add the following to your Cargo.toml file:

[dependencies]
bh1730fvc = "0.1.0"

Then, you can use it in your Rust code like this:

// Create the necessary hardware objects
let mut i2c = hal::I2cdev::new("/dev/i2c-1").unwrap();
let mut delay = hal::Delay;

// Create a new BH1730FVC instance
let mut bh1730fvc = BH1730FVC::new(&mut delay, &mut i2c).unwrap();

// Read the device ID
let device_id = bh1730fvc.read_id(&mut i2c).unwrap();
log::info!(
    "Device ID: (Part Number: 0x{:02X}, Revision ID: 0x{:02X}",
    device_id.0,
    device_id.1,
);

// Do single shot measurement once
match bh1730fvc.get_ambient_light_intensity_single_shot(&mut delay, &mut i2c) {
    Ok(reading) => log::info!("Single shot measurement - lux value: {}", reading),
    Err(e) => log::error!("Error reading sensor: {:?}", e),
}

Examples

There is an example available in the examples directory. To build it (cross-compiling for the RPI), run the following command:

cargo build --example rpi_demo --target=arm-unknown-linux-gnueabihf

License

This library is licensed under either of

• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Changelog

v0.1.1

Initial release

v0.2.0

Added async support