Hargassner Pellet Boiler / Hargassner Pelletheizung Integration | Nano-PK

[karlspace (Karl Bauer)]

Hargassner Pellet Boiler Integration - Real-time monitoring via Telnet

I’m excited to share my Hargassner Pellet Boiler Integration for Home Assistant! This integration provides real-time monitoring of your Hargassner pellet boiler through a direct telnet connection - no cloud dependency needed.

Key Features

• Real-time monitoring of up to 228 boiler parameters via direct telnet connection
• Energy Dashboard integration with automatic kWh calculation based on pellet consumption
• Flexible sensor sets: Choose between Standard (17 essential sensors) or Full (228 sensors)
• Automatic reconnection with intelligent retry logic
• Bilingual support (English/German) for sensor names and states
• Robust & thread-safe async telnet client with proper error handling
• 100% local - no cloud services required

Screenshots

Device Overview:

Custom Dashboard with Pellet Consumption Forecast:

Energy Dashboard Integration:

Installation via HACS

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 and restart Home Assistant

Quick Configuration

After installation:

1. Go to Settings → Devices & Services → Add Integration
2. Search for “Bauergroup Hargassner”
3. Enter your configuration:
   • Host: IP address of your boiler (e.g., 192.168.1.100)
   • Firmware: Select your firmware version (currently V14_1HAR_q1 fully tested)
   • Device Name: Choose a friendly name
   • Language: EN or DE
   • Sensor Set: STANDARD (17 sensors) or FULL (228 sensors)
   • Pellet Energy & Efficiency: For accurate energy calculations (defaults: 4.8 kWh/kg, 90%)

Available Sensors

STANDARD Set (17 Sensors)

Perfect for most users, includes:

• Connection status & Boiler state
• Core temperatures (Boiler, Flue Gas, Buffer zones, Hot Water, Return)
• Output power (%)
• Pellet stock & consumption
• Heat Output (kWh) - automatically calculated for Energy Dashboard
• Buffer fill level

FULL Set (228 Sensors)

For advanced diagnostics:

• All temperatures (HC 1-8, Solar, DHW)
• All motors & pumps (M1-M38)
• All digital inputs (E1-E16)
• Heating circuit modes, valve positions, motor currents
• Complete system diagnostics

Energy Dashboard Integration

The integration automatically creates a Heat Output sensor compatible with Home Assistant’s Energy Dashboard. The calculation uses:

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

Both values are fully customizable in the integration options!

Supported Models

Model	Firmware	Status
Nano-PK	V14_1HAR_q1	Fully tested
Other models	Custom	Requires firmware template

Additional firmware versions can be easily added via XML templates. See the documentation for details.

Resources

• GitHub Repository: GitHub - bauer-group/IP-HargassnerIntegration: Home Assistant integration for Hargassner pellet boilers without cloud / Home Assistant-Integration für Hargassner-Pelletkessel ohne Cloud
• Documentation: Detailed guides for installation, custom dashboards, and adding firmware support
• Issue Tracker: GitHub · Where software is built

Feedback Welcome

This is my first Home Assistant integration, and I’d love to hear your feedback! If you have a Hargassner boiler with a different firmware version, please reach out - I can help you add support for it.

---

License: MIT
IoT Class: Local Polling
Quality Scale: Silver

[tvieider]

Hi Karl!
Vielen Dank für diene Mühe! Und auch danke für die raschen Korrekturen!

LG
Tommy

[Ra1080]

Hallo Karl,
super Integration! Herzlichen Dank!

Beste Grüße
Ralf

[Matten83 (6m69phv4ts Alt)]

Hallo Karl.
vielen Dank für die super Integration!
Habe sie jetzt erfolgreich auf meinen Eco-HK30 Hackschnitzelkessel umgesetzt.
Hat ein bisschen gedauert, bin noch neu in HA. Was ich mir allerdings wünschen würde: eine möglichkeit das Heizprogramm über HA zu ändern.
Gibt es da eine Möglichkeit?

Grüße Matthias

[ElektroBasti22]

Hallo Karl, hallo Matthias.

Karl, erstmal Hut ab, was du da auf die Beine gestellt hast.

ich hab einen ECO-HK50 mit der Softwareversion V30.0HAR.e

Daran zwei HKM

-einmal mit AB-Platine (3 Heizkreise + Boiler)
-einmal mit zwei weiteren Heizkreisen

