diff --git a/source/_components/homematicip_cloud.markdown b/source/_components/homematicip_cloud.markdown index 6d817784386..93b3c972e07 100644 --- a/source/_components/homematicip_cloud.markdown +++ b/source/_components/homematicip_cloud.markdown @@ -144,7 +144,74 @@ authtoken: * Weather Sensor – plus (*HmIP-SWO-PL*) * Weather Sensor – pro (*HmIP-SWO-PR*) -Additional info: +## Services + +- `homematicip_cloud.activate_eco_mode_with_duration`: Activate eco mode with duration. +- `homematicip_cloud.activate_eco_mode_with_period`: Activate eco mode with period. +- `homematicip_cloud.activate_vacation`: Activates the vacation mode until the given time. +- `homematicip_cloud.deactivate_eco_mode`: Deactivates the eco mode immediately. +- `homematicip_cloud.deactivate_vacation`: Deactivates the vacation mode immediately. + +### Service Examples + +`accesspoint_id` (SGTIN) is optional for all services and only relevant if you have multiple Homematic IP Accesspoints connected to HA. If empty, service will be called for all configured Homematic IP Access Points. +The `accesspoint_id` (SGTIN) can be found on top of the integration page, or on the back of your Homematic IP Accesspoint. + +Activate eco mode with duration. + +```yaml +... +action: + service: homematicip_cloud.activate_eco_mode_with_duration + data: + duration: 60 + accesspoint_id: 3014xxxxxxxxxxxxxxxxxxxx +``` + +Activate eco mode with period. + +```yaml +... +action: + service: homematicip_cloud.activate_eco_mode_with_period + data: + endtime: 2019-09-17 18:00 + accesspoint_id: 3014xxxxxxxxxxxxxxxxxxxx +``` + +Activates the vacation mode until the given time. + +```yaml +... +action: + service: homematicip_cloud.activate_vacation + data: + endtime: 2019-09-17 18:00 + temperature: 18.5 + accesspoint_id: 3014xxxxxxxxxxxxxxxxxxxx +``` + +Deactivates the eco mode immediately. + +```yaml +... +action: + service: homematicip_cloud.deactivate_eco_mode + data: + accesspoint_id: 3014xxxxxxxxxxxxxxxxxxxx +``` + +Deactivates the vacation mode immediately. + +```yaml +... +action: + service: homematicip_cloud.deactivate_vacation_mode + data: + accesspoint_id: 3014xxxxxxxxxxxxxxxxxxxx +``` + +## Additional info Push button devices are only available with a battery sensor. This is due to a limitation of the vendor API (eq3). It's not possible to detect a key press event on these devices at the moment.