From 7a47e29679f0baa98dc97ad16e24472f111f6391 Mon Sep 17 00:00:00 2001 From: Nad <15346053+valordk@users.noreply.github.com> Date: Sat, 19 Oct 2019 21:32:59 +0200 Subject: [PATCH] Add documentation for SHTCx Temperature sensors (#305) * Add documentation for STS3x Temperature sensors * Updated formatting * Updated index and other temperature sensors with link to STS3x sensor * Added STS31 sensor photo * Add documentation for SHTCx Temperature sensors * Fixed reference to a sensor thumbnail * Cleaned up changes leaked from STS3x feature * Remove references on other pages It's already getting too cluttered... * Remove references Co-authored-by: Otto Winter --- components/sensor/images/shtc3.jpg | Bin 0 -> 18344 bytes components/sensor/images/sts3x.jpg | Bin 0 -> 9930 bytes components/sensor/shtcx.rst | 65 +++++++++++++++++++++++++++++ images/shtc3.jpg | Bin 0 -> 18344 bytes images/sts3x.jpg | Bin 0 -> 9930 bytes index.rst | 1 + 6 files changed, 66 insertions(+) create mode 100644 components/sensor/images/shtc3.jpg create mode 100644 components/sensor/images/sts3x.jpg create mode 100644 components/sensor/shtcx.rst create mode 100644 images/shtc3.jpg create mode 100644 images/sts3x.jpg diff --git a/components/sensor/images/shtc3.jpg b/components/sensor/images/shtc3.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9235518231d69285f61392cc86c7e1b72fbe9586 GIT binary patch literal 18344 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, +`Sensirion STHC1 `__) and +the newer SHTC3 +(`datasheet `__, +`Sparkfun`_ ) sensors with +ESPHome. The :ref:`I²C Bus ` is +required to be set up in your configuration for this sensor to work. + +.. _Sparkfun: https://www.sparkfun.com/products/15074 + +.. figure:: images/temperature-humidity.png + :align: center + :width: 80.0% + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: shtcx + temperature: + name: "Living Room Temperature" + humidity: + name: "Living Room Humidity" + address: 0x70 + update_interval: 60s + +Configuration variables: +------------------------ + +- **temperature** (**Required**): 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 `. + +- **humidity** (**Required**): 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 `. + +- **address** (*Optional*, int): Manually specify the i^2c address of the sensor. + Defaults to ``0x70``. +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the + sensor. Defaults to ``60s``. + +See Also +-------- + +- :ref:`sensor-filters` +- :doc:`dht` +- :doc:`dht12` +- :doc:`hdc1080` +- :doc:`htu21d` +- :doc:`sht3xd` +- :apiref:`shtcx/shtcx.h` +- :ghedit:`Edit` diff --git a/images/shtc3.jpg b/images/shtc3.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9235518231d69285f61392cc86c7e1b72fbe9586 GIT binary patch literal 18344 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