> ## Documentation Index
> Fetch the complete documentation index at: https://docs.titanos.tv/llms.txt
> Use this file to discover all available pages before exploring further.

# Firmware

## What is a Firmware?

Firmware is the software that is permanently programmed into the TV hardware. It provides the low-level instructions the device needs to function.

Unlike applications, which are easily installed, firmware is tightly linked to the device's hardware and requires a more careful installation process. It handles core functions like starting up the device and controlling basic hardware components.

## Firmware use cases

A firmware file is necessary for specific development and diagnostic tasks that are not possible in a standard production environment.

A firmware file is typically only required for a few key use cases:

* **Legacy Devices:** Testing applications on Philips devices from 2020 to 2022.
* **System Diagnostics:** Capturing detailed system logs, monitoring TV behavior, and diagnosing issues.
* **Deep-Level Debugging:** Performing advanced debugging that requires a dedicated environment.
* **Version Updates:** To manually update a development or production firmware to a specific version.
* **Support:** If requested by the Titan OS support team to investigate system issues.

With the exception of option one (about testing applications on Philips devices), the other options are only necessary if requested by the support team.

## Philips devices

### How to check your current firmware

On your Smart TV, go to: Configuration > Update Software > Current software info. The version number will indicate if it's a production or debug version.

| **Production Firmware**                       | **Debug Firmware**                                                                 |
| :-------------------------------------------- | :--------------------------------------------------------------------------------- |
| **Versions ending in `1`** (e.g., `249.001`). | **Versions ending in `0`** (e.g., `249.000`).                                      |
| Intended for regular user operations.         | Intended for development and debugging, with additional logs and diagnostic tools. |

### How to Get a Firmware File

A firmware file is only available for partners who are in the process of onboarding (certification) or have a commercial agreement with Titan OS.

To obtain the debug firmware for your TV model or to get more details on how to get this support, please contact the Titan OS Partner Support Team at [apponboarding@titanos.tv](mailto:apponboarding@titanos.tv).

### Preparing for installation

**USB drive requirements**

* **USB 2.0** drive with at least **4GB**
* Ensure the USB drive is formatted to **FAT 32**
* Ensure the USB drive remains connected to the TV throughout the process

**File types and their usage**

* **Pkg Embedded File**: Used when switching from production firmware to debug firmware, or vice versa. The file provided is named `pkg.burn.7z`, and it contains all necessary files for this transition.
* **Upgrade Pkg File**: Used for updating the firmware version. This file has the extention `upgrade.pkg`.

### Installing a Debug Firmware

This process is used when switching between production and debug firmware (or vice versa).

<Steps>
  <Step title="Download and prepare files:">
    Download the `pkg.burn.7z` file and extract its contents. Copy all the
    extracted files to the root directory of your prepared USB drive.
  </Step>

  <Step title="Initiate the firmware installation:">
    Power off the TV by unplugging it from the AC outlet. Insert the USB drive
    into one of the TV's USB 2.0 ports. Press and hold the joystick power key
    located beneath the remote control sensor on the TV. While holding the key,
    plug the TV back into the AC outlet. Hold for about 10-15 seconds before
    releasing. The TV will perform an "empty burning" process, installing the
    debug firmware.
  </Step>

  <Step title="Finalize the installation:">
    Once the process is complete, remove the pendrive and manually unplug and
    replug the TV. Navigate to **Settings → General Settings → Reinstall to
    reset the TV**.
  </Step>
</Steps>

### Updating Firmware

<Steps>
  <Step title="Download and rename the firmware file:">
    Download the correct debug firmware file for your TV model. Ex:
    `PH_2K24_ALL_EU_NT72690_TPN246E_V246.004.147.110_upgrade.pkg` Rename the
    file to `upgrade.pkg`.
  </Step>

  <Step title="Install the firmware:">
    Copy the `upgrade.pkg` file to the root directory of the USB drive. Insert
    the USB drive into the TV. Unplug and replug the TV from the power source to
    start the update automatically.
  </Step>

  <Step title="Complete the update:">
    After the update, remove the USB drive to prevent accidental reinstallation.
    Navigate to **Settings → General Settings → Reinstall to reset the TV**.
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="Debbuging your app" icon="rectangle-code" href="/debugging">
    Larn how to debug apps in Titan OS devices
  </Card>

  <Card title="Accessibility" icon="tv" href="/accessibility">
    Learn how to get started to the new accessibility functionalities in TitanSDK
  </Card>
</CardGroup>