AP0806720 XC88x Cookery Book

Download as pdf or txt
Download as pdf or txt
You are on page 1of 119

Application Note, V2.

0, August 2007

AP08067

XC886/XC888
XC888 Starter Kit "Cookery-Book" for a
"Hello world" application. You can do the
“Hello world” example in this document with
the evaluation version of the KEIL tool
chain.

Microcontrollers
Edition 2008-07-11
Published by
Infineon Technologies AG
81726 München, Germany
© Infineon Technologies AG 2008.
All Rights Reserved.

LEGAL DISCLAIMER
THE INFORMATION GIVEN IN THIS APPLICATION NOTE IS GIVEN AS A HINT FOR THE
IMPLEMENTATION OF THE INFINEON TECHNOLOGIES COMPONENT ONLY AND SHALL NOT BE
REGARDED AS ANY DESCRIPTION OR WARRANTY OF A CERTAIN FUNCTIONALITY, CONDITION OR
QUALITY OF THE INFINEON TECHNOLOGIES COMPONENT. THE RECIPIENT OF THIS APPLICATION
NOTE MUST VERIFY ANY FUNCTION DESCRIBED HEREIN IN THE REAL APPLICATION. INFINEON
TECHNOLOGIES HEREBY DISCLAIMS ANY AND ALL WARRANTIES AND LIABILITIES OF ANY KIND
(INCLUDING WITHOUT LIMITATION WARRANTIES OF NON-INFRINGEMENT OF INTELLECTUAL
PROPERTY RIGHTS OF ANY THIRD PARTY) WITH RESPECT TO ANY AND ALL INFORMATION GIVEN
IN THIS APPLICATION NOTE.

Information
For further information on technology, delivery terms and conditions and prices please contact your nearest
Infineon Technologies Office (www.infineon.com).

Warnings
Due to technical requirements components may contain dangerous substances. For information on the types
in question please contact your nearest Infineon Technologies Office.
Infineon Technologies Components may only be used in life-support devices or systems with the express
written approval of Infineon Technologies, if a failure of such components can reasonably be expected to
cause the failure of that life-support device or system, or to affect the safety or effectiveness of that device or
system. Life support devices or systems are intended to be implanted in the human body, or to support
and/or maintain and sustain and/or protect human life. If they fail, it is reasonable to assume that the health
of the user or other persons may be endangered.
AP08067
XC88x Starter Kit "Cookery-Book"

AP08048
Revision History: 2006-07 V2.0
Previous Version: none
Page Subjects (major changes since last revision)

We Listen to Your Comments


Any information within this document that you feel is wrong, unclear or missing at all?
Your feedback will help us to continuously improve the quality of this document.
Please send your proposal (including a reference to this document) to:
[email protected]

Application Note 3 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Table of Contents Page

Note: Table of Contents see page 8.

Introduction:

This “Appnote” is an Infineon Hands-On-Training / Cookery-Book / step-by-step-book.


It will help inexperienced users to get an XC88x Evaluation Board / Starter Kit Board up and
running.

With this step-by-step book you should be able to get your first useful program in less than 2 hours.

The purpose of this document is to gain know-how of the microcontroller and the tool-chain.
Additionally, the "hello-world-example" can easily be expanded to suit your needs.
You can connect either a part of - or your entire application to the Starter Kit Board.
You are also able to benchmark any of your algorithms to find out if the selected microcontroller
fulfils all the required functions within the time frame needed.

Note:
The style used in this document focuses on working through this material as fast and easily as
possible. That means there are full screenshots instead of dialog-window-screenshots; extensive use
of colours and page breaks; and listed source-code is not formatted to ease copy & paste.

Have fun and enjoy the XC88x microcontrollers!

Application Note 4 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

The New
XC800-Family
Designed to Make the Difference

Application Note 5 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

XC888CLM-8FFA Block Diagram (Source: Product Marketing)

XC888CLM-8FFA Block Diagram (Source: DAvE)

Application Note 6 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

XC888CLM-8FFA Block Diagram (Source: User’s Manual)

XC888CLM-8FFA functional units (Source: User’s Manual)

Note:
Just by comparing the different sources of block diagrams, you should be able
to get a complete picture of the product and to answer some of your initial questions.

Application Note 7 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

“Cookery-book“
For your first programming example for the XC888 Starter Kit Board:

Your
program:

