CF.book Page 11 Friday, July 8, 2005 8:59 AM
1
Introduction
This manual explains how to use CodeWarrior™ development tools to develop applications for the Freescale
™
ColdFire
®
family of integrated microprocessors.
This chapter consists of these sections:
• Read the Developer Notes
• Features
• CodeWarrior Editions
• About this Manual
• Documentation Overview
• Additional Information Resources
Read the Developer Notes
Before using the CodeWarrior IDE, read the developer notes. These notes contain important information about last-minute changes, bug fixes, incompatible elements, or other topics that may not be included in this manual.
NOTE
The release notes for specific components of the CodeWarrior IDE are located at location: {CodeWarrior_Dir}\Release_Notes, where
{CodeWarrior_Dir} is the CodeWarrior installation directory.
If you are new to the CodeWarrior IDE, read this chapter and the Getting Started chapter.
This chapter provides references to resources of interest to new users; the Getting Started chapter helps you become familiar with the software features.
Features
The CodeWarrior Development Studio for ColdFire Architectures includes these features:
• Latest version of the CodeWarrior IDE, which the IDE User’s Guide explains.
• Support for the latest ColdFire processors: CFM5213, and variants CFM5211 and
CFM5212.
ColdFire Architectures v6.0 - Targeting Manual 11
CF.book Page 12 Friday, July 8, 2005 8:59 AM
Introduction
CodeWarrior Editions
• Support for previous processors of the ColdFire family, such as CFM547x/548x,
CFM5307, CFM523x, CFM5282, CFM5275, and CFM5249. For more information,
see ColdFire Processor
• Flash-programmer and hardware-diagnostics support. For more information, see
Using Hardware Tools.
• USB debugging support through the P&E Micro protocol. For more information, see
P&E Microsystems Remote Connections.
• Instruction Set Simulator (ISS) for V2 and V4e processor cores. For more
information, see Remote Connections for Debugging and Instruction Set Simulator
• For previous processors of the ColdFire family, support for the simple profiler. For
more information, see Using the Simple Profiler and the Profiler User’s Guide. (This
profiler support is not available for CFM5213, CFM5211, or CFM5212 processors.)
CodeWarrior Editions
There are three editions of CodeWarrior™ Development Studio for ColdFire
®
Architectures, version 6.0. Table 1.1 shows their feature differences.
Table 1.1 CodeWarrior ColdFire 6.0 Edition Features
Feature Special Edition
IDE
Compiles source code
Code size restrictions
Compiler optimization
levels
Yes
ASM and C
128KB
Unlimited
3rd-party plug-ins No RTOS
CodeWarrior Debugger Yes
Debugger hardware connections
P&E Parallel and
USB
Standard
Edition
Yes
ASM and C
None
Unlimited
No RTOS
Yes
P&E Parallel and
USB
V2, V4e simulator No Yes
Professional Edition
Yes
ASM, C, and C++
None
Unlimited
Unlimited RTOS plug-ins
Yes
P&E Parallel, USB, and
Lightning; Abatron serial and
TCP/IP
Yes
12 ColdFire Architectures v6.0 - Targeting Manual
CF.book Page 13 Friday, July 8, 2005 8:59 AM
Introduction
About this Manual
Table 1.1 CodeWarrior ColdFire 6.0 Edition Features ( continued)
Feature
Flash programmers
Special Edition
CodeWarrior Flash
Programmer (129 megabytes) and
ColdFire Flasher standalone plug-in
Not available
Standard
Edition
CodeWarrior Flash
Programmer and
ColdFire Flasher standalone plug-in
Not available
Professional Edition
CodeWarrior Flash
Programmer and ColdFire
Flasher standalone plug-in
Plug-ins available Real time operating system (RTOS)
Availability Free with evaluation board
Available through all channels
Available through all channels.
30-day evaluation copy also available.
About this Manual
Table 1.2 lists the contents of this manual.
Table 1.2 Chapter, Appendix Contents
Chapter/Appendix
Introduction
Getting Started
Application Tutorial
Target Settings
Compilers
ELF Linker and Command
Language
ColdFire Linker Notes
Inline Assembly
Debugging
Explains
New features; contents of this manual; technical support; further documentation
System requirements; overview of CodeWarrior development tools
Tutorial for writing and debugging programs
Controlling the compiler and linker
ColdFire-specific compiler informationColdFire
Linker and linker command file information
Linker capabilities
Compiler support for inline assembly
Debugger settings panels; remote debugging connections
ColdFire Architectures v6.0 - Targeting Manual 13
CF.book Page 14 Friday, July 8, 2005 8:59 AM
Introduction
Documentation Overview
Table 1.2 Chapter, Appendix Contents ( continued)
Chapter/Appendix
Instruction Set Simulator
Libraries and Runtime Code
Using Hardware Tools
Command-Line Tools
Using Debug Initialization
Files
Memory Configuration Files
Explains
Instruction Set Simulator, including configuration for your requirements.
Libraries for ColdFire targets
Flash programmer and hardware diagnostics tools
Command-line compiler, assembler, linker, and debugger
Debug initialization files
Defining access for areas of memory
Documentation Overview
Documentation for your CodeWarrior tools comes in three formats:
• PDF manuals — in subdirectory \Help\PDF of your installation directory.
– The
Target Settings
and
Debugging
chapters of this Targeting Manual are
extensions of the IDE User’s Guide.
– The Compilers
and
Inline Assembly chapters of this Targeting Manual are
extensions of the C Compilers Reference.
– The
Libraries and Runtime Code
chapter of this Targeting Manual is an extension of the MSL C Reference and the MSL C++ Reference.
NOTE
For complete information about a particular topic, you may need to look in this
Targeting manual and in the corresponding generic CodeWarrior manual.
To view any PDF document, you need Adobe
®
Acrobat
®
Reader software, which you can download from: http://www.adobe.com/acrobat
• CHM help files — information in Microsoft
®
HTML Help CHM format, in folder
\Help
of the CodeWarrior installation directory. To view this information, start the
CodeWarrior IDE, then select Help > Online Manuals from the main menu bar.
• CodeWarrior online help — information about using the IDE and understanding error messages. To access this information, start the CodeWarrior IDE, then select
Help > CodeWarrior Help from the main menu bar.
14 ColdFire Architectures v6.0 - Targeting Manual
CF.book Page 15 Friday, July 8, 2005 8:59 AM
Introduction
Additional Information Resources
Additional Information Resources
• For general information about the CodeWarrior IDE and debugger, see the IDE
User’s Guide.
• For information specific to the C/C++ front-end compiler, see the C Compilers
Reference.
• For information about Metrowerks standard C/C++ libraries, see the MSL C
Reference and the MSL C++ Reference.
• For instructions on programming in C, C++, Java, and Pascal — all in one environment, see the Discover Programming edition of CodeWarrior software.
• For PDF-format documentation about Freescale processors and cores, go to the
\Freescale_Documentation
subdirectory of your CodeWarrior installation directory.
• For Freescale documentation and resources, visit the Freescale, Inc. web site: http://www.freescale.com
• For additional electronic-design and embedded-system resources, visit the EG3
Communications, Inc. web site: http://www.eg3.com
• For monthly and weekly forum information about programming embedded systems
(including source-code examples), visit the Embedded Systems Programming magazine web site: http://www.embedded.com
ColdFire Architectures v6.0 - Targeting Manual 15
CF.book Page 16 Friday, July 8, 2005 8:59 AM
Introduction
Additional Information Resources
16 ColdFire Architectures v6.0 - Targeting Manual
