This page is part of archived documentation for openHAB 4.0. Go to the current stable version

# 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, V3 and V3duo

Note: Not all channels are available for all Senec Home types. E.g.

  • only V3, V3duo have a power generator and thus MPPs (V3 has 2 MPP, V3duo has 3 MPP)
  • not equipped battery packs will return 0 for all ...Pack channels
  • currently channels for the first wallbox are implemented (senec could handle 4 wallboxes)

# 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)
currentMPP1 ampere PV generator current on MPP1
currentMPP2 ampere PV generator current on MPP2
currentMPP3 ampere PV generator current on MPP3
powerMPP1 watt PV generator power on MPP1
powerMPP2 watt PV generator power on MPP2
powerMPP3 watt PV generator power on MPP3
voltageMPP1 volt PV generator voltage on MPP1
voltageMPP2 volt PV generator voltage on MPP2
voltageMPP3 volt PV generator voltage on MPP3
houseConsumption watt Current power consumption of your house/living
energyProduction watt Energy generated by your pv / inverter
batteryPower watt Energy processed by battery negative discharge, positive charge
batteryCurrent ampere Battery current negative discharge, positive charge
batteryVoltage volt Battery Voltage
batteryFuelCharge percent Fuel charge of your battery (0 - 100%)
systemState Text describing current action of the senec home system (e.g. CHARGE)
systemStateValue Value describing current action of the senec home system (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
liveBatCharge kilo watt hour Live Total Bat Charge
liveBatDischarge kilo watt hour Live Total Bat Discharge
liveGridImport kilo watt hour Live Total Grid Import
liveGridExport kilo watt hour Live Total Grid Export
liveHouseConsumption kilo watt hour Live Total House Consumption (without WB)
livePowerGenerator kilo watt hour Live Total PV generator generated energy
liveEnergyWallbox1 kilo watt hour Live Total Wallbox 1 charged energy
chargedEnergyPack1 kilo watt hour total charged energy battery pack 1
chargedEnergyPack2 kilo watt hour total charged energy battery pack 2
chargedEnergyPack3 kilo watt hour total charged energy battery pack 3
chargedEnergyPack4 kilo watt hour total charged energy battery pack 4
dischargedEnergyPack1 kilo watt hour total discharged energy battery pack 1
dischargedEnergyPack2 kilo watt hour total discharged energy battery pack 2
dischargedEnergyPack3 kilo watt hour total discharged energy battery pack 3
dischargedEnergyPack4 kilo watt hour total discharged energy battery pack 4
cyclesPack1 battery charge/discharge cycles pack 1
cyclesPack2 battery charge/discharge cycles pack 2
cyclesPack3 battery charge/discharge cycles pack 3
cyclesPack4 battery charge/discharge cycles pack 4
currentPack1 ampere battery current pack 1
currentPack2 ampere battery current pack 2
currentPack3 ampere battery current pack 3
currentPack4 ampere battery current pack 4
voltagePack1 volt battery voltage pack 1
voltagePack2 volt battery voltage pack 2
voltagePack3 volt battery voltage pack 3
voltagePack4 volt battery voltage pack 4
maxCellVoltagePack1 volt maximum cell voltage battery pack 1
maxCellVoltagePack2 volt maximum cell voltage battery pack 2
maxCellVoltagePack3 volt maximum cell voltage battery pack 3
maxCellVoltagePack4 volt maximum cell voltage battery pack 4
minCellVoltagePack1 volt minimum cell voltage battery pack 1
minCellVoltagePack2 volt minimum cell voltage battery pack 2
minCellVoltagePack3 volt minimum cell voltage battery pack 3
minCellVoltagePack4 volt minimum cell voltage battery pack 4
batteryTemperature celsius battery temperature (maximum of all battery packs)
caseTemperature celsius case temperature
mcuTemperature celsius MCU (main control unit) temperature
wallbox1State Wallbox 1 state as Text (e.g. Charging)
wallbox1StateValue Wallbox 1 state as value (e.g. 194)
wallbox1ChargingCurrentPhase1 ampere Wallbox 1 charging current Phase 1
wallbox1ChargingCurrentPhase2 ampere Wallbox 1 charging current Phase 2
wallbox1ChargingCurrentPhase3 ampere Wallbox 1 charging current Phase 3
wallbox1ChargingPower watt Wallbox 1 charging power

# 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 SenecSystemState          "Current system state [%s]"                    <text> { channel="senechome:senechome:pvbattery:systemState" }
Number SenecSystemStateValue     "Current system state [%d]"                    <text> { channel="senechome:senechome:pvbattery:systemStateValue" }
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=SenecSystemState
        Default item=SenecSystemStateValue
        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
    }
}