diff --git a/components/hdc302x.rst b/components/hdc302x.rst new file mode 100644 index 0000000000..602ce623df --- /dev/null +++ b/components/hdc302x.rst @@ -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 `__, `Adafruit `__) of temperature and humidity sensors over I2C. The :ref:`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) ` +- :ghedit:`Edit` diff --git a/components/index.rst b/components/index.rst index 17cdd0481a..d81c49606a 100644 --- a/components/index.rst +++ b/components/index.rst @@ -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 diff --git a/images/hdc302x.jpg b/images/hdc302x.jpg new file mode 100644 index 0000000000..f137fb6127 Binary files /dev/null and b/images/hdc302x.jpg differ