# Homematic IP

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

Supported features: meter

## 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 in the CCU web user interface. | 6 |  |
| switchchannel | Switch/Actor channel number Homematic switch actor channel number like shown in the CCU web user interface. | 3 |  |
| port | XML-RPC server port number | 2010 |  |
| user | Username e.g. email address, user id, etc. |  |  |
| password | Password Service account password |  |  |
| standbypower | Standby power Power values above this value will be considered as charging power and hence status "charging". Negative values deactivate status detection. | 15 W |  |
| cache | XML-RPC API cache duration In case of duty cycle problems try a cache setting of 30s. | 1s | advanced |
| integrateddevice | Integrated device Integrated device. No charging sessions |  | advanced |
| heating | Heating device Shows °C instead of % |  | advanced |
| icon | Icon Will be displayed in the user interface (car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater) |  | advanced |

## Configuration example for evcc.yaml

```yaml
chargers:
    - name: my_smartswitch
      type: template
      template: homematic
      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 in the CCU web user interface.
      switchchannel: 3 # Switch/Actor channel number, Homematic switch actor channel number like shown in the CCU web user interface.
      port: 2010 # XML-RPC server port number, optional
      user: # Username, e.g. email address, user id, etc. (optional)
      password: # Password, Service account password (optional)
      standbypower: 15 # Standby power (W), Power values above this value will be considered as charging power and hence status "charging". Negative values deactivate status detection. (optional)
      cache: 1s # XML-RPC API cache duration, In case of duty cycle problems try a cache setting of 30s. (optional)
      integrateddevice: # Integrated device, Integrated device. No charging sessions (optional)
      heating: # Heating device, Shows °C instead of % (optional)
      icon: # Icon, Will be displayed in the user interface [car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater] (optional)
```