esphome-docs/components/sensor/mics_4514.rst

56 lines
1.9 KiB
ReStructuredText

MiCS 4514 Gas Sensor
====================
.. seo::
:description: Instructions for setting up MiCS 4514 Gas sensors.
:image: mics_4514.jpg
:keywords: MiCS, 4514, MICS-4514
This component exposes the different gas concentration sensors from the `MiCS-4514 <https://www.dfrobot.com/product-2417.html>`__. This is a differnet sensor than the MICS-4514 being sold on AliExpress.
.. note::
The sensor has a 3-minute warmup period where data is unreliable and ESPHome will only start publishing sensor values after this time.
If the sensor was already powered only, such as if you restarted or updated your ESPHome device, then it will start publishing immediately.
The :ref:`I²C Bus <i2c>` is required to be set up in your configuration for this sensor to work.
.. code-block:: yaml
# Example configuration entry
sensor:
- platform: mics_4514
nitrogen_dioxide:
name: Nitrogen Dioxide
carbon_monoxide:
name: Carbon Monoxide
hydrogen:
name: Hydrogen
ethanol:
name: Ethanol
methane:
name: Methane
ammonia:
name: Ammonia
update_interval: 60s
Configuration variables:
------------------------
- **nitrogen_dioxide** (*Optional*): All options from :ref:`Sensor <config-sensor>`
- **carbon_monoxide** (*Optional*): All options from :ref:`Sensor <config-sensor>`
- **hydrogen** (*Optional*): All options from :ref:`Sensor <config-sensor>`
- **ethanol** (*Optional*): All options from :ref:`Sensor <config-sensor>`
- **methane** (*Optional*): All options from :ref:`Sensor <config-sensor>`
- **ammonia** (*Optional*): All options from :ref:`Sensor <config-sensor>`
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the
sensor. Defaults to ``60s``.
See Also
--------
- :ref:`sensor-filters`
- :apiref:`mics_4514/mics_4514.h`
- :ghedit:`Edit`