ARM RealView Versatile/PB926EJ-S Board Support Package for ...

®
ARM RealView
Versatile/PB926EJ-S
Board Support Package for
Microsoft Windows CE .NET
Revision: r0p0
User Guide
Copyright © 2004 ARM Limited. All rights reserved.
ARM DUI 0274A

ARM RealView Versatile/PB926EJ-S Board Support Package
for Microsoft Windows CE .NET
User Guide
Copyright © 2004 ARM Limited. All rights reserved.
Release Information
The following changes have been made to this document.
Change History
Date Issue Change
08 April 2004 A First release for r0p0
Proprietary Notice
Words and logos marked with ® or are registered trademarks or trademarks of ARM Limited in the EU and
other countries, except as otherwise stated below in this proprietary notice. Other brands and names
mentioned herein may be the trademarks of their respective owners.
Neither the whole nor any part of the information contained in, or the product described in, this document
may be adapted or reproduced in any material form except with the prior written permission of the copyright
holder.
The product described in this document is subject to continuous developments and improvements. All
particulars of the product and its use contained in this document are given by ARM Limited in good faith.
However, all warranties implied or expressed, including but not limited to implied warranties of
merchantability, or fitness for purpose, are excluded.
This document is intended only to assist the reader in the use of the product. ARM Limited shall not be liable
for any loss or damage arising from the use of any information in this document, or any error or omission in
such information, or any incorrect use of the product.
Confidentiality Status
This document is Non-Confidential. The right to use, copy and disclose this document may be subject to
license restrictions in accordance with the terms of the agreement entered into by ARM and the party that
ARM delivered this document to.
Product Status
The information in this document is final, that is for a developed product.
Web Address
http://www.arm.com
ii Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Contents
ARM RealView Versatile/PB926EJ-S
Board Support Package for
Microsoft Windows CE .NET User Guide
Preface
About this guide ............................................................................................. x
Feedback ..................................................................................................... xiii
Chapter 1
Chapter 2
Chapter 3
Introduction
1.1 About the Windows CE .NET Board Support Package ............................... 1-2
Using the BSP
2.1 Deliverables and peripherals ....................................................................... 2-2
2.2 Installation ................................................................................................... 2-4
2.3 Building the image ...................................................................................... 2-6
2.4 Running the image ...................................................................................... 2-9
2.5 Downloading using Multi-ICE and AXD from ADS .................................... 2-10
2.6 Downloading using RealView-ICE and the RealView Debugger .............. 2-12
2.7 Downloading the image to the board ........................................................ 2-14
Configuring the BSP
3.1 BSP environment variables ......................................................................... 3-2
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. iii

Contents
3.2 Configuring the ethernet bootloader ........................................................... 3-3
3.3 Flash images .............................................................................................. 3-5
3.4 Versatile/PB926EJ-S LED information ....................................................... 3-8
3.5 Creating a Software Development Kit ........................................................ 3-9
iv Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

List of Tables
ARM RealView Versatile/PB926EJ-S
Board Support Package for
Microsoft Windows CE .NET User Guide
Change History ............................................................................................................. ii
Table 3-1 BSP environment variables ....................................................................................... 3-2
Table 3-2 Eboot configuration menu ......................................................................................... 3-4
Table 3-3 Character LCD display settings ................................................................................. 3-8
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. v

List of Tables
vi Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

List of Figures
ARM RealView Versatile/PB926EJ-S
Board Support Package for
Microsoft Windows CE .NET User Guide
Figure 2-1 Manage Catalog Features dialog .............................................................................. 2-5
Figure 2-2 Platform configuration ............................................................................................... 2-6
Figure 2-3 Application and media options .................................................................................. 2-7
Figure 2-4 Networking and communications options .................................................................. 2-7
Figure 2-5 Platform Builder displaying the Catalog window ....................................................... 2-8
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. vii

List of Figures
viii Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Preface
This preface introduces the ARM RealView Versatile/PB926EJ-S Board Support
Package for Microsoft Windows CE .NET User Guide. It contains the following
sections:
• About this guide on page x
• Feedback on page xiii.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. ix

