Phytec phyCORE-PXAG49 Programming manual

A product of a PHYTEC Technology Holding company
phyCORE-PXAG49
QuickStart Instructions
Using PHYTEC FlashToolsOCF for on-chip Flash and the
Tasking XA Embedded Development Environment (EDE)
Evaluation Version
Note: The PHYTEC Spectrum CD includes the electronic version of
the phyCORE-PXAGx English Hardware Manual
Hinweis: Die PHYTEC Spectrum CD beinhaltet die elektronische
Version des deutschen phyCORE-PXAGx Hardware Manuals
Edition: July 2002

phyCORE-PXAG49 QuickStart Instructions
© PHYTEC Meßtechnik GmbH 2002 L-481e_4
In this manual are descriptions for copyrighted products that are not explicitly
indicated as such. The absence of the trademark () and copyright () symbols
does not imply that a product is not protected. Additionally, registered patents and
trademarks are similarly not expressly indicated in this manual.
The information in this document has been carefully checked and is believed to be
entirely reliable. However, PHYTEC Meßtechnik GmbH assumes no
responsibility for any inaccuracies. PHYTEC Meßtechnik GmbH neither gives any
guarantee nor accepts any liability whatsoever for consequential damages resulting
from the use of this manual or its associated product. PHYTEC Meßtechnik
GmbH reserves the right to alter the information contained herein without prior
notification and accepts no responsibility for any damages which might result.
Additionally, PHYTEC Meßtechnik GmbH offers no guarantee nor accepts any
liability for damages arising from the improper usage or improper installation of
the hardware or software. PHYTEC Meßtechnik GmbH further reserves the right
to alter the layout and/or design of the hardware without prior notification and
accepts no liability for doing so.
Copyright 2002 PHYTEC Meßtechnik GmbH, D-55129 Mainz.
Rights - including those of translation, reprint, broadcast, photomechanical or
similar reproduction and storage or processing in computer systems, in whole or in
part - are reserved. No reproduction may occur without the express written
consent from PHYTEC Meßtechnik GmbH.
EUROPE NORTH AMERICA
Address: PHYTEC Technologie Holding AG
Robert-Koch-Str. 39
D-55129 Mainz
GERMANY
PHYTEC America LLC
203 Parfitt Way SW, Suite G100
Bainbridge Island, WA 98110
USA
Ordering
Information: [phone] [e-mail] 1 [phone] [e-mail]
Technical
Support: [phone] [email protected] 1 [phone] [e-mail]
Fax: [phone] [phone]
Web Site: http://www.phytec.de http://www.phytec.com
4th Edition: July 2002

Table of Contents
© PHYTEC Meßtechnik GmbH 2002 L-481e_4
1 Introduction to the Rapid Development Kit...........................................1
1.1 Rapid Development Kit Documentation ......................................1
1.2 Overview of this QuickStart Instruction.......................................2
1.3 System Requirements ...................................................................3
1.4 The PHYTEC phyCORE-PXAG49..............................................4
1.5 The Tasking XA Embedded Development
Environment (EDE)......................................................................7
2 Getting Started........................................................................................11
2.1 Installing Rapid Development Kit Software...............................11
2.2 Interfacing the phyCORE-PXAG49 to a Host-PC .....................18
2.3 Starting PHYTEC FlashToolsOCF for Windows.......................20
2.4 Downloading Example Code with FlashTools...........................21
2.4.1 "Blinky".........................................................................27
2.4.2 "Hello"...........................................................................29
3 Getting More Involved............................................................................35
3.1 Starting the Tasking Tool Chain.................................................35
3.2 Creating a New Project and Adding an Existing Source File.....37
3.3 Modifying the Source Code........................................................45
3.4 Saving the Modifications............................................................46
3.5 Setting Tool Chain Options ........................................................46
3.6 Building the Project....................................................................53
3.7 Downloading the Output File .....................................................54
3.8 “Hello2”......................................................................................55
3.8.1 Creating a New Project..................................................55
3.8.2 Modifying the Example Source.....................................56
3.8.3 Setting Tool Chain Options...........................................57
3.8.4 Building the New Project ..............................................58
3.8.5 Downloading the Output File........................................59
3.8.6 Starting the Terminal Emulation Program.....................60

