4/14/03

This directory contains a utility that can be used to retrieve debug
information from unit running NET+OS.  Normally, data sent to stdout
by printf is directed to a serial port, but some devices might not 
have serial ports.  In this case, output can be directed to the 
UDP Debug device driver.  This driver stores data output to stdout in
a buffer and sends the contents of this buffer to applications that
poll it, and so allows printf style debugging on devices that do not
have a serial port.

Do the following to use this utility:

1.  Set BSP_INCLUDE_UDP_DEBUG_DRIVER to TRUE in bsp.h.
2.  Rebuild the BSP.
3.  Set APP_STDIO_PORT to "/udpdb/0" in appconf.h.
4.  Rebuild your application.
5.  Start your application.
6.  Start the UDPDB.EXE program on a workstation after your application
    has brought up the network.
    
At this point, printf output should be displayed on your workstation.

The command line for this application is:

    udpdb ip-address [port]
    
where ip-address is replaced by the ip-address of the unit under debug,
and port, which is an optional parameter, must be set to the value of
BSP_UDP_DEBUG_PORT in bsp.h.  If port is not specified, then it will
default to 12345.

This application can be built with the GNU tools that ship with Cygwin.
These tools are shipped with NET+OS for GNU.  If you do not have them,
then you can download them for free from http://www.cygwin.com/.

To build using Microsoft Visual C++ to remove the cygwin1.dll dependency,
use these commands:

nmake /f "udpdb.mak" CFG="udpdb - Win32 Release"

nmake /f "udpdb.mak" CFG="udpdb - Win32 Release" clean

