From 30db4f8dc27b22d42b1a7f1530a0d6b7d197e33f Mon Sep 17 00:00:00 2001 From: Duco Sebel <74970928+DCSBL@users.noreply.github.com> Date: Tue, 11 Jan 2022 01:37:01 +0100 Subject: [PATCH] Add HomeWizard Energy documentation page (#20939) Co-authored-by: Paulus Schoutsen Co-authored-by: Klaas Schoute --- source/_integrations/homewizard.markdown | 54 ++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 source/_integrations/homewizard.markdown diff --git a/source/_integrations/homewizard.markdown b/source/_integrations/homewizard.markdown new file mode 100644 index 00000000000..bae3cbdf860 --- /dev/null +++ b/source/_integrations/homewizard.markdown @@ -0,0 +1,54 @@ +--- +title: HomeWizard Energy +description: Instructions on how to integrate HomeWizard Energy into Home Assistant. +ha_release: 2022.2 +ha_category: + - Energy +ha_iot_class: Local Polling +ha_config_flow: true +ha_domain: homewizard +ha_codeowners: + - '@DCSBL' +ha_platforms: + - sensor +ha_zeroconf: true +--- + +Integration for the [HomeWizard Energy](https://www.homewizard.nl/energy) platform. It can collect data locally from the HomeWizard Energy products and create them as sensors in Home Assistant. + +**Supported devices** + +- [Wifi P1 Meter](https://www.homewizard.nl/p1-meter): Depending on the connected DSMR meter: sensors for power import/export, energy consumption (single or three phases) and gas. (Model: `HWE-P1`) +- [Wifi Energy Socket](https://www.homewizard.nl/energy-socket): Sensors for power import/export and energy consumption. (model: `HWE-SKT`) +- [Wifi kWh Meter](https://www.homewizard.nl/kwh-meter): Sensors for power import/export and energy consumption. (Models: `SDM230-wifi`, `SDM630-wifi`) + +## 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'. + +{% include integrations/config_flow.md %} + +## Sensors + +The HomeWizard Energy API only exposes properties that are used within the HomeWizard Energy app. The available properties are listed below. + +| Name | Unit | Availability | Description | +| --- | --- | --- | --- | +| Wifi SSID | | HWE-P1, SDM230-wifi, SDM630-wifi, HWE-SKT | The SSID of the connected network. | +| Wifi Strength | % | HWE-P1, SDM230-wifi, SDM630-wifi, HWE-SKT | Percentage of the wifi connection. | +| Total Energy Import_t1 | kWh | HWE-P1, SDM230-wifi, SDM630-wifi, HWE-SKT | Energy import reading. | +| Total Energy Import_t2 | kWh | HWE-P1 | Energy import reading for other tariff. | +| Total Energy Export_t1 | kWh | HWE-P1, SDM230-wifi, SDM630-wifi, HWE-SKT | Energy export reading. | +| Total Energy Export_t2 | kWh | HWE-P1 | Energy export reading for other tariff. | +| Active Power | w | HWE-P1, SDM230-wifi, SDM630-wifi, HWE-SKT | Active power usage. | +| Active Power_l1 | w | HWE-P1, SDM230-wifi, SDM630-wifi, HWE-SKT | Active power usage Line 1, for `SDM230-wifi` and`HWE-SKT` this value is the same as `Active Power`. | +| Active Power_l2 | w | HWE-P1, SDM630-wifi | Active power usage Line 2. | +| Active Power_l3 | w | HWE-P1, SDM630-wifi | Active power usage Line 3. | +| Total Gas | m3 | HWE-P1 | Current gas import reading, only available when your smart meter is connected to a gas meter. | +| DSMR Version | | HWE-P1 | The detected DSMR version. | +| Smart Meter Model | | HWE-P1 | The detected smart meter model. |