Phytec phyCORE-P87C591 Programming manual

A product of a PHYTEC Technology Holding company
phyCORE-P87C591
QuickStart Instructions
Using PHYTEC FlashTools98 for Windows and the Raisonance
Integrated Development Environment (RIDE)
for 8051 and XA Demo Version
Note: The PHYTEC Spectrum CD includes the electronic version of
the English phyCORE-P8xC591 Hardware Manual
Hinweis: Die PHYTEC Spektrum CD beinhaltet die elektronische
Version des deutschen phyCORE-P8xC591 Hardware Manuals
Edition: July 2002

phyCORE-P87C591 QuickStart Instructions
© PHYTEC Meßtechnik GmbH 2002 L-586e_2
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
2nd Edition: July 2002

Table of Contents
© PHYTEC Meßtechnik GmbH 2002 L-586e_2
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-P87C591..............................................4
1.5 The Raisonance Integrated Development
Environment (RIDE) for 51+XA..................................................7
2 Getting Started...................................................................................11
2.1 Installing Rapid Development Kit Software...............................11
2.2 Interfacing the phyCORE-P87C591 to a Host-PC .....................18
2.3 Starting PHYTEC FlashTools98 for Windows ..........................20
2.4 Downloading Example Code with FlashTools...........................21
2.4.1 "Blinky".........................................................................25
2.4.2 "Hello"...........................................................................27
3 Getting More Involved......................................................................33
3.1 Starting the Raisonance Tool Chain ...........................................33
3.2 Creating a New Project and Adding an Existing Source File.....34
3.3 Modifying the Source Code........................................................38
3.4 Saving the Modifications............................................................38
3.5 Setting Tool Chain Options ........................................................39
3.6 Building the Project....................................................................42
3.7 Downloading the Output File .....................................................43
3.8 “Hello2”......................................................................................44
3.8.1 Creating a New Project..................................................44
3.8.2 Modifying the Example Source.....................................45
3.8.3 Setting Tool Chain Options...........................................45
3.8.4 Building the New Project ..............................................45
3.8.5 Downloading the Output File........................................46
3.8.6 Starting the Terminal Emulation Program.....................47

phyCORE-P87C591 QuickStart Instructions
© PHYTEC Meßtechnik GmbH 2002 L-586e_2
4 Debugging ..........................................................................................49
4.1 Preparing the Target Hardware to Communicate with
ROM Monitor.............................................................................50
4.2 Creating a Debug Project and Preparing the Debugger .............51
4.2.1 Creating a New Project .................................................51
4.2.2 Setting Options for Target.............................................52
4.3 Preparing the Debugger..............................................................59
4.4 Starting the Debugger.................................................................61
4.5 Raisonance Debug Features .......................................................64
4.6 Using the Raisonance Debug Features.......................................65
4.6.1 Watch Window..............................................................65
4.6.2 Run to ...........................................................................66
4.6.3 Step Into and Step Over ................................................68
4.6.4 Breakpoints....................................................................69
4.7 Running, Stopping and Resetting...............................................72
4.8 Changing Target Settings for the "Final Version" .....................73
5 Advanced User Information.............................................................75
5.1 FlashTools98 ..............................................................................75
5.2 Linking and Locating .................................................................77
Index of Figures
Figure 1: Mounting the phyCORE-P87C591 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
Figure 4: Memory Model for Use with the Raisonance Monitor
(64 kByte RAM).........................................................................53

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-586e_2 1
1Introduction to the Rapid Development Kit
This QuickStart provides:
•general information on the PHYTEC phyCORE-P87C591 Single
Board Computer (SBC)
•an overview of Raisonance’s Integrated Development
Environment (RIDE) for 51+XA, and
•instructions on how to run example programs on the
phCORE-P87C591, mounted on the PHYTEC phyCORE
Development Board LD 5V, in conjunction with RIDE for 51+XA
Please refer to the phyCORE-P8xC591 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
phCORE-P8xC591 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-P8xC591 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-P87C591
in conjunction with the Raisonance Integrated Development
Environment (RIDE) for 51+XA

phyCORE-P87C591 QuickStart Instructions
2© PHYTEC Meßtechnik GmbH 2002 L-586e_2
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-P87C591 in conjunction with the Raisonance Integrated
Development Environment (RIDE) for 51+XA. It is structured as
follows:
1) The "Getting Started" section uses two example programs:
"Hello" and "Blinky" to demonstrate the download of user code
to the Flash device using PHYTEC FlashTools98 for Windows.
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-P87C591 using the Raisonance tool chain and
FlashTools98.
3) The "Debugging”section provides a third example
program - “Debug” - to demonstrate monitoring of the board and
simple debug functions using the Raisonance RIDE 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-586e_2 3
1.3 System Requirements
Use of this “Rapid Development Kit” requires:
•the phyCORE-P87C591 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 - [email protected]
http://www.raisonance.com - or - http://www.amrai.com (US)
[email protected] - or - [e-mail] (US)
[email protected] (Europe)

