# Atmoce MG100 M-gateway

Source: https://docs.evcc.io/en/meters/atmoce-mg100-m-gateway

Support for Atmoce MG100 (included with MC100 and MC100-T).
Requires installer to enable Modbus TCP in configuration or through Atmozen app; available in firmware 01.01.00.18.10 or later.
'Grid Recharging' and 'Export Power' must be enabled in the Atmozen app to allow battery (dis)charging to/from grid.

Supported features: battery-control, curtail, dim

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| modbus | Modbus Type (tcpip) |  |  |
| firmware | Firmware version Firmware 01.01.00.28.15 and higher allows for correct hold/holdcharge functionality, dimming and curtailing. Older versions only support hold function without (dis)charge. (<01.01.00.28.15, >=01.01.00.28.15) | <01.01.00.28.15 |  |
| maxacpower | Maximum AC power of the hybrid inverter | 0 W | advanced |
| minsoc | Minimum charge Lower limit as configured on the battery system. Used by optimizer. | 10 % | advanced |
| maxsoc | Maximum charge Upper limit as configured on the battery system. Used by optimizer and for grid charging. | 100 % | advanced |

## Configuration example for evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: atmoce
      usage: grid
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      firmware: <01.01.00.28.15 # Firmware version, Firmware 01.01.00.28.15 and higher allows for correct hold/holdcharge functionality, dimming and curtailing. Older versions only support hold function without (dis)charge. [<01.01.00.28.15, >=01.01.00.28.15]
```

```yaml
meters:
    - name: my_pv
      type: template
      template: atmoce
      usage: pv
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      firmware: <01.01.00.28.15 # Firmware version, Firmware 01.01.00.28.15 and higher allows for correct hold/holdcharge functionality, dimming and curtailing. Older versions only support hold function without (dis)charge. [<01.01.00.28.15, >=01.01.00.28.15]
      maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional
```

```yaml
meters:
    - name: my_battery
      type: template
      template: atmoce
      usage: battery
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      firmware: <01.01.00.28.15 # Firmware version, Firmware 01.01.00.28.15 and higher allows for correct hold/holdcharge functionality, dimming and curtailing. Older versions only support hold function without (dis)charge. [<01.01.00.28.15, >=01.01.00.28.15]
      minsoc: 10 # 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 for grid charging. (optional)
```