Generate MCS Image - 2022.1 English

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2022-04-26
Version
2022.1 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.mcs in 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.