Chapter/
Step *** Recipes ***

1.) XC888 Starter Kit Board


Power Supply (via USB), Jumper Setting, Serial Connection (via USB) to the notebook

2.) DAvE (program generator)


DAvE Installation (mothersystem) + DAvE Update Installation (XC888.DIP) for XC888

3.) Using DAvE


Microcontroller initialization for your programming example

4.) Using the KEIL Development Tools (C-Compiler)


Programming of your application (XC888) with KEIL tool chain (µVision3)
Compiler V8.09a + first steps with the Simulator

5.) Using the simulator


6.) Using real hardware (+ OnChipFlash-Programming)

Feedback

7.) Feedback

Application Note 8 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

1.) XC888 Starter Kit Board:

Ordering information:

Starter Kits – Type µC Order No.

SK-XC886/888LM SAK-XC888CM B158-H8743-X-X-7600


SK-XC886/888CLM Easy Kit SAK-XC888CM B158-H8744-X-X-7600

Distribution Worldwide:
http://www.infineon.com/cms/en/corporate/company/location/index.html

Application Note 9 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Screenshot of the XC888 Starter Kit Homepage:

Application Note 10 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Overview of the XC888 Starter Kit Board connection to the environment:

Note:
Do not connect now!
This is just information! We are going to connect the board later!

Reason:
When the ULINK is already connected to the Starter Kit Board, the Starter Kit Board must be
supplied with power for the ULINK to work properly.
For the power supply we are going to use the USB cable – by connecting the USB cable a USB
driver is needed.

USB Cable [used for: UART communication (the RS232 serial interface is available via USB); the
USB connection works also as the power supply].

Remove jumper Jumper COM:


J3 (BSL) select USB to
Î Open: connect the TX
Bootstrap loader and RX pin of
is disabled or USB-UART
User mode bridge IC
enabled

KEIL-ULINK (used for: On-Chip-Flash-Programming and Debugging).

Note:
For further information, please refer to the XC888 Board Manual, V2.1, Sept 2006 .

Application Note 11 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

2.) DAvE – Installation for XC888 microcontrollers:

Install DAvE (mothersystem):

Download the DAvE-mothersystem setup.exe @ http://www.infineon.com/DAvE

and execute setup.exe to install DAvE .

Application Note 12 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Install the XC888 microcontroller support/update (XC888CLM DIP file):

1.)
Download the DAvE-update-file (.DIP) for the required microcontroller
@ http://www.infineon.com/DAvE

Unzip the zip-file “XC888CLM_v1.2.zip” and save “ XC888CLM_v12.DIP “


@ e.g. D:\DAvE\XC888-2007-08-14\XC888CLM_v12 .dip.

Application Note 13 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

2.)

Start DAvE - ( click )

3.)

View
Setup Wizard
Default: • Installation
Forward>
Select: • I want to install products from the DAvE’s web site
Forward>
Select: D:\DAvE\XC888-2007-08-14
Forward>
Select: Available Products
click D XC888CLM
Forward>
Install
End

4.) DAvE is now ready to generate code for the XC888CLM microcontroller.

Application Note 14 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

3.) DAvE - Microcontroller Initialization after Power-On:

Start the program generator DAvE and select the XC888CLM microcontroller:

File
New
8-Bit Microcontrollers
select XC888CLM
Create

Application Note 15 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Choose the Project Settings as you can see in the following screenshots:

General: Controller Details: Device: check/select XC888CLM-8FF


General: For the KEIL Compiler check/choose ~ Keil in the Compiler Settings:

Application Note 16 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

System Clock: (do nothing)

Note:
CPU clock is 24 MHz.

Application Note 17 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Additional information: Clock System (Source: User’s Manual):

Clock Generation Unit (CGU) Block Diagram

1
2

96 MHz
9,6
MHz 20

Note:

fSYS = fOSC * N / ( P * K ) = 9,6 MHz * 20 / ( 1 * 2 ) = 96 MHz

Application Note 18 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Additional information: Clock System (Source: User’s Manual):

Clock Generation from fsys:

48 48
fSYS/4
24

24

9,6 96 24
48 24

24
48

Note:

fSYS = 96 MHz

CPU clock: CCLK, SCLK = 24 MHz


Fast clock: FCLK = 24 or 48 MHz
Peripheral clock: PCLK = 24 MHz
Flash Interface clock: CCLK2 = 48 MHz and CCLK = 24 MHz

