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

# Kostal Inverter Binding

Scrapes the web interface of the inverter for the metrics of the supported channels below.

Kostal Pico

Kostal Piko 10-20

Kostal PLENTICORE / PIKI IQ

# Supported Things

# First generation devices (PIKO)

Tested with Kostal Inverter PIKO but might work with other inverters from Kostal too.

# Second generation devices (PIKO 10-20, PIKO NEW GENERATION)

Tested with Kostal Inverter PIKO 10-20, PIKO NEW GENERATION.

# Third generation devices (PIKO IQ / PLENTICORE plus)

This implementation was tested for the current KOSTAL PIKO PLENTICORE plus and PIKO IQ devices. All of these devices contain the same communication board (SCB = SmartConnectionBoard)

Currently supported things are:

  • PIKO IQ 4.2
  • PIKO IQ 5.5
  • PIKO IQ 7.0
  • PIKO IQ 8.5
  • PIKO IQ 10.0
  • PLENTICORE plus 4.2 (with or without battery attached)
  • PLENTICORE plus 5.5 (with or without battery attached)
  • PLENTICORE plus 7.0 (with or without battery attached)
  • PLENTICORE plus 8.5 (with or without battery attached)
  • PLENTICORE plus 10.0 (with or without battery attached)

Others may be supported (like future devices using the same SCB or offering the same Web API, branded OEM devices, ...), but they were not tested!

Kostal bindings to third generation devices require Java's strong cryptography to be enabled in order to establish connections. In case you are allowed to use strong cryptography in your country, you can achieve this by modifying the $JAVA_HOME/jre/lib/security/java.security file (find the line crypto.policy=limited and set it to unlimited). If you're using the official openHAB docker image you may also enable Java's strong cryptography by specifying an environment variable CRYPTO_POLICY="unlimited".

# Discovery

None

# Channels

# First generation devices (PIKO)

  • acPower
  • totalEnergy
  • dayEnergy
  • status
  • str1Voltage
  • str1Current
  • str2Voltage
  • str2Current
  • l1Voltage
  • l1Power
  • l2Voltage
  • l2Power
  • l3Voltage
  • l3Power

# Second generation devices (PIKO 10-20, PIKO NEW GENERATION)

