Phytec phyCORE-XC161 Programming manual

A product of a PHYTEC Technology Holding company
phyCORE-XC161
with XC161CJ
QuickStart Instructions
Using PHYTEC FlashTools 3 and the Keil µVision2 Software
Evaluation Development Tool Chain
Note: The PHYTEC Spectrum CD includes the electronic version of
the English phyCORE-XC161 Hardware Manual
Edition: July 2003

phyCORE-XC161 with XC161CJ QuickStart Instructions
© PHYTEC Meßtechnik GmbH 2003 L-646e_1
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 2003 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
1st Edition: July 2003

Contents
© PHYTEC Meßtechnik GmbH 2003 L-646e_1 3
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-XC161.................................................4
1.5 The Keil µVision2 Software Development Tool Chain...............7
2 Getting Started...................................................................................11
2.1 Installing Rapid Development Kit Software...............................11
2.2 Interfacing the phyCORE-XC161 to a Host-PC.........................18
2.3 Starting PHYTEC FlashTools 3 .................................................20
2.4 Downloading Example Code with FlashTools 3........................21
2.4.1 "Blinky".........................................................................27
2.4.2 "Hello"...........................................................................29
3 Getting More Invloved......................................................................35
3.1 Starting the µVision2 Tool Chain...............................................35
3.2 Creating a New Project and Adding an Existing Source File.....36
3.3 Modifying the Source Code........................................................42
3.4 Saving the Modifications............................................................43
3.5 Setting Options for Target..........................................................43
3.6 Building the Project....................................................................46
3.7 Downloading the Output File .....................................................47
3.8 "Hello"........................................................................................48
3.8.1 Creating a New Project..................................................48
3.8.2 Modifying the Example Source.....................................49
3.8.3 Setting Target Options...................................................50
3.8.4 Building the New Project ..............................................50
3.8.5 Downloading the Output File........................................51
3.8.6 Starting the Terminal Emulation Program.....................52
4 Debugging...........................................................................................53
4.1 Creating a Debug Project and Preparing the Debugger..............54
4.1.1 Creating a New Project..................................................54
4.1.2 Setting Options for Target.............................................55
4.1.3 Preparing the Debugger.................................................59

phyCORE-XC161 with XC161CJ QuickStart Instructions
© PHYTEC Meßtechnik GmbH 2003 L-646e_1
4.2 Preparing the Target Hardware to Communicate with the
Debugger ....................................................................................61
4.3 Starting the Debugger.................................................................61
4.4 Keil µVision2 Debug Features...................................................63
4.5 Using the Keil µVision2 Debug Features...................................65
4.5.1 Serial Window...............................................................65
4.5.2 Breakpoints....................................................................66
4.5.3 Single Stepping and Watch Window.............................67
4.6 Running, Stopping and Resetting...............................................68
4.7 Resetting the Debugger and the phyCORE-XC161...................69
4.8 Changing Target Settings for the "Executable Version"............70
5 Advanced User Information.............................................................75
5.1 FlashTools 3 ...............................................................................75
5.2 Start-pc-XC161.a66....................................................................76
5.3 Linking and Locating .................................................................77
5.4 Debugging Using Monitor Kernel..............................................79
5.5 Demo for the Optional Ethernet Controller CS8900A-CQ........81
A Appendices.........................................................................................83
A1 Troubleshooting..........................................................................83
A1.1 µVision2 Debugger in Monitor Mode...........................83
A.2 Monitor Configuration Error.........................................84
Figures
Figure 1: phyCORE Development Board HD200 2.5V Overview............18
Figure 2: Default Setting for the phyCORE Development
Board HD200 2.5V.....................................................................19
Figure 3: Power Connector........................................................................19

Introduction
© PHYTEC Meßtechnik GmbH 2003 L-646e_1 1
1Introduction to the Rapid Development Kit
This QuickStart provides:
•general information on the PHYTEC phyCORE-XC161 Single
Board Computer (SBC),
•an overview of Keil’s µVision2 software development tool chain
evaluation version, and
•instructions on how to run example programs on the
phyCORE-XC161, mounted on the PHYTEC phyCORE
Development Board HD200 2.5V, in conjunction with Keil
software tools
Please refer to the phyCORE-XC161 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-XC161 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-XC161 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-XC161 in
conjunction with the Keil µVision2 software development tool
chain evaluation version

phyCORE-XC161 with XC161CJ QuickStart Instructions
2© PHYTEC Meßtechnik GmbH 2003 L-646e_1
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-XC161 in conjunction with Keil µVision2. 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 3.
2) The "Getting More Invloved" 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-XC161 using the Keil tools and FlashTools 3.
3) The "Debugging" section provides a third example
program - "Debug" - to demonstrate simple debug functions
using the Keil µVision2 debug environment.
In addition to dedicated data for this Rapid Development Kit, the
PHYTEC Spectrum CD-ROM contains supplemental information on
embedded microcontroller design and development.

