Generate MCS Image - Generate MCS Image - 2026.1 English - UG1144

An MCS image for Versal usually contains a PDI file (imported from hardware design), PLM, PSM firmware, 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

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 --plm pre-built/linux/images/plm.elf --psmfw pre-built/linux/images/psmfw.elf --atf pre-built/linux/images/bl31.elf --format MCS

This generates boot.mcs in <plnx-proj-root>/images/linux directory. The default DTB load address is 0x1000. 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 0xF40000 --format MCS

Execute the following command to generate the MCS image to boot up to Linux 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 --plm pre-built/linux/images/plm.elf --psmfw pre-built/linux/images/psmfw.elf --atf pre-built/linux/images/bl31.elf --kernel pre-built/linux/images/image.ub --offset 0xF40000 --boot-script pre-built/linux/images/boot.scr --format MCS

This generates boot.mcs in theimages/linux directory containing images to boot up to Linux using Fit image (with a tiny root file system if switch_root is enabled) loaded at 0xF40000 Flash offset.

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