openhab-addons/bundles/org.openhab.binding.fenecon/README.md

FENECON Binding

The FENECON Binding integrates the FENECON energy storage system device into the openHAB system via REST-API.

With the binding, it is possible to request status information from FENECON Home to allow you home automation decisions based on the current energy management.

This makes it possible, for example, to switch on other consumers such as the dishwasher or washing machine in the case of power overproduction.

Supported Things

Currently only one Thing is supported: The home-device connection to the FENECON energy storage system.

This Binding was tested with an FENECON HOME 10 device.

Discovery

Auto-discovery is not supported.

Thing Configuration

The FENECON Thing only needs to be configured with the hostname, all other parameters are optional and prefilled with the suitable default values:

Parameter	Description
hostname	Hostname or IP address of the FENECON device, e.g. 192.168.1.11
password	Password of the FENECON device. The password for guest access is set by default.
port	Port of the FENECON device. Default: 8084
refreshInterval	Interval the device is polled in sec. Default 30 seconds

Channels

The FENECON binding currently only provides access to read out the values from the energy storage system.

Channel	Type	Read/Write	Description
state	String	R	FENECON system state: Ok, Info, Warning or Fault
last-update	DateTime	R	Last successful update via REST-API from the FENECON system
ess-soc	Number:Dimensionless	R	Battery state of charge in percent
charger-power	Number:Power	R	Current charger power of energy storage system in watt.
discharger-power	Number:Power	R	Current discharger power of energy storage system in watt.
emergency-power-mode	Switch	R	Indicates if there is grid power is off and the emergency power mode is on.
production-active-power	Number:Power	R	Current active power producer load in watt.
production-max-active-power	Number:Power	R	Maximum active production power in watt that was measured.
export-to-grid-power	Number:Power	R	Current export power to grid in watt.
exported-to-grid-energy	Number:Energy	R	Total energy exported to the grid in watt per hour.
consumption-active-power	Number:Power	R	Current active power consumer load in watt.
consumption-max-active-power	Number:Power	R	Maximum active consumption power in watt that was measured.
consumption-active-power-l1	Number:Power	R	Current active power consumer load in watt on phase 1.
consumption-active-power-l2	Number:Power	R	Current active power consumer load in watt on phase 2.
consumption-active-power-l3	Number:Power	R	Current active power consumer load in watt on phase 3.
import-from-grid-power	Number:Power	R	Current import power from grid in watt.
imported-from-grid-energy	Number:Energy	R	Total energy imported from the grid in watt per hour.

Full Example

fenecon.things

Thing fenecon:home-device:local "FENECON Home" [hostname="192.168.1.11", refreshInterval=5]

demo.items

// Sitemap Items
Group   Home                    "MyHome"              <house>                                 ["Indoor"]
Group   GF                      "GroundFloor"         <groundfloor>          (Home)           ["GroundFloor"]
// Utility room
Group   GF_UtilityRoom          "Utility room"        <energy>               (Home, GF)       ["Room"]
Group   GF_UtilityRoomSolar     "Utility room solar"  <solarplant>           (GF_UtilityRoom) ["Inverter"]

// FENECON items
String               EssState                       <text>         (GF_UtilityRoomSolar) ["Status"]                {channel="fenecon:home-device:local:state"}
DateTime             LastFeneconUpdate              <time>         (GF_UtilityRoomSolar) ["Status"]                {channel="fenecon:home-device:local:last-update"}
Number:Dimensionless EssSoc                         <batterylevel> (GF_UtilityRoomSolar) ["Measurement"]           {unit="%", channel="fenecon:home-device:local:ess-soc"}
Number:Power         ChargerPower                   <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:charger-power"}
Number:Power         DischargerPower                <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:discharger-power"}
Switch               EmergencyPowerMode             <switch>       (GF_UtilityRoomSolar) ["Switch"]                {channel="fenecon:home-device:local:emergency-power-mode"}

Number:Power         ProductionActivePower          <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:production-active-power"}
Number:Power         ProductionMaxActivePower       <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:production-max-active-power"}
Number:Power         SellToGridPower                <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:export-to-grid-power"}
Number:Energy        TotalSellEnergy                <energy>       (GF_UtilityRoomSolar) ["Measurement", "Energy"] {channel="fenecon:home-device:local:exported-to-grid-energy"}

Number:Power         ConsumptionActivePower         <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:consumption-active-power"}
Number:Power         ConsumptionMaxActivePower      <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:consumption-max-active-power"}
Number:Power         ConsumptionActivePowerPhase1   <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:consumption-active-power-l1"}
Number:Power         ConsumptionActivePowerPhase2   <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:consumption-active-power-l2"}
Number:Power         ConsumptionActivePowerPhase3   <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:consumption-active-power-l3"}
Number:Power         BuyFromGridPower               <energy>       (GF_UtilityRoomSolar) ["Measurement", "Power"]  {channel="fenecon:home-device:local:import-from-grid-power"}
Number:Energy        TotalBuyEnergy                 <energy>       (GF_UtilityRoomSolar) ["Measurement", "Energy"] {channel="fenecon:home-device:local:imported-from-grid-energy"}

// Examples of items for calculating the energy purchased and sold. Look at the demo.rules section.
Number:Currency      SoldEnergy "Total sold energy [%.2f €]"           <price> (GF_UtilityRoomSolar)
Number:Currency      PurchasedEnergy "Total purchased energy [%.2f €]" <price> (GF_UtilityRoomSolar)

demo.sitemap

sitemap demo label="FENECON Example Sitemap" {
    Frame label="Groundfloor" icon="groundfloor" {
        Group item=GF_UtilityRoom
    }
}

demo.rules

:::: tabs

::: tab DSL

rule "Blackout detection"
when
  Item EmergencyPowerMode changed to ON
then
    val msg = "🚨 Power blackout detected, emergency power mode running."
    logInfo("PowerBlackout", msg)
    sendBroadcastNotification(msg)
end

rule "Battery 100 percent"
when
  Item EssSoc changed
then
    var batteryState = (EssSoc.getState() as Number).intValue()
    if(batteryState == 100){
        val msg = "🔋 Full battery, consumers can be activated."
        logInfo("FullBattery", msg)
        sendBroadcastNotification(msg)
    }
end

rule "Calculation sold energy"
when
  Item TotalSellEnergy changed
then
    val sellingPricePerKiloWattHour = 0.07 // €
    var current = (TotalSellEnergy.getState() as Number).intValue()
    var result = current * sellingPricePerKiloWattHour;
    SoldEnergy.postUpdate(result)
end

rule "Calculation purchased energy"
when
  Item TotalBuyEnergy changed
then
    val purchasedPricePerKiloWattHour = 0.32 // €
    var current = (TotalBuyEnergy.getState() as Number).intValue()
    var result = current * purchasedPricePerKiloWattHour;
    PurchasedEnergy.postUpdate(result)
end

:::

::::