Skip to content
smart charging

KACO blueplanet hybrid NH3

This page shows the nightly version. There is no release version yet.

For KACO blueplanet Hybrid NH3 with AI dongle/Wi-Fi stick. Modbus TCP and the local AISWEI HTTP API must be reachable at the stick's IP address (Modbus TCP port 502, device ID 3; HTTP port 8484). Battery power control uses the local fdbg.cgi endpoint. Maximum charge and discharge power are read from SunSpec Model 802. Battery charge and discharge energy are read from the local AISWEI HTTP API. Configure curtailment through a separate KACO NH3 curtailer device. The grid meter exposed through SunSpec Model 203 provides grid power, import/export energy, and per-phase measurements.

Supported features

  • Battery control: External control of home battery charging and discharging via evcc.

Usage areas

  • Grid meter
  • Solar production
  • Battery

Parameters

NameDescriptionValueLevel
idModbus ID
Default: 1
intrequired
hostIP address or hostname
Example: 192.0.2.2
required
portPort
Default: 502
intrequired
batteryBattery numberoptional
serialInverter serial number (isn)optional
capacity [kWh]Battery capacity
Example: 50
optional
minsoc [%]Minimum charge

Written to the inverter as the discharge limit and used by the optimizer. Only set a value supported by the battery. Minimum value is 5%.

Default: 10
Example: 25
optional
maxsoc [%]Maximum charge

Written to the inverter as the charge limit and used by the optimizer. Only set a value supported by the battery.

Default: 100
Example: 95
optional
Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

meters:
- name: my_grid
type: template
template: kaco-nh3
usage: grid
# Modbus TCP
modbus: tcpip
id: 3
host: # Hostname
port: 502 # Port
meters:
- name: my_pv
type: template
template: kaco-nh3
usage: pv
# Modbus TCP
modbus: tcpip
id: 3
host: # Hostname
port: 502 # Port
meters:
- name: my_battery
type: template
template: kaco-nh3
usage: battery
# Modbus TCP
modbus: tcpip
id: 3
host: # Hostname
port: 502 # Port
battery: # Battery number, [1, 2]
serial: # Inverter serial number (isn)
capacity: 50 # Battery capacity (kWh), optional
minsoc: 10 # Minimum charge (%), Written to the inverter as the discharge limit and used by the optimizer. Only set a value supported by the battery. Minimum value is 5%. (optional)
maxsoc: 100 # Maximum charge (%), Written to the inverter as the charge limit and used by the optimizer. Only set a value supported by the battery. (optional)