Zoom Sample Application Readme.txt
-------------------------------------------------------------------------------
NOTICE:
This file contains source code, ideas, techniques, and information (the
Information) which are Proprietary and Confidential Information of Logic 
Product Development Company.  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 "Zoom i.MX LITEKIT User's Manual" for
further instructions. This manual is available for download from Logic's 
website: www.logicpd.com/auth/downloads/Zoom i.MX LITEKIT/

-------------------------------------------------------------------------------
       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 GNU Cross 
Development Tools Documentation download at: www.logicpd.com/downloads/1151/
and locate the document in the directory: 
.\GNU_Tools_Documentation\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.

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 have to burn the program into flash at the 
correct address (please see the "Zoom i.MX LITEKIT User's Manual" for that 
address and other instructions). 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.

(c)2008 Logic Product Development Company. All Rights Reserved. www.logicpd.com