Skip to content
EN | DE

FoxESS MQ2200

This page shows the nightly version. Switch to the release version.

Supported features

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

Usage areas

  • Grid meter
  • Solar production
  • Battery

Parameters

Modbus
NameDescriptionValueLevel
idModbus ID
Default: 1
intrequired
deviceDevice name

USB-RS485 adapter

Example: /dev/ttyUSB0
required
baudrateBaudrate
Default: 9600
required
comsetComSet

Communication parameter for the adapter

Default: 8N1
required
hostIP address or hostname
Example: 192.0.2.2
required
portPort
Default: 502
intrequired
minsoc [%]Minimum charge

Lower limit as configured on the battery system. Used by optimizer.

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

Upper limit as configured on the battery system. Used by optimizer and for grid charging.

Default: 100
Example: 95
optional
maxchargepower [W]Maximum charge power

For forced charging of the battery.

Default: 1200
optional
maxdischargepower [W]Maximum discharge power

Maximum discharge power of the storage.

Default: 800
optional
capacity [kWh]Battery capacity
Default: 2.11
Example: 50
optional
maxacpower [W]Maximum AC power of the hybrid inverter
Default: 800
Example: 5000
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: fox-ess-avocado
usage: grid
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter
# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: # Hostname
port: 502 # Port
# Modbus TCP
modbus: tcpip
id: 1
host: # Hostname
port: 502 # Port
meters:
- name: my_pv
type: template
template: fox-ess-avocado
usage: pv
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter
# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: # Hostname
port: 502 # Port
# Modbus TCP
modbus: tcpip
id: 1
host: # Hostname
port: 502 # Port
maxacpower: 800 # Maximum AC power of the hybrid inverter (W), optional
meters:
- name: my_battery
type: template
template: fox-ess-avocado
usage: battery
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 1
device: /dev/ttyUSB0 # USB-RS485 Adapter Adresse
baudrate: 9600 # Prüfe die Geräteeinstellungen, typische Werte sind 9600, 19200, 38400, 57600, 115200
comset: "8N1" # Kommunikationsparameter für den Adapter
# RS485 via TCP/IP (Modbus RTU)
modbus: rs485tcpip
id: 1
host: # Hostname
port: 502 # Port
# Modbus TCP
modbus: tcpip
id: 1
host: # Hostname
port: 502 # Port
minsoc: 10 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer.
maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and for grid charging.
maxchargepower: 1200 # Maximum charge power (W), For forced charging of the battery.
maxdischargepower: 800 # Maximum discharge power (W), Maximum discharge power of the storage.
capacity: 2.11 # Battery capacity (kWh), optional