readme_imx21.txt

MX21_InitCodeLib.rar freescale mx21系列ARM芯片9328的WINCE5.0下初始化代码

//________________________________________________________________________
//                      i.MX21 (Tahiti) Specific Information
//________________________________________________________________________

How Do I Flash MetroTRK onto the i.MX21 board?
--------------------------------------------------------
Browse to this folder:  
<CW>\ARM_EABI_Tools\MetroTRK\Processor\arm\board\motorola\iMX21
There are binary files located here that you can use to flash MetroTRK on your
board. 

For how to Flash TRK binaries to the target, refer Flash Programmer Quick start
Guide OR Targetting Manual. Flash Programmer module is integrated with the IDE.

How Do I Configure a MetroTRK Remote Debugger Connection?
--------------------------------------------------------
If there is no remote connection set up for the MetroTRK:
Select Preferences from the Edit pull-down menu to open the IDE pref panels.
Select Remote Connections from the Debugger pref panels.  Click Add.
Give your new connection a name and select ARM - MetroTRK for the Debugger.
Select the Serial Port that your DBMX1 board is connected to and configure 
the other settings to match the DBMX1's hardware.**  Click OK to close the 
New Connection window.

If there is a remote connection set up for the MetroTRK:
Select Preferences from the Edit pull-down menu to open the IDE pref panels.
Select the Remote Connections from the Debugger pref panels.  Select the 
remote connection set up for the MetroTRK and hit Change to access the 
connection window.  From there you can reconfigure any of the settings you
wish.

**Note: See the Readme located at 
<CW>\Layout\ARM_EABI_Tools\MetroTRK\Processor\arm\board\motorola\iMX21
for more info on the proper settings for a tahiti connection.

How Do I Configure a Multi-ICE Remote Debugger Connection?
---------------------------------------------------------
If there is no remote connection set up for the Multi-ICE:
Select Preferences from the Edit pull-down menu to open the IDE pref panels.
Select the Remote Connections from the Debugger pref panels.  Click Add.
Give your new connection a name and select ARM RDI for the Debugger.
Click Browse and browse to the Multi-ICE.dll in your ARM Multi-ICE 
installation***.  Click Configure.  This will bring up ARM's Multi-ICE Setup 
window.  Follow the directions to configure your connection.  When you've
saved your configuration file, click OK to close the New Connection window.

If there is a remote connection set up for the RDI:
Select Preferences from the Edit pull-down menu to open the IDE pref panels.
Select the Remote Connections from the Debugger pref panels.  Select the 
remote connection set up for the Multi-ICE and hit Change to access the 
connection window.  From there you can select Configure to reconfigure 
your connection.

***Note: The Multi-ICE is not included in the CodeWarrior installation,
and must be purchased separately. Ensure that MULTI-ICE 2.2.5 or higher is used
with i.MX21 board (926EJS core based)

Configure ARM Debugger Settings Preference Panel when Multi-ICE is used
-----------------------------------------------------------------------

By default, no initialization file is selected by the stationery. But,
the targets require this file to initialize the memory system on the
i.MX21 board.

Check the "Use Target Initialization File"
Browse to the <install>\ARM_EABI_Support\Initialization_Files folder.

pick up the init file for i.MX1 board

--------------------------------------------------
Debugging ROM Debug  & Rom Release Stationery:
-------------------------------------------------
While Debugging ROM Stationery, ensure that the following options in the "ARM Debugger 
Setting Panel" Under 'Program Download options' for both 'Initial Launch' & 'Successive 
Runs' are  unchecked.
'Executable', 
'Constant Data',
'Initialized Data',
'Uninitialized Data'.


//------------------------------------------------------------------------
//	General Overview
//------------------------------------------------------------------------

This project stationery is designed to get you up and running
quickly with CodeWarrior for ARM.  This includes stationery for debugging 
on the DragonBall MX1 and MX-Lite via the MetroTRK and the Multi-ICE.
There are other stationery set up for debugging with the Virtio, as well as
on the Integrator920T and Evaluator7T boards via the MetroTRK and Multi-ICE. 

The project has Five targets:  RAM Debug, RAM Rel,ROM Debug,Rom Release and Build All.
The Debug & Release targets are almost identical, but are 
set to build at different compiler optimizations, Minimum(0) & Most(1) 
respectively.  The Build All target has been included for 
your convenience and simply builds all of the other targets.

//------------------------------------------------------------------------
//	Getting Started
//------------------------------------------------------------------------

Most of the target settings are already configured for you, but you
will need to configure the debugger settings.  Once you have a project 
created from this stationery, open the Edit pull-down menu and select
Debug Settings... (Alt+F7). Select the Remote Debugging pref panel from 
the left column.  If want to debug via the MetroTRK, select the Connection 
that you've set up in the IDE Preferences for Remote Debugging via the 
MetroTRK.  Otherwise, select the Connection that you've set up for Remote 
Debugging via the Multi-ICE.  We recommend that you make sure the project 
is working properly before you begin adding your own code.  Select Make 
and then Debug from the Project pull-down menu****.  If everything is working 
properly, the debugger window should come up and be stopped at main().  If 
there is a problem, please consult the Targeting_ARM_Systems.pdf for more 
information on debugging via the MetroTRK, or consult ARM's Multi-ICE 
documentation.

****Note: When debugging via the Multi-ICE, remember to launch the Multi-ICE 
server before launching the CW debugger.  If you've installed ARM's 
Multi-ICE software, you should be able to access the Multi-ICE server 
through your Startup menu.  Alternatively, execute Multi-ICEServer.exe in
your ARM Multi-ICE installation.  You may also reconfigure your CW 
Multi-ICE Remote Debugger Connection, which will bring up a Failed to 
Connect window that will ask whether you want to launch the Multi-ICE 
server.

//------------------------------------------------------------------------
//	Adding your own code
//------------------------------------------------------------------------

Once everything is working as expected, you can begin adding your own code
to the project.  Keep in mind that we provide this as an example of how to
get up and running quickly with CodeWarrior.  Feel free to modify any of 
the source provided. 


//------------------------------------------------------------------------
//	Contacting Metrowerks
//------------------------------------------------------------------------

For bug reports, technical questions, and suggestions, please use the
forms in the Release Notes folder on the CD, and send them to:

[e-mail]        : For bug reports.
[e-mail]      : For suggestions.