Skip to content
EN | DE

M-TEC Energy Butler GEN3

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
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: mtec-eb-gen3
usage: grid
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 255
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: 255
host: # Hostname
port: 502 # Port
# Modbus TCP
modbus: tcpip
id: 255
host: # Hostname
port: 502 # Port
meters:
- name: my_pv
type: template
template: mtec-eb-gen3
usage: pv
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 255
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: 255
host: # Hostname
port: 502 # Port
# Modbus TCP
modbus: tcpip
id: 255
host: # Hostname
port: 502 # Port
meters:
- name: my_battery
type: template
template: mtec-eb-gen3
usage: battery
# RS485 via adapter (Modbus RTU)
modbus: rs485serial
id: 255
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: 255
host: # Hostname
port: 502 # Port
# Modbus TCP
modbus: tcpip
id: 255
host: # Hostname
port: 502 # Port
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)