From 8b79a485eb08b46d0afd1e9b307503a7e4fe7bc0 Mon Sep 17 00:00:00 2001 From: blakadder Date: Wed, 6 Nov 2019 22:23:07 +0100 Subject: [PATCH] sds011 changes --- Commands.md | 2 +- Peripherals.md | 2 +- SDS011.md | 41 ++++++++++++++++ Supported-sensors.md | 2 +- ...d-Nova-Fitness-SDS011-Laser-Dust-Sensor.md | 48 ------------------- 5 files changed, 44 insertions(+), 51 deletions(-) create mode 100644 SDS011.md delete mode 100644 Wemos-D1-Mini-and-Nova-Fitness-SDS011-Laser-Dust-Sensor.md diff --git a/Commands.md b/Commands.md index 930c7e0d..aad3952c 100644 --- a/Commands.md +++ b/Commands.md @@ -264,7 +264,7 @@ HumRes|Humidity sensor resolution
`0..3` = maximum number PressRes|Pressure sensor resolution
`0..3` = maximum number of decimal places Sensor13|[INA219](http://www.ti.com/product/INA219) low voltage current sensor calibration mode
`0` = set INA219 calibration to max 32V and 2A
`1` = set INA219 calibration to max 32V and 1A
`2` = set INA219 calibration to max 16V and 0.4A Sensor15|[Automatic Baseline Correction](https://github.com/arendst/Tasmota/blob/c97ea4d9176eb7e87abff5f963a0f1c60f0a5e52/sonoff/xsns_15_mhz19.ino#L47) for [MH-Z19B](MH-Z19B) CO2 sensor
`0` = disabled
`1` = enabled *(default)*
`2` = disable and start manual calibration from 400 ppm of CO2
`9` = reset sensor to factory defaults
`1000` = sets measurement range to 1000ppm CO2
`2000` = sets measurement range to 2000ppm CO2
`3000` = sets measurement range to 3000ppm CO2
`5000` = sets measurement range to 5000ppm CO2 -Sensor20|[Nova Fitness SDS011](Wemos-D1-Mini-and-Nova-Fitness-SDS011-Laser-Dust-Sensor) dust sensor.  »6.5.0.3
1..255` = number of seconds before TelePeriod to poll the sensor +Sensor20|[Nova Fitness SDS011](SDS011) dust sensor.  »6.5.0.3
1..255` = number of seconds before TelePeriod to poll the sensor Sensor27|[APDS-9960](APDS-9960) sensor commands
`0` = enable light level and proximity sensor / disable gestures *(default)*
`1` = enable gesture mode/ disable light level and proximity sensor
`2` = enable gestures with half gain / disable light and proximity sensor
`3..255` = Set [ATIME register](APDS-9960#known-issues) for different integration times Sensor29|MCP23008 / MCP23017 I2C GPIO Expander configuration ([additional details](MCP230xx))
`Reset` = reset all pins
x = `1..6`
`1` = INPUT mode, no reporting, no pull-up
`2` = INPUT mode, report on CHANGE, pull-up enabled
`3` = INPUT mode, report on LOW, pull-up enabled
`4` = INPUT mode, report on HIGH, pull-up enabled
`5` = OUTPUT mode (if enabled by `#define USE_MCP230xx_OUTPUT`)
`6` = inverted OUTPUT mode (if enabled by `#define USE_MCP230xx_OUTPUT`)

`pin,pinmode{,intpullup\|outstate{,repmode}}`
[Continue reading...](MCP230xx#device-configuration) Sensor34|  »6.6.0
[HX711 load cell](https://github.com/bogde/HX711) sensor calibration
`1` = reset display to 0
`2` = start calibration
`2` `` = set reference weight in grams and start calibration
`3` = show reference weight in grams
`3` `` = set reference weight in grams
`4` = show calibrated scale value
`4` `` = set calibrated scale value
`5` = show max weight in gram
`5` `` = set max weight in grams
`6` = show single item weight in grams
`6` `` = set single item weight in grams. Once the item weight is set, when items are added to the scale, the telemetry message will report `Count` as the number of items on the scale
`7` = save current weight to be used as start weight on restart
`8` `0/1`   »6.6.0.13
 `0` = disable JSON message on weight change over 4 grams
 `1` = enable JSON message on weight change over 4 grams diff --git a/Peripherals.md b/Peripherals.md index 6c6f224b..fa9348aa 100644 --- a/Peripherals.md +++ b/Peripherals.md @@ -56,7 +56,7 @@ More about [general configuration](Sensor-Configuration). - **SCD30** - CO2 sensor (I2C) - **SDM120** - Modbus Energy Meter (serial) - **SDM630** - Modbus Energy Meter (serial) -- [**SDS011 (SDS021)**](Wemos-D1-Mini-and-Nova-Fitness-SDS011-Laser-Dust-Sensor) - Laser Dust Sensor +- [**SDS011 (SDS021)**](SDS011) - Laser Dust Sensor - **SGP30** - Gas and Air Quality sensor (I2C) - **SHT1x** - Temperature and Humidity sensor (I2C) - [**SHT30**](Wemos-D1-Mini-and-SHT30-Shield-High-Precision-Humidity-&-Temperature) - Humidity & Temperature Sensor diff --git a/SDS011.md b/SDS011.md new file mode 100644 index 00000000..fb55829a --- /dev/null +++ b/SDS011.md @@ -0,0 +1,41 @@ + + +Nova PM Sensor SDS011 can measure the air quality very accurately by measuring air particles or dust based on laser detection. + +Specifications: + +* Voltage: 4.7 - 5.3V DC (5V DC with <20mV ripple advised) +* Power consumption: 70mA ±10mA (in operation), <4mA (laser and fan sleep mode) +* Measuring range: 0.0-999.9 μg/m3 +* PM2.5 and PM10 output + +See [manufacturer site](http://www.inovafitness.com/en/a/chanpinzhongxin/95.html) for more information. + +## Configuration +### Wiring + +| SDS011 | ESP8266 | +|---|---| +|GND |GND | +|5V |5V | +|TX |GPIO RX | +|RX |GPIO TX | + +### Tasmota +In the _Configuration -> Configure Module_ page assign: +1. GPIO RX to `SDS0X1 Tx (101)` +2. GPIO TX to `SDS0X1 Rx (70)` + + + +### Tasmota Main +After reboot of the device the displays the SDS011 measurements. + + + +### OpenHab + +```sensors.items +Number Dust_Sensor_2_5 "PM 2.5 [%.2f µg/m³]" (Dust) {mqtt="<[mosquitto:tele/dust/SENSOR:state:JSONPATH($.SDS0X1['PM2.5'])]"} +Number Dust_Sensor_10 "PM 10 [%.2f µg/m³]" (Dust) {mqtt="<[mosquitto:tele/dust/SENSOR:state:JSONPATH($.SDS0X1['PM10'])]"} +``` \ No newline at end of file diff --git a/Supported-sensors.md b/Supported-sensors.md index 39605606..108da0be 100644 --- a/Supported-sensors.md +++ b/Supported-sensors.md @@ -47,7 +47,7 @@ - **SCD30** CO2 sensor (I2C) - **SDM120** Modbus Energy Meter (Serial) - **SDM630** Modbus Energy Meter (Serial) -- [**SDS011 (SDS021)**](Wemos-D1-Mini-and-Nova-Fitness-SDS011-Laser-Dust-Sensor) Laser Dust Sensor +- [**SDS011 (SDS021)**](SDS011) Laser Dust Sensor - **SGP30** Gas and Air Quality sensor (I2C) - **SHT1x** Temperature and Humidity sensor (I2C) - [**SHT30**](Wemos-D1-Mini-and-SHT30-Shield-High-Precision-Humidity-&-Temperature) Humidity & Temperature Sensor diff --git a/Wemos-D1-Mini-and-Nova-Fitness-SDS011-Laser-Dust-Sensor.md b/Wemos-D1-Mini-and-Nova-Fitness-SDS011-Laser-Dust-Sensor.md deleted file mode 100644 index f3961a92..00000000 --- a/Wemos-D1-Mini-and-Nova-Fitness-SDS011-Laser-Dust-Sensor.md +++ /dev/null @@ -1,48 +0,0 @@ -## Nova Fitness SDS011 PM2.5 PM10 Laser Dust Sensor (Serial) - - - -The SDS011 using principle of laser scattering,can get the particle concentration between 0.3 to 10µm in the air. It with digital output and built-in fan is stable and reliable. - -Accurate and Reliable: laser detection, stable, good consistency; -Quick response: response time is less than 10 seconds when the scene changes; -Easy integration: UART output (or IO output can be customized), fan built-in; -High resolution: resolution of 0.3µg/m3; - -Measurementparameters PM2.5, PM10 -Range 0.0-999.9µg /m3 -Rated voltage 5V -Rated current 70mA±10mA - -See [Nova Fitness SDS011 PM2.5 PM10 Laser Dust Feinstaub Sensor](https://inovafitness.de/produkt/sds011) (German) for more information. - -### Connecting the SDS011 to a Wemos Mini D1 - -| Wemos | SDS011 | -|---|---| -|GND |GND | -|5V |5V | -|TX (gpio01) |RX | -|RX (gpio03) |TX | - -### Tasmota Configuration -In the Configuration -> Configure Module page, select the following: -1. **Module Type : 18 Generic** -2. **TX (GPIO01) Serial Out : 101 SDS0X1 Tx** -3. **RX (GPIO03) Serial In : 70 SDS0X1 Rx** - -_Readings are performed every teleperiod seconds (Tasmota Default is 300 seconds = 5 min)._ - - - -### Tasmota Main -After reboot of the device the displays the SDS011 measurements. - - - -### OpenHab configuration - -```sensors.items -Number Dust_Sensor_2_5 "PM 2.5 [%.2f µg/m³]" (Dust) {mqtt="<[mosquitto:tele/dust/SENSOR:state:JSONPATH($.SDS0X1['PM2.5'])]"} -Number Dust_Sensor_10 "PM 10 [%.2f µg/m³]" (Dust) {mqtt="<[mosquitto:tele/dust/SENSOR:state:JSONPATH($.SDS0X1['PM10'])]"} -``` \ No newline at end of file