​
Introduction

​
Why use debug firmware?

Debug firmware is crucial when testing applications, diagnosing issues, or performing deep-level debugging on your TV. It allows developers and testers to capture detailed logs and monitor system behavior, making it easier to identify and resolve issues. You cannot install debug firmware directly over production firmware; a specific installation process is required.

​
Important notes

Firmware types
  • Production Firmware: Versions ending in 1 (e.g., 249.001) are intended for regular user operations.
  • Debug Firmware: Versions ending in 0 (e.g., 249.000) are intended for development and debugging purposes, featuring additional logging and diagnostic tools.
USB drive requirements
  • Use a USB 2.0 drive with at least 4GB of storage.
  • Format the USB drive 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 typically provided is pkg.burn.7z, which contains all necessary files for this transition.
  • Upgrade Pkg File: Used for updating debug firmware when the TV is already running a debug version. This file is typically named upgrade.pkg.

​
Preparing for installation

1

Prepare the USB drive:

Ensure the USB drive is formatted to FAT 32. Download and unzip the necessary files onto the root directory of the USB drive.
2

Power cycling the TV:

To initiate the installation, the TV must be powered off, unplugged, and then reconnected to the power source.

​
Installing debug firmware

This process is used when switching between production and debug firmware.
1

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.
2

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.
3

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.

​
Installing debug firmware on top of debug firmware:

When your TV is already running a debug firmware version, use these steps to update it.
1

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.
2

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.
3

Complete the update:

After the update, remove the USB drive to prevent accidental reinstallation. Navigate to Settings → General Settings → Reinstall to reset the TV.

​
How can I get debug firmware?

To obtain debug firmware for your TV model, contact the app onbarding team. They will provide you with the necessary files.

​
Philips 2024 NT676

There’s a new feature already available for Philips 2024 NT676 in special that doesn’t require the firmware to debug. Follow the next steps to make use of this:
It’s important to mention that this a new feature an it’s currently being tested on some selected devices. If you need any support, please contact our support team.
1

Open the DevView app

If you’re not familiar with DevView, please refer to the How to test on your TV section to learn how to set it up.
2

Navigate to Device Info tab

At the DevView app top menu, click on Device Info tab.
3

Move to the Preferences section

Move to the right to the last card named “Preferences”

Examples of Icons usage in the UI

4

Enable debug mode by pressing OK on your remote control

It should enable the debug mode on this device. From that point your device should becomes visible by chrome inspect.
5

Inspect your app

Inspect your app in the Chrome browser by pointing to the 9222 port.
After doing these steps,