jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-06-01 15:56:49 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_components/homematicip_cloud.markdown
saepfle b6f595e3f3 Update homematicip_cloud.markdown (#8864) 
* Update homematicip_cloud.markdown

* Update source/_components/homematicip_cloud.markdown

Co-Authored-By: saepfle <42702704+saepfle@users.noreply.github.com>

* ✏️ Tweak
2019-03-24 16:08:47 +01:00

4.6 KiB
Raw Blame History

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_iot_class, ha_release, redirect_from
layout title description date sidebar comments sharing footer logo ha_category ha_iot_class ha_release redirect_from
page HomematicIP Cloud Instructions for integrating HomematicIP into Home Assistant. 2018-04-02 13:40 true false true true homematicip_cloud.png
Hub
Alarm
Binary Sensor
Climate
Cover
Light
Sensor
Switch
Cloud Push 0.66
/components/alarm_control_panel.homematicip_cloud/
/components/binary_sensor.homematicip_cloud/
/components/climate.homematicip_cloud/
/components/cover.homematicip_cloud/
/components/light.homematicip_cloud/
/components/sensor.homematicip_cloud/
/components/switch.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

{% 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, -I)
    • Window Rotary Handle Sensor (HmIP-SRH)
    • Smoke sensor and alarm (HmIP-SWSD)
    • Motion Detector with Brightness Sensor - indoor (HmIP-SMI)
    • 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)
    • 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)

  • homematicip_cloud.weather

    • Weather Sensor – basic (HmIP-SWO-B)
    • Weather Sensor – plus (HmIP-SWO-PL)
    • Weather Sensor – pro (HmIP-SWO-PR)