From 7b4aac84ecd668d4c633f8f08e4c55365e2348b3 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 27 Nov 2025 18:21:42 +0100 Subject: [PATCH 1/7] Thread: migrate to a new adapter --- source/_integrations/thread.markdown | 35 ++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index a846102824cc..933d3216c663 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -201,6 +201,41 @@ Note: the steps and images here show the process with a Google Thread network. B ![image](/images/integrations/thread/thread-ha-preferred.png) - 🎉 You successfully created a Home Assistant Thread network and joined it with a pre-existing third-party network. +## Migrating a Thread network to a new adapter + +follow these steps if you already have a Thread adapter running but want to switch to a new adapter. + +### Prerequisites + +- [Home Assistant Operating System](https://www.home-assistant.io/docs/glossary/#home-assistant-operating-system) installed on your smart home hub. For example: + - on a Home Assistant Green, where Home Assistant OS is preinstalled + - on a Home Assistant Yellow or on a Raspberry Pi +- Existing Thread adapter connected to your Home Assistant hub +- Latest updates installed +- A new Thread adapter and a USB extension cable + - If your adapter supports multiple protocols: + - They might have another firmware installed by default, (Zigbee, for example). + - Check their documentation and install the OpenThread firmware on the adapter. + - Check their documentation and take a note of the baudrate. +- Thread devices + +### To migrate an existing Thread network to a new adapter + +1. Plug the new adapter into the extension cable and plug it into the Home Assistant hub. +2. Go to {% my supervisor_addon title="**Settings** > **Add-ons** > **OpenThread Border Router**" addon="core_openthread_border_router" %} and select the **Configuration** tab. +3. Under **Devices**, select your adapter. +4. Enter the **Baudrate** as specified in the documentation of your adapter. + - If you can't find the baudrate, contact the manufacturer's support. + - If your feeling lucky, try `460800`. + - **Save** your changes. + - **Troubleshooting**: If you see in the logs that the add-on seems to crash, or does not seem to communicate with the Thread integration: Disable the **Hardware flow control** option and try again. +5. Restart the add-on and check the logs. Wait. + - **Info**: Your Thread network is managed by Home Assistant. It is not stored on the adapter. Migrating the adapter means that Home Assistant will start to use your new adapter's radio instead of the old one. +6. Go to {% my integrations title="**Settings** > **Devices & services**" %}, select the **Thread** integration. + - Select the cogwheel {% icon "mdi:cog-outline" %}. + - **Result**: You should now see that the Thread network is still there. +7. If you no longer want to use the old adapter, you can unplug it now. + ## Understanding the Thread configuration page This section explains why you might see multiple networks on the Thread configuration page and what this means for your network. From 713b27a25cb95ee1ca25a1912d819e4ae12e0a37 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 27 Nov 2025 18:33:05 +0100 Subject: [PATCH 2/7] Fix typo --- source/_integrations/thread.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index 933d3216c663..7d9c5f11684d 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -203,7 +203,7 @@ Note: the steps and images here show the process with a Google Thread network. B ## Migrating a Thread network to a new adapter -follow these steps if you already have a Thread adapter running but want to switch to a new adapter. +Follow these steps if you already have a Thread adapter running but want to switch to a new adapter. ### Prerequisites From 973f453aa4c3ffddcbb2f17155e55b2019abd4f0 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 27 Nov 2025 18:36:19 +0100 Subject: [PATCH 3/7] Add troubleshooting step --- source/_integrations/thread.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index 7d9c5f11684d..229c9aadc4c6 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -214,7 +214,7 @@ Follow these steps if you already have a Thread adapter running but want to swit - Latest updates installed - A new Thread adapter and a USB extension cable - If your adapter supports multiple protocols: - - They might have another firmware installed by default, (Zigbee, for example). + - They might have another firmware installed by default (Zigbee, for example). - Check their documentation and install the OpenThread firmware on the adapter. - Check their documentation and take a note of the baudrate. - Thread devices @@ -234,6 +234,7 @@ Follow these steps if you already have a Thread adapter running but want to swit 6. Go to {% my integrations title="**Settings** > **Devices & services**" %}, select the **Thread** integration. - Select the cogwheel {% icon "mdi:cog-outline" %}. - **Result**: You should now see that the Thread network is still there. + - **Troubleshooting**: If you don't see the network there, go back to the add-on configuration and adjust your settings, if needed and try again. 7. If you no longer want to use the old adapter, you can unplug it now. ## Understanding the Thread configuration page From 6ea19e35af0671116b20966ad1d6df74fd0d4086 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 27 Nov 2025 18:38:27 +0100 Subject: [PATCH 4/7] Update source/_integrations/thread.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/thread.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index 229c9aadc4c6..e616987718c7 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -226,7 +226,7 @@ Follow these steps if you already have a Thread adapter running but want to swit 3. Under **Devices**, select your adapter. 4. Enter the **Baudrate** as specified in the documentation of your adapter. - If you can't find the baudrate, contact the manufacturer's support. - - If your feeling lucky, try `460800`. + - If you're feeling lucky, try `460800`. - **Save** your changes. - **Troubleshooting**: If you see in the logs that the add-on seems to crash, or does not seem to communicate with the Thread integration: Disable the **Hardware flow control** option and try again. 5. Restart the add-on and check the logs. Wait. From a0b57ed86e0e2e672d5307b4147b9b310a4bf6fc Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 27 Nov 2025 18:42:46 +0100 Subject: [PATCH 5/7] Tweak --- source/_integrations/thread.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index e616987718c7..0eef93711448 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -228,7 +228,9 @@ Follow these steps if you already have a Thread adapter running but want to swit - If you can't find the baudrate, contact the manufacturer's support. - If you're feeling lucky, try `460800`. - **Save** your changes. - - **Troubleshooting**: If you see in the logs that the add-on seems to crash, or does not seem to communicate with the Thread integration: Disable the **Hardware flow control** option and try again. + - **Troubleshooting**: + - Check the logs. + - If the add-on crashes or fails to communicate with the Thread integration: Disable the **Hardware flow control** option and try again. 5. Restart the add-on and check the logs. Wait. - **Info**: Your Thread network is managed by Home Assistant. It is not stored on the adapter. Migrating the adapter means that Home Assistant will start to use your new adapter's radio instead of the old one. 6. Go to {% my integrations title="**Settings** > **Devices & services**" %}, select the **Thread** integration. From 5e34403189ee35bedc7b403f83e795f3047f047f Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 27 Nov 2025 18:46:25 +0100 Subject: [PATCH 6/7] Update source/_integrations/thread.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/thread.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index 0eef93711448..cba12f39ef92 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -209,7 +209,7 @@ Follow these steps if you already have a Thread adapter running but want to swit - [Home Assistant Operating System](https://www.home-assistant.io/docs/glossary/#home-assistant-operating-system) installed on your smart home hub. For example: - on a Home Assistant Green, where Home Assistant OS is preinstalled - - on a Home Assistant Yellow or on a Raspberry Pi + - On a Home Assistant Yellow or on a Raspberry Pi - Existing Thread adapter connected to your Home Assistant hub - Latest updates installed - A new Thread adapter and a USB extension cable From 5cbaf1ce8a4a16bcb0e11f1b930da38c54adfba1 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Thu, 27 Nov 2025 19:23:10 +0100 Subject: [PATCH 7/7] Update source/_integrations/thread.markdown --- source/_integrations/thread.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/thread.markdown b/source/_integrations/thread.markdown index cba12f39ef92..341c022e883a 100644 --- a/source/_integrations/thread.markdown +++ b/source/_integrations/thread.markdown @@ -207,7 +207,7 @@ Follow these steps if you already have a Thread adapter running but want to swit ### Prerequisites -- [Home Assistant Operating System](https://www.home-assistant.io/docs/glossary/#home-assistant-operating-system) installed on your smart home hub. For example: +- [Home Assistant Operating System](/docs/glossary/#home-assistant-operating-system) installed on your smart home hub. For example: - on a Home Assistant Green, where Home Assistant OS is preinstalled - On a Home Assistant Yellow or on a Raspberry Pi - Existing Thread adapter connected to your Home Assistant hub