Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eldruin/iaq-core-rs
Platform agnostic Rust driver for the iAQ-Core gas sensors for monitoring indoor air quality
https://github.com/eldruin/iaq-core-rs
air air-quality-sensor co2 driver embedded embedded-hal-driver gas i2c indoor quality rust sensor voc
Last synced: 18 days ago
JSON representation
Platform agnostic Rust driver for the iAQ-Core gas sensors for monitoring indoor air quality
- Host: GitHub
- URL: https://github.com/eldruin/iaq-core-rs
- Owner: eldruin
- License: apache-2.0
- Created: 2020-01-02T16:19:01.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-09-06T12:46:43.000Z (about 3 years ago)
- Last Synced: 2024-04-29T14:22:31.060Z (7 months ago)
- Topics: air, air-quality-sensor, co2, driver, embedded, embedded-hal-driver, gas, i2c, indoor, quality, rust, sensor, voc
- Language: Rust
- Size: 33.2 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# Rust iAQ-Core Indoor Air Quality Sensor Driver
[](https://crates.io/crates/iaq-core)
[](https://docs.rs/iaq-core)
[](https://github.com/eldruin/iaq-core-rs/actions?query=workflow%3ABuild)
[](https://coveralls.io/github/eldruin/iaq-core-rs?branch=master)
This is a platform agnostic Rust driver for the iAQ-Core indoor air quality sensors
using the [`embedded-hal`] traits.
This driver allows you to:
- Read all the sensor data at once. See: `data()`.
- Read the CO2 equivalent prediction value in ppm. See: `co2()`.
- Read the TVOC equivalent prediction value in ppb. See: `tvoc()`.
- Read the sensor resistance in Ohm. See: `resistance()`.
The ams iAQ-core Indoor Air Quality Module is a low-cost, ultracompact
solution for detecting poor air quality. It is equipped with an MOS sensor
element for the detection of a broad range of reducing gases such as CO
and VOCs. A change of resistance in the presence of these gases generates
a signal that is translated into parts per million (ppm) CO2 equivalent or
parts per billion (ppb) TVOC equivalent units.
When defined threshold limits are exceeded, the module signals the system
to initiate activities such as increasing ventilation, releasing fragrance,
providing a message to open a window, switching on an air cleaner, etc.
When VOC levels are minimized, the module instructs the system to return
to standby, thereby saving energy, lowering operating costs and maintaining
a healthy environment.
In any demand-controlled ventilation/actuation environment where air
quality is important, including commercial and residential facilities
(offices, classrooms, kitchens, bathrooms, living and bedrooms etc.)
the iAQ-core Indoor Air Quality Module performs accurately and reliably.
Plus, the module’s small size opens up a wide variety of new applications
where space is at a premium.
Documentation:
- [Datasheet](https://ams.com/documents/20143/36005/iAQ-core_DS000334_1-00.pdf)
- [Factsheet](https://ams.com/documents/20143/36005/iAQ-core_FS000136_1-00.pdf)
## Usage
To use this driver, import this crate and an `embedded_hal` implementation,
then instantiate the device.
Please find additional examples using hardware in this repository: [driver-examples]
[driver-examples]: https://github.com/eldruin/driver-examples
```rust
use iaq_core::IaqCore;
use linux_embedded_hal::I2cdev;
use nb::block;
fn main() {
let dev = I2cdev::new("/dev/i2c-1").unwrap();
let mut sensor = IaqCore::new(dev);
loop {
let data = block!(sensor.data()).unwrap();
println!("CO2: {} ppm, TVOC: {} ppb", data.co2, data.tvoc);
}
}
```
## Support
For questions, issues, feature requests, and other changes, please file an
[issue in the github project](https://github.com/eldruin/iaq-core-rs/issues).
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
http://opensource.org/licenses/MIT)
at your option.
### Contributing
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.
[`embedded-hal`]: https://github.com/rust-embedded/embedded-hal