This page is part of archived documentation for openHAB 4.1. Go to the current stable version

# tplinkrouter Binding

The tplinkrouter Binding allows monitoring and controlling TP-Link routers.

The binding uses a telnet connection to communicate with the router.

At the moment only wifi part is supported and TD-W9970 is the only model tested. This binding may work with other TP-Link router provided that they use the same telnet API.

# Supported Things

This binding provides only the router Thing.

# Thing Configuration

# router Thing Configuration

Name Type Description Default Required Advanced
hostname text Hostname or IP address of the device N/A yes no
port integer Port for telnet connection 23 no no
username text Username to access the router (same as WebUI) N/A yes no
password text Password to access the device (same as WebUI) N/A yes no
refreshInterval integer Interval the device is polled in sec. 60 no yes

# Channels

Channel Type Read/Write Description
wifi#status Switch RW State of the wifi
wifi#ssid String R SSID of the wifi network
wifi#bandwidth String R Bandwidth of the wifi network
wifi#qss Switch RW Quick Security Setup of the wifi network
wifi#secMode String R Security Mode of the wifi network
wifi#authentication String R Authentication Mode of the wifi network
wifi#encryption String R Encryption Mode of the wifi network
wifi#key String R Password of the wifi network

# Full Example

.things configuration file:

Thing tplinkrouter:router:myRouter [hostname="192.168.0.1", username="admin", password="myPassword"]

.items configuration file:

Switch Wifi "Wifi" <QualityOfService> {channel="tplinkrouter:router:myRouter:wifi#status", autoupdate="false"}
String WifiSSID "Wifi SSID" <QualityOfService> {channel="tplinkrouter:router:myRouter:wifi#ssid"}
String BandWidth "Wifi Bandwidth" <QualityOfService> {channel="tplinkrouter:router:myRouter:wifi#bandwidth"}
Switch QSS "Wifi QSS" <QualityOfService> {channel="tplinkrouter:router:myRouter:wifi#qss", autoupdate="false"}
String SecMode "Wifi Security Mode" <QualityOfService> {channel="tplinkrouter:router:myRouter:wifi#secMode"}
String Authentication "Wifi Authentication Mode" <QualityOfService> {channel="tplinkrouter:router:myRouter:wifi#authentication"}
String Encryption "Wifi Encryption Mode" <QualityOfService> {channel="tplinkrouter:router:myRouter:wifi#encryption"}