Colibri IMX8QXP - "Unknown command 'bootz'"

Hello everyone,

I have a Colibri IMX8QXP 2GB IT V1.0D and I wanted to upgrade this to Torizon OS 6, so I have tried to update the module to the Colibri IMX8X image (version 6.6.1+build.14)

Now after the update, the device is stuck in uboot. The error I receive is:

"Unknown command ‘bootz’ - try ‘help’ "

Does anyone know how to solve this error?

Kind regards,

Hi, I’m the Toradex AI Assistant. I’m in early beta, and I would appreciate your feedback.
The Toradex Support team will follow up with you shortly!

Did you like my answer?

:+1: :-1:

Hello Anouk,

The issue you’re encountering with the “Unknown command ‘bootz’” error in U-Boot on your Colibri iMX8QXP module typically indicates that the U-Boot version running on your device does not support the bootz command, which is used to start the Linux kernel image compressed with zlib. This can happen due to various reasons, such as an incomplete update or a mismatch between the U-Boot and the kernel image.

To resolve this error, please follow these steps:

  1. Ensure Compatibility: Verify that the Torizon OS version you are trying to install is compatible with your Colibri iMX8QXP module. Each Toradex module has specific software versions that are compatible with it.

  2. Update U-Boot: It’s possible that the U-Boot on your device needs to be updated to a version that supports the bootz command. You can do this by downloading the appropriate U-Boot binary for the Colibri iMX8QXP from the Toradex website and using the U-Boot update procedure outlined in the Toradex documentation.

  3. Use Toradex Easy Installer: If you’re not already using it, the Toradex Easy Installer is the recommended way to install or update the OS on Toradex modules. It simplifies the process and reduces the chances of compatibility issues. Boot your module into the Toradex Easy Installer and select the appropriate Torizon OS version for your module.

  4. Check Boot Environment: If the U-Boot and Torizon OS versions are compatible, check the U-Boot environment variables. It’s possible that the boot command or environment variables have been altered in a way that is causing this issue. You may need to reset the U-Boot environment to its default settings or adjust the boot command to use a command supported by your U-Boot version.

  5. Manual Boot: As a temporary measure, you can manually boot the kernel from the U-Boot prompt using the appropriate commands supported by your U-Boot version. This involves setting the environment variables to point to your kernel image, device tree blob, and root filesystem, and then using a boot command that is recognized by U-Boot.

If after following these steps you continue to experience issues, it might be necessary to closely review the U-Boot version details and the specific steps you’ve taken during the update process to ensure everything aligns with the requirements for the Colibri iMX8QXP and the version of

Please, also check if these links can help you solve your problem:

Qt for Device Creation (Boot to Qt) | Toradex Developer Center.

Dear @xAnouk,

Thank you for contacting us. While @ToradexAI has given some nice suggestions, I believe the issue might lie in the bootloader. To update from TorizonOS 5 to 6 you have to follow a few specific steps, which are mentioned in here.

Please let me know how you fare with this.

Best regards