Generate MCS Image - 2024.2 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2024-11-13
Version
2024.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 when design has programmable logic in design:

petalinux-package boot --fpga --u-boot --format MCS

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 when programmable logic present in design:

cd <plnx-proj-root>
petalinux-package boot --fpga pre-built/linux/images/system.bit --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 

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 when design has programmable logic:

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

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 when design has programmable logic:

cd <plnx-proj-dir>
petalinux-package boot --fpga pre-built/linux/images/system.bit --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

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.