Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create ENS161 #1277

Merged
merged 3 commits into from
Oct 17, 2023
Merged

Create ENS161 #1277

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
35c190d
Create ENS161
chrfriese123 Sep 8, 2023
8cb4092
Rename ENS161 to ENS161.md
blakadder Oct 17, 2023
111f1da
Update ENS161.md
blakadder Oct 17, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions docs/ENS161.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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)
Loading