Integration for the HomeWizard Energy platform. It can collect data locally from the HomeWizard Energy products and create them as sensors in Home Assistant.
Wi-Fi P1 Meter: Sensors for power import/export, energy consumption (single or three phases). information about your smart meter and gas. (Model:
Wi-Fi Energy Socket: Sensors for power import/export and energy consumption and switches for controlling the outlet (model:
Wi-Fi Watermeter: Sensors for active and total water usage (model:
Wi-Fi kWh Meter: Sensors for power import/export and energy consumption. (Models:
The Watermeter can be powered via a USB-C cable and with batteries. When using batteries they only connect to Wi-Fi every couple of hours. Because of this, the API can only be used when powered via the USB-C cable. It is not possible to use this integration when the water meter is powered by batteries.
Enable the API
You have to enable the local API to allow Home Assistant to communicate with your device. Do this in the HomeWizard Energy app:
- Go to Settings. (Gear icon in the upper-right)
- Go to ‘Meters’.
- Select your device.
- Scroll down and turn on ‘Local API’.
Adding HomeWizard Energy to your Home Assistant instance can be done via the user interface, by using this My button:
HomeWizard Energy can be auto-discovered by Home Assistant. If an instance was found, it will be shown as “Discovered”, which you can select to set it up right away.
If there wasn’t any discovered automatically, don’t worry! You can set up a manual integration entry:
Browse to your Home Assistant instance.
In the sidebar click on Settings.
From the configuration menu select: Devices & Services.
In the bottom right, click on the Add Integration button.
From the list, search and select “HomeWizard Energy”.
Follow the instruction on screen to complete the set up.
Sensors for the P1 meter, Energy socket, and kWh meter:
- Total energy import/export (kWh): Total energy imported or exported since installation. Each tariff has its own sensor (e.g., T1, T2) and a sensor for the combined value.
- Active power (W): Active power that is measured on each phase.
Sensors for P1 meter, only available when smart meter exposes these values:
- Gas usage (m³): Total gas used since the installation of the gas meter. A gas meter sends its measurement once every 5 minutes or per hour, depending on the version of the smart meter.
- Active tariff: Current tariff that is used. Can be used to keep consumption as low as possible during peak hours.
- Active voltage (V): Active voltage that is measured on each phase.
- Active current (A): Active current that is measured on each phase.
- Active frequency (Hz): Net frequency.
- Voltage sags and swells: Number of times a voltage sag or well has been detected.
- Power failures: Two sensors that indicate the number of power failures that have been detected by the smart meter. One for all power failures and another for ‘long’ power failures.
- Peak demand: Belgium users are started to get charged for the peak usage per month (see capaciteitstarief). Two sensors are available: One that shows the current quarterly average and another that shows the peak measured this month. Both these sensors are provided directly from the smart meter and can be used to keep the peak as low as possible.
Sensors for Water meter:
- Active usage (L/min): Flow of water that is measured at that time.
- Total usage (m³): Total water usage since the installation of the HomeWizard Water meter.
The Energy Socket outlet state and status light can be controlled. There are two switches:
- Switch: Controls the outlet state of the Energy Socket. This switch is locked out when Switch Lock is turned on.
- Switch lock: Forces the outlet state in the on position and disables the physical button. This option is useful when the socket is used for a device that must not be turned off, such as a refrigerator.
You can also control the green status light brightness with Status light brightness. This light turns on when the switch is on.
The identify button can be pressed to let the status light blink for a few seconds. This feature is currently only available for the P1 meter and the Energy Socket.
The HomeWizard Energy devices are designed to work with the HomeWizard Energy app and require communication with the HomeWizard cloud to make them function with the app. The “Cloud connection” configuration toggle can be used to turn off all communication with the HomeWizard cloud, making the device fully local. The device cannot communicate with the app, and the device won’t receive any future firmware updates. This feature is currently not available for the Water meter.
Cloud communication is restored when the switch is turned on again. Cloud communications are also restored after a factory reset, or when the device is put in pairing mode.