Overview

U-boot, Linux kernel and Yocto are also provided through the git trees at https://github.com/altera-opensource. This page presents instructions for cloning the git trees and building U-boot, Linux kernel and Yocto.

Component	Git address	Branch	Tag
Linux	linux-socfpga.git	socfpga-3.9-rel	ACDS13.1_REL_GSRD_PR
U-Boot	u-boot-socfpga.git	socfpga_v2013.01.01-rel	ACDS13.1_REL_GSRD_PR
Yocto	poky-socfpga.git	danny-altera-rel	ACDS13.1_REL_GSRD_PR_UPDATE1

Note: If your computer connects to the Internet using a proxy, you may need to use this command totell the Git utility about the proxy:

$ git config --global http.proxy <proxy_name>

Build Toolchain

In case the U-boot or Linux kernel git trees are directly used, the build toolchain has to be manually downloaded. This section contains the instructions on how to download and setup the toolchain for this case.

Note that the build toolchain is provided with the Yocto Source Package. And In case the Yocto Project git tree is used, the recipes will download the build chain automatically.

The steps necessary to download and setup the build toolchain are:

$ cd ~
$ wget https://launchpad.net/linaro-toolchain-binaries/trunk/2012.11/+download/gcc-linaro-arm-linux-gnueabihf-4.7-2012.11-20121123_linux.tar.bz2
$ tar xjf gcc-linaro-arm-linux-gnueabihf-4.7-2012.11-20121123_linux.tar.bz2
$ export CROSS_COMPILE=~/gcc-linaro-arm-linux-gnueabihf-4.7-2012.11-20121123_linux/bin/arm-linux-gnueabihf-

U-Boot

This section presents instructions on how to clone the U-boot git tree and compile U-boot. It assumes that you have manually downloaded the build toolchain.

$ git clone http://git.rocketboards.org/u-boot-socfpga.git 
$ cd u-boot-socfpga
$ git checkout -b test_branch_name ACDS13.1_REL_GSRD_PR
$ export CROSS_COMPILE=~/gcc-linaro-arm-linux-gnueabihf-4.7-2012.11-20121123_linux/bin/arm-linux-gnueabihf-
$ make mrproper
$ make socfpga_cyclone5_config
$ make

Notes:

• replace test_branch_name with the name of the branch you want to use locally.
• replace make socfpga_cyclone5_config with make socfpga_arria5_config to compile the Arria V version.

Some of the files that are created:

File	Description
u-boot	U-boot ELF file
u-boot.bin	U-boot binary file
u-boot.img	U-boot image file

Linux Kernel

This section presents instructions on how to clone the Linux kernel git tree and compile the Linux kernel. It assumes that you have manually downloaded the build toolchain.

$ git clone http://git.rocketboards.org/linux-socfpga.git 
$ cd linux-socfpga
$ git checkout -b test_branch_name ACDS13.1_REL_GSRD_PR
$ export CROSS_COMPILE=~/gcc-linaro-arm-linux-gnueabihf-4.7-2012.11-20121123_linux/bin/arm-linux-gnueabihf-
$ make ARCH=arm socfpga_defconfig
$ make ARCH=arm uImage LOADADDR=0x8000

Note: replace test_branch_name with the name of the branch you want to use locally.

Some of the files that are created:

File	Description
vmlinux	Linux Kernel ELF file
arch/arm/boot/uImage	Linux Kernel image

On you host machine, the step

$ make ARCH=arm uImage LOADADDR=0x8000

may fail with

"mkimage" command not found - U-Boot images will not be built
make[1]: *** [arch/arm/boot/uImage] Error 1
make: *** [uImage] Error 2

The mkimage tool can be installed as a Linux distribution package, but it is also built as part of the uboot compilation step.

This works around this failure:

$ export PATH=../u-boot-socfpga/tools:$PATH; make  ARCH=arm uImage LOADADDR=0x8000

Yocto Project

This section presents how to clone the Yocto Project git tree and also how to build using it.

Note that in this case only the Yocto Project build system and the recipes are cloned, all the dependencies are downloaded from Internet during the build process.

Refer to Linux Getting Started on Altera SoC Development Board - Using Yocto Source Package for the Yocto Project Source Package instead if you do not have Internet access on the build machine, or if you want to avoid downloading the dependencies.

The instructions for cloning the Yocto Project git trees and building Yocto Project are:

$ git clone http://git.rocketboards.org/poky-socfpga.git  
$ cd  poky-socfpga/
$ git checkout -b test_branch_name ACDS13.1_REL_GSRD_PR_UPDATE1
$ source ./altera-init build
$ bitbake virtual/kernel virtual/bootloader altera-gsrd-image    

Note: replace test_branch_name with the name of the branch you want to use locally.

On Debian / Ubuntu, may have to first "sudo apt-get install chrpath".

If docbook fails to link, you may have hit https://bugzilla.yoctoproject.org/show_bug.cgi?id=2972 in which case you can patch the bitbake recipe as a workaround. See https://lists.yoctoproject.org/pipermail/meta-freescale/2012-December/000597.html

This will build all the Linux items: U-boot, Device Tree, Linux kernel, root filesystem. See Using Yocto Source Package for more details and a list of generated files.