Konfigurations- und Optionsparameter

Vollständige Referenz für Einrichtungsparameter, Optionen-Flow, unterstützte Entitäten und bekannte Einschränkungen.

100% Lokale Push-Architektur (`iot_class: local_push`)

The VIDAA Smart TV integration operates with pure local push telemetry. Startseite Assistant maintains a persistent TLS MQTT socket connection directly to the TV hardware on port 36669. No polling loops run for power state, volume, active app, or input sources. The TV broadcasts live state changes over MQTT in real-time as physical remote keys are pressed.

📱 Unterstützte Entitäten & Plattformen

During setup, the integration discovers and registers entities across 9 Startseite Assistant platforms:

Platform Entity Class Features & Telemetry
media_player MediaPlayerDeviceClass.TV Power toggle, volume step/slider, mute, source input switcher, app launcher, transport controls (Play, Pause, Stop, Weiter, Zurück), dynamic app artwork, track/channel stepping, and Apple StartseiteKit virtual remote mapping.
remote RemoteEntity Discrete key press execution, multi-key sequence dispatching (vidaa.send_key_sequence), repeat burst counts, and custom inter-key delays.
sensor SensorEntity Active Source, Active App, Audio Output Routing (TV Speakers vs ARC/eARC), Session Status, Auth Profile, Brand Profile, and Hardware Clock Drift offset (>60s threshold).
binary_sensor BinarySensorEntity Live MQTT Broker Connection state and In Use indicator.
button ButtonEntity Sync TV Clock, Force Reconnect, Probe Capabilities, and Trigger Re-pairing diagnostic buttons.
switch SwitchEntity Debug Logging dynamic toggle and Audio Only (turn off panel backlight while keeping audio playing).
select SelectEntity Picture Mode (Standard, Cinema Day, Cinema Night, Dynamic, Sports, Game, Filmmaker Mode) and Sound Mode (Standard, Theatre, Music, Speech, Late Night, Sports).
number NumberEntity Real-time picture calibration sliders for Backlight, Brightness, and Contrast (0–100).

⚠️ Bekannte Hardware- & Firmware-Einschränkungen

  • No ICMP Ping in Deep Standby: Most VIDAA TVs power down their ICMP ping responder in low-power sleep (fake_sleep_0). Generic ping binary sensors will report the TV as offline even though it can be awakened.
  • Wi-Fi Wake-on-LAN Drops: Wake-on-LAN over 802.11 Wi-Fi can drop packets when the Wi-Fi card enters power-saving sleep. Connecting via wired Ethernet or enabling multi-burst WoL is strongly recommended.
  • Pre-2018 VIDAA Models (U2 or earlier): Older models prior to 2018 lack the internal hardware MQTT daemon on port 36669 and cannot be controlled via local TLS.
  • DRM Deep-Linking Restrictions: Certain proprietary streaming apps (e.g. Netflix, Disney+) enforce DRM restrictions preventing direct launching into specific video titles without user navigation in the app UI.
  • Mouse Cursor Browser Scope: In VIDAA OS, the mouse cursor is exclusively active inside the native Web Browser app. Startseite screens and media apps utilize standard D-pad navigation.
  • Virtual Keyboard Requirements: Text sent via vidaa.send_text_input targets the active search bar or input field on screen. The TV OS ignores text if an on-screen input field is not currently open and focused.

🚀 Erstkonfigurationsparameter (Config Flow)

Field Type Required Default Description
ip_address IPv4 String Yes None Local network IP address of the TV (e.g. 192.168.1.50). A static DHCP reservation is strongly recommended.
name String Optional <Brand> TV (<ip>) User-friendly display name used to prefix created entities and device registry entries.
mac_address MAC String Optional Auto-discovered Hardware Ethernet or Wi-Fi MAC address used for Wake-on-LAN and entity uniqueness. Discovered via UPnP / ARP.
brand Select Optional auto OEM Brand profile selector. Defaults to Auto Detect (Recommended) which queries UPnP port 38400. Can be manually set to Hisense, Toshiba, Loewe, Philips/TPV, Sharp, JVC, TOPTRO, and 16 other partners.
auth_profile Select Yes auto Authentication tier: auto (4-tier fallback cascade), modern (VIDAA 2.0 / 2024+ models), middle (VIDAA 1.5), remotenow (VIDAA U4/U5), legacy (pre-2022).
pin_code 4-Digit String Yes (at pairing) None 4-digit verification code displayed on the physical TV screen during pairing.
certfile / keyfile File Path Optional Auto-resolved Custom path to TLS certificate and private key. Automatically resolved from ssl/client_mobile_android.p12 or ssl/El.p12 if left blank.

⚙️ Referenz des tabellarischen Optionen-Menüs

To modify settings without re-pairing, go to Settings → Devices & Services → VIDAA Smart TV → Configure:

⚡ Tab 1: General & Power

Enable Wake-on-LAN: Toggle WoL magic packet transmission when calling media_player.turn_on.
WoL Burst Count: Number of repeated UDP magic packets (1–10, default 3).
Subnet Broadcast: Target broadcast address (e.g. 192.168.1.255) across subnets and VLANs.
Pluggable Turn-On Action: Link a custom Startseite Assistant device trigger (smart plug, relay, IR blaster) executed on turn-on.

📺 Tab 2: Sources & Media

Live TV Source Name: Custom name for the antenna tuner source in the media player dropdown.
Custom Source List: Filter and order input sources (HDMI 1, HDMI 2, AV) displayed in the UI.
Dynamic Artwork: Fetch high-resolution streaming app artwork and channel icons from Startseite Assistant local assets.
Context-Aware Transport: Route Prev/Weiter keys to channel step on Live TV or track skip on apps.

🎮 Tab 3: Remote Key Timings

Inter-Key Delay: Delay in milliseconds between consecutive key commands in sequences (default 150ms).
Repeat Count: Default number of command repetitions for volume and directional keys.
Repeat Interval: Delay between repeated bursts (default 100ms) to prevent buffer overflows on TV hardware.

🔒 Tab 4: Security & Brand

Brand Profile Override: Switch brand profile without re-pairing.
Auth Salt Override: Force Modern XOR salt or standard legacy salt for custom firmware.
Clock Drift Sync: Adjust background UPnP clock sync frequency (1h to 12h, default 2h).

🩺 Diagnose- & Reparatursteuerungen

The integration provides direct repair buttons and diagnostic telemetry to prevent downtime:

  • Trigger Re-pairing Button: Forces an in-place 4-digit PIN re-pairing flow without deleting entity IDs, automations, or Lovelace cards.
  • Sync TV Clock Button: Triggers an instantaneous UPnP hardware clock check and syncs Startseite Assistant's local timestamp.
  • Probe Capabilities Button: Queries the TV's internal feature table and logs active picture presets, sound modes, and app IDs.
  • Hardware Clock Drift Sensor: Tracks milliseconds of drift between TV RTC and Startseite Assistant host, alerting if time skew exceeds 60 seconds (which would invalidate HMAC authentication tokens).