Contents
========
The archive contains the following software : 
- xAAL/ : xAAL Python Library  
- services/ : xAAL Services (not needed for basic operation) 
    		  - xAALCache/     : Caching service
		  - xAALMetadata/  : Metadata repos

- gateways/ : Gateways for 
  			  - Knx/      KNX (eibd) gateway 
			  - Zwave/    Zwave gateway (based on OpenZwave) use Zwave S2 stick
			  - X10/	  X10 gateway for X10 (CM11 adapter) 

- apps : xAAL Apps :
  	   	 - xAALBrowser/  Web interface for xAAL network 
		 - cmdLine/

- devices : some device xAAL wrapper : 
		- Spotify Player
		- WiiBalance 

Installation
============
To install the software, simply add the xAAL directory in your PYTHONPATH. For
example, in a bash terminal: 
 $ export PYTHONPATH=/home/jkx/Projets/SID/xAAL/trunk/

At this time, there is no setup.py, nor pip support (see the TODO list). 

Tests
=====
- Edit the xAAL/config.py to fix CONF_DIR, and SCHEMA_DIR 
- CONF_DIR: default config file path (Be careful, the directory must exist !!)
- SCHEMA_DIR:  path where you store the schemas. 
- Schemas are mainly used for the xAALBrowser at this time. 

- Start the dumper. 
  cd apps/cmdline; python ./dumper.py 
  ========= <xAAL.Messages.XAALMessage instance at 0x7f72637d0dd0> =========
  *****Header*****	
  Devtype	dumper
  Action: 	alive
  Msgtype: 	notify
  Version: 	0.2
  Cipher: 	
  Signature: 	
  Target: 	00000000-0000-0000-0000-000000000000
  Source: 	543b8b7c-3db3-11e4-b99d-3c77e618c6f7

- Start devices/spotify; python ./spotify.py 
  Empty config file /home/jkx/.xaal/SpotifyAgent.conf
  ========= <xAAL.Messages.XAALMessage instance at 0x7f4a5f5bf518> =========
  *****Header*****	
  Devtype	spotify.agent
  Action: 	alive
  Msgtype: 	notify
  Version: 	0.2
  Cipher: 	
  Signature: 	
  Target: 	00000000-0000-0000-0000-000000000000
  Source: 	e58c04d0-3db3-11e4-97b3-3c77e618c6f7

- Send command through xAAL to spotify 
  cd apps/cmdline; python send.py e58d7d24-3db3-11e4-97b3-3c77e618c6f7 stop

- Now you can try the web interface : 
  - Install cherrypy if needed (apt-get install python-cherrypy3)
  - Start the web-server : cd apps/xAALBrowser; python xAALBrowserIHM.py 
  - Browse http://localhost:8080/devices 
  
  
SUPPORT
=======
If you find bugs, please let us know at : 


TODO
==== 
- Add a setup.py / pip support .. 
- Fix the ifdown / ifup error. Right now, on an ifdown the xAAL API raise 
  an socket.error. 

WARNING
======= 
- The API send a "attributesChange" each time a attribute change. This
  doesn't follow exactly the xAAL specs.


--
The xAAL Team.