Deploy a custom image to Mallow Carrier board - Verdin

Technical Support
1

Hi Team,

I am currently working on a project using Verdin iMX8MP SoM module with Mallow Carrier board.

As first step, I have followed the Quick Start Guide to set up the non-WiFi configuration on the board and installed the Multimedia image through Easy Installer.

Start Quickstart | Toradex Developer Center

I could see various images displayed on the HDMI.

Now I am trying to customize the OS based on the guidelines provided in the link below.

Customize Torizon OS Images | Toradex Developer Center

As an initial step, I am working on splash screen customization. I have successfully downloaded the Linux kernel, then device tree overlays and then Torizon OS. I have created the .yaml file and made the necessary changes as per the instructions in the link. The build process was successful, and the output was generated as torizon-docker-verdin-imx8mp.ota.tar.zst.

Now I am trying to deploy the custom image to the Carrier board through SSH. However, I encountered an issue with the first SSH command: 'images unpack,’ which is not working as expected.

Could you please review the steps I have taken so far and advise if they are correct?

Additionally, I need your guidance on the next steps to flash the custom image to the board through SSH.

Thanks,
Preethi

2

Hi, I’m the Toradex AI Assistant.

I might make mistakes or occasionally get you wrong. Our support team will step in if needed.

Hello Preethi,

Great progress on your customization work with the Verdin iMX8MP and Mallow Carrier board! I can help you with the SSH deployment process.

Review of Your Steps

Your approach so far looks correct (1):

  • Downloaded the Linux kernel and device tree overlays
  • Downloaded Torizon OS image
  • Created the YAML configuration file
  • Successfully built the custom image generating torizon-docker-verdin-imx8mp.ota.tar.zst

SSH Deployment Process

For SSH deployment, you need to follow these specific steps (1):

Step 1: Unpack Your Custom Image

First, you need to unpack the generated image folder (not the .tar.zst file). The command should target the folder that was generated during the build process (1):

torizoncore-builder images unpack torizon-docker-verdin-imx8mp-Tezi_7.3.0+build.18/

(1)

Important: Use the folder path, not the .ota.tar.zst file. The folder should have been created alongside the .ota.tar.zst file during your build process (1).

Step 2: Deploy to Your Board

Once the image is unpacked, deploy it to your board (1):

torizoncore-builder deploy --remote-host <BOARD-IP> --remote-username <USERNAME> --remote-password <PASSWORD> --reboot

(1)

Note: Starting with TorizonCore Builder 3.1.0, the default values for --remote-username and --remote-password are torizon, so if either the username or password is torizon, you can omit the corresponding argument (1).

Important Limitations

Please be aware that SSH deployment has some limitations (1):

  • This operation only alters the OSTree, so it does not support deploying pre-provisioned containers (1)
  • The deployment transfers only the missing objects to the board via SSH and registers the new commit for the next boot (1)

Alternative Deployment Methods

If you encounter issues with SSH deployment, you can also use (1):

  • Toradex Easy Installer: Copy the generated folder to a USB stick
  • Torizon Cloud: Push the image to Torizon Cloud for remote deployment

Let me know if you need clarification on any of these steps or encounter specific error messages!

Best regards, Toradex AI Assistant.

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

If I answered your question, please tick the “Solution” checkbox.

For follow-up questions to me, please use @ToradexAI in your post.

3

Greetings @PreethiT,

Your post is a bit confusing and has some contradictory information.

First of all, you said you installed our multimedia image:

As first step, I have followed the Quick Start Guide to set up the non-WiFi configuration on the board and installed the Multimedia image through Easy Installer.

But then, later in your post you talk about Torizon OS. So which OS software are you using exactly? These are different.

You say you’re trying to do splash screen customization, but then talk about Linux kernel, and device tree overlays:

As an initial step, I am working on splash screen customization. I have successfully downloaded the Linux kernel, then device tree overlays and then Torizon OS.

These thing are not needed if you’re just changing the splash screen.

The build process was successful, and the output was generated as torizon-docker-verdin-imx8mp.ota.tar.zst.

The output should have been a directory not a single file.

Now I am trying to deploy the custom image to the Carrier board through SSH. However, I encountered an issue with the first SSH command: 'images unpack,’ which is not working as expected.

What was the issue exactly?

Please clarify these details and exact steps otherwise it’s difficult for us to determine what you are exactly doing.

Best Regards,
Jeremias

4

Hi

The multimedia image was to test the board is functioning as per the Quick start guide.

My aim is to customize the Torizon OS. As a first step I am trying Splash screen customization.

I have the necessary details to build the OS like Linux, device tree overlays, .yaml file. Though these are not required for Splash screen, it was mentioned in the manual that these are required for build process. Now I have successfully built the OS. As you mentioned, there is a directory containing multiple files.

Now I need to flash this image to the board. I thought of trying through SSH, but the manual mentioned there has to be a Torizon OS in the board after which I can deploy the custom image to the board. The board actually has multimedia image (Wayland).

So I thought of trying through USB. I have few queries with USB process. I have a output directory with .json, .png, .html, .sh, .ota.tar.zst. Should I transfer the complete directory to USB and flash through Easy Installer. Or what is the correct method?

Thanks

5

Should I transfer the complete directory to USB and flash through Easy Installer. Or what is the correct method?

Transfer the entire output directory to a USB and use Toradex Easy Installer to flash the customized OS image.

Best Regards,
Jeremias