cm11 v0.2							17.Feb.03

    cm11 is a command-line program to control and monitor the X10 CM11A
    module from Linux or other Unix platforms.

    The cm11 program and accompanying documentation have been placed into
    the public domain in February, 2003, by the authors, Erik Olson
    and Jim McBeath.

    For the latest version of cm11, look in:
       http://www.alumni.caltech.edu/~jimmc/cm11/

    cm11 has the following features:

	- Two-way communication with CM11A module.

	- Macro language to download macros to CM11A.

	- Monitor mode to watch commands received by CM11A.

	- Written in C, easy to compile.

    cm11 has the following limitations:

	- No screen-mode (for either Unix or Windows)

	- Occasionally loses synch with the CM11A; if anyone knows how
	  to fix this problem, please send in a patch.

    To unpack cm11 version X.Y:
    1. unzip cm11-X_Y.zip
       This will produce the directory cm11-X_Y.
    2. cd cm11-X_Y
       This puts you into the directory, where you can compile and test.

    To compile cm11 version X_Y:
    1. cd into the cm11-X_Y directory and do a "make". This will build
       the cm11 program in the src directory.

    To test cm11:
    1. Use the command
	 cm11 -i "ON A1"
       to turn on device A1.
    2. Run cm11 in monitor mode with the command
	 cm11 -m
       then push an ON, OFF, or DIM button on a controller.  The CM11A should
       receive this request, and the cm11 program should print a message to
       the screen.
    For more, point your browser to doc/index.html and read the documentation.

    To build a cm11 distribution version X_Y:
    1. Check these files to make sure they contain the correct information:
        README		Version and date
    	VERSION		Version and date
    2. In the main cm11 directory, do "make rel".  This will create
       a directory called cm11-X_Y where X_Y is extracted from the vX.Y
       version string in the VERSION file.
    3. In the main cm11 directory, do "make relzip".  This will create
       the file cm11-X_Y.zip from the cm11-X_Y directory.  This is the file
       to distribute.

    cm11 has been compiled and run on the following machines:
	Linux (Intel x86), Red Hat 7.3
	Sparc Solaris 2.5 + gcc 2.7.2
    If you compile on a platform not in this list, please let me know.

    Original Author: 
      Erik Olson
      http://www.thekrib.com/Authors/erik.html

    Current Maintainer:
      Jim McBeath
      http://www.alumni.caltech.edu/~jimmc/