Skip to content

Commit

Permalink
Add to HACS default, update docs (#22)
Browse files Browse the repository at this point in the history
* Add to HACS default, update docs

* Remove manual adding repo via HACS
  • Loading branch information
jbouwh authored Dec 18, 2022
1 parent ad031d3 commit 5ebb875
Show file tree
Hide file tree
Showing 4 changed files with 25 additions and 16 deletions.
13 changes: 6 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.**
Expand Down Expand Up @@ -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

Expand All @@ -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:

Expand Down
2 changes: 1 addition & 1 deletion custom_components/elro_connects/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
}
24 changes: 17 additions & 7 deletions info.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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 %}

Expand All @@ -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
2 changes: 1 addition & 1 deletion version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.1.11
0.1.12

0 comments on commit 5ebb875

Please sign in to comment.