https://github.com/pvyleta/xcc-integration
Home Assistant Integration for XCC2 regulation for 'AC Heating' heat pumps
https://github.com/pvyleta/xcc-integration
custom-component hacs heat-pump home-assistant integration xcc
Last synced: 3 months ago
JSON representation
Home Assistant Integration for XCC2 regulation for 'AC Heating' heat pumps
- Host: GitHub
- URL: https://github.com/pvyleta/xcc-integration
- Owner: pvyleta
- Created: 2025-06-28T18:04:09.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-22T21:21:26.000Z (3 months ago)
- Last Synced: 2026-04-22T22:29:55.976Z (3 months ago)
- Topics: custom-component, hacs, heat-pump, home-assistant, integration, xcc
- Language: Python
- Homepage:
- Size: 7.65 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# AC Heating XCC Heat Pump Controller Integration
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.
## 🏠 Home Assistant Integration Features
- 🔧 **470+ settable fields** automatically discovered across 8 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.)
## 📦 HACS Installation
1. **Add Custom Repository**:
- Open HACS in Home Assistant
- Click the 3 dots (⋮) → "Custom repositories"
- Add repository: `https://github.com/pvyleta/xcc-integration`
- Category: `Integration`
2. **Install Integration**:
- Go to HACS > Integrations
- Search for "XCC Heat Pump Controller"
- Click "Download" and restart Home Assistant
3. **Configure Integration**:
- Settings > Devices & Services > "Add Integration"
- Search for "XCC Heat Pump Controller"
- Enter your XCC controller details
## 🔧 Development & Testing
### Development Setup
1. **Clone the repository:**
```bash
git clone https://github.com/pvyleta/xcc-integration
cd xcc-integration
```
2. **Create virtual environment:**
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. **Install dependencies:**
```bash
pip install -r requirements.txt
```
### Running Tests
The integration includes comprehensive tests to ensure reliability:
```bash
# Run all tests
python -m pytest tests/ -v
```
## 📚 Configuration Pages
The 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 |
| **PV Inverter** | Inverter configuration and telemetry | String/phase sensors, inverter settings |
| **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 |
| **Heat Pump Settings** | Advanced configuration (discovered dynamically) | Configuration switches, numbers |