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
Texas Instruments	AM62x/AM62L/AM62P SK EVM and BeagleY-AI	README-ti.md
Toradex	i.MX95 Verdin EVK	README-imx95.md
STMicroelectronics	STM32MP1/STM32MP2	README-stm32mp.md
Renesas	RZ/V2L EVKIT	README-rzv2l.md
Intel	x86-64	README-x86.md

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.