CLKREL: The clock division factor fSYS/4 (see DAvE screenshot page 17) is inclusive the fixed
divider factor of 2.

Application Note 19 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Global Settings: (do not change configuration)

*U

Note (Source: DAvE):


// You have two choices for interrupt type select in Project Settings Page
// under Global Settings Section.
// If you select CHOICE 1 then ISR will be generated with push and pop.
// If you select CHOICE 2 then ISR will be generated without push and pop.
// Default choice is CHOICE 2.
// Current selection is CHOICE 2

Note:
*” = Interrupt Structure 2 applies to Timer 2, Timer 21, UART1, LIN, external interrupts 2 to 6,
ADC, SSC, CCU6, Flash, MDU, CORDIC and MultiCAN interrupt sources.
There is a slightly different behavior between MODE=0 and MODE=1 in setting/clearing the
pending interrupt request bit.
*U = If an interrupt node is shared with another interrupt node, the ISR code will be generated in
the SHARED_INT.C file.

Application Note 20 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Notes: If you wish, you can insert your comments here.

Exit and Save this dialog now by clicking the close button:

Application Note 21 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Configuration of the ASC0:

The configuration window/dialog can be opened by clicking the specific block/module.

Application Note 22 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

UART: Transmitter: click ~ Use pin P1.1 (TXD_0)


UART: Receiver: click ~ Use pin P1.0 (RXD_0)
UART: Receiver Enable: click 9 Enable receiver (REN)
UART: Mode Control: click ~ Mode 1: 8-bit shift UART, variable baud rate (see BRG or Timer1)

Note:
The RS232 serial interface (UART pins P1.0 and P1.1) is available via the USB port which converts
the TTL-UART-signals to USB-signals
(using a SILICON LABS CP2102 ”Single-Chip USB To UART Bridge”).

USB port

Application Note 23 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

BRG: BRG Run Control: click/check 9 Enable BRG


BRG: Fractional Divider Control: click/check 9 Enable Fractional Divider
BRG: BRG Settings: Required baud rate [kbaud] insert 9,600 <ENTER>

Note:
Validate each alphanumeric entry by pressing ENTER.

Application Note 24 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Interrupts: (do nothing)

Priority

Note:
For the serial communication with a terminal program running on your Personal-Computer the
printf-function is used. The printf-function uses Software-Polling-Mode therefore we do not need to
configure any interrupts.

Application Note 25 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Interrupt Priorities:

Note (Source: Application Note AP08053):


There could be six interrupt priorities.
These priorities, with 6 beeing the highest, are as follows:

Interrupt Priority:
6 NMI
5 Interrupt Priority 3
4 Interrupt Priority 2
3 Interrupt Priority 1
2 Interrupt Priority 0
1 Main

Main refers to routines that run prior to any interrupt and can be interrupted by any interrupt.
Each interrupt source can be programmed to any of the four interrupt priorities (0-3).
An interrupt that is currently being serviced can only be interrupted by a higher-priority interrupt,
but not by another interrupt of the same or lower priority.
Hence, an interrupt of the highest priority cannot be interrupted by any other interrupt request.
In any case, the NMI always has the highest priority (above level 3) and its priority cannot be
programmed.

Application Note 26 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Functions: Initialization Function: click 9 UART_vInit

Note:
You can change function names (e.g. UART_vInit) and
file names (e.g. UART.C) anytime.

Application Note 27 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Parameters: (do nothing)

Notes: If you wish, you can insert your comments here.

Exit and Save this dialog now by clicking the close button.

Application Note 28 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Configure Timer T0:

The configuration window/dialog can be opened by clicking the specific block/module.

Note:
The LEDs on IO_Port_3 will be blinking (if selected in the main menu)
with a frequency of about 1 second (done in the Timer_0-Interrupt-Service-Routine).
Therefore we have to configure Timer_0.

Application Note 29 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Timer0: Timer Mode: click ~ Mode 1: 16-bit timer


Timer0: Timer Options: click 9 Turn on timer (TR0)
Timer0: Interrupt Control: click 9 Enable interrupt of timer (ET0)

Note:
We need 183 Timer_0 overflows to achieve an approximate 1 second delay.
This will be handled in the Timer_0 interrupt function.
183 * 5461,333 µs = 0,9994 s.

Application Note 30 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Timer1: do nothing (not used)

