Skip to content

Latest commit

 

History

History
38 lines (21 loc) · 2.32 KB

README.md

File metadata and controls

38 lines (21 loc) · 2.32 KB
Raw

A Python 3 API for interfacing with TP-Link LB130 smart bulbs. I also included a command line script called "l", which can be used to control all LB130 bulbs on your home network.

Most of the reverse engineering was adapted from Reverse Engineering the TP-Link HS110. The LB130 also has support for scheduling and anti-burglary measures, but I haven't implemented those features in this library. I might some other time

Overview

The library is designed to support several kinds of networking protocols, which are represented as instances of the TPLinkProtocol class. An instance of a LB130 controller uses a given protocol to communicate with one or more physical LB130 bulbs.

TPLinkProtocol

Abstract class representing a method of communicating with LB130 bulbs. Must implement the send function, and perform setup and cleanup in __enter__ and __exit__ functions.

Implemented and tested protocols accepted by the LB130 are:

  • TCP - A one-to-one TCP connection protocol between the client and an LB130 bulb. Will also fetch the bulb's response with every send.
  • UDP - A one-to-one UDP protocol between the client and an LB130 bulb.
  • UDP Broadcast - A one-to-many UDP broadcast on ip 255.255.255.255.
  • Cloud - A one-to-one connection using the TP-Link cloud API with token-based web requests. Tokens can be acquired given TP-Link login credentials.

TPLinkDevice

Base class for all TP-Link devices.

CloudTPLinkDevice

Base class for cloud-enabled TP-Link devices.

Supports registering the device with a TP-Link account and updating the device.

LB130

Controller using a TPLinkProtocol to communicate with one or more LB130 bulbs. Also has discover_local and discover_cloud functions to scan for LB130 bulbs on the local network or a registered cloud account.

encryption

Houses the four functions used by the LB130 to "encrypt" communication between the bulb and the user using an autokey XOR cipher. Discovered by the people from softScheck, though the LB130 expects headed messages for TCP connections, where the length of the packet is encoded into the 4-byte header in big endian, whereas the HS110 just requires any 4-byte header.

Made in my spare time for my own home setup and only tested on Manjaro Linux with Python 3.7 :)