Preface
About this guide
This guide provides installation, set-up, and build information for the Windows CE
.NET Board Support Package (BSP) for the ARM926EJ-S processor-based RealView
Versatile Platform Baseboard. It describes the components of the Windows CE .NET
BSP including the supported peripherals and device drivers.
Product revision status
The rnpn identifier indicates the revision status of the product described in this guide,
where:
rn Identifies the major revision of the product.
pn Identifies the minor revision or modification status of the product.
Intended audience
This guide is written for all developers who want to set up and use the
Versatile/PB926EJ-S Board Support Package. It assumes that you are an experienced
software developer and that you are familiar with ARM development tools and
Microsoft Platform Builder.
Using this guide
Conventions
This guide is organized into the following chapters:
Chapter 1 Introduction
Read this chapter for an introduction to the Windows CE .NET BSP.
Chapter 2 Using the BSP
Read this chapter for information on using the BSP, and on installation,
building, and running images.
Chapter 3 Configuring the BSP
Read this chapter for information on how to configure the BSP.
The conventions used in this guide are described in:
• Typographical on page xi
• Numbering on page xi.
x Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Preface
Typographical
The following typographical conventions are used in this guide:
italic
bold
monospace
monospace
monospace italic
monospace bold
Highlights important notes, introduces special terminology,
denotes internal cross-references, and citations.
Highlights interface elements, such as menu names. Denotes
ARM processor signal names. Also used for terms in descriptive
lists, where appropriate.
Denotes text that you can enter at the keyboard, such as
commands, file and program names, and source code.
Denotes a permitted abbreviation for a command or option. You
can enter the underlined text instead of the full command or option
name.
Denotes arguments to monospace text where the argument is to be
replaced by a specific value.
Denotes language keywords when used outside example code.
< and > Angle brackets enclose replaceable terms for assembler syntax
where they appear in code or code fragments. They appear in
normal font in running text. For example:
• MRC p15, 0 , , ,
• The Opcode_2 value selects which register is accessed.
Numbering
The numbering convention is:
'
This is a Verilog method of abbreviating constant numbers. For example:
• 'h7B4 is an unsized hexadecimal value.
• 'o7654 is an unsized octal value.
• 8'd9 is an eight-bit wide decimal value of 9.
• 8'h3F is an eight-bit wide hexadecimal value of 0x3F. This is
equivalent to b00111111.
• 8'b1111 is an eight-bit wide binary value of b00001111.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. xi

Preface
Further reading
This section lists publications from both ARM Limited and third parties that provide
additional information on developing code for the ARM family of processors.
ARM periodically provides updates and corrections to its documentation. See
http://www.arm.com for current errata sheets and addenda, and the ARM Frequently
Asked Questions list.
ARM publications
This guide contains information that is specific to the Versatile/PB926EJ-S
Development System. Refer to the following documents for other relevant information:
• ARM RealView Versatile/PB926EJ-S Board Support Package for Windows CE
.NET Application Developer’s Guide (ARM DUI 0275)
• ARM RealView Versatile/PB926EJ-S User Guide (ARM DUI 0159)
• ARM Multi-ICE documents:
— Multi-ICE Version 2.2 User Guide (ARM DUI 0048)
— Multi-ICE Version 2.2 Installation Guide (ARM DSI 0005).
• ADS Version 1.2 AXD and armsd Debuggers Guide (ARM DUI 0066)
• Trace Debug Tools Version 1.2 User Guide (ARM DUI 0118)
Other publications
The following online documentation might provide useful background information:
• MSDN Microsoft Windows CE Platform Builder Library, in
http://msdn.microsoft.com/library/default.asp.
xii Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Preface
Feedback
ARM Limited welcomes feedback on both the Windows CE .NET BSP, and its
documentation.
Feedback on the Windows CE .NET BSP
If you have any problems with the Windows CE .NET BSP, contact your supplier. To
help us provide a rapid and useful response, give:
• details of the release you are using
• details of the platform you are running on, such as the hardware platform,
operating system type, and version
• a small standalone sample of code that reproduces the problem
• a clear explanation of what you expected to happen, and what actually happened
• the commands you used, including any command-line options
• sample output illustrating the problem
• the version string of the tool, including the version number and date.
Feedback on this guide
If you have any comments on this guide, send email to errata@arm.com giving:
• the document title
• the document number
• the page number(s) to which your comments apply
• a concise explanation of your comments.
ARM Limited also welcomes general suggestions for additions and improvements.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. xiii

Preface
xiv Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Chapter 1
Introduction
This chapter introduces the Windows CE .NET Board Support Package (BSP). It
contains the following sections:
• About the Windows CE .NET Board Support Package on page 1-2.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 1-1

