sen0177

sen0177 is a Rust library/create 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 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 recieve Sen0177::InvalidData or Sen0177::ChecksumMismatch from the read() call, a second try will usually succeed.

Gotchas

Raspberry Pi

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.