iobroker.kostalpiko
v0.6.22
Published
ioBroker adapter for Kostal PIKO solar inverters (HTTP scraping)
Readme
ioBroker Kostal PIKO Adapter
Live monitoring, 15-minute history and long-term yield for Kostal PIKO inverters – directly via the built-in HTTP web server, no cloud required.
Values are exposed as ioBroker states, optional InfluxDB sync for Grafana, and a built-in engineer dashboard in the browser.
German documentation: docs/README.de.md · Installation: INSTALLATION.md
http://IOBROKER-IP:8092/ ← kostalpiko.0
http://IOBROKER-IP:8093/ ← kostalpiko.1 (additional instances +1 port)Dashboard overview
| Tab | Content | |---|---| | Data | Live AC/DC, phases, efficiency, string values, Vmpp temperature, weather | | History | KPIs, Chart.js curves, 15-min table, string analysis, temperature chart | | Yield | Monthly table years × months, €/kWh, export/import, year comparison | | Nodes | All ioBroker states of the instance | | Logs | Adapter log (sync, PIKO fetch, errors) | | System | Connection, InfluxDB, manual sync |
Screenshots
See docs/screenshots/ – update guide in docs/screenshots/README.md.
Features
| Area | Function |
|---|---|
| Live data | AC/DC, phases, energy, status, efficiency |
| History | LogDaten.dat, Chart.js, cache, catch-up fetch |
| Yield | Years × months, manual + auto, €, kWh/kWp, CSV/JSON |
| Weather | Open-Meteo: sunshine hours, cloud cover, temperature (postal code) |
| Analysis | String analysis, Kostal datasheet limits |
| InfluxDB | Live + history with historical timestamps |
| Multi-instance | kostalpiko.0 + kostalpiko.1 in parallel |
| Notifications | Daily/weekly/monthly HTML email reports |
Supported hardware
| Model | Strings | Status | |---|---|---| | PIKO 3.0 – 4.2 | 1–2 | Supported | | PIKO 5.5 | 3 | Tested | | PIKO 7.0 – 8.3 | 2 | Tested (8.3) | | PIKO 10.1 | 3 | Supported |
Firmware: ver 3.62 · Model selectable in settings or auto-detected.
Manufacturer: Kostal Solar Electric
Installation & update
iobroker url https://github.com/MPunktBPunkt/iobroker.kostalpiko
iobroker add kostalpiko # first install only
iobroker update kostalpiko
iobroker restart kostalpikoReleases: github.com/MPunktBPunkt/iobroker.kostalpiko/releases
Details: INSTALLATION.md · API overview: Schnittstellen.md
Configuration (summary)
| Setting | Default | Description |
|---|---|---|
| IP / port / auth | – | PIKO web server |
| Poll interval | 30 s | Live polling |
| Fetch history | off | LogDaten.dat |
| Sync interval | 15 min | History + optional InfluxDB |
| Web UI port | 8092 | +1 per instance |
| Postal code | 87781 | Weather + regional comparison |
| Feed-in tariff | 0.3925 €/kWh | Yield tab |
| Module config | optional | String analysis, kWp |
InfluxDB (host, token, database) is configured in the InfluxDB adapter.
States (selection)
Live: ac.power, energy.today/total, pv.string1/2/3.*, dc.totalPower, efficiency.ratio, weather.*, status, online
History (15-min): history.dc1/2/3.*, history.ac.*, history.ac.totalPower, history.energy.total, history.efficiency.ratio
Full list: Web UI → Nodes tab or Schnittstellen.md
Object hierarchy: channels (ac, pv, weather, history, …) are created explicitly before states (ioBroker object schema).
Multiple inverters
| Instance | Web UI | Data |
|---|---|---|
| kostalpiko.0 | :8092 | own monthly-yields.json, history-cache.json |
| kostalpiko.1 | :8093 | own files |
Combine yields from two inverters:
node /opt/iobroker/node_modules/iobroker.kostalpiko/scripts/combine-yields.js \
/opt/iobroker/iobroker-data kostalpiko.0 kostalpiko.1 --from 2018-05 --csv yield.csvRelease history: GitHub Releases · Older changelogs
Donate
License
GNU General Public License v3.0 – see LICENSE
Copyright (c) 2026 MPunktBPunkt
