This CCU-Addon reads the current status informationen from a KOSTAL Piko inverter an provides these informations as system variables within the HomeMatic CCU environment.

Following values are requested from a KOSTAL Piko inverter:

• DC-Power (W)
• AC-Power (W)
• Total Output (kW)
• Operational State (0 = off, 1 = idle, 2 = start-up, 3 = feed MPP, 4 = limited, 5 = feed, 6 = ??, 7 = ??, 8 = ??
• Battery - Charge State (%)
• Battery - Load Cycles (Amount)
• Battery - Temperature (celsius°)
• Battery - Voltage (V)
• Battery - Current (A)
• Battery - Charging/Discharging (1=Charging; 0=Discharging)
• Consumed Energy from Energy Provider (W)
• Consumed Energy self generated (W)

• HomeMatic CCU3 / RaspberryMatic
• HomeMatic CCU2
• HomeMatic CCU1

1. Download of recent Addon-Release from Github
2. Installation of Addon archive (hm_kostalpiko-X.X.tar.gz) via WebUI interface of CCU device
3. Configuration of Addon using the WebUI accessible config pages

1. Create a new directory for hm_kostalpiko:

    mkdir /opt/hm_kostalpiko
   

2. Change to new directory:

    cd /opt/hm_kostalpiko
   

3. Download latest hm_kostalpiko.sh:

    wget https://github.com/H2CK/hm_kostalpiko/raw/master/hm_kostalpiko.sh
   

4. Download of sample config:

    wget https://github.com/H2CK/hm_kostalpiko/raw/master/hm_kostalpiko.conf.sample
   

5. Rename sample config to active one:

    mv hm_kostalpiko.conf.sample hm_kostalpiko.conf
   

6. Modify configuration according to comments in config file:

    vim hm_kostalpiko.conf
   

7. Execute hm_kostalpiko manually:

    /opt/hm_kostalpiko/hm_kostalpiko.sh
   

8. If you want to automatically start hm_kostalpiko on system startup a startup script

Instead of automatically calling hm_kostalpiko on a predefined interval one can also trigger its execution using the system.Exec() command within HomeMatic scripts on the CCU following the following syntax:

    system.Exec("/usr/local/addons/hm_kostalpiko/run.sh <iterations> <waittime> &");

Please note the <iterations> and <waittime> which allows to additionally specify how many times hm_kostalpiko should be executed with a certain amount of wait time in between. One example of such an execution can be:

    system.Exec("/usr/local/addons/hm_kostalpiko/run.sh 5 2 &");

This will execute hm_kostalpiko for a total amount of 5 times with a waittime of 2 seconds between each execution.

In case of problems/bugs or if you have any feature requests please feel free to open a new ticket at the Github project pages.

The use and development of this addon is based on version 3 of the LGPL open source license.

Copyright (c) 2018 Thorsten Jagel <[email protected]>

This Addon uses KnowHow that was developed throughout the following projects:

• https://github.com/jens-maus/hm_pdetect