Integrator/PP1 and PP2: Getting Started Guide
Integrator/PP1 and PP2: Getting Started Guide
Proprietary Notice
Words and logos marked with ® or ™ are registered trademarks or trademarks owned by ARM Limited, 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 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
Web Address
http://www.arm.com
This device is test equipment and consequently is exempt from part 15 of the FCC Rules under section 15.103
(c).
CE Declaration of Conformity
The Integrator generates, uses, and can radiate radio frequency energy and may cause harmful interference to
radio communications. However, there is no guarantee that interference will not occur in a particular
installation. If this equipment causes harmful interference to radio or television reception, which can be
determined by turning the equipment off or on, you are encouraged to try to correct the interference by one
or more of the following measures:
• ensure attached cables do not lie across the card
• reorient the receiving antenna
• increase the distance between the equipment and the receiver
• connect the equipment into an outlet on a circuit different from that to which the receiver is connected
• consult the dealer or an experienced radio/TV technician for help
Note
It is recommended that wherever possible Shielded interface cables be used.
Preface
About this book ............................................................................................ viii
Support and feedback .................................................................................... xi
This preface introduces the Integrator/PP1 and PP2 and their user documentation. It
contains the following sections:
• About this book on page viii
• Support and feedback on page xi.
Intended audience
This book is written for all developers who are using the ARM Integrator/PP1 and PP2.
Typographical conventions
monospace bold Denotes language keywords when used outside example code.
Further reading
This section lists publications that provide additional information on the Integrator
boards used in the system and tools for developing code for the ARM family of
processors.
ARM publications
The following publication provide information about ARM PrimeCell devices used to
control the interfaces described in this manual:
• ARM PrimeCell UART (PL011) Technical Reference Manual (ARM DDI 0183)
• ARM PrimeCell Synchronous Serial Port Master and Slave (PL022) Technical
Reference Manual (ARM DDI 0171)
• ARM PrimeCell RTC (PL030) Technical Reference Manual (ARM DDI 0140)
• ARM PrimeCell KMI (PL050) Technical Reference Manual (ARM DDI 0143).
• ARM PrimeCell Advanced Audio CODEC Interface (PL041) Technical
Reference Manual (ARM DDI 0173).
• ARM PrimeCell GPIO (PL061) Technical Reference Manual (ARM DDI 0187)
• ARM PrimeCell Color LCD Controller (PL110) Technical Reference Manual
(ARM DDI 0161)
• ARM PrimeCell Smartcard Interface (PL130) Technical Reference Manual
(ARM DDI 0148)
• ARM PrimeCell Vectored Interrupt Controller (PL190) Technical Reference
Manual (ARM DDI 0181)
The following publication provides information about the ARM Firmware Suite:
• ARM Firmware Suite Reference Guide (ARM DUI 0102)
The following publications provide information about the ARM Developer Suite:
• Getting Started (ARM DUI 0064)
• ADS Tools Guide (ARM DUI 0067)
• ADS Debuggers Guide (ARM DUI 0066)
• ADS Debug Target Guide (ARM DUI 0058)
• ADS Developer Guide (ARM DUI 0056)
• ADS CodeWarrior IDE Guide (ARM DUI 0065).
If you have any problems with these systems, please contact your supplier. To help us
provide you with a rapid response, please give:
• details of the release you are using
• details of 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 number and date of any tools.
If you have problems with the operating system, refer to the operating system vendor.
If you have any comments on this book, please send email to [email protected] giving:
• the document title
• the document number
• the page number(s) to which your comments apply
• a concise explanation of your comments.
The Integrator/PP1 and PP2 porting platforms provide you with a reference platform
that allows you to develop applications on a system that closely models your end
product. The systems are based on standard Integrator modules. This chapter introduces
the Integrator/PP1 and PP2. It contains the following sections:
• Unpacking the Integrator/PP1 on page 1-2
• Unpacking the Integrator/PP2 on page 1-3
• Setting up the Integrator/PP1 on page 1-4
• Setting up the Integrator/PP2 on page 1-5
• Loading and starting an operating system on page 1-8
• About PPFU on page 1-11.
User Guides
ADS
System unit AFS
(Evaluation version)
User Guides
ADS
(Evaluation version) AFS
4
3
2
OFF
1
System unit
Power inlet
Multi-ICE
Terminal
Ethernet
VGA
System unit
3. Connect power and operate the power switch on the rear of the system unit.
The system powers-up and the Porting Platform Flash Utility (PPFU) starts. You
now need to load your operating system as described in Loading and starting an
operating system on page 1-8.
Reset switch
(green)
Integrator power ON
switch (red)
Power inlet
AC power ON/OFF
switch
O
I
VGA
System unit
Figure 1-5 on page 1-6 shows the locations of the connectors and switches on the right
side of the system unit.
Ethernet
Console
Multi-ICE
Mouse
Keyboard
System unit
1. Connect the system components as shown in Figure 1-4 on page 1-5 and
Figure 1-5:
• The keyboard and mouse to the mini-DIN connectors on the AP.
• A terminal, or PC running a terminal emulator, to the 9-pin D-type
connector on the AP using the using null-modem serial cable supplied.
• Your Multi-ICE unit, if required, to the Multi-ICE connector on the core
module, as shown in Figure 1-5.
3. Connect power to the power connector on the PSU, operate the AC power switch
on the PSU and then the Integrator power ON switch on the left side of the system
unit, as shown in Figure 1-4 on page 1-5.
The system powers-up and the Porting Platform Flash Utility (PPFU) starts. You
now need to load your operating system as described in Loading and starting an
operating system on page 1-8.
1.5.1 Prerequisites
• Connect the porting platform to a TFTP server using a LAN connection. Software
is available from third-party vendors over the Internet to enable you to use a PC
as a TFTP server.
• Connect a serial terminal to the Integrator/AP, as shown in Figure 1-3 on page 1-4
or Figure 1-4 on page 1-5. The terminal requires the following settings:
— 38400 baud
— no parity
— 8 bits data
— 1 stop bit
— Xon/Xoff software handshaking.
2. Set the IP address of the porting platform using one of the following:
• If you have a DHCP server available, then:
1. Enter the command dhcpc start. This requests an IP address from the
DHCP server.
2. Check the IP address that you have been assigned using the command
ifconfig.
• If you do not have a DHCP server, then set the IP address and netmask for
the porting platform using the command ifconfig (see ifconfig on
page 1-13).
Consult your system administrator if you need help with any of these steps.
5. Program the image into flash with the command: program imageNo image_name,
where:
imageNo is the number that you allocate to the image.
image_name is the name of the image.
1. At the PPFU prompt list the images in flash by entering the list command. For
example:
>list
Listing images in Flash
Image 667 Blocks [ 1, 1] address 0x24020000 exec 0x500000 - name milo
Image 66 Blocks [ 2, 3] address 0x24040000 exec 0x2e6e4 - name PPFU
Image 666 Blocks [ 4, 19] address 0x24080000 exec 0x24080000 - name kernel
Image 777 Blocks [ 50, 75] address 0x24640000 exec 0x24640000 - name cramfs
Image 11 Blocks [ 76, 167] address 0x24980000 exec 0x24980000 - name OS
SIB at Block 255 End Block 255 address 0x25fe0000
2. Set the new boot image using the setbootimage command. In this example, the
operating system is image number 11, so that the command to set this as the boot
image is:
>setbootimage 11 0xfff00 0x100000
setting image 11 in SIB,
copy at 0xfff00 and run it from 0x100000
A System Image Block (SIB) is created for this image.
After power up or reset, the porting platform can boot the standard boot monitor, PPFU,
or any other selected image. Boot image selection is controlled by the setting of the DIP
switches.
If the boot monitor or another image is booted instead of the PPFU when you power up:
• check that the switches on the motherboard a re set with S1[1] to ON and S1[4]
to OFF and reset the system.
• if the switch settings are correct select PPFU as the boot image as described in
Selecting PPFU as the default boot image using the boot monitor.
For information about the DIP switches on the Integrator/AP board, see the
Integrator/AP User Guide
1.6.2 Selecting PPFU as the default boot image using the boot monitor
1. Check the contents of the flash using the v command. For example:
boot Monitor> v
There are 256 128KByte blocks of Application Flash:
Images found
============
Block Size ImageNo Name Compress
----- ---- ------- ---- --------
0 1 1 zygote (0x24000000-0x2401FFEC)
1 2 66 PPFU (0x24020000-0x2405FFEC)
32 88 2 OS (0x24400000-0x24EFFFEC)
2. Change the default boot image using the bi command. For example:
boot Monitor> bi 66
This section provides a description of the PPFU commands. To list the available
commands, use the command help. For example:
>help
Supported commands:
help ver netstat ifconfig
arp route ping dhcpc
lsmod tftpread tftpsizeof list
identify testBlock delete deleteAll
deleteBlock program setbootimage
>
To display the syntax for a command, use the command help command.
ver
netstat
netstat [-a|m]
ifconfig
The ifconfig command is used to assign a static IP address (if there is no DHCP server,
for example). It can also be used also view the network interface setting. For example:
> ifconfig
Network Interfaces
eth0 Ethernet HWaddr:00D0B7-A0A112
Addr:172.16.11.90 SubNet:172.16.0.0 Bcast:172.16.255.255
UP BROADCAST RUNNING MULTICAST MTU:1500
RX Pkts:37399 Mcast:37399 Bytes:2419164 Errs:0 Drops:1522 NoProto:1422
TX Pkts:2 Mcast:0 Bytes:618 Errs:0 Drops:0
Driver:i82559intAP Irq:14 IOBase:0x4800 Mem:0x44080000
Multicast Filter
:
arp
-s hostname hw_addrs
adds a static entry
route
ping
ping addr
Send ICMP ECHO_REQUEST packets to a network host with the following argument:
For example:
> ping 192.16.100.93
32 bytes from 192.16.100.93: icmp_seq=0 ttl=128 time=4 ms
32 bytes from 192.16.100.93: icmp_seq=1 ttl=128 time=3 ms
32 bytes from 192.16.100.93: icmp_seq=2 ttl=128 time=3 ms
32 bytes from 192.16.100.93: icmp_seq=3 ttl=128 time=3 ms
>
dhcpc
Where:
start starts the DHCP client and obtains an IP address from the DHCP server.
release stops the DHCP client and allows the DHCP server to reallocate the IP
address.
ifname Network interface name, for example, eth0.
IP_Addr IP address of DHCP server to send DHCPINFORM to
lsmod
lsmod
tftpread
Use this command to retrieve a file from a specific machine running a TFTP server. The
value of the size parameter is higher or equal to the size of the file to download. The
tftpread command returns when the file has been downloaded and the file is present in
the target memory.
tftpsizeof
tftpsizeof
list
list
For example:
>list
Listing images in Flash
Image 667 Blocks [ 1, 1] address 0x24020000 exec 0x500000 - name milo
Image 66 Blocks [ 2, 3] address 0x24040000 exec 0x2ee18 - name loader
Image 666 Blocks [30, 44] address 0x243c0000 exec 0x243c0000 - name kernel
Image 777 Blocks [50, 75] address 0x24640000 exec 0x24640000 - name cramfs
SIB at Block 255 End Block 255 address 0x25fe0000
identify
identify
For example:
> identify
Current Active device is:
Flash (Intel 28F320S3) at address 0x24000000 : size 0x2000000
testBlock
testBlock Bblock_number
Use this command to write a test pattern to a particular flash block. You cannot write a
test pattern to the boot SIB.
delete
Use this command to delete an image in Flash. The logical image number is passed as
argument.
deleteAll
deleteAll
deleteBlock
deleteBlock Bblock_number
program
Use this command to program the an image into flash at by specifying an address
0xhex_addr or block number.
This is used to program the image loaded in memory via tftpread into flash. For
example:
setbootimage
Use this command to create and write a System Information Block (SIB) at the end of
the flash to store information for a binary image to boot (for example, an image that
could not be loaded by boot monitor). The parameters are:
The SIB containing this information can be removed using the deleteBlock command,
specifying the block number corresponding to that SIB.
Note
If, by error, the wrong SIB is removed (for example, the one used by boot monitor
containing the default boot image), it can be recreated using bi command at the boot
monitor prompt to set the default image to boot. See Setting a new default boot image
on page 1-10.
This chapter describes how to set up and start using the PP1 and PP2. It contains the
following sections.
• System architecture on page 2-2
• About the Integrator modules on page 2-4.
SDRAM (DIMM)
Multi-ICE
Integrator/CM
HDRA/HDRB
EXPA/EXPB HDRA/HDRB
FPGA BootROM
VGA card PCI expansion slot
PCI-Host
PCI expansion slot bridge Flash
DIP
LEDs
switches SRAM
PCI-PCI
bridge
Touch-
Audio Card VGA
screen
input/output interfaces interface
interface
Integrator/IM-PD1
EXPIM EXPA/EXPB SDRAM (DIMM)
Integrator/LM-XCV200E Integrator/CM
EXPA/EXPB HDRA/HDRB
EXPA/EXPB HDRA/HDRB
FPGA BootROM
PCI expansion slot
PCI-Host
PCI expansion slot bridge Flash
DIP
LEDs
switches SRAM
PCI-PCI
bridge
2.2.1 Integrator/AP