Address late feedback of Overkiz integration (#20841) (#20881)

This commit is contained in:
Mick Vleeshouwer 2022-01-24 04:46:16 -08:00 committed by GitHub
parent 365dadd935
commit 29102ea6f4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -2,17 +2,17 @@
title: Overkiz (by Somfy)
description: Instructions on how to integrate hubs whom use the Overkiz platform with Home Assistant.
ha_category:
- Hub
- Sensor
- Binary Sensor
- Button
- Hub
- Light
- Lock
- Number
- Light
- Scene
- Binary Sensor
- Switch
- Select
ha_release: 2022.1.0
- Sensor
- Switch
ha_release: 2022.2
ha_config_flow: true
ha_iot_class: Cloud Polling
ha_codeowners:
@ -21,18 +21,18 @@ ha_codeowners:
- '@vlebourl'
ha_domain: overkiz
ha_platforms:
- sensor
- binary_sensor
- button
- light
- lock
- number
- light
- scene
- binary_sensor
- switch
- select
- sensor
- switch
---
The Overkiz (by Somfy) integration platform is used by many different vendors, like Somfy, Hitachi and Atlantic. This integration will allow users to integrate their devices into Home Assistant using the Overkiz API.
The Overkiz (by Somfy) integration platform is used by many different vendors, like Somfy, Hitachi, and Atlantic. This integration will allow users to integrate their devices into Home Assistant using the Overkiz API.
## Supported hubs
@ -62,21 +62,17 @@ Over 6000 devices from 60 brands are compatible with the Overkiz platform. This
### Z-Wave, Hue and Sonos not supported
Even though most Overkiz hubs supports adding Z-Wave, Hue and Sonos devices, this isn't supported in the Overkiz integration. All these platforms have native integrations in Home Assistant which are more stable and feature rich.
Even though most Overkiz hubs support adding Z-Wave, Hue, and Sonos devices, this isn't supported in the Overkiz integration. All these platforms have native integrations in Home Assistant which are more stable and feature-rich.
### Overkiz API limits
**Execution queue is full on gateway: #xxxx-xxxx-xxxx (soft limit: 10)**
The Overkiz has a limit of 10 actions that can be executed in parallel. Currently this can only be solved by adding a time-out in between your executions, where you need to take the execution time into account.
**Server busy, please try again later. (Too many executions)**
During peak hours, it could happen that the Overkiz platform is unable to execute your command. The integration will try to retry this command, however this is not guaranteed to succeed.
During peak hours, it could happen that the Overkiz platform is unable to execute your command. The integration will try to retry this command, however, this is not guaranteed to succeed.
### Internet connectivity required
This integration communicates via the cloud based Overkiz API, since Overkiz doesn't expose a local API on their hubs. If you are only using Somfy IO compatible devices, you could purchase a Velux KLF200 hub and use to [the Velux integration](/integrations/velux/) which has a local API.
This integration communicates via the cloud-based Overkiz API, since Overkiz doesn't expose a local API on their hubs. If you are only using Somfy IO compatible devices, you could purchase a Velux KLF200 hub and use [the Velux integration](/integrations/velux/) which has a local API.
#### Local API via HomeKit Controller