GR-LEON4-ITX Development Board Quick Start Guide AEROFLEX GAISLER AB Rev. 0.
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.
GR-LEON4-ITX Development Board Quick Start Guide TABLE OF CONTENTS 1 INTRODUCTION........................................................................................................ 6 1.1 1.2 1.3 2 UNPACKING AND SETTING UP THE BOARD.........................................................7 2.1 2.2 2.3 3 First steps......................................................................................................................15 Running an application.......................................
6.1 6.2 6.3 GR-LEON4-ITX Development Board Quick Start Guide General..........................................................................................................................32 The performance of the system is less compared to what is advertised for LEON4...32 I lost the contents of the USB Flash stick.....................................................................32 How do I restore the original PROM contents?............................................................
GR-LEON4-ITX Development Board Quick Start Guide LIST OF TABLES Table 3-1: System accounts..............................................................................................................13 Table 4-1: GRMON DVI transmitter initialization..............................................................................17 Table 5-1: SnapGear template configurations.................................................................................
1 GR-LEON4-ITX Development Board Quick Start Guide 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.
2 GR-LEON4-ITX Development Board Quick Start Guide 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. 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.
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.
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.
GR-LEON4-ITX Development Board Quick Start Guide grmon -eth -ip In the example above, the command would be: grmon -eth -ip 192.168.0.54 Figure 2-4: GRMON after connect © Aeroflex Gaisler AB March 2013, Rev. 0.
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. © Aeroflex Gaisler AB March 2013, Rev. 0.
3 GR-LEON4-ITX Development Board Quick Start Guide 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.
GR-LEON4-ITX Development Board Quick Start Guide 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: 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.
GR-LEON4-ITX Development Board Quick Start Guide 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 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.
4 GR-LEON4-ITX Development Board Quick Start Guide GRMON AND THE GR-LEON4-ITX BOARD 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 GRMON LEON debug monitor v1.1.
GR-LEON4-ITX Development Board Quick 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 Gaisler Research ahb master 0 LEON4 SPARC V8 Processor (ver 0x0) … some output removed... 02.
GR-LEON4-ITX Development Board Quick Start Guide GRMON 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.
GR-LEON4-ITX Development Board Quick 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/GRLIB design..
GR-LEON4-ITX Development Board Quick 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 Got manufacturer ID 0x20 and Device ID 0x2017 No device match for READ ID instruction, trying RES instruction..
GR-LEON4-ITX Development Board Quick Start Guide 4.6 Interacting with I2C devices The LEON4 ASIC device provides three I2C interfaces, two master interfaces (I2CM0 & I2CM1) 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 I2CM0 interface of the ASIC. The I2CM1 and I2CS interfaces of the ASIC are connected to 4 pin 0.1” headers on the board, to allow an external circuit to be hooked-up.
5 GR-LEON4-ITX Development Board Quick Start Guide ADVANCED TOPICS 5.1 Building the Linux kernel Overview NOTE: The Linux image programmed into the board SPI Flash boot PROM and the source code provided on the USB stick is for SnapGear Linux. This is an older Linux distribution that is no longer actively maintained by Aeroflex Gaisler.
GR-LEON4-ITX Development Board Quick Start Guide 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. Figure 5-1: Selecting a SnapGear template configuration Downloading an image with GRMON After the new image has been compiled it can be downloaded to the board using GRMON.
GR-LEON4-ITX Development Board Quick Start Guide DVI transmitter set to Chrontel CH7301C (AS=0) Initializing CH7301 for LEON/GRLIB design.. Initialization done.. grlib> After this we can load the Linux image: grlib> load images/image.dsu section: .stage2 at 0x40000000, size 10240 bytes section: .vmlinux at 0x40004000, size 2782144 bytes total size: 2792384 bytes (79.0 Mbit/s) read 6260 symbols entry point: 0x40000000 grlib> run Booting Linux Booting Linux...
GR-LEON4-ITX Development Board Quick Start Guide Attaching grlib apbuart serial drivers (clk:100hz): Console: colour dummy device 80x25 Dentry cache hash table entries: 32768 (order: 5, 131072 bytes) Inode-cache hash table entries: 16384 (order: 4, 65536 bytes) pkbase: 0xfc800000 pkend: 0xfcc00000 fixstart 0xfcfe4000 Memory: 252864k/262144k available (2120k kernel code, 9116k reserved, 292k data, 160k init, 65536k highmem) Mount-cache hash table entries: 512 Entering SMP Mode...
GR-LEON4-ITX Development Board Quick Start Guide hub 2-0:1.0: USB hub found hub 2-0:1.0: 2 ports detected Initializing USB Mass Storage driver... usb 1-2: new high speed USB device using grusbhc-ehci and address 2 usb 1-2: configuration #1 chosen from 1 choice scsi0 : SCSI emulation for USB Mass Storage devices usbcore: registered new interface driver usb-storage USB Mass Storage support registered. usbcore: registered new interface driver usbhid drivers/usb/input/hid-core.c: v2.
GR-LEON4-ITX Development Board Quick Start Guide /etc/rc2.d/S20gpm: line 65: /dev/input/mice: No such device . * Not starting internet superserver: no services enabled. Starting periodic command scheduler: crond. Debian GNU/Linux 4.0 gr-leon4-itx ttyS0 gr-leon4-itx login: user Password: Last login: Thu Jan 1 01:03:40 1970 on ttyS0 Linux gr-leon4-itx 2.6.21.
GR-LEON4-ITX Development Board Quick Start Guide Brought up 2 CPUs Total of 2 processors activated (399.36 BogoMIPS). migration_cost=10000 NET: Registered protocol family 16 Found GRPCI controller - ahb mem,io: 0x80000000, 0xfff20000 - apb 0xc0100800 - irq: 25 Assigning PCI BARs.
starting pid 22, tty '': '/etc/init.d/rcS' starting pid 33, tty '': '/bin/sh' / # echo "hello world" hello world / # ls bin etc init linuxrc proc dev home lib mnt sbin / # GR-LEON4-ITX Development Board Quick Start Guide sys tmp usr var Note that the last configuration does not mount the root filesystem from the USB stick. 5.2 Creating a boot PROM Overview Creating a boot PROM allows the system to boot software after power-up without the need to connect with GRMON.
GR-LEON4-ITX Development Board Quick Start Guide After this we can create an image using the SnapGear Linux kernel as input: jan@jan:~/Linux$ /opt/mkprom2/mkprom2 -v -freq 100 -stack 0x4ffffff0 -pnp 0xffeff800 -irqmp 0xc0800100 -dsustart 0xd0000000 -dsutrace -bdinit -nomsg snapgear-2.6p41/images/image.dsu LEON2/3/ERC32 MKPROM prom builder for BCC, ECOS, RTEMS and ThreadX v2.0.25 Copyright Gaisler Research 2004-2007, all rights reserved.
GR-LEON4-ITX Development Board Quick Start Guide read 131 symbols entry point: 0x00000000 The flash contents can now also be verified, either by spim flash verify prom.out or by the faster verify prom.out: grlib> verify prom.out section: .text at 0x0, size 1575824 bytes section: .data at 0x180b90, size 32 bytes total size: 1575856 bytes (12.0 Mbit/s) entry point: 0x00000000 grlib> The PROM has now been successfully programmed.
GR-LEON4-ITX Development Board Quick Start Guide Next we need to build a Linux kernel image that U-boot can handle. U-Boot needs a header to know how to interpret the binary images. The images support compression and CRC verifying. To create an image, the mkimage tool must be in the system path. The Linux kernel has a prepared build target for generating u-boot images (uImage): jan@jan:~/Linux/snapgear-2.6-p41$ cd linux-2.6.21.1/ jan@jan:~/Linux/snapgear-2.6-p41/linux-2.6.21.
6 GR-LEON4-ITX Development Board Quick Start Guide TROUBLESHOOTING AND FREQUENCY ASKED QUESTIONS 6.1 General The performance of the system is less compared to what is advertised for LEON4 The advertised LEON4 performance figures typically come from systems that include a Level-2 cache core. The GR-LEON4-ITX board and LEON4-ASIC-DEMO device were constructed using a pre-release version of the LEON4 processor and the L2 cache core was not available at this time.
GR-LEON4-ITX Development Board Quick Start Guide There is no known workaround for this issue and the LEON4-ASIC-DEMO device cannot be used in a system where it will be accessed by a master performing bursts over eight words in length. I2C communication does not work Please make sure that the bus has pull-ups (see the GR-LEON4-ITX Board User Manual for how to enable pull-ups). My USB disk is not detected / does not work The board may not be able to provide enough power for drives connected via USB.
