openhab-addons/bundles/org.openhab.binding.tapocontrol

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.

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