© Copyright 2005,2007, Logic Product Development, Inc. All Rights Reserved.

NOTICE:
This file contains source code, ideas, techniques, and information (the
Information) which are Proprietary and Confidential Information of Logic 
Product Development, Inc.  This Information may not be used by or disclosed to
any third party except under written license, and shall be subject to the
limitations prescribed under license.

Note: Please refer to the appropriate Zoom Development Kit User's Manual for
further instruction. It is located on the included Zoom Starter CD in the 
Documentation folder and is also available for download from Logic's website:
www.logicpd.com

-------------------------------------------------------------------------------
       Sample Application Overview
-------------------------------------------------------------------------------

The objective of this section is to build a sample application for the Zoom 
Development Kit. The build procedure uses the 'make' utility in Cygwin ('make' 
is a utility common in Unix environments). Included in the 'sample_app' 
directory tree are files called makefiles. Makefiles contain rules that the 
'make' utility follows when building an application.

For the sample application, the user uses the 'make' command line. For example,
the command 'make clean' instructs 'make' to remove previous build results 
from the directory tree.  For details on 'make', refer to the documentation 
on the CD under: 
\tools\Documentation\GNU_Docs\Using_make\make.pdf.

Included with the Zoom Development kit is a rudimentary sample application that
can be built using the GNU tools, and downloaded using the LogicLoader 
bootloader. The application is extremely trivial and intended to serve only as
a starting point for software developers. The purpose is to verify that the
development tools (compiler, linker, etc.) have been correctly installed and 
are working as expected. The sample application will blink the GPIO1 LED on the
Development Kit baseboard, or for those of you with a ColdFire EVB or LITE
Development Kit, it will blink LED D12.

With a little experimentation, developers can modify the source code in
cygwin\home\logic\sample_app\$version\ (where $version is the version of the 
app), rebuild the sample application, download and verify the modified sample
application. You are encouraged to explore the sample application directories 
in order to understand how applications are built for the Zoom Development Kit.

The sample application can be built for two scenarios. The make file will 
launch a build script that displays a menu from which to pick your processor,
followed by a menu to pick the location. Choosing flash will build a sample
application that is meant to be download into SDRAM and burned into flash. 
Choosing RAM will build an application that you can download to and run out of
SDRAM. You can use the 'load elf' command to download the application. If you 
chose to build for flash, you will want to then use the 'burn' application to 
program it into flash. In either case you will want to use the 'exec' command 
to run the application. For more information on using the sample application 
please refer to the Zoom Development Kit User's Manual. For more information on
LogicLoader commands consult the LogicLoader User's Manual or use the help
available from the losh> prompt.

-------------------------------------------------------------------------------
       Installing Sample Application files
-------------------------------------------------------------------------------

The sample application is available for download from Logic's website:
www.logicpd.com/auth/. Once you have downloaded and unpacked the ZIP file,
double-click the 'apps_install.exe' executable and follow the onscreen 
instructions to install the sample application.