👩‍💻Software Development

Customizing and Developing Applications for ATDM with TorizonOS

This guide covers everything you need to know about customizing the ATDM Operating System and creating applications. The ATDM integrates a Toradex System on Module (SoM) and utilizes TorizonOS, alongside development tools from Toradex. These tools include:

• Customization tools for the Torizon operating system.

• Visual Studio Code-based plugins for application development.

• The Torizon platform for remote monitoring and OTA updates.

Additionally, this document summarizes each hardware feature provided by ATDM and explains how to access these features from application software.

For more information on Torizon, visit the Toradex Torizon website.

TorizonOS Overview

TorizonOS Architecture

This diagram provides an overview of the TorizonOS architecture. For detailed information, please refer to the TorizonCore Technical Overview.

OS Customization

This section explains how to customize TorizonOS using the TorizonCore Builder Tool. The Toradex documentation describes this tool, its installation process, and how to build various output formats.

The TorizonCore Builder Tool allows you to:

• Add pre-provisioned Docker Containers (i.e., your application).

• Set the splash screen.

• Customize hardware settings via a specific device tree for ATDM.

• Add external Kernel modules.

• Customize Kernel arguments.

• Capture configuration from a device, such as network manager settings for the LTE modem.

Creating a Simple Qt Application for ATDM

To demonstrate creating and running a simple Qt application on ATDM using a container in TorizonOS, follow these steps:

Prerequisites

• TorizonCore is installed on your ATDM.

• Docker is installed and running on your development machine.

• Visual Studio Code with Toradex Torizon extension installed.

Step-by-Step Guide

1. Set Up Your Development Environment

   • Open Visual Studio Code.

   • Install the Torizon extension from the Visual Studio Code Marketplace.

   • Connect Visual Studio Code to your ATDM.

2. Create a Qt Application

   • Open the Torizon extension in Visual Studio Code.

   • Select "Create a new Torizon Project".

   • Choose "Qt for Python" as the project type.

   • Follow the prompts to set up your project.

3. Build the Docker Container

   • Open the terminal in Visual Studio Code.

   • Navigate to your project directory.

   • Build the Docker container using the following command:

     docker build -t my-qt-app .

4. Deploy the Application to ATDM

   • Once the Docker container is built, deploy it to your ATDM:

     docker run -d --rm --name my-qt-app-container -p 80:80 my-qt-app

5. Run and Test the Application

   • Access your application through the IP address of your ATDM on the specified port.

   • Verify that the Qt application is running as expected.

Example Code

Here is an example of a simple Qt application you can use:

python import sys
from PyQt5.QtWidgets import QApplication, QLabel

app = QApplication(sys.argv)
label = QLabel('Hello, ATDM with Qt!')
label.show()
sys.exit(app.exec_())

Summary

This guide has shown you how to customize the TorizonOS on ATDM and create a simple Qt application to run in a Docker container. By following these steps, you can leverage the powerful tools provided by Toradex to develop and deploy applications on your ATDM devices.

For more detailed customization options and additional features, refer to the TorizonCore Builder Tool documentation.