phyCORE-PXAG49 QuickStart Instructions
© PHYTEC Meßtechnik GmbH 2002 L-481e_4
4 Debugging................................................................................................61
4.1 Creating a Debug Project and Preparing the Debugger .............62
4.1.1 Creating a New Project .................................................62
4.2 Setting Options for Target..........................................................63
4.3 Preparing the Debugger..............................................................69
4.4 Starting the Debugger.................................................................70
4.5 Tasking CrossView Pro Debug Features....................................71
4.6 Using the Tasking CrossView Pro Debug Features...................73
4.6.1 Single Stepping and Watch Window.............................73
4.6.2 Breakpoints....................................................................76
4.6.3 Exiting CrossView Pro..................................................78
4.7 Changing Target Settings for the "Final Version" .....................79
5 Advanced User Information...................................................................81
5.1 FlashTools for On-Chip Flash....................................................81
5.2 Start.src.......................................................................................82
5.3 Linking and Locating .................................................................83
Index of Figures
Figure 1: Mounting the phyCORE-PXAG49 onto the
phyCORE Development Board LD 5V......................................18
Figure 2: Important Connectors, Buttons and Suitable Jumper Settings
on the phyCORE Development Board LD 5V...........................19
Figure 3: Power Connector........................................................................19

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 1
1 Introduction to the Rapid Development Kit
This QuickStart provides:
•general information on the PHYTEC phyCORE-PXAG49 Single
Board Computer (SBC)
•an overview of the Tasking XA Embedded Development
Environment (EDE) evaluation version, and
•instructions on how to run example programs on the
phyCORE-PXAG49, mounted on the PHYTEC
phyCORE Development Board LD 5V, in conjunction with the
Tasking EDE
Please refer to the phyCORE-PXAGx Hardware Manual for specific
information on such board-level features as jumper configuration,
memory mapping and pin layout. Selecting the links on the electronic
version of this document links to the applicable section of the
phyCORE-PXAGx Hardware Manual.
1.1 Rapid Development Kit Documentation
This “Rapid Development Kit” (RDK) includes the following
electronic documentation on the enclosed “PHYTEC Spectrum
CD-ROM”:
•the PHYTEC phyCORE-PXAGx Hardware Manual and phyCORE
Development Board LD 5V Hardware Manual
•controller User's Manuals and Data Sheets
•this QuickStart Instruction with general “Rapid Development Kit”
description, software installation hints and three example programs
enabling quick out-of-the box start-up of the phyCORE-PXAG49
in conjunction with the Tasking software development tools

phyCORE-PXAG49 QuickStart Instructions
2© PHYTEC Meßtechnik GmbH 2002 L-481e_4
1.2 Overview of this QuickStart Instruction
This QuickStart Instruction gives a general “Rapid Development Kit”
description, as well as software installation hints and three example
programs enabling quick out-of-the box start-up of the
phyCORE-PXAG49 in conjunction with the Tasking XA software
development tools. It is structured as follows:
1) The “Getting Started” section uses two example programs:
•"Blinky" and "Hello" to demonstrate the download of user code
to the Flash device using PHYTEC FlashTools for on-chip
Flash (OCF).
2) The “Getting More Involved" section provides step-by-step
instructions on how to modify both examples, create and build
new projects and generate and download output files to the
phyCORE-PXAG49 using the Tasking tool chain and
FlashToolsOCF.
3) The "Debugging”section provides a third example program
- “Debug” - to demonstrate simple debug functions using the
Tasking XA EDE simulator debug environment.
In addition to dedicated data for this Rapid Development Kit, this
CD-ROM contains supplemental information on embedded
microcontroller design and development.

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 3
1.3 System Requirements
Use of this “Rapid Development Kit” requires:
•the phyCORE-PXAG49 SBC module
•the phyCORE Development Board LD 5V with the included DB-9
serial cable and AC adapter supplying 5 VDC/min. 500 mA
•the PHYTEC Spectrum CD
•an IBM-compatible host-PC (486 or higher running at least
Windows95/98)
For more information and example updates, please refer to the
following sources:
http://www.phytec.com - or - http://www.phytec.de
[e-mail] - or - [e-mail]
http://www.tasking.com
[e-mail] (North America)
[e-mail] (Germany)