Channel Type ID Item Type Description Read Write
device-local-grid-output-power Number:Power Current output power to the grid R
statistic-yield-day-second-gen Number:Energy Total produced power today R
statistic-yield-total-second-gen Number:Energy Total produced power R
device-local-operating-status Number:Dimensionless Current operating status, 0 = Standby, 3 = WO-IDLE R
device-local-grid-voltage-l1 Number:ElectricPotential Current output voltage to the grid, L1 R
device-local-grid-current-l1 Number:ElectricCurrent Current output current to the grid, L1 R
device-local-grid-power-l1 Number:Power Current output power to the grid, L1 R
device-local-grid-voltage-l2 Number:ElectricPotential Current output voltage to the grid, L2 R
device-local-grid-current-l2 Number:ElectricCurrent Current output current to the grid, L2 R
device-local-grid-power-l2 Number:Power Current output power to the grid, L2 R
device-local-grid-voltage-l3 Number:ElectricPotential Current output voltage to the grid, L3 R
device-local-grid-current-l3 Number:ElectricCurrent Current output current to the grid, L3 R
device-local-grid-power-l3 Number:Power Current output power to the grid, L3 R
device-local-dc-power-pv Number:Power Current power from all solar panels R
device-local-dc1-voltage Number:ElectricPotential Current voltage from solar panels, Dc1 R
device-local-dc1-current Number:ElectricCurrent Current current from solar panels, Dc1 R
device-local-dc1-power Number:Power Current power from solar panels, Dc1 R
device-local-dc2-voltage Number:ElectricPotential Current voltage from solar panels, Dc2 R
device-local-dc2-current Number:ElectricCurrent Current current from solar panels, Dc2 R
device-local-dc2-power Number:Power Current power from solar panels, Dc2 R
device-local-dc3-voltage Number:ElectricPotential Current voltage from solar panels, Dc3 R
device-local-dc3-current Number:ElectricCurrent Current current from solar panels, Dc3 R
device-local-dc3-power Number:Power Current power from solar panels, Dc3 R
device-local-akt-home-consumption-solar Number:Power Current consumption from solar panels R
device-local-akt-home-consumption-bat Number:Power Current consumption from battery R
device-local-akt-home-consumption-grid Number:Power Current consumption from grid R
device-local-phase-sel-home-consump-l1 Number:Power Current home consumption, L1 R
device-local-phase-sel-home-consump-l2 Number:Power Current home consumption, L2 R
device-local-phase-sel-home-consump-l3 Number:Power Current home consumption, L3 R
device-local-grid-freq Number:Frequency Current frequency on grid R
device-local-grid-cos-phi Number:Angle Current power factor on grid R
statistic-home-consumption-day Number:Energy Total home consumption today R
statistic-own-consumption-day Number:Energy Total own consumption today R
statistic-own-cons-rate-day Number:Dimensionless Total own consumption rate today R
statistic-autonomy-degree-day Number:Dimensionless Total autonomy degree today R
statistic-home-consumption-total Number:Energy Total home consumption R
statistic-own-consumption-total Number:Energy Total own consumption R
statistic-operating-time-total Number:Time Total operating time R
device-local-current Number:ElectricCurrent Current R
device-local-current-dir Number:Dimensionless Current direction of loading/unloading the battery R
device-local-charge-cycles Number:Dimensionless Total number of charge cycles R
device-local-battery-temperature Number:Temperature Battery current temperature R
device-local-loginterval Number:Time Value for loginterval R
device-local-s0-inpulse-cnt Number:Dimensionless S0-pulse counter R
statistic-own-cons-rate-total Number:Dimensionless Total own comsumption rate R
statistic-autonomy-degree-total Number:Dimensionless Total autonomy degree R
device-local-battery-voltage Number:ElectricPotential Battery current voltage R
device-local-bat-state-of-charge Number:Dimensionless Battery current charge state R
device-local-self-consumption Number:Power Current self consumption R
device-local-battery-usage-consumption Number:Power Battery usage consumption R
device-local-smart-battery-control Switch Smart battery control R
device-local-shadow-management Number:Dimensionless Shadow management R
device-local-external-module-control Number:Dimensionless External module control R

The following Channels are writeable

Channel Type ID Item Type Description Read Write
device-local-battery-usage-consumption-set String Battery usage consumption level for power-consumption from battery, value = 100 (W) W
device-local-battery-usage-strategy-set String Battery usage strategy, Value = 1 = Automatic, Value = 2 = Automatic economical W
device-local-smart-battery-control-set Switch Smart battery control, Value = OFF / ON W
device-local-battery-charge-time-from-set String Battery charge time from, Value = 00:00 W
device-local-battery-charge-time-to-set String Battery charge time to, Value = 23:59 W
device-local-max-depth-of-discharge-set String Max depth of discharge (SoC), Value = 10 W
device-local-shadow-management-set String Shadow management, Value = 0 = No shadow management enabled, Value = 1 = Shadow management enabled for DC-Input String 1, Value = 2 = Shadow management enabled for DC-Input String 2, Value = 3 = Shadow management enabled for DC-Input String 1 and 2 W
device-local-external-module-control-set String External module control, Value = 0 = Not Activated, Value = 1 = Activated W

# Third generation devices (PIKO IQ / PLENTICORE plus)

