====== HaierPi Wiki ======

[[http://www.gnu.org/licenses/agpl-3.0|{{ :license-agpl-blue.svg |}}]]

This project allows you to control HAIER heat pumps. 
===== Tested with =====
  - AU082FYCRA(HW)
  - AU162FYCRA(HW)

All tests were performed on a pump with an additional ATW-a01 unit

However, it should work with all pumps that feature the YR-e27 remote control

If you have any question you can find me on discord:

[[https://discord.gg/dVXmAfWt3P|{{:discord.png?400|}}]]

===== Contributors =====

  * @kocur on discord channel
  * @Radek on discord channel

===== Donation =====

If you like My work and want to support me, you can:

[<img width="150px" src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png">](https://www.buymeacoffee.com/jacekbrzozZ)

Or if you from Poland:

[<img width="150px" src="https://buycoffee.to/btn/buycoffeeto-btn-primary.svg">](https://buycoffee.to/jacekbrzozz)


====== HARDWARE ======


===== PCB =====

PCB layout is designed for both RaspberryPi zeroW and NanoPi neo 1.4.

![Front](https://github.com/ktostam/HaierPi/blob/master/images/haierpi-front.png?raw=true)

![Front](https://github.com/ktostam/HaierPi/blob/master/images/haierpi-back.png?raw=true)

===== Component List =====


| **Symbol**        | **Value**            | **Footprint**        |
| J1            | ADC-002          | ADC-002          |
| H3-H4         | JST XH 3         | JST-XH-TH-3-2.5  |
| POMPA,YR-E27  | JST XH 4         | JST-XH-TH-4-2.5  |
| CON1-CON3     | DG308-2.54/2     |                  |
| R1-R4         | 1K               | SMD 0805         |
| R5-R8,R10-R12 | 4.7K             | SMD 0805         |
| R9            | 120              | SMD 0805         |
| R13-R15       | 0                | SMD 0805         |
| R16-R17       | 330              | SMD 0805         |
| C1            | 104              | SMD 0805         |
| LED1          | RED              | SMD 0805         |
| LED2          | GREEN            | SMD 0805         |
| D1-D4         | 1N4007W          | SOD-123          |
| D5-D7         | SMAJ12CA         | DO214AC          |
| REL1          | N4078-2C-5V-0.2W | N4078-2C-5V-0.2W |
| REL2-REL4     | HFD23-005-1ZS    | HFD23-005-1ZS    |
| U1            | MAX3485          | SOP-8            |

===== ERRATA =====

In the first batch of PCB's was error
PCB descriptions of R1 and R2 are swapped places, so if you have that PCB,
you need to solder 1K resistor on R6 and 4.7 on R1

===== Disclaimer =====

  * R9 is RS485 EOL resistor. For this application don't solder it.
  * Resistor R14-R15 is for choosing what type to board you want to connect (Raspberrypi/NanoPi Neo). For NanoPi, solder 0 Ohm resistor for powering NanoPi via GPIO. `If you connect Raspberry Pi don't solder it`, because powering RPi from GPIO bypasses builtin protections. I will be work but its not safe. If you connecting Raspberry Pi zero W, connect `J2`(GND) to `PP6` pad, and `J3`(+5V) to `PP1` pad. 

===== Raspberry Pi =====

if you want to use the script on the raspberry pi, you need to add the following settings to **config.txt**:
<code>
dtoverlay=w1-gpio,gpiopin=4
dtoverlay=pi3-disable-bt
enable_uart=1
</code>
Be aware that this settings will disable bluetooth. but we need use UART0

===== Nano Pi neo 1.4 =====

Script is also tested on NanoPi neo 1.4. For now no change is required, but in future, when support for hardware
temperature sensor will be added, we need to remap some GPIO pins. Further information will be added later.

===== Other platform =====

script needs a relay to control the data flow in order to function properly, so best choice is some sort of SBC.
At the moment there are no plans to add support for other SBCs, but maybe in future I will add support for relays controlled by Home Assistant, 
so script may running on any platform, and only need a RS485 connection.

====== INSTALL ======

==== Download ====

<code bash>
$ git clone https://github.com/ktostam/HaierPi.git
</code>

==== Edit config file ====

Edit the config.ini file with your favorite editor:
<code bash>
$ vim config.ini
</code>

==== use install script ====
run install script with root privileges

installation script by default installs in `/opt/haier`
<code bash>
$ sudo bash install.sh
</code>
installation script creates systemd services and asks if you want the service to start at system startup.

if you want manualy start/stop service:

for stop service:
<code bash>
$ sudo systemctl stop haier.service
</code>
for start service:
<code bash>
$ sudo systemctl start haier.service
</code>
==== After install ====

By default sript listen on all interfaces on port 4000, you can change it in **config.ini** 

default login and password for web interfaces is: ***admin/admin***

==== Screenshot ====
![Screenshot](https://github.com/ktostam/HaierPi/blob/master/images/screenshot.gif?raw=true)

===== Translation =====
  * en
  * pl
=== if you want to help create a translation into another language write me an email or on the discord channel ===


====== LICENSE ======
GNU Affero General Public License v3 
[[https://github.com/ktostam/HaierPi|©Jacek Brzozowski]]


In this project I'am using:

[[https://github.com/Yehzuna/jquery-schedule|jquery-schedule]] - MIT License

[[https://github.com/sweetalert2/sweetalert2|sweetalert2]] - MIT License

[[https://github.com/twbs/bootstrap|bootstrap]] - MIT License

[[https://github.com/jquery/jquery|jquery]] - MIT License