===========================================================================
Nucleus Samples - Serial 
===========================================================================


Purpose & Goals
---------------

The purpose behind this sample application is to illustrate use of Serial
Middleware APIs to use a UART device on the target.

NOTE: If there is only one serial port on the target and it is marked as
stdio port, this application will not be able to use that port.


What You Will Need
------------------

To run this demonstration you will need to connect the available serial
ports on the target board to a PCs RS-232 ports using a straight-through
or null-modem cable and launch console application like Tera Term or
HyperTerminal and configure it based on corresponding UART configurations
in the platform file of the target. Typically, the console configuration is
as following:

    Port         = COM1
    Baud Rate    = 115200
    Data Bits    = 8
    Stop Bits    = 1
    Parity       = none
    Flow Control = none
 

Components Used
---------------

Please reference the sample *.config file for a minimal configuration.  Depending on the product
these can be found within the \samples\ folder or at the base of the system project named 
<app_project_name>.<build_config>.config


Building the Application
------------------------

Open the provided development shell, e.g. Nucleus Dev Shell (CS GNU ARM).bat, and execute the 
following command for the desired platform. 

make PLATFORM=<platform> 

For example, <platform> can be "at91sam9263ek". For more information, please refer to Nucleus ReadyStart reference manual.

As a result of above command, one of the generated output images should be "serial_sample.out".


How To Run The Application
--------------------------

(1) Download the image (*.out) to target and run

(2) View the output on all serial ports. 

(3) If there are more than one serial interfaces connected, then multiple statements should be printed 
on the console application specifying the time elapsed since running the demo. There should be one statement printed per interface.




