'''
File:
        pyinsteon.py

Description:
        Insteon Home Automation Protocol library for Python (Smarthome 2412N, 2412S, 2412U)
        
        For more information regarding the technical details of the PLM:
                http://www.smarthome.com/manuals/2412sdevguide.pdf

Author(s): 
         Jason Sharpee <jason@sharpee.com>  http://www.sharpee.com
         mahmul @ #python
         Ene Uran 01/19/2008    http://www.daniweb.com/software-development/python/code/217019

        Based loosely on the Insteon_PLM.pm code:
        -       Expanded by Gregg Liming <gregg@limings.net>

License:
    This free software is licensed under the terms of the GNU public license, Version 1     

Usage:
    - Instantiate PyInsteon by passing in an interface
    - Call its methods
    - ?
    - Profit

Example: (see bottom of file) 

    def x10_received(houseCode, unitCode, commandCode):
        print 'X10 Received: %s%s->%s' % (houseCode, unitCode, commandCode)

    def insteon_received(*params):
        print 'Insteon REceived:', params

    pyI = PyInsteon(TCP('192.168.0.1', 9671))
    pyI.getVersion()
    pyI.sendX10('m', '2', 'on')
    pyI.onReceivedX10(x10_received)
    pyI.onReceivedInsteon(insteon_received)
    select.select([],[],[])   

Notes:
    - Only support 2412N right now
    - Insteon is not quite finished / untested
    - Read Style Guide @: http://www.python.org/dev/peps/pep-0008/

Created on Mar 26, 2011