Introduction
© PHYTEC Meßtechnik GmbH 2003 L-646e_1 3
1.3 System Requirements
Use of this "Rapid Development Kit" requires:
•the PHYTEC phyCORE-XC161
•the phyCORE Development Board HD200 2.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/NT)
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.keil.com
[email protected]

phyCORE-XC161 with XC161CJ QuickStart Instructions
4© PHYTEC Meßtechnik GmbH 2003 L-646e_1
1.4 The PHYTEC phyCORE-XC161
The phyCORE-XC161 represents an affordable yet highly functional
Single Board Computer (SBC) solution in sub-miniature dimensions
(60 x 53 mm). It is intended for use in memory-intensive applications
running within a CAN bus system. The standard board is populated
with an Infineon XC161CJ controller as well as a Real-Time Clock
which can be buffered by an external battery.
All applicable data/address lines and signals extend from the
underlying logic devices to two high-density Molex SMT pin header
connectors (pin width is 0.635 mm/25 mil) lining the circuit board
edges. This enables the phyCORE-XC161 to be plugged like a "big
chip" into target hardware.
The standard module runs at a 40 MHz internal clock speed
(delivering 25 ns instruction cycle) and offers 512 kByte (up to
1.5 MByte) SRAM and 256 kByte (up to 2 MByte) Flash on-board for
DATA and CODE storage.
The module communicates by means of 2 RS-232 transceiver and
2 CAN bus interfaces. The optional CS8900A 10Base-T Ethernet
controller enables implementation of the module in embedded
Internet devices. The phyCORE-XC161 operates within a standard
industrial range of 0 to +70°C and requires only a 220 mA power
source.
PHYTEC FlashTools 3 enables easy on-board download of user
programs.

Introduction
© PHYTEC Meßtechnik GmbH 2003 L-646e_1 5
phyCORE-XC161 (XC161CJ) Technical Highlights
•SBC in subminiature dimensions (60 x 53 mm) achieved through
modern SMD technology
•populated with an Infineon XC161CJ controller featuring two Full
2.0B on-chip CAN and operating in 16-bit, non-multiplexed bus
mode at 40 MHz CPU speed (25 ns/instruction cycle)
•512 kByte (up to 1.5 MByte) external SRAM (up to 1 MByte can
be buffered with an optional lithium battery)1
•256 kByte (up to 2 MByte) external Flash memory supporting
on-board download of user code from a host-PC in conjunction
with PHYTEC FlashTools 31
•no dedicated programming voltage required through use of 5 V
Flash-devices
•battery-buffered Real-Time Clock
•two serial interface via RS-232
•optional Ethernet controller
•16-channel A/D converter with 10-bit resolution
•two 2.0B Full-CAN interfaces
•requires a dual power supply of 5 VDC and 2.5 VDC/ <220 mA
1: Please contact PHYTEC for more information about additional module configurations.

phyCORE-XC161 with XC161CJ QuickStart Instructions
6© PHYTEC Meßtechnik GmbH 2003 L-646e_1
The phyCORE Development Board HD200 2.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 most PHYTEC phyCORE high-
density series Single Board Computers. Simple jumper configuration
readies the Development Board’s connection to the
phyCORE-XC161, which plugs into the receptacle contact strips
mounted on the Development Board HD200 2.5V.
phyCORE Development Board HD200 2.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 2.5 VDC
•two DB-9 sockets (P1A, P1B) configurable as RS-232 interfaces
•two additional DB-9 plugs (P2A, P2B) configurable as
CAN interfaces
•simple jumper configuration allowing use of the
phyCORE Development Board HD200 2.5V with various
PHYTEC phyCORE high-density SBC’s
•RJ45 Ethernet transformer module
•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 2003 L-646e_1 7
1.5 The Keil µVision2 Software Development Tool Chain
Keil µVision2 fully supports the entire Infineon C166 microcontroller
family. This includes a C compiler, macroassembler, Linker/Locator
and the Simulator and Target Monitor within the µVision2 IDE.
Specific chips supported are the 161, 163, 164-CI, 165, 166, 167Cx
and XC16x. Future derivatives are easily accommodated due to the
flexible Keil C compiler design.
µVision2 supports all in-circuit emulators that adhere to the Infineon
OMF166 debugging specification. The Keil OH166 Object-to-Hex
converter converts an absolute object file into an Intel hexfile that is
suitable for programming into an EPROM device or downloading into
external Flash on the PHYTEC phyCORE-XC161 target board.
µVision2 consists of the following executables:
•C Compiler c166.exe
•Assembler a166.exe
•Linker l166.exe
•Converter oh166.exe
•µVision2 Uv2.exe (a Windows-based application)
Once installed, the default destination location for the DOS based
files is the C:\Keil\C166\bin directory while µVision2 is in
C:\Keil\Uv2. Access to these programs from Windows is
accomplished with µVision2. The entire tool set can be run from
µVision2 or directly from DOS with batch files. The evaluation
version is limited to 4 kByte of object code. Other than these
restrictions, all features operate normally.

