SolarEdge Sensor


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.

Configuration

To use the SolarEdge sensors in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: solaredge
    api_key: API_KEY
    site_id: SITE_ID

Configuration Variables

api_key

(string)(Required)

Your SolarEdge Site API key.

site_id

(string)(Required)

The id of your SolarEdge Site.

name

(string)(Optional)

Let you overwrite the name of the device in the frontend.

Default value:

SolarEdge

monitored_conditions

(list)(Optional)

SolarEdge Site information to be monitored. The following conditions can be monitored.

Default value:

current_power

lifetime_energy

Lifetime energy generated at your SolarEdge Site in Wh

energy_this_year

Energy generated this year at your SolarEdge Site in Wh

energy_this_month

Energy generated this month at your SolarEdge Site in Wh

energy_today

Energy generated today at your SolarEdge Site in Wh

current_power

Current generated power in W

site_details

Site details such as name, location, status, etc.

meters

Site equipment details of connected meters. The sensor value shows the number of meters. Each meter is available as an attribute

sensors

Site equipment details of connected sensors. The sensor value shows the number of sensors. Each sensor is available as an attribute

gateways

Site equipment details of connected gateways. The sensor value shows the number of gateways. Each gateway is available as an attribute

batteries

Site equipment details of connected batteries. The sensor value shows the number of batteries. Each battery is available as an attribute

inverters

Site equiment details of connected inverters. The sensor values shows the number of inverters. Each inverter is available as an attribute

power_consumption

Show the current power consumption of your SolarEdge Site (additional hardware required)

solar_power

Show the current power production of your SolarEdge Site (additional hardware required)

grid_power

Show the current power flow from/to the power grid. State will be either positive of negative indicating importing or exporting electricity (additional hardware required)

storage_power

Show the current power flow from/to your site storage. State will be either positive of negative indicating discharging or charging (additional hardware required)

If no monitored_conditions are specified, only current_power will be enabled.

Full configuration sample

A full configuration entry would look like the sample below.

# 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
      - site_details
      - meters
      - sensors
      - gateways
      - batteries
      - inverters
      - power_consumption
      - solar_power
      - grid_power
      - storage_power

In case you would like to convert the values for example to kWh instead of the default Wh, you can use the template platform.

# Example configuration.yaml entry for template platform
sensors:
  platform: template
  sensors:
    solaredge_energy_this_year_template:
      value_template: "{{ (states('sensor.solaredge_energy_this_year') | float / 1000) | round(2) }}"