Created At

Jun 28, 2023

Last Update

Jun 28, 2023

Platforms

HC 3 Lite, Z-box Hub, Yubii Home Pro, Yubii Home, Venture WISE, HC 3

Views

1255

Download

171

Type Quick App

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

  • Site Details: Displays the site details, such as name, location, status, etc.
  • Site Overview: Display the site overview data.
  • Inventory: Return the 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: Return the site power measurements in 15 minutes resolution.
  • Site Energy: Return the site energy measurements in 15 minutes resolution.
  • Site Environmental Benefits: Returns all environmental benefits based on site energy production: CO2 emissions saved, equivalent trees planted, and light bulbs powered for a day.

SolarEdge_Extra-1.thumb.png.5faa60cca0ff44c0104db7c5d79a39d9.png

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 https://www.solaredge.com/sites/default/files/se_monitoring_api.pdf 

 

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 like format 12345678-90 (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)

 

 How to install: 

  1. Open the Configuration Interface
  2. Go to Settings > Devices
  3. Click  +
  4. Choose Other Device
  5. Choose Upload File
  6. Choose file from your computer with .fqax

 

2 Comments,  Want to add comment please login
Fe8e102f850c34b0cdd1a221196f9aae

Hi, is this app compatible with HC2?

04801fd12b48c36cbcdf5af0b140e42d

No, this works only with HC3, HC3 Lite, Z-box Hub, Yubii Home or Venture WISE.

Load more comments
© 2024. Nice-Polska Sp. z o.o.Privacy policyTerms & ConditionsFeedback