Torizon OTA allows customers to push their own customized versions of TorizonCore to our hosted service. It means that, after customizing the image, you must sign and push it to Torizon OTA.
In this article, you will learn how to use the TorizonCore Builder Tool, the recommended way to customize a TorizonCore image, sign it, and push the image to Torizon OTA, so the system update can be initiated there.
Warning: This feature is not publicly enabled on the server-side to all customers at the moment, if you have interest in doing it, please contact us.
Request Access to Uploading TorizonCore Custom Images to Torizon OTA
This article complies to the Typographic Conventions for Torizon Documentation.
The prerequisites to complete these instructions are:
.tar
file containing the TorizonCore Image with no-container pre-provisioned for offline installation.credentials.zip
file downloaded from your account on the Torizon OTA dashboard.splash.png
, like this one (Obs.: the splash screen image needs to be a png file with a maximum size of your screens resolution - typically a resolution around 600x400 is used).Make sure your working directory has the following structure, including credentials.zip
, splash.png
and a directory called image
containing the uncompressed TorizonCore installation image:
$ tree
.
├── credentials.zip
├── image
│ ├── image.json
│ ├── marketing.tar
│ ├── prepare.sh
│ ├── SPL
│ ├── toradexlinux.png
│ ├── torizon-core-docker-apalis-imx6.ota.tar.zst
│ ├── u-boot.img
│ ├── u-boot-initial-env-spl
│ └── wrapup.sh
└── splash.png
Also make sure you can run TorizonCore Builder:
$ torizoncore-builder --help
Let's change a TorizonCore image, applying a custom splash screen.
First, unpack the TorizonCore installation image inside the TorizonCore Builder docker volume, so the image can be customized:
$ torizoncore-builder unpack --image-directory image/
Apply the custom splash screen image:
torizoncore-builder splash --image splash.png
Now create a new TorizonCore OSTree image:
torizoncore-builder union --union-branch my-custom-image
Note: For a more detailed description of unpack
, union
and other TorizonCore Builder commands, see TorizonCore Builder Tool article.
The command push
from TorizonCore Builder can be used to push a new TorizonCore image to Torizon OTA.
The command requires the credentials.zip
file from Torizon OTA and a reference to the OSTree repository that should be pushed to the OTA server.
torizoncore-builder push --credentials <credentials file> <ostree reference>
In our example, the OSTree reference is called my-custom-image
(defined in the union
command above), so the command below will push the customized image to Torizon OTA:
torizoncore-builder push --credentials credentials.zip my-custom-image
Now, if you log in to Torizon OTA and initiate an update, you should see the customized image, ready to be used to update a device:
And, if everything went fine with the update, you shall see your board rebooting when the process is completed, and the splash screen showed in the device initialization will be the one defined in the new image.