Prerequisites

You will need the following items:

• Arria 10 SoCDevelopment Kit, Rev B and Rev C including:
  • DDR4 Memory Card
  • QSPI Boot Card
• Host PC with:
  • Linux OS - required for compiling U-Boot, which is not supported on Windows
  • Minimum 16GB or RM - required for building the hardware design
  • Serial terminal (for example minicom
  • TFTP Server - for getting Linux binaries to U-Boot to be written to QSPI
  • SoC EDS 16.0 b210 - for generating and building U-Boot
  • ACDS 16.0 b210 - for compiling the hardware design
• Local Ethernet network, with DHCP server (will be used to provide IP address to the board).

Overview

The QSPI boot reference design is very similar with the regular SD card version of the GSRD, with the following notes:

• There is a separate GHRD, that is configured to use QSPI instead of SD card
• There are a separate set of Angstrom recipes, with minor changes as compared to the SD card versoin
• The root file system does not contain all the features of the SD card GSRD, because of limited space

QSPI Layout

The following layout was chosen for the QSPI:

Item	Start Address (Hex)	Size (Hex)	Size (Bytes)
Bootloader Image 0	0x0	0x0040000	262,144
Bootloader Image 1	0x4_0000	0x0040000	262,144
Bootloader Image 2	0x8_0000	0x0040000	262,144
Bootloader Image 3	0xC_0000	0x0040000	262,144
Linux Device Tree	0x10_0000	0x00020000	131,072
zImage	0x12_0000	0x00600000	6,291,456
Monolithic rbf	0x72_0000	0x02900000	42,991,216
U-boot Environment Setting	0x3010000	0x00010000	65,536
Linux File System	0x3020000	0x05000000	83,886,080

Notes:

• Location of the Bootloader at offset 0x0 in QSPI is required by BootROM.
• The FPGA configuration file needs to have the U-Boot (mkimage) wrapper.
• Location of RBF file, Linux kernel and Linux Device Tree are hardcoded in U-Boot source code as U-Boot environment variables (qspirbfaddr, qspibootimageaddr, qspifdtaddr). Their default values can be changed by editing the U-Boot source code file include/configs/socfpga_arria10.h.
• Location of root file system is defined in the Linux Device Tree.

Building the QSPI GSRD

This section describes how to build the QSPI version of the A10 GSRD. The build process is very similar with the SD card version of the GSRD.

Notes:

• Prebuilt binary files are included with this release, so the QSPI GSRD can also be used without being rebuilt.
• In order to make this page shorter, the command line tools are used for the whole build process.

Building Hardware Design

1. Download the hardware design archive:

• For Development Kit Rev C: use https://releases.rocketboards.org/2016.05/a10qspiboot/hw/a10_soc_devkit_ghrd_qspi.tar.gz
• For For Development Kit Rev B: use https://releases.rocketboards.org/2016.05/a10qspiboot/hw/a10_devkit_revb/a10_soc_devkit_ghrd_qspi.tar.gz

Note that you will have to open the file in a web browser (wget doesn't work as you'll need to agree to a popup license agreement).

2. Extract the archive:

cd ~
tar xvzf a10_soc_devkit_ghrd_qspi.tar.gz

3. Build hardware design, U-Boot and Linux device tree from Embedded Command Shell:

Building Hardware design

~/altera/16.0/embedded/embedded_command_shell.sh
cd ~/a10_soc_devkit_ghrd_qspi/
qsys-generate --synthesis=VERILOG ghrd_10as066n2.qsys
quartus_sh --flow compile ghrd_10as066n2.qpf
quartus_cpf -c -o bitstream_compression=on output_files/*.sof output_files/ghrd_10as066n2.rbf
mkimage -A arm -T firmware -C none -O u-boot -a 0 -e 0 -n "RBF" -d output_files/ghrd_10as066n2.rbf output_files/ghrd_10as066n2.rbf.mkimage 

Building uboot

bsp-create-settings --preloader-settings-dir=hps_isw_handoff --type=uboot --settings=software/settings.bsp
bsp-update-settings --settings=software/settings.bsp --set uboot.boot_device QSPI
bsp-generate-files --settings=software/settings.bsp --bsp-dir=software/uboot
make -C software/uboot

Generating Linux device tree

sopc2dts --input ghrd_10as066n2.sopcinfo --output ghrd_10as066n2.dts --board hps_a10_common_board_info.xml --board hps_10_devkit_board_info.xml --board ghrd_10as066n2_board_info.xml --bridge-removal all --clocks

This will create the following files in the ~/a10_soc_devkit_ghrd folder:

File	Description
output_files/ghrd_10as066n2.sof	FPGA Configuration File in SOF format
output_files/ghrd_10as066n2.rbf	FPGA Configuration File in RBF format
output_files/ghrd_10as066n2.rbf.mkimage	FPGA Configuration File in RBF format, with the mkimage header

Note that the hardware design can also be built from the Quartus II GUI. The process is identical as for the SD card version: Compiling Hardware Design.

Generating and Building U-Boot and U-Boot Device Tree

Build U-Boot from Embedded Command Shell:

~/altera/16.0/embedded/embedded_command_shell.sh
cd ~/a10_soc_devkit_ghrd_qspi/
bsp-create-settings --preloader-settings-dir=hps_isw_handoff --type=uboot --settings=software/settings.bsp
bsp-update-settings --settings=software/settings.bsp --set uboot.boot_device QSPI
bsp-generate-files --settings=software/settings.bsp --bsp-dir=software/uboot
make -C software/uboot

This will create the following in the ~/a10_soc_devkit_ghrd folder:

File	Description
software/uboot/uboot_w_dtb-mkpimage.bin	U-Boot Binary and Device Tree, wrapped with mkpimage header

Note that U-Boot BSP generator can also be invoked as a GUI application, not only from the command line. The flow is documented here: Generating U-Boot and U-Boot Device Tree

Building Linux Device Tree

Build Linux Device Tree from Embedded Command Shell:

~/altera/16.0/embedded/embedded_command_shell.sh
cd ~/a10_soc_devkit_ghrd_qspi/
sopc2dts --input ghrd_10as066n2.sopcinfo --output ghrd_10as066n2.dts --board hps_a10_common_board_info.xml --board hps_10_devkit_board_info.xml --board ghrd_10as066n2_board_info.xml --bridge-removal all --clocks

This will create the following in the ~/a10_soc_devkit_ghrd folder:

File	Description
ghrd_10as066n2.dts	Linux Device Tree Source
ghrd_10as066n2.dtb	Linux Device Tree Blob

Building Linux Kernel and Root Filesystem

The complete instructions on how to build the binaries required to boot Linux from QSPI are:

1. Please follow the steps described in Compiling Linux Kernel and Root Filesystem section Host Setup for Yocto to configure your host with the necessary packages to run Yocto.

2. Run the following commands to get and build the updated Angstrom Yocto recipes:

cd ~
$ git clone https://github.com/altera-opensource/angstrom-socfpga
$ cd angstrom-socfpga/
$ git checkout -b test_branch ACDS16.0_REL_GSRD_PR
$ MACHINE=arria10 ./oebb.sh config arria10
$ source ./environment-angstrom-v2014.12
$ export BB_ENV_EXTRAWHITE="$BB_ENV_EXTRAWHITE KERNEL_TAG UBOOT_TAG UBOOT_PROT UBOOT_REPO"
$ export KERNEL_TAG=refs/tags/ACDS16.0_REL_GSRD_PR
$ export UBOOT_TAG=refs/tags/ACDS16.0_REL_GSRD_PR
$ export UBOOT_REPO=git://github.com/altera-opensource/u-boot-socfpga
$ export UBOOT_PROT=http
$ export set PATH=~/Python-2.7.8:~/git-1.7.8:~/tar-1.28/src:$PATH ← only on CentOS 6.5
$ MACHINE=arria10 bitbake virtual/kernel console-image-minimal virtual/bootloader 

This will create the following in the folder ~/angstrom-socfpga/deploy/glibc/images/arria10/:

File	Description
zImage	Linux kernel
console-image-minimal-arria10.jffs2	Root Filesystem Image
console-image-minimal-arria10.tar.xz	Root Filesystem Archive

Programming QSPI

This section presents how to write the QSPI GSRD deliverables to the QSPI Flash device. Prebuilt binaries, or rebuilt files can be used, or a combination of both, as desired.

Writing U-Boot and RBF and Booting U-Boot

This section presents how to write to QSPI the U-Boot and the FPGA configuration file and then boot from QSPI to U-Boot prompt.

1. Connect a micro USB cable from connector J22 to the PC (used for JTAG connection) and a mini USB cable from connector J10 to the PC (used for serial connection).

2. Start a serial terminal on PC and connect to the board using 115,200-8-N-1.

3. Power up the board. Observe the serial terminal. If U-Boot tries to boot, press any key to stop it. This is required because the HPS Flash programmer can have problems connecting to the board when Linux is running.

4. Program the files from an Embedded Command Shell

~/altera/16.0/embedded/embedded_command_shell.sh
cd ~/a10_soc_devkit_ghrd_qspi
quartus_hps --cable=1 --operation=PV --addr=0x0 software/uboot_bsp/uboot_w_dtb-mkpimage.bin
quartus_hps --cable=1 --operation=PV --addr=0x720000 output_files/ghrd_10as066n2.rbf.mkimage

Note: Programming U-Boot to QSPI takes ~4 minutes, while programming the RBF file takes ~1hr.

5. Power cycle the board and observe the serial terminal. U-Boot will run. Press any key to get to the U-Boot console.

Writing Linux Binaries to QSPI and Booting Linux

1. On host PC, make sure you have an TFTP server configured and running.

2. On Host PC, copy QSPI image to the TFTP folder. The following assume that the TFTP shared folder is /tftpboot.

cd ~/
cp qspiimage.img /tftpboot/

3. Boot the board up to U-Boot console, by powering it up and pressing any button while U-Boot displays the countdown timer.

4. At the U-Boot console, run the following commands to erase the flash locations where the Linux Device Tree, Linux kernel and Linux filesystem will be written

sf probe
sf erase 0x0 0x8000000

Note: Erasing QSPI from U-Boot takes a long time. This can be done faster with the HPS Flash Programmer by running the following commands:

~/altera/16.0/embedded/embedded_command_shell.sh
quartus_hps --cable=1 --operation=E --addr=0x0 --size=0x8000000

5. At the U-Boot console, download and write the full QSPI image to the flash:

tftp $loadaddr qspiimage.img
sf write $loadaddr 0x0 $filesize

6. Power cycle the board. It should boot to the Linux console.

Error: (3) can't find a10-linux-booted.png in Documentation

Deliverables

The associated files are available at https://releases.rocketboards.org/2016.05/a10qspiboot and consist of the following:

Folder	File	Description
bin/	linux-socfpga-gsrd-16.0-a10-qspi-bin.tar.gz	Precompiled binaries for Rev C board
bin/a10_devkit_revb/	linux-socfpga-gsrd-16.0-a10-qspi-bin.tar.gz	Precompiled binaries for Rev B board
hw/	a10_soc_devkit_ghrd_qspi.tar.gz	Hardware project for Rev C board
hw/a10_devkit_revb/	a10_soc_devkit_ghrd_qspi.tar.gz	Hardware project for Rev B board
src/	a10_soc_devkit_ghrd_qspi-src.tar.gz

The precompiled binaries archive contains the following:

File	Description
console-image-qspi-arria10.jffs2.gz	Compressed JFFS2 rootfs partition image
console-image-qspi-arria10.tar.xz	Compressed root file system archive
ghrd_10as066n2.rbf.mkimage	FPGA Configuration RBF wrapped with mkimage header
ghrd_10as066n2.sof	FPGA Configuration File SOF
qspiimage.tar.gz	Compressed image of the QSPI
socfpga_arria10_socdk_qspi.dtb	Updated Linux Device Tree file
uboot_w_dtb-mkpimage.bin	Precompiled U-Boot and U-Boot Device Tree Image
vmlinux	Linux kernel executable
zImage	Linux kernel compressed image

The prebuilt binaries are provided for reference, and can enable the user to skip some or all of the steps from the flow.