Very simple library to manipulate the basic parameters of the Haier heat pump.
Project description
PyHaier
Very simple (for now) library to manipulate the basic parameters of the Haier heat pump.
Donation
If you like My work and want to support me, you can:
Or if you from Poland:
Support
For support, join our Discord channel https://discord.gg/7aF38puD
Contributors
- Daniel Mentel he found all information from functions added in 0.2.1 and 0.2.2 version
Version
0.2.6
- fix function name
0.2.5
- add GetPump function to show if buildin pump is on or off
- add Get3way function to show what position the 3-way valve is in
0.2.4
- some fixes
0.2.3
- use divmod
0.2.2
- add GetTdTs function showing Td and Ts parameters as array
- add GetPdPs function showing current and set Pd parameter (for now only Pd) as array
- add GetFanRpm function showing Fan1 and Fan2 rpm, as array
- add GetTao function showwing ambient temperatura
- rename GetCompFreq function to GetCompInfo and add to this function other information like temperature, voltage and current about compressor, display as array
0.2.1
- add GetCompFreq function showing current and set compressor frequency
- add GetArchError function showing three archive errors as array
- add GetEEVLevel function showing current EEV opening level
0.2.0
- rename 'silent' to 'quiet' in GetMode and SetMode function to be consistent with haier nomenclature
0.1.9
- fix for SetState. Now turning on/off emulate "leaf" button on YR-e27
0.1.8
- fix for previous fix :D
0.1.7
- fix turning on pump in SetState function
0.1.6
- Just for pip upload
0.1.5
- More error handling
0.1.4
- Update in error handling
0.1.3
New function
- Add function to read Compressor frequency
0.1.2
New function:
- Get value of Twi and Two parameters (not 100% sure if this is OK.)
0.1.1
New function:
- Get current DHW tank temperature
0.1.0
Basic function:
- Get current state
- Get current mode
- Get current Heating temperature
- Get current DHW temperature
- Set state
- Set mode
- Set Heating temperature
- Set DHW temperature
Tested with
- AU082FYCRA(HW)
- AU162FYCRA(HW)
However, it should work with all pumps that feature the YR-e27 remote control
Instalation
Install from pip
$ pip install PyHaier
Install from source
$ git clone https://github.com/ktostam/PyHaier.git
$ cd PyHaier
$ python setup.py install
Usage
PyHaier.GetState(payload)
Display current state (Cool/Heat/Tank/Cool+Tank/Heat+Tank/Off).
You need provide payload for GetState function. payload is the contents of holding registers 101-106
PyHaier.GetMode(payload)
Display current Mode (ECO/Silent/Turbo).
You need provide payload for GetMode function. payload is the contents of holding register 201
PyHaier.GetCHTemp(payload)
Display current water temperature with precision 0.5°C
You need provide payload for GetMode function. payload is the contents of holding registers 101-106
PyHaier.GetDHWTemp(payload)
Display current DHW temperature with precision 1°C
You need provide payload for GetMode function. payload is the contents of holding registers 101-106
PyHaier.GetDHWCurTemp(payload)
Display current DHW temperature in Tank with precision 0.1°C
You need provide payload for GetDHWCurTemp function. payload is the contents of holding registers 141-156
PyHaier.GetTwiTwo(payload)
Display Twi and Two parameters with precision 0.1°C, output is an array
You need provide payload for GetTwiTwo function. payload is the contents of holding registers 141-156
PyHaier.SetState(current,new)
Create Modbus frame to set new pump state
You need provide payload for SetState function. payload is the contents of holding registers 101-106
new can be:
off
on
C
for CoolH
for HeatT
for TankCT
for Cool+TankHT
for Heat+Tank
PyHaier.SetMode(new)
Set mode (eco/silent/turbo).
You need provide new for SetMode function. new can be:
eco
silent
turbo
PyHaier.SetCHTemp(current, new)
Set water temperature with precision 0.5°C
You need provide current for SetCHTemp function. current is the contents of holding registers 101-106
new is new temperature with precision 0.5°C
PyHaier.SetDHWTemp(current, new)
Set DHW temperature with precision 1°C
You need provide current for SetDHWTemp function. current is the contents of holding registers 101-106
new is new temperature with precision 1°C
PyHaier.GetCompFreq(payload)
Display set and actual compressor frequency, output is an array
You need provide payload for GetCompFreq function. payload is the contents of holding registers 241-261
PyHaier.GetArchError(payload)
Display archve error codes, output is an array
You need provide payload for GetArchError function. payload is the contents of holding registers 241-261
PyHaier.GetEEVLevel(payload)
Display actual EEV opening level
You need provide payload for GetEEVLevel function. payload is the contents of holding registers 241-261
Example script 1
from pymodbus.client.sync import ModbusSerialClient
import PyHaier
# Serial setting
client = ModbusSerialClient(method = "rtu", port="/dev/ttyAMA0", stopbits=1, bytesize=8, parity='E', baudrate=9600)
# connect to serial
client.connect()
#read holding registers from 101 to 106
payload=client.read_holding_registers(101, 6, unit=17)
state=PyHaier.GetState(payload.registers)
htemp=PyHaier.GetCHTemp(payload.registers)
dhwtemp=PyHaier.GetDHWTemp(payload.registers)
payload=client.read_holding_registers(201, 1, unit=17)
mode=PyHaier.GetMode(payload.registers)
client.close()
print("Pump status:\t"+state+"\nPump mode:\t"+mode+"\nWater temp:\t"+str(htemp)+"\nDHW temp:\t"+str(dhwtemp))
Output
$ python script.py
Pump status: Heat+Tank ON
Pump mode: silent
Water temp: 25.0
DHW temp: 43.0
Example script 2
from pymodbus.client.sync import ModbusSerialClient
import PyHaier
# Serial setting
client = ModbusSerialClient(method = "rtu", port="/dev/ttyAMA0", stopbits=1, bytesize=8, parity='E', baudrate=9600)
# connect to serial
client.connect()
#read holding registers from 101 to 106
payload=client.read_holding_registers(101, 6, unit=17)
state=PyHaier.GetState(payload.registers)
print("Current state:\t"+state)
new=PyHaier.SetState(payload.registers,"CT")
client.write_registers(101, new , unit=17)
payload=client.read_holding_registers(101, 6, unit=17)
state=PyHaier.GetState(payload.registers)
print("New state:\t"+state)
client.close()
Output
$ python script.py
Current stete: Heat+Tank ON
New state: Cool+Tank ON
License
GNU GPL ©Jacek Brzozowski
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file PyHaier-0.2.6.tar.gz
.
File metadata
- Download URL: PyHaier-0.2.6.tar.gz
- Upload date:
- Size: 8.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a3a056e556c44f621c94dec07315b1592ec0cd5bb535f0a34c00727e4a27b60d |
|
MD5 | 2a7682acd03ca0892e53b10b89169bfa |
|
BLAKE2b-256 | 8e7e1886efc9a3f535987d61fd88f2e4792faa5d2354dd5c2362a17981ddd44d |
File details
Details for the file PyHaier-0.2.6-py3-none-any.whl
.
File metadata
- Download URL: PyHaier-0.2.6-py3-none-any.whl
- Upload date:
- Size: 10.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d530709b150540c1507a2813436ec8eb9b34afe210fc5ebb9ecb6fe6f1edeed8 |
|
MD5 | 9b469e8ceffd1a27eeda3fa538f00a96 |
|
BLAKE2b-256 | 6c79fda5b49c1f4d1542ac9ea78814116a05f959297bebc7174a03bfa3776c31 |