Code Monkey home page Code Monkey logo

ha-tahoma's Introduction

screenshot of a device detail page in Home Assistant hacs_badge GitHub release Open in Visual Studio Code Discord

Overkiz (by Somfy) - Home Assistant

Custom component for Home Assistant to interact with smart devices via the Overkiz platform.

This component builds upon the work of @philklei and is an updated version of the original Tahoma integration in Home Assistant with the goal of eventually merging into core. The installation of this component will replace the original TaHoma integration and thus allows you to beta-test all changes.

Supported hubs

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

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. See #507 for context.

Supported devices

This integration doesn't rely on a hardcoded list of devices anymore, but relies on the characteristics of every device. This means that more devices will be supported out of the box, based on their category, available states and commands. If your device is not supported or working correctly, have a look here.

Installation

You can install this integration via HACS or manually.

HACS

This integration is included in HACS. Search for the Overkiz (by Somfy) integration and choose install. Reboot Home Assistant and configure the 'Overkiz (by Somfy)' integration via the integrations page or press the blue button below.

Open your Home Assistant instance and start setting up a new integration.

Manual

Copy the custom_components/tahoma to your custom_components folder. Reboot Home Assistant and configure the 'Overkiz (by Somfy)' integration via the integrations page or press the blue button below.

Open your Home Assistant instance and start setting up a new integration.

Advanced

Available services

After installation this integration adds new services to Home Assistant which can be used in automations. The new services are:

  • Overkiz (by Somfy): Set cover position with low speed (tahoma.set_cover_position_low_speed, only added if supported by the device)
  • Overkiz (by Somfy): My position (cover) (tahoma.set_cover_my_position)
  • Overkiz (by Somfy): Execute command (tahoma.execute_command)
  • Overkiz (by Somfy): Get execution history (tahoma.get_execution_history)

Enable debug logging

The logger integration lets you define the level of logging activities in Home Assistant. Turning on debug mode will show more information about unsupported devices in your logbook.

logger:
  default: critical
  logs:
    custom_components.tahoma: debug

Device not supported

If your device is not visible in the device list of Home Assistant (/config/devices/dashboard), you need to turn on debug logging. Copy the debug string from your log and create a new issue

DEBUG (MainThread) [custom_components.tahoma] Unsupported TaHoma device (io:DimmableLightIOComponent - Light - DimmableLight).

Device not working correctly

If your device is listed in the device list, create a new issue and fill in all details of the issue template.

In order to gather more information, you can use the tahoma.get_execution_history service which will print your execution history to the Home Assistant log. Run the commands via the official vendor app (e.g. TaHoma) and capture the commands.

2021-01-28 09:20:22 INFO (MainThread) [custom_components.tahoma] 2021-01-27 21:30:00: off executed via Home Assistant on io://xxxx, with [].
2021-01-28 09:20:22 INFO (MainThread) [custom_components.tahoma] 2021-01-27 16:23:29: setIntensity executed via Home Assistant on io://xxxx, with [70].

Exclude devices

The previous version had functionality to exclude devices from Home Assistant. Since we moved to the entity registry, this functionality is now offered by default in Home Assistant core. You can now disable entities via the interface.

Retrieve HomeKit code

If your TaHoma box supports HomeKit natively, the integration will log the HomeKit code on start currently. This is currently an experimental implementation and in order to enable this, you need to have debug logging enabled.

ha-tahoma's People

Contributors

azrael783 avatar dmaasland avatar imicknl avatar jgarec avatar tetienne avatar vlebourl avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.