# Homematic IP

Source: https://docs.evcc.io/en/meters/homematic-ip

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| host | IP address or hostname | 192.0.2.2 |  |
| device | Device address/Serial number Homematic device id like shown in the CCU web user interface. | 0001EE89AAD848 |  |
| meterchannel | Meter channel number Homematic meter channel number like shown after the device id separated with a colon in the CCU web user interface. | 6 |  |
| user | Username e.g. email address, user id, etc. |  |  |
| password | Password Service account password |  |  |
| cache | XML-RPC API cache duration In case of duty cycle problems try a cache setting of 30s. | 1s | advanced |

## Configuration example for evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: homematic
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      device: 0001EE89AAD848 # Device address/Serial number, Homematic device id like shown in the CCU web user interface.
      meterchannel: 6 # Meter channel number, Homematic meter channel number like shown after the device id separated with a colon in the CCU web user interface.
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      cache: 1s # XML-RPC API cache duration, In case of duty cycle problems try a cache setting of 30s. (optional)
```

```yaml
meters:
    - name: my_pv
      type: template
      template: homematic
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      device: 0001EE89AAD848 # Device address/Serial number, Homematic device id like shown in the CCU web user interface.
      meterchannel: 6 # Meter channel number, Homematic meter channel number like shown after the device id separated with a colon in the CCU web user interface.
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      cache: 1s # XML-RPC API cache duration, In case of duty cycle problems try a cache setting of 30s. (optional)
```

```yaml
meters:
    - name: my_charger
      type: template
      template: homematic
      usage: charge
      host: 192.0.2.2 # IP address or hostname
      device: 0001EE89AAD848 # Device address/Serial number, Homematic device id like shown in the CCU web user interface.
      meterchannel: 6 # Meter channel number, Homematic meter channel number like shown after the device id separated with a colon in the CCU web user interface.
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      cache: 1s # XML-RPC API cache duration, In case of duty cycle problems try a cache setting of 30s. (optional)
```