Wiki

Analog Devices Wiki

English
English
简体中文
简体中文
日本語
日本語
Руccкий
Руccкий
This version is outdated by a newer approved version.DiffThis version (14 Feb 2018 15:12) was approved by Michael Hennerich.The Previously approved version (02 Feb 2018 10:30) is available.Diff

This is an old revision of the document!

Table of Contents

Building the Zynq Linux kernel and devicetrees from source

The script method

We provide a script that does automates the build for Zynq using the Linaro toolchain.

The script takes 4 parameters:

  1. <zynq|zynqmp> - default is zynq if left blank
  2. <local_kernel_dir> - default is linux-adi if left blank ; use this, if you want to use an already cloned kernel repo
  3. <devicetree_file> - which device tree should be exported/copied from the build ; default is zynq-zc702-adv7511-ad9361-fmcomms2-3.dtb for Zynq
  4. <path_to_other_toolchain> - in case you have your own preferred toolchain [other than Linaro's or Xilinx's] you can use override it with this 3rd param

The script will:

  1. clone the ADI kernel tree
  2. download the Linaro GCC toolchain [if no other is specified]
  3. build the ADI kernel tree
  4. export/copy the Image file and device tree file out of the kernel build folder

Running the script in one line [with defaults]

wget https://raw.githubusercontent.com/analogdevicesinc/wiki-scripts/master/linux/build_zynq_kernel_image.sh && chmod +x build_zynq_kernel_image.sh && ./build_zynq_kernel_image.sh

On the development host

Make sure you have u-boot-tools installed, to have the mkimage utility available. You can install it via your distro's package manager.

Then 

git clone https://github.com/analogdevicesinc/linux.git

or do a git pull in the existing repository.

Checkout the Release branch

If not otherwise required always use the latest release!
Release names and Branches
2014_R2
2015_R2
2016_R1
2016_R2
2017_R1 
dave@hal9000:~/github-linux-build/linux$ git checkout origin/2015_R2 -b 2015_R2
Branch 2015_R2 set up to track remote branch 2015_R2 from origin.
Switched to a new branch '2015_R2'

Setup cross compile environment variables

There are a few toolchains that can be used. The Xilinx toolchain is recommended, but the Linaro toolchain can also be used.

Other toolchains/compilers for ARM may work as well, but the ones described here have been tested and found to work.

Using the Xilinx toolchain

Release names and Branches Required Vivado/SDK versions
2014_R2 Vivado 2014.2
2015_R2 Vivado 2015.2
2016_R1 Vivado 2015.4.2
2016_R2 Vivado 2016.2
2017_R1 Vivado 2016.4

Vivado 2015.2 SDK may be installed into a different directory 

dave@hal9000:~/github-linux-build/linux$ source /opt/Xilinx/SDK/2015.2/settings64.sh
dave@hal9000:~/github-linux-build/linux$ export ARCH=arm
dave@hal9000:~/github-linux-build/linux$ export CROSS_COMPILE=arm-xilinx-linux-gnueabi-

Using the Linaro toolchain

Alternatively, the Linaro toolchain/compiler can be used to compile to kernel. Linaro compilers (that work with Zynq) can be downloaded from: https://releases.linaro.org/components/toolchain/binaries/latest-5/arm-linux-gnueabi/

Example: 

wget https://releases.linaro.org/components/toolchain/binaries/latest-5/arm-linux-gnueabi/gcc-linaro-5.5.0-2017.10-x86_64_arm-linux-gnueabi.tar.xz
tar -xvf gcc-linaro-5.5.0-2017.10-x86_64_arm-linux-gnueabi.tar.xz
export ARCH=arm
export CROSS_COMPILE=$(pwd)/gcc-linaro-5.5.0-2017.10-x86_64_arm-linux-gnueabi/bin/arm-linux-gnueabi-

Configure the kernel

dave@hal9000:~/github-linux-build/linux$ make zynq_xcomm_adv7511_defconfig
#
# configuration written to .config
#
dave@hal9000:~/github-linux-build/linux$

Build the kernel

dave@hal9000:~/github-linux-build/linux$ make -j5 UIMAGE_LOADADDR=0x8000 uImage
scripts/kconfig/conf --silentoldconfig Kconfig
  CHK     include/config/kernel.release
  CHK     include/generated/uapi/linux/version.h
  UPD     include/config/kernel.release
  CHK     include/generated/utsrelease.h

[ -- snip --]

  AS      arch/arm/boot/compressed/bswapsdi2.o
  AS      arch/arm/boot/compressed/piggy.gzip.o
  LD      arch/arm/boot/compressed/vmlinux
  OBJCOPY arch/arm/boot/zImage
  Kernel: arch/arm/boot/zImage is ready
  UIMAGE  arch/arm/boot/uImage
Image Name:   Linux-3.17.0-126697-g611e217-dir
Created:      Fri Nov 28 10:20:40 2014
Image Type:   ARM Linux Kernel Image (uncompressed)
Data Size:    3195872 Bytes = 3120.97 kB = 3.05 MB
Load Address: 00008000
Entry Point:  00008000
dave@hal9000:~/github-linux-build/linux$

Build the devicetree FCMOMMS2/3/4/5

Build the one that fits your FPGA carrier and FMC card

