Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iobroker-community-adapters/iobroker.fronius
ioBroker Adapter für Fronius Wechselrichter mit Fronius Datalogger Web ab Version 2.0.4-1 oder Fronius Datamanager ab Version 3.0.3-1
https://github.com/iobroker-community-adapters/iobroker.fronius
fronius fronius-datalogger-web fronius-datamanager home-automation iobroker iobroker-adapter smarthome
Last synced: 7 days ago
JSON representation
ioBroker Adapter für Fronius Wechselrichter mit Fronius Datalogger Web ab Version 2.0.4-1 oder Fronius Datamanager ab Version 3.0.3-1
- Host: GitHub
- URL: https://github.com/iobroker-community-adapters/iobroker.fronius
- Owner: iobroker-community-adapters
- License: mit
- Created: 2017-02-21T10:42:02.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-11-01T04:36:08.000Z (19 days ago)
- Last Synced: 2024-11-10T00:35:26.548Z (10 days ago)
- Topics: fronius, fronius-datalogger-web, fronius-datamanager, home-automation, iobroker, iobroker-adapter, smarthome
- Language: JavaScript
- Size: 1.83 MB
- Stars: 22
- Watchers: 8
- Forks: 21
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG_OLD.md
- License: LICENSE
Awesome Lists containing this project
README
# ioBroker.fronius
](https://github.com/iobroker-community-adapters/ioBroker.fronius/blob/main/LICENSE)
[](https://www.npmjs.com/package/iobroker.fronius)
[](https://weblate.iobroker.net/engage/adapters/?utm_source=widget)
**Version:**
[](https://www.npmjs.com/package/iobroker.fronius)
**Tests:**
[](https://github.com/iobroker-community-adapters/ioBroker.fronius/actions/workflows/test-and-release.yml)
[](https://github.com/iobroker-community-adapters/ioBroker.fronius/actions/workflows/codeql.yml)
## 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](doc/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](https://github.com/iobroker-community-adapters/ioBroker.fronius/issues) 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
- http://192.168.0.1/solar_api/v1/GetActiveDeviceInfo.cgi?DeviceClass=System
### 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
- http://192.168.0.1/solar_api/v1/GetOhmPilotRealtimeData.cgi?Scope=System
### Storage data
- http://192.168.0.1/solar_api/v1/GetStorageRealtimeData.cgi?Scope=Device&DeviceId=0
### Smartmeter data
- http://192.168.0.1/solar_api/v1/GetMeterRealtimeData.cgi?Scope=Device&DeviceId=0
### 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)
- http://192.168.0.1/solar_api/v1/GetPowerFlowRealtimeData.fcgi
### Site data
- http://192.168.0.1/solar_api/v1/GetLoggerInfo.cgi
## Changelog
### 2.1.1 (2024-07-24)
* (nkleber78) Better handling of empty objects [#374]
* (mcm1957) Some issues reported by adapter checker have been fixed.
* (mcm1957) Dependencies have been updated.
### 2.1.0 (2024-04-29)
* (mcm1957) Adapter requires node.js >= 18 and js-controller >= 5 now
* (mcm1957) Dependencies have been updated
### 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.
## License
The MIT License (MIT)
Copyright (c) 2023-2024 ioBroker Community Developers
Copyright (c) 2023 ldittmar
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.