Application Note 31 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Interrupts: (do nothing)

Priority

Interrupt of Timer_0
is enabled, ET0 = 1

Note (Source: User’s Manual):


An interrupt that is currently being serviced can only be interrupted by a higher-priority interrupt,
but not by another interrupt of the same or lower priority.
Hence, an interrupt of the highest priority cannot be interrupted by any other interrupt request.
If two or more requests of different priority levels are received simultaneously, the request with the
highest priority is serviced first. If requests of the same priority are received simultaneously, an
internal polling sequence determines which request is serviced first. Thus, within each priority
level, there is a second priority structure determined by a polling sequence as shown in the User’s
Manual and above.

Application Note 32 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Functions: Initialization Function: click 9 T01_vInit

Timer_0 interrupt service routine

Note:
Timer_0 has a dedicated interrupt vector address (000BH), interrupt node and its own interrupt
status flag TF0.
The vector is used to service the corresponding interrupt node request – when enabled (ET0=1),
which means: the interrupt system will hardware-generate an LCALL to the appropriate service
routine at 000BH.
TF0 will be automatically cleared by hardware (the core) once its pending interrupt request is
serviced.

Application Note 33 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Additional information: Interrupt Handling (Source: User’s Manual):

The processor acknowledges an interrupt request by executing a hardware generated LCALL to the
appropriate service routine (interrupt vector address).

In some cases, hardware also clears the flag that generated the interrupt, while in other cases, the
flag must be cleared by the user’s software (e.g. see DAvE Source Code).

The hardware-generated LCALL pushes the contents of the Program Counter (PC) onto the stack
(but it does not save the PSW) and reloads the PC with an address that depends on the source of the
interrupt being vectored to (interrupt vector addresses see User’s Manual).

Program execution returns to the next instruction after calling the interrupt when the RETI
instruction is encountered. The RETI instruction informs the processor that the interrupt routine is
no longer in progress, then pops the two top bytes from the stack and reloads the PC.
Execution of the interrupted program continues from the point where it was stopped.
Note that the RETI instruction is important because it informs the processor that the program has
left the current interrupt priority level.
A simple RET instruction would also have returned execution to the interrupted program, but it
would have left the interrupt control system on the assumption that an interrupt was still in progress.
In this case, no interrupt of the same or lower priority level would be acknowledged.

Application Note 34 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Parameters: (do nothing)


Notes: If you wish, you can insert your comments here.
Exit this dialog now by clicking the close button.

Application Note 35 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Configure Port 3 to Output:

The configuration window/dialog can be opened by clicking the specific block/module.

Note:
The LEDs are connected to IO_Port_3.

Application Note 36 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Additional information: Parallel Ports – General Structure (Source: User’s Manual):

Application Note 37 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Ports: click “Configure Port 3”

Application Note 38 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Port 3: Port Function: click 9 Use P3.0 as general IO - Port Direction: click ~ Out
Port 3: Port Function: click 9 Use P3.1 as general IO - Port Direction: click ~ Out
Port 3: Port Function: click 9 Use P3.2 as general IO - Port Direction: click ~ Out
Port 3: Port Function: click 9 Use P3.3 as general IO - Port Direction: click ~ Out
Port 3: Port Function: click 9 Use P3.4 as general IO - Port Direction: click ~ Out
Port 3: Port Function: click 9 Use P3.5 as general IO - Port Direction: click ~ Out
Port 3: Port Function: click 9 Use P3.6 as general IO - Port Direction: click ~ Out
Port 3: Port Function: click 9 Use P3.7 as general IO - Port Direction: click ~ Out

Application Note 39 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Pull Device: (do nothing)

Application Note 40 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Parameters: (do nothing)

Notes: If you wish, you can insert your comments here.


Exit this dialog now by clicking the close button.

Application Note 41 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Functions: Initialization Functions: click 9 IO_vInit


Functions: Function Library: click 9 IO_ubReadPin
Functions: Function Library: click 9 IO_vSetPin
Functions: Function Library: click 9 IO_vResetPin
Functions: Function Library: click 9 IO_ubReadPort
Functions: Function Library: click 9 IO_vWritePort
Functions: Function Library: click 9 IO_vTogglePin

Parameters: (do nothing)


Notes: If you wish, you can insert your comments here.
Exit this dialog now by clicking the close button.

