# Senec Home Binding Binding to request status information from Senec Home Batteries to allow home automation decisions based on your current energy management. If your power feed is limited by regulations for example, you can switch on devices if a limited rate was applied by your Senec Home device. In addition you can switch off devices if the power consumption is getting higher. Examples: Lights, pool filters, wash machines, ... ## Supported Things | Thing type id | Name | |----------------------|-----------------------------------------------| | senechome | Senec Home Lithium Battery, V2.0, V2.1 and V3 | ## Thing Configuration demo.things ``` Thing senechome:senechome:pvbattery [ hostname="192.168.0.128", refreshInterval=60, limitationTresholdValue=70, limitationDuration=60 ] ``` If the thing goes online then the connection to the web interface is successful. In case it is offline you should see an error message. The refresh interval is 15 seconds by default, but you can optionally provide your own value adding the `refreshInterval` key. The property `limitationTresholdValue` is used as threshold for channel `powerLimitationState`. It is combined with property `limitationDuration` (seconds) to define a stable status for power limitation. Therefor use `powerLimitationState` to trigger Events (switches) based on your current power limitation. ## Channels | Channel | Type | Description | |-----------------------|-----------|--------------------------------------------------------------------------| | powerLimitation | percent | How much is your pv generator limited (0% if not limited anyway) | | powerLimitationState | ON/OFF | Power limitation active (based on configuration) | | houseConsumption | watt | Current power consumption of your house/living | | energyProduction | watt | Energy generated by your pv / inverter | | batteryPower | watt | Energy processed by batterie itself, for example while charging | | batteryFuelCharge | percent | Fuel charge of your battery (0 - 100%) | | batteryState | | Text describing current action of battery (e.g. CHARGE) | | batteryStateValue | | Value describing current action of battery (e.g. 14) | | gridPower | watt | Grid power level, negative for supply, positive values for drawing power | | gridPowerDraw | watt | Absolute power level of power draw, zero while supplying | | gridPowerSupply | watt | Absolute power level of power supply, zero while drawing | | gridPowerPhase1 | watt | Grid power level on Phase 1, negative for supply, positive for drawing | | gridPowerPhase2 | watt | Grid power level on Phase 2, negative for supply, positive for drawing | | gridPowerPhase3 | watt | Grid power level on Phase 3, negative for supply, positive for drawing | | gridCurrentPhase1 | ampere | Grid current on Phase 1, always a positive number | | gridCurrentPhase2 | ampere | Grid current on Phase 2, always a positive number | | gridCurrentPhase3 | ampere | Grid current on Phase 3, always a positive number | | gridVoltagePhase1 | volt | Grid voltage on Phase 1 | | gridVoltagePhase2 | volt | Grid voltage on Phase 2 | | gridVoltagePhase3 | volt | Grid voltage on Phase 3 | | gridFrequency | hertz | Grid frequency | | SenecBatteryVoltage | volt | Battery Voltage | | SenecLiveBatCharge | watt hour | Live Bat Charge | | SenecLiveBatDischarge | watt hour | Live Bat Discharge | | SenecLiveGridImport | watt hour | Live Grid Import | | SenecLiveGridExport | watt hour | Live Grid Export | ## Items Sample: ``` Number SenecPowerLimitation "pv generator limit [%d %%]" { channel="senechome:senechome:pvbattery:powerLimitation" } Switch SenecPowerLimitationState "Power limitation active" { channel="senechome:senechome:pvbattery:powerLimitationState" } Number SenecHouseConsumption "Current power consumption [%d W]" { channel="senechome:senechome:pvbattery:houseConsumption" } Number SenecEnergyProduction "Energy generated by pv [%d W]" { channel="senechome:senechome:pvbattery:energyProduction" } Number SenecBatteryPower "Energy processed by battery [%d W]" { channel="senechome:senechome:pvbattery:batteryPower" } Number SenecBatteryFuelCharge "State of Charge [%d %%]" { channel="senechome:senechome:pvbattery:batteryFuelCharge" } String SenecBatteryState "Current action [%s]" { channel="senechome:senechome:pvbattery:batteryState" } Number SenecBatteryStateValue "Current action [%d]" { channel="senechome:senechome:pvbattery:batteryStateValue" } Number SenecGridPower "Grid power level [%d W]" { channel="senechome:senechome:pvbattery:gridPower" } Number SenecGridPowerDraw "Power draw from grid [%d W]" { channel="senechome:senechome:pvbattery:gridPowerDraw" } Number SenecGridPowerSupply "Power supply to grid [%d W]" { channel="senechome:senechome:pvbattery:gridPowerSupply" } Number SenecGridPowerPh1 "Power draw from grid on Phase 1 [%d W]" { channel="senechome:senechome:pvbattery:gridPowerPhase1" } Number SenecGridPowerPh2 "Power draw from grid on Phase 2 [%d W]" { channel="senechome:senechome:pvbattery:gridPowerPhase2" } Number SenecGridPowerPh3 "Power draw from grid on Phase 3 [%d W]" { channel="senechome:senechome:pvbattery:gridPowerPhase3" } Number SenecGridCurrentPh1 "Current draw from grid on Phase 1 [%.2f A]" { channel="senechome:senechome:pvbattery:gridCurrentPhase1" } Number SenecGridCurrentPh2 "Current draw from grid on Phase 2 [%.2f A]" { channel="senechome:senechome:pvbattery:gridCurrentPhase2" } Number SenecGridCurrentPh3 "Current draw from grid on Phase 3 [%.2f A]" { channel="senechome:senechome:pvbattery:gridCurrentPhase3" } Number SenecGridVoltagePh1 "Voltage Level on Phase 1 [%d V]" { channel="senechome:senechome:pvbattery:gridVoltagePhase1" } Number SenecGridVoltagePh2 "Voltage Level on Phase 2 [%d V]" { channel="senechome:senechome:pvbattery:gridVoltagePhase2" } Number SenecGridVoltagePh3 "Voltage Level on Phase 3 [%d V]" { channel="senechome:senechome:pvbattery:gridVoltagePhase3" } Number SenecGridFrequency "Grid Frequency [%.2f Hz]" { channel="senechome:senechome:pvbattery:gridFrequency" } Number SenecBatteryVoltage "Battery Voltage [%.1f V]" { channel="senechome:senechome:pvbattery:batteryVoltage" } Number SenecLiveBatCharge "Live Bat Charge [%d kWh]" { channel="senechome:senechome:pvbattery:liveBatCharge" } Number SenecLiveBatDischarge "Live Bat Discharge [%d kWh]" { channel="senechome:senechome:pvbattery:liveBatDischarge" } Number SenecLiveGridImport "Live Grid Import [%d kWh]" { channel="senechome:senechome:pvbattery:liveGridImport" } Number SenecLiveGridExport "Live Grid Export [%d kWh]" { channel="senechome:senechome:pvbattery:liveGridExport" } ``` ## Sitemap Sample: ``` Text label="Power Grid"{ Frame label="Photovoltaik" { Default item=SenecPowerLimitation Default item=SenecPowerLimitationState Default item=SenecHouseConsumption Default item=SenecEnergyProduction Default item=SenecBatteryPower Default item=SenecBatteryFuelCharge Default item=SenecBatteryState Default item=SenecBatteryStateValue Default item=SenecGridPower Default item=SenecGridPowerDraw Default item=SenecGridPowerSupply Default item=SenecGridPowerPh1 Default item=SenecGridPowerPh2 Default item=SenecGridPowerPh3 Default item=SenecGridCurrentPh1 Default item=SenecGridCurrentPh2 Default item=SenecGridCurrentPh3 Default item=SenecGridVoltagePh1 Default item=SenecGridVoltagePh2 Default item=SenecGridVoltagePh3 Default item=SenecGridFrequency Default item=SenecBatteryVoltage Default item=SenecLiveBatCharge Default item=SenecLiveBatDischarge Default item=SenecLiveGridImport Default item=SenecLiveGridExport } } ```