Repository navigation
v3.1.0
This release marks a major architectural milestone for the Hisense VIDAA TV integration, completing a full migration to native async MQTT (aiomqtt>=2.3.0), eliminating all threaded callbacks and executor offloading, modernizing Lovelace remote card designs, standardizing documentation examples, and achieving complete architectural compliance with all 54 Home Assistant Integration Quality Scale rules in quality_scale.yaml.
☕ Support the Project
If this integration has added value to your smart home setup, consider buying me a coffee to support continued development and maintenance:
🌟 What's New & Hardened in v3.1.0
- NATIVE
aiomqtt>=2.3.0ASYNC TRANSPORT ENGINE (async-dependency: done):- Replaced legacy threaded
paho-mqtt(loop_start()/loop_stop(),threading.Timer,threading.Lock,threading.Thread, and cross-threadhass.loop.call_soon_threadsafe) with nativeaiomqtt.Clientasync context managers running directly on Home Assistant's event loop. - Replaced synchronous locks and thread sleeps with
asyncio.Task,asyncio.Lock, andasyncio.Futurequery routing for snappy, non-blocking TV state requests and commands. - Eliminated unnecessary
hass.async_add_executor_jobinvocations across all platforms (media_player,remote,button,switch,select,number,notify,services).
- Replaced legacy threaded
- SHARED
aiohttp.ClientSessionWEBSESSION INJECTION (inject-websession: done):- Injected Home Assistant's shared
aiohttp.ClientSessionviaasync_get_clientsession(hass)intoHisenseTvClientandHisenseUpnpClient. - Added non-blocking async UPnP HTTP
Dateheader synchronization (async_get_tv_timestamp) and device fingerprinting (async_get_device_fingerprint), replacing legacyurllib.request.urlopen.
- Injected Home Assistant's shared
- LOVELACE REMOTE EXAMPLES & DARK MODE MODERNIZATION (
examples/):- Optimized
examples/lovelace-australian-remote-card.yamlandexamples/lovelace-us-remote-card.yamlfor Home Assistant dark mode and browser rendering engines. - Added
keepconfig (background: true,box_shadow: true,border_radius: true) tocustom:stack-in-cardto eliminate seam artifacts between card segments. - Protected buttons against Chrome/Blink auto-dark-mode contrast inversion with
forced-color-adjust: noneandcolor-scheme: light. - Enhanced Australian remote with authentic Stan branding, white pill styling for streaming apps, glowing borders, and 3D tactile gradients on colored navigation buttons.
- Redesigned power button with circular recessed styling and illuminated red status icon.
- Updated high-resolution brand assets (
brand/icon@2x.png,brand/logo@2x.png) and integration screenshots.
- Optimized
- STANDARDIZED ENTITY IDS ACROSS EXAMPLES & AUTOMATION DOCS (
examples/,docs/):- Standardized entity IDs to
living_room_hisense_vidaa_tvacross all 6 Lovelace card examples (australian-remote,us-remote,classic-remote,button-card-remote,android-tv-card,tv-card) and throughoutdocs/services_and_automations.md.
- Standardized entity IDs to
- MULTI-DEVICE SERVICE TARGET AMBIGUITY GUARD (
services_target.py):- Safeguarded custom services (
send_key,launch_app,send_text_input,set_picture_setting,set_sound_setting,send_key_sequence,change_channel) from unintended broadcast when multiple TVs are present. - Single configured TV: Automatically executes without requiring target selectors (zero breaking changes for single-TV homes).
- Multiple configured TVs without target: Raises
ServiceValidationError(ambiguous_target) prompting for specific target. - Multi-TV broadcast: Explicitly broadcast to all configured TVs using
entity_id: "all". - Full localization added across 7 languages (
en,de,es,fr,it,pt,pt-BR) instrings.jsonand translation catalogs.
- Safeguarded custom services (
- TV USB POWER LIMITATIONS & STANDBY BROWNOUT DOCUMENTATION (
docs/power_and_standby_settings.md):- Documented volatile token memory wipes caused by external streaming sticks (Chromecast, Fire TV, Roku) powered by TV USB ports during standby transitions, providing power and standby mitigation instructions.
- PROTOCOL & EVENT LOOP RUNTIMEWARNING FIX (
protocol/ping.py):- Closed unspawned coroutines cleanly when the event loop is absent to eliminate Python
RuntimeWarningmessages in test harnesses and standalone scripts.
- Closed unspawned coroutines cleanly when the event loop is absent to eliminate Python
- INTEGRATION QUALITY SCALE ALIGNMENT (
quality_scale.yaml):- Formally achieved 100% rule compliance across all 54 Bronze, Silver, Gold, and Platinum rules in
quality_scale.yaml(async-dependency,inject-websession,strict-typing,reconfiguration-flow,runtime-data). - Conservatively retains
manifest.jsonat"quality_scale": "bronze"in accordance with Home Assistant Core staged review policy.
- Formally achieved 100% rule compliance across all 54 Bronze, Silver, Gold, and Platinum rules in
- EXPANDED TEST SUITE (224 TESTS PASSING):
- Expanded unit test coverage across async MQTT lifecycle, proactive token refresh in standby, multi-device ambiguity guards, Websession retention, and Hassfest container verification.