conradlin / Cloud-Based_TP-Link-to-SmartThings-Integration

Cloud-based TP-Link Integration

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Cloud-Based TP-Link Bulb, Plug, and Switch to SmartThing Integration - BETA

Two versions of TP-Link to Smart Things Integraion now exist:

a. Hub-Based TP-Link to Smart Things Integraion: The Hub-based version that requires an always on Hub device (bridge). Attributes:

Requires user-configured (PC, Android, Raspberry) Hub with node.js and server script.
Does not require a token captured from the TP-Link cloud.
Manual device installation and setting static IP addresses.

b. Cloud-Based TP-Link to Smart Things Integraion: The new version (currently in Beta) that relies on the TP-Link Kasa cloud. Attributes:

Reliant on TP-Link cloud (and the continued availabilty of same).
Must have TP-Link account.
Simpler setup. Install Service Manager and applicable device handlers. Runs service Manager.

Cloud-Based Pre-requisites:

a. A valid TP-Link Kasa account (must have login name and password.

b. TP-Link devices installed and in 'Remote Control' mode (done in Kasa App)

Caveate: The author is not associated with the company TP-Link except as an owner/consumer of their products. All date used to create thes applets was garnered from public-domain data.

Installation

Installation instruction can be found:

a.  Top-level in the document 'Cloud TP-Link to SmartThing Installation.pdf'.
b.  In the README.md file in the 'Service Manager' and 'Device Handlers' folders.

Cloud Beta Updates and Objectives

UPDATES (Dallas, Texas USA times uploaded to GitHub)
08-09 (1330) -  CRITICAL.  Updated Service Manager (addDevices) to correct typo causing failure
                to install of LB110 bulbs.
08-09 (0700) -  Minor.  Updated Service Manager for additional logging and limiting the automatic
                getToken to three times w/o user intervention.  Updated Installation Instructions
                to ask user to open logging and copy log if there are errors on install.
08-07 (0600) -  CRITICAL.  Fixed Service Manager code eliminating error causing installation crash.
                was only the Service Manager loaded 08-07 (1600).
08-06 (1600) -  Minor.  Varions fixes to error handling and messaging within Device Handlers and
                Service Manager.
08-06 (1400) -  Documentation:  Updated 'TP-Link SmartThings Implementation'

Objectives of Cloud Beta:

1.  Verify that all devices install appropriatly.  Open:  LB110. NEED USER INPUT!
2.  Determine actual Token life-span (done on my local copy) and update as required.
    (after one week, still open)
3.  Verify Energy Monitor functions.  Open: HS110, LB110.  NEED USER INPUT!
4.  Capture miscellaneous errors.  NEED USER INPUT!

TP-Link Devices Supported:

HS100, Hs105, HS110, HS200 - (Cloud)TP-Link_HS_Series.groovy
LB100, LB110 - (Cloud)TP-Link_LB100_110.groovy
LB120 - (Cloud)TP-Link_LB120.groovy
LB130 - (Cloud)TP-Link_LB130.groovy
ENERGY MONITOR VARIANTS
HS110 with energy monitor functions - (Cloud)TP-Link_HS110_Emeter.groovy
LB110 with energy monitor functions - (Cloud)TP-Link_LB110_Emeter.groovy
LB120 with energy monitor functions - (Cloud)TP-Link_LB120_Emeter.groovy
LB130 with energy monitor functions - (Cloud)TP-Link_LB130_Emeter.groovy

Files:

Service Manager. The installation and communications application.

Device Handlers. All SmartThings device handlers. Names are clear as to device applicability.

Documentation. Design Notes, and Interface description, TP-Link Cloud Error Codes.

About

Cloud-based TP-Link Integration


Languages

Language:Groovy 100.0%