public/openhab-addons
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[tplinkrouter] Initial contribution (#13369)

Browse Source 
* Initial commit

Signed-off-by: Olivier Marceau <hollysaiqs@marceau.ovh>
This commit is contained in:
Olivier
2022-10-15 21:52:33 +02:00
committed by GitHub
parent 19b4c95103
commit 73e18424b9
17 changed files with 875 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

57
bundles/org.openhab.binding.tplinkrouter/README.md Normal file
View File

@@ -0,0 +1,57 @@
# 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"}
```