Mips Technologies Malta development platform User manual

Document Number: MD00141
Revision 6.03
December 20, 2009
MIPS Technologies, Inc.
955 East Arques Avenue
Sunnyvale, CA 94085-4521
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
MIPS® MaltaTM Developer’s Kit - Getting
Started with Windows® Embedded CE

MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03 2
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
Contents
Section 1: Overview................................................................................................................................ 4
1.1: How to Get Started ...................................................................................................................................... 4
1.2: Target Hardware.......................................................................................................................................... 4
1.3: Host Development PC Requirements.......................................................................................................... 4
1.4: Required Software Tools ............................................................................................................................. 5
Section 2: Target Hardware Setup ........................................................................................................ 6
2.1: Jumper Settings........................................................................................................................................... 7
2.2: DIP Switch Settings ..................................................................................................................................... 7
2.3: Installing PCI Cards..................................................................................................................................... 7
2.3.1: Network Cards............................................................................................................................. 7
Section 3: Host Development PC Setup ............................................................................................... 8
3.1: Installing the Windows Embedded CE Tools............................................................................................... 8
3.2: Installing the MIPS Malta BSP..................................................................................................................... 8
3.3: Verify the Windows Embedded CE Tool Installation ................................................................................... 8
Section 4: Target Software Setup ....................................................................................................... 10
4.1: Installing the Windows Embedded CE Boot loader ................................................................................... 10
4.1.1: Binary installation: BOOT_xxx.fl ................................................................................................ 10
4.1.2: Binary installation: BOOT_xxx.bin ............................................................................................. 12
4.1.3: Binary installation: BOOT_xxx.sre............................................................................................. 14
4.2: Configuring the Windows Embedded CE Boot loader............................................................................... 17
Section 5: Host/Target Connectivity ................................................................................................... 19
Section 6: Support................................................................................................................................ 21
Section 7: Revision History ................................................................................................................. 22

3 MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.

MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03 4
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
1 Overview
This document describes how to get started with Microsoft® Windows® Embedded CE version 6.0 operating system
on the MIPS® Malta™development platform.
1.1 How to Get Started
New users of the Malta development platform are recommended to read and follow the guidelines in the document,
"Malta Developers Kit Getting Started" (MD00051), delivered along with the Malta board, to understand the basic
Malta hardware in operation and then continue with the guidelines in this document to proceed with setting up a Win-
dows Embedded CE development environment on Malta.
1.2 Target Hardware
The basic Malta hardware, as delivered, consists of the Malta motherboard and its daughter board, which carries a
suitable CPU (MIPS32-4Kc/4KEc/4KSc/24Kc/24Kf/34K/1004K or MIPS64-5Kc/5Kf/20Kc/25Kf) and System Con-
troller (Galileo GT64120, MIPS Bonito64, or MIPS SOCit™). The daughter board must be equipped with a minimum
32 MB PC100 SDRAM (64 MB is recommended). This release supports the L2 cache.
In addition to the basic Malta hardware, you will need:
• Suitable standard ATX cabinet with power supply. For a power supply with standby capabilities, a minimum cur-
rent of 720 mA is required (1A/1.5A peak recommended) for the 5V standby voltage.
• Windows Embedded CE compatible Video PCI card (the MIPS Malta BSP defaults to the ATI RageXL)
• Optional Windows Embedded CE compatible Audio PCI card (the MIPS Malta BSP defaults to the Ensoniq
ES1371 PDD)
• Optional NE2000 compatible Ethernet PCI card, when booting Windows Embedded CE stand alone applications.
(Nno KITL/VMINI transport)
• PS/2 Keyboard and Mouse
• VGA monitor
• Ethernet cables
• Parallel port cable for downloading Windows Embedded CE 6.0 boot loader
1.3 Host Development PC Requirements
Please see details on the Microsoft product, Windows Embedded CE 6.0, for the current list of requirements for the
host PC. Recent requirements included:
• 600 MHz Pentium (1 GHz recommended) processor

5 MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
• 192 MB RAM (256 MB recommended)
• Without MSDN, an aggragate of 3 GB, 3.8 or 4.8 GB with an MSDN installation
• CD-ROM or DVD-ROM drive is not required
• Graphics display of 800x600 at 256 colors; 1024x768 16-bit color recommended
• Microsoft Mouse or compatible pointing device
1.4 Required Software Tools
To start Windows Embedded CE development on Malta, you will need following software:
• Microsoft Windows Embedded CE version 6.0. This tool package contains Platform Builder 6.0, all the binary
Windows Embedded CE 6.0 OS kernels and system libraries, and the Microsoft® Visual C++® 2005.
NOTE: To get more information and to submit an order for the package, you may go to Microsoft’s website to
Products and Related Technologies, to Develop Tools, to Windows Embedded.
• MIPS Malta Development Platform BSP (release 06.00.00 or higher) for the Windows Embedded CE 6.0 operat-
ing system
NOTE: Please send an email request to "[email protected]om" with subject "Request for MIPS Malta Windows
Embedded CE 6.0 BSP".
• A terminal emulation program for communicating with the Target Malta board via its Debug Serial port. We do
not recommend using HyperTerm, as it can be confusing when used in this system to determine the order of lines
displayed from the target. Alternatives include Tera Term, which is a free terminal emulator (see The Tera Term
Home Page) and Procomm Plus32, which can be purchased from Datastorm Technologies.

MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03 6
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
2 Target Hardware Setup
The diagram in Figure 1 shows the layout of the Malta board.
Figure 1 Location of Essential Features of Malta Board
12345678910
1 2 3 4 5 6 7 8
3V
12 45 6 7 83
1 2 43
U42
J17
J15
J16
J14
J13
J12
J2 J4
J3
J8
J7
J5
J6
JP4
JP2
J10
J22
J20
J19 J18
J21
J9
J1
JP1
JP3
S5
S2 D28
ON/NMI
RESET
RST
STBY
5V
3V3
ATX ON
FPGA
TX
SPD100
J31
PCI SLOT#1
PCI SLOT#2
PCI SLOT#3
PCI SLOT#4

7 MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
For Windows Embedded CE on Malta, following locations are important to notice:
• ’JP4’ (left side): jumpers to control the PCI clock frequency
• ’S5-0’ (right side): dip switch "PROG" controls programming of on-board flash via the parallel port
• ’S5-1’ (right side): dip switch "BIGEND" controls endianness and must be set ’OFF’ = ’little endian’, as the
Windows Embedded CE operating system is available (compiled) for ’little endian’ only
• ’J12’-’J15’: PCI slots 1-4
2.1 Jumper Settings
By default, no jumpers are fitted on the Malta board.
NOTE: When using a Malta daughter board with a core bus speed slower than the default PCI-clock of 33 MHz, the
PCI-clock speed must be adjusted via jumper block JP4 to be the same or slower than the core bus speed. See "Malta
User’s Manual" (MD00048) Table 23 "Jumpers" for a list of available PCI-clock speeds and jumper combinations.
2.2 DIP Switch Settings
The dip switch, S5-1 BIGEND, must be set to OFF to set endianness = little. (The Windows Embedded CE operating
system is always compiled for little endianness.)
2.3 Installing PCI Cards
PCI cards may be installed in any slot on the Target Malta board, but some slots share interrupt lines with other
devices on the PCI bus. PCI card placement may affect interrupt priority and latency.
PCI devices map to the following interrupts:
• PCI slot 1 maps to PCI INTA which is steered to IRQ5 on the PIIX4E South Bridge Interrupt Controller
• PCI slot 2 and the on-board AMD Ethernet Controller (AM79C973) map to PCI INTB which is steered to IRQ10
on the PIIX4E South Bridge Interrupt Controller
• PCI slot 3 and the on-board Crystal Audio Controller (CS4281) map to PCI INTC which is steered to IRQ11 on
the PIIX4E South Bridge Interrupt Controller
• PCI slot 4 and the on-board PIIX4E USB Host Controller map to PCI INTD which is steered to IRQ9 on the
PIIX4E South Bridge Interrupt Controller
2.3.1 Network Cards
When using the Malta board with Platform Builder, the Malta on-board Ethernet Controller is supported by the shared
Ethernet driver of the MIPS Malta BSP, providing download and debug network traffic and application network traf-
fic as well. However, the shared Ethernet driver cannot be used for stand alone Windows Embedded CE applications,
when booting Windows Embedded CE images in non-debug mode. Therefore, to obtain network access for stand

MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03 8
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
alone applications, an NE2000-compatible PCI Ethernet Controller may be installed in an available PCI slot. See the
Windows Embedded CE documentation for a list of supported PCI Ethernet Controllers.
3 Host Development PC Setup
3.1 Installing the Windows Embedded CE Tools
Windows Embedded CE 6.0 is delivered in conjuction with Microsoft Visual Studio 2005. To install, you will first
install the Microsoft Visual Studio Suite, and then install Windows Embedded CE 6.0. Follow the installation instruc-
tions for Microsoft Visual Studio 2005 first, which will lead you through two discs.
During installation configuration of Windows Embedded CE 6.0 , you will be asked to select which CPUs will be
supported. Please select all of the following:
• MIPSII
• MIPSII_FP
• MIPSIV
• MIPSIV_FP
3.2 Installing the MIPS Malta BSP
You can download the MIPS Malta BSP from the MIPS Technologies web site: http://www.mips.com/products/soft-
waretools/system_software/Windows_CE_BSP.php.
The download includes:
• This document (MD00141 – MaltaTM Developer’s Kit – Getting Started with Windows Embedded Embedded CE
6.0)
• Release Notes, in readme.txt
• Microsoft Installation package
The MIPS Malta BSP source, a Platform Builder CEC description file, and a readme.txt file detailing use of the BSP
with the Malta development board, are located in the Microsoft Installation package.
Double-click on the MSI file to begin installing the MIPS Malta BSP and follow the Package Wizard instructions to
complete the installation.
3.3 Verify the Windows Embedded CE Tool Installation
Now everything should be installed on the Host Development PC and the Windows Embedded CE development envi-
ronment for MIPS Malta BSP should be ready. The installation should be verified by building a Windows Embedded

