meta-toradex-torizon

Torizon OS is an embedded Linux distribution for the Torizon platform. It features, among other essential services, a container runtime and components for secure remote over-the-air (OTA) updates.

This layer provides metadata to build two distinct Torizon OS flavors:

• Torizon: built on top of Toradex's BSP.
• Common Torizon: built on top of BSPs from third-parties.

Building Torizon OS

To build Torizon OS, see the following article:

https://developer.toradex.com/knowledge-base/build-torizoncore

Building Common Torizon OS

Start with the machine-specific build instructions below:

SoC Vendor	Platform / Board	Documentation	Pre-built images
Texas Instruments	AM62x/AM62L/AM62P SK EVM and BeagleY-AI	README-ti.md	Common Torizon OS for TI Machines
NXP	i.MX 95 Verdin EVK and FRDM i.MX 93	README-nxp.md	One-off Common Torizon images available for i.MX 95 Verdin EVK and FRDM i.MX 93
STMicroelectronics	STM32MP1/STM32MP2	README-stm32mp.md	N/A
Synaptics	Astra SL1680/Luna SL1680	README-syn.md	N/A
Renesas	RZ/V2L EVKIT	README-rzv2l.md	N/A
Intel	x86-64	README-x86.md	Common Torizon OS for x86 Machines

If your machine is not listed above or you prefer a manual setup, you can follow these generic steps:

1. Download the layers for the scarthgap branch:

   $ git clone https://github.com/torizon/meta-toradex-torizon.git -b scarthgap-7.x.y
   $ git clone https://github.com/uptane/meta-updater.git -b scarthgap
   $ git clone https://git.yoctoproject.org/git/meta-virtualization -b scarthgap

2. Set up the environment: Source the appropriate script your BSP uses to set up the build environment.

3. Configure your build:

• Add the meta-toradex-torizon layer and its dependencies to your conf/bblayers.conf file.
• Edit conf/local.conf to set the MACHINE you wish to build.
• In the same file, set the distribution to DISTRO='common-torizon'.

4. Build an image: Start building one of the available Torizon images:

• torizon-docker
• torizon-minimal
• torizon-podman (experimental)

Reporting Issues

If you encounter any issues when using or developing Torizon OS, you can open a new issue in this repository's issue tracker or create a new Technical Support topic in the Toradex Developer Community.

Contributing

You may also choose to actively fix issues and bugs or possibly port Common Torizon on new devices. For more details, see CONTRIBUTING.md.

Development Process

Torizon is maintained by the Toradex R&D team. Development happens in this repository, including issues, PRs, and discussions. This repository is then used by our internal CI/CD infrastructure.

We also track issues, bugs and features internally. Because of this, some of the commits and pull requests made by Toradex team members may contain references to internal ticket identifiers e.g. 'Related-to: TOR-3705'.

License

All metadata is MIT licensed unless otherwise stated. Source code and binaries included in tree for individual recipes is under the LICENSE stated in each recipe (.bb file) unless otherwise stated.

This README document is Copyright (C) 2019-2025 Toradex AG.