feat: added basic integration

Author: reinos

.github/workflows/hassfest.yaml

@@ -0,0 +1,14 @@
+name: Validate with hassfest
+
+on:
+  push:
+  pull_request:
+  # schedule:
+  #   - cron: "0 0 * * *"
+
+jobs:
+  validate:
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: "actions/checkout@v3"
+      - uses: home-assistant/actions/hassfest@master

.github/workflows/validate.yml

@@ -0,0 +1,18 @@
+name: Validate
+
+on:
+  push:
+  pull_request:
+  # schedule:
+    # - cron: "0 0 * * *"
+  workflow_dispatch:
+
+jobs:
+  validate:
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: "actions/checkout@v4"
+      - name: HACS validation
+        uses: "hacs/action@main"
+        with:
+          category: "integration"

README.md

@@ -1,3 +1,49 @@
-# Boiler Controller HA integration
+# Boiler Controller HA Integration
 
-[TODO]
+A Home Assistant integration for automatically controlling a Shelly Dimmer 0/1-10V PM Gen3 based on P1 smart meter data.
+
+## Features
+
+This integration:
+- Reads data from a P1 smart meter via an existing Home Assistant device
+- Controls a Shelly Dimmer 0/1-10V PM Gen3 based on live net consumption
+- Automatically switches between different dimmer percentages depending on consumption
+- Provides Shelly telemetry sensors (voltage, current, power, temperature, energy)
+- Exposes manual override entities so you can switch between automatic logic and a fixed brightness when needed
+
+## Installation
+
+1. Install via HACS or copy the `custom_components/boiler_controller` folder to your Home Assistant configuration
+2. Restart Home Assistant
+3. Go to Settings > Devices & Services
+4. Click "Add Integration" and search for "Boiler Controller"
+5. Follow the configuration steps:
+   - Select your P1 smart meter device
+   - Choose the correct power entity from the P1 meter
+   - Select your Shelly Dimmer device
+
+## Configuration
+
+The integration requires:
+- A working P1 smart meter integration in Home Assistant
+- A Shelly Dimmer 0/1-10V PM Gen3 device connected to Home Assistant
+
+## Advanced Settings & Manual Override
+
+Via the integration options you can adjust the minimum and maximum dimmer bounds that the automatic logic uses.
+
+For ad-hoc control you also get two helper entities once the integration is set up:
+
+- `Select` – **{Integration Name} Dimmer Mode**: choose `auto` to let the controller react to power usage, or `manual` to override the Shelly brightness yourself.
+- `Number` – **{Integration Name} Manual Brightness**: specify the brightness percentage (0–100). This value is only applied when the mode select is in `manual`.
+
+Switching back to `auto` immediately returns control to the P1-driven logic.
+
+## Logic
+
+The default logic:
+- At 0W consumption: dimmer at minimum
+- At 3000W+ consumption: dimmer at maximum
+- In between: linearly scaled between min and max
+
+This logic can be customized in the `controller.py` file.

custom_components/.DS_Store

@@ -0,0 +1,67 @@
+import logging
+
+from homeassistant.core import HomeAssistant
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.loader import async_get_integration
+
+from .const import DOMAIN, PLATFORMS
+from .controller import BoilerController
+
+_LOGGER = logging.getLogger(__name__)
+
+
+# Set up the component
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
+    """Set up Boiler Controller from a config entry."""
+    _LOGGER.info("Setting up Boiler Controller")
+    
+    integration = await async_get_integration(hass, DOMAIN)
+    integration_version = integration.version
+
+    # Create the controller
+    controller = BoilerController(hass, entry, integration_version)
+    
+    # Start the controller (now handles missing entities gracefully)
+    success = await controller.async_start()
+    if not success:
+        _LOGGER.error("Failed to start Boiler Controller")
+        # Don't raise ConfigEntryNotReady anymore - let it start and wait for entities
+        _LOGGER.warning("Boiler Controller will continue running and wait for entities to become available")
+    
+    # Store the controller
+    hass.data.setdefault(DOMAIN, {})[entry.entry_id] = {
+        "controller": controller,
+    }
+    
+    # Set up platforms
+    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
+    
+    _LOGGER.info("Boiler Controller setup completed")
+    return True
+
+# Implement unloading and reloading of the config entry
+async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
+    """Unload a config entry."""
+    _LOGGER.info("Unloading Boiler Controller")
+    
+    # Unload platforms
+    unload_ok = await hass.config_entries.async_unload_platforms(entry, PLATFORMS)
+    
+    # Stop the controller
+    controller_data = hass.data.get(DOMAIN, {}).get(entry.entry_id)
+    if controller_data:
+        controller = controller_data.get("controller")
+        if controller:
+            await controller.async_stop()
+    
+    # Remove from hass.data
+    if DOMAIN in hass.data and entry.entry_id in hass.data[DOMAIN]:
+        hass.data[DOMAIN].pop(entry.entry_id)
+    
+    return unload_ok
+
+
+async def async_reload_entry(hass: HomeAssistant, entry: ConfigEntry) -> None:
+    """Reload config entry."""
+    await async_unload_entry(hass, entry)
+    await async_setup_entry(hass, entry)