Metadata-Version: 2.1
Name: python-selve
Version: 1.3.1
Summary: Python library for interfacing with selve devices using the USB-RF controller
Home-page: https://github.com/gpulido/python-selve
Author: Gabriel Pulido
Author-email: gabriel.pulidodetorres@gmail.com
Keywords: selve blind awning shutter usb rf
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
License-File: LICENSE
Requires-Dist: pySerial
Requires-Dist: pybase64
Requires-Dist: untangle

Python control of selve devices through USB-RF Gateway
======================================================

|PyPI version|

A simple Python API for controlling RF Blinds / shutters / awning from selve using a USB-RF Gateway.
At present, only Iveo devices are supported.

The complete protocol specification can be found at `selve <https://www.selve.de/de/service/software-updates/service-entwicklungstool-commeo-usb-rf-gateway/>`_

Example of use
--------------

Create a new instance of the gateway:

.. code-block:: python

    gat = Gateway(portname)


portname is the name of the serial port where the usb rf gateway is listed on the os. Please refer to the serial library documentation.

By default the gateway will discover all Iveo devices already registered onto the gateway.

To access them:

.. code-block:: python

    gat.devices()

Will return a list of IveoDevices()

Each IveoDevice can be controlled by using the already defined commands: stop() moveUp() moveToIntermediatePosition1() and moveToIntermediatePosition2()

The library also allows to send directly commands to the gateway without the need of using the IveoDevice abstraction just create the command and execute using the gateway:

.. code-block:: python

    command = IveoCommandGetIds()
    command.execute(gat)

Once executed the response is stored in the command instance for later user or just to discard.

.. |PyPI version| image:: https://badge.fury.io/py/python-selve.svg
   :target: https://badge.fury.io/py/python-selve