Introduction
1.1 About the Windows CE .NET Board Support Package
This section outlines the Windows CE .NET BSP for the Versatile/PB926EJ-S:
• Features
• Tools
• Software revisions.
1.1.1 Features
This BSP enables you to take the working system and add your own applications to help
make a fully functional product in a short time. The BSP supports both VGA and Color
LCD screen output, at 640x480 in 16-bit. User interaction is performed using a PS/2
mouse and PS/2 keyboard. Audio playback and record is also supported in the BSP.
1.1.2 Tools
You build and test your code using Microsoft Windows CE .NET Platform Builder.
Support for automated and user testing is provided in the Windows CE .NET Test Kit.
1.1.3 Software revisions
The software revisions for use with the BSP are:
• Microsoft Windows CE .NET 4.2, with ARMV4I Quarterly QFE Packages Q2
and Q3 2003 installed. You can download the QFEs from www.microsoft.com.
• Microsoft Windows CE .NET Platform Builder 4.2.
• Microsoft eMbedded Visual C++ 4.0 with Service Packs (SP) 1 and 2 installed.
You can download the Service Packs from www.microsoft.com.
• ARM Developer Suite 1.2, build 848. You can download the 848 build patch for
ADS 1.2 from www.arm.com.
• ARM RealView-ICE 1.1.
• ARM RealView Debugger 1.7.
• ARM Multi-ICE 2.2.5. You can upgrade Multi-ICE 2.2 or higher by downloading
the Multi-ICE 2.2.5 patch from www.arm.com. See the Multi-ICE documentation
for more information.
• Versatile FPGA and PLD configuration images:
— Versatile/PB926EJ-S (HBI-0117BC) FPGA flash image 0 build 48
Character LCD Mux build 3.
1-2 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Chapter 2
Using the BSP
This chapter describes how you use the BSP, and gives information on installation,
building, and running images. It contains the following sections:
• Deliverables and peripherals on page 2-2
• Installation on page 2-4
• Building the image on page 2-6
• Running the image on page 2-9
• Downloading using Multi-ICE and AXD from ADS on page 2-10
• Downloading using RealView-ICE and the RealView Debugger on page 2-12
• Downloading the image to the board on page 2-14.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 2-1

Using the BSP
2.1 Deliverables and peripherals
This section describes the deliverables and supported peripherals for the Windows CE
.NET BSP:
• Deliverables
• Supported peripherals
• Serial ports
• Timers on page 2-3.
2.1.1 Deliverables
Refer to the release note contained in the package for a detailed list of the deliverables.
2.1.2 Supported peripherals
The Windows CE .NET BSP supports the following peripherals:
• Real-Time Clock PL031 (RTC)
• Color Liquid Crystal Display Controller PL110 (CLCDC)
• Universal Asynchronous Receiver/Transmitter PL011 (UART)
• Advanced Audio CODEC Interface PL041 (AACI)
• Keyboard and Mouse Interface PL050 (KMI)
• General Purpose Input/Output PL061 (GPIO)
• Counters/Timers SP804 (CT)
• Vectored Interrupt Controller PL190 (VIC)
• Dynamic Memory Access PL080 (DMA), for memory-to-memory transfer only
• Flash (memory for boot-up only)
• Debug LEDs and Character LCD Display
• Debug Ethernet.
2.1.3 Serial ports
The Versatile/PB926EJ-S has four UARTs or serial ports:
Serial Port 0
Serial Port 1
Serial Port 2
Serial Port 3
Is a Windows CE serial port named COM1:.
Unused.
Outputs debug messages. See Using Eboot on page 3-3 for
information on capturing the output from this port.
Unused.
2-2 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Using the BSP
2.1.4 Timers
The Versatile/PB926EJ-S platform supports four timers:
Timer0 This is used in the BSP as a the main Windows CE system timer at 1MHz.
Timer1 This is supported in the BSP, but is unused.
Timer2 This is used for internal routines in the kernel and boot loader.
Timer3 This is not supported in the BSP.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 2-3

