esphome-docs/components/climate/haier.rst
Yaroslav Heriatovych ac71defd45
Add haier climate component (#2431)
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
2023-02-23 15:05:54 +13:00

87 lines
2.1 KiB
ReStructuredText

Haier Climate
=============
.. seo::
:description: Instructions for setting up a Haier climate devices.
:image: air-conditioner.svg
The `haier` climate platform creates a Haier climate device.
The component can be used as a replacement of a Haier proprietary WiFi modules such as KZW-W001 and KZW-W002.
This component requires a :ref:`uart` to be setup.
.. code-block:: yaml
logger:
baud_rate: 0 #Disable UART logging for ESP8266
uart:
rx_pin: GPIO3
tx_pin: GPIO1
baud_rate: 9600
climate:
platform: haier
name: Haier AC
supported_swing_modes:
- VERTICAL
- HORIZONTAL
- BOTH
Configuration variables:
------------------------
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- **name** (**Required**, string): The name of the climate device.
- **update_interval** (*Optional*, :ref:`config-time`): How often device will be polled for status. Defaults to `5s`.
- **supported_swing_modes** (*Optional*, list): List of supported swing modes. Possible values are: ``VERTICAL``, ``HORIZONTAL``, ``BOTH``.
- All other options from :ref:`Climate <config-climate>`.
Hardware setup
--------------
Most units will have a dedicated USB-A port for Haier WiFi module.
The physical USB port is in fact UART and does not "speak" USB protocol.
It uses four USB pins as 5V, GND, RX, TX.
You can use spare male USB cable to connect esphome device directly to the climate appliance.
Other units will not have USB ports, but will still probably have UART exposed somewhere on the main board.
.. list-table:: Haier UART pinout
:header-rows: 1
* - Board
- USB
- Wire color
- ESP8266
* - 5V
- VCC
- red
- 5V
* - GND
- GND
- black
- GND
* - TX
- DATA+
- green
- RX
* - RX
- DATA-
- white
- TX
.. figure:: images/usb_pinout.png
:align: center
:width: 70.0%
USB Pinout
See Also
--------
- `esphaier <https://github.com/MiguelAngelLV/esphaier>`__
- :doc:`/components/climate/index`
- :apiref:`haier/climate/haier.h`
- :ghedit:`Edit`