Search by Tags

Torizon

 

Introduction

Torizon is a new Linux-based software platform that simplifies the process of developing and maintaining embedded software. It allows you to configure the system for your use case quickly and easily, so you can focus on application development instead of Linux builds.

Requirements

Torizon fully supports the following modules, which use eMMC as flash storage:

Resources

Browse for Torizon resources from the tabs below.

Partner Demo Containers

To leverage the flexibility of the Torizon platform, Toradex partners with software companies from different industry segments and technologies to offer you Partner Demo Containers. Those containers are ready-to-run demonstrations with out-of-the-box compatibility to both Toradex hardware and the Torizon platform.

           Partner Demo Container Brief Description
XNOR.ai AI solutions XNOR.ai AI2GO Object Detector Demonstration on how to use the XNOR.ai AI2GO self-service solution
Codesys Codesys Codesys PLC Runtime CODESYS programmable logic controller (PLC) demo runtime on a Torizon container and how to use it
Crank Crank Software Crank Storyboard Crank Storyboard allows you to build an embedded systems optimized, rich GUI on a cross platform IDE

How to Start

Follow our Step-by-step Getting Started Guide for fully supported modules as an overview step to get you set up in no time.

After you have completed it, check the other tabs from the current article, where you can find a list of Torizon features as well as a list of related articles.

Installation

TorizonCore is installed via the Toradex Easy Installer that comes pre-installed in Toradex SoMs from factory. Install the TorizonCore image with Docker runtime:


  • Install TorizonCore image with Docker runtime

    Install TorizonCore image with Docker runtime

Upon booting one can login on the serial console (debug UART) or from the network via SSH using the following user and password:

  • User: torizon
  • Password: torizon

On the first login, you are prompted to change the default password. You can then execute commands as root with sudo <command> or gain root access from within the Linux shell with sudo su.

Additional Resources

Check out ongoing projects on Toradex Labs:

Torizon is an embedded computing platform that makes it easy to develop robust and scalable products. An initial overview is provided in the Torizon page on the Toradex website. The main Torizon component is TorizonCore: a minimal embedded Linux image that has the base for OTA services and an optional container runtime.

TorizonCore binary images are provided by Toradex with different configuration options. Whenever possible you should use TorizonCore image with Docker runtime:

Image Description
TorizonCore image with Docker runtime Full-featured image containing Docker and OTA. The preferred image, provides the full Torizon experience.
TorizonCore image minimal image only containing OTA. Can serve as a base for customers building custom images using OpenEmbedded and planing to leverage TorizonCore update system.

All images above have a Linux kernel built with and without PREEMPT_RT real-time patch applied. The versions with PREEMPT_RT are experimental. A chart illustrating the variations and the relation between them is provided below:


  • TorizonCore Images

    TorizonCore Images - click to see in full resolution

The latest builds can be obtained by enabling the Toradex Continous Integration (CI) Server feed in the Toradex Easy Installer Feeds dialog, and some images or variants from the table above may be availble only in the CI server.

Containers

Docker containers are the base in which Torizon relies for application development. You are able to run any image built for your respective module's architecture. Along with TorizonCore we provide a default container as a sort of friendly starting environment.

Torizon OTA

TorizonCore is built with Over-The-Air Updates capabilities and Torizon also provides server-side capabilities. The overview is provided in a separate article:

Device Tree Overlays

The traditional device tree development and deployment process is laborious. Torizon uses device tree overlays hoping to somewhat streamline this process. With overlays, you just create a small snippet containing the hardware changes you need.

Additional Information

  • The full image is quite minimal featuring basic command line utilities.
  • The kernel itself is following mainline.
  • There is no package management in the base system.
  • Docker containers can be used to acquire other features.
  • The minimal image is even more bare-bones containing just the bare minimum to support OTA.

TorizonCore Release Details and Roadmap

Toradex provides a public release roadmap for the TorizonCore platform:

  • Image Space limitation

The full-featured image is rather large taking up most of the space on the raw NAND-based modules. As such it is not recommended to experiment with containers on these devices since there isn't much space for containers as is. In the future, we hope to slim down the footprint. Alternatively, the Balena based image is slimmer by about ~70MB, although fully unsupported by Toradex.

  • Xorg video driver

In our i.MX6-based Debian containers we are using the Armada X.org DDX driver which seems to have worked fine in our tests but, it might show stability issues.

  • Error "No session for pid" on container startup

The error is probably related to missing session management inside the container.

  • Image not booting properly

Make sure to clear the U-Boot environment by using env default -a && env save. If resetting the U-Boot environment does not help, use setenv tdxargs loglevel=7 to enable kernel debug messages. Also setenv tdxargs "loglevel=7 earlycon" can help to initialize a console during very early boot and thus see debug output in case the kernel crashes very early during boot.