Using the BSP
2.2 Installation
This section describes how you install the BSP:
• Unpacking the files
• Setting up the environment
• Installing Versatile/PB926EJ-S BSP catalog file.
Note
These instructions assume that you have successfully installed Platform Builder.
Check the release notes for any updates to these instructions.
2.2.1 Unpacking the files
2.2.2 Setting up the environment
To reconstruct the BSP directory structure:
1. Unpack the supplied deliverable file.
2. Move the top-level directory, ARMVPB926EJS\ and all its subdirectories and files to:
Drive:\WINCE420\PLATFORM
where Drive represents your root drive.
To set up the environment:
1. Create a system environment variable that points to your Platform Builder
installation directory. For example:
CEPBDir=C:\Program Files\Windows CE Platform Builder\4.20\cepb
You can set a system environment variable from the Advanced tab in the System
options of your Control Panel. See the Windows Help for more information.
2.2.3 Installing Versatile/PB926EJ-S BSP catalog file
To install the Versatile/PB926EJ-S BSP catalog file:
1. Launch Microsoft Platform Builder.
2. Click on the menu File → Manage Catalog Features.
3. In the Manage Catalog Features dialog box that appears, click Import.
2-4 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Using the BSP
4. Select $(_WINCEROOT)\Platform\ARMVPB926EJS\Catalogue\ARMVPB926EJS.cec and
click Open. Figure 2-1 shows the updated Manage Catalog Features dialog
box.
Figure 2-1 Manage Catalog Features dialog
5. In the Manage Catalog Features dialog box, click Refresh and then OK.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 2-5

Using the BSP
2.3 Building the image
To build an image:
1. Launch Platform Builder.
2. Click on the menu File → New Platform.
3. In the New Platform Wizard dialog, click Next.
4. From the BSP list, select ARM REALVIEW VERSATILE PB926EJ-S: ARMV4I, then click
Next.
5. From the Platform Configuration options, select Mobile HandHeld and enter a
platform name, as shown in Figure 2-2.
Figure 2-2 Platform configuration
Note
The Mobile Handheld platform configuration is chosen because this is the
environment used during ARM development and testing.
6. Click Next.
7. From the Application and Media options, select the following, as shown in
Figure 2-3 on page 2-7:
• ActiveSync
• Internet Browser - Pocket Internet Explorer
• Media Audio/MP3.
2-6 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Using the BSP
8. Deselect all other options, then click Next.
Figure 2-3 Application and media options
9. From the Networking and Communications options, select the following, as
shown in Figure 2-4:
• Local Area Network (LAN) - Wired Local Area Network
• Wide Area Network (WAN) - Dial-up Networking (RAS/PPP).
Figure 2-4 Networking and communications options
10. Deselect all other options, then click Next.
11. Read the ActiveSync security warning, then click Next.
12. Click Finish.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 2-7

Using the BSP
13. Click on the menu View → Catalog. In the displayed Catalog window (on the
right in the Platform Builder window):
a. Open the expanding view for Device Drivers.
b. Right click Windows CE Test Kit.
c. Select Add to Platform.
Figure 2-5 shows the resulting display.
Figure 2-5 Platform Builder displaying the Catalog window
14. Optionally, add the Versatile-specific tests. In the Catalog window:
a. Open the expanding views for Third Party → BSPs → ARM RealView
Versatile PB926EJ-S: ARMV4I → Tests.
b. Right click on a specific test.
c. Select Add to Platform.
15. Click on the menu Build → Rebuild Platform.
The nk.bin file is ready to be downloaded to the FPGA platform using EBOOT.
2-8 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Using the BSP
2.4 Running the image
The ethernet bootloader is responsible for configuring the board to accept an image
from Platform Builder.
To run the image:
1. Download the ethernet bootloader using one of the following:
• Multi-ICE and AXD from ADS.
This is described in Downloading using Multi-ICE and AXD from ADS on
page 2-10.
• RealView-ICE and the RealView Debugger.
This is described in Downloading using RealView-ICE and the RealView
Debugger on page 2-12.
2. After the image has built successfully, download it to the board. This is described
in Downloading the image to the board on page 2-14.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 2-9

