Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 49 additions & 0 deletions components/hdc302x.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
HDC302x Temperature & Humidity Sensor
=====================================

.. seo::
:description: Instructions for setting up HDC302x temperature and humdiity sensor in ESPHome.
:image: hdc302x.jpg


.. figure:: ../images/hdc302x.jpg
:align: center
:width: 60.0%

Adafruit board for HDC302X.


Component
---------

The hdc302x component allows you to talk with the TI HDC302X series (`datasheet <https://www.ti.com/lit/ds/symlink/hdc3020.pdf>`__, `Adafruit <https://learn.adafruit.com/adafruit-hdc3021-precision-temperature-humidity-sensor/overview>`__) of temperature and humidity sensors over I2C. The :ref:`I2C <i2c>` is required to be set up in your configuration for this sensor to work.

.. code-block:: yaml

# Minimal configuration entry to report temperature & humidity
hdc302x:
temperature:
name: temp_a
id: temp_a
humidity:
name: humidity_a
id: humidity_a

Configuration variables:
************************

- **temperature** (*Optional*, :ref:`config-sensor`): Sensor configuration for temperature readings. If omitted, temperature will not be reported.
- **humidity** (*Optional*, :ref:`config-sensor`): Sensor configuration for humidity readings. If omitted, humidity will not be reported.
- **last_error** (*Optional*, :ref:`config-text_sensor`): Configuration for text sensor reporting last error encountered talking to the hdc302x sensor.
- **i2c_id** (*Optional*): The I²C Bus ID to use.
- **update_interval** (*Optional*, :ref:`config-time`): Interval in seconds between temperature and humidity updates.
Defaults to ``60s``.

See Also
--------

- :ref:`i2c`
- :ref:`config-sensor`
- :ref:`config-text_sensor`
- :apiref:`API Reference (HDC302X) <hdc302x/hdx302x.h>`
- :ghedit:`Edit`
1 change: 1 addition & 0 deletions components/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -392,6 +392,7 @@ Environmental
ENS160, components/sensor/ens160, ens160.jpg, CO2 & Air Quality
ENS210, components/sensor/ens210, ens210.jpg, Temperature & Humidity
HDC1080, components/sensor/hdc1080, hdc1080.jpg, Temperature & Humidity
HDC302X, components/hdc302x, hdc302x.jpg, Temperature & Humidity
HHCCJCY10 (MiFlora Pink), components/sensor/xiaomi_hhccjcy10, xiaomi_hhccjcy10.jpg, Soil moisture & Temperature & Light
Honeywell ABP, components/sensor/honeywellabp, honeywellabp.jpg, Pressure & Temperature
Honeywell ABP2 I2C, components/sensor/honeywellabp2_i2c, honeywellabp.jpg, Pressure & Temperature
Expand Down
Binary file added images/hdc302x.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.