2.9 KiB
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)