phyCORE-PXAG49 QuickStart Instructions
4© PHYTEC Meßtechnik GmbH 2002 L-481e_4
1.4 The PHYTEC phyCORE-PXAG49
The phyCORE-PXAG49 represents an affordable, yet highly
functional Single Board Computer (SBC) solution in subminiature
dimensions (55 x 47 mm). The standard board is populated with a
16-bit Philips PXAG49 controller featuring 64 kByte on-chip Flash.
All applicable data/address lines and applicable signals extend from
the underlying logic devices to standard-width (2.54 mm / 0.10 in.)
pin headers lining the circuit board edges. This enables the
phyCORE-PXAG49 to be plugged like a “big chip” into target
hardware.
The standard memory configuration of the phyCORE-PXAG49
features 64 kByte on-chip Flash, 256 kByte external SRAM and
256 kByte external Flash for additional code storage. Three Chip
Select signals are available for external I/O connectivity.
The module communicates by means of an RS-232 transceiver and
operates within a standard industrial range of 0 to +70 degrees C. It
requires only a 220 mA power source.
PHYTEC FlashToolsOCF enables easy on-board download of user
programs.

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 5
phyCORE-PXAG49 Technical Highlights
•SBC in subminiature dimensions (55 x 47 mm) achieved through
advanced SMD technology
•populated with an 44-pin packaged (PLCC) Philips
XA-compatible PXAG49 controller featuring 64 kByte on-chip
Flash
•minimal instruction cycle time of 102 ns at 29.4912 MHz clock
speed (standard)
•64 kByte on-chip Flash, enabling In-System Programming (ISP)
and In-Application Programming (IAP)
•256 kByte (up to 1 MByte) on-board SRAM
•256 kByte (up to 2 MByte) external Flash enabling In-System
Programming (ISP)
•4 to 32 kByte I²C EEPROM or 8 kByte FRAM
•I²C Real-Time Clock with internal quartz
•RS-232 serial interface
•three I/O Chip Select signals for connection to external peripherals
•requires only a +5 V / 220 mA power source
•operates in a temperature range of 0... 70°C
(optional -40... 85°C temperature range available)

