Skip to content
Docs
EN | DE

Homematic IP

← Smart switches

Supported features

  • Built-in meter: Support for an integrated meter. Availability may vary between models.

Parameters

NameDescriptionValueLevel
hostIP address or hostname
Example: 192.0.2.2
optional
deviceDevice address/Serial number

Homematic device id like shown in the CCU web user interface.

Example: 0001EE89AAD848
optional
meterchannelMeter channel number

Homematic meter channel number like shown in the CCU web user interface.

Default: 6
Example: HMIP-PSM=6, HMIP-FSM+HMIP-FSM16=5, HM=2
optional
switchchannelSwitch/Actor channel number

Homematic switch actor channel number like shown in the CCU web user interface.

Default: 3
Example: HMIP-PSM=3, HMIP-FSM+HMIP-FSM16=2, HM=1
optional
portXML-RPC server port number
Default: 2010
Example: BidCos-Wired=2000, BidCos-RF=2001, HmIP=2010
optional
userUsername

e.g. email address, user id, etc.

optional
passwordPassword

Service account password

optional
standbypower [W]Standby power

Power values above this value will be considered as charging power and hence status "charging". Negative values deactivate status detection.

Default: 15
optional
cacheXML-RPC API cache duration

In case of duty cycle problems try a cache setting of 30s.

Default: 1s
Example: 5m
advanced
integrateddeviceIntegrated device

Integrated device. No charging sessions

advanced
heatingHeating device

Shows °C instead of %

advanced
iconIcon

Will be displayed in the user interface

advanced
Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

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)