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