Added guntamatic heater integration

.strict-typing

@@ -245,6 +245,7 @@ homeassistant.components.gpsd.*
 homeassistant.components.greeneye_monitor.*
 homeassistant.components.group.*
 homeassistant.components.guardian.*
+homeassistant.components.guntamatic_sensor.*
 homeassistant.components.habitica.*
 homeassistant.components.hardkernel.*
 homeassistant.components.hardware.*

homeassistant/components/guntamatic_sensor/README.md

@@ -0,0 +1,38 @@
+# Guntamatic Sensor
+
+## High-Level Description
+The Guntamatic Sensor integration allows Home Assistant to monitor sensors from Guntamatic heaters. Guntamatic is a brand of modern wood/pellet gas boilers. This integration exposes temperature, operational state, and other relevant sensors.
+
+
+## Sensors
+The integration currently exposes the following sensors (dynamic values):
+
+- Boiler state: Running, STANDBY
+- Boiler temperature
+- Outside temperature
+- Buffer load and buffer top/mid/bottom temperatures
+- Boiler shunt pump, suction fan, primary and secondary air
+- CO₂ content
+- Domestic hot water (DHW) temperatures and pumps
+- Heating circulation pumps and flow temperatures for multiple zones
+- Program states (HEAT/HC)
+- Interruptions
+- Serial number, version, operation time, service hours
+- Auxiliary pumps
+- Additional WW/Buffer sensors
+
+## Installation Instructions
+1. Copy the `guntamatic_sensor` folder into `config/custom_components/`.
+2. Restart Home Assistant.
+3. Go to **Settings → Devices & Services → Add Integration**.
+4. Search for "Guntamatic Sensor" and enter the host address of your heater.
+
+## Removal Instructions
+1. Go to **Settings → Devices & Services**.
+2. Select the Guntamatic Sensor integration.
+3. Click **Delete** to remove the integration and its entities.
+4. Optional: Delete the `guntamatic_sensor` folder from `custom_components/`.
+
+## Services
+This integration does **not** provide any Home Assistant service calls.
+

homeassistant/components/guntamatic_sensor/__init__.py

