2024.10.4
Home ▸ Integrations ▸

HomeWizard Energy

Integration for the HomeWizard Energy platform. It can collect data locally from the HomeWizard Energy products and create them as sensors in Home Assistant.

Supported devices

  • Wi-Fi P1 Meter: Sensors for power import/export, energy consumption (single or three phases). information about your smart meter and gas. (Model: HWE-P1)
  • Wi-Fi Energy Socket: Sensors for power import/export and energy consumption and switches for controlling the outlet (model: HWE-SKT)
  • Wi-Fi Watermeter: Sensors for active and total water usage (model: HWE-WTR)
  • Wi-Fi kWh Meter: Sensors for power import/export and energy consumption. (Models: HWE-KWH1, HWE-KWH3, SDM230-wifi, and SDM630-wifi)

Note

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:

  1. Go to Settings. (Gear icon in the upper-right)
  2. Go to ‘Meters’.
  3. Select your device.
  4. Scroll down and turn on ‘Local API’.

Configuration

To add the HomeWizard Energy integration to your Home Assistant instance, use this My button:

HomeWizard Energy can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select HomeWizard Energy.

  • Follow the instructions on screen to complete the setup.

Sensors

Sensors for the P1 meter, Energy socket, and kWh meter:

  • 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.
  • 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.
  • Tariff: Current tariff that is used. Can be used to keep consumption as low as possible during peak hours.
  • Voltage (V): Active voltage that is measured on each phase.
  • Current (A): Active current that is measured on each phase.
  • 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 starting 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 Energy Socket and kWh meter:

  • Voltage (V): Active voltage that is measured on each phase.
  • Current (A): Active current that is measured on each phase.
  • Frequency (Hz): Net frequency.
  • Reactive power (VAR): Active reactive power measurement on each phase.
  • Apparent power (VA): Active apparent power measurement on each phase.

Sensors for Water meter:

  • Water usage (L/min): Flow of water that is measured at that time.
  • Total Water usage (m³): Total water usage since the installation of the HomeWizard Water meter.

Energy Socket

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.

Identify

The identify button can be pressed to let the status light blink for a few seconds. This feature not available for the kWh Meter.

Cloud communication

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.

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.