GSRD v16.1 - GHRD make utilities - Arrow SoCKit Edition

Overview

A makefile is included with the GHRD to provide automated command line build options. This can be used as an alternative build method and some users might find this more convenient.

The makefile utilities can be separated into the following categories

• Quartus and Qsys GUI edit
• Quartus and Qsys compile
• Generate .sof and .rbf FPGA images
• Program the FPGA or QSPI devices via the USB-Blaster II
• Reset the HPS via the USB-Blaster II
• Create the preloader and u-boot images
• Copy the preloader and u-boot binary images to an SD card binary partition

Prerequisites

The following items are required:

• Host PC running Linux (CentOS 6.3 or newer or Ubuntu 12.04LTS or newer preferred) or Windows
• Altera Quartus™ II v16.1 - available from http://www.altera.com/products/software/sfw-index.jsp
• GHRD Archive from github

Procedure

1. Open an embedded shell and cd to the home folder.

2. Clone the github archive

$ git clone https://github.com/arrow-socfpga/arrow-sockit-ghrd
$ cd arrow-sockit-ghrd

3. Checkout a branch (sockit-ghrd-16.1 or sockit-ghrd-1080p-16.1)

$ git checkout sockit-ghrd-16.1

4. Run the make utilities described on the next tab from this folder.

Make utilities

make all

The entire GHRD can be built using the make all command. This command will result in the following operations.

• Qsys generation
• Quartus compilation

make qsys_edit

Launches the Qsys GUI and opens the soc_system.qsys project

make qsys_compile

Generates the Qsys project

make quartus_edit

Launches the Quartus GUI and opens the soc_system project

make quartus_compile

Compiles the Quartus project

make sof

Compiles the Quartus project and creates the sof configuration file

make rbf

Compiles the Quartus project and creates the rbf configuration file. The configuration mode is Fast Passive Parallel, x32, compressed

make program_fpga

Downloads the sof configuration file to the FPGA

make program_qspi

Programs the on board qspi device with the preloader binary image. It uses the quartus_hps utility to do this.

make hps_cold_reset

Sends a cold reset request to the hps via the jtag

make hps_warm_reset

Sends a warm reset request to the hps via the jtag

Generated Files

This section presents the name and location of the files generated as a result of compiling the hardware design.

make utility	File	Description
all	sockit_ghrd/output_files/soc_system.sof	SRAM Object File - for programming FPGA
	sockit_ghrd/output_files/soc_system.rbf	Raw Binary File - for programming FPGA
	sockit_ghrd/soc_system.sopcinfo	SOPC Info File - Used by Device Tree Generator
	sockit_ghrd/soc_system/synthesis/soc_system_hps_0_hps.svd	System View File - Used by ARM DS-5 AE
	sockit_ghrd/hps_isw_handoff	Handoff folder - Used by Preloader Generator
qsys_compile	sockit_ghrd/soc_system.sopcinfo	SOPC Info File - Used by Device Tree Generator
quartus_compile	sockit_ghrd/output_files/soc_system.sof	SRAM Object File - for programming FPGA
	sockit_ghrd/soc_system/synthesis/soc_system_hps_0_hps.svd	System View File - Used by ARM DS-5 AE
	sockit_ghrd/hps_isw_handoff	Handoff folder - Used by Preloader Generator
sof	sockit_ghrd/output_files/soc_system.sof	SRAM Object File - for programming FPGA
rbf	sockit_ghrd/output_files/soc_system.rbf	Raw Binary File - for programming FPGA