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

# TapoControl Binding

# 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="[email protected]", 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="[email protected]", 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" }

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

← Tankerkönig Telegram →