home-assistant · joostlek · Jun 23, 2025 · Feb 23, 2025 · Feb 23, 2025 · Feb 23, 2025
diff --git a/CODEOWNERS b/CODEOWNERS
diff --git a/homeassistant/brands/tilt.json b/homeassistant/brands/tilt.json
@@ -0,0 +1,5 @@
+{
+  "domain": "tilt",
+  "name": "Tilt",
+  "integrations": ["tilt_ble", "tilt_pi"]
+}
diff --git a/homeassistant/components/tilt_pi/__init__.py b/homeassistant/components/tilt_pi/__init__.py
@@ -0,0 +1,28 @@
+"""The Tilt Pi integration."""
+
+from homeassistant.const import Platform
+from homeassistant.core import HomeAssistant
+
+from .coordinator import TiltPiConfigEntry, TiltPiDataUpdateCoordinator
+
+PLATFORMS: list[Platform] = [Platform.SENSOR]
+
+
+async def async_setup_entry(hass: HomeAssistant, entry: TiltPiConfigEntry) -> bool:
+    """Set up Tilt Pi from a config entry."""
+    coordinator = TiltPiDataUpdateCoordinator(
+        hass,
+        entry,
+    )
+
+    await coordinator.async_config_entry_first_refresh()
+    entry.runtime_data = coordinator
+
+    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
+
+    return True
+
+
+async def async_unload_entry(hass: HomeAssistant, entry: TiltPiConfigEntry) -> bool:
+    """Unload a config entry."""
+    return await hass.config_entries.async_unload_platforms(entry, PLATFORMS)
diff --git a/homeassistant/components/tilt_pi/config_flow.py b/homeassistant/components/tilt_pi/config_flow.py
@@ -0,0 +1,63 @@
+"""Config flow for Tilt Pi integration."""
+
+from typing import Any
+
+import aiohttp
+from tiltpi import TiltPiClient, TiltPiError
+import voluptuous as vol
+from yarl import URL
+
+from homeassistant.config_entries import ConfigFlow, ConfigFlowResult
+from homeassistant.const import CONF_HOST, CONF_PORT, CONF_URL
+from homeassistant.helpers.aiohttp_client import async_get_clientsession
+
+from .const import DOMAIN
+
+
+class TiltPiConfigFlow(ConfigFlow, domain=DOMAIN):
+    """Handle a config flow for Tilt Pi."""
+
+    async def _check_connection(self, host: str, port: int) -> str | None:
+        """Check if we can connect to the TiltPi instance."""
+        client = TiltPiClient(
+            host,
+            port,
+            session=async_get_clientsession(self.hass),
+        )
+        try:
+            await client.get_hydrometers()
+        except (TiltPiError, TimeoutError, aiohttp.ClientError):
+            return "cannot_connect"
+        return None
+
+    async def async_step_user(
+        self, user_input: dict[str, Any] | None = None
+    ) -> ConfigFlowResult:
+        """Handle a configuration flow initialized by the user."""
+
+        errors = {}
+        if user_input is not None:
+            url = URL(user_input[CONF_URL])
+            if (host := url.host) is None:
+                errors[CONF_URL] = "invalid_host"
+            else:
+                self._async_abort_entries_match({CONF_HOST: host})
+                port = url.port
+                assert port
+                error = await self._check_connection(host=host, port=port)
+                if error:
+                    errors["base"] = error
+                else:
+                    return self.async_create_entry(
+                        title="Tilt Pi",
+                        data={
+                            CONF_HOST: host,
+                            CONF_PORT: port,
+                        },
+                    )
+
+        return self.async_show_form(
+            step_id="user",
+            data_schema=vol.Schema({vol.Required(CONF_URL): str}),
+            errors=errors,
+        )
diff --git a/homeassistant/components/tilt_pi/const.py b/homeassistant/components/tilt_pi/const.py
@@ -0,0 +1,8 @@
+"""Constants for t
9E81
he Tilt Pi integration."""
+
+import logging
+from typing import Final
+
+LOGGER = logging.getLogger(__package__)
+
+DOMAIN: Final = "tilt_pi"
diff --git a/homeassistant/components/tilt_pi/coordinator.py b/homeassistant/components/tilt_pi/coordinator.py
@@ -0,0 +1,53 @@
+"""Data update coordinator for Tilt Pi."""
+
+from datetime import timedelta
+from typing import Final
+
+from tiltpi import TiltHydrometerData, TiltPiClient, TiltPiError
+
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.const import CONF_HOST, CONF_PORT
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers.aiohttp_client import async_get_clientsession
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator, UpdateFailed
+
+from .const import LOGGER
+
+SCAN_INTERVAL: Final = timedelta(seconds=60)
+
+type TiltPiConfigEntry = ConfigEntry[TiltPiDataUpdateCoordinator]
+
+
+class TiltPiDataUpdateCoordinator(DataUpdateCoordinator[dict[str, TiltHydrometerData]]):
+    """Class to manage fetching Tilt Pi data."""
+
+    config_entry: TiltPiConfigEntry
+
+    def __init__(
+        self,
+        hass: HomeAssistant,
+        config_entry: TiltPiConfigEntry,
+    ) -> None:
+        """Initialize the coordinator."""
+        super().__init__(
+            hass,
+            LOGGER,
+            config_entry=config_entry,
+            name="Tilt Pi",
+            update_interval=SCAN_INTERVAL,
+        )
+        self._api = TiltPiClient(
+            host=config_entry.data[CONF_HOST],
+            port=config_entry.data[CONF_PORT],
+            session=async_get_clientsession(hass),
+        )
+        self.identifier = config_entry.entry_id
+
+    async def _async_update_data
F438
(self) -> dict[str, TiltHydrometerData]:
+        """Fetch data from Tilt Pi and return as a dict keyed by mac_id."""
+        try:
+            hydrometers = await self._api.get_hydrometers()
+        except TiltPiError as err:
+            raise UpdateFailed(f"Error communicating with Tilt Pi: {err}") from err
+
+        return {h.mac_id: h for h in hydrometers}
diff --git a/homeassistant/components/tilt_pi/entity.py b/homeassistant/components/tilt_pi/entity.py
@@ -0,0 +1,39 @@
+"""Base entity for Tilt Pi integration."""
+
+from tiltpi import TiltHydrometerData
+
+from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC, DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity
+
+from .coordinator import TiltPiDataUpdateCoordinator
+
+
+class TiltEntity(CoordinatorEntity[TiltPiDataUpdateCoordinator]):
+    """Base class for Tilt entities."""
+
+    _attr_has_entity_name = True
+
+    def __init__(
+        self,
+        coordinator: TiltPiDataUpdateCoordinator,
+        hydrometer: TiltHydrometerData,
+    ) -> None:
+        """Initialize the entity."""
+        super().__init__(coordinator)
+        self._mac_id = hydrometer.mac_id
+        self._attr_device_info = DeviceInfo(
+            connections={(CONNECTION_NETWORK_MAC, hydrometer.mac_id)},
+            name=f"Tilt {hydrometer.color}",
+            manufacturer="Tilt Hydrometer",
+            model=f"{hydrometer.color} Tilt Hydrometer",
+        )
+
+    @property
+    def current_hydrometer(self) -> TiltHydrometerData:
+        """Return the current hydrometer data for this entity."""
+        return self.coordinator.data[self._mac_id]
+
+    @property
+    def available(self) -> bool:
+        """Return True if the hydrometer is available (present in coordinator data)."""
+        return super().available and self._mac_id in self.coordinator.data
diff --git a/homeassistant/components/tilt_pi/icons.json b/homeassistant/components/tilt_pi/icons.json
@@ -0,0 +1,9 @@
+{
+  "entity": {
+    "sensor": {
+      "gravity": {
+        "default": "mdi:water"
+      }
+    }
+  }
+}
diff --git a/homeassistant/components/tilt_pi/manifest.json b/homeassistant/components/tilt_pi/manifest.json
@@ -0,0 +1,10 @@
+{
+  "domain": "tilt_pi",
+  "name": "Tilt Pi",
+  "codeowners": ["@michaelheyman"],
+  "config_flow": true,
+  "documentation": "https://www.home-assistant.io/integrations/tilt_pi",
+  "iot_class": "local_polling",
+  "quality_scale": "bronze",
+  "requirements": ["tilt-pi==0.2.1"]
+}
diff --git a/homeassistant/components/tilt_pi/quality_scale.yaml b/homeassistant/components/tilt_pi/quality_scale.yaml
@@ -0,0 +1,80 @@
+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: |
+      This integration does not provide additional actions.
+  docs-high-level-description: done
+  docs-installation-instructions: done
+  docs-removal-instructions: done
+  entity-event-setup:
+    status: exempt
+    comment: |
+      Entities of this integration does not explicitly subscribe to events.
+  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 to configure
+  docs-installation-parameters: done
+  entity-unavailable: done
+  integration-owner: done
+  log-when-unavailable: done
+  parallel-updates: done
+  reauthentication-flow:
+    status: exempt
+    comment: |
+      This integration does not require authentication.
+  test-coverage: done
+  # Gold
+  devices: done
+  diagnostics: todo
+  discovery-update-info: todo
+  discovery: todo
+  docs-data-update: todo
+  docs-examples: todo
+  docs-known-limitations: done
+  docs-supported-devices: done
+  docs-supported-functions: done
+  docs-troubleshooting: todo
+  docs-use-cases: todo
+  dynamic-devices: todo
+  entity-category:
+    status: done
+    comment: |
+      The entities are categorized well by using default category.
+  entity-device-class: done
+  entity-disabled-by-default:
+    status: exempt
+    comment: No disabled entities implemented
+  entity-translations: done
+  exception-translations: todo
+  icon-translations: done
+  reconfiguration-flow: todo
+  repair-issues:
+    status: exempt
+    comment: |
+      No repairs/issues.
+  stale-devices: todo
+  # Platinum
+  async-dependency: done
+  inject-websession: done
+  strict-typing: todo