From 49d2c61908eeb1640b1289452a9cdabec437e0b4 Mon Sep 17 00:00:00 2001 From: David Roberts Date: Tue, 18 Jun 2019 07:07:17 -0400 Subject: [PATCH] Solaredge local (#9490) * Add documentation for SolarEdge local component * bump release * Update source/_components/solaredge_local.markdown Co-Authored-By: Klaas Schoute * Update source/_components/solaredge_local.markdown Co-Authored-By: Klaas Schoute * remove redirect * remove monitored_conditions per https://github.com/home-assistant/architecture/pull/244 * :pencil2: Tweaks --- source/_components/solaredge_local.markdown | 74 +++++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 source/_components/solaredge_local.markdown diff --git a/source/_components/solaredge_local.markdown b/source/_components/solaredge_local.markdown new file mode 100644 index 00000000000..5187a313ee8 --- /dev/null +++ b/source/_components/solaredge_local.markdown @@ -0,0 +1,74 @@ +--- +layout: page +title: "SolarEdge Local Sensor" +description: "Instructions on how to integrate SolarEdge sensor within Home Assistant via Local API." +date: 2018-12-04 14:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: solaredge.png +ha_category: + - Sensor + - Energy +ha_release: 0.95 +ha_iot_class: Local Polling +--- + +The `solaredge_local` platform uses the local API available on some SolarEdge Inverters to allow you to get details from your SolarEdge solar power setup and integrate these into your Home Assistant installation. + +Only specific models support the local API. The local API is available on the SExxxxH-US models with SetApp as well as European three-phase inverters SEXXK-XXXTXBXX4 models with SetApp like SE3K-E10K, SE12.5K-SE27.6K and SE33.3K. Please check the datasheets carefully if in the section "Additional Features", sub-section "Inverter Commissioning" is present the following line "With the SetApp mobile application using built-in Wi-Fi access point for local connection". + +You can check by finding the IP address of your inverter and visiting it in a browser. If it supports the local API, you'll see the SolarEdge logo and a "Commissioning" menu. + +

+If your inveter does not support the local API, you can use the [cloud based version](/components/solaredge/) instead. +

+ +## {% linkable_title Configuration %} + +To use the SolarEdge sensors in your installation, add the following to your configuration.yaml file: + +```yaml +# Example configuration.yaml entry +sensor: + platform: solaredge_local + ip_address: IP_ADDRESS +``` + +{% configuration %} +ip_address: + description: The IP Address of your SolarEdge inverter. + required: true + type: string +name: + description: Let you overwrite the name of the device in the frontend. + required: false + default: SolarEdge + type: string +{% endconfiguration %} + +### {% linkable_title Full configuration sample %} + +A full configuration entry would look like the sample below. + +```yaml +# Example configuration.yaml entry +sensor: + - platform: solaredge_local + name: SolarEdge + ip_address: 192.168.1.123 +``` + +In case you would like to convert the values for example to kWh instead of the default Wh, you can use the [template platform](/components/sensor.template/). + +{% raw %} +```yaml +# Example configuration.yaml entry for template platform +sensors: + platform: template + sensors: + solaredge_energy_this_year_template: + value_template: '{{(states.sensor.solaredge_energy_this_year.state | float / 1000) | round(2)}}' +``` +{% endraw %}