From b7a6bc4d78e4c8212c9a79275e103afbcaae10c4 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 25 Jan 2023 09:58:48 +1300 Subject: [PATCH] Add documentation for MiCS 4514 (#2605) --- components/sensor/mics_4514.rst | 48 ++++++++++++++++++++++++++++++++ images/mics_4514.jpg | Bin 0 -> 36642 bytes index.rst | 1 + 3 files changed, 49 insertions(+) create mode 100644 components/sensor/mics_4514.rst create mode 100644 images/mics_4514.jpg diff --git a/components/sensor/mics_4514.rst b/components/sensor/mics_4514.rst new file mode 100644 index 000000000..7ee7f7e81 --- /dev/null +++ b/components/sensor/mics_4514.rst @@ -0,0 +1,48 @@ +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 `__. + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: mics_4514 + nitrogen_dioxide: + name: Nitrogen Dioxide + carbon_monoxide: + name: Carbon Monxide + hydrogen: + name: Hydrogen + ethanol: + name: Ethanol + methane: + name: Methane + ammonia: + name: Ammonia + update_interval: 60s + +Configuration variables: +------------------------ + +- **pin** (**Required**, :ref:`config-pin`): The pin where the DHT bus is connected. +- **nitrogen_dioxide** (*Optional*): All options from :ref:`Sensor ` +- **carbon_monoxide** (*Optional*): All options from :ref:`Sensor ` +- **hydrogen** (*Optional*): All options from :ref:`Sensor ` +- **ethanol** (*Optional*): All options from :ref:`Sensor ` +- **methane** (*Optional*): All options from :ref:`Sensor ` +- **ammonia** (*Optional*): All options from :ref:`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` diff --git a/images/mics_4514.jpg b/images/mics_4514.jpg new file mode 100644 index 0000000000000000000000000000000000000000..da99e90f16d09d8c30bad0e9e066197d110b501f GIT binary patch literal 36642 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