Custom tezi image

Technical Support
,
1

Hi support,

I have a question about a tezi. From the guide I can’t understand if it is possible to insert a custom DTS overlay into Tezi. If possible, what should i do for create a tezi image custom ?

Thanks

Fabio

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.

Yes, you can absolutely create a custom Tezi (Toradex Easy Installer) image with custom device tree overlays(1). Here’s how to do it:

Using TorizonCore Builder

The recommended method is to use the TorizonCore Builder Tool with the build command(1)(2). This creates a custom Torizon OS image with your specified device tree overlays, ready to be installed with Toradex Easy Installer(1).

Configuration File Approach

Create a configuration YAML file (tcbuild.yaml) that specifies your custom overlay(1)(2):

# Sample configuration file:
input:
 easy-installer:
 local: images/torizon-core-docker-colibri-imx6-Tezi_5.3.0+build.7.tar
#Sample customization: insert the resistive 7" display overlay in the IMX6 device-tree with Aster Carrier Board
customization:
 device-tree:
 include-dirs:
 - device-trees/include/
 custom: device-trees/dts-arm32/imx6dl-colibri-eval-v3.dts
 overlays:
 add:
 - device-trees/overlays/display-edt7_overlay.dts
output:
 easy-installer:
 local: torizon-core-docker-colibri-imx6-Tezi_5.3.0.CUSTOM

(1)

Required Setup

  1. Install TorizonCore Builder following the installation guide(1)(2)

  2. Clone the necessary repositories(1)(2):

For i.MX 8/8X/8M Mini/8M Plus:

git clone -b toradex_6.6-2.2.x-imx git://git.toradex.com/linux-toradex.git linux
git clone -b toradex_6.6-2.2.x-imx git://git.toradex.com/device-tree-overlays.git device-trees

(1)(2)

For i.MX 6/6ULL/7:

git clone -b linux-6.6.y git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
git clone -b master git://git.toradex.com/device-tree-overlays.git device-trees

(1)(2)

  1. Build the custom image(1)(2):
torizoncore-builder build

(1)(2)

Alternative: Single Command Approach

For quick testing, you can also apply an overlay directly to a running device with a single command(1):

torizoncore-builder dto deploy --remote-host 192.168.1.117 --remote-username torizon --remote-password torizon --force --reboot device-trees/overlays/display-edt7_overlay.dts

(1)

Output

Both approaches generate a custom Toradex Easy Installer image as output(1). This image can then be deployed using standard Toradex Easy Installer procedures(2).

The build command is the recommended approach for production programming and CI/CD pipelines(1), while the single command approach is better suited for evaluation and prototyping(1).

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

Hello @fmolon,

Are you trying to build a custom Toradex Easy Installer image or a custom BSP/Torizon OS image? Also, for which module are you building the image for? Which guide are you following? If you are building a custom Toradex Easy Installer (TEZI) image, could you please specify the use-case? This will help me give you the right solution.

4

Hi @rudhi.tx,

i am trying to build a custom TEZI. I would like to create a custom Tezi image. In particular, I would like to modify the overlays.txt file that is part of Tezi. I need to add my own custom DTS overlay file so that Tezi is displayed on an LVDS display instead of HDMI.

5

Hi @fmolon,

Instructions on how to modify/customize a tezi image are on the document I linked earlier. I noticed that it does not show an example for how to add a custom device tree overlay specifically. I did some investigation. Here is how I would approach it:

  1. Compile your device tre eoverlay: dtc -@ -I dts -O dtb -o my-lvds_overlay.dtbo my-lvds_overlay.dts. You need to use the right linux staging kernel for this first of all.
  2. Add it into your tezi.its file. You can follow the example on the articke, however you can also decompile the current FIT image into an ITS source and check how other dtbo files are added: dtc -I dtb -O dts -o tezi.its tezi.itb. You don’t have to add the data as binary but just its path (like in the example in step 3) would be sufficient.
  3. Extract all images and rebuild tezi.itb.
  4. You can verify that your overlay was added with dumpimage -l tezi.itb | grep my-lvds.
  5. Edit overlays.txt file to add your overlay. You should remove the other display overlays (verdin-imx8mp_hdmi_overlay.dtbo, verdin-imx8mp_dsi-to-hdmi_overlay.dtbo) to avoid conflicts.

In case you are not aware, you can also access the GUI of TEZI using a VNC viewer on your development PC (either connected to the board via USB RNDIS or using the IP address of the board - if you know the IP), or you can even access tezi on serial console using tezictl commands. Therefore, unless you have strong reasons to view the GUI of TEZI on the connected displays, I would not go into the hassle of building a custom TEZI.

6

Hi @rudhi.tx,

tbanks for the support