Kostal Piko Solar Monitor

Home Assistant custom integration for KOSTAL PIKO inverters with battery support.

This integration reads the fixed inverter XML endpoints and creates sensors that are ready for Lovelace and the Energy Dashboard.

Highlights

• UI setup via host or IP
• Optional YAML setup
• Automatic use of /all.xml and /measurements.xml
• PV, battery, grid and household consumption sensors
• Battery state of charge and charge/discharge power
• Built-in cumulative energy sensors (kWh) for Energy Dashboard
• Device grouping in Home Assistant device registry

Requirements

• Home Assistant
• Network access to the inverter
• KOSTAL PIKO inverter with reachable web interface

Installation

HACS (recommended)

1. Open HACS.
2. Go to Integrations.
3. Open the menu and choose Custom repositories.
4. Add https://github.com/Multigestern/Kostal-Piko-Solar-Monitor.
5. Select category Integration.
6. Install Kostal Piko Solar Monitor.
7. Restart Home Assistant.

Manual

Copy the integration folder to:

config/custom_components/ha_kostal_piko_solar_monitor/

Then restart Home Assistant.

Configuration

UI setup

1. Open Settings -> Devices & Services -> Add Integration.
2. Select Kostal Piko Solar Monitor.
3. Enter inverter host or IP.
4. Optionally set a display name.

YAML setup

sensor:
  - platform: ha_kostal_piko_solar_monitor
    host: "inverter.local"
    device_name: "Kostal Piko"

Energy Dashboard mapping

Recommended mapping:

• Solar production: ..._solar_production_energy
• Grid import: ..._grid_import_energy
• Grid export: ..._grid_export_energy
• Battery charged: ..._battery_charging_energy
• Battery discharged: ..._battery_discharging_energy

Battery state of charge is available as:

• ..._battery_state_of_charge

Sensor groups

Raw inverter measurements include examples like:

• ..._ac_power
• ..._bms_bat_soc
• ..._gridpower
• ..._produced_yield

Derived sensors include:

• ..._battery_charging_power
• ..._battery_discharging_power
• ..._house_consumption_power
• ..._solar_production_power

Built-in cumulative energy sensors include:

• ..._battery_charging_energy
• ..._battery_discharging_energy
• ..._grid_import_energy
• ..._grid_export_energy

Troubleshooting

Energy sensors not visible in Energy Dashboard

If battery/grid energy sensors are not selectable, check:

1. Developer Tools -> Statistics for unit issues.
2. Repair invalid statistics metadata (for example None to kWh).
3. Wait a few minutes after repair for statistics to be generated.

Unknown values on grid sensors

Some Grid* values can remain unknown if no compatible external meter is connected to the inverter, or if the meter communication is unavailable.

Development

Install dependencies:

pip install -r requirements.txt

Optional syntax check:

python -m py_compile custom_components/ha_kostal_piko_solar_monitor/*.py

Maintainer notes

• Integration domain: ha_kostal_piko_solar_monitor
• HACS metadata: hacs.json
• Main component files: custom_components/ha_kostal_piko_solar_monitor/
• Keep manifest version in sync with release tags

Support

• Issues: https://github.com/Multigestern/Kostal-Piko-Solar-Monitor/issues
• Repository: https://github.com/Multigestern/Kostal-Piko-Solar-Monitor

License

MIT. See LICENSE.