Aero-Flex GR-LEON4-ITX User Manual
GR-LEON4-ITX
Development Board
Quick Start Guide
AEROFLEX GAISLER AB
Rev. 0.2, 2010-06-16
2 GR-LEON4-ITX Development Board
Quick Start Guide
Information furnished by Aeroflex Gaisler AB is believed to be accurate and reliable.
However, no responsibility is assumed by Aeroflex Gaisler AB for its use, nor for any infringements
of patents or other rights of third parties which may result from its use.
No license is granted by implication or otherwise under any patent or patent rights of Aeroflex
Gaisler AB.
Aeroflex Gaisler AB tel +46 31 7758650
Kungsgatan 12 fax +46 31 421407
411 19 Göteborg sales@gaisler.com
Sweden www.aeroflex.com/gaisler
Copyright © 2010 Aeroflex Gaisler
All information is provided as is. There is no warranty that it is correct or suitable for any purpose,
neither implicit nor explicit.
© Aeroflex Gaisler AB June 2010, Rev. 0.2
3 GR-LEON4-ITX Development Board
Quick Start Guide
TABLE OF CONTENTS
1 INTRODUCTION...........................................................................................................6
1.1 Overview...................................................................................................................... 6
1.2 References................................................................................................................... 6
1.3 Abbreviations...............................................................................................................6
2 UNPACKING AND SETTING UP THE BOARD...........................................................7
2.1 Unpacking and initial setup..........................................................................................7
2.2 Running the bundled Linux system..............................................................................7
Overview...................................................................................................................... 7
Pre-requisites............................................................................................................... 7
Booting Linux...............................................................................................................8
2.3 Connecting with the GRMON debug monitor...............................................................8
Overview...................................................................................................................... 8
Pre-requisites............................................................................................................... 8
Connecting with the included JTAG adapter................................................................9
Connecting with a Xilinx USB JTAG adapter................................................................9
Connecting via the USB interface................................................................................9
Connecting via serial UART.........................................................................................9
Connecting via Ethernet............................................................................................... 9
Using GRMON...........................................................................................................10
3 LINUX SYSTEM USER GUIDE.................................................................................11
3.1 Overview.................................................................................................................... 11
3.2 Debian Operating System..........................................................................................11
3.3 Logging in to the system............................................................................................11
3.4 Shutting down the System..........................................................................................12
3.5 Graphical Interface (X Window System)....................................................................12
3.6 Network Interface....................................................................................................... 12
3.7 System Time Keeping................................................................................................ 13
3.8 Changing the Keyboard Layout.................................................................................. 13
4 GRMON AND THE GR-LEON4-ITX BOARD.............................................................14
4.1 First steps..................................................................................................................14
4.2 Running an application............................................................................................... 15
4.3 Initializing the DVI transmitter.....................................................................................16
4.4 Drawing images.........................................................................................................17
4.5 Interacting with the SPI boot PROM...........................................................................17
4.6 Interacting with I2C devices.......................................................................................19
4.7 Other interfaces and operations.................................................................................19
5 ADVANCED TOPICS..................................................................................................20
5.1 Building the Linux kernel............................................................................................20
Overview.................................................................................................................... 20
Downloading an image with GRMON.........................................................................21
5.2 Creating a boot PROM............................................................................................... 27
Overview.................................................................................................................... 27
MKPROM2................................................................................................................. 27
U-boot........................................................................................................................28
6 TROUBLESHOOTING AND FREQUENCY ASKED QUESTIONS..........................31
© Aeroflex Gaisler AB June 2010, Rev. 0.2
4 GR-LEON4-ITX Development Board
Quick Start Guide
6.1 General......................................................................................................................31
The performance of the system is less compared to what is advertised for LEON4. .31
I lost the contents of the USB Flash stick...................................................................31
How do I restore the original PROM contents?..........................................................31
GRMON reports a system frequency of 100 MHz, should it not be 200 MHz?...........31
6.2 Interfaces...................................................................................................................31
Software freezes when initializing the Ethernet Interface...........................................31
I have problem X when using the USB Debug Communication Link..........................31
The system freezes when using it together with my PCI device.................................31
I2C communication does not work.............................................................................32
My USB disk is not detected / does not work.............................................................32
How do I change the Ethernet Debug Link IP address in the delivered system?.......32
6.3 Additional support......................................................................................................32
© Aeroflex Gaisler AB June 2010, Rev. 0.2
5 GR-LEON4-ITX Development Board
Quick Start Guide
LIST OF TABLES
Table 3-1: System accounts.......................................................................................................... 12
Table 4-1: GRMON DVI transmitter initialization...........................................................................16
Table 5-1: SnapGear template configurations............................................................................... 20
LIST OF FIGURES
Figure 2-1: GR-LEON4-ITX Development Board.............................................................................7
Figure 2-2: User JTAG headers.......................................................................................................8
Figure 2-3: Setting the EDCL IP address.........................................................................................9
Figure 2-4: GRMON after connect.................................................................................................10
Figure 5-1: Selecting a SnapGear template configuration..............................................................21
REVISION HISTORY
Revision Date Page Description
0.1 2010-03-17 All New document
0.2 2010-06-16 29, 30, 32 Fixed minor errors and omissions in U-boot image creation. Added
information on how to change the EDCL IP address used by U-boot.
© Aeroflex Gaisler AB June 2010, Rev. 0.2
6 GR-LEON4-ITX Development Board
Quick Start Guide
1 INTRODUCTION
1.1 Overview
This document is a quick start guide for the GR-LEON4-ITX Development Board.
The purpose of this document is to get users quickly started using the board. For a complete
description of the board please refer to the GR-LEON4-ITX Development Board User
Manual, the LEON4 system-on-chip is described in the LEON4-ASIC-DEMO Data sheet and
User's Manual. This quick start guide does not contain as much technical details and is
instead how-to oriented. However, to make the most of the guide the user should have
glanced through the two aforementioned documents and should ideally also be familiar with
the GRMON debug monitor.
The GR-LEON4-ITX data package and this document (including possibly newer revisions)
are available from the GR-LEON4-ITX product page at http://www.gaisler.com
1.2 References
RD-1 LEON4-ASIC-DEMO Data sheet and User's Manual, Aeroflex Gaisler, 2010
RD-2 GR-LEON4-ITX Development Board User Manual, Aeroflex Gaisler, 2010
RD-3 GRMON User Manual
RD-4 SnapGear Linux for LEON
The referenced documents can be downloaded from http://www.gaisler.com or be found on
the USB Flash stick accompanying the board.
1.3 Abbreviations
ASIC Application Specific Integrated Circuit.
DIL Dual In-Line
DDR Double Data Rate
DSU Debug Support Unit
GPIO General Purpose Input / Output
I/O Input/Output
I2C IIC, Inter integrated circuit, a 2 wire bus
IP Intellectual Property
MUX Multiplexer
PCB Printed Circuit Board
RMII Reduced Media Independent Interface
SOC System On a Chip
SPI Serial Peripheral Interface
© Aeroflex Gaisler AB June 2010, Rev. 0.2
7 GR-LEON4-ITX Development Board
2 UNPACKING AND SETTING UP THE BOARD
2.1 Unpacking and initial setup
The board is delivered with a power supply, JTAG adapter, USB and Ethernet cables.
Quick Start Guide
Figure 2-1: GR-LEON4-ITX Development Board
After unpacking the board, two routes can be taken. Either the preprogrammed Linux system
can be booted, or you can connect to the board using the GRMON debug monitor. If you
wish to start the bundled Linux system, please proceed to section 2.2 , to work with the
board through the GRMON debug monitor skip to section 2.3 .
2.2 Running the bundled Linux system
Overview
The GR-LEON4-ITX board's SPI boot PROM has been programmed with boot loader that
loads an image of the Linux kernel into main memory and then boots the kernel. The Linux
kernel then mounts its root file system, containing initialization scripts and software, from a
USB Flash stick. The Linux console is available both over the DVI video interface and over
the serial terminal.
Pre-requisites
The Linux kernel mounts the root filesystem from the USB stick included in the delivery.
Therefore the USB stick must be attached to the board. As previously stated, the Linux
console is available both over the video interface and over the serial terminal. As the board
© Aeroflex Gaisler AB June 2010, Rev. 0.2
8 GR-LEON4-ITX Development Board
Quick Start Guide
only provides PIN headers with the receive and transmit lines for the serial terminal it is
recommended that a monitor, keyboard and mouse is attached to the board. According the
normal conventions for the PS/2 interface, the top connector (green) is the Mouse interface
and the bottom connector (purple) is the Keyboard interface. If using a USB keyboard and
mouse the devices should be connected via a USB hub and the USB memory stick should
be directly connected to one of the board's USB ports.
The connected monitor must support DVI-A output, the board can also be connected to a
monitor using a DVI-to-VGA adapter.
It is recommended, but not required, to connect the board to a Ethernet network where it can
receive an IP address via DHCP and access the Internet. This will allow system software to
automatically set the system date and time. If an Ethernet cable is attached it should be
connected to the first Ethernet port (the lower port).
Booting Linux
The bootloader will start Linux when the power adapter is attached to the board. Please skip
to section 3 for usage instructions. Section 5.1 contains transcripts of the output that should
be shown on the monitor during the boot process.
2.3 Connecting with the GRMON debug monitor
Overview
GRMON is a competent debug monitor that is used to debug GRLIB/LEON systems. The
GR-LEON4-ITX board has a number of debug interfaces that are all supported by GRMON.
Note: If you intend to use GRMON to work with the board it is recommended to clear the SPI
boot PROM as described in section 4.5 .
Pre-requisites
The board is delivered with a JTAG adapter that can be used to connect to the board. For a
description of how to set up the JTAG device, or for other JTAG adapters please see the
GRMON User's Manual. The documentation and a evaluation version of GRMON is
available from http://www.gaisler.com. Unless you will be loading software that will use the
USB Flash stick, it is recommended to not connect the USB Flash stick to the board.
Figure 2-2: User JTAG headers
© Aeroflex Gaisler AB June 2010, Rev. 0.2
9 GR-LEON4-ITX Development Board
Quick Start Guide
Connecting with the included JTAG adapter
The JTAG adapter shall be connected to the board using the JTAG pin header shown in the
middle bottom of Figure 2-2. Please ensure that the JTAG cable/adapter is connected with
the correct polarity, to prevent unintended damage to the board or cable.
To connect to the board using the JTAG adapter delivered with the board, issue the
command:
grmon -jtag
Connecting with a Xilinx USB JTAG adapter
The JTAG adapter shall be connected to the board using the JTAG pin header, or ribbon
connector, shown in the middle bottom of Figure 2-2. Please ensure that the JTAG
cable/adapter is connected with the correct polarity, to prevent unintended damage to the
board or cable.
To connect to the board using a Xilinx USB adapter, issue the command:
grmon -xilusb
Connecting via the USB interface
Please see the GRMON User's Manual for how to set up the required USB driver software.
Then connect to the board using the command:
grmon -usb
Connecting via serial UART
Please refer to the GR-LEON4-ITX Development Board User Manual and the GRMON
User's Manual for instructions on how to connect via the serial debug interface.
Connecting via Ethernet
Before connecting via Ethernet the host computer (the computer running GRMON) must be
connected to the same network as the GR-LEON4-ITX board. After that the IP address of
the Ethernet Debug Communication Link (EDCL) must be set up. This address can be set up
either by PROM software or by using another debug link. After connecting with an alternate
debug link, issue the command edcl <ip address>. Figure 2-3 below shows a session where
an IP address is set and the expected output:
Figure 2-3: Setting the EDCL IP address
After the EDCL IP address has been set, connect to the target with
grmon -eth -ip <ip address>
In the example above, the command would be: grmon -eth -ip 192.168.0.54
© Aeroflex Gaisler AB June 2010, Rev. 0.2
10 GR-LEON4-ITX Development Board
Quick Start Guide
Using GRMON
The GRMON User's Manual describes the capabilities of GRMON. Section 4 of this
document describes some usage scenarios for GRMON on the GR-LEON4-ITX board.
Figure 2-4: GRMON after connect
© Aeroflex Gaisler AB June 2010, Rev. 0.2
Loading...