Boot Toradex via SSD Card

Technical Support
1

I am trying to boot our project GUI through SD-Card and I followed the below steps to load sd card with the boot files.

The image load fails with the error “Failed to load 'my-custom-devicetree.dtb”

image
image1177×808 79.8 KB

please advice how to solve this.
Thank you.

2

Hi, I’m the Toradex AI Assistant.

I might make mistakes. Our support team will step in if needed. If I answered your question, please tick the “Solution” checkbox. For follow-up questions to me, please use @ToradexAI in your post.

Did you like my answer? :+1: :-1:

Hello! Thank you for reaching out.

The error message “Failed to load ‘my-custom-devicetree.dtb’” suggests that U-Boot is unable to find or access your custom device tree file during the boot process from the SD card. Here are the steps to troubleshoot and resolve this issue:

1. Verify the Device Tree File on the Boot Partition

  • Make sure your custom device tree binary file (my-custom-devicetree.dtb) is properly compiled and present in the boot partition of your SD card.
  • The file name must exactly match the one specified in your U-Boot environment or boot script (including capitalization).

2. Check the Boot Partition Contents

  • Mount the boot partition of your SD card on your Linux host PC and list the files. The device tree binary should be present.
    ls /mnt/boot/
    • If missing, re-extract your image, making sure to include the device tree:
      sudo tar xf <image-name>.bootfs.tar.xz --no-same-owner -C /mnt/boot
      (Reference)

3. Confirm Filename Consistency

  • The device tree name in U-Boot or extlinux.conf must perfectly match your .dtb file name.
  • If unsure, you can directly copy your device tree file (replace placeholder values as needed):
    scp my-custom-devicetree.dtb root@<target-ip>:/media/boot/
    (Reference)

4. Verify U-Boot SD Card Partition Detection

  • On the U-Boot command line (via serial console), run:
    mmc dev 1; mmc part
    This checks if U-Boot can see your SD card partitions properly.
    (Reference)

5. Summary of Key Areas to Check

  • The .dtb file exists in the boot partition.
  • The filename exactly matches the expected name.
  • U-Boot can access the SD card and see its partitions.

If problems persist, please let me know:

  • Which Toradex module you are using
  • The exact name of your device tree file
  • The full list of files in the boot partition (output of ls)

This will help further analyze the issue.

Best regards,
Toradex AI Assistant.

Useful Links:

3

Hi @Kalpana!

Did you customize the entire device tree? We recommend using our standard device tree and creating Device Tree Overlays to customize it. Have you tried overlays?

Best regards.