===== Android TV =====

==== Objective ====

This documentation explains how to:

  * Enable developer mode
  * Enable ADB debugging (USB / Wi-Fi)
  * Connect to an Android screen via ADB
  * Deploy an APK (e.g., Zebrix Agent)
  * Configure the driver in Zebrix Control

==== Prerequisites ====
 
  * Android screen (e.g., Samsung WAF – Android 14)
  * PC with ADB installed
  * Screen and PC on the same network
  * Download the [[https://control.zebrix.net/download/apk_android/app_release.apk|APK]] to deploy

==== 1. Access system information ====

Go to **Settings → About tablet**

Identify:
  * System version
  * Build number

{{ .:pasted:20260422-155956.png?800 }}

==== 2. Enable developer mode ====

Click **7 times on "Build number"**

Result:
  * The message "You are now a developer" appears
  * The "Developer options" menu is enabled

{{ .:pasted:20260422-155956.png?800 }}

==== 3. Access developer options ====

Go to **Settings → System → Developer options**

Enable:
  * Use developer options
  * USB debugging

{{ .:pasted:20260422-160209.png?800 }}

==== 4. ADB connection ====
From your PC:

  * Install **ADB**
  * Download the [[https://control.zebrix.net/download/apk_android/app_release.apk|APK]] to deploy
Open a command prompt and run:

<code bash>
adb connect IP
</code>
or
<code bash>
adb connect IP:PORT
</code>

Example:

<code bash>
adb connect 192.168.1.1:5555
</code>

==== 5. Verification ====

Use the following command to verify the connection between your PC and the screen:

<code bash>
adb devices
</code>

Expected result:

<code>
192.168.1.1:5555    device
</code>

⚠️ If "unauthorized":
  * Check the screen
  * Accept the debugging request

==== 6. APK installation ====

Use the following command to install the APK:

<code bash>
adb -s 192.168.1.1:5555 install "{path}\app-release.apk"
</code>

Update:

<code bash>
adb -s 192.168.1.1:5555 install -r "{path}\zebrix-agent.apk"
</code>

Once the installation is complete, launch the application manually on the display or using adb:
<code bash>
.\adb.exe -s 192.168.1.1:5555 shell am start -n net.zebrix.agent/.ui.MainActivity
</code>

Then, from your command prompt, run:

<code bash>
# Brightness
.\adb.exe -s 192.168.1.1:5555 shell appops set net.zebrix.agent WRITE_SETTINGS allow

# Read the currently displayed input source (required for input_source)
.\adb.exe -s 192.168.1.1:5555 shell appops set net.zebrix.agent GET_USAGE_STATS allow
.\adb.exe -s 192.168.1.1:5555 shell am force-stop net.zebrix.agent
.\adb.exe -s 192.168.1.1:5555 shell am start -n net.zebrix.agent/.ui.MainActivity

# Device Administrator — required for sleep mode and screen locking
.\adb.exe -s 192.168.1.1:5555 shell dpm set-active-admin net.zebrix.agent/.service.ZebrixDeviceAdminReceiver

# Device Owner — required for reboot and set_time (cannot be configured without ADB)
.\adb.exe -s 192.168.1.1:5555 shell dpm set-device-owner net.zebrix.agent/.service.ZebrixDeviceAdminReceiver
</code>

==== Configuration in Zebrix Control ====

Configure the screen driver as follows:

{{.:pasted:20260724-084223.png}}

Your equipment is now configured.