HomeWizard Cloud watermeter integration

Share your Projects! Custom Integrations
1

Hi guys,

I recently bought a HomeWizard watermeter device. HomeWizard official integration is really great as it works with a real-time local API running directly on their devices. However, in the case of the watermeter, the local API is only available when the device is powered through USB. When running on batteries, the official integration can not be used, and the device only reports water consumption to the HomeWizard cloud directly (only 4 reports are done per day in this case to limit power consumption).

To bypass this, I created a custom integration that fetch the data from the HomeWIzard Cloud.

The integration is available on github.

I copy/paste the readme below for those interested:

HomeWizard Cloud Watermeter Integration for Home Assistant

This is a custom integration for Home Assistant that allows you to retrieve daily consumption data from your HomeWizard watermeter devices via the HomeWizard Cloud API.

Overview

The official HomeWizard Energy integration for Home Assistant provides excellent real-time data using a local API. However, for the HomeWizard Watermeter, this local API is only active when the device is powered by its USB port.

When the Watermeter runs on batteries, it disables the local API to conserve power. Instead, it takes four readings per day and uploads them to the HomeWizard cloud. This integration was created to bridge that gap, fetching those daily totals from the cloud and bringing them into Home Assistant.

Who is this for?

This integration is specifically for users who:

  • Own a HomeWizard Watermeter.
  • Run it on battery power (and thus cannot use the local API).
  • Want to integrate their daily water consumption data into Home Assistant.

If you power your Watermeter via USB, you should use the official HomeWizard integration for real-time data.

Installation

The recommended way to install this integration is through the Home Assistant Community Store (HACS).

  1. Go to HACS > Integrations.
  2. Click the three dots in the top right and select “Custom repositories”.
  3. Add the URL to this repository and select “Integration” as the category.
  4. Find “HomeWizard Cloud Watermeter” in the list and click “Install”.
  5. Restart Home Assistant.

Configuration

  1. Go to Settings > Devices & Services.
  2. Click Add Integration and search for “HomeWizard Cloud Watermeter”.
  3. Enter your HomeWizard account email and password. These are the same credentials you use for the mobile app.
  4. If you have multiple homes configured in your account, select the correct location from the list of the second step.
  5. The integration will automatically discover your devices (like Watermeter, P1 Meter, etc.) and create corresponding devices and sensor entities in Home Assistant.

Important Notes

  • Cloud-Based: This integration relies on the HomeWizard Cloud. It is not real-time and will only update a few times a day, corresponding to when the battery-powered device uploads its data.
  • Data Scope: The integration fetches data from the “Energy Panel” view in the app, which represents daily totals.

This is an unofficial integration and is not affiliated with HomeWizard.

Thanks for reading :slightly_smiling_face:

1 Like