[−][src]Crate sen0177

sen0177 is a Rust library/crate that reads air quality data from the SEN0177 air quality sensor.

Prerequisites

You've connected the sensor to a UART on a Linux-based device, and that UART is enabled and available from the kernel as a TTY device node.

Installation

Include the following in your Cargo.toml file:

[dependencies]
sen0177 = "0.1"

Usage

use sen0177::{Reading, Sen0177};
 
const SERIAL_PORT: &str = "/dev/ttyS0";
 
let mut sensor = Sen0177::open(SERIAL_PORT).expect("Failed to open device");
let reading = sensor.read().expect("Failed to read sensor data");
println!("PM1: {}µg/m³, PM2.5: {}µg/m³, PM10: {}µg/m³",
         reading.pm1(), reading.pm2_5(), reading.pm10());

Note that the serial device occasionally returns bad data. If you receive Sen0177Error::InvalidData or Sen0177Error::ChecksumMismatch from the Sen0177::read call, a second try will usually succeed.

If you're using this with a Raspberry Pi, note that by default the primary GPIO pins are set up as a Linux serial console. You will need to disable that (by editing /boot/cmdline.txt) before this will work. Instead of using a specifiy TTY device node, you should use /dev/serial0, which is a symlink to the proper device.

Alternatively, you can use the second UART, but you'll need to load an overlay to assign it to GPIO pins. See UART configuration and the UART-related overlays for more information.

Structs

Reading	A single air quality sensor reading
Sen0177	An instance of the SEN0177 air quality sensor

Enums

Sen0177Error

Describes errors returned by the SEN0177 sensor