phyCORE-PXAG49 QuickStart Instructions
6© PHYTEC Meßtechnik GmbH 2002 L-481e_4
The phyCORE Development Board LD 5V, in EURO-card
dimensions (160 x 100 mm), is fully equipped with all mechanical
and electrical components necessary for the speedy and secure
insertion, and subsequent programming, of PHYTEC
phyCORE series Single Board Computers with standard width
(2.54 mm/ 0.10 in.) pin header connectors. Simple jumper
configuration readies the Development Board’s connection to any
phyCORE module (standard header pins), which plug pins-down into
the contact strips mounted on the phyCORE Development
Board LD 5V.
phyCORE Development Board LD 5V Technical Highlights
•Reset signal controlled by push button or RS-232 control line
CTS0
•Boot signal controlled by push button or RS-232 control line
DSR0
•low voltage socket for supply with regulated input voltage 5 VDC
•additional supply voltage 3.3 VDC
•two DB-9 sockets (P1A, P1B) configurable as RS-232 interfaces
•two additional DB-9 plugs (P2A, P2B) configurable as
CAN interfaces, connector P2B optionally configurable as RS-485
interface
•simple jumper configuration allowing use of the
phyCORE Development Board LD 5V with various PHYTEC
phyCORE SBC’s
•one control LED D3 for quick testing of user software
•2 x 160-pin Molex connector (X2) enabling easy connectivity to
expansion boards (e.g. PHYTEC GPIO Expansion Board)

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 7
1.5 The Tasking XA Embedded Development Environment
(EDE)
The Tasking tool chain fully supports the entire XA-derivative
microcontroller family, including the Philips PXACx family. It
includes a C/C++/EC++ compiler, macroassembler, linker/locator and
the CrossView Pro simulator and ROM monitor debugger within the
EDE development environment.
Note:
The Tasking tool chain supports all in-circuit emulators that adhere to
the IEEE-695 debugging specification or support the Tasking a.out
format. The LCXA locator generates an Intel hexfile that is suitable
for programming into an EPROM device or downloading into on-chip
Flash on the PHYTEC phyCORE-PXAG49 target board.
The Tasking tool chain consists of the following executables:
•C Compiler ccxa.exe
•C++ Compiler cpxa.exe (not in eval version)
•Assembler asxa.exe
•Linker lkxa.exe
•Locator lcxa.exe
•Make Utility mkxa.exe
•Object reader prxa.exe (not in eval version)
•Library archiver arxa.exe (not in eval version)
•CrossView Pro xfwxa.exe (Windows-based)
•EDE ede.exe (Windows-based)

phyCORE-PXAG49 QuickStart Instructions
8© PHYTEC Meßtechnik GmbH 2002 L-481e_4
Once installed, the default destination location for these files is the
C:\DCXA\Bin folder for the evaluation version. If using the
professional (i.e. full) version of the Tasking tool chain, the default
destination location for these files is C:\CXA\Bin. The executables
are 32-bit Windows programs that run in command line mode except
for CrossView Pro and EDE which are Windows-based applications.
Access to these programs from Windows is accomplished with EDE.
The entire tool set can be run from EDE or directly from command
line using batch or make files.
The Tasking tools are also available for UNIX.
Embedded Development Environment (EDE)
EDE is a Windows-based Graphical User Interface for the C compiler
and assembler. All compiler, assembler and linker options are set with
simple mouse clicks. EDE runs under Windows 95/98/2000 and NT.
This Embedded Development Environment has been expressly
designed with the user in mind and includes a fully functional editor
based on the popular Codewright editor from Premia.
All EDE commands and functions are accessible via intuitive
pull-down menus with prompted selections. An extensive Help utility
and the complete set of online manuals is included. External
executables can be run from within EDE, including emulator
software.
XA C Compiler
The XA ANSI C compiler and ASXA assembler are designed
specifically for XA controllers. All common derivatives from Philips
can be selected from a list in the EDE Processor Options menu.
The Tasking XA compiler provides the fastest and smallest code
using industry benchmarks.

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 9
Debug Environment
CrossView Pro is a software simulator/ROM monitor debugger that
supports debugging either via software on a host-PC or in target
hardware. CrossView Pro enables the following debugging functions:
•run/halt, instruction/source stepping
•set (complex) breakpoints
•examine/change memory
•view the stack
•simulated I/O
•extended logging and scripting language
•powerful C like command language
•communication via RS-232
The CrossView Pro Simulator supports code coverage and profiling
to ensure your code runs efficiently, and high level language trace.
The restrictions of the evaluation version of the Tasking XA tool set
are described in ‘C:\Dcxa\Doc\Limitxa.hlp’. Other than these
restrictions, the evaluation tool chain functions exactly as the full
version. The evaluation version does not have a starting address
restriction and produces useful object code. This allows you to fully
evaluate the features of Tasking products in conjunction with the
PHYTEC Single Board Computer module. The full version has no
restrictions and is fully ANSI compliant.

phyCORE-PXAG49 QuickStart Instructions
10 © PHYTEC Meßtechnik GmbH 2002 L-481e_4

