mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-14 12:56:54 +00:00
🚜 Merges/Redirect TP-Link component pages (#9017)
This commit is contained in:
Klaas Schoute
Fabian Affolter
parent
7b29fa1998
commit
25b49ec9ee
@ -1,68 +0,0 @@
|
|||||||
---
|
|
||||||
layout: page
|
|
||||||
title: "TP-Link Router"
|
|
||||||
description: "Instructions on how to integrate TP-Link routers into Home Assistant."
|
|
||||||
date: 2015-06-22 10:30
|
|
||||||
sidebar: true
|
|
||||||
comments: false
|
|
||||||
sharing: true
|
|
||||||
footer: true
|
|
||||||
logo: tp-link.png
|
|
||||||
ha_category: Presence Detection
|
|
||||||
ha_release: pre 0.7
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
The `tplink` platform allows you to detect presence by looking at connected devices to a [TP-Link](https://www.tp-link.com) router.
|
|
||||||
|
|
||||||
Currently supported devices includes the following:
|
|
||||||
|
|
||||||
- Archer C7 firmware version 150427
|
|
||||||
- Archer C9 firmware version 150811
|
|
||||||
- EAP-225 AP with latest firmware version
|
|
||||||
- Archer D9 firmware version 0.9.1 0.1 v0041.0 Build 160224 Rel.59129n
|
|
||||||
|
|
||||||
<p class='note'>
|
|
||||||
TP-Link devices typically only allow one login at a time to the admin console. This component will count towards your one allowed login. Depending on how aggressively you configure device_tracker you may not be able to access the admin console of your TP-Link device without first stopping Home Assistant. Home Assistant takes a few seconds to login, collect data, and log out. If you log into the admin console manually, remember to log out so that Home Assistant can log in again.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
## {% linkable_title Configuration %}
|
|
||||||
|
|
||||||
To enable this device tracker, add the following lines to your `configuration.yaml`:
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
# Example configuration.yaml entry
|
|
||||||
device_tracker:
|
|
||||||
- platform: tplink
|
|
||||||
host: YOUR_ROUTER_IP
|
|
||||||
username: YOUR_ADMIN_USERNAME
|
|
||||||
password: YOUR_ADMIN_PASSWORD
|
|
||||||
```
|
|
||||||
|
|
||||||
{% configuration %}
|
|
||||||
host:
|
|
||||||
description: The IP address of your router, e.g., 192.168.1.1.
|
|
||||||
required: true
|
|
||||||
type: string
|
|
||||||
username:
|
|
||||||
description: The username of an user with administrative privileges, usually *admin*. The Archer D9 last firmware does not require a username.
|
|
||||||
required: true
|
|
||||||
type: string
|
|
||||||
password:
|
|
||||||
description: The password for your given admin account.
|
|
||||||
required: true
|
|
||||||
type: string
|
|
||||||
{% endconfiguration %}
|
|
||||||
|
|
||||||
For Archer C9 models running firmware version 150811 or later please use the encrypted password you can retrieve like this:
|
|
||||||
|
|
||||||
1. Go to the login page of your router. (default: 192.168.0.1)
|
|
||||||
2. Type in the password you use to login into the password field.
|
|
||||||
3. Click somewhere else on the page so that the password field is not selected anymore.
|
|
||||||
4. Open the JavaScript console of your browser (usually by pressing F12 and then clicking on "Console").
|
|
||||||
5. Type `document.getElementById("login-password").value;` or `document.getElementById("pcPassword").value;`, depending on your firmware version.
|
|
||||||
6. Copy the returned value to your Home Assistant configuration as password.
|
|
||||||
|
|
||||||
See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked.
|
|
||||||
|
|
||||||
For Archer D9 model the default ip is 192.168.1.1, the username is not necessary and you can leave that field blank.
|
|
||||||
@ -8,16 +8,27 @@ comments: false
|
|||||||
sharing: true
|
sharing: true
|
||||||
footer: true
|
footer: true
|
||||||
logo: tp-link.png
|
logo: tp-link.png
|
||||||
ha_category: Hub
|
ha_category:
|
||||||
|
- Hub
|
||||||
|
- Switch
|
||||||
|
- Light
|
||||||
|
- Presence Detection
|
||||||
ha_release: 0.89
|
ha_release: 0.89
|
||||||
ha_iot_class: Local Polling
|
ha_iot_class: Local Polling
|
||||||
redirect_from:
|
redirect_from:
|
||||||
- /components/switch.tplink/
|
- /components/switch.tplink/
|
||||||
- /components/light.tplink/
|
- /components/light.tplink/
|
||||||
|
- /components/device_tracker.tplink/
|
||||||
---
|
---
|
||||||
|
|
||||||
The `tplink` component allows you to control your [TP-Link Smart Home Devices](https://www.tp-link.com/kasa-smart/) such as smart plugs and smart bulbs.
|
The `tplink` component allows you to control your [TP-Link Smart Home Devices](https://www.tp-link.com/kasa-smart/) such as smart plugs and smart bulbs.
|
||||||
|
|
||||||
|
There is currently support for the following device types within Home Assistant:
|
||||||
|
|
||||||
|
- **Light**
|
||||||
|
- **Switch**
|
||||||
|
- [Presence Detection](#presence-detection)
|
||||||
|
|
||||||
In order to activate the support, you will have to enable the integration inside the config panel.
|
In order to activate the support, you will have to enable the integration inside the config panel.
|
||||||
The supported devices in your network are automatically discovered, but if you want to control devices residing in other networks you will need to configure them manually as shown below.
|
The supported devices in your network are automatically discovered, but if you want to control devices residing in other networks you will need to configure them manually as shown below.
|
||||||
|
|
||||||
@ -129,3 +140,59 @@ sensor:
|
|||||||
unit_of_measurement: 'kWh'
|
unit_of_measurement: 'kWh'
|
||||||
```
|
```
|
||||||
{% endraw %}
|
{% endraw %}
|
||||||
|
|
||||||
|
## {% linkable_title Presence detection %}
|
||||||
|
|
||||||
|
The `tplink` platform allows you to detect presence by looking at connected devices to a [TP-Link](https://www.tp-link.com) router.
|
||||||
|
|
||||||
|
Currently supported devices includes the following:
|
||||||
|
|
||||||
|
- Archer C7 firmware version 150427
|
||||||
|
- Archer C9 firmware version 150811
|
||||||
|
- EAP-225 AP with latest firmware version
|
||||||
|
- Archer D9 firmware version 0.9.1 0.1 v0041.0 Build 160224 Rel.59129n
|
||||||
|
|
||||||
|
<p class='note'>
|
||||||
|
TP-Link devices typically only allow one login at a time to the admin console. This component will count towards your one allowed login. Depending on how aggressively you configure device_tracker you may not be able to access the admin console of your TP-Link device without first stopping Home Assistant. Home Assistant takes a few seconds to login, collect data, and log out. If you log into the admin console manually, remember to log out so that Home Assistant can log in again.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
### {% linkable_title Configuration %}
|
||||||
|
|
||||||
|
To enable this device tracker, add the following lines to your `configuration.yaml`:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
device_tracker:
|
||||||
|
- platform: tplink
|
||||||
|
host: YOUR_ROUTER_IP
|
||||||
|
username: YOUR_ADMIN_USERNAME
|
||||||
|
password: YOUR_ADMIN_PASSWORD
|
||||||
|
```
|
||||||
|
|
||||||
|
{% configuration %}
|
||||||
|
host:
|
||||||
|
description: The IP address of your router, e.g., 192.168.1.1.
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
username:
|
||||||
|
description: The username of an user with administrative privileges, usually *admin*. The Archer D9 last firmware does not require a username.
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
password:
|
||||||
|
description: The password for your given admin account.
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
For Archer C9 models running firmware version 150811 or later please use the encrypted password you can retrieve like this:
|
||||||
|
|
||||||
|
1. Go to the login page of your router. (default: 192.168.0.1)
|
||||||
|
2. Type in the password you use to login into the password field.
|
||||||
|
3. Click somewhere else on the page so that the password field is not selected anymore.
|
||||||
|
4. Open the JavaScript console of your browser (usually by pressing F12 and then clicking on "Console").
|
||||||
|
5. Type `document.getElementById("login-password").value;` or `document.getElementById("pcPassword").value;`, depending on your firmware version.
|
||||||
|
6. Copy the returned value to your Home Assistant configuration as password.
|
||||||
|
|
||||||
|
See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked.
|
||||||
|
|
||||||
|
For Archer D9 model the default ip is 192.168.1.1, the username is not necessary and you can leave that field blank.
|
||||||
Loading…
x
Reference in New Issue
Block a user