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 %%]"                <heating> { channel="senechome:senechome:pvbattery:powerLimitation" }
Switch SenecPowerLimitationState "Power limitation active"                    <switch> { channel="senechome:senechome:pvbattery:powerLimitationState" }
Number SenecHouseConsumption     "Current power consumption [%d W]"           <energy> { channel="senechome:senechome:pvbattery:houseConsumption" }
Number SenecEnergyProduction     "Energy generated by pv [%d W]"              <energy> { channel="senechome:senechome:pvbattery:energyProduction" }
Number SenecBatteryPower         "Energy processed by battery [%d W]"         <energy> { channel="senechome:senechome:pvbattery:batteryPower" }
Number SenecBatteryFuelCharge    "State of Charge [%d %%]"              <batterylevel> { channel="senechome:senechome:pvbattery:batteryFuelCharge" }
String SenecBatteryState         "Current action [%s]"                          <text> { channel="senechome:senechome:pvbattery:batteryState" }
Number SenecBatteryStateValue    "Current action [%d]"                          <text> { channel="senechome:senechome:pvbattery:batteryStateValue" }
Number SenecGridPower            "Grid power level [%d W]"                    <energy> { channel="senechome:senechome:pvbattery:gridPower" }
Number SenecGridPowerDraw        "Power draw from grid [%d W]"                <energy> { channel="senechome:senechome:pvbattery:gridPowerDraw" }
Number SenecGridPowerSupply      "Power supply to grid [%d W]"                <energy> { channel="senechome:senechome:pvbattery:gridPowerSupply" }
Number SenecGridPowerPh1         "Power draw from grid on Phase 1 [%d W]"     <energy> { channel="senechome:senechome:pvbattery:gridPowerPhase1" }
Number SenecGridPowerPh2         "Power draw from grid on Phase 2 [%d W]"     <energy> { channel="senechome:senechome:pvbattery:gridPowerPhase2" }
Number SenecGridPowerPh3         "Power draw from grid on Phase 3 [%d W]"     <energy> { channel="senechome:senechome:pvbattery:gridPowerPhase3" }
Number SenecGridCurrentPh1       "Current draw from grid on Phase 1 [%.2f A]" <energy> { channel="senechome:senechome:pvbattery:gridCurrentPhase1" }
Number SenecGridCurrentPh2       "Current draw from grid on Phase 2 [%.2f A]" <energy> { channel="senechome:senechome:pvbattery:gridCurrentPhase2" }
Number SenecGridCurrentPh3       "Current draw from grid on Phase 3 [%.2f A]" <energy> { channel="senechome:senechome:pvbattery:gridCurrentPhase3" }
Number SenecGridVoltagePh1       "Voltage Level on Phase 1 [%d V]"            <energy> { channel="senechome:senechome:pvbattery:gridVoltagePhase1" }
Number SenecGridVoltagePh2       "Voltage Level on Phase 2 [%d V]"            <energy> { channel="senechome:senechome:pvbattery:gridVoltagePhase2" }
Number SenecGridVoltagePh3       "Voltage Level on Phase 3 [%d V]"            <energy> { channel="senechome:senechome:pvbattery:gridVoltagePhase3" }
Number SenecGridFrequency        "Grid Frequency [%.2f Hz]"                   <energy> { channel="senechome:senechome:pvbattery:gridFrequency" }
Number SenecBatteryVoltage       "Battery Voltage [%.1f V]"                   <energy> { channel="senechome:senechome:pvbattery:batteryVoltage" }
Number SenecLiveBatCharge        "Live Bat Charge [%d kWh]"                   <energy> { channel="senechome:senechome:pvbattery:liveBatCharge" }
Number SenecLiveBatDischarge     "Live Bat Discharge [%d kWh]"                <energy> { channel="senechome:senechome:pvbattery:liveBatDischarge" }
Number SenecLiveGridImport       "Live Grid Import [%d kWh]"                  <energy> { channel="senechome:senechome:pvbattery:liveGridImport" }
Number SenecLiveGridExport       "Live Grid Export [%d kWh]"                  <energy> { 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
    }
}

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)