Application Note 42 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Save the project:

File
Save

Save project: Save in C:\XC888 (create new directory)


File name: XC888

Save

Application Note 43 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Generate Code:

File or click
Generate Code

DAvE will show you all the files he has generated


(File Viewer opens automatically).

File - Exit

Save changes?

click Yes
Application Note 44 V2.0, 2007-08
AP08067
XC88x Starter Kit "Cookery-Book"

4.) Using the KEIL - µVision 3 Development Tools:

Install the Tool chain:

You can download the Keil Development Tools @ http://www.keil.com/demo/eval/c51.htm

Execute C51V809A.EXE ( - or any higher version )

Application Note 45 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Start Keil µVision3 and open the DAvE Project:

If you see an open project – close it: Project - Close Project

Project - Open Project


Select Project File: Look in: choose C:\XC888
Select Project File: Files of type: choose Dave Project Files
Choose XC888.dpt

Open

Application Note 46 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Project – Rebuild all target files or click

Application Note 47 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Configure Compiler, Assembler, Linker, Locater, Hex-Converter, Build – Control, Simulator,


Debugger and Utilities:

mouse position: (Project Workspace, Files): or click


Target1 click right mouse button
Options for Target ´Target1‘

Options for Target ‘Target 1’: Device: check XC888CLM-8FF


Options for Target ‘Target 1’: Device: click 9 Use Extended Linker (LX51)
Options for Target ‘Target 1’: Device: click 9 Use Extended Assembler (AX51)

Application Note 48 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Target: click/check 9 Use On-chip ROM & Target: click/check 9 Use On-chip XRAM

Application Note 49 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Additional information: Flash Memory Map (Source: User’s Manual):

Note (Source: User’s Manual):


The D-Flash bank(s) in the XC886/888 Flash devices are mapped to two program memory address
spaces:
D-Flash Bank 0 is mapped to 7000H – 7FFFH and A000H – AFFFH.
D-Flash Bank 1, which is only available in the 32-Kbyte Flash device, is mapped to 6000H – 6FFFH
and B000H – BFFFH.

In general, the lower address spaces (6000H – 6FFFH and 7000H – 7FFFH) should be
used for D-Flash bank(s) contents that are intended to be used as program code.
Alternatively, the higher address spaces (A000H – AFFFH and B000H – BFFFH) should
be used for D-Flash bank(s) contents that are intended to be used as data.

Application Note 50 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Output: click 9 Create HEX File

Note:
The HEX-File could be used while working with the program
XC800_FLOAD for OnChip-Flash-Programming
via RS232-interface [Bootstrap Loader (BSL) Mode via UART].

Application Note 51 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Listing: C Compiler Listing: click 9 Assembly Code


