2024-11-27 18:57:16 +01:00

3.7 KiB

title description ha_category ha_release ha_iot_class ha_domain ha_platforms ha_integration_type related ha_quality_scale
SCSGate Instructions on how to integrate SCSGate into Home Assistant.
Cover
Hub
Light
Switch
0.13 Local Polling scsgate
cover
light
switch
integration
docs title
/docs/configuration/ Configuration file
legacy

The SCSGate {% term integration %} support the SCSGate device. This a home-brew device allows to interact with the MyHome system from BTicino/Legrande.

There is currently support for the following device types within Home Assistant:

To enable SCSGate in your installation, add the following to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

# Example configuration.yaml entry
scsgate:
  device: PATH_TO_DEVICE

{% configuration %} device: description: The path to your device, e.g., /dev/ttyACM0. required: true type: string {% endconfiguration %}

How to find the scs_id for your devices

The SCSGate integration relies on the scsgate Python module.

This module provides also a command line tool called scs-monitor. This program can be used to find the IDs of your lights, switches and roller shutters and produce the YAML snippet to insert into your {% term "configuration.yaml" %} file.

For more information checkout this section of scsgate's documentation.

Cover

The SCSGate devices can control motorized covers connected to the BTicino MyHome system.

To enable SCSGate covers in your installation, add the following to your {% term "configuration.yaml" %} file:

# Example configuration.yaml entry
cover:
  - platform: scsgate
    devices:
      living_room:
        name: Living Room
        scs_id: XXXXX

{% configuration %} devices: description: A list of devices. required: true type: list keys: slug: description: Slug of the device. required: true type: list keys: name: description: Name to use in the frontend. required: true type: string scs_id: description: The ID of your SCSGate device. required: true type: string {% endconfiguration %}

{% note %} Known limitation: It is not possible to know the current state of the cover. {% endnote %}

Light

The SCSGate device can control lights of the BTicino MyHome system.

To enable SCSGate lights in your installation, add the following to your {% term "configuration.yaml" %} file:

# Example configuration.yaml entry
light:
  - platform: scsgate
    devices:
      living_room:
        name: Living Room
        scs_id: XXXXX

{% configuration %} devices: description: A list of devices with their name to use in the frontend. required: true type: list {% endconfiguration %}

Switch

The SCSGate device can control switches of the BTicino MyHome system.

To enable SCSGate switches in your installation, add the following to your {% term "configuration.yaml" %} file:

# Example configuration.yaml entry
switch:
  - platform: scsgate
    devices:
      living_room:
        scs_id: XXXXX

{% configuration %} devices: description: A list of devices with their name to use in the frontend. required: true type: list {% endconfiguration %}