Skip to main content

API for local communication with LIFX devices over a LAN with asyncio.

Project description

aiolifxc

https://img.shields.io/pypi/v/aiolifxc.svg https://img.shields.io/travis/brianmay/aiolifxc.svg Documentation Status Updates

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)

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

aiolifxc-0.5.1.tar.gz (23.3 kB view details)

Uploaded Source

Built Distribution

aiolifxc-0.5.1-py2.py3-none-any.whl (23.9 kB view details)

Uploaded Python 2 Python 3

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

Hashes for aiolifxc-0.5.1.tar.gz
Algorithm Hash digest
SHA256 7ec1c6aee0e522ac643fca780e682342d7bb6313bd83ad844395d8a5477136df
MD5 f173e95594bcf27335744dd97b9cd3df
BLAKE2b-256 40d06ce333a966a2fee3fd0fc27d15a9baf44e9cad8787165eb52252bfbe9a51

See more details on using hashes here.

Provenance

File details

Details for the file aiolifxc-0.5.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for aiolifxc-0.5.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 cc8bf5750398a7a97a8c480d30f5cc458e0585ceda8de1eac75674a14624117c
MD5 634199bc3990c95103f37807c979ad1c
BLAKE2b-256 3349c953af3476ea42beca27012d40a8a40a69c02201df50f073e8b145d7cce7

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page