Phytec nanoModul-164 Programming manual

A product of a PHYTEC Technology Holding company
nanoMODUL-164
QuickStart Instructions
Using PHYTEC FlashTools for Windows and the Keil µVision2
Software Evaluation Development Tool Chain
Note: The PHYTEC Spectrum CD includes the electronic version of
the English nanoMODUL-164 Hardware Manual
Edition: May 2003

nanoMODUL-164 QuickStart Instructions
PHYTEC Meßtechnik GmbH 2003 L-379e_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 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
4th Edition: May 2003

Contents
PHYTEC Meßtechnik GmbH 2003 L-379e_4
Table of Contents
1 Introduction to the Rapid Development Kit.....................................1
1.1 Documentation Overview.............................................................1
1.2 Overview of this QuickStart Instruction.......................................2
1.3 System Requirements ...................................................................2
1.4 The PHYTEC nanoMODUL-164.................................................3
1.5 The µVision2 Software Evaluation Development Tool Chain.....6
2 Getting Started.....................................................................................9
2.1 Installing Rapid Development Kit Software.................................9
2.2 Interfacing the nanoMODUL-164 to a host-PC .........................16
2.3 Downloading Example Code......................................................18
2.3.1 Starting PHYTEC FlashTools for DOS ........................18
2.3.2 Downloading Example Code with FlashTools for
DOS...............................................................................20
2.3.2.1 "Hello"............................................................25
2.3.2.2 "Blinky"..........................................................30
2.3.3 Downloading Example Code with FlashTools for
Windows........................................................................32
2.3.3.1 "Hello"............................................................37
2.3.3.2 "Blinky"..........................................................42
3 Getting More Involved......................................................................45
3.1 Starting the µVision2 Tool Chain...............................................45
3.2 Creating a New Project and Adding an Existing Source File.....46
3.3 Modifying the Source Code........................................................52
3.4 Saving the Modifications............................................................53
3.5 Setting Options for Target..........................................................53
3.6 Building the Project....................................................................56
3.7 Downloading the Output File .....................................................57
3.7.1 Downloading with FlashTools for DOS........................57
3.7.2 Downloading with FlashTools for Windows.................60
3.8 “Hello”........................................................................................61
3.8.1 Creating a New Project..................................................61
3.8.2 Modifying the Example Source.....................................62
3.8.3 Setting Options for Target.............................................62
3.8.4 Building the New Project ..............................................63
3.8.5 Downloading the Output File........................................64
3.8.5.1 Downloading with FlashTools for DOS.........64
3.8.5.2 Downloading withFlashTools for Windows..66
3.8.6 Starting the Terminal Emulation Program.....................67

nanoMODUL-164 QuickStart Instructions
PHYTEC Meßtechnik GmbH 2003 L-379e_4
4 Debugging ..........................................................................................69
4.1 Loading the Example File ..........................................................70
4.2 Preparing the Debugger..............................................................71
4.3 Preparing the Target Hardware to communicate with
the Debugger ..............................................................................73
4.4 Starting the Debugger.................................................................73
4.5 Using the Keil µVision2 Debug Features...................................75
4.5.1 Breakpoints....................................................................75
4.5.2 In Line Assembler.........................................................75
4.6 Single Stepping...........................................................................76
4.6.1 Memory Window...........................................................77
4.6.2 Watch Window..............................................................78
4.7 Resetting Simulator and the nanoMODUL-164.........................79
5 Advanced User Information.............................................................81
5.1 FlashTools ..................................................................................81
5.1.1 FlashTools for DOS ......................................................81
5.1.2 FlashTools for Windows...............................................82
5.2 Start164.a66................................................................................83
5.3 Linking and Locating .................................................................84
5.4 Debugging using Monitor kernel ...............................................86
Appendices..................................................................................................89
A Troubleshooting..........................................................................89
A.I µVision2 debugger in Monitor mode:...........................89
A.II Monitor Configuration Error.........................................90
Figures
Figure 1: Development Board Overview...................................................16
Figure 2: Suitable Development Board Jumper Settings...........................17
Figure 3: Power Connector........................................................................17

Introduction
PHYTEC Meßtechnik GmbH 2003 L-379e_4 1
1Introduction to the Rapid Development Kit
This tutorial provides:
•general information on the PHYTEC nanoMODUL-164 Single
Board Computer
•an overview of Keil’s µVision2 software evaluation development
tool chain, and
•instructions on how to run example programs on the
nanoMODUL-164, mounted on the PHYTEC Development Board,
in conjunction with µVision2.
Please refer to the nanoMODUL-164 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
nanoMODUL-164 Hardware Manual.
1.1 Documentation Overview
This “Rapid Development Kit” includes the following electronic
documentation on the enclosed “PHYTEC Spectrum CD-ROM”:
•the PHYTEC nanoMODUL-164 Hardware Manual and
Development Board 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
nanoMODUL-164 in conjunction with the µVision2 software
development tools.

