Target Communications Library - Borland C
=========================================

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

You will need Borland C/C++ version 4.5 or later.  This is available
by free download, since only the command-line compiler is required.
In a DOS command window, perform the following steps.

1.

  Create a directory to contain the contents of the distribution.
  For the purpose of this description, the name C:\DM is assumed.
  Move to this directory.
  
    c:
    mkdir \dm
    cd \dm

2.

  Unzip the distribution archive 
  (e.g. c:\dc710\samples\dmtarget\arch\i386\tc_bc.zip)
  into the \dm directory.  You can use WINZIP or any similar archive
  manager.

3.

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

4.

  Edit the makefile.  You may need to change some things like the
  location of your Borland C distribution.

5.

  Edit configuration items.  The file tc_386ex.h specifies a COM port
  number to use (1 or 2).  This should be set according to your
  target requirements.  tc_conf.h also contains many configuration
  items, however this should not need to be altered for the demo
  programs.

6.

  Ensure that the Borland C executables directory 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.

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).  The PC which
  is running Dynamic C 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.
  
12.

  Run the demo program on the target.
