nagpioapi: Demonstrates the use of the gpio APIs

Summary

This application demonstrates the use of the gpio APIs: NAconfigureGPIOpin,
NAsetGPIOpin and NAgetGPIOpin.  The APIs for these functions can be found in
the Signal Mulitplexing and GPIO Function section of the On-line Help.

This program assumes requires a short circuit loop back connection on pins
2 and 3 of the available alternate COM port.  Furthermore, it also assumes
the standard out is not directed to the serial port whose pins are reconfigured
by this example application.  The application will not function if the standard 
output collides with the GPIO measurements.

The application will operate on 9750 and 9360 Dev boards, and on the Connect
Core 9P 9215 rev A board.  The application uses the following for these boards:

                        ns9360_a        ns9750_a    connectcore9p9215_a
                     connectcore9c_a                connectcorewi9p9215_a
                     connectcorewi9c_a
                        --------        --------    -------------------
    Reference Design.     SER D         SER C      SER C
    Serial Port         "/com/3"       "/com/2"    "/com/2"
    GPIO OUTPUT PIN        44             40       11
    GPIO INPUT PIN         45             41       15

On ns9360_a development board
=============================
Note for proper operation on the 9360 Dev board, the JMP2 settings must be 
selecting the serial D pins (configurations C or D).  For customizing the 
NS9360 Dev board, see the 9360 Jumpers and Components guide, or use the 
following setup on JMP2:
                A  B  C
            1   o  ====
            2   o  ====
            3   o  ====
            4   o  ====
            5   o  ====
            6   ====  o
            7   ====  o
            8   ====  o


On connectcore9c_a and connectcorewi9c_a
========================================
Place the jumper between pin 21 (GPIO 44) and 22 (GPIO 45) on P17 of JS Kit.

On connectcore9p9215_a and connectcorewi9p9215_a
================================================
Place the jumper between pin B4 (GPIO 11) and pin B5 (GPIO 15) on X2 connector
of JS Kit

Applicability
=============
This application is specifically built and tested to run on Digi International
NS9750 and NS9360-based development boards.

Build Information

One GNU make file is provided.  Build the target 'image' to
generate an image that can be debugged with gdb, and the file 
image.bin which can be written to flash if the bootloader is used.
Build the target 'rom.bin' to create the file rom.bin which 
can be written to ROM if the bootloader is not used.


appconf.h         sets application configuration settings
makefile          Make file for the GNU toolset.
readme            this file
root.c            contains 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 code used to read settings in appconf.h


The application build file links in the following libraries.  

libbsp.a           		contains the BSP code
libtcpip.a         		contains the Net+Works TCP/IP stack
libtx.a            		contains the ThreadX kernel
libfilesys.a       		contains the file system libraries
libposix.a         		contains the POSIX layer libraries
libflash.a         		contains the Flash driver API library
libpppintf.a		    contains the PPP Interface Library
libftpclnt.a       		contains the FTP client library
libftpsvr.a        		contains the FTP server library
libemailc.a        		contains the Email client library
libdnsclnt.a            contains the DNS Client library
libtelnsvr.a       		contains the Telnet server library
libds.a       	   		contains the Directory Services library
libaddp.a		   		contains the ADDP Library
libssh.a		   		contains the SSH Library
librphttpd.a       		contains the NET+Works AWS API library.
libmanapi.a        		contains the NET+Works Management API library.
libusbmassstorage.a    	contains the USB Mass Storage library
libusbhost.a           	contains the USB Host library
libfat32.a             	contains the FAT32 library
libldap3.a       		contains the LDAPv3 client API library
libsntp.a				contains the SNTP API Library
libgui.a 				contains the GUI Library
libcrypto.a 			contains the Crypto Library
libssl.a 				contains the SSL Library
libsflash.a         	contains the Serial Flash driver API library
libnarmapi.a

The application uses the following files located in the
netos\src\linkerScripts directory.  These files are generated
when the BSP is built.

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

