mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-24 01:37:23 +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
|
||||
footer: true
|
||||
logo: tp-link.png
|
||||
ha_category: Hub
|
||||
ha_category:
|
||||
- Hub
|
||||
- Switch
|
||||
- Light
|
||||
- Presence Detection
|
||||
ha_release: 0.89
|
||||
ha_iot_class: Local Polling
|
||||
redirect_from:
|
||||
- /components/switch.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.
|
||||
|
||||
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.
|
||||
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'
|
||||
```
|
||||
{% 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