diff --git a/components/index.rst b/components/index.rst index b34c68a4d0..581302cc1b 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/sensor/hdc302x, hdc302x.png, 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/components/sensor/hdc302x.rst b/components/sensor/hdc302x.rst new file mode 100644 index 0000000000..0a92498785 --- /dev/null +++ b/components/sensor/hdc302x.rst @@ -0,0 +1,73 @@ +HDC302x Temperature and Humidity Sensor +======================================= + +.. seo:: + :description: Instructions for setting up HDC302x temperature and humidity sensor for use with ESPHome. + :image: hdc302x.png + :keywords: HDC3020, HDC3021, HDC3022 + +The `hdc302x` sensor platform allows you to use your HDC302x temperature and humidity sensor +(`datasheet `__, +`Adafruit `__) with ESPHome. + +The :ref:`I²C Bus ` is required to be set up in your configuration for this sensor to work. + +.. figure:: images/hdc302x.png + :align: center + :width: 80.0% + +.. _Adafruit: https://www.adafruit.com/product/5989 + +.. code-block:: yaml + + sensor: + - platform: hdc302x + temperature: + name: "Temperature" + humidity: + name: "Relative Humidity" + update_interval: 60s + +Configuration variables: +------------------------ + +- **temperature** (*Optional*): Temperature. + + - All options from :ref:`Sensor `. + +- **humidity** (*Optional*): Relative Humidity. + + - All options from :ref:`Sensor `. + +- **power_mode** (*Optional*, enum): The Power Mode used when triggering temperature and humidity readings. This + affects the accuracy of readings and the power usage of the sensor. + + - ``HIGH_ACCURACY`` (Default): Low Power Mode 0 - Highest accuracy, slower, higher power usage. + - ``BALANCED`` + - ``LOW_POWER`` + - ``ULTRA_LOW_POWER``: Low Power Mode 3 - Lowest power usage, faster, less accuracy. + +- **heater** (*Optional*, boolean): If true, enable the relative humidity sensor's integrated heater. + *Note: This will significantly impact temperature readings.* + +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``. + +Heater Configuration: +--------------------- + +The HDC302X includes an integrated heater in the relative humidity sensor, which is intended to remove condensation +from the sensor in high humidity environments. This can help maintain accurate humidity measurements. + +The heater can be enabled by setting ``heater`` to ``true``. This will run the heater with the default sensor settings. + +See the (`datasheet `__) for more information about heater operation. + +See Also +-------- + +- :doc:`/components/sensor/sht4x` +- :doc:`/components/sensor/hdc1080` +- :ref:`sensor-filters` +- :doc:`absolute_humidity` +- :apiref:`hdc302x/hdc302x.h` +- :ghedit:`Edit` diff --git a/components/sensor/images/hdc302x.png b/components/sensor/images/hdc302x.png new file mode 100644 index 0000000000..c6edcb3750 Binary files /dev/null and b/components/sensor/images/hdc302x.png differ diff --git a/images/hdc302x.png b/images/hdc302x.png new file mode 100644 index 0000000000..62f6f7c26e Binary files /dev/null and b/images/hdc302x.png differ