Channel Type ID Item Type Description Read Write
deviceLocalDCPower Number:Energy Current DC power of the inverter R
deviceLocalHomeconsumptionFromBattery Number:Energy Current home consumption obtained from the battery R
deviceLocalHomeconsumptionFromGrid Number:Energy Current home consumption obtained from the grid R
deviceLocalOwnconsumption Number:Energy Current own comsumption R
deviceLocalHomeconsumptionFromPV Number:Energy Current home consumption obtained from photovoltaic R
deviceLocalHomeconsumptionTotal Number:Energy Current total homeconsumption R
deviceLocalLimitEVUAbsolute Number:Energy Permitted feed-in quantity as absolute value as specified by the energy supplier R
deviceLocalLimitEVURelativ Number:Dimensionless Permitted feed-in quantity as relative value as specified by the energy supplier R
deviceLocalWorktime Number:Time Uptime of the inverter R
deviceLocalACPhase1CurrentAmperage Number:ElectricCurrent Amperage of phase 1 R
deviceLocalACPhase1CurrentPower Number:Energy Power of phase 1 R
deviceLocalACPhase1CurrentVoltage Number:ElectricPotential Voltage of phase 1 R
deviceLocalACPhase2CurrentAmperage Number:ElectricCurrent Amperage of phase 2 R
deviceLocalACPhase2CurrentPower Number:Energy Power of phase 2 R
deviceLocalACPhase2CurrentVoltage Number:ElectricPotential Voltage of phase 2 R
deviceLocalACPhase3CurrentAmperage Number:ElectricCurrent Amperage of phase 3 R
deviceLocalACPhase3CurrentPower Number:Energy Power of phase 3 R
deviceLocalACPhase3CurrentVoltage Number:ElectricPotential Voltage of phase 3 R
deviceLocalACCurrentPower Number:Energy Current AC power of the inverter R
deviceLocalBatteryLoadingCycles Number:Dimensionless Amount of loading cycles done by the battery R
deviceLocalBatteryFullChargeCapacity Number:ElectricCharge Capacity of the battery if charged fully R
deviceLocalBatteryAmperage Number:ElectricCurrent Current amperage of the battery R
deviceLocalBatteryPower Number:Energy Current battery charge R
deviceLocalBatteryStageOfCharge Number:Dimensionless Current battery charge status R
deviceLocalBatteryVoltage Number:ElectricPotential Current voltage of the battery R
deviceLocalPVString1Amperage Number:ElectricCurrent Current amperage of photovoltaic string 1 R
deviceLocalPVString1Power Number:Energy Current power of photovoltaic string 1 R
deviceLocalPVString1Voltage Number:ElectricPotential Current voltage of photovoltaic string 1 R
deviceLocalPVString2Amperage Number:ElectricCurrent Current amperage of photovoltaic string 2 R
deviceLocalPVString2Power Number:Energy Current power of photovoltaic string 2 R
deviceLocalPVString2Voltage Number:ElectricPotential Current voltage of photovoltaic string 2 R
deviceLocalPVString3Amperage Number:ElectricCurrent Current amperage of photovoltaic string 3 R
deviceLocalPVString3Power Number:Energy Current power of photovoltaic string 3 R
deviceLocalPVString3Voltage Number:ElectricPotential Current voltage of photovoltaic string 3 R
SCBEventErrorCountMc Number:Dimensionless Number of errors reported by the main controller R
SCBEventErrorCountSFH Number:Dimensionless Number of errors reported by the grid interface controller R
SCBEventErrorCountSCB Number:Dimensionless Number of errors reported by the smart communication board R
SCBEventWarningCountSCB Number:Dimensionless Number of warnings reported by the smart communication board R
statisticAutarkyDay Number:Dimensionless Autarky ratio of this day R
statisticAutarkyMonth Number:Dimensionless Autarky ratio of this month R
statisticAutarkyTotal Number:Dimensionless Autarky ratio overall R
statisticAutarkyYear Number:Dimensionless Autarky ratio of this year R
statisticCo2SavingDay Number:Mass Savings in Co2 emissions today R
statisticCo2SavingMonth Number:Mass Savings in Co2 emissions this month R
statisticCo2SavingTotal Number:Mass Savings in Co2 emissions overall R
statisticCo2SavingYear Number:Mass Savings in Co2 emissions this year R
statisticHomeconsumptionDay Number:Energy Home consumption today R
statisticHomeconsumptionMonth Number:Energy Home consumption this month R
statisticHomeconsumptionTotal Number:Energy Home consumption overall R
statisticHomeconsumptionYear Number:Energy Home consumption this year R
statisticHomeconsumptionFromBatteryDay Number:Energy Home consumption obtained from the battery today R
statisticHomeconsumptionFromBatteryMonth Number:Energy Home consumption obtained from the battery this month R
statisticHomeconsumptionFromBatteryTotal Number:Energy Home consumption obtained from the battery overall R
statisticHomeconsumptionFromBatteryYear Number:Energy Home consumption obtained from the battery this year R
statisticHomeconsumptionFromGridDay Number:Energy Home consumption obtained from the grid today R
statisticHomeconsumptionFromGridMonth Number:Energy Home consumption obtained from the grid this month R
statisticHomeconsumptionFromGridTotal Number:Energy Home consumption obtained from the grid overall R
statisticHomeconsumptionFromGridYear Number:Energy Home consumption obtained from the grid this year R
statisticHomeconsumptionFromPVDay Number:Energy Home consumption obtained from the photovoltaic plant today R
statisticHomeconsumptionFromPVMonth Number:Energy Home consumption obtained from the photovoltaic plant this month R
statisticHomeconsumptionFromPVTotal Number:Energy Home consumption obtained from the photovoltaic plant overall R
statisticHomeconsumptionFromPVYear Number:Energy Home consumption obtained from the photovoltaic plant this year R
statisticOwnconsumptionRateDay Number:Dimensionless Percentage of electricity demand covered by photovoltaics today R
statisticOwnconsumptionRateMonth Number:Dimensionless Percentage of electricity demand covered by photovoltaics this month R
statisticOwnconsumptionRateTotal Number:Dimensionless Percentage of electricity demand covered by photovoltaics overall R
statisticOwnconsumptionRateYear Number:Dimensionless Percentage of electricity demand covered by photovoltaics this year R
statisticYieldDay Number:Energy Yield of the photovoltaic plant today R
statisticYieldMonth Number:Energy Yield of the photovoltaic plant this month R
statisticYieldTotal Number:Energy Yield of the photovoltaic plant overall R
statisticYieldYear Number:Energy Yield of the photovoltaic plant this year R

