natcptoserial: Serial Tunnel Example Application.

This application is a simple example demonstrating how to very simply pass
data recieved on a serial port to a TCP socket connection as well as take recieved
TCP data and pass it to the serial port. The inbound TCP socket connection is established through
a third party tool or application such as Microsoft Windows telnet client or Hypterminal using a
Winsock connection. This application will only accept a single TCP socket connection at a time.

This application also demonstrates how to read and write to a serial port within a single
thread using the select() function.

This example should work on all development boards that have a serial port available.


Required Configuration:

- Set NA_TCPSERIAL_TCP_PORT in tcpserial.h to the port you wish to connect to a TCP
    client application. The default is 2101.
                                                  
- Set NA_TCPSERIAL_SERIAL_PORT in tcpserial.h for the serial port. 
  The default is BSP_STDIO_PORT in bsp_sys.h. 

  **Note it is important to use a different serial port than the one set as your 
    BSP_CLI_COM_PORT in bsp_cli.h if CLI is enabled. 
    You need to disable BSP_CLI_ENABLE in bsp_cli.h if you're going to use the same serial port
    as BSP_CLI_COM_PORT.


- Set NA_TCPSERIAL_SER_BAUD in tcpserial.h for the serial baud rate. The default is 9600.


To Communicate Through the Target Device:

- Once the example is running, connect to the development board using the appropriate serial cable

- Open the corresponding COM port on your PC with a terminal emulation program, such as the ESP's serial
  window, a Hyper Terminal Sessions, etc. Use 9600 baud, 8 data bits, No Partiy, and 1 stopbits.

- Open a TCP socket connection to the module using a TCP client application such as Microsoft Windows telnet
  client or Hypter Terminal using Winsock. Make sure to note the port used as defined by PORTNUM in root.c.

- Once both connections are open, what you type in one application window should should be seen on the other.


The following files are provided with this application:

appconf.h           sets application configuration settings
makefile            Make file for the GNU toolset.
readme              this file
root.c              contains the applicationStart() function

In addition, the following files in the BSP directory are built
as part of this application:

reset.s         contains the reset code
appconf_api.c   contains run time access to the application configuration


The application uses the following files located in the
netos\src\bsp\platforms\<platform> directory.

bootldr.dat     bootloader configuration file used to generate the
                file image.bin.  It controls the information placed
                in the bootloader header of the image.

image.ldr       GNU linker script used to build an image that can
                be debugged and used with the bootloader.
                
customize.ldr   Customizable GNU linker script
