Target Communications Library - Solaris
=======================================

Installing and Building
-----------------------

You will need either the Sun or the GNU compiler collection (gcc) 
and development tools.  You can download binary executables for
gcc and GNU make from http://www.sunfreeware.com.  The TCL was
tested using gcc on Solaris 8 on an Ultra 10 workstation.  The
purpose of this is not so much to demonstrate TCL under Solaris,
but rather TCL on a Sparc processor, which is a big-endian RISC
processor (as opposed to 80x86 which is little-endian CISC).
You will find that the source code is almost identical to that 
in the Linux distribution (only the tc_conf.h file is slightly
different).

At a command prompt, perform the following steps.

1.

  Move to your home directory.  Extraction of the tar archive (next
  step) will create a directory called 'dm' in this directory.
  
    cd

2.

  Untar the distribution archive 
  (e.g. /cdrom/dc710/samples/dmtarget/arch/Sparc_sol8/tc_solaris.tar)
  into the current directory.  Change to the new dm directory.

    tar xvf <path>/tc_solaris.tar
    cd dm

3.

  Copy the makefile i.e. make a copy you can edit, as well as call it by
  the default makefile name.
  
    cp makefile.solaris Makefile

4.

  Edit the makefile.  You should not need to change anything, however
  you may want to review the compiler options.

5.

  Edit configuration items.  The file tc_sysv.c contains a definition
  of the serial device to use e.g.

    #define SERIAL_DEVICE "/dev/ttyS2"

  This should be changed to the appropriate device e.g. /dev/ttya for
  the first serial port or /dev/ttyb for the second.  This is somewhat
  dependent on the exact model of workstation.

  tc_conf.h also contains many configuration items, however this should
  not need to be altered for the demo programs.

6.

  Ensure that the gcc or cc executable directory (usually /usr/bin or 
  /usr/local/bin) is in your current path.

7.

  Execute the MAKE comand to create all object files and executables.
  
    make

8.

  Connect the Target Communications serial port between the workstation
  and the DeviceMate.  Only a 3-wire connection is required
  (ground, Tx data and Rx data).  Ensure that the Tx data of each side
  is connected to the Rx data of the other.
  
9.

  Some of the demo programs have special requirements.  For example,
  the TCP/IP demos will require that the DeviceMate is actually
  connected to an ethernet LAN.  In addition, sometimes a third
  machine is required to act as a server (or client).  Either the PC
  which is running Dynamic C or the workstation can be made to fulfil 
  this role, if set up correctly.  The comments in the source code of
  each demo document further details and requirements.

10.

  Start the appropriate DeviceMate demo program on the DeviceMate.
  This requires you to switch to Dynamic C, select, compile and
  run the DeviceMate program.  (Sadly, Dynamic C must be run on
  a Windows box - no Solaris version as yet).
  
11.

  Run the demo program on the target.  Note that use of the /dev/tty*
  device may require the process to be running with root privileges.