Using the BSP
2.5 Downloading using Multi-ICE and AXD from ADS
To download the ethernet bootloader to Versatile/PB926EJ-S using Multi-ICE and
AXD from ADS:
1. Make sure the VGA monitor or LCD panel is plugged in correctly.
2. Copy the bootloader file to an easily accessible place, for example, C:\. The
bootloader file is in the platform flat release directory and is called eboot.nb0.
3. Set up the hardware connection:
a. Turn off the Versatile board and connect Multi-ICE.
b. Make sure the following switches are set on the Versatile board:
S1-1 ON
S1-2 OFF
S6-1 OFF
S6-7 OFF
S6-8 OFF.
c. Turn on the Versatile board.
d. Launch the Multi-ICE server from the host PC.
e. Configure Multi-ICE to the relevant ARM core, using Auto Configure
from the File menu.
4. Launch AXD.
5. Select Go from the Execute menu to continue execution.
6. Press the reset switch on the Versatile board. AXD displays a dialog stating the
processor was reset. Click OK.
7. Select Go from the Execute menu to continue execution. The boot monitor output
appears in the debugger console window.
8. Enter flash in the debugger console window to enter the flash programming mode
of the boot monitor.
9. Enter list images, then enter the following on each image apart from the
BOOT_MONITOR.AXF image:
erase image_name
10. Enter the following to program in the Ethernet Bootloader image:
write image c:\eboot.nb0 eboot 0x34080000
11. Return to the main boot monitor menu by entering exit.
2-10 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Using the BSP
12. Create a new boot script by entering:
bootscript set
13. Finish the boot script by entering the go instruction and two carriage returns:
go 0x34080000
14. Select Stop from the Execute menu to stop execution.
15. Close AXD.
16. Optionally, connect a serial cable from your PC to serial port 2 of the Versatile
board for serial debug output. See Using Eboot on page 3-3 for more information
on capturing debug output.
17. Change ARM Versatile DIP S6-1 to on.
18. Connect an ethernet cable between the network and the ethernet port on the
Versatile board.
You now download the image to the board, as described in Downloading the image to
the board on page 2-14.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 2-11

Using the BSP
2.6 Downloading using RealView-ICE and the RealView Debugger
To download the ethernet bootloader to Versatile/PB926EJ-S using RealView-ICE and
the RealView Debugger:
1. Make sure the VGA monitor or LCD panel is plugged in correctly.
2. Copy the bootloader file to an easily accessible place, for example, C:\. The
bootloader file is in the platform flat release directory and is called eboot.nb0.
3. Set up the hardware connection:
a. Turn off the Versatile board and connect RealView-ICE.
b. Make sure the following switches are set on the Versatile board:
S1-1 ON
S1-2 OFF
S6-1 OFF
S6-7 OFF
S6-8 OFF.
c. Turn on the Versatile board.
d. Launch RVD and select Connection → Connect to Target from the File
menu.
e. Right click on the RealView-ICE entry in the Connection Control dialog
and select Configure Device Info.
f. Configure your connection type and connect to RealView-ICE.
g. Click Auto Configure Scan Chain in the Scan Chain Configuration
view.
h. Select Exit from the File menu.
i. Click Yes to save the changes.
j. Expand the RealView-ICE entry in the Connection Control dialog.
k. Click the box next to the name of the ARM core to connect. This displays
a tick if the connection succeeds.
l. Close the Connection Control dialog.
4. Select Go from the Debug → Execution Control menu.
5. Press the reset switch on the Versatile board. The boot monitor output appears in
the debugger output window on the StdIO tab.
6. Enter flash in the debugger output window on the StdIO tab to enter the flash
programming mode of the boot monitor.
2-12 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Using the BSP
7. Enter list images, then enter the following on each image apart from the
BOOT_MONITOR.AXF image:
erase image_name
8. Enter the following to program in the Ethernet Bootloader image:
write image c:\eboot.nb0 eboot 0x34080000
9. Return to the main boot monitor menu by entering exit.
10. Create a new boot script by entering:
bootscript set
11. Finish the boot script by entering the go instruction and two carriage returns:
go 0x34080000
12. Select Stop from the Debug → Execution menu to stop execution.
13. Close RVD.
14. Optionally, connect a serial cable from your PC to serial port 2 of the Versatile
board for serial debug output. See Using Eboot on page 3-3 for more information
on capturing debug output.
15. Change ARM Versatile DIP S6-1 to on.
16. Connect an ethernet cable between the network and the ethernet port on the
Versatile board.
You now download the image to the board, as described in Downloading the image to
the board on page 2-14.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 2-13