@@ -0,0 +1,101 @@
+"""The guntamatic integration."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+import logging
+
+from guntamatic.heater import Heater
+
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.const import CONF_HOST, Platform
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import ConfigEntryNotReady
+from homeassistant.helpers import device_registry as dr
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator, UpdateFailed
+
+from .const import DOMAIN, SCAN_INTERVAL
+
+# For your initial PR, limit it to 1 platform.
+_LOGGER = logging.getLogger(__name__)
+_PLATFORMS: list[Platform] = [Platform.SENSOR]
+
+type GuntamaticConfigEntry = ConfigEntry[Heater]
+
+
+@dataclass
+class GuntamaticData:
+    """Data for the Guntamatic integration."""
+
+    heater: Heater
+    coordinator: DataUpdateCoordinator
+
+
+async def async_setup_entry(hass: HomeAssistant, entry: GuntamaticConfigEntry) -> bool:
+    """Set up guntamatic from a config entry."""
+
+    host = entry.data[CONF_HOST]
+    heater = Heater(host)
+
+    # initial connectivity check
+    initial_data = None
+    try:
+        initial_data = await hass.async_add_executor_job(heater.get_data)
+    except Exception as err:
+        raise ConfigEntryNotReady(
+            f"Cannot connect to Guntamatic heater: {err}"
+        ) from err
+
+    if not initial_data:
+        raise ConfigEntryNotReady("Cannot connect to Guntamatic heater")
+
+    async def async_update_data() -> dict[str, list[str]]:
+        """Fetch all sensor data from the heater.
+
+        Expected return format:
+            {
+                "Boiler Temperature": [68.5, "°C"],
+                "Flue Temperature": [115.2, "°C"],
+                "Power Output": [12.4, "kW"],
+            }
+        """
+
+        data: dict[str, list[str]] = await hass.async_add_executor_job(heater.get_data)
+        if not data:
+            raise UpdateFailed("No data received from heater")
+        return data
+
+    coordinator = DataUpdateCoordinator(
+        hass,
+        logger=_LOGGER,
+        name="guntamatic_sensor",
+        update_method=async_update_data,
+        update_interval=SCAN_INTERVAL,
+        config_entry=entry,
+    )
+
+    coordinator.data = initial_data
+    entry.runtime_data = GuntamaticData(heater=heater, coordinator=coordinator)
+
+    await hass.config_entries.async_forward_entry_setups(entry, _PLATFORMS)
+    return True
+
+
+async def async_unload_entry(hass: HomeAssistant, entry: GuntamaticConfigEntry) -> bool:
+    """Unload a config entry."""
+    return await hass.config_entries.async_unload_platforms(entry, _PLATFORMS)
+
+
+async def async_remove_config_entry_device(
+    hass: HomeAssistant,
+    config_entry: GuntamaticConfigEntry,
+    device_entry: dr.DeviceEntry,
+) -> bool:
+    """Remove a config entry from a device."""
+    return not any(
+        identifier
+        for identifier in device_entry.identifiers
+        if identifier[0] == DOMAIN
+        and identifier[1]
+        == config_entry.runtime_data.coordinator.data.get("Serial", [None])[0]
+    )

homeassistant/components/guntamatic_sensor/config_flow.py

@@ -0,0 +1,73 @@
+"""Config flow for the guntamatic integration."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from guntamatic.heater import Heater
+import requests
+import voluptuous as vol
+
+from homeassistant.config_entries import ConfigFlow, ConfigFlowResult
+from homeassistant.const import CONF_HOST
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import HomeAssistantError
+
+from .const import DOMAIN
+
+_LOGGER = logging.getLogger(__name__)
+
+STEP_USER_DATA_SCHEMA = vol.Schema(
+    {
+        vol.Required(CONF_HOST): str,
+    }
+)
+
+
+async def validate_input(hass: HomeAssistant, data: dict[str, Any]) -> dict[str, Any]:
+    """Validate the user input allows us to connect.
+
+    Data has the keys from STEP_USER_DATA_SCHEMA with values provided by the user.
+    """
+    heater = Heater(data[CONF_HOST])
+
+    if not await hass.async_add_executor_job(heater.get_data):
+        raise CannotConnect
+
+    # Return info that you want to store in the config entry.
+    return {"host": data[CONF_HOST]}
+
+
+class GuntamaticConfigFlow(ConfigFlow, domain=DOMAIN):
+    """Handle a config flow for guntamatic."""
+
+    VERSION = 1
+
+    async def async_step_user(
+        self, user_input: dict[str, Any] | None = None
+    ) -> ConfigFlowResult:
+        """Handle the initial step."""
+        errors: dict[str, str] = {}
+        if user_input is not None:
+            self._async_abort_entries_match({CONF_HOST: user_input[CONF_HOST]})
+            try:
+                info = await validate_input(self.hass, user_input)
+            except CannotConnect, requests.exceptions.ConnectionError:
+                errors["base"] = "cannot_connect"
+            except Exception:
+                _LOGGER.exception("Unexpected exception")
+                errors["base"] = "unknown"
+            else:
+                return self.async_create_entry(
+                    title="Guntamatic Heater",
+                    data=info,
+                )
+
+        return self.async_show_form(
+            step_id="user", data_schema=STEP_USER_DATA_SCHEMA, errors=errors
+        )
+
+
+class CannotConnect(HomeAssistantError):
+    """Error to indicate we cannot connect."""

homeassistant/components/guntamatic_sensor/const.py

