ARM RealView Versatile/PB926EJ-S Board Support Package for Microsoft Windows CE.NET

Size: px

Start display at page:

Download "ARM RealView Versatile/PB926EJ-S Board Support Package for Microsoft Windows CE.NET"

Karen Briggs
6 years ago
Views:

2 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 ii Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

3 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 Using the BSP 2.1 Deliverables and peripherals Installation Building the image Running the image Downloading using Multi-ICE and AXD from ADS Downloading using RealView-ICE and the RealView Debugger Downloading the image to the board Configuring the BSP 3.1 BSP environment variables ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. iii

4 Contents 3.2 Configuring the ethernet bootloader Flash images Versatile/PB926EJ-S LED information Creating a Software Development Kit iv Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

5 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 Table 3-2 Eboot configuration menu Table 3-3 Character LCD display settings ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. v

7 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 Figure 2-2 Platform configuration Figure 2-3 Application and media options Figure 2-4 Networking and communications options Figure 2-5 Platform Builder displaying the Catalog window ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. vii

9 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

10 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

11 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 <Rd>, <CRn>, <CRm>, <Opcode_2> The Opcode_2 value selects which register is accessed. Numbering The numbering convention is: <size in bits>'<base><number> 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 b 'b1111 is an eight-bit wide binary value of b ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. xi

12 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 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 xii Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

13 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 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

15 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

16 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 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 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 Software revisions The software revisions for use with the BSP are: Microsoft Windows CE.NET 4.2, with ARMV4I Quarterly QFE Packages Q2 and Q installed. You can download the QFEs from Microsoft Windows CE.NET Platform Builder 4.2. Microsoft embedded Visual C with Service Packs (SP) 1 and 2 installed. You can download the Service Packs from ARM Developer Suite 1.2, build 848. You can download the 848 build patch for ADS 1.2 from ARM RealView-ICE 1.1. ARM RealView Debugger 1.7. ARM Multi-ICE You can upgrade Multi-ICE 2.2 or higher by downloading the Multi-ICE patch from 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 Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

17 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 ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. 2-1

18 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 Deliverables Refer to the release note contained in the package for a detailed list of the deliverables 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 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

19 Using the BSP 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

20 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 Unpacking the files 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 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.$

21 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.

22 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/MP Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

Network Wide Area Network (WAN) - Dial-up Networking (RAS/PPP). Figure 2-4 Networking and communications options 10.

23 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.

24 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

25 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 RealView-ICE and the RealView Debugger. This is described in Downloading using RealView-ICE and the RealView Debugger on page After the image has built successfully, download it to the board. This is described in Downloading the image to the board on page ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. 2-9

26 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 0x Return to the main boot monitor menu by entering exit Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

27 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 0x <RETURN> <RETURN> 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 ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. 2-11

28 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 Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

29 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 0x 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 0x <RETURN> <RETURN> 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 ARM DUI 0274A Copyright 2004 ARM Limited. All rights reserved. 2-13

30 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 KB 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 Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

31 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

32 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

33 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 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

34 Configuring the BSP 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

35 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 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 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

36 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

37 Configuring the BSP 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

38 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 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 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

39 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 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 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

40 Configuring the BSP 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 Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0274A

41 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

42 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

Integrator /CP Board Support Package for Microsoft Windows CE.NET

Integrator /CP Board Support Package for Microsoft Windows CE.NET Revision: r0p0 Application Developer s Guide Copyright 2004 ARM Limited. All rights reserved. ARM DUI 0272A Integrator/CP Board Support