Using the BSP
2.7 Downloading the image to the board
After the image has built successfully:
1. In Platform Builder, select the menu Target and click Configure Remote
Connection.
2. On the Service tab, choose Ethernet for both Download and Debug.
3. Turn on the Versatile board and click Configure for Download. Ensure the
correct device is selected. It might take a few seconds for the device to appear.
4. Click OK.
5. In Platform Builder, select the menu Target, then click Download/Initialize.
6. Turn the Versatile board off and on again at the downloading dialog prompt. The
image is downloaded to the board and starts running.
Typical ethernet download speeds are between 100-200KB per second on a 10MB LAN
connection with little other traffic.
On the serial debug output, it is normal to see a number of TFTP retries during the
download. If there is too much external traffic on the ethernet, this can cause download
failure.When the download is complete, the debug output switches from the serial
interface to the ethernet interface. The output then appears in Platform Builder.
2-14 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Chapter 3
Configuring the BSP
This chapter describes how to configure the BSP. It contains the following sections:
• BSP environment variables on page 3-2
• Configuring the ethernet bootloader on page 3-3
• Flash images on page 3-5
• Versatile/PB926EJ-S LED information on page 3-8
• Creating a Software Development Kit on page 3-9.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 3-1

Configuring the BSP
3.1 BSP environment variables
Table 3-1 lists the BSP environment variables. These are all defined and set in the
ARMVPB926EJS.bat file.
Variable Usage Description
Table 3-1 BSP environment variables
BSP_WAVEDEV_AACI set BSP_WAVEDEV_AACI=1 Include the driver set for the AACI wave
device (default).
BSP_DISPLAY_ARMCLCD set BSP_DISPLAY_ARMCLCD=1 Include the driver set for the ARM CLCD
controller (default).
CLCD_565 set CLCD_565=1 Use 565 display in 16-bit color mode
(default) a .
set CLCD_565=
Use 555 display in 16-bit color mode.
CLCD_BEST_OUTPUT set CLCD_BEST_OUTPUT= Optimize display output for VGA (default).
set CLCD_BEST_OUTPUT=1
Optimize display output for CLCD.
EXEFLASH b set EXEFLASH= Do not execute flash images directly from
flash (default).
set EXEFLASH=1
Execute flash images directly from flash.
IMG_NBX b set IMG_NBX= Do not create raw flash images (nk.nb*)
(default).
set IMG_NBX=1
Create raw flash images.
a. This is the best option because it passes the WCETK GDI Tests.
b. See Flash images on page 3-5 for more information on flash settings.
3-2 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Configuring the BSP
3.2 Configuring the ethernet bootloader
This section describes how to use and configure the ethernet bootloader:
• Using Eboot
• Configuring Eboot on page 3-4.
Note
Ensure that you have downloaded Eboot to the Versatile board. For more information,
see Downloading using Multi-ICE and AXD from ADS on page 2-10 and Downloading
using RealView-ICE and the RealView Debugger on page 2-12.
3.2.1 Using Eboot
The ethernet bootloader sends all its output to Serial port 2 of the Versatile board. To
see this information:
1. Connect a serial cable between your PC and Serial port 2 of the
Versatile/PB926EJ-S development board.
2. Launch a serial port communication program on your PC, for example,
Hyperterminal.
3. Configure the communication settings to:
• 38400bps
• 8 bits
• no parity
• 1 stop bit
• no flow control.
Eboot starts up when you turn on the Versatile board. You then have five seconds to
break into the configuration menu. You do this by sending a key press down the serial
connection using the Hyperterminal window. Configuring Eboot on page 3-4 explains
the configuration menu.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 3-3