# Thing Configuration

# First generation devices (PIKO)

demo.things

Thing kostalinverter:kostalinverter:inverter [ url="http://192.168.0.128" ]

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. You optionally can define a userName and a password parameter if the access to the webinterface is protected and a desired refreshInterval (the time interval between updates, default 60 seconds).

# Second generation devices (PIKO 10-20, PIKO NEW GENERATION)

Second generation inverters require 4 mandatory parameters and 1 optional (hasBattery):

Parameter Description Type Unit Default value Example value
url Host name or IP address of your device Text --- --- 192.168.0.2
username Username for your inverter Text --- --- myUsername
password Password for your inverter Text --- --- myPassword
refreshInterval Pollingintervall of your inverter Integer Seconds 60 60
hasBattery Type of PIKO 10-20 inverter, with or without battery boolean --- -- false/true

demo.things

Thing kostalinverter:piko1020:mypiko1020 [ url="http://'inverter-ip'", username="'myUsername'", password="'myPassword'", refreshInterval=60, hasBattery=false]

You can define which type of PIKO10-20 inverter you will connect to with parameter hasBattery.

# Third generation devices (PIKO IQ / PLENTICORE plus)

All third generation inverters require to define 3 mandatory configuration parameters:

Parameter Description Type Unit Default value Example value
url Host name or IP address of your device Text --- --- 192.168.1.2
userPassword Password you configured on the inverters web front end Text --- --- myPassword
refreshInternalInSeconds Defines how often the device is polled for new values Integer Seconds 30 30

If you are using the hostname instead of the IP address, please make sure your DNS is configuration correctly! The refresh interval should be chosen wisely. To small interval may led to high workload for the inverter. It is recommended to use an interval of 30 seconds.

Full sample of thing configuration:

Thing kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery [ url = "192.168.1.2", userPassword="myPassword", refreshInternalInSeconds="30"]

# Items

# First generation devices (PIKO)

demo.items:

Number:Power SolarPower "Solar power [%.1f %unit%]" <energy> { channel="kostalinverter:kostalinverter:inverter:acPower" }
Number:Energy SolarEnergyDay "Solar day energy [%.3f %unit%]" <energy> { channel="kostalinverter:kostalinverter:inverter:dayEnergy" }
Number:Energy SolarTotalEnergy "Solar total energy [%.3f %unit%]" <energy> { channel="kostalinverter:kostalinverter:inverter:totalEnergy" }
String SolarStatus "Solar status [%s]" <energy> { channel="kostalinverter:kostalinverter:inverter:status" }

