3.0 KiB
| layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release | ha_iot_class |
|---|---|---|---|---|---|---|---|---|---|---|---|
| page | SolarEdge Sensor | Instructions on how to integrate SolarEdge sensor within Home Assistant. | 2018-12-04 14:00 | true | false | true | true | solaredge.png | Sensor | 0.85 | Cloud Polling |
The solaredge platform uses the SolarEdge Monitoring API to allow you to get details from your SolarEdge solar power setup and integrate these in your Home Assistant installation.
The SolarEdge Monitoring API has a daily rate limit of 300 requests. In order to stay under this limit, and alow for some additional requests, the `solaredge` platform will update the site overview every 10 minutes.
{% linkable_title Configuration %}
To use the SolarEdge sensors in your installation, add the following to your configuration.yaml file:
{% raw %}
# Example configuration.yaml entry
sensor:
- platform: solaredge
api_key: API_KEY
site_id: SITE_ID
monitored_conditions:
- current_power
- energy_today
{% endraw %}
{% configuration %} api_key: description: Your SolarEdge Site API key. required: true type: string site_id: description: The id of your SolarEdge Site. required: true type: string name: description: Let you overwrite the name of the device in the frontend. required: false default: SolarEdge type: string monitored_conditions: description: SolarEdge Site information to be monitored. The following conditions can be monitored. required: false type: list default: current_power keys: lifetime_energy: description: Lifetime energy generated at your SolarEdge Site in Wh energy_this_year: description: Energy generated this year at your SolarEdge Site in Wh energy_this_month: description: Energy generated this month at your SolarEdge Site in Wh energy_today: description: Energy generated today at your SolarEdge Site in Wh current_power: description: Current generated power in W {% endconfiguration %}
If no monitored_conditions are specified, only current_power will be enabled.
{% linkable_title Full configuration sample %}
A full configuration entry would look like the sample below.
{% raw %}
# Example configuration.yaml entry
sensor:
- platform: solaredge
api_key: API_KEY
site_id: SITE_ID
name: SolarEdge
monitored_conditions:
- current_power
- energy_today
- energy_this_month
- energy_this_year
- lifetime_energy
{% endraw %}
In case you would like to convert the values for example to kWh instead of the default Wh, you can use the template platform.
{% raw %}
# 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 %}