{"id":33543755,"url":"https://github.com/bauer-group/ip-hargassnerintegration","last_synced_at":"2026-05-29T23:01:50.925Z","repository":{"id":325561939,"uuid":"1101653581","full_name":"bauer-group/IP-HargassnerIntegration","owner":"bauer-group","description":"Home Assistant integration for Hargassner pellet boilers without cloud. / Home Assistant-Integration für Hargassner-Pelletkessel ohne Cloud.","archived":false,"fork":false,"pushed_at":"2026-03-24T22:18:39.000Z","size":289,"stargazers_count":6,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-26T03:36:26.586Z","etag":null,"topics":["internal-project"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bauer-group.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-22T02:04:22.000Z","updated_at":"2026-03-24T22:18:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bauer-group/IP-HargassnerIntegration","commit_stats":null,"previous_names":["bauer-group/ip-hargassnerintegration"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/bauer-group/IP-HargassnerIntegration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bauer-group%2FIP-HargassnerIntegration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bauer-group%2FIP-HargassnerIntegration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bauer-group%2FIP-HargassnerIntegration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bauer-group%2FIP-HargassnerIntegration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bauer-group","download_url":"https://codeload.github.com/bauer-group/IP-HargassnerIntegration/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bauer-group%2FIP-HargassnerIntegration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33673628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["internal-project"],"created_at":"2025-11-27T03:03:27.045Z","updated_at":"2026-05-29T23:01:50.919Z","avatar_url":"https://github.com/bauer-group.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"custom_components/bauergroup_hargassnerintegration/icon.png\" alt=\"Hargassner Integration Logo\" width=\"200\"/\u003e\n\n  # Hargassner Pellet Boiler Integration\n  ### for Home Assistant\n\n  [![Home Assistant](https://img.shields.io/badge/Home%20Assistant-Compatible-blue?style=for-the-badge\u0026logo=home-assistant)](https://www.home-assistant.io/)\n\n  [![HACS](https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge)](https://github.com/hacs/integration)\n  [![License](https://img.shields.io/github/license/bauer-group/IP-HargassnerIntegration?style=for-the-badge)](LICENSE)\n\n  [![GitHub Release](https://img.shields.io/github/v/release/bauer-group/IP-HargassnerIntegration?style=for-the-badge)](https://github.com/bauer-group/IP-HargassnerIntegration/releases)\n  [![GitHub Issues](https://img.shields.io/github/issues/bauer-group/IP-HargassnerIntegration?style=for-the-badge)](https://github.com/bauer-group/IP-HargassnerIntegration/issues)\n  [![GitHub Stars](https://img.shields.io/github/stars/bauer-group/IP-HargassnerIntegration?style=for-the-badge)](https://github.com/bauer-group/IP-HargassnerIntegration/stargazers)\n\n  **Modern, professional Home Assistant integration for Hargassner pellet boilers with real-time telnet monitoring.**\n\n  [Features](#-features) • [Screenshots](#-screenshots) • [Installation](#-installation) • [Configuration](#️-configuration) • [Documentation](#-documentation) • [Support](#support)\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n- 🔥 **Real-time monitoring** of 228 boiler parameters via direct connection\n- 🔄 **Automatic reconnection** with exponential backoff strategy\n- 🔒 **Thread-safe** async telnet client with background processing\n- 🛡️ **Robust error handling** with custom exception types\n- 🎛️ **GUI configuration** via Home Assistant Config Flow\n- 🔧 **Firmware support** for V14_1HAR_q1 (extensible architecture)\n- ⚡ **Energy Dashboard** integration with automatic kWh calculation\n- 🌍 **Bilingual** sensor names and states (EN/DE)\n- 📊 **Flexible sensor sets**: Standard (26 sensors) or Full (228 sensors)\n- 🔌 **Local polling** - no cloud dependency\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n### Device Overview\n\u003cimg src=\"docs/images/Device_Example.png\" alt=\"Device Overview\" width=\"800\"/\u003e\n\n### Sensor Dashboard\n\u003cimg src=\"docs/images/Dashboard_Example.png\" alt=\"Dashboard Example\" width=\"800\"/\u003e\n\n### Detailed Sensor View\n\u003cimg src=\"docs/images/Device_Detail_Example.png\" alt=\"Device Detail\" width=\"800\"/\u003e\n\n### Energy Dashboard Integration\n\n\u003cimg src=\"docs/images/Energy_Dashboard_Example.png\" alt=\"Energy Dashboard\" width=\"800\"/\u003e\n\n### Custom Dashboard with Pellet Consumption Forecast\n\n\u003cimg src=\"docs/images/Custom_Dashboard.png\" alt=\"Custom Dashboard\" width=\"800\"/\u003e\n\n\u003c/div\u003e\n\n## 🔥 Supported Models\n\n| Model | Firmware | Status |\n|-------|----------|--------|\n| Nano-PK 20 | V14_1HAR_q1 | ✅ Fully tested |\n| Nano-PK 20 + Solar/3HK | V14_1HAR_q1_solar | 🧪 Community tested (contributed by [@tvieider](https://github.com/tvieider)) |\n| Nano-PK | V14_0HAR_q | 🧪 Community tested (contributed by [@notecp](https://github.com/notecp)) |\n| Nano 65 | V40_0HAR_az15 | 🧪 Community tested (contributed by [@marianhoenscheid](https://github.com/marianhoenscheid)) |\n| HSV/CL 9-60KW | V14_0d | 🧪 Community tested (contributed by [@tk79](https://github.com/tk79)) |\n| Classic Lambda 40L-60L | V14_0m5 | 🧪 Community tested (contributed by [@philippe44](https://github.com/philippe44)) |\n| Other Hargassner models | Custom | ⚠️ Requires firmware template |\n\n\u003e **Note:** Additional firmware versions can be easily added via XML templates. See [Adding Firmware Support](docs/ADDING_FIRMWARE.md) (EN) or [Neue Firmware hinzufügen](docs/ADDING_FIRMWARE_DE.md) (DE) for details.\n\n## 📦 Installation\n\n### Method 1: HACS (Recommended)\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=bauer-group\u0026repository=IP-HargassnerIntegration\u0026category=integration)\n\n1. Open **HACS** in Home Assistant\n2. Go to **Integrations**\n3. Click the **⋮** menu → **Custom repositories**\n4. Add repository:\n   - **URL:** `https://github.com/bauer-group/IP-HargassnerIntegration`\n   - **Category:** Integration\n5. Click **Install**\n6. **Restart Home Assistant**\n\n### Method 2: Manual Installation\n\n```bash\ncd /config\ngit clone https://github.com/bauer-group/IP-HargassnerIntegration.git\ncp -r IP-HargassnerIntegration/custom_components/bauergroup_hargassnerintegration custom_components/\n```\n\nThen restart Home Assistant.\n\n## ⚙️ Configuration\n\n### Quick Start\n\n1. **Settings** → **Devices \u0026 Services** → **Add Integration**\n2. Search for **\"Bauergroup Hargassner\"**\n3. Configure:\n\n| Field | Description | Example |\n|-------|-------------|---------|\n| **Host** | IP address of boiler | `192.168.1.100` |\n| **Firmware** | Boiler firmware version | `V14_1HAR_q1` |\n| **Device Name** | Friendly name | `Hargassner` |\n| **Language** | UI language (EN/DE) | `DE` |\n| **Sensor Set** | STANDARD or FULL | `FULL` |\n| **Pellet Energy** | Energy content (kWh/kg) | `4.8` (default) |\n| **Efficiency** | Boiler efficiency (%) | `90` (default) |\n\n### Sensor Sets Comparison\n\n| Set | Sensors | Use Case |\n|-----|---------|----------|\n| **STANDARD** | 26 sensors | Basic monitoring, dashboards |\n| **FULL** | 228 sensors | Advanced diagnostics, all parameters |\n\n\u003e 💡 **Tip:** Start with STANDARD, switch to FULL if you need detailed diagnostics.\n\n## 📊 Available Sensors\n\n### STANDARD Set (26 Sensors)\n\n**Always Available (4):**\n\n- 🔌 **Connection** - Connected/Disconnected\n- 🔥 **Boiler State** - Off, Ignition, Full Firing, etc.\n- ⚠️ **Operation Status** - OK / Error messages\n- ⚡ **Heat Output** (Wärmemenge) - kWh (calculated from pellet consumption with configurable efficiency)\n\n**Boiler \u0026 Combustion (8):**\n\n- 🌡️ **Boiler Temperature** (TK)\n- 🌡️ **Boiler Setpoint** (TKsoll)\n- 💨 **Flue Gas Temperature** (TRG)\n- 🔥 **Burner Temperature** (BRT)\n- 📈 **Output Power** (Leistung)\n- 📊 **Efficiency** (Effizienz)\n- 📉 **O2 Level** (O2)\n- 🌀 **Draft Actual** (SZist)\n\n**Buffer \u0026 Storage (6):**\n\n- 🔵 **Buffer Top/Middle/Bottom** (TPo, TPm, TPu)\n- 📊 **Buffer Fill Level** (Puff Füllgrad)\n- 🔼 **Buffer Setpoint Top** (Puffer_soll oben)\n- 🔽 **Buffer Setpoint Bottom** (Puffer_soll unten)\n\n**Heating Circuits (3):**\n\n- ➡️ **Flow Temperature HC1** (TVL_1)\n- 🎯 **Flow Setpoint HC1** (TVLs_1)\n- ↩️ **Return Temperature** (TRL)\n\n**Hot Water (2):**\n\n- 💧 **Hot Water Temperature** (TB1)\n- 🎯 **Hot Water Setpoint** (TBs_1)\n\n**Outside \u0026 Pellets (3):**\n\n- 🌍 **Outside Temperature** (Taus)\n- 🪵 **Pellet Stock** (Lagerstand)\n- 📉 **Pellet Consumption** (Verbrauchszähler)\n\n### FULL Set (228 Sensors)\n\nAll STANDARD sensors **plus** 202 additional parameters:\n\n**Analog Sensors (112):**\n\n- All temperatures (Boiler, Buffer, HC 1-8, DHW, Solar)\n- O2 levels, Lambda values, Draft pressure\n- All valve positions (HC 1-8)\n- Motor currents (delivery, grate, ash removal)\n- Pellet stock, consumption, ash content\n- System time (minute, hour, day, month, year)\n- Analog inputs (AN11-AN16)\n\n**Digital Sensors (112):**\n\n- Motors (M1-M38): Pumps, mixers, feeders, ash removal\n- Inputs (E1-E16): Switches, thermostats, errors\n- Heating circuit modes (HC1-HC8): Auto, Party, Holiday\n- Operating modes: Auto, Manual, Heating, Error\n- Time programs: Reduced, Normal, Party countdown\n\n## Energy Dashboard Integration\n\nThe integration automatically creates a heat output sensor compatible with Home Assistant's Energy Dashboard:\n\n1. Go to **Settings** → **Dashboards** → **Energy**\n2. Add the **Hargassner Heat Output** (Wärmemenge) sensor to track your pellet heating energy usage\n\n### Customizing Energy Calculation\n\nThe heat output is calculated using the formula:\n\n```\nHeat (kWh) = Pellets (kg) × Energy Content (kWh/kg) × Efficiency (%)\n```\n\nYou can customize both values in the integration options:\n\n- **Pellet Energy Content**: Default 4.8 kWh/kg (range: 3.0-6.0)\n- **Boiler Efficiency**: Default 90% (range: 50-100%)\n\n**Example**: With 100 kg pellets consumed, 4.8 kWh/kg energy content, and 90% efficiency:\n```\n100 kg × 4.8 kWh/kg × 0.90 = 432 kWh\n```\n\nTo adjust these values:\n1. Go to **Settings** → **Devices \u0026 Services**\n2. Find your Hargassner integration\n3. Click **Configure** → Adjust values as needed\n\n## 📚 Documentation\n\n### User Guides\n\n- **[Quick Start Guide](README.md#️-configuration)** - Get started in 5 minutes\n- **[German Quick Start (SCHNELLSTART.md)](SCHNELLSTART.md)** - Schnellstartanleitung auf Deutsch\n- **[Detailed Installation Guide](docs/INSTALLATION.md)** - Step-by-step installation instructions\n- **[Energy Dashboard Setup](README.md#energy-dashboard-integration)** - Configure energy tracking\n- **[Custom Dashboard Setup](docs/CUSTOM_DASHBOARD.md)** - Complete dashboard with consumption forecasts and HDD analysis\n\n### Technical Documentation\n\n- **[Architecture Overview](docs/ARCHITECTURE.md)** - Deep-dive into technical architecture, data flow, and design decisions\n- **[Development Guide](docs/DEVELOPMENT.md)** - Developer setup, coding standards, and workflow\n- **[Adding Firmware Support](docs/ADDING_FIRMWARE.md)** - Guide for adding new firmware versions (English)\n- **[Neue Firmware hinzufügen](docs/ADDING_FIRMWARE_DE.md)** - Anleitung für neue Firmware-Versionen (Deutsch)\n- **[Contributing Guidelines](docs/CONTRIBUTING.md)** - How to contribute to this project\n\n### Troubleshooting\n\n- **[Common Issues](README.md#troubleshooting)** - Solutions for connection and data problems\n- **[Debug Logging](README.md#enable-debug-logging)** - Enable detailed logging for diagnosis\n\n## Troubleshooting\n\n### Connection Issues\n\n- Ensure telnet (port 23) is enabled on your boiler\n- Check firewall settings\n- Verify IP address and network connectivity\n- Check logs: **Settings** → **System** → **Logs**\n\n### Incorrect Data\n\n- Verify the correct firmware version is selected\n- Check encoding in logs\n- Enable debug logging (see below)\n\n### Enable Debug Logging\n\nAdd to `configuration.yaml`:\n\n```yaml\nlogger:\n  default: info\n  logs:\n    custom_components.bauergroup_hargassnerintegration: debug\n```\n\n## Architecture\n\nSee [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed technical documentation.\n\n## Development\n\nSee [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for development guidelines.\n\n## Contributing\n\nContributions are welcome! Please read [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) first.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- [Issue Tracker](https://github.com/bauer-group/IP-HargassnerIntegration/issues)\n- [Discussions](https://github.com/bauer-group/IP-HargassnerIntegration/discussions)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbauer-group%2Fip-hargassnerintegration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbauer-group%2Fip-hargassnerintegration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbauer-group%2Fip-hargassnerintegration/lists"}