Generate MCS Image - 2023.2 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2023-10-18
Version
2023.2 English

An MCS image for Zynq usually contains a First stage boot loader image (FSBL), FPGA bitstream, ArmĀ® trusted firmware, U-Boot, DTB, and Kernel Fit image (optional).

Execute the following command to generate the MCS image to boot up to U-Boot using build images:

petalinux-package --boot --u-boot --format MCS
Note: Specifying --u-boot adds all the required images to boot up to U-Boot into boot.mcs file.

Execute the following command to generate the MCS image to boot up to U-Boot using prebuilt images:

cd <plnx-proj-root>
petalinux-package --boot --u-boot pre-built/linux/images/u-boot.elf --dtb pre-built/linux/images/system.dtb --fsbl pre-built/linux/images/zynq_fsbl.elf --format MCS 

This generates boot.mcs in <plnx-proj-root>/images/linux directory. For more information on Bootgen arguments, see Bootgen User Guide (UG1283).

Execute the following command to generate the MCS image to boot up to Linux using build images:

petalinux-package --boot --u-boot --kernel --offset 0x1080000 --format MCS

Execute the following command to generate the MCS image to boot up to Linux using prebuilt images:

cd <plnx-proj-dir>
petalinux-package --boot --u-boot pre-built/linux/images/u-boot.elf --dtb pre-built/linux/images/system.dtb --fsbl pre-built/linux/images/zynq_fsbl.elf --kernel pre-built/linux/images/image.ub --offset 0x1080000 --boot-script pre-built/linux/images/boot.scr --format MCS

This generates boot.mcsin images/linux directory containing images to boot up to Linux using Fit image (with tiny root file system if switch_root enabled) loaded at 0x1080000 Flash offset.

For detailed usage, see the --help option and petalinux-package --boot.