Skip to content
Yandex Smart Home component for Home Assistant
Branch: master
Clone or download
Latest commit c47619b Jun 19, 2019

README.markdown

Yandex Smart Home custom component for Home Assistant

Installation

  1. Update home assistant to 0.93.0 at least
  2. Clone this project into custom_components directory(create if required, path should look like ~/.homeassistant/custom_components/yandex_smart_home)
  3. Configure component via configuration.yaml
  4. Restart home assistant
  5. Create dialog via https://dialogs.yandex.ru/developer/
  6. Add devices via your Yandex app on android/ios

Configuration

Now add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
yandex_smart_home:
  filter:
    include_domains:
      - switch
      - light
    include_entities:
      - media_player.tv
    exclude_entities:
      - light.highlight
  entity_config:
    switch.kitchen:
      name: CUSTOM_NAME_FOR_YANDEX_SMART_HOME
    light.living_room:
      room: LIVING_ROOM

Configuration variables:

yandex_smart_home:
  (map) (Optional) Configuration options for the Yandex Smart Home integration.

  filter:
    (map) (Optional) description: Filters for entities to include/exclude from Yandex Smart Home.
    include_entities:
      (list) (Optional) description: Entity IDs to include.
    include_domains:
      (list) (Optional) Domains to include.
    exclude_entities:
      (list) (Optional) Entity IDs to exclude.
    exclude_domains:
      (list) (Optional) Domains to exclude.

  entity_config:
    (map) (Optional) Entity specific configuration for Yandex Smart Home.
    ENTITY_ID:
      (map) (Optional) Entity to configure.
      name:
        (string) (Optional) Name of entity to show in Yandex Smart Home.
      room:
        (string) (Optional) Associating this device to a room in Yandex Smart Home

Available domains

Currently only on/off and mute/unmute actions implemented, the following domains are available to be used:

  • climate (on/off, temperature, mode, fan speed)
  • cover (on/off = close/open)
  • fan (on/off, fan speed)
  • group (on/off)
  • input_boolean (on/off)
  • light (on/off, brightness, color, color temperature)
  • media_player (on/off, mute/unmute)
  • switch (on/off)
  • vacuum (on/off)

Room/Area support

Entities that have not got rooms explicitly set and that have been placed in Home Assistant areas will return room hints to Yandex Smart Home with the devices in those areas.

Create Dialog

Go to https://dialogs.yandex.ru/developer/ and create smart home dialog.

Field Value
Endpoint URL https://[YOUR HOME ASSISTANT URL:PORT]/api/yandex_smart_home

For account linking add configuration on https://dialogs.yandex.ru/developer/settings/oauth:

Field Value
Client identifier https://social.yandex.net/
API authorization endpoint https://[YOUR HOME ASSISTANT URL:PORT]/auth/authorize
Token Endpoint https://[YOUR HOME ASSISTANT URL:PORT]/auth/token
Refreshing an Access Token https://[YOUR HOME ASSISTANT URL:PORT]/auth/token
You can’t perform that action at this time.