From 95f9bc2535ca9a28ee97ab7a9a095379a3db61e8 Mon Sep 17 00:00:00 2001 From: Marius Ciotlos Date: Mon, 4 Jun 2018 14:18:31 +0300 Subject: [PATCH 1/3] Updated documentation --- README.md | 33 ++++++++++++++++++++++++++------- 1 file changed, 26 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index df3910593..f796e946f 100644 --- a/README.md +++ b/README.md @@ -2,18 +2,37 @@ # zigbee2mqtt :bridge_at_night: :honeybee: ![Thumbs up or down?](header.png) + -Allows you to use your Zigbee devices **without** the vendors (Xiaomi/TRADFRI/Hue) bridge/gateway. +Allows you to use your Zigbee devices **without** the vendors (Xiaomi/TRADFRI/Hue) bridge or gateway. -It bridges events and allows you to control your Zigbee devices via MQTT. In this way you can integrate your Zigbee devices with whatever smart home infrastructure you are using. Integrates especially well with [Home Assistant](https://www.home-assistant.io/). - -![Architecture](architecture.png) - -See [Supported devices](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-devices) to check wether your device is supported. If it's not listed there support can be added (fairly) easy, see [How to support new devices](https://github.com/Koenkk/zigbee2mqtt/wiki/How-to-support-new-devices). +It bridges events and allows you to control your Zigbee devices via MQTT. In this way you can integrate your Zigbee devices with whatever smart home infrastructure you are using. The [wiki](https://github.com/Koenkk/zigbee2mqtt/wiki) provides you all the information needed to get up and running! -### Contributors +## Integrations +Below you will find the most popular home automation integrations available for **zigbee2mqtt**. + + + +### [Home Assistant](https://www.home-assistant.io/) +- [Hassio](https://www.home-assistant.io/hassio/): Using [the official addon](https://github.com/danielwelch/hassio-zigbee2mqtt) from [danielwelch](https://github.com/danielwelch) +- Generic install or Hassbian: Using instructions [here](https://github.com/Koenkk/zigbee2mqtt/wiki/Running-the-bridge#2-installing) + +--- + +## Architecture +![Architecture](architecture.png) + +## Supported devices +See [Supported devices](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-devices) to check wether your device is supported. There is quite an extensive list including devices from vendors like Xiaomi, Ikea, Philips, OSRAM and more. + +If it's not listed in [Supported devices](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-devices), support can be added (fairly) easy, see [How to support new devices](https://github.com/Koenkk/zigbee2mqtt/wiki/How-to-support-new-devices). + +## Support & help +If you need assistantce you can check [opened issues](https://github.com/Koenkk/zigbee2mqtt/issues). Feel free to help with Pull Requests when you were able to fix things or add new devices or just share the love on social media. + +## Contributors * [AndrewLinden](https://github.com/AndrewLinden) * [oskarn97](https://github.com/oskarn97) * [dgomes](https://github.com/dgomes) From 54342f6fe9ca77f900bde5d1e9f783d362fb0309 Mon Sep 17 00:00:00 2001 From: Koen Kanters Date: Mon, 4 Jun 2018 17:23:47 +0200 Subject: [PATCH 2/3] Update README.md --- README.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index f796e946f..c0bf9d382 100644 --- a/README.md +++ b/README.md @@ -11,15 +11,13 @@ It bridges events and allows you to control your Zigbee devices via MQTT. In thi The [wiki](https://github.com/Koenkk/zigbee2mqtt/wiki) provides you all the information needed to get up and running! ## Integrations -Below you will find the most popular home automation integrations available for **zigbee2mqtt**. +Zigbee2mqtt integrates well with (almost) every home automation solution because it uses MQTT. However the following integrations are woth mentioning: ### [Home Assistant](https://www.home-assistant.io/) - [Hassio](https://www.home-assistant.io/hassio/): Using [the official addon](https://github.com/danielwelch/hassio-zigbee2mqtt) from [danielwelch](https://github.com/danielwelch) -- Generic install or Hassbian: Using instructions [here](https://github.com/Koenkk/zigbee2mqtt/wiki/Running-the-bridge#2-installing) - ---- +- Generic install or Hassbian: Using instructions [here](https://github.com/Koenkk/zigbee2mqtt/wiki/Integrating-with-Home-Assistant) ## Architecture ![Architecture](architecture.png) @@ -37,4 +35,4 @@ If you need assistantce you can check [opened issues](https://github.com/Koenkk/ * [oskarn97](https://github.com/oskarn97) * [dgomes](https://github.com/dgomes) * [Koenkk](https://github.com/Koenk) -* [kirovilya](https://github.com/kirovilya) \ No newline at end of file +* [kirovilya](https://github.com/kirovilya) From eab7665726c3b4228f9943c85c8ea0f1d1414001 Mon Sep 17 00:00:00 2001 From: Koen Kanters Date: Mon, 4 Jun 2018 17:25:39 +0200 Subject: [PATCH 3/3] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c0bf9d382..7be12fb96 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ See [Supported devices](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-dev If it's not listed in [Supported devices](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-devices), support can be added (fairly) easy, see [How to support new devices](https://github.com/Koenkk/zigbee2mqtt/wiki/How-to-support-new-devices). ## Support & help -If you need assistantce you can check [opened issues](https://github.com/Koenkk/zigbee2mqtt/issues). Feel free to help with Pull Requests when you were able to fix things or add new devices or just share the love on social media. +If you need assistance you can check [opened issues](https://github.com/Koenkk/zigbee2mqtt/issues). Feel free to help with Pull Requests when you were able to fix things or add new devices or just share the love on social media. ## Contributors * [AndrewLinden](https://github.com/AndrewLinden)