The SolarEdge binding is used to get live data from from SolarEdge inverters via the central web api. This binding should in general be compatible with all inverter models that upload data to the solaredge portal.
Only read access is supported.
## Supported Things
This binding provides only one thing type: "generic" which is the inverter itself.
As the name suggests it is generic which means it applies to all available inverters.
Create one inverter thing per physical inverter installation available in your home(s).
Additional stuff like batteries is automatically supported.
Inverters which have a meter attached allow more detailed measuring.
Either a SolarEdge modbus meter or a S0 meter (export or consumption meter) can be used.
While on the one hand the S0 meter is the cheaper solution the solaredge meter on the other hand can be used as combined import+export meter and therefore allows even more detailed measurements.
- [Avoiding Feed-In limitations with consumption meters](https://www.solaredge.com/solutions/feed-in-limitation-and-metering-solution#)
- [Detailed description of meter setup](https://solaredge.com/sites/default/files/feed-in_limitation_application_note.pdf)
## Discovery
Auto-Discovery is not supported, as access requires authentication.
## Thing Configuration
The following configuration parameters are available for this thing:
- **tokenOrApiKey** (required)
Either the [official API Key](https://www.youtube.com/watch?v=iR26nmL5bXg) for using the public API or when using the inofficial private API: a token which can be retrieved from browser's cookie store when logged into the SolarEdge website.
It is called "SPRING_SECURITY_REMEMBER_ME_COOKIE".
When using this token, see also `usePrivateApi` and `meterInstalled`.
E.g. for Firefox, use the built-in [Storage Inspector](https://developer.mozilla.org/en-US/docs/Tools/Storage_Inspector) to retrieve the token.
Id of your inverter at SolarEdge (can be found in the URL after successful login: <https://monitoring.solaredge.com/solaredge-web/p/site/>**<solarId>** /#/dashboard)
| live#import | Number:Power | Current import from grid | requires meter attached and 'meterInstalled' set |
| live#export | Number:Power | Current export to grid | requires meter attached and 'meterInstalled' set |
| live#grid_status | String | Current grid status | requires meter attached and 'meterInstalled' set |
| aggregate_day#production | Number:Energy | Day Aggregate PV production | general available |
| aggregate_day#consumption | Number:Energy | Day Aggregate power consumption | requires meter attached and 'meterInstalled' set |
| aggregate_day#selfConsumptionForConsumption | Number:Energy | Day Aggregate self consumption (incl battery) | requires meter attached and 'meterInstalled' set |
| aggregate_day#selfConsumptionCoverage | Number:Dimensionless | Day Coverage of consumption by self production | requires meter attached and 'meterInstalled' set |
| aggregate_day#batterySelfConsumption | Number:Energy | Day Aggregate self consumption from battery | requires battery and private API activated |
| aggregate_day#import | Number:Energy | Day Aggregate import from grid | requires meter attached and 'meterInstalled' set |
| aggregate_day#export | Number:Energy | Day Aggregate export to grid | requires meter attached and 'meterInstalled' set |
| aggregate_week#production | Number:Energy | Week Aggregate PV production | requires meter attached and 'meterInstalled' set |
| aggregate_week#consumption | Number:Energy | Week Aggregate power consumption | requires meter attached and 'meterInstalled' set |
| aggregate_week#selfConsumptionForConsumption | Number:Energy | Week Aggregate self consumption (incl battery) | requires meter attached and 'meterInstalled' set |
| aggregate_week#selfConsumptionCoverage | Number:Dimensionless | Week Coverage of consumption by self production | requires meter attached and 'meterInstalled' set |
| aggregate_week#batterySelfConsumption | Number:Energy | Week Aggregate self consumption from battery | requires battery and private API activated |
| aggregate_week#import | Number:Energy | Week Aggregate import from grid | requires meter attached and 'meterInstalled' set |
| aggregate_week#export | Number:Energy | Week Aggregate export to grid | requires meter attached and 'meterInstalled' set |
| aggregate_month#production | Number:Energy | Month Aggregate PV production | general available |
| aggregate_month#consumption | Number:Energy | Month Aggregate power consumption | requires meter attached and 'meterInstalled' set |
| aggregate_month#selfConsumptionForConsumption | Number:Energy | Month Aggregate self consumption (incl battery) | requires meter attached and 'meterInstalled' set |
| aggregate_month#selfConsumptionCoverage | Number:Dimensionless | Month Coverage of consumption by self production | requires meter attached and 'meterInstalled' set |
| aggregate_month#batterySelfConsumption | Number:Energy | Month Aggregate self consumption from battery | requires battery and private API activated |
| aggregate_month#import | Number:Energy | Month Aggregate import from grid | requires meter attached and 'meterInstalled' set |
| aggregate_month#export | Number:Energy | Month Aggregate export to grid | requires meter attached and 'meterInstalled' set |
| aggregate_year#production | Number:Energy | Year Aggregate PV production | general available |
| aggregate_year#consumption | Number:Energy | Year Aggregate power consumption | requires meter attached and 'meterInstalled' set |
| aggregate_year#selfConsumptionForConsumption | Number:Energy | Year Aggregate self consumption (incl battery) | requires meter attached and 'meterInstalled' set |
| aggregate_year#selfConsumptionCoverage | Number:Dimensionless | Year Coverage of consumption by self production | requires meter attached and 'meterInstalled' set |
| aggregate_year#batterySelfConsumption | Number:Energy | Year Aggregate self consumption from battery | requires battery and private API activated |
| aggregate_year#import | Number:Energy | Year Aggregate import from grid | requires meter attached and 'meterInstalled' set |
| aggregate_year#export | Number:Energy | Year Aggregate export to grid | requires meter attached and 'meterInstalled' set |
