mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-11 15:42:10 +01:00
51 lines
3.4 KiB
Markdown
51 lines
3.4 KiB
Markdown
|
# Solar-Log Binding
|
||
|
|
|
||
|
|
The [Solar-Log Family](https://www.solar-log.com/en/) of monitoring devices for PV installations provide a MODBUS (TCP) and JSON-based API to access a number of internal data related to power generation and consumption. This binding implements access to the data via the JSON API.
|
||
|
|
|
||
|
|
## Use of the binding
|
||
|
|
|
||
|
|
The Solar-Log is exposed as one thing with a number of channels that can be used to read the values for different aspects of your Solar-Log installation.
|
||
|
|
|
||
|
|
## Setup of the binding
|
||
|
|
|
||
|
|
You can either configure the Thing via the openHAB UI or via a `*.things` file, according to the following example:
|
||
|
|
|
||
|
|
`Thing solarlog:meter:pv "Solar-Log 300" @ "Utility Room" [ url="http://solar-log", refreshInterval=15]`
|
||
|
|
|
||
|
|
The parameters to be used are simple:
|
||
|
|
|
||
|
|
* `url` denotes the URL of your Solar-Log. If you have not changed anything, this defaults to `http://solar-log`.
|
||
|
|
* `refreshInterval` is the interval to fetch new data. Solar-Log updates its data every 15 - 60 seconds. `15` is the default value. Values lower than this will return the result from the last 15 seconds period. No value lower than this can be set in the UI.
|
||
|
|
|
||
|
|
Currently, the binding does not support authenticated access to the Solar-Log JSON API (which was introduced with newer firmwares). If must set the API access to `Open` in the Solar-Log configuration in order for the binding to work.
|
||
|
|
|
||
|
|
## Available channels
|
||
|
|
|
||
|
|
The following table is taken from the official manual and contains all available channels. If you want to manually define Items, this can for example be done as follows:
|
||
|
|
|
||
|
|
`Number solarlog_meter_pv_yieldday "Yield Day [% W]" (gSolarLog, gUtilityRoom) { channel="solarlog:meter:pv:yieldday" }`
|
||
|
|
|
||
|
|
Data point | Unit | Index Description
|
||
|
|
------------------- | --------------------- | -----------------
|
||
|
|
lastupdate | Time in the format dd.mm.yy; hh.minmin, secsec | 100 Time
|
||
|
|
pac | W | 101 Total output PAC from all of the inverters and meters in inverter mode
|
||
|
|
pdc | W | 102 Total output PAC from all of the inverters
|
||
|
|
uac | V | 103 Average voltage UAC from the inverter
|
||
|
|
udc | V | 104 Average voltage UDC from the inverter
|
||
|
|
yieldday | Wh | 105 Total yield for the day from all of the inverters
|
||
|
|
yieldyesterday | Wh | 106 Total yield for the previous day from all of the inverters
|
||
|
|
yieldmonth | Wh | 107 Total yield for the month from all of the inverters
|
||
|
|
yieldyear | Wh | 108 Total yield for the year from all of the inverters
|
||
|
|
yieldtotal | Wh | 109 Total yield from all of the inverters
|
||
|
|
conspac | W | 110 Current total consumption PAC from all of the consumption meters
|
||
|
|
consyieldday | Wh | 111 Total consumption from all of the consumption meters
|
||
|
|
consyieldyesterday | Wh | 112 Total consumption for the previous day; all of the consumption meters
|
||
|
|
consyieldmonth | Wh | 113 Total consumption for the month; all of the consumption meters
|
||
|
|
consyieldyear | Wh | 114 Total consumption for the year; all of the consumption meters
|
||
|
|
consyieldtotal | Wh | 115 Accumulated total consumption, all Consumption meter
|
||
|
|
totalpower | Wp | 116 Installed generator power
|
||
|
|
|
||
|
|
## More information
|
||
|
|
|
||
|
|
More information about the Solar-Log Data interfaces and the exact meaning of the various channels and the documentation of the JSON API can be found in the [Manual](https://www.solar-log.com/manuals/manuals/en_GB/SolarLog_Manual_3x_EN.pdf).
|