Target Communications Library - Linux
=====================================

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

You will need the GNU compiler collection (gcc) and development
tools.  The code is tested on kernel version 2.2.16 (Red Hat 7)
but should work on any kernel or distribution from 2.0 on up.
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/x86_linux/tc_linux.tar)
  into the current directory.  Change to the created directory.

    tar xvf <path>/tc_linux.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.linux Makefile

4.

  Edit the makefile.  You should not need to change anything, however
  you may want to review the gcc 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/ttyS0 for
  the first serial port ("COM1" under DOS).

  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 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.

  If necessary, upload executable(s) to the target system.  This is
  only required if the current machine is not being used to run the
  samples.

9.

  Connect the Target Communications serial port between the target
  processor 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.
  
10.

  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 Linux box 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.

11.

  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 Linux version as yet).
  
12.

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