esphome-docs/esphomeyaml/components/sensor/sht3xd.rst

72 lines
2.4 KiB
ReStructuredText
Raw Normal View History

2018-05-14 21:15:49 +02:00
SHT3X-D Temperature+Humidity Sensor
2018-05-16 20:02:48 +02:00
===================================
2018-05-14 21:15:49 +02:00
.. warning::
This sensor is experimental has not been fully tested yet as I do not own all sensors. If you
2018-05-16 20:02:48 +02:00
can verify it works (or if it doesn't), please notify me on `discord <https://discord.gg/KhAMKrd>`__.
2018-05-14 21:15:49 +02:00
The ``sht3xd`` sensor platform Temperature+Humidity sensor allows you to use your Sensiron SHT31-D
(`datasheet <https://cdn-shop.adafruit.com/product-files/2857/Sensirion_Humidity_SHT3x_Datasheet_digital-767294.pdf>`__,
`Adafruit`_ ) sensors with
2018-06-01 18:10:00 +02:00
esphomelib. The :ref:`I²C Bus <i2c>` is
2018-05-14 21:15:49 +02:00
required to be set up in your configuration for this sensor to work.
2018-06-01 18:10:00 +02:00
.. figure:: images/sht3xd-full.jpg
:align: center
:target: `Adafruit`_
:width: 50.0%
2018-05-14 21:15:49 +02:00
2018-06-01 18:10:00 +02:00
SHT3X-D Temperature & Humidity Sensor. Image by `Adafruit`_.
2018-05-14 21:15:49 +02:00
.. _Adafruit: https://www.adafruit.com/product/2857
2018-06-01 18:10:00 +02:00
.. figure:: images/temperature-humidity.png
:align: center
:width: 80.0%
2018-05-14 21:15:49 +02:00
.. code:: yaml
# Example configuration entry
sensor:
- platform: sht3xd
temperature:
name: "Living Room Temperature"
humidity:
name: "Living Room Humidity"
accuracy: high
address: 0x44
update_interval: 15s
Configuration variables:
~~~~~~~~~~~~~~~~~~~~~~~~
2018-06-01 18:10:00 +02:00
- **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 <config-sensor>` and :ref:`MQTT Component <config-mqtt-component>`.
- **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 <config-sensor>` and :ref:`MQTT Component <config-mqtt-component>`.
- **address** (*Optional*, int): Manually specify the i^2c address of the sensor.
Defaults to ``0xff``.
- **accuracy** (*Optional*, string): The accuracy of the sensor. One of ``low``, ``medium`` and ``high``.
Defaults to ``high``.
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the
sensor. Defaults to ``15s``.
See Also
^^^^^^^^
- :ref:`sensor-filters`
- :doc:`dht`
- :doc:`dht12`
- :doc:`hdc1080`
- :doc:`htu21d`
- :doc:`API Reference </api/sensor/sht3xd>`