From 43817feea4fb0992b5838d83a94aa804a7438fe5 Mon Sep 17 00:00:00 2001 From: tronikos Date: Mon, 27 Mar 2023 18:55:04 -0700 Subject: [PATCH 1/6] Update harmony.markdown (#26750) --- source/_integrations/harmony.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/harmony.markdown b/source/_integrations/harmony.markdown index cf60473840a..53b7631ebcf 100644 --- a/source/_integrations/harmony.markdown +++ b/source/_integrations/harmony.markdown @@ -21,7 +21,7 @@ ha_platforms: ha_integration_type: integration --- -The `harmony` remote platform allows you to control the state of your [Harmony Hub Device](https://support.myharmony.com/hub). +The `harmony` integration allows you to control the state of your [Harmony Hub Device](https://support.myharmony.com/hub). Supported units: From f5b6aac0758bc594492831baeea1d5e34c083660 Mon Sep 17 00:00:00 2001 From: Chris Carini <6374067+ChrisCarini@users.noreply.github.com> Date: Mon, 27 Mar 2023 23:18:59 -0700 Subject: [PATCH 2/6] fixing typo (#26751) --- source/_integrations/androidtv.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/androidtv.markdown b/source/_integrations/androidtv.markdown index c001cf636ac..2e79570a076 100644 --- a/source/_integrations/androidtv.markdown +++ b/source/_integrations/androidtv.markdown @@ -38,7 +38,7 @@ For Fire TV devices, the instructions are as follows: - From the main (Launcher) screen, select Settings. - Select My Fire TV > About > Network. -If Develper Options is missing from Settings then select My Fire TV and press the button seven times on About. +If Developer Options is missing from Settings then select My Fire TV and press the button seven times on About. {% include integrations/config_flow.md %} From db58e5479ed591f13155973cf0094c39908b7c94 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Tue, 28 Mar 2023 12:03:36 +0200 Subject: [PATCH 3/6] Add links to Matter and HomeKit integrations (#26744) * Add links to Matter and HomeKit integrations * Fix grammar Co-authored-by: Franck Nijhof * Fix header hierarchy and md table * Add subheading - move table further up to make it clear from the get-go that devices are not added by the Thread integration but via the Matter or HomeKit integration * Fix grammar Co-authored-by: Franck Nijhof --------- Co-authored-by: Franck Nijhof --- source/_integrations/thread.markdown | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index d1a623f0c79..6bc0f888cdf 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -16,12 +16,28 @@ ha_zeroconf: true The Thread integration helps you track the different Thread networks in your home and helps you manage their credentials. It is currently a work in progress. -Thread is a low-power mesh networking standard which allows users to connect their devices within a home network. It uses the same RF technology as Zigbee, but provides IP connectivity similar to Wi-Fi. Unlike Zigbee, Thread does not allow to control devices directly: It is just a communication protocol. A higher level protocol such as Matter or HomeKit is required to control Thread enabled devices. Thread allows devices to communicate with each other without the need for a central gateway or router. This makes it ideal for home automation, where a large number of devices may need to be connected. +Thread-based consumer devices use one of the two Home Automation standards: Matter or HomeKit. To add a thread-based device to Home Assistant, use the respective Home Assistant integration: -To connect a Thread network to Home Assistant, Thread Border Routers (TBRs) are used. TBRs are devices that bridge the Thread network to a local Wi-Fi or Ethernet network. To add a TBR to Home Assistant, you can use our [Home Assistant Yellow](/yellow/) hub or the [Home Assistant SkyConnect](/skyconnect/) Zigbee/Thread stick. +| Logo | Home Assistant integration | +| :-------------------------------------------------------------------------: | :--------------------------------:| +| | [Matter](/integrations/Matter/) | +| | [HomeKit](/integrations/homekit/) | -Home Assistant communicates with TBRs over the local network. This means that TBRs do not have to be physically attached to Home Assistant to be used. You might already have a TBR as part of other products in your home, like a Google Nest Hub Gen 2 or Apple HomePod Mini. Each vendor forms their own network when you start using their products, so you can end up having a Home Assistant, an Apple, and a Google Thread network in your home. These are all separate networks using different credentials, which prevents devices to roam between TBRs. -It is possible to align credentials for TBRs from different vendors and have them form a single network together. This allows you to freely move devices between rooms without losing connectivity. To do this, you need to make sure that all TBRs use the same credentials. Sadly, this works differently for each TBR vendor. +## Thread — A communication protocol + +Thread is a low-power mesh networking standard that allows users to connect their devices within a home network. Thread allows devices to communicate with each other without the need for a central controller. This makes it ideal for home automation, where a large number of devices may need to be connected. Thread uses the same RF technology as Zigbee but provides IP connectivity similar to Wi-Fi. Unlike Zigbee, Thread does not allow to control devices directly: It is just a communication protocol. A higher-level protocol, such as Matter or HomeKit, is required to control Thread-enabled devices. To see which home automation standard is supported by your device, check the icon on the packaging. + +## TBRs connect Thread network to Home Assistant + +To connect a Thread network to Home Assistant, Thread border routers (TBRs) are used. TBRs are devices that bridge the Thread network to a local Wi-Fi or Ethernet network. To add a TBR to Home Assistant, you can use our [Home Assistant Yellow](/yellow/) hub or the [Home Assistant SkyConnect](/skyconnect/) Zigbee/Thread stick. + +Home Assistant communicates with TBRs over the local network. This means that TBRs do not have to be physically attached to Home Assistant to be used. You might already have a TBR as part of other products in your home, like a Google Nest Hub Gen 2 or Apple HomePod Mini. + +### Vendor specific Thread networks + +Each vendor forms their own network when you start using their products, so you can end up having a Home Assistant, an Apple, and a Google Thread network in your home. These are all separate networks using different credentials, which prevents devices from roaming between TBRs. + +It is possible to align credentials for TBRs from different vendors and have them form a single network together. This allows you to freely move devices between rooms without losing connectivity. To do this, you need to make sure that all TBRs use the same credentials. Currently, this works differently for each TBR vendor. Home Assistant will sync the Thread credentials with Google when starting to commission a Matter device via the Home Assistant Companion app. For other vendors, if the vendor allows you to see the operational dataset in TLV format, you can import it to Home Assistant from the Thread panel. From 2cee119ea8dc4d7e4204552984f6140b0474289d Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Tue, 28 Mar 2023 13:18:06 +0200 Subject: [PATCH 4/6] Glossary: add Thread (#26754) --- source/_data/glossary.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml index 7502a31d68f..f27072e5f02 100644 --- a/source/_data/glossary.yml +++ b/source/_data/glossary.yml @@ -315,6 +315,14 @@ dynamic actions. link: /docs/automation/templating/ +- term: Thread + definition: >- + Thread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. *Mesh* topology means that the devices can communicate with each other directly, without going through a central controller first. Thread uses the same radio frequency (RF) technology as Zigbee, but provides IP connectivity similar to Wi-Fi. Unlike Zigbee, Thread does not specify how to control devices. How Thread-enabled devices are controlled is specified in a higher level protocol such as HomeKit or Matter. + + link: /integrations/thread/ + excerpt: > + Thread is a low-power mesh networking standard that is specifically designed for smart home applications. It is a protocol that defines how devices communicate. + - term: Trigger definition: >- A trigger is a set of values or conditions of a platform that are defined From bdec26e3eed2bcafb8ac05a96d85f87d41aa4345 Mon Sep 17 00:00:00 2001 From: GoodLug <87616222+GoodLug@users.noreply.github.com> Date: Tue, 28 Mar 2023 14:26:51 +0100 Subject: [PATCH 5/6] Update shell_command.markdown (#26756) Co-authored-by: Franck Nijhof --- source/_integrations/shell_command.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_integrations/shell_command.markdown b/source/_integrations/shell_command.markdown index b32177d30d2..f87c23b844e 100644 --- a/source/_integrations/shell_command.markdown +++ b/source/_integrations/shell_command.markdown @@ -15,6 +15,8 @@ ha_integration_type: integration This integration can expose regular shell commands as services. Services can be called from a [script] or in [automation]. Shell commands aren't allowed for a camel-case naming, please use lowercase naming only and separate the names with underscores. +Note that the shell command process will be terminated after 60 seconds, full stop. There is no option to alter this behavior, this is by design because Home Assistant is not intended to manage long-running external processes. + [script]: /integrations/script/ [automation]: /getting-started/automation/ From 4a72485ace296a4d765ad443e68d90493a491729 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Tue, 28 Mar 2023 17:47:26 +0200 Subject: [PATCH 6/6] Glossary: add Matter (#26755) Co-authored-by: Franck Nijhof --- source/_data/glossary.yml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml index f27072e5f02..852963b503e 100644 --- a/source/_data/glossary.yml +++ b/source/_data/glossary.yml @@ -218,6 +218,13 @@ or RGB color control. link: /integrations/light +- term: Matter + definition: >- + Matter is an open-source standard that defines how to control smart home devices on a Wi-Fi or Thread network. The aim of the standard is to improve security and to make devices interoperable across vendors, replacing proprietary protocols for smart home ecosystems. Unlike other standards, Matter allows joining the same device to multiple controllers. For example, you can add a light to Google Home, Apple Home, and Home Assistant at the same time. A bridge device can be used to connect devices running on other smart home technologies such as Zigbee or Z-Wave. + excerpt: > + Matter is an open-source standard that defines how to control smart home devices on a Wi-Fi or Thread network. + link: /integrations/matter + - term: Notification definition: >- You can use notifications to send messages, pictures, and more, to devices.