Skip to content

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 ​

NameTypeDescriptionDefaultRequiredAdvanced
hostnametextHostname or IP address of the deviceN/Ayesno
portintegerPort for telnet connection23nono
usernametextUsername to access the router (same as WebUI)N/Ayesno
passwordtextPassword to access the device (same as WebUI)N/Ayesno
refreshIntervalintegerInterval the device is polled in sec.60noyes

Channels ​

ChannelTypeRead/WriteDescription
wifi#statusSwitchRWState of the wifi
wifi#ssidStringRSSID of the wifi network
wifi#bandwidthStringRBandwidth of the wifi network
wifi#qssSwitchRWQuick Security Setup of the wifi network
wifi#secModeStringRSecurity Mode of the wifi network
wifi#authenticationStringRAuthentication Mode of the wifi network
wifi#encryptionStringREncryption Mode of the wifi network
wifi#keyStringRPassword of the wifi network

Full Example ​

.things configuration file:

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

.items configuration file:

dsl
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"}