home-assistant.io/source/_components/homematicip_cloud.markdown
2019-02-13 18:04:19 +01:00

2.9 KiB
Raw Blame History

layout title description date sidebar comments sharing footer logo ha_category ha_iot_class ha_release featured
page HomematicIP Cloud Instructions for integrating HomematicIP into Home Assistant. 2018-04-02 13:40 true false true true homematicip_cloud.png Hub Cloud Push 0.66 false

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.

{% linkable_title 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.

{% linkable_title 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 %} name: required: false description: Name to identify your access point, this will be used to prefix your device names. type: string accesspoint: required: true description: This is the access point ID (SGTIN). type: string authtoken: required: true description: "Authentication token generated with generate_auth_token.py." type: string {% endconfiguration %}

{% linkable_title Implemented and tested devices %}

  • homematicip_cloud.alarm_control_panel

    • Security zones (HmIP-SecurityZone)
  • homematicip_cloud.binary_sensor

    • Window and door contact (HmIP-SWDO, HmIP-SWDO-I)
    • 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)
    • Switch Actuator for brand switches with signal lamp (HmIP-BSL)
  • 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)
    • Light sensor Outdoor (HmIP-SLO)
  • homematicip_cloud.switch

    • Pluggable Switch and Meter (HmIP-PSM)
    • Full flush Switch and Meter (HmIP-FSM, HmIP-FSM16)