From bacf0172f8c4ace6de285e782e40874a2cf0156d Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Wed, 1 Sep 2021 11:15:55 -0700 Subject: [PATCH] Add documentation on how to use IoTaWatt with energy management (#19155) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add documentation on how to use IoTaWatt with energy management * Update source/_integrations/iotawatt.markdown Co-authored-by: Joakim Sørensen Co-authored-by: Joakim Sørensen --- source/_integrations/iotawatt.markdown | 35 +++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/source/_integrations/iotawatt.markdown b/source/_integrations/iotawatt.markdown index bbf2dda38cc..ab665f08ab1 100644 --- a/source/_integrations/iotawatt.markdown +++ b/source/_integrations/iotawatt.markdown @@ -12,8 +12,41 @@ ha_codeowners: ha_platforms: - sensor --- -A sensor platform for the [IoTaWatt](https://www.iotawatt.com/) Open WiFi Electricity Monitor. It +Integration for the [IoTaWatt](https://www.iotawatt.com/) Open WiFi Electricity Monitor. It will collect data from the Current Transformer Clamps (Input CTs) and any Outputs that are defined on the IoTaWatt and create them as sensors in Home Assistant. {% include integrations/config_flow.md %} + +## Energy management + +IoTaWatt does not provide the exact data that is needed for energy management. We're working with the IotaWatt team on resolving this. + +Until then, you can use these instructions to create the correct entities that work with energy management: + +### Configure IoTaWatt + +You will need to configure two new IoTaWatt output sensors: + +| Name | Unit | Formula +| - | - | - +| MainsConsumption|Watts|`(Main_In_Red + Main_In_White + Main_In_Blue) max 0` +| MainsExport|Watts|`((Main_In_Red + Main_In_White + Main_In_Blue) min 0) abs` + +Replace `(Main_In_Red + Main_In_White + Main_In_Blue)` with the correct formula for your main feed. + +### Configure Home Assistant + +Add the following to your configuration.yaml file to convert the Watt measurements into kWh: + +```yaml +sensor iotawatt: + - platform: integration + source: sensor.mainsexport + name: Total Grid Export + unit_prefix: k + - platform: integration + source: sensor.mainsconsumption + name: Total Grid Consumption + unit_prefix: k +```