From 5ebb8757eba9017ba495b42faf7b3bd087c65d05 Mon Sep 17 00:00:00 2001 From: Jan Bouwhuis Date: Sun, 18 Dec 2022 17:43:43 +0100 Subject: [PATCH] Add to HACS default, update docs (#22) * Add to HACS default, update docs * Remove manual adding repo via HACS --- README.md | 13 +++++----- custom_components/elro_connects/manifest.json | 2 +- info.md | 24 +++++++++++++------ version | 2 +- 4 files changed, 25 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index ef26eec..afcc0e1 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ The Elro Connects integration will allow users to integrate their Elro Connects > There is also a K2 connector available, but this K2 connector will not work with this software. -The integration 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 prodycs 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 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 prodycs 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.** @@ -42,11 +42,10 @@ The `siren` platform (for enabling a test alarm) was tested and is supported for ### Using HACS 1. Install the [Home Assistant Community Store (HACS)](https://hacs.xyz/docs/setup/download). -2. Add Elro Connects as custom repository. See [the HACS FAQ](https://hacs.xyz/docs/faq/custom_repositories) and add `https://github.com/jbouwh/ha-elro-connects` as repository. -3. Select `integration` as category. -4. After this you should be able to add, download and install Elro Connects as a custom integration via HACS. -5. When the installation via HACS is done, restart Home Assistant. -6. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Elro Connects" +2. Select `integration` as category and click `+` to add an integration. +3. Find and install install Elro Connects via HACS. +4. When the installation via HACS is done, restart Home Assistant. +5. In the HA UI go to `Configuration` -> `Integrations` click `+` and search for `Elro Connects` ### Manual @@ -56,7 +55,7 @@ The `siren` platform (for enabling a test alarm) was tested and is supported for 4. Download _all_ the files from the `custom_components/elro_connects/` directory (folder) in this repository. 5. Place the files you downloaded in the new directory (folder) you created. 6. Restart Home Assistant -7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Elro Connects" +7. In the HA UI go to `Configuration` -> `Integrations` click `+` and search for `Elro Connects` Using your HA configuration directory (folder) as a starting point you should now also have something like this: diff --git a/custom_components/elro_connects/manifest.json b/custom_components/elro_connects/manifest.json index 20816e7..52fa638 100644 --- a/custom_components/elro_connects/manifest.json +++ b/custom_components/elro_connects/manifest.json @@ -7,5 +7,5 @@ "requirements": ["lib-elro-connects==0.5.4"], "codeowners": ["@jbouwh"], "iot_class": "local_polling", - "version": "0.1.11" + "version": "0.1.12" } diff --git a/info.md b/info.md index 0cf0d2f..9a080dd 100644 --- a/info.md +++ b/info.md @@ -1,12 +1,19 @@ [![GitHub Release][releases-shield]][releases] -[![GitHub Activity][commits-shield]][commits] -[![License][license-shield]][license] +[![License][license-shield]][LICENCE] [![hacs][hacsbadge]][hacs] -[![Project Maintenance][maintenance-shield]][user_profile] +![Project Maintenance][maintenance-shield] [![Community Forum][forum-shield]][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 prodycs 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 @@ -27,6 +34,8 @@ The `device_state` sensor can have of the following states: 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](https://github.com/jbouwh/lib-elro-connects/issues/new) if a new state needs to be supported. 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_strength`sensors are not enabled by default. {% if not installed %} @@ -50,13 +59,14 @@ The `siren` platform (for enabling a test alarm) was tested and is supported for [commits-shield]: https://img.shields.io/github/commit-activity/y/jbouwh/ha-elro-connects.svg?style=for-the-badge [commits]: https://github.com/jbouwh/ha-elro-connects/commits/main [hacs]: https://hacs.xyz -[hacsbadge]: https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge +[hacsbadge]: https://img.shields.io/badge/HACS-Default-orange.svg?style=for-the-badge [exampleimg]: example.png [forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge [forum]: https://community.home-assistant.io/ [license]: https://github.com/jbouwh/ha-elro/connects/blob/main/LICENSE -[license-shield]: https://img.shields.io/github/license/jbouwh/ha-elro/connects.svg?style=for-the-badge -[maintenance-shield]: https://img.shields.io/badge/maintainer-Jan%20Bouwhuis%20%40jbouwh-blue.svg?style=for-the-badge +[license-shield]: https://img.shields.io/github/license/jbouwh/ha-elro-connects.svg?style=for-the-badge + +[maintenance-shield]: https://img.shields.io/badge/maintainer-Jan%20Bouwhuis-blue.svg?style=for-the-badge [releases-shield]: https://img.shields.io/github/release/jbouwh/ha-elro/connects.svg?style=for-the-badge -[releases]: https://github.com/jbouwh/ha-elro/connects/releases +[releases]: https://github.com/jbouwh/ha-elro-connects/releases [user_profile]: https://github.com/jbouwh diff --git a/version b/version index 20f4951..0e24a92 100644 --- a/version +++ b/version @@ -1 +1 @@ -0.1.11 +0.1.12