From ffa60556e1e97cdef2b9b1c4fc1b40d12e622693 Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Mon, 12 Aug 2024 19:35:45 +0300 Subject: [PATCH 1/9] switcher update doc to runner S11 --- source/_integrations/switcher_kis.markdown | 26 +++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index abe24ecd0e26..7aa598e03c61 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -34,9 +34,33 @@ Supported devices: - Switcher V4 - Switcher Breeze - Switcher Runner +- Switcher Runner S11 + +Required a token devices: + +- Switcher Runner S11 If you completed the integration setup but are still unable to control the device, please make sure your device's firmware is up-to-date. +## Prerequisites + +For security reasons, some of the Switcher devices require a token to operate. + +To use your Switcher token-based devices with Home Assistant, + +You will need two pieces of information: + +- **The username of your Switcher Account.** You can find the username by + going into the Switcher app. +- **Local control key token.** To find local control key token, browse to the + [Switcher GetKey API][token], enter your Switcher account username (which is email address), and press + **Send Me The Code**. + + The token will be send to you by email. + It will look something like this: zvVvd7JxtN7CgvkD1Psujw== + +[token]: https://switcher.co.il/GetKey/ + {% include integrations/config_flow.md %} ## Buttons @@ -87,5 +111,5 @@ Note: This does not affect the auto off timer. ## Notes -Make sure that Home Assistant host's firewall allows incoming traffic on UDP ports 10002, 20002 & 20003 and outgoing connections to Switcher device(s) on TCP ports 9957 & 10000. +Make sure that Home Assistant host's firewall allows incoming traffic on UDP ports 10002, 10003, 20002 & 20003 and outgoing connections to Switcher device(s) on TCP ports 9957 & 10000. If Home Assistant and the Switcher device(s) are not on the same network, you will also need to have their traffic properly forwarded between the two networks. From bd4ea5dd11c7befc8380c33c91a9cf48f02c4cad Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Mon, 12 Aug 2024 19:42:13 +0300 Subject: [PATCH 2/9] Update source/_integrations/switcher_kis.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- source/_integrations/switcher_kis.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index 7aa598e03c61..224adb96a729 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -53,7 +53,7 @@ You will need two pieces of information: - **The username of your Switcher Account.** You can find the username by going into the Switcher app. - **Local control key token.** To find local control key token, browse to the - [Switcher GetKey API][token], enter your Switcher account username (which is email address), and press + [Switcher GetKey API][token], enter your Switcher account username (which is an email address), and press **Send Me The Code**. The token will be send to you by email. From e02d5ca4f30688179c873f3cc5b17b125cbaf9f0 Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Mon, 12 Aug 2024 19:42:21 +0300 Subject: [PATCH 3/9] Update source/_integrations/switcher_kis.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- source/_integrations/switcher_kis.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index 224adb96a729..eee8a0550e11 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -56,7 +56,7 @@ You will need two pieces of information: [Switcher GetKey API][token], enter your Switcher account username (which is an email address), and press **Send Me The Code**. - The token will be send to you by email. + The token will be sent to you by email. It will look something like this: zvVvd7JxtN7CgvkD1Psujw== [token]: https://switcher.co.il/GetKey/ From 8665db8d52544c4f1a6bd26d9805b0075fc00ae5 Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Mon, 12 Aug 2024 19:42:38 +0300 Subject: [PATCH 4/9] Update source/_integrations/switcher_kis.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- source/_integrations/switcher_kis.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index eee8a0550e11..d3d87075b6d3 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -36,7 +36,7 @@ Supported devices: - Switcher Runner - Switcher Runner S11 -Required a token devices: +Required token devices: - Switcher Runner S11 From d733949bfa444710279161ee26325c9289ddb46e Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Mon, 12 Aug 2024 19:46:38 +0300 Subject: [PATCH 5/9] fix Update switcher_kis.markdown --- source/_integrations/switcher_kis.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index d3d87075b6d3..fbae1e8556f6 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -46,7 +46,7 @@ If you completed the integration setup but are still unable to control the devic For security reasons, some of the Switcher devices require a token to operate. -To use your Switcher token-based devices with Home Assistant, +To use your Switcher token-based devices with Home Assistant, You will need two pieces of information: From 7f5857f205eccdee6ddb68d397aba9e026c429ac Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Fri, 20 Sep 2024 22:44:15 +0300 Subject: [PATCH 6/9] Update source/_integrations/switcher_kis.markdown Co-authored-by: Shay Levy --- source/_integrations/switcher_kis.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index fbae1e8556f6..e1447af1ae2a 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -56,8 +56,7 @@ You will need two pieces of information: [Switcher GetKey API][token], enter your Switcher account username (which is an email address), and press **Send Me The Code**. - The token will be sent to you by email. - It will look something like this: zvVvd7JxtN7CgvkD1Psujw== + The token will be sent to you by email. It will look something like this: `zvVvd7JxtN7CgvkD1Psujw==` [token]: https://switcher.co.il/GetKey/ From bce482cbb3a2446be0a4b0c97a6886f0339692c0 Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Fri, 20 Sep 2024 22:44:21 +0300 Subject: [PATCH 7/9] Update source/_integrations/switcher_kis.markdown Co-authored-by: Shay Levy --- source/_integrations/switcher_kis.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index e1447af1ae2a..4d37b5386748 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -36,7 +36,7 @@ Supported devices: - Switcher Runner - Switcher Runner S11 -Required token devices: +Devices that require a token: - Switcher Runner S11 From 7877e22006e2f20b8285636d42df765e58605da5 Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Fri, 20 Sep 2024 22:44:30 +0300 Subject: [PATCH 8/9] Update source/_integrations/switcher_kis.markdown Co-authored-by: Shay Levy --- source/_integrations/switcher_kis.markdown | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index 4d37b5386748..24c3640afb23 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -44,11 +44,7 @@ If you completed the integration setup but are still unable to control the devic ## Prerequisites -For security reasons, some of the Switcher devices require a token to operate. - -To use your Switcher token-based devices with Home Assistant, - -You will need two pieces of information: +To enhance security, certain Switcher devices require a token for operation. In order to integrate your token-based Switcher devices with Home Assistant, you'll need the following information: - **The username of your Switcher Account.** You can find the username by going into the Switcher app. From 87da51b08299363823c81805ae315e07f02e2f72 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Mon, 23 Sep 2024 09:04:10 +0200 Subject: [PATCH 9/9] Tiny tweak --- source/_integrations/switcher_kis.markdown | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index 24c3640afb23..5483e7d680a3 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -46,9 +46,8 @@ If you completed the integration setup but are still unable to control the devic To enhance security, certain Switcher devices require a token for operation. In order to integrate your token-based Switcher devices with Home Assistant, you'll need the following information: -- **The username of your Switcher Account.** You can find the username by - going into the Switcher app. -- **Local control key token.** To find local control key token, browse to the +- **The username of your Switcher Account**: To find the username, open the Switcher app. +- **Local control key token**: To find the local control key token, browse to the [Switcher GetKey API][token], enter your Switcher account username (which is an email address), and press **Send Me The Code**.