Skip to content
EN | DE

Solplanet AI-Dongle LAN (local HTTP API)

Uses the AI-Dongle local HTTP API (e.g. BA121T-30) instead of Modbus TCP. The inverter serial number (isn) can be read via http://<host>:8484/getdev.cgi?device=2.

Usage areas

  • Grid meter
  • Solar production
  • Battery

Parameters

NameDescriptionValueLevel
hostIP address or hostname
Example: 192.0.2.2
optional
serialInverter serial number (isn)optional
capacity [kWh]Battery capacity
Example: 50
optional
minsoc [%]Minimum charge

Lower limit when discharging the battery in normal operation

Example: 25
optional
maxsoc [%]Maximum charge

Upper limit when charging the battery from the grid

Example: 95
optional
maxchargepower [W]Maximum charge power

For forced charging of the battery.

advanced
maxdischargepower [W]Maximum discharge power

Maximum discharge power of the storage.

advanced
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: solplanet-ai-dongle
usage: grid
host: 192.0.2.2 # IP address or hostname
serial: # Inverter serial number (isn)
meters:
- name: my_pv
type: template
template: solplanet-ai-dongle
usage: pv
host: 192.0.2.2 # IP address or hostname
serial: # Inverter serial number (isn)
meters:
- name: my_battery
type: template
template: solplanet-ai-dongle
usage: battery
host: 192.0.2.2 # IP address or hostname
serial: # Inverter serial number (isn)
capacity: 50 # Battery capacity (kWh), optional
minsoc: 25 # Minimum charge (%), Lower limit when discharging the battery in normal operation (optional)
maxsoc: 95 # Maximum charge (%), Upper limit when charging the battery from the grid (optional)
maxchargepower: # Maximum charge power (W), For forced charging of the battery. (optional)
maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)