phyCORE-XC161 with XC161CJ QuickStart Instructions
8© PHYTEC Meßtechnik GmbH 2003 L-646e_1
µVision2 IDE
µVision2 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. µVision runs under
Windows 95/98/Me, NT, 2000 and XP. This Integrated Development
Environment (IDE) has been expressly designed with the user in mind
and includes a fully functional editor.
All IDE commands and functions are accessible via intuitive pull-
down menus with prompted selections. An extensive Help utility is
included. External executables can be run from within µVision2, in-
cluding emulator software.
C166 C Compiler for the Entire Infineon 166/167 Family
The C166 ANSI compiler and A166 assembler are designed
specifically for the Infineon 161, 163, C164CI, 165,166, 167, 167Cx,
XC16x and future derivatives. The C166 compiler easily integrates
into the Keil RTOS and interfaces and passes debug information to
the µVision2 Simulator and all in-circuit emulators. Extensions
provide access to on-chip peripherals.
The Keil C166 compiler provides the fastest and smallest code using
industry benchmarks.
A166 Macroassembler
The Professional Kit (PK) macroassembler is included with the
PK Compiler package or is available separately. It is DOS-based or
can be run from µVision2 and includes all utilities needed to complete
your project.

Introduction
© PHYTEC Meßtechnik GmbH 2003 L-646e_1 9
Debug Environment
µVision2 contains a software simulator supporting debugging either
via software on a host-PC or in target hardware. When operated in
conjunction with the Keil Monitor resident in target hardware
µVision2 enable the following debugging functions:
•run/halt,
•set breakpoints,
•examine/change memory,
•view the stack,
•view/set peripheral information
•apply virtual external signals.
µVision2 has a performance analysis feature to ensure your code runs
efficiently. In addition, µVision2 has a disassembler/assembler that
allows the modification of user code without recompiling. The
evaluation version of µVision2 is restricted to a 8 kByte in
manipulable code. Other than this restriction the evaluation tool chain
(EK) functions exactly as does the full (PK) version. The evaluation
version does not have a starting address restriction and produces
useful object code. This allows you to fully evaluate the features and
power of Keil products on the PHYTEC target board. The PK full
version has no restrictions and is fully ANSI compliant.
FR166 Full-Function RTOS for the Infineon C166 Family
The FR166 is a multi-tasking real-time operating system for the
Infineon 166 family. You can manage multiple tasks on a single CPU
making your programs much easier to develop. The RTX166 Full
includes CAN libraries. The RTX166 Tiny is a subset of the RTX166
Full and is included with all C166 C Compiler Kits. The EK version
of the tool chain does not include an RTOS.

phyCORE-XC161 with XC161CJ QuickStart Instructions
10 © PHYTEC Meßtechnik GmbH 2003 L-646e_1
CAN (Controller Area Network) Library
The RTX166 Full RTOS supports CAN controllers with the included
libraries. The CAN libraries are sold with the RTOS and support
11- and 29-bit message identifiers. Keil 166 and 8051 C compilers
interface with the RTOS and CAN libraries. Keil supports all CAN
microcontrollers based on the Infineon C505C, C515C, C164-CI,
C167Cx and XC16x. Future CAN products based on these 8051 or
C16x families are easily supported due to the flexible Keil Compiler
design.

Getting Started
© PHYTEC Meßtechnik GmbH 2003 L-646e_1 11
2Getting Started
What you will learn with this Getting Started example:
•installing Rapid Development Kit software
•starting PHYTEC’s FlashTools 3 download utility
•interfacing the phyCORE-XC161, mounted on the Development
Board, to a host-PC
•downloading example user code in hexfile format from a host-PC
to the external Flash memory using FlashTools 3
2.1 Installing Rapid Development Kit Software
When you 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-XC161 with XC161CJ QuickStart Instructions
12 © PHYTEC Meßtechnik GmbH 2003 L-646e_1
The following window appears:
•Choose 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 2003 L-646e_1 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 subdirectory
of the Rapid Development Kit root directory that you have specified
at the beginning of the installation process.

phyCORE-XC161 with XC161CJ QuickStart Instructions
14 © PHYTEC Meßtechnik GmbH 2003 L-646e_1
All software and tools for this phyCORE-XC161 RDK will be
installed to the \PHYBasic directory 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-XC161 Kit will also be
installed to the Kit-specific subdirectory.

Getting Started
© PHYTEC Meßtechnik GmbH 2003 L-646e_1 15
•Setup will now add program icons to the program folder, named
PHYTEC.
•In the next window, choose the Keil EK166 Software
Development Tool Chain.
The applicable Keil 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 the Keil EK166 resp. µVision2 from
the Spectrum CD-ROM even if other versions of µVision2 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 Development Tool
Chain.

phyCORE-XC161 with XC161CJ QuickStart Instructions
16 © PHYTEC Meßtechnik GmbH 2003 L-646e_1
The applicable Keil µVision2 evaluation development tool chain will
be installed to your hard-drive. Additional software, such as Adobe
Acrobat Reader, will also be offered for installation.
In the following windows you can decide to install FlashTools 3
software and the Acrobat Reader.
The applicable FlashTools 3 software 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.
•Click on Yes and complete the FlashTools 3 Setup program.