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.

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)
    • Rotary Handle Sensor (HmIP-SRH)
    • Smoke sensor and alarm (HmIP-SWSD)
    • Motion detectors (HmIP-SMI)
    • Motion detectors and push button (HmIP-SMI55)
    • Water detector (HmIP-SWD)
  • homematicip_cloud.climate
    • Radiator thermostat (HmIP-eTRV,-2)
    • Climate group (HmIP-HeatingGroup)
  • homematicip_cloud.light
    • Switch actuator and meter for brand switches (HmIP-BSM)
    • Dimming actuator for brand switches (HmIP-BDT)
  • homematicip_cloud.sensor
    • Accesspoint duty-cycle (HmIP-HAP)
    • Wall-mounted thermostat (HmIP-WTH)
    • Temperature and humidity sensor (HmIP-STH)
    • Temperature and humidity Sensor with display (HmIP-STHD)
    • Outdoor temperature and humidity sensor (HmIP-STHO)
    • Illuminance sensor (HmIP-SMI, 55)
  • homematicip_cloud.switch
    • Pluggable Switch and Meter (HmIP-PSM)