zynq-zc702-adv7511-ad9361-fmcomms2-3.dts ZC702, the on-board ADV7511 and the AD-FMCOMMS2-EBZ or AD-FMCOMMS3-EBZ board
zynq-zc702-adv7511-ad9361-fmcomms5.dts ZC702, the on-board ADV7511 and the AD-FMCOMMS5-EBZ
zynq-zc702-adv7511-ad9364-fmcomms4.dts ZC702, the on-board ADV7511 and the AD-FMCOMMS4-EBZ board
zynq-zc706-adv7511-ad9361-fmcomms2-3.dts ZC706, the on-board ADV7511 and the AD-FMCOMMS2-EBZ or AD-FMCOMMS3-EBZ board
zynq-zc706-adv7511-ad9361-fmcomms2-3-pr.dts ZC706, the on-board ADV7511 and the AD-FMCOMMS2-EBZ or AD-FMCOMMS3-EBZ board
zynq-zc706-adv7511-ad9361-fmcomms5.dts ZC706, the on-board ADV7511 and the AD-FMCOMMS5-EBZ board
zynq-zc706-adv7511-ad9364-fmcomms4.dts ZC706, the on-board ADV7511 and the AD-FMCOMMS4-EBZ board
zynq-zc706-adv7511-ad9434-fmc-500ebz.dts ZC706, the on-board ADV7511 and the AD9434-FMC-500EBZ board
zynq-zed-adv7511-ad9361-fmcomms2-3.dts Zed Board, the on-board ADV7511 and the AD-FMCOMMS2-EBZ or AD-FMCOMMS3-EBZ board
zynq-zed-adv7511-ad9364-fmcomms4.dts Zed Board, the on-board ADV7511 and the AD-FMCOMMS4-EBZ board
zynq-zed-adv7511-ad9467-fmc-250ebz.dts Zed Board, the on-board ADV7511 and the AD9467-FMC-250EBZ board
zynq-mini-itx-adv7511-ad9361-fmcomms2-3.dts Mini-ITX, the on-board ADV7511 and the AD-FMCOMMS2-EBZ or AD-FMCOMMS3-EBZ board
zynq-mini-itx-adv7511-ad9361-fmcomms2-3-pr.dts Mini-ITX, the on-board ADV7511 and the AD-FMCOMMS2-EBZ or AD-FMCOMMS3-EBZ board
zynq-mini-itx-adv7511-ad9364-fmcomms4.dts Mini-ITX, the on-board ADV7511 and the AD-FMCOMMS4-EBZ board 
dave@hal9000:~/github-linux-build/linux$ make zynq-zc702-adv7511-ad9361.dtb
  DTC     arch/arm/boot/dts/zynq-zc702-adv7511-ad9361.dtb
dave@hal9000:~/github-linux-build/linux$

Copy the generated files to your SD Card

dave@hal9000:~/github-linux-build/linux$ cp arch/arm/boot/uImage /media/BOOT/uImage
dave@hal9000:~/github-linux-build/linux$ cp arch/arm/boot/dts/zynq-zc702-adv7511-ad9361.dtb  /media/BOOT/devicetree.dtb

On the target platform

Modifying devicetrees

1. Make sure the boot partition is mounted. On new images, this can be done by right-clicking the boot icon on the desktop and selecting the “Mount Volume” option. The partition will then be mounted at /media/analog/boot.

2. Convert the compiled devicetree related to the target back into an editable format. 

dave@hal9000:/media/analog/boot/zynq-zc702-adv7511$ dtc -I dtb -O dts -o devicetree.dts devicetree.dtb

3. Modify the devicetree.dts file as required.

4. Recompile the devicetree file. Note that this will overwrite the original dtb file, copy or rename the original file if you want to keep it before running this step. 

dave@hal9000:/media/analog/boot/zynq-zc702-adv7511$ dtc -I dts -O dtb -o devicetree.dtb devicetree.dts

Building the Zynq boot image

The boot image BOOT.BIN is built using the bootgen tool which requires several input files.

Instructions on how to build the Xilinx Shell Archive (XSA) handover file can be found here:

All further steps are lengthy explained on the Xilinx Wiki Page

Use script to build BOOT.BIN

For ease of use, we provide a bash shell script which allows building BOOT.BIN from system_top.xsa and u-boot.elf

Download

The script can be downloaded from here:

NOTE: After downloading the script you need to make it executable

$ chmod +x build_boot_bin.sh

Usage

usage: build_boot_bin.sh system_top.xsa u-boot.elf [output-archive]
  • Path to system_top.xsa and u-boot.elf are required parameters
  • An optionally 3rd name parameter can be given to tar.gz the output directory (name.tar.gz)
  • Build output is located in a local directory named: output_boot_bin
  • This script requires Xilinx Vitis and bootgen in the PATH
    • A simple way is to source vivado settings[32|64].sh:
$ source /opt/Xilinx/Vivado/202x.x/settings64.sh
  • When using cygwin, you can add the following in the ~/.bashrc configuration file:
export PATH=$PATH:/cygdrive/c/Xilinx/Vivado/202x.x/bin
export PATH=$PATH:/cygdrive/c/Xilinx/Vitis/202x.x/bin

There is also a version of script that works in Windows Powershell: build_boot_bin.ps1

NOTE: u-boot.elf
For those who don't want to build u-boot themselves.
The u-boot.elf can be extracted from the project folder on the SD Card image, bootgen_sysfiles.tgz

14 Feb 2018 11:33 · Michael Hennerich
resources/tools-software/linux-build/generic/zynq.1518606802.txt.gz · Last modified: 14 Feb 2018 12:13 by Michael Hennerich

Page Tools