Help for additional haier climete sensors added (#3628)

Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Co-authored-by: Pavlo Dudnytskyi <pdudnytskyi@astrata.eu>

components/binary_sensor/haier.rst

@@ -0,0 +1,68 @@
+Haier Climate Binary Sensors
+============================
+
+.. seo::
+    :description: Instructions for setting up additional binary sensors for Haier climate devices.
+    :image: haier.svg
+
+Additional sensors for Haier Climate device. **These sensors are supported only by the hOn protocol**.
+
+
+.. figure:: images/haier-climate.jpg
+    :align: center
+    :width: 50.0%
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    uart:
+      baud_rate: 9600
+      tx_pin: 17
+      rx_pin: 16
+      id: ac_port
+    
+    climate:
+      - platform: haier
+        id: haier_ac
+        protocol: hOn
+        name: Haier AC
+        uart_id: ac_port
+    
+    binary_sensor:
+      - platform: haier
+        haier_id: haier_ac
+        compressor_status:
+          name: Haier Outdoor Compressor Status
+        defrost_status:
+          name: Haier Defrost Status
+        four_way_valve_status:
+          name: Haier Four Way Valve Status
+        indoor_electric_heating_status:
+          name: Haier Indoor Electric Heating Status
+        indoor_fan_status:
+          name: Haier Indoor Fan Status
+        outdoor_fan_status:
+          name: Haier Outdoor Fan Status
+
+Configuration variables:
+------------------------
+
+- **haier_id** (**Required**, :ref:`config-id`): The id of haier climate component
+- **compressor_status** (*Optional*): A binary sensor that indicates Haier climate compressor activity.
+  All options from :ref:`Binary Sensor <config-binary_sensor>`.
+- **defrost_status** (*Optional*): A binary sensor that indicates defrost procedure activity.
+  All options from :ref:`Binary Sensor <config-binary_sensor>`.
+- **four_way_valve_status** (*Optional*): A binary sensor that indicates four way valve status.
+  All options from :ref:`Binary Sensor <config-binary_sensor>`.
+- **indoor_electric_heating_status** (*Optional*): A binary sensor that indicates electrical heating system activity.
+  All options from :ref:`Binary Sensor <config-binary_sensor>`.
+- **indoor_fan_status** (*Optional*): A binary sensor that indicates indoor fan activity. 
+  All options from :ref:`Binary Sensor <config-binary_sensor>`.
+- **outdoor_fan_status** (*Optional*): A binary sensor that indicates outdoor fan activity. 
+  All options from :ref:`Binary Sensor <config-binary_sensor>`.
+
+See Also
+--------
+
+- :doc:`Haier Climate </components/climate/haier>`
+- :ghedit:`Edit`

components/climate/haier.rst

@@ -74,8 +74,6 @@ This component requires a :ref:`uart` to be setup.
         wifi_signal: true
         beeper: true
         display: true
-        outdoor_temperature:
-          name: Haier AC outdoor temperature
         visual:
           min_temperature: 16 °C
           max_temperature: 30 °C
@@ -125,16 +123,11 @@ Configuration variables:
 - **control_method** (*Optional*, list): (supported only by hOn) Defines control method (should be supported by AC). Supported values: MONITOR_ONLY - no control, just monitor status, SET_GROUP_PARAMETERS - set all AC parameters with one command (default method), SET_SINGLE_PARAMETER - set each parameter individually (this method is supported by some new ceiling ACs like AD71S2SM3FA)
 - **display** (*Optional*, boolean): Can be used to set the AC display off.
 - **beeper** (*Optional*, boolean): Can be used to disable beeping on commands from AC. Supported only by hOn protocol.
-- **outdoor_temperature** (*Optional*): Temperature sensor for outdoor temperature. Supported only by hOn protocol.
-
-  - **name** (**Required**, string): The name of the sensor.
-  - **id** (*Optional*, :ref:`config-id`): ID of the sensor, can be used for code generation
-  - All other options from :ref:`Sensor <config-sensor>`.
 - **supported_modes** (*Optional*, list): Can be used to disable some of AC modes. Possible values: 'OFF', HEAT_COOL, COOL, HEAT, DRY, FAN_ONLY
 - **supported_swing_modes** (*Optional*, list): Can be used to disable some swing modes if your AC does not support it. Possible values: 'OFF', VERTICAL, HORIZONTAL, BOTH
 - **supported_presets** (*Optional*, list): Can be used to disable some presets. Possible values for smartair2 are: AWAY, BOOST, COMFORT. Possible values for hOn are: AWAY, ECO, BOOST, SLEEP. AWAY preset can be enabled only in HEAT mode, it is disabled by default
-- **on_alarm_start (Optional, :ref:`Automation <automation>`):** (supported only by hOn) Automation to perform when AC activates a new alarm. See :ref:`haier-on_alarm_start`
-- **on_alarm_end (Optional, :ref:`Automation <automation>`):** (supported only by hOn) Automation to perform when AC deactivates a new alarm. See :ref:`haier-on_alarm_end`
+- **on_alarm_start** (*Optional*, :ref:`Automation <automation>`): (supported only by hOn) Automation to perform when AC activates a new alarm. See :ref:`haier-on_alarm_start`
+- **on_alarm_end** (*Optional*, :ref:`Automation <automation>`): (supported only by hOn) Automation to perform when AC deactivates a new alarm. See :ref:`haier-on_alarm_end`
 - All other options from :ref:`Climate <config-climate>`.
 
 Automations
@@ -327,6 +320,8 @@ See Also
 --------
 
 - `haier-esphome <https://github.com/paveldn/haier-esphome>`__
+- :doc:`Haier Climate Sensors </components/sensor/haier>`
+- :doc:`Haier Climate Binary Sensors </components/binary_sensor/haier>`
 - :doc:`/components/climate/index`
 - :apiref:`haier/climate/haier.h`
 - :ghedit:`Edit`

components/sensor/haier.rst

@@ -0,0 +1,90 @@
+Haier Climate Sensors
+=====================
+
+.. seo::
+    :description: Instructions for setting up additional sensors for Haier climate devices.
+    :image: haier.svg
+
+Additional sensors for Haier Climate device. **These sensors are supported only by the hOn protocol**.
+
+
+.. figure:: images/haier-climate.jpg
+    :align: center
+    :width: 50.0%
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    uart:
+      baud_rate: 9600
+      tx_pin: 17
+      rx_pin: 16
+      id: ac_port
+    
+    climate:
+      - platform: haier
+        id: haier_ac
+        protocol: hOn
+        name: Haier AC
+        uart_id: ac_port
+    
+    sensor:
+      - platform: haier
+        haier_id: haier_ac
+        outdoor_temperature:
+          name: Haier outdoor temperature
+        humidity:
+          name: Haier Indoor Humidity
+        compressor_current:
+          name: Haier Compressor Current
+        compressor_frequency:
+          name: Haier Compressor Frequency
+        expansion_valve_open_degree:
+          name: Haier Expansion Valve Open Degree
+        indoor_coil_temperature:
+          name: Haier Indoor Coil Temperature
+        outdoor_coil_temperature:
+          name: Haier Outdoor Coil Temperature
+        outdoor_defrost_temperature:
+          name: Haier Outdoor Defrost Temperature
+        outdoor_in_air_temperature:
+          name: Haier Outdoor In Air Temperature
+        outdoor_out_air_temperature:
+          name: Haier Outdoor Out Air Temperature
+        power:
+          name: Haier Power
+
+Configuration variables:
+------------------------
+
+- **haier_id** (**Required**, :ref:`config-id`): The id of haier climate component
+- **outdoor_temperature** (*Optional*): Temperature sensor for outdoor temperature.
+  All options from :ref:`Sensor <config-sensor>`.
+- **humidity** (*Optional*): Sensor for indoor humidity. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+- **compressor_current** (*Optional*): Sensor for climate compressor current. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+- **compressor_frequency** (*Optional*): Sensor for climate compressor frequency. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+- **expansion_valve_open_degree** (*Optional*): Sensor for climate's expansion valve open degree. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+- **indoor_coil_temperature** (*Optional*): Temperature sensor for indoor coil temperature. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+- **outdoor_coil_temperature** (*Optional*): Temperature sensor for outdoor coil temperature. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+- **outdoor_defrost_temperature** (*Optional*): Temperature sensor for outdoor defrost temperature. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+- **outdoor_in_air_temperature** (*Optional*): Temperature sensor incoming air temperature.
+  All options from :ref:`Sensor <config-sensor>`.
+- **outdoor_out_air_temperature** (*Optional*): Temperature sensor for outgoing air temperature.
+  All options from :ref:`Sensor <config-sensor>`.
+- **power** (*Optional*): Sensor for climate power consumption. Make sure that your climate model supports this type of sensor.
+  All options from :ref:`Sensor <config-sensor>`.
+
+
+See Also
+--------
+
+- :doc:`Haier Climate </components/climate/haier>`
+- :ref:`sensor-filters`
+- :ghedit:`Edit`