
                   Installing Heyu on a Unix-like system.

Heyu requires a reasonable compiler (GCC works well) and the 'make' program.

Note: If you're upgrading from a previous version of Heyu, run 'heyu stop'
under that version before proceeding.

Quickstart:
    sh ./Configure  [option]   (As a normal user)
    make                       (As a normal user)
    su                         (Become superuser)
    make install 	       (As superuser)
    exit                       (Revert to normal user)
    heyu info		       (As a normal user, to test installation)

(The 'make install' requires that you have write permissions to
/usr/local/bin, man page, and other directories.)

Kindly report any compile errors or warnings to the author.

It can take 5-8 seconds to set up the heyu_relay daemon and initialize
the CM11A interface the first time Heyu is run, e.g., with 'heyu info'.

Running 'heyu help' will display the long list of Heyu commands.
These are further explained in the man page heyu(1).

CUSTOMIZING
-----------
The Configure script creates a Makefile by running 'uname -s' and then
adding known good configuration options to the Makefile.  The contents
of Makefile.in is then appended to the Makefile.  Changes to the makefile
should be made in Configure or Makefile.in.

If Configure can not figure out what your system is, you can try
sh ./Configure generic
    or
sh ./Configure sysv

If those don't work, we'll have to figure it out by hand. Please contact
the author so your discoveries can be integrated into the next release.


OPTIONS
-------
  
By default, support for the X10 CM17A "Firecracker" device is compiled
into Heyu.  As there is no known version of this device available which
transmits at frequencies other than the 310 MHz used for transceivers
in North America, users outside this region may wish to compile without
CM17A support. Since the CM17A is both powered and actuated by the DTR
and RTS serial lines, support for this device might as well also be
omitted if your serial port hardware does not support these lines.
To do so, run the Configure step mentioned above with the '-nocm17a'
option, i.e.,

    sh ./Configure -nocm17a

By default, support for Extended Type 0 (Shutter and Shade) commands
is compiled into Heyu.  As there is only one module known to support
these commands (the 230V, 50Hz Marmitek SW10 Shutter Motor Controller
sold in Europe), this support may be omitted by using Configure with
the '-noext0' option, i.e., 

   sh ./Configure -noext0

If you change any Configure parameter and have previously run 'make',
first run 'make clean' to delete the existing object (*.o) files.

Notes for Mac OS X:
-------------------
The heyu executable is installed in directory /usr/local/bin, which
is not on the Mac's default PATH.  You will have to add this directory
to your PATH.

Newer Macs don't have an actual RS232 serial port, only a USB port,
and a USB/Serial adapter is required.  The manufacturer's adapter
driver will usually add two or more different devices in /dev
(and often with "usbserial" as part of the name).  You'll have
to experiment to see which one works with Heyu by trying the
different names in the TTY directive in the heyu configuration
file.  The device name which also includes "cu" rather than "tty"
has been found to work on the (few) Macs tested thusfar.


Notes for AT&T SysV r4:
----------------------
The function uname(1) used to determine the system type for
Configure does not distinguish this OS from other sysv systems.
Supply the system type parameter "attsvr4" to Configure, i.e.,
run 'sh ./Configure attsvr4'.

