Aeroflex GR-LEON4-ITX User manual

GR-LEON4-ITX
Development Board
Quick Start Guide
EROFLEX G ISLER B
Rev. 0.2, 2010-06-16

2 GR-LEON4-ITX Development Board
uick 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 [phone]
Kungsgatan 12 fax [phone]
411 19 Göteborg [email protected]
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
uick Start Guide
T BLE OF CONTENTS
1 INTRODUCTION...........................................................................................................6
1.1 Overview......................................................................................................................6
1.2 References...................................................................................................................6
1.3 Abbreviations...............................................................................................................6
2 UNP CKING ND SETTING UP THE BO RD...........................................................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 ND THE GR-LEON4-ITX BO RD.............................................................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 DV NCED 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 ND FREQUENCY SKED QUESTIONS..........................31
© Aeroflex Gaisler AB June 2010, Rev. 0.2

4 GR-LEON4-ITX Development Board
uick 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
uick Start Guide
LIST OF T BLES
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
uick 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-ASI -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 bbreviations
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
uick Start Guide
2 UNP CKING ND SETTING UP THE BO RD
2.1 Unpacking and initial setup
The board is delivered with a power supply, JTAG adapter, USB and Ethernet cables.
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
Figure 2-1: GR-LEON4-ITX Development Board

8 GR-LEON4-ITX Development Board
uick 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.
© Aeroflex Gaisler AB June 2010, Rev. 0.2
Figure 2-2: User JTAG headers

9 GR-LEON4-ITX Development Board
uick Start Guide
Connecting with the included JT G 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 JT G 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 U RT
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:
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
Figure 2-3: Setting the EDCL IP address

10 GR-LEON4-ITX Development Board
uick 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.
© Aeroflex Gaisler AB June 2010, Rev. 0.2
Figure 2-4: GRMON after connect

