mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-28 17:48:35 +01:00
ac71defd45
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
87 lines
2.1 KiB
ReStructuredText
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`
|