# Over The Air Updates

**Overview of Torizon OTA** Torizon is a secure, easy-to-use Linux-based software platform from Toradex that simplifies the development and maintenance of embedded systems. It offers a wide range of features, including container support with Docker, remote monitoring, and over-the-air (OTA) updates. OTA updates allow you to remotely deploy updates to your devices, ensuring they always have the latest features, security patches, and bug fixes.

**Benefits of using OTA with ATDM** Integrating Torizon's OTA capabilities with the Advanced Telematics Display Module (ATDM) ensures that your telematics devices remain up-to-date with minimal manual intervention. This integration provides:

* **Reliability**: Ensure consistent performance and dependability across remote applications.
* **Security**: Maintain the latest security patches and updates, reducing vulnerability risks.
* **Efficiency**: Save time and resources by automating the update process.

**Prerequisites** Before you begin, ensure you have the following:

* An ATDM device with TorizonCore installed
* A Torizon account
* Basic knowledge of Docker and embedded Linux
* Development environment setup (Docker, Torizon Visual Studio Code Extension, etc.)

**Setting Up Your Environment**

**Required tools and software**

* **TorizonCore Installer**: To install the Torizon operating system on your ATDM device.
* **Docker**: To create and manage containers for your applications.
* **Torizon Visual Studio Code Extension**: To facilitate development and deployment.
* **ATDM device**: The target hardware for your application.

**Installing TorizonCore on your ATDM**

1. **Download the TorizonCore Installer** from the Toradex website.
2. **Connect your ATDM device** to your development machine via USB or network.
3. **Run the TorizonCore Installer** and follow the on-screen instructions to install TorizonCore on your ATDM device.
   * Ensure that your device is properly detected by the installer.
   * Select the appropriate TorizonCore image for your ATDM device.
   * Complete the installation process and reboot your device.

**Setting up your development environment**

1. **Install Docker** on your development machine. Follow the instructions for your operating system on the Docker website.
2. **Install the Torizon Visual Studio Code Extension**:
   * Open Visual Studio Code.
   * Go to the Extensions view by clicking the Extensions icon in the Activity Bar on the side of the window.
   * Search for "Torizon" and install the Torizon extension.
3. **Connect to your ATDM device** from Visual Studio Code:
   * Open the Torizon extension.
   * Add your ATDM device's IP address or hostname.
   * Verify the connection by checking the device status in Visual Studio Code.

**Deploying Your Application Using OTA**

**Creating an OTA update package**

1. **Develop your application** for the ATDM device using your preferred tools and frameworks.
2. **Create a Dockerfile** for your application. Here is an example Dockerfile:

   ```dockerfile
   dockerfile FROM torizon/debian:2
   WORKDIR /app
   COPY . .
   RUN apt-get update && apt-get install -y \
       python3 \
       python3-pip \
       && rm -rf /var/lib/apt/lists/*
   RUN pip3 install -r requirements.txt
   CMD ["python3", "main.py"]
   ```
3. **Build your Docker image**:

   ```sh
   docker build -t my-atdm-application .
   ```
4. **Test your Docker container** locally to ensure it runs correctly:

   ```sh
   docker run -it my-atdm-application
   ```

**Uploading your package to Torizon**

1. **Log in to your Torizon account** on the Torizon website.
2. **Navigate to the OTA section** in your Torizon dashboard.
3. **Upload your Docker image** to Torizon:
   * Go to the "Images" tab.
   * Click "Upload Image" and select your Docker image file.
4. **Create an update package**:
   * Go to the "Packages" tab.
   * Click "Create Package" and follow the prompts to include your uploaded Docker image.

**Scheduling and managing OTA updates**

1. **Schedule the update deployment time**:
   * Go to the "Deployments" tab in your Torizon dashboard.
   * Click "Create Deployment" and select your update package.
   * Choose the target devices (your ATDM devices) and schedule the deployment time.
2. **Monitor the update process** through the Torizon dashboard:
   * Track the deployment status in real-time.
   * Check for any errors or issues during the deployment.
3. **Verify the successful deployment** on your ATDM device:
   * Ensure the application is running correctly.
   * Check the device status and logs for any anomalies.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://andromeda-interfaces-inc.gitbook.io/andromeda-interfaces/advanced-telematics-display-module/over-the-air-updates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.