@@ -0,0 +1,31 @@
+"""Constants for the guntamatic integration."""
+
+from datetime import timedelta
+
+from homeassistant.components.sensor import SensorDeviceClass, SensorStateClass
+
+DOMAIN = "guntamatic_sensor"
+SCAN_INTERVAL = timedelta(seconds=30)
+DIAGNOSTIC_SENSORS = {"Serial", "Version", "Operat. time", "Service Hrs"}
+
+SENSOR_DEVICE_CLASSES: dict[str, SensorDeviceClass | None] = {
+    "Boiler temperature": SensorDeviceClass.TEMPERATURE,
+    "Outside Temp.": SensorDeviceClass.TEMPERATURE,
+    "Buffer Top": SensorDeviceClass.TEMPERATURE,
+    "Buffer Mid": SensorDeviceClass.TEMPERATURE,
+    "Buffer Btm": SensorDeviceClass.TEMPERATURE,
+    "DHW 0": SensorDeviceClass.TEMPERATURE,
+    "DHW 1": SensorDeviceClass.TEMPERATURE,
+    "DHW 2": SensorDeviceClass.TEMPERATURE,
+    # co2 content is explicitly not a co2 device class, this is flue gas, which will be 900.000ppm it doesn't make sense
+    # to put it in the category of indoor air quality measurement devices
+    # "CO2 Content": SensorDeviceClass.CO2,
+    "Operat. time": SensorDeviceClass.DURATION,
+}
+
+SENSOR_STATE_CLASSES: dict[str, SensorStateClass | None] = {
+    "Boiler temperature": SensorStateClass.MEASUREMENT,
+    "Outside Temp.": SensorStateClass.MEASUREMENT,
+    "Buffer load.": SensorStateClass.MEASUREMENT,
+    "CO2 Content": SensorStateClass.MEASUREMENT,
+}

homeassistant/components/guntamatic_sensor/diagnostics.py

@@ -0,0 +1,19 @@
+"""Diagnostics support for Guntamatic."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from homeassistant.core import HomeAssistant
+
+from . import GuntamaticConfigEntry
+
+
+async def async_get_config_entry_diagnostics(
+    hass: HomeAssistant, entry: GuntamaticConfigEntry
+) -> dict[str, Any]:
+    """Return diagnostics for a config entry."""
+    return {
+        "entry_data": dict(entry.data),
+        "data": entry.runtime_data.coordinator.data,
+    }

homeassistant/components/guntamatic_sensor/manifest.json

@@ -0,0 +1,15 @@
+{
+  "domain": "guntamatic_sensor",
+  "name": "guntamatic",
+  "codeowners": ["@JensTimmerman"],
+  "config_flow": true,
+  "dependencies": [],
+  "documentation": "https://www.home-assistant.io/integrations/guntamatic_sensor",
+  "homekit": {},
+  "integration_type": "device",
+  "iot_class": "local_polling",
+  "quality_scale": "silver",
+  "requirements": ["guntamatic==1.0.3"],
+  "ssdp": [],
+  "zeroconf": []
+}

homeassistant/components/guntamatic_sensor/quality_scale.yaml

@@ -0,0 +1,74 @@
+rules:
+  # Bronze
+  action-setup: done
+  appropriate-polling: done
+  brands: done
+  common-modules: done
+  config-flow-test-coverage: done
+  config-flow: done
+  dependency-transparency: done
+  docs-actions:
+    status: exempt
+    comment: |
+      No custom actions are defined.
+  docs-high-level-description: done
+  docs-installation-instructions: done
+  docs-removal-instructions: done
+  entity-event-setup: done
+  entity-unique-id: done
+  has-entity-name: done
+  runtime-data: done
+  test-before-configure: done
+  test-before-setup: done
+  unique-config-entry: done
+
+  # Silver
+  action-exceptions:
+    status: exempt
+    comment: |
+      No custom actions are defined.
+  config-entry-unloading: done
+  docs-configuration-parameters:
+    status: exempt
+    comment: No options flow
+  docs-installation-parameters: done
+  entity-unavailable: done
+  integration-owner: done
+  log-when-unavailable: done
+  parallel-updates: done
+  reauthentication-flow:
+    status: exempt
+    comment: No authentication required.
+  test-coverage: done
+
+  # Gold
+  devices: done
+  diagnostics: done
+  discovery-update-info:
+    status: exempt
+    comment: Guntamatic heaters do not support network discovery protocols.
+  discovery:
+    status: exempt
+    comment: Guntamatic heaters do not support network discovery protocols.
+  docs-data-update: todo
+  docs-examples: todo
+  docs-known-limitations: todo
+  docs-supported-devices: todo
+  docs-supported-functions: todo
+  docs-troubleshooting: todo
+  docs-use-cases: todo
+  dynamic-devices: done
+  entity-category: done
+  entity-device-class: todo
+  entity-disabled-by-default: todo
+  entity-translations: todo
+  exception-translations: todo
+  icon-translations: todo
+  reconfiguration-flow: todo
+  repair-issues: todo
+  stale-devices: todo
+
+  # Platinum
+  async-dependency: todo
+  inject-websession: todo
+  strict-typing: todo