Home Assistant integration for AC Heating XCC heat pump controllers with photovoltaic integration. Monitor and control your heat pump system directly from Home Assistant with automatic entity discovery and bilingual support.
Inspired by work in https://github.com/Pdobry/xcc-graph.
- 🔧 470+ settable fields automatically discovered across 6 configuration pages
- 📊 Live data monitoring with real-time sensor values
- 🌐 Bilingual support (English/Czech with auto-detection)
- 📋 Organized by device (heating, PV, hot water, auxiliary source, etc.)
-
Add Custom Repository:
- Open HACS in Home Assistant
- Click the 3 dots (⋮) → "Custom repositories"
- Add repository:
https://github.com/pvyleta/xcc-integration - Category:
Integration
-
Install Integration:
- Go to HACS > Integrations
- Search for "XCC Heat Pump Controller"
- Click "Download" and restart Home Assistant
-
Configure Integration:
- Settings > Devices & Services > "Add Integration"
- Search for "XCC Heat Pump Controller"
- Enter your XCC controller details
-
Clone the repository:
git clone https://github.com/pvyleta/xcc-integration cd xcc-integration -
Create virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
The integration includes comprehensive tests to ensure reliability:
# Run all tests
python -m pytest tests/ -vThe integration automatically discovers entities from these XCC pages:
| Page | Description | Typical Entities |
|---|---|---|
| Heating Circuits | Temperature control, schedules | Temperature sensors, setpoint controls |
| Photovoltaics | Battery management, export limits | Power sensors, battery controls |
| Hot Water | Sanitization, circulation | Water temperature, heating controls |
| Auxiliary Source | Backup heating system | Status sensors, operation controls |
| Spot Pricing | Dynamic pricing optimization | Price sensors, optimization switches |
| System Status | Overall system information | Status sensors, diagnostic data |