# Second generation devices (PIKO NEW GENERATION)

demo.items:

Number:Power                GridOutputPower             "Grid Output Power"                         <energy> { channel="kostalinverter:piko1020:mypiko1020:gridOutputPower" }
Number:Energy               YieldDaySecondGen           "PV Output Power Day"                       <energy> { channel="kostalinverter:piko1020:mypiko1020:yieldDaySecondGen" }
Number:Energy               YieldTotalSecondGen         "PV Output Power Total"                     <energy> { channel="kostalinverter:piko1020:mypiko1020:yieldTotalSecondgen" }  
Number:Dimensionless        OperatingStatus             "Operating Status"                          <energy> { channel="kostalinverter:piko1020:mypiko1020:operatingStatus" }
Number:ElectricPotential    GridVoltageL1               "Grid Voltage L1"                           <energy> { channel="kostalinverter:piko1020:mypiko1020:gridVoltageL1" }
Number:ElectricCurrent      GridCurrentL1               "Grid Current L1"                           <energy> { channel="kostalinverter:piko1020:mypiko1020:gridCurrentL1" }
Number:Power                GridPowerL1                 "Grid Power L1"                             <energy> { channel="kostalinverter:piko1020:mypiko1020:gridPowerL1" }
Number:ElectricPotential    GridVoltageL2               "Grid Voltage L2"                           <energy> { channel="kostalinverter:piko1020:mypiko1020:gridVoltageL2" }
Number:ElectricCurrent      GridCurrentL2               "Grid Current L2"                           <energy> { channel="kostalinverter:piko1020:mypiko1020:gridCurrentL2" }
Number:Power                GridPowerL2                 "Grid Power L2"                             <energy> { channel="kostalinverter:piko1020:mypiko1020:gridPowerL2" }
Number:ElectricPotential    GridVoltageL3               "Grid Voltage L3"                           <energy> { channel="kostalinverter:piko1020:mypiko1020:gridVoltageL3" }
Number:ElectricCurrent      GridCurrentL3               "Grid Current L3"                           <energy> { channel="kostalinverter:piko1020:mypiko1020:gridCurrentL3" }
Number:Power                GridPowerL3                 "Grid Power L3"                             <energy> { channel="kostalinverter:piko1020:mypiko1020:gridPowerL3" }
Number:Power                DcPvPower                   "DC Power Pv"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:dcPowerPV" }
Number:ElectricPotential    Dc1Voltage                  "DC1 Voltage"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:dc1Voltage" }
Number:ElectricCurrent      Dc1Current                  "DC1 Current"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:dc1Current" }
Number:Power                Dc1Power                    "DC1 Power"                                 <energy> { channel="kostalinverter:piko1020:mypiko1020:dc1Power" }
Number:ElectricPotential    Dc2Voltage                  "DC2 Voltage"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:dc2Voltage" }
Number:ElectricCurrent      Dc2Current                  "DC2 Current"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:dc2Current" }
Number:Power                Dc2Power                    "DC2 Power"                                 <energy> { channel="kostalinverter:piko1020:mypiko1020:dc2Power" }
Number:ElectricPotential    Dc3Voltage                  "DC3 Voltage"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:dc3Voltage" }
Number:ElectricCurrent      Dc3Current                  "DC3 Current"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:dc3Current" }
Number:Power                Dc3Power                    "DC3 Power"                                 <energy> { channel="kostalinverter:piko1020:mypiko1020:dc3Power" }
Number:Power                AktHomeConsumptionSolar     "Akt Home Consumption Solar"                <energy> { channel="kostalinverter:piko1020:mypiko1020:aktHomeConsumptionSolar" }
Number:Power                AktHomeConsumptionBat       "Akt Home Consumption Battery"              <energy> { channel="kostalinverter:piko1020:mypiko1020:aktHomeConsumptionBat" }
Number:Power                AktHomeConsumptionGrid      "Akt Home Consumption Grid"                 <energy> { channel="kostalinverter:piko1020:mypiko1020:aktHomeConsumptionGrid" }
Number:Power                PhaseSelHomeConsumpL1       "Phase Sel Home Consump L1"                 <energy> { channel="kostalinverter:piko1020:mypiko1020:phaseSelHomeConsumpL1" }
Number:Power                PhaseSelHomeConsumpL2       "Phase Sel Home Consump L2"                 <energy> { channel="kostalinverter:piko1020:mypiko1020:phaseSelHomeConsumpL2" }
Number:Power                PhaseSelHomeConsumpL3       "Phase Sel Home Consump L3"                 <energy> { channel="kostalinverter:piko1020:mypiko1020:phaseSelHomeConsumpL3" }
Number:Frequency            GridFreq                    "Grid Freq"                                 <energy> { channel="kostalinverter:piko1020:mypiko1020:gridFreq" }
Number:Angle                GridCosPhi                  "Grid Cos Phi"                              <energy> { channel="kostalinverter:piko1020:mypiko1020:gridCosPhi" }
Number:Energy               HomeConsumptionDay          "Home Consumption Day"                      <energy> { channel="kostalinverter:piko1020:mypiko1020:homeConsumptionDay" } 
Number:Energy               OwnConsumptionDay           "Own Consumption Day"                       <energy> { channel="kostalinverter:piko1020:mypiko1020:ownConsumptionDay" } 
Number:Dimensionless        OwnConsRateDay              "Own Cons Rate Day"                         <energy> { channel="kostalinverter:piko1020:mypiko1020:ownConsRateDay" } 
Number:Dimensionless        AutonomyDegreeDay           "Autonomy Degree Day"                       <energy> { channel="kostalinverter:piko1020:mypiko1020:autonomyDegreeDay" }
Number:Energy               HomeConsumptionTotal        "Home Consumption Total"                    <energy> { channel="kostalinverter:piko1020:mypiko1020:homeConsumptionTotal" } 
Number:Energy               OwnConsumptionTotal         "Own Consumption Total"                     <energy> { channel="kostalinverter:piko1020:mypiko1020:ownConsumptionTotal" } 
Number:Time                 OperatingTimeTotal          "Operating Time Total"                      <energy> { channel="kostalinverter:piko1020:mypiko1020:operatingTimeTotal" }
Number:ElectricCurrent      Current                     "Current"                                   <energy> { channel="kostalinverter:piko1020:mypiko1020:current" }
Number:Dimensionless        CurrentDir                  "Current Dir"                               <energy> { channel="kostalinverter:piko1020:mypiko1020:currentDir" }
Number:Dimensionless        ChargeCycles                "Charge Cycles"                             <energy> { channel="kostalinverter:piko1020:mypiko1020:chargeCycles" }
Number:Temperature          BatteryTemperature          "BatteryTemperature"                        <energy> { channel="kostalinverter:piko1020:mypiko1020:batteryTemperature" }
Number:Time                 Loginterval                 "Log Interval"                              <energy> { channel="kostalinverter:piko1020:mypiko1020:loginterval" }
Number:Dimensionless        S0InPulseCnt                "S0 InPulse Cnt"                            <energy> { channel="kostalinverter:piko1020:mypiko1020:s0InPulseCnt" }
Number:Dimensionless        OwnConsRateTotal            "Own Cons Rate Total"                       <energy> { channel="kostalinverter:piko1020:mypiko1020:ownConsRateTotal" } 
Number:Dimensionless        AutonomyDegreeTotal         "Autonomy Degree Total"                     <energy> { channel="kostalinverter:piko1020:mypiko1020:autonomyDegreeTotal" } 
Number:ElectricPotential    BatteryVoltage              "Battery Voltage"                           <energy> { channel="kostalinverter:piko1020:mypiko1020:batteryVoltage" }
Number:Dimensionless        BatStateOfCharge            "Bat State Of Charge"                       <energy> { channel="kostalinverter:piko1020:mypiko1020:batStateOfCharge" }
Number:Power                SelfConsumption             "Self Consumption"                          <energy> { channel="kostalinverter:piko1020:mypiko1020:selfConsumption" }
Number:Dimensionless        BatteryUsageConsumption     "Battery Usage Consumption"                 <energy> { channel="kostalinverter:piko1020:mypiko1020:batteryUsageConsumption" }
Switch                      SmartBatteryControl         "Smart Battery Control"                     <energy> { channel="kostalinverter:piko1020:mypiko1020:smartBatteryControl" }
Number:Dimensionless        MaxDepthOfDischarge         "Max Depth Of Discharge"                    <energy> { channel="kostalinverter:piko1020:mypiko1020:maxDepthOfDischarge" }
Number:Dimensionless        ShadowManagement            "Shadow Management"                         <energy> { channel="kostalinverter:piko1020:mypiko1020:shadowManagement" }
Number:Dimensionless        ExternalModuleControl       "External Module Control"                   <energy> { channel="kostalinverter:piko1020:mypiko1020:externalModuleControl" }           


