Configuration & Options Parameters
Complete reference for initial setup parameters, tabbed options flow, supported entities, and known limitations.
The VIDAA Smart TV integration operates with pure local push telemetry. Home 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.
📱 Supported Entities & Platforms
During setup, the integration discovers and registers entities across 9 Home 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, Next, Previous), dynamic app artwork, track/channel stepping, and Apple HomeKit 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). |
⚠️ Known Hardware & Firmware Limitations
- 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. Home screens and media apps utilize standard D-pad navigation.
- Virtual Keyboard Requirements: Text sent via
vidaa.send_text_inputtargets 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.
🚀 Initial Setup Parameters (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. |
⚙️ Tabbed Options Flow Reference
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 Home 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 Home Assistant local assets.
Context-Aware Transport: Route Prev/Next 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).
🩺 Diagnostics & Repair Controls
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 Home 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 Home Assistant host, alerting if time skew exceeds 60 seconds (which would invalidate HMAC authentication tokens).