phyCORE-P87C591 QuickStart Instructions
4© PHYTEC Meßtechnik GmbH 2002 L-586e_2
1.4 The PHYTEC phyCORE-P87C591
The phyCORE-P87C591 represents an affordable, yet highly
functional Single Board Computer (SBC) solution in subminiature
dimensions (40 x 55 mm). The standard board is populated with a
Philips P87C591 controller, featuring a 6-channel on-chip
A/D-converter with 10-bit resolution and an integrated
CAN controller.
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-P87C591 to be plugged like a “big chip” into target
hardware.
The standard memory configuration of the phyCORE-P87C591
features 128 kByte external SRAM and 128 kByte external Flash for
code storage (64 kByte for FlashTools firmware and 64 kByte for
storage of user code). The Flash device allows direct on-board
programming. 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 250 mA power source.
PHYTEC FlashTools98 enables easy on-board download of user
programs.

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-586e_2 5
phyCORE-P87C591 Technical Highlights
•SBC in subminiature dimensions (40 x 55 mm) achieved through
advanced SMD technology
•populated with an 44-pin packaged (PLCC) Philips
8051-compatible P87C591 controller featuring 2.0B on-chip CAN
with extended Philips PeliCAN
•instruction cycle time of 375 ns at 16 MHz clock speed
(no internal clock prescaler)
•128 kByte external SRAM
•128 (to 512) kByte external Flash supporting on-board
downloading of user code from a host-PC in conjunction with
PHYTEC FlashTools98 firmware
•RS-232 serial interface
•2.0B CAN bus interface supporting 11-bit and 29-bit message
identifiers
•6-channel on-chip A/D converter with 10-bit resolution
•three Chip Select signals for connection to external peripherals
•requires only a +5 V/250 mA power source
•operates in a temperature range of 0... 70°C
(optional -40... 85°C temperature range available)

phyCORE-P87C591 QuickStart Instructions
6© PHYTEC Meßtechnik GmbH 2002 L-586e_2
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-586e_2 7
1.5 The Raisonance Integrated Development Environment
(RIDE) for 51+XA
The Raisonance tool chain fully supports the entire Philips XA and
8051 derivative microcontroller families. It includes an ANSI-C
compiler, macroassembler, linker/locator, simulator/debugger and
ROM monitor/debugger within the RIDE development environment.
From the unique RIDE user interface projects can be developed for an
application based either on an 8051 derivative, a XA derivative, or
both. Such flexibility makes migrating from 8-bit to 16-bit
architectures easier.
The Raisonance tool chain produces OMF object files that are
supported by most in-circuit emulators. The OMF-to-HEX utility
converts a Raisonance .aof format file into an Intel hexfile that is
suitable for programming into the external Flash on the PHYTEC
phyCORE-P87C591 target board.
The Raisonance tool chain consists of the following tools; all
integrated in RIDE:
•C Compiler
•Assembler
•RTOS
•Linker/Locator
•Simulator/Debugger
•ROM Monitor
All these tools and many utility programs are available in two
versions: as Win32 DLL called internally from RIDE, and DOS-based
executables (*.exe) that can be called externally. These two versions
are strictly equivalent regarding the generated code.

phyCORE-P87C591 QuickStart Instructions
8© PHYTEC Meßtechnik GmbH 2002 L-586e_2
The evaluation version of the RIDE development environment is
limited in manipulable code size as follows:
•4 kByte for the 8051.
•8 kByte for the XA.
Other than these restrictions, the evaluation tool chain functions
exactly as the full version does, enabling full evaluation of the
features and functionality of Raisonance development tools. This
demo version can be upgraded by entering a serial number.
Raisonance Integrated Development Environment (RIDE)
RIDE is a Windows-based Graphical User Interface for all
Raisonance tools. All compiler, assembler, linker/locator and
debugger options are configured with simple mouse clicks. RIDE runs
under Windows 95/98/2000 and NT.
All RIDE commands and functions are accessible via intuitive pull-
down menus with prompted selections. An extensive help utility and
complete set of online manuals are included. External executables can
be run from within RIDE, including emulator software.
RC51 C Compiler
The RC51 compiler and MA51 assembler are designed specifically
for 8051 controllers.
The Raisonance RC51 compiler provides the fastest and smallest code
using industry benchmarks.
The Getting Started Guide from Raisonance provides more
information on these tools. It also includes an introduction on
‘Migrating from the 8051 to the XA’.

Introduction
© PHYTEC Meßtechnik GmbH 2002 L-586e_2 9
Debug Environment
RIDE includes a simulator/debugger and a ROM Monitor that
supports debugging either via software on a host-PC or in target
hardware. All the debugging functions are enabled in the demo
version with the same restrictions in manipulable code size as
follows:
•4 kByte for the 8051,
•8 kByte for the XA (Page Zero mode only).

phyCORE-P87C591 QuickStart Instructions
10 © PHYTEC Meßtechnik GmbH 2002 L-586e_2

Getting Started
© PHYTEC Meßtechnik GmbH 2002 L-586e_2 11
2Getting Started
What you will learn with this Getting Started example:
•installing Rapid Development Kit software
•starting PHYTEC FlashTools98 for Windows download utility
•interfacing the phyCORE-P87C591, 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 external Flash memory using FlashTools98
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-P87C591 QuickStart Instructions
12 © PHYTEC Meßtechnik GmbH 2002 L-586e_2
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-586e_2 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-P87C591 QuickStart Instructions
14 © PHYTEC Meßtechnik GmbH 2002 L-586e_2
All software and tools for this phyCORE-P87C591 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-P87C591 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-586e_2 15
•In the next window, choose to install the Raisonance Software
Development tool chain for 51 + XA1.
The applicable Raisonance 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 Raisonance tool chain from the
Spectrum CD-ROM even if other versions of RIDE is 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 Raisonance
tool chain. The default location is C:\Ride.
1: If installing a different software development tool chain, please refer to the applicable
version of the QuickStart manual.

phyCORE-P87C591 QuickStart Instructions
16 © PHYTEC Meßtechnik GmbH 2002 L-586e_2
The applicable Raisonance Software Development tool chain for
51+XA 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 FlashTools98
software and the Acrobat Reader.
The applicable FlashTools 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.