Solplanet Hybrid inverter (Modbus TCP)

← PV, Battery, Grid, Meter

Only for inverters with a dedicated Modbus TCP ethernet port (e.g. ASW-TH series, KACO Blueplanet Hybrid NH3, port eth 5&6), protocol AISWEI "MB001_ASW GEN-Modbus" V2.1.7. Older devices without that port need the solplanet-ai-dongle template instead. The grid meter import/export energy counters (46443/46445) are not exposed over Modbus TCP by this firmware. With two battery packs (BMS1 + BMS2) add one battery meter each, using battery number 1 and 2.

Supported features

Battery control: External control of home battery charging and discharging via evcc.
Curtailable: Inverter production can be reduced (e.g. § 9 EEG). See External Limit.

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Value	Level
`id`	Modbus ID Default: `1`	int	required
`host`	IP address or hostname Example: `192.0.2.2`		required
`port`	Port Default: `502`	int	required
`battery`	Battery number		optional
`maxchargepower` [W]	Maximum charge power Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power.		optional
`capacity` [kWh]	Battery capacity Example: `50`		optional
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Default: `0` Example: `25`		optional
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. Default: `100` Example: `95`		optional
`maxdischargepower` [W]	Maximum discharge power Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging.		advanced

Configuration example for evcc.yaml

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

Grid meterSolar productionBattery

meters:
    - name: my_grid
      type: template
      template: solplanet-modbus
      usage: grid

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port

meters:
    - name: my_pv
      type: template
      template: solplanet-modbus
      usage: pv

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port

meters:
    - name: my_battery
      type: template
      template: solplanet-modbus
      usage: battery

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      battery: # Battery number, [1, 2]
      maxchargepower: # Maximum charge power (W), Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power.
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. (optional)
      maxdischargepower: # Maximum discharge power (W), Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging. (optional)