jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-21 00:06:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add-watergate-event-entity (#36932)

Browse Source
This commit is contained in:
c0ffeeca7 2025-03-25 14:35:47 +01:00 committed by GitHub
commit 88b9c64e48
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 19 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
source/_integrations/watergate.markdown
View File

@ -13,6 +13,7 @@ ha_codeowners:
ha_domain: watergate ha_domain: watergate
ha_platforms: ha_platforms:
- sensor - sensor
- event
- valve - valve
ha_quality_scale: bronze ha_quality_scale: bronze
ha_integration_type: integration ha_integration_type: integration
@ -24,6 +25,7 @@ With this integration, you are able to:
- Control your valve - Control your valve
- Monitor live telemetry (water flow, water pressure, water temperature) - Monitor live telemetry (water flow, water pressure, water temperature)
- Monitor water usage - Monitor water usage
- Receive information when Sonic shuts off the valve due to potential leak
## Prerequisites ## Prerequisites
@ -72,6 +74,16 @@ The Watergate integration provides the following entities.
- **Description**: The current state of the water valve (open/closed). - **Description**: The current state of the water valve (open/closed).
- **Remarks**: It is automatically updated when the valve state is changed. - **Remarks**: It is automatically updated when the valve state is changed.
#### Events
- **Auto Shut-Off**
- **Description**: Event triggered when the valve automatically shuts off due to detected leak.
- **Event Type**: Either `volume_threshold` or `duration_threshold`
- **Event Data**:
- `volume`: The volume of water that triggered the shut-off
- `duration`: The duration of leak that triggered the shut-off
- **Remarks**: Historical events are not preserved across Home Assistant restarts.
## Data updates ## Data updates
The Watergate integration fetches data from the Sonic device every 2 minutes. The Watergate integration fetches data from the Sonic device every 2 minutes.
@ -79,7 +91,7 @@ Thanks to the webhook option, Sonic will provide live telemetry every second whe
## Known limitations ## Known limitations
The integration does not provide the ability to set auto shut-off thresholds and does not report any events regarding automatically closed valves. The integration does not provide the ability to set auto shut-off thresholds.
{% include integrations/config_flow.md %} {% include integrations/config_flow.md %}
@ -88,12 +100,6 @@ IP address:
description: "The IP address of your Sonic device." description: "The IP address of your Sonic device."
{% endconfiguration_basic %} {% endconfiguration_basic %}
## Removing the integration
This integration follows standard integration removal procedures. No extra steps are required.
{% include integrations/remove_device_service.md %}
## Examples ## Examples
### Monitor water usage in the Energy Dashboard ### Monitor water usage in the Energy Dashboard
@ -107,3 +113,9 @@ The water meter volume entity can be added to the Energy Dashboard, allowing you
- Send a notification when the water is too hot. - Send a notification when the water is too hot.
- Send a notification when the water is too cold. - Send a notification when the water is too cold.
- Send a notification when water is flowing for too long. - Send a notification when water is flowing for too long.
## Removing the integration
This integration follows standard integration removal procedures. No extra steps are required.
{% include integrations/remove_device_service.md %}