From f6fb4c45b4e545f3b66a4e8578a16b892c59d887 Mon Sep 17 00:00:00 2001 From: jpfaff Date: Wed, 25 Oct 2023 20:28:13 +0200 Subject: [PATCH] Honeywellabp2 (#3204) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/sensor/honeywellabp2_i2c.rst | 62 +++++++++++++++++++++++++ index.rst | 1 + 2 files changed, 63 insertions(+) create mode 100644 components/sensor/honeywellabp2_i2c.rst diff --git a/components/sensor/honeywellabp2_i2c.rst b/components/sensor/honeywellabp2_i2c.rst new file mode 100644 index 000000000..5d0538367 --- /dev/null +++ b/components/sensor/honeywellabp2_i2c.rst @@ -0,0 +1,62 @@ +Honeywell ABP 2 Pressure Sensors +================================ + +.. seo:: + :description: Instructions for setting up Honeywell ABP2 Pressure sensors + :image: honeywellabp.jpg + :keywords: Honeywell ABP2 + +The ``honeywellabp2_i2c`` sensor platform allows you to use your Honeywell ABP +(`website `__, +`datasheet `_) +pressure and temperature sensors with ESPHome. The :ref:`I2C ` is +required to be set up in your configuration for this sensor to work + +.. figure:: images/honeywellabp.jpg + :align: center + :width: 50.0% + + Honeywell ABP Pressure and Temperature Sensor. + +.. code-block:: yaml + + sensor: + - platform: honeywellabp2_i2c + pressure: + name: "Honeywell2 pressure" + min_pressure: 0 + max_pressure: 16000 + transfer_function: "A" + temperature: + name: "Honeywell2 temperature" + +Configuration variables: +------------------------ + +The values for ``min_pressure`` and ``max_pressure`` and ``transfer_function`` can be found in the device datasheet for the specific device. +These are used to calculate the pressure reading published by the sensor. Some sensors measure pressure in ``bar`` or ``Psi``; +set ``min_pressure`` and ``max_pressure`` to the measurement range, ``transfer_function`` to ``A`` or ``B`` and ``unit_of_measurement`` to the appropriate unit for your device. + +- **pressure** (*Optional*): The information for the pressure sensor. + + - **min_pressure** (**Required**, int or float): Minimum pressure for the pressure sensor. + - **max_pressure** (**Required**, int or float): Maximum pressure for the pressure sensor. + - **transfer_function** (**Required**, "A" or "B"): Transfer function used by the pressure sensor. + - All other options from :ref:`Sensor `. + +Some sensors do not have temperature sensing ability, see datasheet. In some cases the sensor may return a valid temperature even though the +datasheet indicates that the sensor does not measure temperature. + +- **temperature** (*Optional*): The information for the temperature sensor. + All 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:`honeywellabp/honeywellabp2.h` +- :ghedit:`Edit` diff --git a/index.rst b/index.rst index 5d48c9171..575f666f1 100644 --- a/index.rst +++ b/index.rst @@ -312,6 +312,7 @@ Environmental HDC1080, components/sensor/hdc1080, hdc1080.jpg, Temperature & Humidity HTE501, components/sensor/hte501, HTE501.png, Temperature & Humidity Honeywell ABP, components/sensor/honeywellabp, honeywellabp.jpg, Pressure & Temperature + Honeywell ABP2 I2C, components/sensor/honeywellabp2_i2c, honeywellabp.jpg, Pressure & Temperature HTU21D / Si7021 / SHT21, components/sensor/htu21d, htu21d.jpg, Temperature & Humidity Hydreon Rain Sensor, components/sensor/hydreon_rgxx, hydreon_rg9.jpg, Rain Inkbird IBS-TH1 Mini, components/sensor/inkbird_ibsth1_mini, inkbird_isbth1_mini.jpg, Temperature & Humidity