QuickApp - SolarEdge Extra

[SmartHomeEddy 884]

In the next version of

Please login or register to see this link.

 the functions of SolarEdge Extra will be integrated. 

 

This QuickApp gets extra information from your SolarEdge managed Solar Panels to give you the most insight of your SolarEdge installation. 

 

• Site Details: Site details, such as name, location, status, etc.
• Site Overview: Site overview data.
• Inventory: Inventory of SolarEdge equipment in the site, including inverters/SMIs, batteries, meters, gateways and sensors.
• Inverter Technical Data: Return specific inverter data for a given timeframe.
• Site Power: Site power measurements in 15 minutes resolution.
• Site Energy: Site energy measurements in 15 minutes resolution.
• Site Environmental Benefits: All environmental benefits based on site energy production: CO2 emissions saved, equivalent trees planted, and light bulbs powered for a day.

Use of the monitoring server API is subject to a query limit of 300 requests for a specific account token and a parallel query limit of 300 requests for each specific site ID from the same source IP. The monitoring server API allows up to 3 concurrent API calls from the same source IP. Any additional concurrent calls will return HTTP 429 error – too many requests.
See API documentation on

Please login or register to see this link.

 

Please login or register to see this attachment.

 

Site Details:

• id – the siteID
• name – the site name
• account id – the account this site belongs to
• status – the site status (see Site Status on page 53)
• peak power – site peak power
• currency - e.g. EUR
• installationDate – site installation date (format: yyyy-MM-DD hh:mm:ss )
• ptoDate – permission to operate date
• notes
• type – site type
• location:
  •   country
  •   state
  •   city
  •   address
  •   secondary address
  •   zip
  •   time zone
• alertQuantity - number of open alerts in this site *
• alertSeverity – the highest alert severity in this site *
• publicSettings:
•   isPublic - if this site is public (true or false)
•   public name - name

* _{Alert information is only available when using an API_KEY generated by an account. API_KEY generated at the site level does not return this information.}

 

Inventory:

• Inverter 
  •   name – the inverter name e.g. Inverter 1
  •   manufacturer – manufacturer name (SolarEdge)
  •   model name e.g. SE16K
  •   Firmware version e.g. 2.52.311
  •   communicationMethod – the communication interface used to connect to server. e.g.: Ethernet or WIFI.
  •   serialNumber – the equipment serial number e.g.: 7F123456-00
  •   connectedOptimizers – number of optimizers connected to the inverter
• Meters
  •   name – the inverter name e.g. “FeedInMeter”
  •   Manufacturer – e.g. “WattNode”
  •   Model – meter model number
  •   SN – serial number (if applicable)
  •   Type – metertype, e.g. “Production”
  •   Firmware Version (if applicable)
  •   Connected To – Name of SolarEdge device the meter is connected to
  •   connectedSolaredgeDeviceSN – serial number of the inverter/gateway the meter is connected to
  •   form – physical for a HW meter or virtual if calculated by arithmetic between other meters
• Sensors (Irradiance/wind/temperature sensors)
  •   connectedSolaredgeDeviceSN – the S/N of the device it is connected to e.g. 12345678-00
  •   Id – e.g. “SensorDirectIrradiance”
  •   connectedTo – name of the device it is connected to e.g. “Gateway 1”
  •   Category – e.g.IRRADIANCE
  •   Type – e.g. “Plane of array irradiance”
• Gateways
  •   name – the inverter name e.g. Inverter 1
  •   serialNumber – the equipment serialnumber e.g. 7F123456-00
  •   Firmwareversion
• Batteries
  •   Name
  •   SerialNumber
  •   Manufacturer - the battery manufacturer name
  •   Model - the battery model name
  •   Nameplate capacity - the nameplate capacity of the battery as provided by the manufacturer
  •   Firmwareversion
  •   ConnectedTo – Name of SolarEdge device the battery is connected to
  •   connectedSolaredgeDeviceSN – serial number of the inverter/gateway the battery is connected to

 

Interver Technical data:

• timestamp 
• AC current (divided per phase)
• AC voltage (divided per phase)
• AC frequency (divided per phase) 
• QRef (divided per phase)
• CosPhi (divided per phase)
• TotalActivePower 
• apparentPower - Supported starting communication board version 2.474
• activePower - Supported starting communication board version 2.474
• reactivePower
• DC voltage 
• groundFaultResistance 
• powerLimit %
• Lifetime energy - Supported starting communication board version 2.474
• totalEnergy 
• temperature - Celsius
• inverterMode 
  •   SLEEPING – night mode
  •   STARTING – pre-production
  •   MPPT – production
  •   THROTTLED – Forced power reduction
  •   SHUTTING_DOWN – Shutdown procedure
  •   FAULT – error mode
  •   STANDBY – maintenance
  •   LOCKED_STDBY – standby mode lock
  •   LOCKED_FIRE_FIGHTERS – firefighters lock mode
  •   LOCKED_FORCE_SHUTDOWN – forced shutdown from server
  •   LOCKED_COMM_TIMEOUT – communication timeout
  •   LOCKED_INV_TRIP – inverter self-lock trip
  •   LOCKED_INV_ARC_DETECTED – inverter self-lock on arc detection
  •   LOCKED_DG – inverter lock due to DG mode enable
  •   LOCKED_PHASE_BALANCER – inverter lock due to phase imbalance (1ph, Australia only) 
  •   LOCKED_PRE_COMMISSIONING – inverter lock due to pre-commissioning
  •   LOCKED_INTERNAL – inverter lock due to an undisclosed internal reason
