ZyAura CO2 / Temperature / Humidity Sensor (#281)

* Docs ready

* Small fix

* Small fix

* Update components/sensor/zyaura.rst

Co-Authored-By: Otto Winter <otto@otto-winter.com>

* Update components/sensor/zyaura.rst

Co-Authored-By: Otto Winter <otto@otto-winter.com>

* Review fix

* Update components/sensor/zyaura.rst

Co-Authored-By: Otto Winter <otto@otto-winter.com>
This commit is contained in:
Nikolay Vasilchuk 2019-07-03 17:00:04 +03:00 committed by Otto Winter
parent adea670924
commit ec4ecf6b71
5 changed files with 85 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 208 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

View File

@ -0,0 +1,84 @@
ZyAura CO2 & Temperature & Humidity Sensor
==========================================
.. seo::
:description: Instructions for setting up ZyAura co2, temperature and humidity monitors.
:image: zgm053.jpg
:keywords: CO2, MT8057, MT8057S, MT8060, ZGm05, ZGm053U, ZG1683R, ZG1583RUD
The ZyAura CO2 & Temperature & Humidity sensor allows you to use your
`ZGm05(3)(U) <http://www.zyaura.com/products/ZGm05.asp>`__
(`MT8057 <https://masterkit.ru/shop/1266110>`__, `MT8057S <https://medgadgets.ru/shop/kit-mt8057.html>`__),
`ZG1683R(U) <http://www.zyaura.com/products/ZG1683R.asp>`__ (`MT8060 <https://masterkit.ru/shop/1921398>`__),
`ZG1583RUD <http://www.zyaura.com/products/ZG1583RUD.asp>`__
monitors with ESPHome.
.. figure:: images/zgm053-full.jpg
:align: center
:width: 80.0%
ZyAura ZGm053U CO2 & Temperature Monitor.
.. figure:: images/zgm053-connection.jpg
:align: center
:width: 80.0%
ZyAura ZGm053U connection diagram (1 - empty, 2 - clock, 3 - data, 4 - GND).
.. code-block:: yaml
# Example configuration entry
sensor:
- platform: zyaura
clock_pin: D1
data_pin: D2
co2:
name: "ZyAura CO2"
temperature:
name: "ZyAura Temperature"
humidity:
name: "ZyAura Humidity"
Configuration variables:
------------------------
- **clock_pin** (**Required**, :ref:`config-pin`): The pin where the clock bus is connected.
- **data_pin** (**Required**, :ref:`config-pin`): The pin where the data bus is connected.
- **co2** (*Optional*): The information for the CO2 sensor.
- **name** (**Required**, string): The name for the CO2 sensor.
- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
- All other options from :ref:`Sensor <config-sensor>`.
- **temperature** (*Optional*): The information for the temperature sensor.
- **name** (**Required**, string): The name for the temperature sensor.
- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
- All other options from :ref:`Sensor <config-sensor>`.
- **humidity** (*Optional*): The information for the humidity sensor
- **name** (**Required**, string): The name for the humidity sensor.
- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
- All other options from :ref:`Sensor <config-sensor>`.
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the
sensor. Defaults to ``60s``.
.. note::
ZGm05 monitor (and maybe others) needs some initial time to get correct data when powered
on. Only after this timespan will the sensor report correct values. It's not recommended to set
``update_interval`` lower than ``20s``.
See Also
--------
- :ref:`sensor-filters`
- :doc:`mhz19`
- `CO2mon-esp firmware <https://github.com/Anonym-tsk/co2mon-esp>`__ by `@anonym-tsk <https://github.com/Anonym-tsk>`__
- `Some information about hacking MT8060 <https://habr.com/ru/company/dadget/blog/394333/>`__
- `CO2MeterHacking project <https://revspace.nl/CO2MeterHacking>`__
- :apiref:`zyaura/zyaura.h`
- :ghedit:`Edit`

BIN
images/zgm053.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

View File

@ -138,6 +138,7 @@ Sensor Components
WiFi Signal Strength, components/sensor/wifi_signal, network-wifi.svg
Xiaomi MiFlora, components/sensor/xiaomi_miflora, xiaomi_miflora.jpg
Xiaomi MiJia, components/sensor/xiaomi_mijia, xiaomi_mijia.jpg
ZyAura, components/sensor/zyaura, zgm053.jpg
Custom Sensor, components/sensor/custom, language-cpp.svg
Looking for a sensor that outputs its values as an analog voltage? Have a look at the