Add documentation on how to use IoTaWatt with energy management (#19155)

* Add documentation on how to use IoTaWatt with energy management

* Update source/_integrations/iotawatt.markdown

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>
This commit is contained in:
Paulus Schoutsen 2021-09-01 11:15:55 -07:00 committed by GitHub
parent 604763df5d
commit bacf0172f8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -12,8 +12,41 @@ ha_codeowners:
ha_platforms: ha_platforms:
- sensor - 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 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. and create them as sensors in Home Assistant.
{% include integrations/config_flow.md %} {% 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
```