mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +00:00
Update tplink docs for auth and tapo (#30966)
This commit is contained in:
parent
8ed657dde6
commit
e7af0c5613
@ -1,5 +1,5 @@
|
||||
---
|
||||
title: TP-Link Kasa Smart
|
||||
title: TP-Link Smart Home
|
||||
description: Instructions on integrating TP-Link Smart Home Devices to Home Assistant.
|
||||
ha_category:
|
||||
- Hub
|
||||
@ -13,6 +13,7 @@ ha_codeowners:
|
||||
- '@rytilahti'
|
||||
- '@thegardenmonkey'
|
||||
- '@bdraco'
|
||||
- '@sdb9696'
|
||||
ha_domain: tplink
|
||||
ha_platforms:
|
||||
- diagnostics
|
||||
@ -24,15 +25,12 @@ ha_quality_scale: platinum
|
||||
ha_integration_type: integration
|
||||
---
|
||||
|
||||
The `tplink` integration allows you to control your [TP-Link Smart Home Devices](https://www.tp-link.com/kasa-smart/) such as plugs, power strips, wall switches and bulbs.
|
||||
The `tplink` integration allows you to control your [TP-Link Kasa Smart Home Devices](https://www.tp-link.com/kasa-smart/) and [TP-Link Tapo Devices](https://www.tapo.com/) such as plugs, power strips, wall switches and bulbs.
|
||||
|
||||
You need to provision your newly purchased device to connect to your network before it can be added via the integration. This can be done either by using [kasa command-line tool](https://python-kasa.readthedocs.io/en/latest/cli.html#provisioning) or by adding it to the official Kasa app before trying to add them to Home Assistant. If you use the app, do not upgrade the firmware if it presents the option to avoid blocking the local access by potential firmware updates.
|
||||
You need to provision your newly purchased device to connect to your network before it can be added via the integration. This can be done either by using [kasa command-line tool](https://python-kasa.readthedocs.io/en/latest/cli.html#provisioning) or by adding it to the official Kasa or Tapo app before trying to add them to Home Assistant.
|
||||
|
||||
There is currently support for the following device types within Home Assistant:
|
||||
|
||||
- **Light**
|
||||
- **Switch**
|
||||
- **Sensor**
|
||||
If your device is a newer Kasa or Tapo device it will require your TP-Link cloud username and password to authenticate for local access.
|
||||
If you have an older device that does not currently require authentication, you may consider disabling automatic firmware updates to keep it that way.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
@ -40,9 +38,11 @@ There is currently support for the following device types within Home Assistant:
|
||||
|
||||
See [Supported Devices in python-kasa](https://github.com/python-kasa/python-kasa#supported-devices) for an up to date list.
|
||||
|
||||
## Supported devices
|
||||
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).
|
||||
|
||||
### Plugs
|
||||
### Not requiring authentication
|
||||
|
||||
#### Plugs
|
||||
|
||||
- HS100
|
||||
- HS103
|
||||
@ -55,16 +55,18 @@ See [Supported Devices in python-kasa](https://github.com/python-kasa/python-kas
|
||||
- KP125
|
||||
- KP401
|
||||
- EP10
|
||||
- EP25 (HW versions 2.5 and earlier)
|
||||
- EP25 (Hardware version < 2.6)
|
||||
|
||||
### Power Strips
|
||||
#### Power Strips
|
||||
|
||||
- EP40
|
||||
- HS300
|
||||
- KP303
|
||||
- KP200
|
||||
- KP400
|
||||
- KP405
|
||||
|
||||
### Wall switches
|
||||
#### Wall switches
|
||||
|
||||
- ES20M
|
||||
- HS200
|
||||
@ -74,7 +76,7 @@ See [Supported Devices in python-kasa](https://github.com/python-kasa/python-kas
|
||||
- KS220M
|
||||
- KS230
|
||||
|
||||
### Bulbs
|
||||
#### Bulbs
|
||||
|
||||
- EP40
|
||||
- LB100
|
||||
@ -90,19 +92,41 @@ See [Supported Devices in python-kasa](https://github.com/python-kasa/python-kas
|
||||
- KL130
|
||||
- KL135
|
||||
|
||||
### Light strips
|
||||
#### Light strips
|
||||
|
||||
- KL400
|
||||
- KL420
|
||||
- KL430
|
||||
|
||||
Other bulbs may also work, but with limited color temperature range (2700-5000). If you find a bulb isn't reaching the full-color temperature boundaries, submit a bug report to [python-kasa](https://github.com/python-kasa/python-kasa).
|
||||
### Requiring authentication
|
||||
|
||||
## Unsupported devices
|
||||
#### Plugs
|
||||
|
||||
### Plugs
|
||||
- EP25 (Hardware version >= 2.6)
|
||||
- KP125M
|
||||
- P110
|
||||
- HS100 (UK Hardware version 4.1 with firmware 1.1.0)
|
||||
|
||||
- KP125M (supported via [Matter](/integrations/matter/#tp-link-tapo-p125m-power-plug), but without energy monitoring features)
|
||||
#### Wall switches
|
||||
|
||||
- KS205
|
||||
- KS225
|
||||
|
||||
#### Bulbs
|
||||
|
||||
- L510B
|
||||
- L530E
|
||||
|
||||
#### Light strips
|
||||
|
||||
- L900-5
|
||||
- L900-10
|
||||
- L920
|
||||
|
||||
|
||||
## Light strip effects
|
||||
|
||||
Light strip effects are currently only supported for the device types not requiring authentication.
|
||||
|
||||
### Random Effect - Service `tplink.random_effect`
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user