Configuring the BSP
3.2.2 Configuring Eboot
Menu Key Option
Main 1 Network settings menu.
Table 3-2 shows the options in the Eboot configuration menu.
2 Kitl settings menu.
3 Flash settings menu.
9 Exit menus and continue boot.
Network settings 1 Show current network settings.
Table 3-2 Eboot configuration menu
2 Toggle DHCP enabled setting:
• When enabled, a network address is retrieved from a DHCP server.
• When disabled, Eboot uses the static IP address and subnet mask supplied below.
3 Enter a static IP address and subnet mask. This is used when DHCP is disabled.
9 Return to main menu.
Kitl settings a 1 Show current Kitl settings.
2 Toggle Kitl Enabled setting:
• When enabled, this connects to Platform Builder during boot-up, if Kitl is set to Active.
• When disabled, this boots an image without requiring Platform Builder. No Ethernet
connection is present in this mode.
3 Toggle Kitl Active Mode setting:
• When active, a connection to Platform Builder is made during boot-up.
• When passive, if Kitl is enabled, you can use your own Kitl connection tool to connect
after boot-up.
9 Return to main menu.
Flash settings a 1 Show current flash settings.
2 Toggle Force Platform Builder Flash Download/boot setting:
• You must use the enabled setting when downloading or booting a flash image from
Platform Builder that does not execute from flash.
• When disabled, Platform Builder controls what happens to the download or boot.
9 Return to main menu
a. See Flash images on page 3-5 for more information on flash settings.
3-4 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Configuring the BSP
3.3 Flash images
This section describes the different options for creating flash images:
• Building flash images
• Running flash images
• Raw flash images on page 3-7.
3.3.1 Building flash images
To create a flash image:
1. Ensure you have created a new platform (see Building the image on page 2-6).
2. Click on the menu Platform → Settings.
3. Click the Build Options tab.
4. Tick the Enable Image for Flash option.
5. Edit the second EXEFLASH setting in ARMVPB926EJS.bat depending on your flash
preferences:
a. To copy the flash image to RAM and execute from there:
set EXEFLASH=
b. To execute the image in flash:
set EXEFLASH=1
6. Click on the menu Build → Rebuild Platform.
3.3.2 Running flash images
To download this image to the Versatile/PB926EJ-S platform:
1. Download Eboot (see Downloading using Multi-ICE and AXD from ADS on
page 2-10 and Downloading using RealView-ICE and the RealView Debugger on
page 2-12).
2. Change the Force Platform Builder Flash Download/boot setting in the Eboot
configuration menu (see Configuring Eboot on page 3-4). Set this depending on
the type of flash image you built in Building flash images:
a. ENABLE this setting to copy the flash image to RAM and execute from
there.
b. DISABLE this setting to execute the image in flash memory.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 3-5

Configuring the BSP
3. Download the flash image to the Versatile/PB926EJ-S:
a. In Platform Builder, click on the menu Target → Configure Remote
Connection.
b. On the Settings tab, tick Download Image and select Download always.
c. On the Service tab, choose Ethernet for both Download and Debug.
d. Turn on the Versatile board and click Configure for Download. Ensure the
correct device is selected. It might take a few seconds for the device to
appear.
e. Click OK.
f. In Platform Builder, click on the menu Target → Download/Initialize.
g. Turn the Versatile board off and on again at the downloading dialog prompt.
The image is downloaded to the board and written to flash, then starts
running.
Rebooting the Versatile/PB926EJ-S
You can reboot the Versatile/PB926EJ-S using the current flash image with or without
a network connection:
With a network connection:
1. In Platform Builder, click on the menu Target → Configure
Remote Connection.
2. On the Settings tab, uncheck Download Image and select Jump
to image only.
3. Click OK.
4. In Platform Builder, click on the menu Target →
Download/Initialize.
5. Turn the Versatile board off and on again at the downloading dialog
prompt. The image in flash then starts running.
Without a network connection:
1. Set switch S6-2 to ON.
2. Disable the Kitl Enabled setting in the Eboot configuration menu
(see Configuring Eboot on page 3-4).
3. Exit from the configuration menu. The image in flash starts
running.
3-6 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Configuring the BSP
3.3.3 Raw flash images
As described in Running flash images on page 3-5, Eboot performs the image flashing
to the Versatile/PB926EJ-S platform. Alternatively, you can create raw flash images
that you can flash to the Versatile/PB926EJ-S yourself:
1. Edit the IMG_NBX setting in ARMVPB926EJS.bat:
set IMG_NBX=1
2. Click on the Platform Builder menu Build → Rebuild Platform.
This creates a nk.nb0 file in your flat release directory. This is the raw flash image. You
can now download this image to flash using a different method.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 3-7

