Troubleshooting - Troubleshooting - 2026.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)
Document ID
UG1144
Release Date
2026-06-23
Version
2026.1 English

This section describes some common issues you can experience while booting a PetaLinux image on hardware with QSPI/OSPI Flash.

Table 1. PetaLinux Image on Hardware Troubleshooting
Problem / Error Message Description and Solution

Wrong Image Format for boot command.

ERROR: Can't get kernel image!

Problem Description:

This error message indicates that the U-Boot boot loader is unable to find kernel image. This is likely because the Kernel offset in the boot.scr and the Kernel image offset in the Flash do not match.

Solution:

To see the default boot offsets of SPI, click Configuring U-Boot Boot Script (boot.scr)

Wrong Image Format for bootm command ERROR: can't get kernel image! Booting using Fit image failed

 Problem Description:

This error message appears when you load Image and ramdisk.cpio.gz.uboot for QSPI/OSPI/NAND boot mode. You can ignore this error message.
Error string observed while booting.

[ systemd[1]: File System Check on Root Device was skipped because of a failed condition check (ConditionPathIsReadWrite=!/).

 Error message indicates that the file system devices has read and write permission. Since this has no functional impact, you can ignore it.
Tip: To know more about U-Boot options, use the U-Boot-PetaLinux> printenv command.