Getting Started
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 11
2 Getting Started
What you will learn with this Getting Started example:
•installing Rapid Development Kit software
•starting PHYTEC FlashToolsOCF for Windows download utility
•interfacing the phyCORE-PXAG49, mounted on the
phyCORE Development Board LD 5V, to a host-PC
•downloading example user code in Intel hexfile format from a
host-PC to the on-chip Flash memory using FlashToolsOCF
2.1 Installing Rapid Development Kit Software
•Insert the PHYTEC Spectrum CD into the CD-ROM drive of your
host-PC
The PHYTEC Spectrum CD should automatically launch a setup
program that installs the software required for the Rapid Development
Kit as specified by the user. Otherwise the setup program start.exe
can be manually executed from the root directory of the PHYTEC
Spectrum CD.

phyCORE-PXAG49 QuickStart Instructions
12 © PHYTEC Meßtechnik GmbH 2002 L-481e_4
The following window appears:
•Choose the Install Basic Product Files button.
•After accepting the Welcome window and license agreement,
select the destination location for installation of Rapid
Development Kit software and documentation.
The default destination location is C:\PHYBasic. All path and file
statements within this QuickStart Instruction are based on the
assumption that you accept the default install paths and drives. If you
decide to individually choose different paths and/or drives you must
consider this for all further file and path statements.
We recommend that you accept the default destination location.

Getting Started
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 13
•In the next window, select your Rapid Development Kit of choice
from the list of available products. By using the Change button,
advanced users can select in detail which options should be
installed for a specific product.
All Kit-specific content will be installed to a Kit-specific subfolder of
the Rapid Development Kit root folder that you have specified at the
beginning of the installation process.

phyCORE-PXAG49 QuickStart Instructions
14 © PHYTEC Meßtechnik GmbH 2002 L-481e_4
All software and tools for this phyCORE-PXAG49 RDK will be
installed to the \PHYBasic folder on your hard drive.
•In the next dialog you must choose whether to copy the selected
documentation as *.pdf files to your hard drive or to install a link
to the file on the Spectrum CD.
If you decide not to copy the documentation to your hard drive, you
will need the PHYTEC Spectrum CD-ROM each time you want to
access these documents. The installed links will refer to your
CD-ROM drive in this case.
If you decide to copy the electronic documentation to your hard drive,
the documentation for this phyCORE-PXAG49 RDK will also be
installed to the kit-specific subfolder. The manuals of the
phyCORE Development Board LD 5V are copied to their own
specific subfolder (e.g. \PHYBasic\DevBLD5V) because each
Development Board is suitable for multiple SBC’s and is not
dedicated to a specific RDK.
Setup will now add program icons to the program folder, named
PHYTEC.
•Click on Finish to complete the installation of PHYTEC products.

Getting Started
© PHYTEC Meßtechnik GmbH 2002 L-481e_4 15
In the next window, choose the Tasking for XA Software
Development Tool Chain for installation1.
The applicable Tasking tool chain must be installed to ensure
successful completion of this QuickStart Instruction. Failure to install
the proper software could lead to possible version conflicts, resulting
in functional problems.
We recommend that you install Tasking for XA from the Spectrum
CD-ROM even if other versions of the Tasking tool chain are already
installed on your system. These QuickStart Instructions and the demo
software included on the CD-ROM have been specifically tailored for
use with one another.
•After accepting the Welcome window and license agreement,
select the destination location for installation of the Tasking for
XA demo tool chain. The default location is C:\Dcxa.
1: If installing a different Software Development tool chain, please refer to the applicable
version of the QuickStart manual.

phyCORE-PXAG49 QuickStart Instructions
16 © PHYTEC Meßtechnik GmbH 2002 L-481e_4
•Disable the check box ’Yes, I want to launch EDE now’, the
Tasking tool chain is not required for the first examples. Click on
Finish to exit this installation step.
Additional software, such as Adobe Acrobat Reader, will also be
offered for installation.
In the following windows you can decide to install FlashToolsOCF
software and the Acrobat Reader.