# Third generation devices (PIKO IQ / PLENTICORE plus)

demo.items:

Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_DC_POWER                         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalDCPower"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_HOMECONSUMPTION_FROM_BATTERY     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalHomeconsumptionFromBattery"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_HOMECONSUMPTION_FROM_GRID        <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalHomeconsumptionFromGrid"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_OWNCONSUMPTION                   <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalOwnconsumption"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_HOMECONSUMPTION_FROM_PV          <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalHomeconsumptionFromPV"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_HOMECONSUMPTION_TOTAL            <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalHomeconsumptionTotal"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_LIMIT_EVU_ABSOLUTE               <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalLimitEVUAbsolute"}
Number:Dimensionless         MyPlentiCore100WithBattery_DEVICE_LOCAL_LIMIT_EVU_RELATIV                <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalLimitEVURelativ"}
Number:Time                  MyPlentiCore100WithBattery_DEVICE_LOCAL_WORKTIME                         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalWorktime"}
Number:ElectricCurrent       MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_1_CURRENT_AMPERAGE      <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase1CurrentAmperage"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_1_CURRENT_POWER         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase1CurrentPower"}
Number:ElectricPotential     MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_1_CURRENT_VOLTAGE       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase1CurrentVoltage"}
Number:ElectricCurrent       MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_2_CURRENT_AMPERAGE      <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase2CurrentAmperage"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_2_CURRENT_POWER         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase2CurrentPower"}
Number:ElectricPotential     MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_2_CURRENT_VOLTAGE       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase2CurrentVoltage"}
Number:ElectricCurrent       MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_3_CURRENT_AMPERAGE      <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase3CurrentAmperage"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_3_CURRENT_POWER         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase3CurrentPower"}
Number:ElectricPotential     MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_PHASE_3_CURRENT_VOLTAGE       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACPhase3CurrentVoltage"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_AC_CURRENT_POWER                 <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalACCurrentPower"}
Number:Dimensionless         MyPlentiCore100WithBattery_DEVICE_LOCAL_BATTERY_LOADING_CYCLES           <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalBatteryLoadingCycles"}
Number:ElectricCharge        MyPlentiCore100WithBattery_DEVICE_LOCAL_BATTERY_FULL_CHARGE_CAPACITY     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalBatteryFullChargeCapacity"}
Number:ElectricCurrent       MyPlentiCore100WithBattery_DEVICE_LOCAL_BATTERY_AMPERAGE                 <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalBatteryAmperage"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_BATTERY_POWER                    <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalBatteryPower"}
Number:Dimensionless         MyPlentiCore100WithBattery_DEVICE_LOCAL_BATTERY_STATE_OF_CHARGE          <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalBatteryStageOfCharge"}
Number:ElectricPotential     MyPlentiCore100WithBattery_DEVICE_LOCAL_BATTERY_VOLTAGE                  <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalBatteryVoltage"}
Number:ElectricCurrent       MyPlentiCore100WithBattery_DEVICE_LOCAL_PVSTRING_1_AMPERAGE              <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalPVString1Amperage"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_PVSTRING_1_POWER                 <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalPVString1Power"}
Number:ElectricPotential     MyPlentiCore100WithBattery_DEVICE_LOCAL_PVSTRING_1_VOLTAGE               <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalPVString1Voltage"}
Number:ElectricCurrent       MyPlentiCore100WithBattery_DEVICE_LOCAL_PVSTRING_2_AMPERAGE              <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalPVString2Amperage"}
Number:Energy                MyPlentiCore100WithBattery_DEVICE_LOCAL_PVSTRING_2_POWER                 <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalPVString2Power"}
Number:ElectricPotential     MyPlentiCore100WithBattery_DEVICE_LOCAL_PVSTRING_2_VOLTAGE               <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:deviceLocalPVString2Voltage"}
Number:Dimensionless         MyPlentiCore100WithBattery_SCB_EVENT_ERROR_COUNT_MC                      <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:SCBEventErrorCountMc"}
Number:Dimensionless         MyPlentiCore100WithBattery_SCB_EVENT_ERROR_COUNT_SFH                     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:SCBEventErrorCountSFH"}
Number:Dimensionless         MyPlentiCore100WithBattery_SCB_EVENT_ERROR_COUNT_SCB                     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:SCBEventErrorCountSCB"}
Number:Dimensionless         MyPlentiCore100WithBattery_SCB_EVENT_WARNING_COUNT_SCB                   <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:SCBEventWarningCountSCB"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_AUTARKY_DAY                         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticAutarkyDay"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_AUTARKY_MONTH                       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticAutarkyMonth"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_AUTARKY_TOTAL                       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticAutarkyTotal"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_AUTARKY_YEAR                        <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticAutarkyYear"}
Number:Mass                  MyPlentiCore100WithBattery_STATISTIC_CO2SAVING_DAY                       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticCo2SavingDay"}
Number:Mass                  MyPlentiCore100WithBattery_STATISTIC_CO2SAVING_MONTH                     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticCo2SavingMonth"}
Number:Mass                  MyPlentiCore100WithBattery_STATISTIC_CO2SAVING_TOTAL                     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticCo2SavingTotal"}
Number:Mass                  MyPlentiCore100WithBattery_STATISTIC_CO2SAVING_YEAR                      <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticCo2SavingYear"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_DAY                 <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionDay"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_MONTH               <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionMonth"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_TOTAL               <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionTotal"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_YEAR                <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionYear"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_BATTERIE_DAY   <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromBatteryDay"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_BATTERIE_MONTH <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromBatteryMonth"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_BATTERIE_TOTAL <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromBatteryTotal"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_BATTERIE_YEAR  <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromBatteryYear"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_GRID_DAY       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromGridDay"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_GRID_MONTH     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromGridMonth"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_GRID_TOTAL     <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromGridTotal"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_GRID_YEAR      <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromGridYear"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_PV_DAY         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromPVDay"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_PV_MONTH       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromPVMonth"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_PV_TOTAL       <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromPVTotal"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_HOMECONSUMPTION_FROM_PV_YEAR        <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticHomeconsumptionFromPVYear"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_OWNCONSUMPTION_RATE_DAY             <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticOwnconsumptionRateDay"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_OWNCONSUMPTION_RATE_MONTH           <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticOwnconsumptionRateMonth"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_OWNCONSUMPTION_RATE_TOTAL           <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticOwnconsumptionRateTotal"}
Number:Dimensionless         MyPlentiCore100WithBattery_STATISTIC_OWNCONSUMPTION_RATE_YEAR            <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticOwnconsumptionRateYear"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_YIELD_DAY                           <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticYieldDay"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_YIELD_MONTH                         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticYieldMonth"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_YIELD_TOTAL                         <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticYieldTotal"}
Number:Energy                MyPlentiCore100WithBattery_STATISTIC_YIELD_YEAR                          <energy> { channel="kostalinverter:PLENTICOREPLUS100WITHBATTERY:MyPlentiCore100WithBattery:statisticYieldYear"}

# Rules

Second generation devices (PIKO 10-20, PIKO NEW GENERATION) Ex. Set Smart battery control OFF with cron trigger:

triggers:
   id: "1"
    configuration:
      cronExpression: 0 0/2 * * * ? *
    type: timer.GenericCronTrigger
conditions: []
actions:
   inputs: {}
    id: "2"
    configuration:
      type: application/vnd.openhab.dsl.rule
      script: KOSTALPIKO1020_SmartBatteryControlSet.sendCommand("OFF")
    type: script.ScriptAction