Skip to content

Latest commit

 

History

History
69 lines (50 loc) · 4.33 KB

info.md

File metadata and controls

69 lines (50 loc) · 4.33 KB

GitHub Release License

hacs Project Maintenance

Community Forum

Elro Connects K1

The Elro Connects integration will allow users to integrate their Elro Connects fire, heat, CO, water, or smoke alarms as a siren entity into Home Assistant. The alarms can be tested (and silenced) through the siren turn on (and turn off) services. The integration discovers entities (automatically) through an Elro Connects K1 connector plug. The entity names assigned in the Elro Connects app will be synced with Home Assistant.

There is also a K2 connector available, but this K2 connector will not work with this software.

The integration only supports the Elro Connects K1 connector (SF40GA) mainly sold in Germany, the Netherlands, Belgium and France. The manufactor of this connector is Siterwell, and its products are also sold under the name FamilyWell Smart Security EcoSystem (gateway product GS188A). This integration support the legacy gateway, not the new generation that is working via Tuya using a zigbee gateway. The integration is not tested with the Siterwell branded devices, but some user reports indicate this is working too.

This component will set up the following platforms.

Platform Description
sensor Adds a device state sensor, a battery level sensor and a signal sensor (disabled by default) for each device.
siren Represents Elro Connects alarms as a siren. Turn the siren ON to test it. Turn it OFF to silence the (test) alarm.

The device_state sensor can have of the following states:

  • fault
  • silence
  • test_alarm
  • fire_alarm
  • alarm
  • normal
  • unknown
  • offline

Note that the sensors are polled about every 15 seconds. So it might take some time before an alarm state will be propagated. If an unknown state is found that is not supported yet, the hexadecimal code will be assigned as state. Please open an issue here if a new state needs to be supported.

If the name of the device is changed in HA, it is also updated in the Elro Connects app. Note the name has a 15 character length limit.

The siren platform (for enabling a test alarm) was tested and is supported for Fire, Heat, CO and Water alarms. Other device might only support a device_state, signal_strength and battery sensor. Note that the device_state and signal_strengthsensors are not enabled by default.

{% if not installed %}

Installation

  1. Click install.
  2. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Elro Connects" and add the integration.
  3. When the installation via HACS is done, restart Home Assistant.

{% endif %}

Configuring the integration

  1. You need the IP-address and your Elro Connects cloud credentials (username and password) to setup the integration. This will get the connector_id and api_key for local access of your connector. After the setup has finished setup, the cloud credentials will not be used during operation.
  2. An alternative is a manual setup. For this you need to fill in the connector_id, leave username and password fields open. which can be obtained from the Elro Connects app. Go to the home tab and click on the settings wheel. Select current connector. A list will be shown with your connectors. The ID starts with ST_xxx....
  3. The API key is probably not needed as long as it is provided by the connector locally. This behavior might change in the future.