Solución de problemas y procedimientos de diagnóstico
Flujos de diagnóstico, tabla de códigos de error, solución para PIN de términos y herramientas CLI.
- Check TV Network State: Is the TV in deep eco-sleep or can it be reached on your LAN? (VIDAA TVs disable network chips in deep standby unless Fast Power On / Network Wake is enabled).
- Inspect Inicio Assistant Repairs: If session tokens were invalidated, an alert will appear in Settings → Repairs.
- Toggle Debug Logging: Flip
switch.<tv_name>_debug_loggingto stream raw MQTT frames directly into Settings → System → Logs.
⚠️ Referencia de errores de acción de servicio
| Error Message | Root Cause | Resolution |
|---|---|---|
Failed to send key {key}: {error} |
TV is disconnected in deep sleep or invalid key name passed. | Wake the TV with WoL first, or verify key name matches standard aliases (e.g. home, menu, back, ok). |
Channel digits must contain numbers only |
vidaa.change_channel received non-numeric characters. |
Provide only integer digits or dot-separated channel numbers (e.g. 10, 70, 7.1). |
Failed to send channel confirmation key |
TV did not acknowledge the trailing confirmation key. | Increase digit_delay in the service call (e.g. digit_delay: 0.5) to allow slower TV tuners to buffer digits. |
Failed to launch app {app_name} |
App is not installed on this TV, or TV OS rejected launch payload. | Verify app is installed and visible in the native app launcher. Check source_list on media_player.<tv_name> for exact names. |
Failed to set picture setting |
Picture preset value out of range or not supported on this model. | Use built-in UI selects (select.<tv_name>_picture_mode) to test supported presets. |
Failed to set sound setting |
Sound mode locked or ARC / eARC soundbar is controlling audio presets. | If external AV receiver / soundbar is connected over eARC, TV audio equalizer presets are managed by the soundbar. |
Failed to send text input |
On-screen keyboard dialog or search bar is not active. | Ensure an active text input search bar is open on screen (e.g. in YouTube search or browser) before calling vidaa.send_text_input. |
📺 Problema 1: El diálogo del PIN de 4 dígitos no aparece
If you enter your TV's IP address in Inicio Assistant but no 4-digit code appears on your television display:
VIDAA OS suppresses on-screen pairing PIN popups if Smart / Connected Services are disabled. To resolve:
- On your physical TV remote, press Settings (Gear).
- Navigate to Support (or System) → Terms & Conditions (or Connected Services).
- Accept the terms of service and ensure connected smart features are turned ON.
- Retry pairing in Inicio Assistant—the 4-digit PIN dialog will pop up instantly!
(Privacy Note: Once pairing is completed, you can safely block internet/WAN access at your router firewall; local Inicio Assistant control operates completely offline).
💤 Problema 2: La TV aparece como "no disponible" al apagarse
VIDAA televisions shut down their main motherboard and Wi-Fi chip in deep standby to satisfy EU ≤ 0.5W eco regulations. The entity will report unavailable because no TCP connection can be maintained while the hardware is powered down.
⚡ Solution A: Enable Fast Power On
Go to Settings → System → Advanced Settings → Fast Power On → ON.
The TV SoC remains in a low-power listening state, waking instantly over local MQTT.
📡 Solution B: Configure Wake-on-LAN
1. In TV menu: Settings → Network → Wake on LAN / Mobile App Turn On → ON.
2. In Inicio Assistant: Configure → Enable Wake-on-LAN with burst count 3–5.
🧪 Herramientas de diagnóstico CLI independientes
The integration includes two standalone Python diagnostic scripts inside the repository's scripts/ folder. You can run these from any machine without starting Inicio Assistant:
1. test_client.py: Non-Invasive Network & Handshake Probe
Tests network reachability, verifies mutual TLS certificates, and inspects UPnP service descriptors:
python3 scripts/test_client.py --host 192.168.1.50 --cert /config/ssl/client_mobile_android.p12
2. debug_tv.py: Live MQTT Payload Monitor
Monitors raw state changes, dumps installed TV app IDs, and outputs pre-formatted Markdown blocks for reporting issues on GitHub:
python3 scripts/debug_tv.py --host 192.168.1.50 --apps --report