nanoMODUL-164 QuickStart Instructions
2PHYTEC Meßtechnik GmbH 2003 L-379e_4
1.2 Overview of this QuickStart Instruction
1) The “Getting Started” section uses two example programs –
“Hello”and “Blinky” demonstrate the download of user code to
the Flash device using PHYTEC’s FlashTools for Windows.
2) Section “Getting More Involved” provides step-by-step
instructions on how to modify both examples, create and build
new projects and likewise download output files to the
nanoMODUL-164 using the Windows-based µVision2 tool.
3) The “Debugging” section provides a third example program
“Debug” to demonstrate monitoring of the board and simple
debug functions using the µVision2 debug environment.
In addition to dedicated data for this Rapid Development Kit, this
CD-ROM contains supplemental information on embedded
microcontroller design and development.
1.3 System Requirements
Use of this ‘Rapid Development Kit’ requires:
•the PHYTEC nanoMODUL-164,
•the PHYTEC Development Board with the included DB-9 serial
cable and AC adapter supplying 8-12 V / min. 500 mA.,
•the PHYTEC Spectrum CD,
•an IBM-compatible host-PC (486 or higher running at least
Windows 95/NT)

Introduction
PHYTEC Meßtechnik GmbH 2003 L-379e_4 3
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]
1.4 The PHYTEC nanoMODUL-164
The nanoMODUL-164 is intended for use in memory-intensive appli-
cations and in running within a CAN-bus network. Half of the size of
a credit card (47 by 38 mm.), the standard board is equipped with the
Infineon C164CI controller as well as a Real-Time Clock which, like
the SRAM, can be buffered by an external battery. The standard
module runs at a 20 MHz internal clock speed (delivering 100
instruction cycles/ns) and offers 256 kByte (up to 1 MB) SRAM and
256 kByte (up to 1 MB) Flash on-board for DATA and CODE
storage. PHYTEC FlashTools for Windows enable easy on-board
download of user code to the external Flash device.
The nanoMODUL-164 is fitted with one RS-232 transceiver, an I²C
RTC and a CAN-bus interface. All controller signals and ports extend
to pin rows aligning two edges of the board. These pins provide a 16-
bit bi-directional I/O port and 64 free port lines, including 8 analog
inputs with 10-bit resolution. The nanoMODUL-164 has an industrial
temperature range from 0 to 70 degrees ºC (with extended range from
-40 to 85 degrees ºC except RTC only from –30 to 70 degrees) and
requires only a 300 mA power source.

nanoMODUL-164 QuickStart Instructions
4PHYTEC Meßtechnik GmbH 2003 L-379e_4
nanoMODUL-164 Technical Highlights
•SBC in matchbox-sized dimensions (47 x 38 mm) achieved
through modern SMD technology
•populated with Infineon C164CI controller with Full 2.0B on-chip
CAN
•instruction cycle time of 100 ns at 20 MHz clock speed in 16-bit,
multiplexed bus mode
•256 kByte (to 1 MByte) SRAM on-board and 256 kByte (to
1 MByte) Flash on-board
•RS-232 interface
•Full 2.0B CAN bus interface
•battery-buffered Real-Time Clock and SRAM
•prepared for operation with in-circuit emulators (such as ICE
connect-16x)
•requires only +5V/300 mA power source in a temperature range of
0 to 70 degree C
The PHYTEC Development Board, in EURO-card dimensions (160 x
100 mm.) is completely equipped with all mechanical and electrical
components necessary for the speedy and secure insertion and
subsequent programming of the PHYTEC nanoMODUL series Single
Board Computer. Simple Jumper configuration readies the Devel-
opment Board’s connectivity to the nanoMODUL, which plugs con-
nectors-down into the high-density receptacle footprint connector
mounted on the Development Board.

Introduction
PHYTEC Meßtechnik GmbH 2003 L-379e_4 5
Development Board Technical Highlights
•RESET button
•BOOT button
•low-voltage socket and voltage regulator accepting an unregulated
input voltage in a range from 8 to 12 VDC
•DB-9 connector (configured as an RS-232 interface)
•second DB-9 interface for CAN
•VG96-connector
•simple jumper configuration
•wire wrap field (64 x 69 mm) supporting development of user-
designed peripheral hardware

nanoMODUL-164 QuickStart Instructions
6PHYTEC Meßtechnik GmbH 2003 L-379e_4
1.5 The µVision2 Software Evaluation Development Tool
Chain
The Keil µVision2 fully supports the entire Infineon C166 micro-
controller line. It includes a C compiler, macroassembler, linker/lo-
cator and the Simulator and target monitor within the µVision2 IDE.
Specific chips supported are the 161, 163, 164-CI, 165, 166, 167, and
the 167CR. 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
the Flash on the PHYTEC nanoMODUL-164 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 these files is the
C:\C166eval\Bin directory for the evaluation version while µVision2
is in C:\Keil\uv2. Using the professional (i.e. full) version of the Keil
tool chain, the default folder for these files is C:\C166\Bin. 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 in code size to 8 kByte.
All features operate normally, except these restrictions mentioned
above.

