From b11ac5051025a6d7bd90be1dde8121a3d5ce0974 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 12 Jun 2025 09:46:14 +0200 Subject: [PATCH 01/10] Z-Wave: set radio frequency region --- source/_integrations/zwave_js.markdown | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index bb76d7c1cc55..4207e9ac196a 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -184,6 +184,20 @@ To migrate a Z-Wave network to a new controller, follow these steps: - Confirm that you connected the new controller by selecting **Submit**. 6. Follow the steps on screen. +## Setting the radio frequency region of the controller + +The frequency used for Z-Wave depends on your region. For each country or region, the Z-Wave products has to apply the standard Z-Wave frequency used and approved in that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. For example, when you live in Europe, it is not allowed to use a device that is using a US frequency. + +During onboarding of your controller, the region of your Home Assistant is used to determine the region in the Z-Wave JS add-on. If needed, you can change this radio frequency region for your controller. However, the region of the device cannot be changed. It only works in the frequency region it was specified for. + +### To change the radio frequency region of your Z-Wave controller + +1. Go to {% my supervisor_addon addon="core_zwave_js" title="**Settings** > **Add-ons** > **Z-Wave JS**" %}. +2. Open the **Configuration** tab. +3. In the **Options** section, select the **Radio Frequency Region**. +4. To apply your changes, select **Save**. + - Your Z-Wave controller is now ready to communicate with devices that were specified for that region. + ## Special Z-Wave entities The Z-Wave integration provides several special entities, some of which are available for every Z-Wave device, and some of which are conditional based on the device. From fe3d62619aef2218de059c439e7838adda19cff6 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 12 Jun 2025 09:48:48 +0200 Subject: [PATCH 02/10] Add prereqs --- source/_integrations/zwave_js.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 4207e9ac196a..027255fe17e1 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -190,6 +190,11 @@ The frequency used for Z-Wave depends on your region. For each country or region During onboarding of your controller, the region of your Home Assistant is used to determine the region in the Z-Wave JS add-on. If needed, you can change this radio frequency region for your controller. However, the region of the device cannot be changed. It only works in the frequency region it was specified for. +### Prerequisites + +- Administrator rights in Home Assistant +- All your Z-Wave devices must be specified for that region + ### To change the radio frequency region of your Z-Wave controller 1. Go to {% my supervisor_addon addon="core_zwave_js" title="**Settings** > **Add-ons** > **Z-Wave JS**" %}. From 1daa1875f9d48e8e82ff7e69193df016f768e405 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 12 Jun 2025 09:53:54 +0200 Subject: [PATCH 03/10] Rephrase intro --- source/_integrations/zwave_js.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 027255fe17e1..c41150814980 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -186,9 +186,9 @@ To migrate a Z-Wave network to a new controller, follow these steps: ## Setting the radio frequency region of the controller -The frequency used for Z-Wave depends on your region. For each country or region, the Z-Wave products has to apply the standard Z-Wave frequency used and approved in that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. For example, when you live in Europe, it is not allowed to use a device that is using a US frequency. +The frequency used by Z-Wave devices depends on your region. For each country or region, the Z-Wave product has to apply the standard Z-Wave frequency approved for that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. For example, when you live in Europe, it is not allowed to use a device that is using a US frequency. -During onboarding of your controller, the region of your Home Assistant is used to determine the region in the Z-Wave JS add-on. If needed, you can change this radio frequency region for your controller. However, the region of the device cannot be changed. It only works in the frequency region it was specified for. +During onboarding of your controller, the region of your Home Assistant is used to determine which radio frequency region this controller is using. If needed, you can change the radio frequency region for your controller. However, the region of the device cannot be changed. It only works in the frequency region it was specified for. ### Prerequisites From f81dd88364a9c585351cba616cea1a968f28427f Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 12 Jun 2025 11:58:52 +0200 Subject: [PATCH 04/10] Update source/_integrations/zwave_js.markdown Co-authored-by: AlCalzone --- source/_integrations/zwave_js.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index c41150814980..db026aedc84b 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -188,7 +188,7 @@ To migrate a Z-Wave network to a new controller, follow these steps: The frequency used by Z-Wave devices depends on your region. For each country or region, the Z-Wave product has to apply the standard Z-Wave frequency approved for that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. For example, when you live in Europe, it is not allowed to use a device that is using a US frequency. -During onboarding of your controller, the region of your Home Assistant is used to determine which radio frequency region this controller is using. If needed, you can change the radio frequency region for your controller. However, the region of the device cannot be changed. It only works in the frequency region it was specified for. +During onboarding of your controller, the region of your Home Assistant is used to determine which radio frequency region this controller is using. If needed, you can change the radio frequency region for your controller. However, the region of end devices cannot be changed. They only work in the frequency region they were specified for. ### Prerequisites From 2a7f0f580b5738ba99660886218cc9a683d55553 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 12 Jun 2025 13:54:29 +0200 Subject: [PATCH 05/10] Implement review feedback --- source/_integrations/zwave_js.markdown | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index db026aedc84b..3e88ba3d76e0 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -184,16 +184,17 @@ To migrate a Z-Wave network to a new controller, follow these steps: - Confirm that you connected the new controller by selecting **Submit**. 6. Follow the steps on screen. -## Setting the radio frequency region of the controller +## Setting the radio frequency region of the controller in the Z-Wave JS add-on -The frequency used by Z-Wave devices depends on your region. For each country or region, the Z-Wave product has to apply the standard Z-Wave frequency approved for that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. For example, when you live in Europe, it is not allowed to use a device that is using a US frequency. +The frequency used by Z-Wave devices depends on your region. For each country or region, the Z-Wave product has to apply the standard Z-Wave frequency approved for that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. -During onboarding of your controller, the region of your Home Assistant is used to determine which radio frequency region this controller is using. If needed, you can change the radio frequency region for your controller. However, the region of end devices cannot be changed. They only work in the frequency region they were specified for. +If you are using the Z-Wave JS add-on, the region of your Home Assistant is used to determine the radio frequency region. If needed, you can change the radio frequency region for your controller. However, the region of end devices cannot be changed. They only work in the frequency region they were specified for. ### Prerequisites - Administrator rights in Home Assistant - All your Z-Wave devices must be specified for that region +- Note: this procedure only applies if your controller is [set-up using the Z-Wave JS add-on](#setting-up-a-z-wave-js-server) ### To change the radio frequency region of your Z-Wave controller From cbe94523fe294825c8283549af27708cceaedb85 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 13 Jun 2025 11:37:20 +0200 Subject: [PATCH 06/10] Update source/_integrations/zwave_js.markdown Co-authored-by: Martin Hjelmare --- source/_integrations/zwave_js.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 3e88ba3d76e0..6ed12843bed4 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -188,7 +188,7 @@ To migrate a Z-Wave network to a new controller, follow these steps: The frequency used by Z-Wave devices depends on your region. For each country or region, the Z-Wave product has to apply the standard Z-Wave frequency approved for that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. -If you are using the Z-Wave JS add-on, the region of your Home Assistant is used to determine the radio frequency region. If needed, you can change the radio frequency region for your controller. However, the region of end devices cannot be changed. They only work in the frequency region they were specified for. +If you are using the Z-Wave JS add-on, the country of your Home Assistant is used to determine the radio frequency region. If needed, you can change the radio frequency region for your controller. However, the region of end devices cannot be changed. They only work in the frequency region they were specified for. ### Prerequisites From f38cbdb4bf40e7fee6133a08d496ee7f3ec95912 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 13 Jun 2025 11:42:33 +0200 Subject: [PATCH 07/10] Update source/_integrations/zwave_js.markdown --- source/_integrations/zwave_js.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 62e4c22d244e..38ee9c4880fd 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -184,7 +184,6 @@ To migrate a Z-Wave network to a new controller, follow these steps: - Confirm that you connected the new controller by selecting **Submit**. 6. Follow the steps on screen. - ## Setting the radio frequency region of the controller in the Z-Wave JS add-on The frequency used by Z-Wave devices depends on your region. For each country or region, the Z-Wave product has to apply the standard Z-Wave frequency approved for that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. From adf309d0f4af7fbe45daeb07430ac0c1bdb02cd7 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Mon, 16 Jun 2025 07:30:43 +0200 Subject: [PATCH 08/10] Update source/_integrations/zwave_js.markdown Co-authored-by: AlCalzone --- source/_integrations/zwave_js.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 38ee9c4880fd..b448318a7564 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -186,9 +186,9 @@ To migrate a Z-Wave network to a new controller, follow these steps: ## Setting the radio frequency region of the controller in the Z-Wave JS add-on -The frequency used by Z-Wave devices depends on your region. For each country or region, the Z-Wave product has to apply the standard Z-Wave frequency approved for that region. This means that when you buy a Z-Wave product, you need to make sure it is approved for your region. +The frequency used by Z-Wave devices depends on your region. For 700 and 800 series controllers, this frequency can be changed. The frequency of end devices cannot, so you need to make sure to buy devices specific to your region. -If you are using the Z-Wave JS add-on, the country of your Home Assistant is used to determine the radio frequency region. If needed, you can change the radio frequency region for your controller. However, the region of end devices cannot be changed. They only work in the frequency region they were specified for. +If you are using the Z-Wave JS add-on, Home Assistant automatically changes the radio frequency region to match the region/country you're in. If needed, you can override this setting. ### Prerequisites From bd38c1c7bf2ccab2af224b0b6a845101a359f3c3 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Mon, 16 Jun 2025 10:03:22 +0200 Subject: [PATCH 09/10] Update source/_integrations/zwave_js.markdown Co-authored-by: AlCalzone --- source/_integrations/zwave_js.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index b448318a7564..51aee60f0cbc 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -196,7 +196,7 @@ If you are using the Z-Wave JS add-on, Home Assistant automatically changes the - All your Z-Wave devices must be specified for that region - Note: this procedure only applies if your controller is [set up using the Z-Wave JS add-on](#setting-up-a-z-wave-js-server) -### To change the radio frequency region of your Z-Wave controller +### Overriding the radio frequency region of your Z-Wave controller 1. Go to {% my supervisor_addon addon="core_zwave_js" title="**Settings** > **Add-ons** > **Z-Wave JS**" %}. 2. Open the **Configuration** tab. From 26325a898eb44fed3708999660dcf0d2828b8227 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Mon, 16 Jun 2025 10:11:34 +0200 Subject: [PATCH 10/10] add step to return to default setting --- source/_integrations/zwave_js.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 51aee60f0cbc..e24906382704 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -202,7 +202,8 @@ If you are using the Z-Wave JS add-on, Home Assistant automatically changes the 2. Open the **Configuration** tab. 3. In the **Options** section, select the **Radio Frequency Region**. 4. To apply your changes, select **Save**. - - Your Z-Wave controller is now ready to communicate with devices that were specified for that region. + - Your Z-Wave controller is now ready to communicate with devices that were specified for your chosen region. +5. To return to the default setting and use the region defined by Home Assistant, under **Radio Frequency Region** choose **Automatic**. ## Backing up your Z-Wave network