Compiling Hardware Design and Preloader

Compile Atlas SoC Hardware Design and Generate Preloader

This page needs tagging. Please add keywords describing what this page is about.

Overview

The build flow for the Atlas Hardware image is entirely makefile driven, and all source is hosted on GitHub. All Quartus and SoCEDS and ARM Development Studio tools should be in the path for compilation.

The Build will generate the following:

1. Quartus Project and associated FPGA images
2. Preloader and u-Boot images
3. u-Boot boot script
4. Tar of all of the contents for the FAT partition on the boot sdcard

The build flow consists of the following

1. Creation of quartus project and settings
2. Creation and generation of the QSys system
3. Compilation of the Quartus project
4. Build of the Preloader and u-Boot
5. Tar of the FAT partition contents

Finally, the atlas hardware source has the following structure

• ip - Contains all customer qsys ip for the project
• patches - Contains patches specific to u-Boot and the preloader
• hdl_src - Contains verilog top level source
• board_info - deprecated, old board xml for use with sopc2dts
• scripts - scripts to create quartus and qsys files
• mks - Makefile fragments for various targets

Prerequisites

The following items are required:

1. Quartus and SoCEDS and ARM Development Studio 15.0.1 or 15.0.2
2. Access to github
3. READ the DEBUG Build section!

Procedure

In either a SoCEDS and ARM Development Studio shell on Windows, or a terminal on a linux machine (tested on Fedora 21/22 & Centos 6.5 bash terminals) with the Quartus and SoCEDS and ARM Development Studio tools in the path

1. mkdir atlas
2. cd atlas
3. wget https://github.com/dwesterg/atlas-soc-ghrd/tarball/master -O atlas-soc-ghrd.tgz
4. mkdir atlas-soc-ghrd
5. tar -xzvf atlas-soc-ghrd.tgz --strip-components 1 -C atlas-soc-ghrd
6. cd atlas-soc-ghrd
7. make all

Results

The only output needed to create the SDCard image is the tar of the fat contents (sd_fat.tar.gz) however there are other useful things to note.

• ATLAS_SOC_GHRD - Quartus and QSys build and output
• ATLAS_SOC_GHRD/preloader - the preloader and uboot build
• ATLAS_SOC_GHRD/output_files - Quartus build output, including sof and rbf for the FPGA

Debug Build

Attention: work in progress!

• QSys generation will fail on Web Editions of Quartus, or installations of Quartus without the Stratix family installed per this KDB entry.