11 GR-LEON4-ITX Development Board
uick Start Guide
3 LINUX SYSTEM USER GUIDE
3.1 Overview
When the system is powered on the processor will load the Linux kernel from flash into main
memory. The kernel will then mount a Debian root file system system from the USB Flash
stick.
The sections below describe the system and the available user interfaces. The reader is
encouraged to read the full documentation before using the system for the first time.
3.2 Debian Operating System
The USB Flash stick contains an installation of Debian 4.0 (Etch). Debian is a well-known
GNU/Linux distribution which comes with extensive documentation and a large set of
precompiled applications. A good starting point for Debian documentation is
http://www.debian.org/doc/
Precompiled applications can easily be added using Debian's package management system.
To search for an application the command apt-cache can be used. To search for the
application `less', issue the command:
apt-cache search less
The output will show a large amount of packages, in this case the package we searched for
is simply named less:
less - Pager program similar to more
To install this application we now issue (to install applications you must be logged in as the
super-user):
apt-get install less
This will fetch the application from a public repository specified in the file /etc/apt/sources.list,
which at delivery is specified to a public repository that can be accessed over the Internet.
More documentation about the package management system is available at the Debian
website mentioned above.
3.3 Logging in to the system
There are three ways of logging in to the system,
• Serial terminal connected to the RS232 port (or GRMON with -u flag)
• Keyboard, mouse and computer screen directly attached the system
The recommended interface for system interaction is to attach a keyboard, a mouse and a
computer monitor and use the command line interface. This setup will be no different from
working with a normal Linux desktop system.
The serial terminal provides an alternative way of access. To access the system via the
serial port the terminal emulator should be configured for 38400 8N1. The system boot
messages will be displayed on the frame buffer device. The serial terminal will display a login
prompt when the system has completed its boot process.
The system has two accounts for login:
© Aeroflex Gaisler AB June 2010, Rev. 0.2

12 GR-LEON4-ITX Development Board
uick Start Guide
Username Password Description
user user Normal user account.
root root Super-user account. Should only be used for system administration.
Table 3-1: System accounts
3.4 Shutting down the System
To protect the integrity of the file system, the system software should be properly shut down
before powering down the board. The correctly shut down the system, issue the command:
shutdown -h now
This command must be issued as the super-user (root). After the system has reported that is
going down for system halt there will be no more output on the serial terminal. The system
will report Halt on the frame buffer console when it is safe to power-off the board. If an
external screen is not connected, it can be assumed safe to power-off the system 90
seconds after the The system is going down for system halt NOW! message has been
displayed on the serial terminal.
3.5 Graphical Interface (X Window System)
The X window system graphical interface can be started from the command line by using the
command startx. This will launch a session using the BlackBox window manager, right-click
on the mouse will bring up the menu.
Other window managers can be started by editing the .xsession file in the home directory
(for the user account, /home/user/.xsession). If the file is changed to exec fvwm2, startx will
launch an X session using the FVWM window manager (http://www.fvwm.org).
The graphical interface has a menu option to shut down the system, but this is not supported
by the hardware. Instead, X should be exited back to the shell before the system is shut
down.
The X window system may show some instabilities, particularly when exiting the graphical
interface. If this leads to the system being inaccessible from the keyboard and mouse it is
typically still possible to connect to the system via another interface, such as the serial
terminal or network.
3.6 Network Interface
The network interface is configured during system start-up with the information contained in
the file /etc/network/interfaces. The default content of this file is:
# The loopback network interface
auto lo
iface lo inet loopback
# The primary network interface
auto eth0
iface eth0 inet dhcp
To assign a static IP address the file contents could be changed to, for instance:
# The loopback network interface
auto lo
iface lo inet loopback
# The primary network interface
© Aeroflex Gaisler AB June 2010, Rev. 0.2

13 GR-LEON4-ITX Development Board
uick Start Guide
auto eth0
iface eth0 inet static
address 192.168.0.58
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
It is recommended that the system is attached to a network which allows access to the
Internet.
3.7 System Time Keeping
System software that is currently delivered with the board does have support for reading out
the board's real time clock and is therefore not able to keep the system time after the system
has been shut down. To avoid problems, such as irregularities caused by file time stamps
being in the future, it is strongly recommended that the system time is set at each boot. If the
system is connected to a network this can be automated by configuring the software to set
the time from a Network Time Protocol (NTP) server.
The delivered system is configured to set the time from the NTP server ntp1.chalmers.se.
Another NTP server can be selected by editing the file /etc/default/ntpdate.
If the board cannot be connected to a network with an NTP server, the time can be set
manually with the commands:
date --set 2008-10-10
date --set 14:00:00
The commands must be run as the super-user (root) and this must be done each time the
system has been restarted, unless the system has access to an NTP server.
3.8 Changing the Keyboard Layout
The system is configured to use a keyboard with a US American layout. If a keyboard with
another layout is to be used the keymap should be changed. For the console keyboard
layout issue the command below as the super-user (root):
dpkg-reconfigure console-data
In the package configuration, choose Select keymap from full list. The keymap that should
be chosen is likely prefixed with “pc /”.The system is delivered with the setting:
pc / qwerty / US american / Standard / Standard
The keymap for the graphical X Window system will also need to be changed if a keyboard
with a non-american layout is connected. This can be done by editing the /etc/X11/xorg.conf
file and modifying the line:
Option “XkbLayout” “us”
To the layout choice corresponding to the new keyboard, for example by exchanging “us” to
“fr”.
© Aeroflex Gaisler AB June 2010, Rev. 0.2

14 GR-LEON4-ITX Development Board
uick Start Guide
4 GRMON ND THE GR-LEON4-ITX BO RD
4.1 First steps
The subsections below assume that GRMON, the host computer and the GR-LEON4-ITX
board have been set up so that GRMON can connect to the board. The transcripts with
courier font below are from a shell session invoking the command line version of GRMON.
The same commands can be used when the debugger is used with a GUI.
grmon -eth -ip 192.168.0.54
RMON LEON debug monitor v1.1.39 professional version
Copyright (C) 2004-2008 Aeroflex aisler - all rights reserved.
For latest updates, go to http://www.gaisler.com/
Comments or bug-reports to [email protected]
ethernet startup. Found AHB 1 to AHB 0 bridge
Device ID: : 0x102
RLIB build version: 3508
initialising ......................................
detected frequency: 100 MHz
Component Vendor
LEON4 SPARC V8 Processor aisler Research
LEON4 SPARC V8 Processor aisler Research
SV A Controller aisler Research
AHB-to-AHB Bridge aisler Research
AHB Debug UART aisler Research
AHB Debug JTA TAP aisler Research
R Ethernet MAC aisler Research
R Ethernet MAC aisler Research
USB EHCI controller aisler Research
USB UHCI controller aisler Research
R USB 2.0 Device Controller aisler Research
USB Debug Comm. Link aisler Research
aisler CAN with DMA aisler Research
Fast 32-bit PCI Bridge aisler Research
PCI/AHB DMA controller aisler Research
AHB-to-AHB Bridge aisler Research
LEON4 Debug Support Unit aisler Research
DDR2 Controller aisler Research
AHB/APB Bridge aisler Research
SPI Memory Controller aisler Research
AHB/APB Bridge aisler Research
AHB/APB Bridge aisler Research
Multi-processor Interrupt Ctrl aisler Research
eneric APB UART aisler Research
eneric APB UART aisler Research
Modular Timer Unit aisler Research
PS/2 interface aisler Research
PS/2 interface aisler Research
I2C slave aisler Research
AMBA Wrapper for OC I2C-master aisler Research
AMBA Wrapper for OC I2C-master aisler Research
AMBA Wrapper for OC I2C-master aisler Research
SPI Controller aisler Research
eneral purpose I/O port aisler Research
eneral purpose I/O port aisler Research
AHB status register aisler Research
PCI Arbiter European Space Agency
PCI trace buffer aisler Research
Use command 'info sys' to print a detailed report of attached cores
grlib>
At this point GRMON has successfully connected to the system. In this case we used the
© Aeroflex Gaisler AB June 2010, Rev. 0.2

15 GR-LEON4-ITX Development Board
uick Start Guide
Ethernet Debug Communications Link (EDCL). However any of the other debug links would
be fine. The first listing shows all cores available in the design. Giving the command info sys
prints a detailed report of the system. The output is too long to include here, however as a
sample with some most of the output cut out:
grlib> info sys
00.01:048 aisler Research LEON4 SPARC V8 Processor (ver 0x0)
ahb master 0
… some output removed...
02.01:01d aisler Research R Ethernet MAC (ver 0x0)
ahb master 2, irq 12
apb: c0100100 – c0100200
edcl ip 192.168.0.54, buffer 2 kbyte
… some output removed...
01.01:02e aisler Research DDR2 Controller (ver 0x0)
ahb: 40000000 – 80000000
ahb: ffe00100 – ffe00200
32-bit DDR2 : 1 * 256 Mbyte @ 0x40000000
200 MHz, col 10, ref 7.8 us, trfc 135 ns
… some output removed...
grlib>
The above shows a sample of the cores connected. In the sample we can see that the EDCL
IP address has been set and that the EDCL has 2 kbyte hardware buffer, we can also see
that GRMON has identified, and configured the DDR2 controller to use, 256 MiB of DDR2
SDRAM memory.
4.2 Running an application
In this example we will compile and run an application of our own. The procedure for
downloading other applications is the same as shown below.
In order to cross-compile a stand-alone C application the host computer must have the BCC
toolchain installed. The toolchain can be downloaded from http://www.gaisler.com and is
also included on the USB Flash stick (software/toolchains/B ).
Below is a transcript of a terminal with comments inserted:
Show contents of file hello.c:
user@host:~$ cat hello.c
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
return 0;
}
Compile and link application, place resulting machine code in file hello:
user@host:~$ sparc-elf-gcc -Wall hello.c -o hello
Connect with GRMON and load the application. Note that the flag -u is given to GRMON.
This flag places the first UART in debug mode which means that GRMON will echo the
characters written to the UART and the user does not need to attach a dedicated serial
terminal to the board. Without -u switch, no output would come from the program. Please
see the GRMON User's Manual for more information.
jan@jan:~$ grmon -eth -ip 192.168.0.54 -u
© Aeroflex Gaisler AB June 2010, Rev. 0.2

16 GR-LEON4-ITX Development Board
uick Start Guide
RMON LEON debug monitor v1.1.39 professional version
… output removed ….
Use command 'info sys' to print a detailed report of attached cores
Download application to RAM:
grlib> load hello
section: .text at 0x40000000, size 39584 bytes
section: .data at 0x40009aa0, size 2764 bytes
total size: 42348 bytes (70.4 Mbit/s)
read 201 symbols
entry point: 0x40000000
Run the application that was just downloaded:
grlib> run
Hello world
Program exited normally.
grlib>
After this the application can be downloaded and run again. Please also try commands such
as inst or hist after running an application and refer to the GRMON User's Manual for their
meaning.
4.3 Initializing the DVI transmitter
The DVI transmitter on the board must be initialized before it can pass video data from the
LEON4-ASIC-DEMO device to a monitor. There are several GRMON commands tailored for
initializing the DVI transmitter with values suitable for the GR-LEON4-ITX board.
Command Description
i2c 3 dvi init l4itx_dvi Initialize the DVI transmitter for IDF 2 input data (16-bit color depth) and
monitor connected via digital DVI.
i2c 3 dvi init l4itx_vga Initialize the DVI transmitter for IDF 2 input data (16-bit color depth) and
monitor connected via analog interface (or DVI-to-VGA adapter).
i2c 3 dvi init l4itx_dvi 0 Initialize the DVI transmitter for IDF 0 input data (24-bit color depth) and
monitor connected via digital DVI.
i2c 3 dvi init l4itx_vga 0 Initialize the DVI transmitter for IDF 0 input data (24-bit color depth) and
monitor connected via analog interface (or DVI-to-VGA adapter).
Table 4-1: GRMON DVI transmitter initialization
The transcript below shows the GRMON output:
grlib> i2c 3 dvi init_l4itx_dvi
Transmitter was not set to Chrontel CH7301C (AS=0), changing..
DVI transmitter set to Chrontel CH7301C (AS=0)
Initializing CH7301 for LEON/ RLIB design..
Initialization done..
grlib>
After initializing the transmitter, the command i2c 3 dvi showreg will show the values of the
DVI transmitter's registers.
© Aeroflex Gaisler AB June 2010, Rev. 0.2

17 GR-LEON4-ITX Development Board
uick Start Guide
4.4 Drawing images
GRMON has support for drawing both test screens and images in PPM ASCII format. The
transcript below show commands that draw the built-in test screen in different modes. Note
that the DVI transmitter must be initialized for the correct bit depth.
grlib> i2c 3 dvi init_l4itx_dvi
Transmitter was not set to Chrontel CH7301C (AS=0), changing..
DVI transmitter set to Chrontel CH7301C (AS=0)
Initializing CH7301 for LEON/ RLIB design..
Initialization done..
grlib> svga formats
Available SV ACTRL display formats:
Format Resolution, refresh rate
------ ------------------------
0 480x272,
1 480x240,
2 640x480, 60 Hz
3 640x480, 72 Hz
4 640x480, 75 Hz
5 640x480, 85 Hz
6 800x480,
7 800x600, 56 Hz
8 800x600, 60 Hz
9 800x600, 72 Hz
10 800x600, 75 Hz
11 800x600, 85 Hz
12 1024x768, 60 Hz
13 1024x768, 70 Hz
14 1024x768, 75 Hz
15 1024x768, 80 Hz
16 Custom format (undefined)
grlib> svga draw test_screen 2 16
Drawing picture = test_screen, Depth = 16 bits, Format = 640x480, 60 Hz
Framebuffer memory pos = 0x40200000
grlib> svga draw test_screen 8 16
Drawing picture = test_screen, Depth = 16 bits, Format = 800x600, 60 Hz
Framebuffer memory pos = 0x40200000
grlib> svga draw test_screen 12 16
Drawing picture = test_screen, Depth = 16 bits, Format = 1024x768, 60 Hz
Framebuffer memory pos = 0x40200000
grlib> i2c 3 dvi init_l4itx_dvi 0
Initializing CH7301 for LEON/ RLIB design..
Initialization done..
grlib> svga draw test_screen 8 32
Drawing picture = test_screen, Depth = 32 bits, Format = 800x600, 60 Hz
Framebuffer memory pos = 0x40200000
grlib>
The test screen consists of a framed white cross on black background.
4.5 Interacting with the SPI boot PROM
GRMON provides support for interacting with SPI memory devices via its SPI Flash layer.
SPI memory devices can be controlled both over SPICTRL and SPIMCTRL cores. In the
examples below we will use the SPI memory controller core (SPIMCTRL) since it is attached
© Aeroflex Gaisler AB June 2010, Rev. 0.2

18 GR-LEON4-ITX Development Board
uick Start Guide
to the SPI boot PROM on the GR-LEON4-ITX board. The first step in communicating with
the SPI memory device is to allow the SPI Flash layer to detect the device:
grlib> spim flash detect
ot manufacturer ID 0x20 and Device ID 0x2017
No device match for READ ID instruction, trying RES instruction..
Found matching device: ST/Numonyx M25P64
grlib>
Since the SPIMCTRL core maps the memory device into AMBA address space we can read
the memory device using GRMON's mem command:
grlib> mem 0
0 ffffffff ffffffff ffffffff ffffffff ................
10 ffffffff ffffffff ffffffff ffffffff ................
20 ffffffff ffffffff ffffffff ffffffff ................
30 ffffffff ffffffff ffffffff ffffffff ................
grlib>
In the read out above the device is empty. We can now try to load a file to the device. First
we give a shell command that lists the contents of the small S-REC file we will use for this
example (do not issue the shell cat command on large or non-text files)
grlib> shell cat ~/tests/test_seq4-small
S0030000FC
S315000000000000000004040404080808080C0C0C0C4A
S315000000101010101014141414181818181C1C1C1C3A
S315000000202020202024242424282828282C2C2C2C2A
S315000000303030303034343434383838383C3C3C3C1A
S315000000404040404044444444484848484C4C4C4C0A
S315000000505050505054545454585858585C5C5C5CFA
S315000000606060606064646464686868686C6C6C6CEA
S315000000707070707074747474787878787C7C7C7CDA
… and so on. We can now download this file to the memory device:
grlib> spim flash load ~/tests/test_seq4-small
section: at 0x0, size 256 bytes
entry point: 0x0
After downloading the file we can see that the contents has been written to the flash device:
grlib> mem 0
0 00000000 04040404 08080808 0c0c0c0c ................
10 10101010 14141414 18181818 1c1c1c1c ................
20 20202020 24242424 28282828 2c2c2c2c $$$$((((,,,,
30 30303030 34343434 38383838 3c3c3c3c 000044448888<<<<
grlib>
GRMON also has support for dumping the contents of the memory device into a S-REC file,
see the GRMON User's Manual for details.
Finally, we can erase the device, this should always be done before attempting to load data
into the memory. Erasing is quite slow and will take a little over sixty seconds:
grlib> spim flash erase
grlib> mem 0 4
0 ffffffff ffffffff ffffffff ffffffff ................
grlib>
When the device is erased, all bits will be set to '1'.
© Aeroflex Gaisler AB June 2010, Rev. 0.2

19 GR-LEON4-ITX Development Board
uick Start Guide
4.6 Interacting with I2C devices
The LEON4 ASI device provides three I2C interfaces, two master interfaces (I2 M0 &
I2 M1) and one slave interface (I2CS).
As a demonstration I2C circuit, an on-board DS1672 Real-Time Clock circuit is connected on
the board to the I2 M0 interface of the ASIC.
The I2 M1 and I2 S interfaces of the ASIC are connected to 4 pin 0.1” headers on the
board, to allow an external circuit to be hooked-up. If required, 10kOhm pull-up resistors on
the SCL and SDA signals can be installed if the appropriate jumpers JP9 and JP10 are
installed.
One way to interact with multiple I2C devices on the board is to connect one of the I2C
masters to the I2C slave. This can be done by attaching J18:1 to J17:1 and J18:3 to J17:3.
Pull-ups also need to be enabled (JP9:1-2,3-4 or JP10:1-2,3-4).
The following GRMON command will initialize the slave:
grlib> wmem 0xc0000600 0x50
grlib> wmem 0xc0000604 0x07
grlib> wmem 0xc0000614 0x99
The meaning of these write operations can be found by reading the I2C slave manual. The
connections made above connected I2CM1 to the slave. GRMON enumerates I2CM1 as I2C
core 2. To read data from the slave, issue:
grlib> i2c 2 read 0x50
Another way to interact with devices over I2C is to communicate with the DS1672 real time
clock (RTC). The RTC is connected to the bus if I2C M0, this master is enumerated as I2C
core 1 by GRMON. To detect any (7-bit addressable) devices on a bus the following
command can be used:
grlib> i2c 1 scan
Scanning 7-bit address space on I2C bus:
Detected I2C device at address 0x68
Scan of I2C bus completed. 1 device found
grlib>
The registers of the device can be read with:
grlib> i2c 1 read 0x68 0 5
00: ad a9 29 b1
04: 80
grlib>
The device can be written with:
grlib> i2c 1 write 0x68 0 0xab
grlib> i2c 1 read 0x68 0 5
00: ab a9 29 b1
04: 80
grlib>
Please see the GRMON User's Manual and the DS1672 data sheet for further details.
4.7 Other interfaces and operations
Please see the GRMON User's Manual for a description of the other debug drivers and
capabilities provided by GRMON.
© Aeroflex Gaisler AB June 2010, Rev. 0.2

20 GR-LEON4-ITX Development Board
uick Start Guide
5 DV NCED TOPICS
5.1 Building the Linux kernel
Overview
Aeroflex Gaisler provides a Linux distribution named SnapGear Linux. A release of
SnapGear Linux has been included on the first partition of the USB stick delivered with the
board (software/Linux contains the distribution and software/toolchains/Linux contains the
toolchain). SnapGear Linux can also be downloaded from http://www.gaisler.com
To be able to easily create a Linux configuration to run on the GR-LEON4-ITX board,
SnapGear Linux includes three template configurations that can be selected to quickly
compile a new Linux configuration:
Configuration name Description
gr_l4itx_video Main console is DVI video. Mounts root filesystem from second partition on
USB Flash stick.
gr_l4itx_serial No video support, main console is serial terminal. Mounts root filesystem
from second partition on USB Flash stick.
gr_l4itx_busybox No video support, main console is serial terminal. Root filesystem is a
memory image containing a Busybox system, does not mount USB Flash
stick.
Table 5-1: SnapGear template configurations
To be able to easily create a Linux configuration to run on the GR-LEON4-ITX board,
SnapGear Linux includes three template configurations that can be selected to quickly
compile a new Linux configuration.
First extract the SnapGear distribution:
jan@jan:~/Linux$ tar jxf snapgear-2.6-p41.tar.bz2
Enter the SnapGear directory and issue the command make xconfig. In the menu system
click Template onfigurations and select the wanted configuration in the new window, also
check the box below the selection, as shown in Figure 5-1.
After the selection has been made, click the Main Menu button and in the remaining window
click Save and Exit.
The configuration of the SnapGear system and Linux kernel have now been updated to
predefined values. The system can now be compiled by issuing make at the system prompt.
The updated configuration can also be tailored as for normal SnapGear configurations. For
further information on SnapGear please see the SnapGear Linux for LEON manual.
© Aeroflex Gaisler AB June 2010, Rev. 0.2