Jump to content

Welcome to Smart Home Forum by FIBARO

Dear Guest,

 

as you can notice parts of Smart Home Forum by FIBARO is not available for you. You have to register in order to view all content and post in our community. Don't worry! Registration is a simple free process that requires minimal information for you to sign up. Become a part of of Smart Home Forum by FIBARO by creating an account.

 

As a member you can:

  •     Start new topics and reply to others
  •     Follow topics and users to get email updates
  •     Get your own profile page and make new friends
  •     Send personal messages
  •     ... and learn a lot about our system!

 

Regards,

Smart Home Forum by FIBARO Team


  • 0

QuickApp - SolarEdge Extra


SmartHomeEddy

Question

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" />

 

Download the QuickApp here (download the file and un-zip):

Please login or register to see this link.

or from the Fibaro Marketplace: 

Please login or register to see this link.

 

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

 

 

 

 

 

 

Edited by SmartHomeEddy
  • Like 2
Link to comment
Share on other sites

4 answers to this question

Recommended Posts

  • 0
  • Inquirer
  • 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 by SmartHomeEddy
    • Like 1
    Link to comment
    Share on other sites

    • 0

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

    Link to comment
    Share on other sites

    • 0
  • Inquirer
  • 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. 

     

    Link to comment
    Share on other sites

    Join the conversation

    You can post now and register later. If you have an account, sign in now to post with your account.

    Guest
    Answer this question...

    ×   Pasted as rich text.   Paste as plain text instead

      Only 75 emoji are allowed.

    ×   Your link has been automatically embedded.   Display as a link instead

    ×   Your previous content has been restored.   Clear editor

    ×   You cannot paste images directly. Upload or insert images from URL.

    ×
    ×
    • Create New...