From bfe5439051fa87dd73a179b012820ef13be60f7d Mon Sep 17 00:00:00 2001 From: sdb9696 Date: Thu, 6 Jun 2024 18:19:20 +0100 Subject: [PATCH 1/4] Update tplink documentation for next release --- source/_integrations/tplink.markdown | 115 ++++++--------------------- 1 file changed, 26 insertions(+), 89 deletions(-) diff --git a/source/_integrations/tplink.markdown b/source/_integrations/tplink.markdown index 7d6708816e42..3ee82a23747f 100644 --- a/source/_integrations/tplink.markdown +++ b/source/_integrations/tplink.markdown @@ -2,6 +2,7 @@ title: TP-Link Smart Home description: Instructions on integrating TP-Link Smart Home Devices to Home Assistant. ha_category: + - Fan - Hub - Light - Sensor @@ -17,6 +18,7 @@ ha_codeowners: ha_domain: tplink ha_platforms: - diagnostics + - fan - light - sensor - switch @@ -36,98 +38,33 @@ If you have an older device that does not currently require authentication, you ## Supported Devices -See [Supported Devices in python-kasa](https://github.com/python-kasa/python-kasa#supported-devices) for an up to date list. +See [Supported Devices in python-kasa](https://github.com/python-kasa/python-kasa#supported-devices) for an up to date list that includes hardware and firmware versions. Devices not listed below may work but if you encounter issues submit a bug report to [python-kasa](https://github.com/python-kasa/python-kasa). -### Not requiring authentication - -#### Plugs - -- HS100 -- HS103 -- HS105 -- HS107 -- HS110 -- KP100 -- KP105 -- KP115 -- KP125 -- KP401 -- EP10 -- EP25 (Hardware version < 2.6) - -#### Power Strips - -- EP40 -- HS300 -- KP303 -- KP200 -- KP400 -- KP405 - -#### Wall switches - -- ES20M -- HS200 -- HS210 -- HS220 -- KS200M -- KS220M -- KS230 - -#### Bulbs - -- EP40 -- LB100 -- LB110 -- LB120 -- LB130 -- LB230 -- KL50 -- KL60 -- KL110 -- KL120 -- KL125 -- KL130 -- KL135 - -#### Light strips - -- KL400 -- KL420 -- KL430 - -### Requiring authentication - -#### Plugs - -- EP25 (Hardware version >= 2.6) -- KP125M -- P110 -- P115 -- HS100 (UK Hardware version 4.1 with firmware 1.1.0) - -#### Wall switches - -- KS205 -- KS225 - -#### Bulbs - -- L510B -- L530E -- TL135E - -#### Light strips - -- L900-5 -- L900-10 -- L920 - -#### Power Strips - -- P300 +### Supported Kasa devices + +- **Plugs**: EP10, EP25\*, HS100\*\*, HS103, HS105, HS110, KP100, KP105, KP115, KP125, KP125M\*, KP401 +- **Power Strips**: EP40, HS107, HS300, KP200, KP303, KP400 +- **Wall Switches**: ES20M, HS200, HS210, HS220, KP405, KS200M, KS205\*, KS220M, KS225\*, KS230, KS240\* +- **Bulbs**: KL110, KL120, KL125, KL130, KL135, KL50, KL60, LB110 +- **Light Strips**: KL400L5, KL420L5, KL430 +- **Hubs**: KH100\* +- **Hub-Connected Devices\*\*\***: KE100\* + +### Supported Tapo\* devices + +- **Plugs**: P100, P110, P115, P125M, P135, TP15 +- **Power Strips**: P300, TP25 +- **Wall Switches**: S500D, S505, S505D +- **Bulbs**: L510B, L510E, L530E +- **Light Strips**: L900-10, L900-5, L920-5, L930-5 +- **Hubs**: H100 +- **Hub-Connected Devices\*\*\***: T110, T300, T310, T315 + +\*   Model requires authentication
+\*\*  Newer versions require authentication
+\*\*\* Devices may work across TAPO/KASA branded hubs ## Light strip effects From 9511822bc3568a07fbef1b903e85526671fb8661 Mon Sep 17 00:00:00 2001 From: sdb9696 Date: Wed, 26 Jun 2024 07:00:56 +0100 Subject: [PATCH 2/4] Add all the new platforms and update light effect comments --- source/_integrations/tplink.markdown | 38 ++++++++++++++--------- source/_integrations/tplink_tapo.markdown | 13 +++++++- 2 files changed, 36 insertions(+), 15 deletions(-) diff --git a/source/_integrations/tplink.markdown b/source/_integrations/tplink.markdown index 3ee82a23747f..7bcbe973da08 100644 --- a/source/_integrations/tplink.markdown +++ b/source/_integrations/tplink.markdown @@ -2,9 +2,14 @@ title: TP-Link Smart Home description: Instructions on integrating TP-Link Smart Home Devices to Home Assistant. ha_category: + - Binary sensor + - Button + - Climate - Fan - Hub - Light + - Number + - Select - Sensor - Switch ha_release: 0.89 @@ -12,14 +17,18 @@ ha_iot_class: Local Polling ha_config_flow: true ha_codeowners: - '@rytilahti' - - '@thegardenmonkey' - '@bdraco' - '@sdb9696' ha_domain: tplink ha_platforms: + - binary_sensor + - button + - climate - diagnostics - fan - light + - number + - select - sensor - switch ha_dhcp: true @@ -44,15 +53,15 @@ Devices not listed below may work but if you encounter issues submit a bug repor ### Supported Kasa devices -- **Plugs**: EP10, EP25\*, HS100\*\*, HS103, HS105, HS110, KP100, KP105, KP115, KP125, KP125M\*, KP401 +- **Plugs**: EP10, EP25[^1], HS100[^2], HS103, HS105, HS110, KP100, KP105, KP115, KP125, KP125M[^1], KP401 - **Power Strips**: EP40, HS107, HS300, KP200, KP303, KP400 -- **Wall Switches**: ES20M, HS200, HS210, HS220, KP405, KS200M, KS205\*, KS220M, KS225\*, KS230, KS240\* +- **Wall Switches**: ES20M, HS200, HS210, HS220, KP405, KS200M, KS205[^1], KS220M, KS225[^1], KS230, KS240[^1] - **Bulbs**: KL110, KL120, KL125, KL130, KL135, KL50, KL60, LB110 - **Light Strips**: KL400L5, KL420L5, KL430 -- **Hubs**: KH100\* -- **Hub-Connected Devices\*\*\***: KE100\* +- **Hubs**: KH100[^1] +- **Hub-Connected Devices[^3]**: KE100[^1] -### Supported Tapo\* devices +### Supported Tapo[^1] devices - **Plugs**: P100, P110, P115, P125M, P135, TP15 - **Power Strips**: P300, TP25 @@ -60,19 +69,20 @@ Devices not listed below may work but if you encounter issues submit a bug repor - **Bulbs**: L510B, L510E, L530E - **Light Strips**: L900-10, L900-5, L920-5, L930-5 - **Hubs**: H100 -- **Hub-Connected Devices\*\*\***: T110, T300, T310, T315 +- **Hub-Connected Devices[^3]**: T110, T300, T310, T315 -\*   Model requires authentication
-\*\*  Newer versions require authentication
-\*\*\* Devices may work across TAPO/KASA branded hubs +[^1]: Requires authentication +[^2]: Newer versions require authentication +[^3]: Devices may work across TAPO/KASA branded hubs -## Light strip effects +## Light effects -Light strip effects are currently only supported for the device types not requiring authentication. +If light effects are supported by a device they can be selected from the bottom of the light card. +They are currently not supported on Kasa bulbs. ### Random Effect - Service `tplink.random_effect` -The light strips allow setting a random effect. +Light strips allow setting a random effect. | Service data attribute | Description | | ---------------------- | ----------- | @@ -121,7 +131,7 @@ data: ### Sequence Effect - Service `tplink.sequence_effect` -The light strips allow setting a sequence effect. +Light strips allow setting a sequence effect. | Service data attribute | Description | | ---------------------- | ----------- | diff --git a/source/_integrations/tplink_tapo.markdown b/source/_integrations/tplink_tapo.markdown index b5a64c39ce9b..90dd40eb4663 100644 --- a/source/_integrations/tplink_tapo.markdown +++ b/source/_integrations/tplink_tapo.markdown @@ -2,8 +2,14 @@ title: Tapo description: Connect and control your Tapo devices using the TP-Link Smart Home integration ha_category: + - Binary sensor + - Button + - Climate + - Fan - Hub - Light + - Number + - Select - Sensor - Switch ha_domain: tplink_tapo @@ -13,13 +19,18 @@ ha_supporting_domain: tplink ha_supporting_integration: TP-Link Smart Home ha_codeowners: - '@rytilahti' - - '@thegardenmonkey' - '@bdraco' - '@sdb9696' ha_config_flow: true ha_platforms: + - binary_sensor + - button + - climate - diagnostics + - fan - light + - number + - select - sensor - switch ha_iot_class: Local Polling From 50f386c83598b409b68982b5dd6ce0e71c7b46f5 Mon Sep 17 00:00:00 2001 From: sdb9696 Date: Wed, 26 Jun 2024 07:10:27 +0100 Subject: [PATCH 3/4] Update supported devices link --- source/_integrations/tplink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/tplink.markdown b/source/_integrations/tplink.markdown index 7bcbe973da08..9997162b2c8f 100644 --- a/source/_integrations/tplink.markdown +++ b/source/_integrations/tplink.markdown @@ -47,7 +47,7 @@ If you have an older device that does not currently require authentication, you ## Supported Devices -See [Supported Devices in python-kasa](https://github.com/python-kasa/python-kasa#supported-devices) for an up to date list that includes hardware and firmware versions. +See [Supported Devices in python-kasa](https://python-kasa.readthedocs.io/en/stable/SUPPORTED.html) for an up to date list that includes hardware and firmware versions. Devices not listed below may work but if you encounter issues submit a bug report to [python-kasa](https://github.com/python-kasa/python-kasa). From 7ec76116f19e02155fc4a6c8b95bfbe5661fc554 Mon Sep 17 00:00:00 2001 From: sdb9696 Date: Wed, 26 Jun 2024 07:20:18 +0100 Subject: [PATCH 4/4] Re-add thegardenmonkey as a codeowner --- source/_integrations/tplink.markdown | 1 + source/_integrations/tplink_tapo.markdown | 1 + 2 files changed, 2 insertions(+) diff --git a/source/_integrations/tplink.markdown b/source/_integrations/tplink.markdown index 9997162b2c8f..1c6cfef8d7f5 100644 --- a/source/_integrations/tplink.markdown +++ b/source/_integrations/tplink.markdown @@ -17,6 +17,7 @@ ha_iot_class: Local Polling ha_config_flow: true ha_codeowners: - '@rytilahti' + - '@thegardenmonkey' - '@bdraco' - '@sdb9696' ha_domain: tplink diff --git a/source/_integrations/tplink_tapo.markdown b/source/_integrations/tplink_tapo.markdown index 90dd40eb4663..405705881c88 100644 --- a/source/_integrations/tplink_tapo.markdown +++ b/source/_integrations/tplink_tapo.markdown @@ -19,6 +19,7 @@ ha_supporting_domain: tplink ha_supporting_integration: TP-Link Smart Home ha_codeowners: - '@rytilahti' + - '@thegardenmonkey' - '@bdraco' - '@sdb9696' ha_config_flow: true