This article will discuss the steps needed to download and compile a Bootable (SD) Linux Image for the ZCU102 using the OSL flow.
...
The recommended flow for building a Linux system is to use the Petalinux tools. However, this article offers an alternative for users that want full visibility into the Image.
This assumes that the users has downloaded Vitis (used to by the devcetree generator). I have structured this wiki in a way that users can copy this into their Makefile for ease of use. However, users will need to be careful of the makefile syntax while copy and pasting.
Some steps are duplicated. For example, the cross_compile steps. This is intentional to allow the users to build each image in isolation.
However, users must use the same tag, as there are dependencies between pmufw and atf for example.The rootFS is downloaded from the released images from here.
NOTE: If building on an Ubuntu (or derivative machine), ensure that the default shell has been changed from Dash to Bash. Compiling in Dash may result in syntax errors within the Makefile that will prevent the code from compiling.
...
| Code Block |
|---|
|
kernel:
$(MAKE) -C linux-xlnx clean
source $(TOOLS)/$(VERSION)/settings64.sh; \
export CROSS_COMPILE=aarch64-linux-gnu-; \
export ARCH=arm64; \
export CC=aarch64-linux-gnu-gcc; \
cd linux-xlnx; \
$(MAKE) -f Makefile xilinx_zynqmp_defconfig; \
$(MAKE) -f Makefile all -j 32; \
$(MAKE) -f Makefile modules_install INSTALL_MOD_PATH=. |
Build device-tree
- Create a xsct_script.tcl file with the following contents:
| Code Block |
|---|
|
proc build_dts {args} {
set board 0
set version 2020.2
for {set i 0} {$i < [llength $args]} {incr i} {
if {[lindex $args $i] == "-board"} {
set board [string tolower [lindex $args [expr {$i + 1}]]]
}
if {[lindex $args $i] == "-version"} {
set version [string toupper [lindex $args [expr {$i + 1}]]]
}
}
set xsa [glob -nocomplain -directory [pwd] -type f *.xsa]
hsi::open_hw_design $xsa
hsi::set_repo_path ./repo
hsi::create_sw_design device-tree -os device_tree -proc psu_cortexa53_0
hsi::generate_target -dir my_dts
hsi::close_hw_design [hsi::current_hw_design]
if {$board != 0} {
foreach lib [glob -nocomplain -directory repo/my_dtg/device-tree-xlnx/device_tree/data/kernel_dtsi/${version}/include/dt-bindings -type d *] {
if {![file exists my_dts/include/dt-bindings/[file tail $lib]]} {
file copy -force $lib my_dts/include/dt-bindings
}
}
set dtsi_files [glob -nocomplain -directory repo/my_dtg/device-tree-xlnx/device_tree/data/kernel_dtsi/${version}/BOARD -type f *${board}*]
if {[llength $dtsi_files] != 0} {
file copy -force [lindex $dtsi_files end] my_dts
set fileId [open my_dts/system-user.dtsi "w"]
puts $fileId "/include/ \"[file tail [lindex $dtsi_files end]]\""
puts $fileId "/ {"
puts $fileId "};"
close $fileId
}
}
} |
...
| Code Block |
|---|
|
bootimage:
export PATH=$$PATH:$(shell pwd)/bootgen; \
bootgen -arch zynqMP -image bootgen.bif -w -o BOOT.BIN |
Downloading the RootFS:
There are released images for all Xilinx development boards. I will extract the rootfs from the image.ub here using dumpimage utility:
| Code Block |
|---|
| language | c# |
|---|
| title | extract_rootfs |
|---|
|
extract_rootfs:
tar xvf $(VERSION)-$(BOARD)-release.tar.xz
./u-boot-xlnx/tools/dumpimage -T flat_dt -p 2 $(VERSION)-$(BOARD)-release/image.ub -o petalinux-image-minimal-zynqmp-generic.cpio.gz |
Creating the FIT image:
| Code Block |
|---|
|
/dts-v1/;
/ {
description = "U-Boot fitImage for plnx_aarch64 kernel";
#address-cells = <1>;
images {
kernel@0 {
description = "Linux Kernel";
data = /incbin/("./linux-xlnx/arch/arm64/boot/Image");
type = "kernel";
arch = "arm64";
os = "linux";
compression = "none";
load = <0x80000>;
entry = <0x80000>;
hash@1 {
algo = "sha1";
};
};
fdt@0 {
description = "Flattened Device Tree blob";
data = /incbin/("./system.dtb");
type = "flat_dt";
arch = "arm64";
compression = "none";
hash@1 {
algo = "sha1";
};
};
ramdisk@0 {
description = "ramdisk";
data = /incbin/("./petalinux-user-image-plnx_aarch64.cpio.gz");
type = "ramdisk";
arch = "arm64";
os = "linux";
compression = "none";
hash@1 {
algo = "sha1";
};
};
};
configurations {
default = "conf@1";
conf@1 {
description = "Boot Linux kernel with FDT blob + ramdisk";
kernel = "kernel@0";
fdt = "fdt@0";
ramdisk = "ramdisk@0";
hash@1 {
algo = "sha1";
};
};
conf@2 {
description = "Boot Linux kernel with FDT blob";
kernel = "kernel@0";
fdt = "fdt@0";
hash@1 {
algo = "sha1";
};
};
};
}; |
Use the command below to created the .ub file:
...
