Gree Heat Pump Home Assistant Integration

This is a custom Home Assistant integration for Gree Heat Pump devices that use the proprietary UDP protocol.

Note

This repository is archived, as I no longer have access to a Gree Heat Pump, meaning that I cannot test nor validate any changes. If you'd like to give continuity to the repository, feel free to fork :)

Installation

1. Copy the gree_hp folder to your Home Assistant custom_components directory:

   custom_components/
     gree_hp/
   

2. Restart Home Assistant

3. Go to Settings → Devices & Services → Add Integration

4. Search for "Gree Heat Pump" and click to add

5. Enter the IP address of your heat pump when prompted

Features

The integration provides the following entities:

Climate Entity

• Power Control: Turn the heat pump on/off
• Mode Selection: Cool, Heat, Shower Water, Cool + Shower Water, Heat + Shower Water

Temperature Control

• Cold Water Temperature: Current cold water temperature setting
• Hot Water Temperature: Current hot water temperature setting
• Shower Water Temperature: Current shower water temperature setting

Temperature Sensors

• Water tank: Current temperature of the water inside the water tank
• Water In PE: Temperature of the water entering the Heat Pump circuit
• Water Out PE: Temperature of the water leaving the Heat Pump circuit

Configuration

During setup, you only need to provide:

• IP Address: The local IP address of your heat pump (e.g., 192.168.1.100)

All other protocol parameters (port, encryption keys) are hardcoded based on the Gree protocol specifications.

Data Updates

The integration polls the heat pump every 10 seconds to retrieve the current status, ensuring the Home Assistant entities stay synchronized with any manual changes made on the heat pump itself.

Technical Details

• Protocol: UDP communication on port 7000
• Encryption: AES-ECB with device-specific keys
• Discovery: Automatic device discovery and binding
• Dependencies: Requires pycryptodome package

Troubleshooting

1. Connection Issues: Ensure the heat pump IP address is correct and the device is on the same network
2. Entity Updates: The integration updates every 10 seconds; manual changes may take a few seconds to reflect
3. Logs: Check Home Assistant logs for detailed error messages if the integration fails to connect

Development

This integration is based on reverse-engineered, lots of searching and looking into similar implementations of the Gree protocol communication patterns.