This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# TapoControl Binding
This binding adds support to control Tapo (Copyright © TP-Link Corporation Limited) Smart Home Devices from your local openHAB system.
# Supported Things
The following Tapo-Devices are supported
# P100/P105 SmartPlug (WiFi)
- Power On/Off
- Wi-Fi signal (SignalStrength)
- On-Time (Time in seconds device is switched on)
# P110 EnergyMonitoring SmartPlug (WiFi)
- Power On/Off
- Wi-Fi signal (SignalStrength)
- On-Time (Time in seconds device is switched on)
- actual PowerUsage (Watt)
- today EnergyUsage (Wh)
- today Runtime (Time in seconds device was on today)
# L510(Series) dimmable SmartBulb (WiFi)
- Light On/Off
- Brightnes (Dimmer) 0-100 %
- ColorTemperature (Number) 2500-6500 K
- Wi-Fi signal (SignalStrength)
- On-Time (Time in seconds device is switched on)
# L530(Series) MultiColor SmartBulb (WiFi)
- Light On/Off
- Brightnes (Dimmer) 0-100 %
- ColorTemperature (Number) 2500-6500 K
- Color (Color)
- Wi-Fi signal (SignalStrength)
- On-Time (Time in seconds device is switched on)
# L900/L920 LED-LightStrip (WiFi)
- Light On/Off
- Brightnes (Dimmer) 0-100 %
- ColorTemperature (Number) 2500-6500 K
- Color (Color)
- Wi-Fi signal (SignalStrength)
- On-Time (Time in seconds device is switched on)
# Prerequisites
Before using Smart Plugs with openHAB the devices must be connected to the Wi-Fi network. This can be done using the Tapo provided mobile app. You need to setup a bridge (Cloud-Login) to commiunicate with your devices.
Note: If the Tapo device is to be isolated from the internet e.g. on an IoT LAN, the P110 will not expose its energy and power data until it has successfully synchronised it's clock with an NTP server - at time of writing, this was pool.ntp.org
.
To satisfy this requirement while keeping the device isolated, your router should be configured to either permit udp/123
out to the internet or a NAT rule created to redirect all internet bound NTP traffic to a local NTP server.
# Discovery
Discovery is done by connecting to the Tapo-Cloud Service. All devices stored in your cloud account will be detected even if they are not in your network. You need to know the IP-Adress of your device. This must be set manually in the thing configuration
# Bridge Configuration
The bridge needs to be configured with by username
and password
(Tapo-Cloud login) .
This is used for device discovery and to create a handshake (cookie) to act with your devices over the local network.
The thing has the following configuration parameters:
Parameter | Description |
---|---|
username | Username (eMail) of your Tapo-Cloud |
password | Password of your Tapo-Cloud |
# Thing Configuration
The thing needs to be configured with ipAddress
.
The thing has the following configuration parameters:
Parameter | Description |
---|---|
ipAddress | IP Address of the device. |
pollingInterval | Refresh interval in seconds. Optional. The default is 30 seconds |
# Channels
All devices support some of the following channels:
group | channel | type | description | things supporting this channel |
---|---|---|---|---|
actuator | output | Switch | Power device on or off | P100, P105, P110, L510, L530, L900, L920 |
brightness | Dimmer | Brightness 0-100% | L510, L530, L900 | |
colorTemperature | Number | White-Color-Temp 2500-6500K | L510, L530, L900 | |
color | Color | Color | L530, L900 | |
device | wifiSignal | system.signal-strength | WiFi-quality-level | P100, P105, P110, L510, L530, L900, L920 |
onTime | Number:Time | seconds output is on | P100, P105, P110, L510, L530, L900, L920 | |
energy | actualPower | Number:Power | actual Power (Watt) | P110 |
todayEnergyUsage | Number:Energy | used energy today (Wh) | P110 | |
todayRuntime | Number:Time | seconds output was on today | P110 |
# Channel Refresh
When the thing receives a RefreshType
command the thing will send a new refreshRequest over http.
To minimize network traffic the default refresh-rate is set to 30 seconds. This can be reduced down to 10 seconds in advanced settings of the device. If any command was sent to a channel, it will do an immediately refresh of the whole device.
# Full Example
# tapocontrol.things:
tapocontrol:bridge:myTapoBridge "Cloud-Login" [ username="you@yourpovider.com", password="verysecret" ]
tapocontrol:P100:myTapoBridge:mySocket "My-Socket" (tapocontrol:bridge:myTapoBridge) [ ipAddress="192.168.178.150", pollingInterval=30 ]
tapocontrol:L510:myTapoBridge:whiteBulb "white-light" (tapocontrol:bridge:myTapoBridge) [ ipAddress="192.168.178.151", pollingInterval=30 ]
tapocontrol:L530:myTapoBridge:colorBulb "color-light" (tapocontrol:bridge:myTapoBridge) [ ipAddress="192.168.178.152", pollingInterval=30 ]
tapocontrol:L900:myTapoBridge:myLightStrip "light-strip" (tapocontrol:bridge:myTapoBridge) [ ipAddress="192.168.178.153", pollingInterval=30 ]
Bridge tapocontrol:bridge:secondBridgeExample "Cloud-Login" [ username="youtoo@anyprovider.com", password="verysecret" ] {
Thing tapocontrol:P110:secondBridgeExample:mySocket "My-Socket" [ ipAddress="192.168.101.51", pollingInterval=30 ]
}
# tapocontrol.items:
Switch TAPO_SOCKET "socket" { channel="tapocontrol:P100:myTapoBridge:mySocket:actuator#output" }
← Tankerkönig Telegram →