Introduction
PHYTEC Meßtechnik GmbH 2003 L-379e_4 7
µ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. µVision2 runs under Windows
95/98 and NT. This Integrated Development Environment (IDE) has
been expressly designed with the user in mind. IDE includes a fully
functional editor.
All IDE commands and functions are accessible via intuitive pull-
down menus with prompted selections. It includes an extensive Help
utility. External executables can be run from within µVision2,
including emulator software.
C166 C Compiler for the entire Infineon 166/167 family
The C166 ANSI compiler and A166 assembler are designed speci-
fically for the Infineon 161, 163, C164CI, 165,166, 167, 167CR, 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 and A51 Macroassemblers
These two macroassemblers include their respective compiler package
or they are available separately. All utilities needed to complete your
project are included for all members of the respective assembler
family. These assemblers are based on DOS or can be run from
µVision2 which is included in every assembler and compiler package
from Keil.
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:

nanoMODUL-164 QuickStart Instructions
8PHYTEC Meßtechnik GmbH 2003 L-379e_4
• 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 code. The
evaluation version does not have a starting address restriction. An
useful object code is produced.
There are no other than these restrictions, the tool set works exactly as
the full version does. This allows you to completely evaluate the
features and power of Keil products on the PHYTEC target board.
The full version has no restrictions and is completely ANSI
compliant.
FR166 Full-Function RTOS for the Infineon C166 Family
The FR166 is a multitasking real-time operating system for the
Infineon 166 family. Multiple tasks can be managed by you 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 includes all C166 C compiler kits.
CAN (Controller Area Network) Library
The RTX51 and RTX166 Full RTOS supports CAN controllers with
the included libraries. The CAN libraries are sold with the RTOS and
support 11 and 29 bit 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, and
C167CR. 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-379e_4 9
2Getting Started
What you will learn with this Getting Started example:
•installing Rapid Development Kit Software
•starting PHYTEC’s FlashTools download utility
•interfacing the nanoMODUL-164, 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
2.1 Installing Rapid Development Kit Software
When inserting 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.

nanoMODUL-164 QuickStart Instructions
10 PHYTEC Meßtechnik GmbH 2003 L-379e_4
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-379e_4 11
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.

nanoMODUL-164 QuickStart Instructions
12 PHYTEC Meßtechnik GmbH 2003 L-379e_4
All software and tools for this nanoMODUL-164 Kit 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 doc. 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 nanoMODUL-164 Kit will also be
installed to the Kit-specific subdirectory. The manuals of the
Development Boards are copied to their own specific subdirectories
(e.g. \PHYBasic\DevBnM) because each Development Board is
suitable for multiple Single Board Computers and is not dedicated to
a specific Kit.

Getting Started
PHYTEC Meßtechnik GmbH 2003 L-379e_4 13
Setup will now add program icons to the program folder, named
PHYTEC.
In the next window, you choose the Keil EK166 Software
Development Tool Chain.
After accepting the Welcome window and license agreement select
the destination location for installation ofthe Development Tool
Chain.
Depending on the Rapid Development Kit software you have
selected, 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.

nanoMODUL-164 QuickStart Instructions
14 PHYTEC Meßtechnik GmbH 2003 L-379e_4
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 µ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.
In the following windows you can decide to install FlashTools for
Windows Beta Version and the Acrobat Reader. For better
performance, you can use the DOS Flashtools which have already
been installed.

Getting Started
PHYTEC Meßtechnik GmbH 2003 L-379e_4 15
Press Finish to complete the installation and decide if you want to
begin the Quickstart Instruction immediately.

nanoMODUL-164 QuickStart Instructions
16 PHYTEC Meßtechnik GmbH 2003 L-379e_4
2.2 Interfacing the nanoMODUL-164 to a host-PC
Connecting the nanoMODUL-164, mounted on the PHYTEC
Development Board, to your computer is simple:
•If the nanoMODUL is not already pre-installed, mount it pins-
down onto the Development Board’s receptacle footprint (X3) as
shown in the Figure below.
Ensure that there is a solid connection between the modul pins and
the Development Board receptacle. Also take precautions not to bend
the pins when the nanoMODUL is removed from and inserted onto
the Development Board.
Figure 1: Development Board Overview
•Configure the Jumpers on the Development Board as indicated
below. This correctly routes the RS-232 signals to the DB-9
connector (P1) on the Development Board.
PHYTEC Meßtechnik GmbH Development Board nanoMODUL-164
nanoMODUL-164
X2
X1