Bin in der ganzen Programmierwelt noch etwas schwach aufgestellt.

Könntet ihr mir da etwas auf die Sprünge helfen?

Gruß Basti

[rca1959]

Thanks!
I’ve just discovered your post. I have 2 Hargassner boilers. 1 Classic Lambda 35 and 1 HV 60.
Late now here in Sweden, will examine more later.

[rca1959]

I now have the app running. Connects fine. But the parameter list is not so correct.
As I said in my post above, I have a Classic Lambda 35. That is the one I’m testing on.
Tested both available firmware versions, non was 100% same name as mine. V14.0HAR.q1.
Feedback: I didn’t find anywhere to change the firmware version once it was installed on HA. Maybe I didn’t look in the right place. I reinstalled it.

Herzliche Grüße aus Schweden

[tvieider]

Hi rca1959!

As I understand, the firmwares can be very individually.
For example, I have an Hargassner Nano PK20 and a circuit board for solar installed.
So I get different datas, than others.

Here is the information how to extract the date with a sdcard from your heater:

GitHub - TheRealKillaruna/nano_pk: Home Assistant integration of Hargassner Nano-PK

After that, you need to adjust your individuelly firmware.
Anderl78 made a describtion how to create “dummies” for data without a definition:

New Firmware NanoPK V14.0HAR.p1 (new msgformat inside)

A dummy looks like: <CHANNEL id='59' name='Dummy 1' unit='°C'/>

Here ist an example of my excel:

Maybe it will help you to get along

Lieben Gruß aus Tirol
Tommy

[oligraf]

Hallo,
ich habe einen Nano PK12 mit eCleaner. Die Integration lief Problemlos.
Ich habe die Datei Firmware-Tamplates um meine DAQ wie beschreiben ergänzt. Das funktioniert super einfach. Danke für die schöne Umsetzung.

Softwareart:V14.1
Software-Version:V14.1HAR.q
Bootloader-Version:V3.26
CMD-Version:1.0.1
IO-Firmware:V1.2.8
Verbaut ist eCleaner, 1x Heizkreispumpe und zusätzlich 1 Fühler HK2

DAQ V14.1HAR.q

Gruß Oliver

[Mickl312]

Ich habe auch eine ECO-HK-50. Hast du dafür schon eine Lösung?

[ElektroBasti22]

Hey Mickl, ne hab schon einige Abende damit verbracht. Die DAQ Files hab ich aber scheiter schon kläglich an dem Punkt 3.2 wo es im Terminal los geht… ich hab echt 0 Ahnung, wie ich das lösen soll.

Nachtrag habs grundsätzlich mal hinbekommen, Die Meisten Werte machen jetzt tatsächlich Sinn, manche muss ich noch feinjustieren und zuweisen.

Meine Vorgehensweise:

Im Studio Code Server findest du unter config/bauergroup…
den Ordner “firmware_templates.py” ab Zeile 21 die Firmwareversionen, hier gibst du deine ein und kopierst von der SD-Karte den kompletten Bereich von … bis … und fügst ihn hier ein.

dann noch unter consty.py
ab Zeile 95 deine Firmwareversion ergänzen, den HA neu starten und die Bauer-Integration wie gewohnt nochmal installieren und deine Softwareversion auswählen.

Weiter bin ich bis jetzt noch nicht aber im gröbsten funktionierts

[der_Bauer]

Guten Abend,

vielen Dank für diese Mega coole Integration. Hoffe, dass ich damit die Funktionen (z.B. wann ich meinen Holzvergaser füttern kann), die Hargassner in der App nicht einbaut, endlich selber mit HA bauen kann.
Die Tools zum Automatisierten anpassen der DAQ Files waren bei mir im Ordner leider nicht zu finden oder ich war blind. Ist aber auch das erste mal, dass ich mit Studio Code Server versucht habe etwas selbst anzupassen.

Dein Hinweis Basti hat mir daher gut geholfen, jetzt funktioniert es erstmal. Muss noch ein bisschen was anpassen, weil von meinem NEO-HV 30 brauche ich nicht alle Parameter und daher auch nicht alle Entitäten, weil das halt ein Holzvergaser und kein Pelletkessel ist. Aber das kommt sicherlich.

Vielen Dank für die Integration und das gemeinsame weiterhelfen hier

Ich teste mein Firmware file jetzt und werde es noch etwas weiter verfeinern und dann teile ich das gerne!

Lg. Phil