diff --git a/components/sensor/aht10.rst b/components/sensor/aht10.rst new file mode 100644 index 000000000..39115afe0 --- /dev/null +++ b/components/sensor/aht10.rst @@ -0,0 +1,62 @@ +AHT10 Temperature+Humidity Sensor +================================= + +.. seo:: + :description: Instructions for setting up AHT10 temperature and humidity sensors + :image: aht10.jpg + :keywords: aht10 + +The ``aht10`` Temperature+Humidity sensor allows you to use your aht10 +(`datasheet `__) i2c-based sensor with ESPHome. + +.. figure:: images/aht10-full.jpg + :align: center + :width: 50.0% + + AHT10 Temperature & Humidity Sensor. + +.. figure:: images/temperature-humidity.png + :align: center + :width: 80.0% + +.. note:: + + When configured for humidity, the log *'Components should block for at most 20-30ms in loop().'* will be generated in verbose mode. This is due to technical specs of the sensor and can not be avoided. + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: aht10 + temperature: + name: "Living Room Temperature" + humidity: + name: "Living Room Humidity" + 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 `. + +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``. + + +See Also +-------- + +- :ref:`sensor-filters` +- :apiref:`aht10/aht10.h` +- `AHT10 Library `__ by `Thinary Electronic `__ +- `Unofficial Translated AHT10 Datasheet (en) `__ +- :ghedit:`Edit` diff --git a/components/sensor/images/aht10-full.jpg b/components/sensor/images/aht10-full.jpg new file mode 100644 index 000000000..b7fd56b5e Binary files /dev/null and b/components/sensor/images/aht10-full.jpg differ diff --git a/images/aht10.jpg b/images/aht10.jpg new file mode 100644 index 000000000..81bfa628d Binary files /dev/null and b/images/aht10.jpg differ diff --git a/index.rst b/index.rst index 07954080e..a53fabd58 100644 --- a/index.rst +++ b/index.rst @@ -92,6 +92,7 @@ Sensor Components ADC, components/sensor/adc, flash.svg ADE7953, components/sensor/ade7953, ade7953.svg ADS1115, components/sensor/ads1115, ads1115.jpg + AHT10, components/sensor/aht10, aht10.jpg AM2320, components/sensor/am2320, am2320.jpg APDS9960, components/sensor/apds9960, apds9960.jpg ATM90E32, components/sensor/atm90e32, atm90e32.jpg