Attention: this is a copy of the GSRD User Manual. It has been modified to document how to use the Golden System Reference Design with the Arrow SoCKit.

Overview

The GSRD (Golden System Reference Design) provides a set of essential hardware and software system components that can be used as a starting point for various custom user designs.

The GSRD consists of:

• Arrow SoCKit Board
• Golden Hardware Reference Design (GHRD)
• Linux release
• Linux sample drivers
• Linux sample applications
• Web server running on target board

Release Notes

See Release Notes.

Release Contents

See Release Contents.

Release Location

The GSRD release is located at the link above under Release Contents.

Prerequisites

The following are required in order to be able to fully exercise the GSRD:

• Host PC running Linux (CentOS 6.3 or newer or Ubuntu 12.04LTS or newer preferred)
• Arrow SoCKit Board rev. B or later
• Altera SoC EDS v13.1 - available from http://www.altera.com/products/software/sfw-index.jsp
• Altera Quartus™ II v13.1 - available from http://www.altera.com/products/software/sfw-index.jsp

Default Paths

Throughout the documentation, the following default paths are assumed. Please update the commands accordingly if non-standard paths are used.

Default Path	Description
~/altera/13.1/embedded	SoC EDS installation path
~/altera/13.1/qprogrammer	Quartus II Programmer installation path
~/altera/13.1/quartus	Quartus II installation path
~/sockit_ghrd	Arrow SoCKit GHRD folder, extracted from sockit_ghrd_13.1.tar.gz

Getting Started Guides

• Booting Linux Using Prebuilt SD Card Image
• Connecting to Board Using SSH
• Running Sample Linux Applications
• Using Yocto Source Package
• Creating and Updating SD Card
• Compiling the Hardware Design
• Generating and Compiling the Preloader
• Generating the Device Tree
• FPGA Programming from HPS Software
• FPGA Programming with Quartus II Programmer
• Using System Console
• Using Git Trees
• Booting from QSPI Flash
• Booting from FPGA
• Programming QSPI Flash
• Customizing HPS Clocks in Preloader
• Preloader and U-Boot Customization

GHRD Overview

See GHRD Overview.

HPS Boot Flow

See HPS Boot Flow.

Development Flow Overview

The following picture presents a high level view of the development flow for projects based on the GSRD.

Detailed GSRD Build Flow

The following diagram illustrates the full build flow for the GSRD.

The following table presents the tools that are used in the build flow:

Tool	Description	Part of
Quartus II	Create, edit and compile FPGA hardware designs *	ACDS
Device Tree Generator	Generate Device Trees	SoC EDS
Device Tree Compiler	Converts between Device Tree file formats	^
Preloader Generator	Generates Preloader source code based on hardware handoff information	^
ARM DS-5 AE	Software Development Suite	^
Bitbake	Yocto build utility	Yocto Source Package
SD Card Script	Script that creates the SD card image	^

The following table presents the input files that are part of the build process:

File	Description
Quartus Project	FPGA Hardware Project source code
Board XML	File describing the development board, used in creating the Device Tree
Clocking XML	File describing the development board, used in creating the Device Tree
Yocto Source Package	Yocto recipes and necessary packages and tools for building Linux
Web Server Files	Additional files needed for the web server running on the board

The following table describes the rest of the items that are part of the build flow diagram:

File	Description
.sof	SRAM Object File - FPGA programming file, resulted from compiling the FPGA hardware project
.rbf	Raw Binary File - Compressed FPGA programing file
.dts	Device Tree Source - used to describe the hardware for the Linux kernel
.dtb	Device Tree Binary - binary representation of the .dts
.sopcinfo	SOPC Info File - containing a description of the hardware to be used by Device Tree Generator
.svd	System View Description File - describes the hardware for the DS-5 debugger
Handoff	Folder containing a description of the hardware to be used by the Preloader Generator

Not all the people involved in a project need to deal with the full flow. For example:

• Board Designer: Typically works with the hardware engineer to decide the design of the custom board, pin muxing, and to update the Board XML file used by the Device Tree Generator.
• Hardware Engineer: Usually works only on the FPGA Quartus Project, and notifies the firmware engineer whenever the hardware files (.sof, .rbf, .sopcinfo, handoff folder) were changed. He also needs to notify the firmware engineer of any hardware interface changes.
• Firmware Engineer: Typically updates the Linux drivers according to the changes that were performed in hardware, recompiles the kernel if necessary. Re-generates the Device Tree when needed.
• Software Engineer: Develops the applications that run on top of the Linux OS. May need to change the software when new drivers are added.

Linux Documentation

• Linux BSP User Manual
• Yocto User Manual
• Device Tree Generator User Guide