Overview

This page presents how to generate the device tree source and how to compile it to a device tree blob file that Linux needs.

Reference Information

For detailed information about the Device Tree Generator see Device Tree Generator User Guide.

Prerequisites

The following items are required:

• Host PC running Linux (CentOS 6.3+ or Ubuntu 12.04+ are preferred)
• Altera SoC EDS Software - from https://www.altera.com/download/software/soc-eds
• GHRD Archive: cv_soc_devkit_ghrd.tar.gz or av_soc_devkit_ghrd.tar.gz from https://releases.rocketboards.org/2013.11/gsrd/ghrd.

Procedure

Cyclone V

1. Compile the GHRD as described in Compiling the Hardware Design to obtain the .sopcinfo file.

2. Start an Embedded Command Shell and go to GHRD folder (assumed here to be saved in the home folder):

$ ~/altera/13.1/embedded/embedded_command_shell.sh
$ cd ~/cv_soc_devkit_ghrd 

3. Run the Device Tree Generator

 $ sopc2dts --input soc_system.sopcinfo\
  --output socfpga.dts\
  --board soc_system_board_info.xml\
  --board hps_clock_info.xml 

This will generate the file cv_soc_devkit_ghrd/socfpga.dts.

4. In order to compile the Device Tree Source file and obtain the Device Tree Blob file run the following command:

$ dtc -I dts -O dtb -o socfpga.dtb socfpga.dts

This will generate the file cv_soc_devkit_ghrd/socfpga.dtb. that is required by Linux to boot.

Arria V

The procedure above uses the Cyclone V GHRD as an example. For the Arria V GHRD the following similar commands (just file names changed) can be used:

$ ~/altera/13.1/embedded/embedded_command_shell.sh
$ cd ~/av_soc_devkit_ghrd
$ sopc2dts --input ghrd_5astfd5k3.sopcinfo\
  --output socfpga.dts\
  --board ghrd_5astfd5k3_board_info.xml\
  --board hps_clock_info.xml
$ dtc -I dts -O dtb -o socfpga.dtb socfpga.dts

This will generate the file av_soc_devkit_ghrd/socfpga.dtb that is required by Linux to boot.