xAAL Python stack

Install

Right now, there is no public release (pip based) of xAAL Python binding, so you have to install things from SVN or archive.

You can use virtualenv (recommended). Python 3 version isn't mandatory but highly recommended (some parts haven't be tested with Python 2 since a while).

First build a virtualenv :

$ virtualenv3 xaal_env
$ source xaal_env/bin/activate

Every time, you want to use the binding, you must source the activate script.

Download source files from SVN:

$ svn checkout https://redmine.telecom-bretagne.eu/svn/xaal/code/Python/trunk/ xaal_svn

First, install the xaal.lib package:

$ cd xaal_svn/libs/lib/
$ python setup.py develop

Install the monitor lib (needed for Dashboard, REST API..)

$ cd xaal_svn/libs/monitor/
$ python setup.py develop

Install the tools

$ cd xaal_svn/apps/tools
$ python setup.py develop

You can use the python setup.py install instead of develop, but modification to source files, won't be applied, you have to re-install it. Right now develop, is the best option.

Create the configuration files in your home directory:

$ mkdir ~/.xaal/
$ cp xaal_svn/libs/lib/xaal.ini.sample ~/.xaal/xaal.ini
$ xaal-keygen

xaal-keygen will compute an key for a given passphrase. Edit the xaal.ini file according to your needs.

Test

First, you can launch a message dumper with this tools

$ xaal-dumper
$ or xaal-tail 0

To start an fake lamp:

$ cd xaal_svn/devices/test/DummyDevices/
$ python lamp.py

To search for devices, you can use:

$ xaal-isalive
$ xaal-info xxxxxxxxxxxxxx <- uuid
$ xaal-walker

Notes

FAQ