esphome-docs/components/sensor/mics_4514.rst
smoke007 3967374318
Update mics_4514.rst (#2862)
MICS-4514 being sold on AliExpress has the same model number, but is a different board that doesn't use I²C Bus.  Adding a note about this as a warning for anyone shopping for this sensor.
2023-05-31 15:38:01 +02:00

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`