Hargassner Pellet Boiler Integration

for Home Assistant

Modern, professional Home Assistant integration for Hargassner pellet boilers with real-time telnet monitoring.

Features • Screenshots • Installation • Configuration • Documentation • Support

• 🔥 Real-time monitoring of 228 boiler parameters via direct connection
• 🔄 Automatic reconnection with exponential backoff strategy
• 🔒 Thread-safe async telnet client with background processing
• 🛡️ Robust error handling with custom exception types
• 🎛️ GUI configuration via Home Assistant Config Flow
• 🔧 Firmware support for V14_1HAR_q1 (extensible architecture)
• ⚡ Energy Dashboard integration with automatic kWh calculation
• 🌍 Bilingual sensor names and states (EN/DE)
• 📊 Flexible sensor sets: Standard (17 sensors) or Full (228 sensors)
• 🔌 Local polling - no cloud dependency

Device Overview

Sensor Dashboard

Detailed Sensor View

Energy Dashboard Integration

Custom Dashboard with Pellet Consumption Forecast

Note: Additional firmware versions can be easily added via XML templates. See Adding Firmware Support (EN) or Neue Firmware hinzufügen (DE) for details.

1. Open HACS in Home Assistant
2. Go to Integrations
3. Click the ⋮ menu → Custom repositories
4. Add repository:
   • URL: https://github.com/bauer-group/IP-HargassnerIntegration
   • Category: Integration
5. Click Install
6. Restart Home Assistant

cd /config
git clone https://github.com/bauer-group/IP-HargassnerIntegration.git
cp -r IP-HargassnerIntegration/custom_components/bauergroup_hargassnerintegration custom_components/

Then restart Home Assistant.

1. Settings → Devices & Services → Add Integration
2. Search for "Bauergroup Hargassner"
3. Configure:

💡 Tip: Start with STANDARD, switch to FULL if you need detailed diagnostics.

Always Available (4):

• 🔌 Connection - Connected/Disconnected
• 🔥 Boiler State - Off, Ignition, Full Firing, etc.
• ⚠️ Operation Status - OK / Error messages
• ⚡ Heat Output (Wärmemenge) - kWh (calculated from pellet consumption with configurable efficiency)

Boiler & Combustion (8):

• 🌡️ Boiler Temperature (TK)
• 🌡️ Boiler Setpoint (TKsoll)
• 💨 Flue Gas Temperature (TRG)
• 🔥 Burner Temperature (BRT)
• 📈 Output Power (Leistung)
• 📊 Efficiency (Effizienz)
• 📉 O2 Level (O2)
• 🌀 Draft Actual (SZist)

Buffer & Storage (6):

• 🔵 Buffer Top/Middle/Bottom (TPo, TPm, TPu)
• 📊 Buffer Fill Level (Puff Füllgrad)
• 🔼 Buffer Setpoint Top (Puffer_soll oben)
• 🔽 Buffer Setpoint Bottom (Puffer_soll unten)

Heating Circuits (3):

• ➡️ Flow Temperature HC1 (TVL_1)
• 🎯 Flow Setpoint HC1 (TVLs_1)
• ↩️ Return Temperature (TRL)

Hot Water (2):

• 💧 Hot Water Temperature (TB1)
• 🎯 Hot Water Setpoint (TBs_1)

Outside & Pellets (4):

• 🌍 Outside Temperature (Taus)
• 🪵 Pellet Stock (Lagerstand)
• 📉 Pellet Consumption (Verbrauchszähler)

All STANDARD sensors plus 211 additional parameters:

Analog Sensors (112):

• All temperatures (Boiler, Buffer, HC 1-8, DHW, Solar)
• O2 levels, Lambda values, Draft pressure
• All valve positions (HC 1-8)
• Motor currents (delivery, grate, ash removal)
• Pellet stock, consumption, ash content
• System time (minute, hour, day, month, year)
• Analog inputs (AN11-AN16)

Digital Sensors (112):

• Motors (M1-M38): Pumps, mixers, feeders, ash removal
• Inputs (E1-E16): Switches, thermostats, errors
• Heating circuit modes (HC1-HC8): Auto, Party, Holiday
• Operating modes: Auto, Manual, Heating, Error
• Time programs: Reduced, Normal, Party countdown

The integration automatically creates a heat output sensor compatible with Home Assistant's Energy Dashboard:

1. Go to Settings → Dashboards → Energy
2. Add the Hargassner Heat Output (Wärmemenge) sensor to track your pellet heating energy usage

The heat output is calculated using the formula:

Heat (kWh) = Pellets (kg) × Energy Content (kWh/kg) × Efficiency (%)

You can customize both values in the integration options:

• Pellet Energy Content: Default 4.8 kWh/kg (range: 3.0-6.0)
• Boiler Efficiency: Default 90% (range: 50-100%)

Example: With 100 kg pellets consumed, 4.8 kWh/kg energy content, and 90% efficiency:

100 kg × 4.8 kWh/kg × 0.90 = 432 kWh

To adjust these values:

1. Go to Settings → Devices & Services
2. Find your Hargassner integration
3. Click Configure → Adjust values as needed

• Quick Start Guide - Get started in 5 minutes
• German Quick Start (SCHNELLSTART.md) - Schnellstartanleitung auf Deutsch
• Detailed Installation Guide - Step-by-step installation instructions
• Energy Dashboard Setup - Configure energy tracking
• Custom Dashboard Setup - Complete dashboard with consumption forecasts and HDD analysis

• Architecture Overview - Deep-dive into technical architecture, data flow, and design decisions
• Development Guide - Developer setup, coding standards, and workflow
• Adding Firmware Support - Guide for adding new firmware versions (English)
• Neue Firmware hinzufügen - Anleitung für neue Firmware-Versionen (Deutsch)
• Contributing Guidelines - How to contribute to this project

• Common Issues - Solutions for connection and data problems
• Debug Logging - Enable detailed logging for diagnosis

• Ensure telnet (port 23) is enabled on your boiler
• Check firewall settings
• Verify IP address and network connectivity
• Check logs: Settings → System → Logs

• Verify the correct firmware version is selected
• Check encoding in logs
• Enable debug logging (see below)

Add to configuration.yaml:

logger:
  default: info
  logs:
    custom_components.bauergroup_hargassnerintegration: debug

See docs/ARCHITECTURE.md for detailed technical documentation.

See docs/DEVELOPMENT.md for development guidelines.

Contributions are welcome! Please read docs/CONTRIBUTING.md first.

MIT License - see LICENSE file for details.

• Issue Tracker
• Discussions