API for local communication with LIFX devices over a LAN with asyncio.
Project description
aiolifxc
aiolifxc is a Python 3/asyncio library to control Lifx LED lightbulbs over your LAN.
Most of it was originally taken from Meghan Clarkk lifxlan package and adapted to Python 3 (and asyncio obviously)
This is a fork from François Wautier’s package. It uses coroutines as opposed to callbacks. If you prefer callbacks, please see his implementation instead. This was forked from version 0.5.0.
This should be considered Alpha status. While it works, and seems to work well, there are still changes I wish to make that may break the API.
Installation
We are on PyPi so:
pip3 install aiolifx
or:
python3 -m pip install aiolifx
- NOTE: When installing with Python 3.4, the installation produce an error message
(syntax error). This can be safely ignored.
How to use
Essentially, you create an object with at least 2 methods:
register
unregister
You then start the LifxDiscovery task in asyncio. It will register any new light it finds. All the method communicating with the bulb can be passed a callback function to react to the bulb response. The callback should take 2 parameters:
a light object
the response message
The easiest way is to look at the file in the examples directory. “Wifi” and “Uptime” use a callback to print the info when it is returned.
In essence, the test program is this:
class bulbs(): """ A simple class with a register and unregister methods """ def __init__(self): self.bulbs=[] def register(self,bulb): self.bulbs.append(bulb) def unregister(self,bulb): idx=0 for x in list([ y.mac_addr for y in self.bulbs]): if x == bulb.mac_addr: del(self.bulbs[idx]) break idx+=1 def readin(): """Reading from stdin and displaying menu""" selection = sys.stdin.readline().strip("\n") DoSomething() MyBulbs= bulbs() loop = aio.get_event_loop() coro = loop.create_datagram_endpoint( partial(alix.LifxDiscovery,loop, MyBulbs), local_addr=('0.0.0.0', UDP_BROADCAST_PORT)) try: loop.add_reader(sys.stdin,readin) server = loop.create_task(coro) loop.run_forever() except: pass finally: server.cancel() loop.remove_reader(sys.stdin) loop.close()
Other things worth noting:
Whilst LifxDiscover uses UDP broadcast, the bulbs are connected with Unicast UDP
The socket connecting to a bulb is not closed unless the bulb is deemed to have gone the way of the Dodo. I’ve been using that for days with no problem
You can select to used IPv6 connection to the bulbs by passing an IPv6 prefix to LifxDiscover. It’s only been tried with /64 prefix. If you want to use a /48 prefix, add “:” (colon) at the end of the prefix and pray. (This means 2 colons at the end!)
I only have Original 1000, so I could not test with other types of bulbs
Unlike in lifxlan, set_waveform takes a dictionary with the right keys instead of all those parameters
History
0.5.1 (2017-06-26)
Initial version after fork from https://github.com/frawau/aiolifx
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file aiolifxc-0.5.1.tar.gz
.
File metadata
- Download URL: aiolifxc-0.5.1.tar.gz
- Upload date:
- Size: 23.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7ec1c6aee0e522ac643fca780e682342d7bb6313bd83ad844395d8a5477136df |
|
MD5 | f173e95594bcf27335744dd97b9cd3df |
|
BLAKE2b-256 | 40d06ce333a966a2fee3fd0fc27d15a9baf44e9cad8787165eb52252bfbe9a51 |
Provenance
File details
Details for the file aiolifxc-0.5.1-py2.py3-none-any.whl
.
File metadata
- Download URL: aiolifxc-0.5.1-py2.py3-none-any.whl
- Upload date:
- Size: 23.9 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc8bf5750398a7a97a8c480d30f5cc458e0585ceda8de1eac75674a14624117c |
|
MD5 | 634199bc3990c95103f37807c979ad1c |
|
BLAKE2b-256 | 3349c953af3476ea42beca27012d40a8a40a69c02201df50f073e8b145d7cce7 |