Skip to content

Commit 5942d80

Browse files
paveldnpdudnytskyi
authored andcommitted
Help updated 2
1 parent a351952 commit 5942d80

2 files changed

Lines changed: 30 additions & 27 deletions

File tree

README.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ This is an implementation of the ESPHome component to control HVAC on the base o
1313

1414
There are two versions of the Haier protocol: the older version uses an application called SmartAir2 while the newer version uses an application called hOn. Both protocols are compatible on the transport level but utilize different commands to control appliances.
1515

16-
Older Haier models controlled by the SmartAir2 application are using the KZW-W002 module. This module can't be reused, and you need to replace it with an ESP or RPI Pico W module. The USB connector on the board doesn't support the USB protocol. It is a UART port that just uses a USB connector. To connect the ESP board to your AC you can cut a USB type A cable and connect wires to the climate connector.
16+
Older Haier models controlled by the SmartAir2 application are using the KZW-W002 module. This module cant be reused, and you need to replace it with an ESP or RPI Pico W module. The USB connector on the board doesnt support the USB protocol. It is a UART port that just uses a USB connector. To connect the ESP board to your AC you can cut a USB type A cable and connect wires to the climate connector.
1717

1818
.. list-table:: Haier UART pinout
1919
:header-rows: 1
@@ -43,7 +43,7 @@ Older Haier models controlled by the SmartAir2 application are using the KZW-W00
4343

4444
<p><a href="./docs/esphome-docs/climate/images/usb_pinout.png?raw=true"><img src="./docs/esphome-docs/climate/images/usb_pinout.png?raw=true" height="70%" width="70%"></a><br><i>&emsp;KZW-W002 module pinout</i></p>
4545

46-
Newer Haier models using a module called ESP32-for-Haier. It is an ESP32 single-core board with an ESP32-S0WD chip. In some cases, you can reuse this module and flash it with ESPHome, but some new modules don't support this. They look the same but have encryption enabled.
46+
Newer Haier models using a module called ESP32-for-Haier. It is an ESP32 single-core board with an ESP32-S0WD chip. In some cases, you can reuse this module and flash it with ESPHome, but some new modules dont support this. They look the same but have encryption enabled.
4747

4848
**Warning!** The new generation of ESP32-Haier devices has encryption enabled, so they can only be flashed with firmware that is signed with a private key. There is no way to make them work with ESPHome, so if you try to do it, the board will get into a boot loop with the error ``rst:0x10 (RTCWDT_RTC_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)`` The only way to recover this board is to flash it with the original image. So before starting your experiments make a backup image.
4949

@@ -536,7 +536,7 @@ Configuration variables:
536536
Haier Climate Switches
537537
======================
538538

539-
Additional switches to support additional features for Haier AC.
539+
Switches to support additional features for Haier AC.
540540

541541
.. code-block:: yaml
542542

docs/esphome-docs/climate/haier.rst

Lines changed: 27 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This is an implementation of the ESPHome component to control HVAC on the base o
99

1010
There are two versions of the Haier protocol: the older version uses an application called SmartAir2 while the newer version uses an application called hOn. Both protocols are compatible on the transport level but utilize different commands to control appliances.
1111

12-
Older Haier models controlled by the SmartAir2 application are using the KZW-W002 module. This module can't be reused, and you need to replace it with an ESP or RPI Pico W module. The USB connector on the board doesn't support the USB protocol. It is a UART port that just uses a USB connector. To connect the ESP board to your AC you can cut a USB type A cable and connect wires to the climate connector.
12+
Older Haier models controlled by the SmartAir2 application are using the KZW-W002 module. This module cant be reused, and you need to replace it with an ESP or RPI Pico W module. The USB connector on the board doesnt support the USB protocol. It is a UART port that just uses a USB connector. To connect the ESP board to your AC you can cut a USB type A cable and connect wires to the climate connector.
1313

1414
.. list-table:: Haier UART pinout
1515
:header-rows: 1
@@ -41,7 +41,7 @@ Older Haier models controlled by the SmartAir2 application are using the KZW-W00
4141

4242
KZW-W002 module pinout
4343

44-
Newer Haier models using a module called ESP32-for-Haier. It is an ESP32 single-core board with an ESP32-S0WD chip. In some cases, you can reuse this module and flash it with ESPHome, but some new modules don't support this. They look the same but have encryption enabled.
44+
Newer Haier models using a module called ESP32-for-Haier. It is an ESP32 single-core board with an ESP32-S0WD chip. In some cases, you can reuse this module and flash it with ESPHome, but some new modules dont support this. They look the same but have encryption enabled.
4545

4646
**Warning!** The new generation of ESP32-Haier devices has encryption enabled, so they can only be flashed with firmware that is signed with a private key. There is no way to make them work with ESPHome, so if you try to do it, the board will get into a boot loop with the error ``rst:0x10 (RTCWDT_RTC_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)`` The only way to recover this board is to flash it with the original image. So before starting your experiments make a backup image.
4747

@@ -82,28 +82,28 @@ This component requires a :ref:`UART bus <uart>` to be setup.
8282
- VERTICAL
8383
- HORIZONTAL
8484
- BOTH
85-
supported_presets:
85+
supported_presets:
8686
- AWAY
8787
- BOOST
8888
- SLEEP
89-
on_alarm_start:
90-
then:
91-
- logger.log:
92-
level: WARN
93-
format: "Alarm activated. Code: %d. Message: \"%s\""
94-
args: [ code, message]
95-
on_alarm_end:
96-
then:
97-
- logger.log:
98-
level: INFO
99-
format: "Alarm deactivated. Code: %d. Message: \"%s\""
100-
args: [ code, message]
101-
on_status_message:
102-
then:
103-
- logger.log:
104-
level: INFO
105-
format: "New status message received, size=%d, subcmd=%02X%02X"
106-
args: [ 'data_size', 'data[0]', 'data[1]' ]
89+
on_alarm_start:
90+
then:
91+
- logger.log:
92+
level: WARN
93+
format: "Alarm activated. Code: %d. Message: \"%s\""
94+
args: [ code, message]
95+
on_alarm_end:
96+
then:
97+
- logger.log:
98+
level: INFO
99+
format: "Alarm deactivated. Code: %d. Message: \"%s\""
100+
args: [ code, message]
101+
on_status_message:
102+
then:
103+
- logger.log:
104+
level: INFO
105+
format: "New status message received, size=%d, subcmd=%02X%02X"
106+
args: [ 'data_size', 'data[0]', 'data[1]' ]
107107
108108
109109
Configuration variables:
@@ -141,7 +141,8 @@ This automation will be triggered when a new alarm is activated by AC. The error
141141
.. code-block:: yaml
142142
143143
climate:
144-
- protocol: hon
144+
- platform: haier
145+
protocol: hon
145146
on_alarm_start:
146147
then:
147148
- logger.log:
@@ -159,7 +160,8 @@ This automation will be triggered when a previously activated alarm is deactivat
159160
.. code-block:: yaml
160161
161162
climate:
162-
- protocol: hon
163+
- platform: haier
164+
protocol: hon
163165
on_alarm_end:
164166
then:
165167
- logger.log:
@@ -178,7 +180,8 @@ This trigger can be used to support some features that unique for the model and
178180
.. code-block:: yaml
179181
180182
climate:
181-
- protocol: hon
183+
- platform: haier
184+
protocol: hon
182185
on_status_message:
183186
then:
184187
- logger.log:

0 commit comments

Comments
 (0)