4.2 KiB
title, description, ha_category, ha_config_flow, ha_release, ha_iot_class, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_zeroconf, ha_quality_scale
| title | description | ha_category | ha_config_flow | ha_release | ha_iot_class | ha_codeowners | ha_domain | ha_platforms | ha_integration_type | ha_zeroconf | ha_quality_scale | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Droplet | Instructions on how to setup Droplet in Home Assistant. |
|
true | 2025.10 | Local Push |
|
droplet |
|
integration | true | bronze |
The Droplet {% term integration %} seamlessly connects your Home Assistant setup to Droplet -- an advanced all-in-one smart home water sensor.
Leveraging cutting-edge ultrasonic sensing technology, Droplet accurately monitors your home's water usage in real time. It safeguards your property from potential water damage and empowers you to make informed decisions about water conservation and identify anomalies early.
Stay in control of your home's water system efficiently and intelligently with Droplet and Home Assistant.
Prerequisites
Before connecting to Home Assistant, it is necessary to enable the integration on your Droplet.
In the Droplet app, navigate to Settings > Smart Home Integrations > Home Assistant. Enable the integration and copy the token that appears on the screen. You will need to enter this in the configuration step.
{% include integrations/config_flow.md %}
{% configuration_basic %} IP address: description: "If your Droplet has a fixed IP address, you can use it for manual configuration. This field is not required for auto discovery." Pairing code: description: "Pairing code to authenticate with Droplet device. You can find it on the Droplet app under Settings > Smart Home Integrations > Home Assistant." {% endconfiguration_basic %}
Supported functionality
Sensors
The following sensors values are available:
- Flow rate
- Volume
- Server connectivity
- Signal quality
Data updates
Once the integration connects, Droplet will push data points as soon as they are available. During periods of increased activity, this may be as often as every 5 seconds. During periods of inactivity, it may be as seldom as every 30 seconds.
Use cases
Adding Droplet to your Energy Dashboard
- Open the edit menu of your energy dashboard.
- Select the water consumption tile.
- Select one of Droplet's volume sensors. Optionally, track your costs.
- Water usage recorded by Droplet will now be incorporated into your energy dashboard.
Removing the integration
This integration follows standard integration removal process.
{% include integrations/remove_device_service.md %} 4. To prevent Droplet from showing up as a discovered device after its removal, disable the local API in the Droplet app under Settings > Smart Home Integrations > Home Assistant.
Troubleshooting
Here are some steps you can take if you're having trouble connecting your Droplet to Home Assistant.
- Make sure you've entered the code from the Droplet app without any spaces and in all caps.
- Try waiting 1-2 minutes after enabling Home Assistant or regenerating the code in the app. It may take a moment for Droplet to be ready to accept connections.
FAQ
Q: Why does Droplet’s volume sensor sometimes show negative values?
A: Even when you’re not using appliances in your home, there can still be activity in your pipes. Droplet tries to be very accurate and is sensitive to small flows, which can include water sloshing back and forth, or slight movement as a result of pressure differences. Small negative values are to be expected, and are reported so that cumulative statistics reported in Home Assistant (or other consumers of the API) can be fully accurate.
Q: Why is Droplet's volume sensor value so small?
A: The volume reported by Droplet over local API is point-to-point, meaning that each new value represents the difference in volume recorded since this data was last sent. This data can be aggregated to generate cumulative volumes over periods such as days, weeks, or months.