=======================================
Package PimucHA - Version 0.8
=======================================


Overview:
---------

PimucHA
Python integrated multi controllers Home Automation:

- Yet an another Home Automation Software
- Integrate differents controllers
- Interoperate each other
- Communicate over local network
- Self configuration for detectors, devices and sensors 




Main features:
--------------

Controller with local port access:

- USB
- Serial
- Ftdi 


Run in the same thread to:

- receive, parse and decode events
- get a command from queue, encode it and send to local and / or net controller 


Access as client to an controller on the local network:

- can receive events from
- can send command to
- using TCP sockets (receive and send)
- using XMLRPC (send) 


Act as:

- server to broadcast events for multiple clients
- access point for receiving commands from multiple clients 




Requirements:
-------------

General requirements:

- Python version 2.6.8 or higher 


Requirements for an local controller:

- Package piHAcontrollers
- System interface modules
- Python modules
- pyUSB version 1.0 recommended
- pySerial version 2.5 or higher
- python-ftdi or pylibftdi 


Requirements for access as client to net controller:

- No requirements for client
- On the system running net controller
- Package piHAcontrollers
- Server running and accepting connections 


Requirements for parsing and decoding events:

- Package piHAparsers




Installation from source distribution:
--------------------------------------

- Download the archive, unpack it, enter distribution root directory
- From a terminal, run setup script
- Setup will install
- piHAcontrollers and all stuff under directory piHAcontrollers
- piHAcore and all stuff under directory piHAcore
- piHAparsers and all stuff under directory piHAparsers 

- For details, see http://www.pimucha.com




Usages:
-------

- Script piHAcore/start.py 

- For details, see http://www.pimucha.com

