ioBroker.fronius
A Fronius inverter adapter for ioBroker
This is an ioBroker adapter for your Fronius PV inverter with Fronius Datalogger Web from version 2.0.4-1 onwards, Fronius Datamanager from version 3.0.3-1 onwards and Symo Gen24.
Installation
For installation no special setup is needed. Just install the Adapter and start the instance. Then go to the Adapter configuration. In the configuration section enter the IP Address or URL for your Inverter. Then you need to press the "check IP" button. This is needed to trigger a check and reading the system configuration. This system configuration is needed to control the API calls later on.
Note for upgrade from V1 to V2 of the adapter. Please refer to DatastructureMapping_V1.3-V2.0.pdf. It is recommended to check the above document carefully and delete the no longer available or moved states manually.
Request additional parameters
If you like to have an additional parameter or API call, then please provide in a ticket the call you have executed, a file with the JSON response to that call so this can be added to the System and also to the test environment. In any case please provide the system information from this call http://192.168.0.1/solar_api/v1/GetActiveDeviceInfo.cgi?DeviceClass=System so that the system setup is clear.
Report issues
If you find any issue, please report it on Github with the following information
- Adapter Version installed
- Detailled log (Log level Debug or Silly) of the current behaviour
- Detailled description about the issue
- If usefull the system information from http://192.168.0.1/solar_api/v1/GetActiveDeviceInfo.cgi?DeviceClass=System (Adjustment of the IP-Adress is needed)
Executed API calls
The following request are sent to the API. But the availlable datapoints strongly depends on the specific device on the Bus. Therefore if a datapoint is missing, please check first if the API delivers this information. The IP address and the DeviceId parameter must be adjusted to your own setup.
General system information
Inverter data
- http://192.168.0.1/solar_api/v1/GetInverterInfo.cgi
- http://192.168.0.1/solar_api/v1/GetInverterRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=3PInverterData
- http://192.168.0.1/solar_api/v1/GetInverterRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=CommonInverterData
- http://192.168.0.1/solar_api/v1/GetInverterRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=MinMaxInverterData
- http://192.168.0.1/solar_api/v1/GetArchiveData.cgi?Scope=System&StartDate=02.06.2023&EndDate=02.06.2023&Channel=Current_DC_String_1&Channel=Current_DC_String_2&Channel=Temperature_Powerstage&Channel=Voltage_DC_String_1&Channel=Voltage_DC_String_2
Ohmpilot data
Storage data
Smartmeter data
Sensorcard data
- http://192.168.0.1/solar_api/v1/GetSensorRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=NowSensorData
- http://192.168.0.1/solar_api/v1/GetSensorRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=MinMaxSensorData
String data
- http://192.168.0.1/solar_api/v1/GetStringRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=NowStringControlData
- http://192.168.0.1/solar_api/v1/GetStringRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=LastErrorStringControlData
- http://192.168.0.1/solar_api/v1/GetStringRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=CurrentSumStringControlData&TimePeriod=Day
- http://192.168.0.1/solar_api/v1/GetStringRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=CurrentSumStringControlData&TimePeriod=Year
- http://192.168.0.1/solar_api/v1/GetStringRealtimeData.cgi?Scope=Device&DeviceId=1&DataCollection=CurrentSumStringControlData&TimePeriod=Total
Powerflow data (Inverter/Site)
Site data
Changelog
2.0.2 (2023-06-28)
- (nkleber78) Instability issues fixed. (#306, #313)
- (nkleber78) Set values for parameters delivered as 'null' from API to 0. (#315)
2.0.1 (2023-06-04)
- (mcm1957) Deploy mechanism at github has been reactivated.
2.0.0 (2023-06-04)
- (nkleber78) Several errors resulting in missing data have been fixed. (#152, #242, #175)
- (nkleber78) Several errors due to missing objects have been solved. (#206, #129, #76)
- (nkleber78) The usage of the ping utility has been removed. (#169)
- (nkleber78) Reading of mpp values has been added. (#78)
- (nkleber78) 'Request' module has been replaced by 'axios'.
- (nkleber78) Fixed changes related to GEN24 API update for latest FW incl. object creation for storage objects
- (nkleber78) Fixed issue #97, Added some new predefined objects
- (nkleber78) Added Inverter Temperature readout (#86)
- (mcm1957) Dependencies and toolset have been updated.
1.1.3 (2021-03-15)
- (nkleber78) Split main.js into multiple files for better maintenance
- (nkleber78) Prevent creating info objects which are not supported by the inverters
- (schweigel) Added archive request values
- (schweigel) Added archive polling intervall
- (schweigel) Added devicetype string
1.1.1 (2020-11-30)
- (schweigel) Added missing units
- (schweigel) Added inverterinfo
1.1.0 (2020-11-24)
- (nkleber78) Implementation change for support of SYMO GEN24
- (nkleber78) Fix issue with adapters connected state
1.0.5 (2019-01-18)
- (ldittmar) compact mode compatibility added
- (ldittmar) add chinese support
1.0.4
- (ldittmar) Fix assignment to constant variable error
1.0.3
- (ldittmar) Ready for Admin 3
1.0.2
- (tobintax) Bugfix - Inverter Query regarding PAC adjusted.
1.0.1
- (tobintax) Added more values from Smartmeter
- (tobintax) Added more Powerflow Values
- (tobintax) Removed Value "EnergyReal_WAC_Minus_Relative" . This Value had no result and is undocumented in the fronius api documentation.
1.0.0
- (ldittmar) Fixed little errors
0.0.5
- (ldittmar) Read storage data and error/status codes
0.0.4
- (ldittmar) Read more data
0.0.3
- (ldittmar) Improved installation routine
0.0.2
- (ldittmar) First data is read
0.0.1
- (ldittmar) initial commit
License
The MIT License (MIT)
Copyright (c) 2023 ldittmar iobroker@lmdsoft.de
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.