2022-02-23 21:35:38 +01:00

2.8 KiB

title, description, ha_category, ha_release, ha_config_flow, ha_iot_class, ha_codeowners, ha_domain, ha_dhcp, ha_zeroconf, ha_platforms
title description ha_category ha_release ha_config_flow ha_iot_class ha_codeowners ha_domain ha_dhcp ha_zeroconf ha_platforms
Overkiz (by Somfy) Instructions on how to integrate hubs whom use the Overkiz platform with Home Assistant.
Binary Sensor
Button
Climate
Cover
Hub
Light
Lock
Number
Scene
Select
Sensor
Siren
Switch
2022.2 true Cloud Polling
@imicknl
@vlebourl
@tetienne
overkiz true true
binary_sensor
button
diagnostics
climate
cover
light
lock
number
scene
sensor
select
siren
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.

Supported hubs

  • Atlantic Cozytouch
  • Hitachi Hi Kumo
  • Nexity Eugénie
  • Rexel Energeasy Connect
  • Somfy Connexoon IO
  • Somfy Connexoon RTS
  • Somfy TaHoma
  • Somfy TaHoma Switch (instructions)
  • Thermor Cozytouch

If you own a Somfy hub, you could also use the Somfy integration which uses the official API.

TaHoma Switch

Multiple users reported that the TaHoma Switch will work with this integration after you create a scene in the TaHoma app and wait for a few hours.

Supported devices

Over 6000 devices from 60 brands are compatible with the Overkiz platform. This integration will retrieve your devices and map them to the relevant Home Assistant platforms.

{% include integrations/config_flow.md %}

Known limitations

Z-Wave, Hue and Sonos not supported

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

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.

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 the Velux integration which has a local API.

Local API via HomeKit Controller

If your hub (e.g. Somfy TaHoma) supports HomeKit natively, your setup code will be added as a sensor in Home Assistant. Look up your hub in Home Assistant and retrieve the value from the 'HomeKit Setup Code' sensor. You can now configure the HomeKit Controller integration in Home Assistant and benefit from local support.