From 1df37a19e21712a4a1af88406e34dbcb03a19d28 Mon Sep 17 00:00:00 2001 From: Michael Heyman <2618514+michaelheyman@users.noreply.github.com> Date: Mon, 23 Jun 2025 11:39:47 -0700 Subject: [PATCH] Add Tilt Pi integration (#37788) Co-authored-by: Michael Heyman Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Joost Lekkerkerker --- CODEOWNERS | 1 + source/_integrations/tilt_pi.markdown | 87 +++++++++++++++++++++++++++ 2 files changed, 88 insertions(+) create mode 100644 source/_integrations/tilt_pi.markdown diff --git a/CODEOWNERS b/CODEOWNERS index 69f8ceef5d9..f2e62dd4aea 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -925,6 +925,7 @@ source/_integrations/thread.markdown @home-assistant/core source/_integrations/tibber.markdown @danielhiversen source/_integrations/tile.markdown @bachya source/_integrations/tilt_ble.markdown @apt-itude +source/_integrations/tilt_pi.markdown @michaelheyman source/_integrations/time.markdown @home-assistant/core source/_integrations/time_date.markdown @fabaff source/_integrations/tmb.markdown @alemuro diff --git a/source/_integrations/tilt_pi.markdown b/source/_integrations/tilt_pi.markdown new file mode 100644 index 00000000000..6352b5eee47 --- /dev/null +++ b/source/_integrations/tilt_pi.markdown @@ -0,0 +1,87 @@ +--- +title: Tilt Pi +description: Instructions on how to configure a Tilt Pi. +ha_category: + - Sensor +ha_release: '2025.7' +ha_iot_class: Local Polling +ha_quality_scale: Bronze +ha_config_flow: true +ha_codeowners: + - '@michaelheyman' +ha_domain: tilt_pi +ha_platforms: + - sensor +related: + - url: https://tilthydrometer.com/collections/tilt-pi + title: Tilt Pi product page +--- + +The **Tilt Pi** {% term integration %} allows you to connect a Tilt Pi to Home Assistant to +automatically discover Tilt Hydrometer devices. + +The Tilt Pi is a Raspberry Pi-based device that can read data from Tilt +Hydrometers and broadcast it over the network. The Tilt Pi can be used to +monitor the fermentation of beer, wine, cider, and other beverages. + +The benefit of the Tilt Pi is that it can be placed in a location with better +reception than the Tilt Hydrometer itself, allowing for more reliable data +collection. + +{% note %} +For instances where you only have a Tilt Hydrometer and not a Tilt Pi, consider +using the [Tilt Hydrometer integration](/integrations/tilt_ble). +{% endnote %} + +## Prerequisites + +1. Have a Raspberry Pi with the Tilt Pi software installed. +2. Have a Tilt Hydrometer in range of the Tilt Pi. +3. Have the IP address or hostname of the Tilt Pi. + +{% include integrations/config_flow.md %} +{% configuration_basic %} +Host: + description: "The hostname or IP address of the Tilt Pi." +Port: + description: "The port of the Tilt Pi. The default port is 1880." +{% endconfiguration_basic %} + +## Supported functionality + +### Entities + +After adding the integration, you can add the Tilt Pi device to your Home +Assistant. If the Tilt Pi was found and there are Tilt Hydrometers in its range, +then entities will be created for each Tilt Hydrometer. + +You may then use these entities in automations, scripts, dashboards, and other +integrations. + +#### Sensors + +- **Tilt Hydrometer temperature** + - **Description**: Current temperature of the Tilt Hydrometer. + - **Entity name**: `tilt__temperature` + +- **Tilt Hydrometer gravity** + - **Description**: Current specific gravity of the Tilt Hydrometer. + - **Entity name**: `tilt__gravity` + +## Data updates + +The Tilt Pi integration {% term polling polls %} the Tilt Pi for data every 60 seconds. This +interval is currently not configurable. + +## Supported devices + +The following devices are known to be supported by the integration: + +- [Tiltâ„¢ Pi v2 Bookworm May24](https://tilthydrometer.com/collections/tilt-pi/products/tilt-pi-v2-bookworm-may24-raspberry-pi-sd-card-image-download) + +## Removing the integration + +This integration follows standard integration removal. No extra steps are +required. + +{% include integrations/remove_device_service.md %}