• operationMode
  •   0 – On-grid
  •   1 – Operating in off-grid mode using PV or battery
  •   2 - Operating in off-grid mode with generator (e.g. diesel) is present
• apparentPower - VA (divided per phase) 
• activePower - VA (divided per phase) 
• reactivePower - VAR (divided per phase) 
• cosPhi (divided per phase) 
• vL1ToN - 1ph only 
• vL2ToN - 1ph only 
• vL1To2 - 3ph only
• vL2To3 - 3ph only
• vL3To1 - 3ph only

 

Environmental Benefits:

• CO2 - quantity of CO2 emissions that would have been generated by an equivalent fossil fuel system
• SO2 - quantity of SO2 emissions that would have been generated by an equivalent fossil fuel system
• NOX - quantity of NOX emissions that would have been generated by an equivalent fossil fuel system
• treesPlanted - equivalent planting of new trees for reducing CO2 levels
• lightBulbs - number of light bulbs that could have been powered by the site for a day

 

Site Power Detailed:

• timeUnit - the time unit (QUARTER_OF_AN_HOUR)
• unit - the measurement units (e.g. Watt)
• type - i.e. Production, Consumption, SelfConsumption, FeedIn (export) or Purchased (import)
• date - date and time
• value - power in Watt at that time of the day

 

Site Energy Detailed:

• timeUnit - the time unit (QUARTER_OF_AN_HOUR)
• unit - the measurement units (e.g. Wh)
• type - i.e. Production, Consumption, SelfConsumption, FeedIn (export) or Purchased (import)
• date - date and time
• value - power in Wh at that time of the day

 

Overview:

• id
• currentPower
• lastDayData energy
• lastDayData revenue
• lastMonthData energy
• lastMonthData revenue
• lastYearData energy
• lastYearData revenue
• lifeTimeData energy
• lifeTimeData revenue
• lastUpdateTime

 

Changes version 0.1 (25th June 2023)
- First (development) version

Variables (mandatory and created automatically): 

- siteID = Site ID of your SolarEdge Inverter (see your Inverter Site Details)

- apiKey = API key of your SolarEdge Inverter (contact your installer if you don't have one)

- serialNumber = Short serialNumer of your SolarEdge Inverter (see your Inverter Inventory Details)

- language = Preferred language (default = English (en)) 

- debugLevel = Number (1=some, 2=few, 3=all, 4=simulation mode) (default = 1)

 

Please login or register to see this image.

/monthly_2023_06/SolarEdge_Extra_Icon.png.246dfdb0bad710b549184b7fee120966.png" />

 

 

Edited July 13, 2024 by SmartHomeEddy

[SmartHomeEddy 884]

Working on a new QuickApp to get all kind of information from your SolarEdge Inverter. Looks promising. 

 

Within the limitations of the SolarEdge Cloud, 300 requests a day, this QuickApp will get, with a push of a button, all kind of information from the SolarEdge Cloud, like:

• Site Details: Site details, such as name, location, status, etc.
• Site Overview: Site overview data.
• Inventory: Inventory of SolarEdge equipment in the site, including inverters/SMIs, batteries, meters, gateways and sensors.
• Inverter Technical Data: Return specific inverter data for a given timeframe.
• Site Power: Site power measurements in 15 minutes resolution.
• Site Energy: Site energy measurements in 15 minutes resolution.
• Site Environmental Benefits: All environmental benefits based on site energy production: CO2 emissions saved, equivalent trees planted, and light bulbs powered for a day.

 

 

 

Edited June 25, 2023 by SmartHomeEddy

[SmartHomeEddy 884]

Available for download 🎁

[Kage 37]

Nice my inverter was broken and only they can see it as the say! 

[SmartHomeEddy 884]

Hi @Kage

Installers can see a bit more, like alerts. With the information from the QuickApp we can see a lot. Maybe nice to write about one of the values in this post. 

 

Like cosPhi:

Cosinus Phi indicates how much power is lost while 'transporting' power. The ratio of real ability to apparent ability is Cos Phi. The higher the Cosine Phi is, the more efficiently devices are used. Usually it is between 0.6 and 0.9. So this means that 60-90% of the power is used effectively. I have a CosPhi of 1. 

 

[SmartHomeEddy 884]

In the next version of 

Please login or register to see this link.

 the functions of SolarEdge Extra will be integrated, with more function like storage data and meters information. This QuickApp will be discontinued. 
 

Please login or register to see this attachment.

[SmartHomeEddy 884]

And the new 

Please login or register to see this link.

 quickapp is available !