Configuring the BSP
3.4 Versatile/PB926EJ-S LED information
This section explains the meaning of the LEDs and character LCD display on the
Versatile/PB926EJ-S development board:
• LEDs
• Character LCD display.
3.4.1 LEDs
The LEDs give the following information:
LED0
LED7
ETH
When this LED is on, the flash image has been copied to RAM.
Indicates how busy the system is. The faster this LED flashes, the greater
the system load is.
Indicates ethernet packet status:
• When ETH LED GREEN is on, ethernet packets are being received
• When ETH LED ORANGE is on, ethernet packets are being sent.
3.4.2 Character LCD display
Table 3-3 explains the Character LCD display settings.
Table 3-3 Character LCD display settings
Display
Config 5 to 1...
Config Menu
BootMe
Downloading
Flash Writing
Go...
-Standby-
Summary
A five-second period when you can enter the Eboot configuration menu.
Eboot configuration menu entered.
Versatile/PB926EJ-S is awaiting Platform Builder connection.
An image is downloading from Platform Builder.
An image is writing to flash.
An image is copying to RAM (if required) and is being executed.
The image is in standby mode.
3-8 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Configuring the BSP
3.5 Creating a Software Development Kit
This section contains information on creating a Software Development Kit (SDK) from
a platform you have created:
• Creating an SDK
• Installing the SDK
• Selecting a platform on page 3-10.
3.5.1 Creating an SDK
To create an SDK:
1. In Platform Builder, click on the menu Platform → Configure SDK. This
displays the Export SDK Wizard dialog. Click Next.
2. Enter the product and manufacturer names, then click Next.
3. Select any development languages features you want to support, and then click
Next.
4. Click Finish.
5. Click on the menu Platform → Build SDK. The Export SDK Wizard dialog
now shows your SDK build progress. When it has finished, select Done.
The SDK is now in your platform project directory, for example:
WINCE420\PUBLIC\MyPlatform\SDK\MyPlatformSDK.msi
6. Double click on the .msi file to install the SDK.
3.5.2 Installing the SDK
You install the SDK with Microsoft eMbedded Visual C++ (eMVC). This enables
eMVC to directly connect to the Versatile/PB926EJ-S using one of:
• TCP/IP
• Kitl
• ActiveSync.
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. 3-9

Configuring the BSP
3.5.3 Selecting a platform
When you have installed the SDK, you can now select your platform in Microsoft
eMbedded Visual C++:
1. In eMbedded Visual C++, click on the menu Build → Set Active Platform.
2. Select your platform from the list in the Set Active Platform dialog. Click OK.
3. Select Tools → Configure Platform Manager.
4. In the Windows CE Platform Manager Configuration dialog:
a. Open the expanding view for your platform.
b. Select your platform device.
c. Click on Properties.
5. Select the Transport and Startup Server connection type and configure them as
required.
6. Click OK.
7. Click OK in the Windows CE Platform Manager Configuration dialog.
You can now directly connect and download your application from within eMVC.
3-10 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Index
The items in this index are listed in alphabetical order. The references given are to page numbers.
A
ActiveSync 2-6, 2-7
Application and Media Options dialog
2-6
Audio playback 1-2
B
Board Support Package. see BSP
BSP
configuration 3-2
environment variables 3-2
features 1-2
testing 1-2
tools 1-2
C
Catalog window 2-8
CEPBDir system environment variable
2-4
Character LCD display 3-8
Conventions
numerical xi
typographical xi
D
Deliverables 2-2
E
Ethernet bootloader, EBOOT 2-9
configuration menu options 3-4
configuring 3-3
downloading 2-12
using 3-3
Ethernet download speeds 2-14
F
Files, unpacking 2-4
Flash images
building 3-5
downloading 3-5
raw 3-7
running 3-5
Flash settings 3-4
I
Images
building 2-6
downloading to the board 2-9, 2-14
running 2-9
Installing
BSP 2-4
setting up the environment 2-4
Versatile/PB926EJ-S BSP catalog
file 2-4
ARM DUI 0274A Copyright © 2004 ARM Limited. All rights reserved. Index-1

Index
K
Keyboard type 1-2
Kitl settings 3-4
L
LED information 3-8
M
Manage Catalog Features dialog 2-5
Mobile Handheld platform
configuration 2-6
Mouse type 1-2
Multi-ICE 1-2, 2-10
N
Network settings 3-4
Networking and Communications
options dialog 2-7
Numerical conventions xi
P
Peripherals 2-2
Peripherals, list of 2-2
Platform Builder 1-2
Platform Configuration dialog 2-6
Product revision status x
creating 3-9
selecting a platform 3-10
Serial ports 2-2
Software revisions 1-2
System environment variable, CEPBDir
2-4
T
TFTP retries 2-14
Timers 2-3
Typographical conventions xi
U
UARTs 2-2
V
Versatile/PB926EJ-S
ETH LED 3-8
MISC LED 3-8
rebooting with network connection
3-6
rebooting without network
connection 3-6
W
Windows CE .NET BSP. see BSP
R
RealView Debugger 1-2, 2-12
RealView-ICE 1-2, 2-12
Recording facility 1-2
Revision status x
S
Screen output 1-2
SDK
Index-2 Copyright © 2004 ARM Limited. All rights reserved. ARM DUI 0274A