A comprehensive Home Assistant integration for Grant Aerona3 Heat Pumps using Modbus TCP communication. This integration automatically discovers and creates entities for all available registers, providing complete monitoring and control of your heat pump system with ASHP entity prefixes for better organization.
- 🔧 Simple Setup: Just enter IP address, port, and scan interval - no complex configuration
- 📊 Complete Monitoring: All 248 Modbus registers automatically created as entities with
ashp_prefixes - 🌡️ Accurate COP Calculation: Configure your flow rate for precise efficiency measurements
- 🏠 Zone Control: Climate entities for heating zones with temperature control
- ⚙️ Full Control: Switches for weather compensation, frost protection, and system settings
- 🔢 Setpoint Management: Number entities for all temperature and timing settings
- 📈 Real-time Data: Temperature sensors, power consumption, compressor frequency, and more
- 🚨 System Monitoring: Error detection, defrost mode, and system health indicators
- 🌦️ Weather Compensation: Advanced adaptive weather compensation with dual heating curves
- ⚡ Energy Monitoring: Comprehensive energy usage tracking and cost estimation
- 🔧 Options Flow: Configure scan intervals and flow rates through the UI
- ✅ Home Assistant 2025.9.0b5 Compatibility: Fully tested and compatible
- ✅ ASHP Entity Prefixes: All entities now use
ashp_prefixes for better organization - ✅ Enhanced Options Flow: Configure settings through the Home Assistant UI
- ✅ Improved Error Handling: Better connection management and error reporting
- ✅ Code Quality: Modern Python type hints and improved documentation
- ✅ Weather Compensation: Advanced adaptive weather compensation features
- ✅ Energy Monitoring: Enhanced COP calculations and energy tracking
- ✅ Modbus Scanner: Modbus Scanner Tool to find new Registers
- Install the integration (see Installation Guide)
- Add Integration via Home Assistant UI (Settings → Devices & Services → Add Integration)
- Enter Details: IP address (required), port (502), slave ID (1), scan interval (30s)
- Configure Options: Set flow rate and adjust scan interval via integration options
- Enjoy: 150+ entities automatically created with
ashp_prefixes and ready to use!
- Temperatures: Flow, return, outdoor, DHW tank, discharge, suction, defrost
- Power & Performance: Power consumption, COP, efficiency, energy usage
- System Status: Compressor frequency, pump speeds, operating modes
- Configuration Values: All current setpoints and settings (read-only)
- Energy Monitoring: Daily energy consumption, cost estimates, monthly projections
- System Status: Compressor running, defrost active, heating active, DHW active
- Safety Systems: Alarm status, backup heater, frost protection, communication status
- Weather Compensation: Zone 1 and Zone 2 weather compensation status
- Weather Compensation: Enable/disable for each zone
- Frost Protection: Room, outdoor, and DHW frost protection
- System Features: Anti-legionella, humidity compensation, night mode
- Terminal Configuration: Remote controller, sensors, pumps, valves
- Temperature Setpoints: Zone flow temperatures, DHW temperatures
- Weather Compensation: Curve settings for optimal efficiency
- Timing Settings: Delays, timeouts, and cycle times
- Flow Rate Configuration: Set your measured flow rate for accurate COP
- ASHP Main Zone: Primary heating zone control
- ASHP Zone 2: Secondary zone control (if configured)
- ASHP DHW: Domestic hot water control
The integration includes sophisticated weather compensation features:
- Adaptive Weather Compensation: Automatically adjusts flow temperatures based on outdoor conditions
- Dual Heating Curves: Primary and secondary curves for different operating modes
- Boost Mode: Temporary higher temperature settings for rapid heating
- Zone-Specific Control: Independent weather compensation for Zone 1 and Zone 2
- Blueprint Automations: Ready-to-use Home Assistant blueprints included
| Document | Description |
|---|---|
| 📋 Installation Guide | Step-by-step installation instructions |
| ⚙️ Configuration Guide | Detailed configuration options |
| 📏 Flow Rate Measurement | How to measure and configure flow rate for accurate COP |
| 🔧 Troubleshooting | Common issues and solutions |
| 📚 Register Reference | Complete list of all 150+ registers |
| 🎯 Examples | Sample automations and dashboard cards |
This integration works with all Grant Aerona3 configurations:
- 🔥 Heating Only (65% of installs): Single zone heating
- 🔥💧 Heating + DHW (25% of installs): Heating with hot water cylinder
- 🏠🏠 Dual Zone (8% of installs): Separate upstairs/downstairs control
- 🔄 Boiler Replacement (2% of installs): Full system replacement
- Home Assistant 2025.9.0b5 or newer (tested and compatible)
- Grant Aerona3 Heat Pump with Modbus TCP interface
- Network Connection between Home Assistant and heat pump
- Python Libraries:
pymodbus>=3.6.8,<4.0.0(automatically installed)
For reliable Modbus TCP communication, we recommend:
New Version (Recommended):
- Waveshare RS232/485/422 to PoE ETH-B
- Power over Ethernet support
- Industrial-grade reliability
Alternative:
- RS232 to RJ45 Ethernet Module
- Basic functionality for budget setups
- Waterproof Enclosure
- Protects hardware from outdoor conditions
For the best dashboard experience:
lovelace-card-mod
apexcharts-card
mushroom
card-mod
energy-flow-card-plus
button-card
- 🐛 Report Issues: GitHub Issues
- 💡 Feature Requests: GitHub Discussions
- 📖 Documentation: Docs/ folder
- 🤝 Contributing: Pull requests welcome!
- ✅ Home Assistant 2025.9.0b5 compatibility
- ✅ Added ASHP entity prefixes for better organization
- ✅ Enhanced options flow for UI configuration
- ✅ Improved error handling and connection management
- ✅ Fixed binary sensor syntax errors
- ✅ Added weather compensation entities and controls
- ✅ Enhanced energy monitoring and COP calculations
- 🎉 Initial release
- 📊 150+ automatically created entities
- 🌡️ Complete temperature monitoring
- ⚙️ Full system control capabilities
This project is licensed under the MIT License - see the LICENSE file for details.
- Grant Engineering for the Aerona3 heat pump series
- Home Assistant community for the excellent platform
- Contributors and testers who helped improve this integration
Made with ❤️ for the Home Assistant community
If this integration helps you monitor and control your Grant Aerona3 heat pump, please consider giving it a ⭐ on GitHub!
- Open HACS in Home Assistant
- Go to "Integrations"
- Click the three dots menu → "Custom repositories"
- Add this repository URL
- Install "Grant Aerona3 Heat Pump"
- Restart Home Assistant
- Download the latest release
- Copy
custom_components/grant_aerona3/to your Home Assistantcustom_components/directory - Restart Home Assistant
- Add the integration via Settings → Devices & Services
Last updated: January 2025 - Compatible with Home Assistant 2025.9.0b5