9 MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
CE sample image. The following example describes how to build a sample image with the ready to use sample plat-
form, "Internet Appliance", and built for a "MIPSII" kernel, which is compliant with all supported MIPS CPU cards
on Malta.
Lauch Start-> All Programs-> Microsoft Visual Studio 2005-> Microsoft Visual Studio 2005, and execute the follow-
ing steps:
1. Enter File -> New-> Project
2. Select “Platform Builder for CE 6.0” in the left pane, and “OS Design” in the right. Enter a name for your new
design, and press OK.
3. Press Next.
4. Select “MIPS Malta: MIPSII”, and press Next.
5. Select Industrial Device and press Next.
6. Select Internet Appliance and press Next.
7. Press Finish,
8. The pop-up “Catalog Item Notification” is a standard Microsoft security warning; press Acknowledge.
9. Select “Build Solution” from the Build pull-down menu to build the Windows Embedded CE sample image and
await build completion. For those with prior experience with Microsoft CE products, avoid the “Advanced Build
Commands” -> “Build and Sysgen” option; it rebuilds code for which libraries are shipped that you do not need
to rebuild.
Verify that the image builds to completion with no errors.
You can change build options by selecting the Project -> Properties pull-down. In the pop-up window, select Config-
uration Properities -> Build Options. For example, if you are doing a release build, you may still want to enable the
Debugger.
NOTE: For Step 9, a potential risk exists, especially when building big images like debug images, to get build errors
like "Error: Too much data space used by DLLs in MODULES section....". The reason is that more static memory
than the default (min. 32 MB device) is required and must be assigned by setting a predefined environment variable
"IMGRAM64" to "1" (min. 64 MB device). This Build Option can be found on the same pop-up window as described
in the previous paragraph – it is labeled “Run-time image can be larger than 32 MB (IMGRAM64=1)”.
Once you have done a build, you can modify the build options, or the BSP code, and need not recompile the entire
Windows Embedded CE space. You can rebuild just the BSP by going into the Solution Explorer, expand your solu-
tion name, and the top of the Windows Embedded CE tree, expand PLATFORM, and you will see “MIPS_MALTA”.
If you right-click on MIPS_MALTA, you can do a build (or re-build) just from there, for a great savings of time. Note
this will not work if you have not already completed a build, or if you have changed anything outside the scope of the
BSP.

MIPS® MaltaTM Developer’s Kit - Getting Started with Windows® Embedded CE, Revision 6.03 10
Copyright © 2007, 2009 MIPS Technologies Inc. All rights reserved.
4 Target Software Setup
4.1 Installing the Windows Embedded CE Boot loader
After the MIPS Malta BSP has been installed into Platform Builder, The Windows Embedded CE boot loader binary
files and a readme.txt file detailing the installation of the boot loader, is located in the following directory:
%_WINCEROOT%\PLATFORM\MIPS_MALTA\bin
This directory contains the boot loader images for the Target Malta board in Motorola S-record format, Yamon BIN
format and MIPS Malta 1284 Flash Download format. There are two types of BOOT images delivered with the MIPS
Malta BSP. One supports at least 32 MB of RAM, and the other supports at least 64 MB of RAM. Please choose the
appropriate image for your application.
The MIPS Malta boot loader for Windows Embedded CE 6.0 is not backwards-compatible with OS images built on
an older version of Windows CE.
4.1.1 Binary installation: BOOT_xxx.fl
The MIPS Malta Flash Download binary file, BOOT_xxx.fl, may be downloaded via the Parallel port to the Target
Malta board.
Before you begin, you must attach a Parallel port cable between the Target Malta board and the Host Development
PC. You should also have a serial cable attached between the Debug Serial port (TTY0) on the Target Malta board and
the Host Development PC, and your preferred terminal emulator connected directly to the COM port where the cable
is connected on the Host Development PC.
Having attached all cables to the Target Malta board, you should now power up the Malta board and a YAMON
prompt, like the example below, should be displayed in your terminal emulator.
YAMON ROM Monitor, Revision 02.13.
Copyright (c) 1999-2006 MIPS Technologies, Inc. - All Rights Reserved.
For a list of available commands, type ’help’.
Compilation time = Dec 7 2006 19:22:35
Board type/revision = 0x02 (Malta) / 0x00
Core board type/revision = 0x0a (Core24K) / 0x00
System controller/revision = MIPS SOC-it 101 OCP / 1.3 SDR-FW-2:1
FPGA revision = 0x0001
MAC address = 00.d0.a0.00.01.4e
Board S/N = 0000000086
PCI bus frequency = 33.33 MHz
Processor Company ID/options = 0x01 (MIPS Technologies, Inc.) / 0x00
Processor ID/revision = 0x93 (MIPS 24Kc) / 0x64
Endianness = Little
CPU/Bus frequency = 266 MHz / 133 MHz
Flash memory size = 4 MByte
SDRAM size = 128 MByte
First free SDRAM address = 0x800b7360