Listing: Linker Listing: click 9 Linker Code Listing: ./*.cod

Note:
With the cod-file you can do the following:
1.) position the mouse on the source code you are interested in
2.) click right mouse button and select Open Linker COD File
3.) see the result: Assembler-Code of your C-Source-Code

Application Note 52 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

User: (do nothing)

Application Note 53 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

C51: Code Optimization: click 9 Linker Code Packing (max. AJMP/ACALL)

Application Note 54 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

AX51: (do nothing)

Application Note 55 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

LX51 Locate: (do nothing)

Application Note 56 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

LX51 Misc: (do nothing)

Application Note 57 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Debug: (do nothing)

Note:
First we are going to use the simulator.

Application Note 58 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Utilities: Configure Flash Menu Command: click ~ Use Target Driver for Flash Programming,
Select: Infineon XC800 ULINK Driver

Application Note 59 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Note:
For OnChipFlashProgramming and OCDS-Debugging we are going to use the ULINK (“Keil-
ULINK-JTAG-Interface”).

Therefore we selected the Infineon XC800 ULINK Driver:

Application Note 60 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Note:
For OnChipFlashProgramming and OCDS-Debugging the Infineon-USB-JTAG-Wiggler-Box could
be used instead of the Keil-ULINK-JTAG-Interface.

For the Infineon USB-JTAG-Wiggler-Box the Infineon DAS Client for XC800 must be selected:

Additionally, the DAS Server must be installed on your computer!


For further information, please see your Starter Kit CD and/or www.infineon.com/DAS .

Application Note 61 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

For OnChipFlashProgramming via UART the program XC800_FLOAD.EXE could be used instead
of the Keil-ULINK-JTAG-Interface or the Infineon-USB-JTAG-Wiggler-Box.
For more information, please see your Starter Kit CD.

Application Note 62 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Utilities: Configure Flash Menu Command: click Settings

Application Note 63 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

OK
OK

Note:
To make the ULINK work properly,
the XC888 Evaluation Board must be supplied with power.
We are going to do this in chapter 6.

Application Note 64 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Insert your application specific program:

Note:
DAvE doesn’t change code which is inserted between ‘// USER CODE BEGIN’ and ‘//
USER CODE END’. Therefore, whenever adding code to DAvE’s generated code, write it
between ‘// USER CODE BEGIN’ and ‘// USER CODE END’.
If you wish to change DAvE´s generated code or add code outside these ‘USER CODE’
sections you will have to insert/modify your changes each time after letting DAvE
regenerate code!

Application Note 65 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click MAIN.C and insert Global Variables:

code char menu[] =


"\r\n\n\n\n"
"1 ... LEDs P3 ON\r\n"
"2 ... LEDs P3 OFF\r\n"
"3 ... LEDs P3 blinking\r\n"
" \r\n";

code char question[] =


"your choice: ";

code char message1[] =


"\n\r*** LEDs ON ***\r\n";

code char message2[] =


"\n\r*** LEDs OFF ***\r\n";

code char message3[] =


"\n\r*** LEDs BLINKING ***\r\n";

volatile int xdata RS232_wait=183; // 183 * Timer_0-overflow = 183 * 5461,333 µs = 0,9994 s


bit blinking=ON;
char select=' ';

Application Note 66 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Application Note 67 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click MAIN.C and insert the function input():

char input (void)


{
char in=' ';
do
{
printf(question);
while (!RI);
RI=0;
in = SBUF;
}while (in!='1' && in!= '2' && in != '3');
return in;
}

Application Note 68 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click MAIN.C and insert the following code in the main function:

P3_DATA=LED_OFF;
while(RS232_wait);

Double click MAIN.C and insert the following code in the main function into the while(1) loop:

printf(menu);
select=input();

switch (select)
{
case '1': blinking=OFF; P3_DATA=LED_ON, printf(message1); break;
case '2': blinking=OFF; P3_DATA=LED_OFF, printf(message2); break;
case '3': blinking=ON, printf(message3); break;
}

Application Note 69 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click Main.h and insert the following Defines:

#define OFF 0
#define ON 1
#define LED_ON 0xFF
#define LED_OFF 0x00

Application Note 70 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click Main.h and insert extern-declarations “Global Variables”:

extern bit blinking;


extern volatile int xdata RS232_wait;

Application Note 71 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click Main.h and insert include files:

#include <stdio.h>
#include <ctype.h>

Application Note 72 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click UART.C

Insert code into the UART_vInit function: (to start printf()):

TI=1;

Application Note 73 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click T01.C

Insert the following global variable:

unsigned char Timer_0_interrupt_counter=0;

Application Note 74 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click T01.C

Insert code for T0 interrupt service routine:

++ Timer_0_interrupt_counter;

if(RS232_wait)
RS232_wait--; // 183 * Timer_0-overflow = 183 * 5461,333 µs = 0,9994

if(Timer_0_interrupt_counter==183) // 183 * Timer_0-overflow = 183*5461,333µs = 0,9994s


{
Timer_0_interrupt_counter=0;
if (blinking)
{
P3_DATA = P3_DATA^0xFF;
}
}

Application Note 75 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Generate your application program:

Project – Rebuild all target files or click

Application Note 76 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Now we close our project and µVision 3:

Project
Close Project

File

Exit

Application Note 77 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

5.) Using the Simulator (first we will test our program with the Keil Simulator):

Start Keil µVision and open our Keil Project

If you see an open project – close it: Project - Close Project

Project - Open Project


Select Project File: Look in: choose C:\XC888
Select Project File: Files of type: choose Project Files (*.uv2)
choose XC888.Uv2

Open

Note:
From now on just open your µVision project (not the DAvE project).
µVision will automatically recognise if there has been a code regeneration done by DAvE!

Application Note 78 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Check the configuration of the µVision simulator:

mouse position: (Project Workspace, Files): or click


Target1 click right mouse button
Options for Target ´Target1‘

Options for Target ´Target1‘: Debug: check ~ Use Simulator

OK

Application Note 79 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Start the µVision Simulator:

or click
Debug - Start/Stop Debug Session

OK

Application Note 80 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Start program-execution:

Debug – Run
View - Serial Window – UART #0
Peripherals - I/O-Ports – Port3
Peripherals – Timer – Timer0

Note:
By activating (clicking) the UART #0-window you can then type
1, 2 or 3 and see the result in the Parallel-Port-3-window.

Now we close our simulator session:

Debug - Stop Running


Debug - Start/Stop Debug Session

Now we close our project and µVision 3:

Project - Close Project

File – Exit

Application Note 81 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Note:
Since our program runs as expected in the simulator we can now use real hardware.

Application Note 82 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

6.) Using real hardware:

Using ULINK [used for: OnChipFlash-Programming and Debugging (using the JTAG interface)]:

Application Note 83 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Connecting the XC888-Board to the Environment:

Connect the USB Cable (the RS232 serial interface is available via USB; the USB connection
works also as the power supply):

Remove jumper Jumper COM:


J3 (BSL) select USB to
connect the TX
and RX pin of
USB-UART
bridge IC

Connect the KEIL-ULINK (used for: On-Chip-Flash-Programming and Debugging).

Application Note 84 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Note:
A USB driver is needed the first time while connecting the Starter Kit Board via the USB cable with
your computer.
Therefore a pop-up window might appear to prompt for a driver:

Application Note 85 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

If so: click Next

If so: click Next

Application Note 86 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

If so, please insert the XC88x Starter Kit CD check ; CD-ROM drives and click Next

If so: click Next

Application Note 87 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

If so: click Finish

Application Note 88 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Or select the USB driver from the directory SK88xCLM_CDV3_1\Driver of your XC88x Starter
Kit CD:

Application Note 89 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Note:
Skip this step when the USB driver is auto-detected and auto-installed.

Note:
A default COM Port is generated after the USB driver is installed.

Application Note 90 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Using a Windows 2000 operating system, we are now going to search for the COM Port which was
generated after connecting our XC888 Evaluation Board:

Start – Settings – Control Panel

Application Note 91 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click: Administrative Tools

Application Note 92 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click: Computer Management

Application Note 93 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Device Manager:

Application Note 94 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Expand: Ports (COM & LPT):


Expand: Universal Serial Bus controllers:

COM16

Note:
As we can see in the screenshot above:
our COM Port for UART/RS232 communication with the Starter Kit Board via USB is COM16 !

Application Note 95 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Additional information:
Using a SILICON LABS CP2102 ”Single-Chip USB To UART Bridge”:

Note:
IC2 soldered on the XC888 Starter Kit is a Silicon Labs CP2102 chip (Single-Chip USB To UART
Bridge) using Virtual COM Port Device Drivers.
Using Virtual COM Port drivers, the data format and baud rate are set during COM port
configuration on the PC.

Supported Data Formats and Baud Rates (Source: CP2102 Data Sheet):

The CP2102 Virtual COM Port (VCP) device drivers allow a CP2102-based device to appear as a
COM port to the PC’s application software.
The application software (e.g. Docklight) running on the PC accesses the CP2102-based device as it
would access a standard hardware COM port.

Every CP2102 device is delivered with a unique Serial Number making it possible to use more than
one XC888 Starter Kit at the same time.
That means every Starter Kit gets its own Virtual COM Port.

Note:
For further information, please refer to the XC888 Board Manual, V2.1, Sept 2006 .
For further information, please refer to the SILICON LABS CP2102 Datasheet .

Application Note 96 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Start Keil µVision and open our Keil Project

If you see an open project – close it: Project - Close Project

Project - Open Project


Select Project File: Look in: choose C:\XC888
Select Project File: Files of type: choose Project Files (*.uv2)
choose XC888.Uv2

Open

Application Note 97 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Check the configuration of the Flash-Programming-Utility:

mouse position: (Project Workspace, Files): or click


Target1 click right mouse button
Options for Target ´Target1‘

Options for Target ´Target1‘:


Utilities: Configure Flash Menu Command: check ~ Use Target Driver for Flash Programming
Options for Target ´Target1‘:
Utilities: Configure Flash Menu Command: check Infineon XC800 ULINK Driver

Application Note 98 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Options for Target ´Target1‘:


Utilities: Configure Flash Menu Command: click Settings

Application Note 99 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Flash Download Options: check: ; Erase Used Sectors


Flash Download Options: check: ; Program
Flash Download Options: check: ; Verify
Flash Download Options: check: ; Reset and Run

”1

OK
OK

Note:
”1: When the ULINK is already connected to the XC888 Starter Kit Board,
the Starter Kit Board must be supplied with power for the ULINK to work properly.
If the power supply is not connected to the Board,
you will see no information in the JTAG Device Chain window.

Application Note 100 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Note:
Now we need a terminal program which is able to handle COM16!
As an example of “any terminal program” we are going to use Docklight.
Docklight can be downloaded @ http://www.docklight.de .

Now, start Docklight:

Application Note 101 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Click: Project Settings

Application Note 102 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Project Settings:
Communication: Communication Mode: click ~ Send/Receive

Project Settings:
Communication: Communication Mode: Send/Receive on comm. channel: select COM16

Project Settings: Communication: COM Port Settings: Baud Rate: select 9600
Project Settings: Communication: COM Port Settings: Parity: select None
Project Settings: Communication: COM Port Settings: Parity Error Char.: select (ignore)
Project Settings: Communication: COM Port Settings: Data Bits: select 8
Project Settings: Communication: COM Port Settings: Stop Bits: select 1

Application Note 103 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Project Settings: Flow Control: Flow Control Support: click ~ Off

Application Note 104 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Project Settings:
Communication Filter: Contents Filter: click ~ Show all original communication data

OK

Application Note 105 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Click:

Application Note 106 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Note:
Docklight is now ready for serial communication!

Application Note 107 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Go back to µVision:

1.) click: 2.) click:

Application Note 108 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Go back to Docklight and see the result:

Application Note 109 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click inside the red box:

Application Note 110 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Edit Send Sequence: Sequence Definition: 1- Name: insert: LEDs ON


Edit Send Sequence: Sequence Definition: 2- Sequence: insert: 1

OK

Application Note 111 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click inside the red box:

Application Note 112 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Edit Send Sequence: Sequence Definition: 1- Name: insert: LEDs OFF


Edit Send Sequence: Sequence Definition: 2- Sequence: insert: 2

OK

Application Note 113 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Double click inside the red box:

Application Note 114 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Edit Send Sequence: Sequence Definition: 1- Name: insert: LEDs BLINKING


Edit Send Sequence: Sequence Definition: 2- Sequence: insert: 3

OK

Application Note 115 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Click LEDs ON or click LEDs OFF or click LEDs BLINKING and check the
result on your Evaluation Board:

Application Note 116 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

Conclusion:

In this step-by-step book you have learned how to use the XC888 board together with the Keil tool
chain.

Now you can easily expand our ”hello world” program to suit your needs!

You can connect either a part of - or your entire application to the Starter Kit Board.

You are also able to benchmark any of your algorithms to find out if the selected microcontroller
fulfils all the required functions within the time frame needed.

Have fun and enjoy working with XC88x microcontrollers!

Note:
There are step-by-step books for 8 bit microcontrollers (e.g. XC866 and XC88x), 16 bit
microcontrollers (e.g. C16x and XC16x) and 32 bit microcontrollers (e.g. TC1796 and TC1130).
All these step-by-step books use the same microcontroller resources and the same example code.
This means: configuration-steps, function-names and variable-names are identical.
This should give you a good opportunity to get in touch with another Infineon microcontroller
family or tool chain!
There are even more programming examples using the same style available [e.g. ADC-examples,
CAPCOM6-examples (e.g. BLDC-Motor, playing music), Simulator-examples, C++ examples]
based on these step-by-step books.

Application Note 117 V2.0, 2007-08


AP08067
XC88x Starter Kit "Cookery-Book"

7.) Feedback (XC888): Your opinion, suggestions and/or criticisms

Contact Details (this section may remain blank should you wish to offer
feedback anonymously):

______________________________________________________

______________________________________________________

______________________________________________________

If you have any suggestions please send this sheet back to:

email: [email protected]
FAX: +43 (0) 4242 3020 5783

Your suggestions:

______________________________________________________

______________________________________________________

______________________________________________________

______________________________________________________

______________________________________________________

______________________________________________________

______________________________________________________

______________________________________________________

Application Note 118 V2.0, 2007-08


http://www.infineon.com

Published by Infineon Technologies AG

You might also like