HomematicIP Cloud


The HomematicIP component platform is used as an interface to the cloud server. Since there is no official documentation about this API, everything was done via reverse engineering. The homematicip-rest-api is used for communicating. Use at your own risk.

There is currently support for the following device types within Home Assistant:

  • Alarm
  • Binary Sensor
  • Climate
  • Cover
  • Light
  • Sensor
  • Switch
  • Weather

Setup the component via the frontend

Menu: Configuration -> Integrations

Fill the form:

  • Your access point ID (SGTIN)
  • Optional a name to identify your access point, this will be used to prefix your device names.

The authentification token will be generated and stored internally.

Setup the component using the configuration files

Generate the authentication token:

generate_auth_token.py

Add the information to your configuration.yaml file:

homematicip_cloud:
  - accesspoint: IDENTIFIER
    authtoken: AUTHTOKEN
  - name: Location2
    accesspoint: IDENTIFIER2
    authtoken: AUTHTOKEN2

Configuration Variables

name

(string)(Optional)Name to identify your access point, this will be used to prefix your device names.

accesspoint

(string)(Required)This is the access point ID (SGTIN).

authtoken

(string)(Required)Authentication token generated with generate_auth_token.py.

Implemented and tested devices

  • homematicip_cloud.alarm_control_panel
    • Security zones (HmIP-SecurityZone)
  • homematicip_cloud.binary_sensor
    • Window and door contact (HmIP-SWDO, -I)
    • Window Rotary Handle Sensor (HmIP-SRH)
    • Smoke sensor and alarm (HmIP-SWSD)
    • Motion Detector with Brightness Sensor - indoor (HmIP-SMI)
    • Motion Detector with Brightness Sensor - outdoor (HmIP-SMO)
    • Water Sensor (HmIP-SWD)
  • homematicip_cloud.climate
    • Heating-Thermostat Radiator with Display (HmIP-eTRV,-2) - should also work with (HmIP-eTRV-2-UK, -B, -B1, -C)
    • Climate group (HmIP-HeatingGroup)
    • This includes temperature/humidity measures for climate devices of a room delivered by:
      • Wall-mounted thermostat (HmIP-WTH, WTH-2)
      • Brand Wall-mounted thermostat (HmIP-BWTH, BWTH-24)
      • Radiator thermostat (HmIP-eTRV,-2) - should also work with (HmIP-eTRV-2-UK, -B, -B1, -C)
      • Temperature and humidity sensor (HmIP-STH)
      • Temperature and humidity Sensor with display (HmIP-STHD)
  • homematicip_cloud.cover
    • Blind actuator for brand switches (HmIP-BBL)
    • Shutter actuator brand-mount (HmIP-BROLL)
    • Shutter actuator flush-mount (HmIP-FROLL)
  • homematicip_cloud.light
    • Switch actuator and meter for brand switches (HmIP-BSM)
    • Dimming actuator for brand switches (HmIP-BDT)
    • Dimming actuator flush-mount (HmIP-FDT)
    • Switch Actuator and Meter – flush-mount (HmIP-FSM)
    • Switch Actuator for brand switches – with signal lamp (HmIP-BSL)
  • homematicip_cloud.sensor
    • Cloud Access point duty-cycle (HmIP-HAP, -B1)
    • Wall Mounted Thermostat Pro with Display (HmIP-WTH, WTH2)
    • Temperature and Humidity Sensor without display - indoor (HmIP-STH)
    • Temperature and Humidity Sensor with display - indoor (HmIP-STHD)
    • Temperature and Humidity sensor - outdoor (HmIP-STHO, -A)
    • Motion Detector with Brightness Sensor - indoor (HmIP-SMI)
    • Motion Detector with Brightness Sensor - outdoor (HmIP-SMO)
    • Light Sensor - outdoor (HmIP-SLO)
  • homematicip_cloud.switch
    • Pluggable Switch (HmIP-PS)
    • Pluggable Switch and Meter (HmIP-PSM) - should also work with (HmIP-PSM-CH, -IT, -UK, -PE)
    • Switch Actuator for brand switches – with signal lamp (HmIP-BSL)
    • Open Collector Module Receiver - 8x (HmIP-MOD-OC8)
    • Multi IO Box - 2x (HmIP-MIOB)
  • homematicip_cloud.weather
    • Weather Sensor – basic (HmIP-SWO-B)
    • Weather Sensor – plus (HmIP-SWO-PL)
    • Weather Sensor – pro (HmIP-SWO-PR)