From 9d82c3e43df160d6c2686849653da4fef7557544 Mon Sep 17 00:00:00 2001 From: Christoph Friese <49806974+chrfriese123@users.noreply.github.com> Date: Tue, 17 Oct 2023 11:47:03 +0200 Subject: [PATCH] Create ENS161 (#1277) * Create ENS161 ENS161 air quality sensor, follow up product for iAQcore and CCS811 * Rename ENS161 to ENS161.md * Update ENS161.md --------- Co-authored-by: blakadder --- docs/ENS161.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 docs/ENS161.md diff --git a/docs/ENS161.md b/docs/ENS161.md new file mode 100644 index 0000000000..94431cfc8b --- /dev/null +++ b/docs/ENS161.md @@ -0,0 +1,42 @@ +# ENS161 indoor air quality sensor + +??? failure "This feature is not included in precompiled binaries" + + When [compiling your build](Compile-your-build) add the following to `user_config_override.h`: + ```arduino + #ifndef USE_ENS16x + #define USE_ENS16x + #endif + ``` + +The ENS161 indoor air quality sensor is a low-cost solution for detecting air quality. This module uses MEMS hotplate coated with metal oxide semiconductor (MOx) technology to detect a broad range of VOCs (volotile organic compounds). In addition an CO~2~ equivalent value as well as a relative air quality index is reported. +Two versions are available ENS160 and ENS161. ENS161 is the latest release offering in addition a low power option and AQIS output. THe driver is able to work with both options. + +## Configuration + +#### Wiring + +Follow datasheet for required pull-ups when connecting the bare sensor module directly to ESP8266. Wemos and NodeMCU board include the required pull-up. The component is operated with 3.3V and 1.8V. +The sensor component can be operated with two differnet I2C addresses. So in principle the use of two components on the same I2C interface is possible. + +#### Tasmota Settings + +In the **_Configuration -> Configure Module_** page assign: + +1. GPIOx to `I2C SDA` +2. GPIOy to `I2C SCL` + +After configuring the GPIO's the driver will check both possible I2C addresses and detect connected ENS161 sensors automatically. + +## Usage + +Typical sensor reading should be around 450 ppm eCO~2~ and 125 ppb TVOC. The AQIS value is in the range of 0 to 500. + +#### Where to get (e.g.) + +* [Adafruit](https://www.adafruit.com/product/5606) +* [Sparkfun](https://www.sparkfun.com/products/22858) +* [DFRobot](https://www.dfrobot.com/product-2523.html) +* [DigiKey](https://www.digikey.com/product-detail/en/ams/IAQ-CORE-C/IAQ-COREC-ND/5117221) + +[ENS161 Datasheet](https://www.sciosense.com/wp-content/uploads/2023/06/SC-001855-DS-2-ENS161-Datasheet.pdf)