This page is part of archived documentation for openHAB 4.1. 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. For precise channel-description look at channels-table below
| DeviceType | ThingType | Description |
|---|---|---|
| SmartPlug (Wi-Fi) | P100 | Smart Socket |
| P105 | Smart Mini Socket | |
| EnergyMonitoring SmartPlug (Wi-Fi) | P110 | Energy Monitoring Smart Socket |
| P115 | Energy Monitoring Mini Smart Socket | |
| Power Strip (Wi-Fi) | P300 | Smart Wi-Fi Power Strip - 3 sockets |
| Dimmable SmartBulb (Wi-Fi) | L510 | Dimmable White-Light Smart-Bulb (E27) |
| L610 | Dimmable White-Light Smart-Spot (GU10) | |
| MultiColor SmartBulb (Wi-Fi) | L530 | Multicolor Smart-Bulb (E27) |
| L630 | Multicolor Smart-Spot (GU10) | |
| MultiColor LightStrip (Wi-Fi) | L900 | Multicolor RGB Dimmable LightStrip (5m) |
| L920 | Multicolor RGB-IC ColorZone LightStrip (5m) | |
| L930 | Multicolor RGBW-IC 50-Zone LightStrip (5m) |
# 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, P115, L510, L530, L610, L630, L900, L920, L930 |
| output1 | Switch | Power socket 1 on or off | P300 | |
| output2 | Switch | Power socket 2 on or off | P300 | |
| output3 | Switch | Power socket 3 on or off | P300 | |
| brightness | Dimmer | Brightness 0-100% | L510, L530, L610, L630, L900, L920 | |
| colorTemperature | Number | White-Color-Temp 2500-6500K | L510, L530, L610, L630, L900, L920 | |
| color | Color | Color | L530, L630, L900, L920 | |
| effects | fxName | String | Active lightning effect | L530 |
| device | wifiSignal | Number | WiFi-quality-level | P100, P105, P110, P115, L510, L530, L610, L630, L900, L920, L930 |
| onTime | Number:Time | seconds output is on | P100, P105, P110, P115, L510, L530, L900, L920, L930 | |
| energy | actualPower | Number:Power | actual Power (Watt) | P110, P115 |
| todayEnergyUsage | Number:Energy | used energy today (Wh) | P110, P115 | |
| todayRuntime | Number:Time | seconds output was on today | P110, P115 |
# 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 P110 mySocket "My-Socket" [ ipAddress="192.168.101.51", pollingInterval=30 ]
}
# tapocontrol.items:
Switch TAPO_SOCKET "socket" { channel="tapocontrol:P100:myTapoBridge:mySocket:actuator#output" }