Make EV live activities opt-in

Author: Antonio ...

README.md

@@ -56,7 +56,7 @@ Most projects target one charger brand or assume a single-phase home. EV Smart C
 
 > **🆕 New in v2.6.0** — mass bug-fix & improvement release (issues #36–#42). Highlights: an optional **`grid_available` binary sensor** ([issue #36](https://github.com/antbald/ha-ev-smart-charger/issues/36)) stops Night Smart Charge grid mode during a **grid outage** so it doesn't drain the home battery on hybrid Battery First / UPS inverters (fail-safe: an unavailable sensor never triggers a false stop); a **customizable nighttime window** ([issue #42](https://github.com/antbald/ha-ev-smart-charger/issues/42)) via two opt-in offset numbers (start before sunset / end after sunrise); and a big **INFO log-noise reduction** ([issue #40](https://github.com/antbald/ha-ev-smart-charger/issues/40)) — idle ticks no longer flood the HA log. Also: valid day icons (#37), faster Generic-charger ramp-up (#38), a consistent Hybrid full-battery threshold (#39), and a cleaner telemetry log (#41). **All backward compatible** — the two features are opt-in.
 
-> **📱 New in v2.7.3** — EV charging **Live Activities / Live Updates** for the Home Assistant Companion app. When mobile notify services are configured, the integration keeps a single `evsc_ev_charging` activity updated for Boost Charge, Night Smart Charge, Solar Surplus, Force Charge, and normal charging detected by the shared `charging_power` / charger-status SSOT. Updates are throttled to protect the iOS push budget and the activity closes only after charging has stopped for two monitor ticks.
+> **📱 New in v2.7.3+** — EV charging **Live Activities / Live Updates** for the Home Assistant Companion app. When enabled from **Dashboard → Settings → Notifications**, the integration keeps a single `evsc_ev_charging` activity updated for Boost Charge, Night Smart Charge, Solar Surplus, Force Charge, and normal charging detected by the shared `charging_power` / charger-status SSOT. Updates are throttled to protect the iOS push budget and the activity closes only after charging has stopped for two monitor ticks. **Default: OFF**.
 
 ---
 
@@ -445,7 +445,7 @@ Used by Night Smart Charge to decide between home battery and grid charging. If
 
 The `person` entity enables presence-based filtering: notifications are only sent when the car owner is home. If the entity is unavailable, notifications are sent anyway as a fail-safe.
 
-The same mobile notify services are used for EV charging Live Activities / Live Updates on supported Companion App versions. No extra helper is required.
+The same mobile notify services can be used for EV charging Live Activities / Live Updates on supported Companion App versions. They are OFF by default and can be enabled later from the generated dashboard.
 
 ### Step 6 — External Connectors
 
@@ -1169,7 +1169,9 @@ If the `person` entity is unavailable, notifications are always sent (fail-safe
 
 ### EV Charging Live Activities / Live Updates
 
-On Home Assistant Core 2026.7+ with a supported Companion App, EV Smart Charger sends a single live notification tagged `evsc_ev_charging`.
+On Home Assistant Core 2026.7+ with a supported Companion App, EV Smart Charger can send a single live notification tagged `evsc_ev_charging`.
+
+Enable it with `switch.evsc_live_activities_enabled` or from **Dashboard → Settings → Notifications → EV Live Activities**. The default is **OFF**, so upgrades never start Live Activities without an explicit opt-in.
 
 It starts or updates automatically when the EV is drawing current, including:
 
@@ -1190,6 +1192,7 @@ Updates are intentionally coarse: the integration reuses meaningful state change
 | `evsc_notify_smart_blocker_enabled` | ON | Notifications when Smart Charger Blocker stops the charger |
 | `evsc_notify_priority_balancer_enabled` | ON | Notifications when Priority Balancer state changes |
 | `evsc_notify_night_charge_enabled` | ON | Notifications when Night Smart Charge starts or completes |
+| `evsc_live_activities_enabled` | OFF | EV charging Live Activities / Live Updates |
 
 ---
 

RELEASE_v2.7.4.md

@@ -0,0 +1,16 @@
+# Release v2.7.4
+
+## Changed
+
+- EV charging Live Activities / Live Updates are now opt-in instead of automatic.
+- Added `evsc_live_activities_enabled`, default OFF, to control Live Activities from the generated dashboard.
+- The normal charging monitor clears the existing `evsc_ev_charging` activity once when the toggle is turned OFF.
+- Bumped integration version metadata to `2.7.4`.
+
+## Documentation
+
+- Updated README, frontend dashboard docs, and maintainer docs for the new default-OFF behavior.
+
+## Tests
+
+- `./.venv/bin/python -m pytest -q`

custom_components/ev_smart_charger/const.py

@@ -2,7 +2,7 @@
 
 # ========== INTEGRATION METADATA ==========
 DOMAIN = "ev_smart_charger"
-VERSION = "2.7.3"
+VERSION = "2.7.4"
 DEFAULT_NAME = "EV Smart Charger"
 FRONTEND_URL_BASE = "/api/ev_smart_charger/frontend"
 FRONTEND_CARD_FILENAME = "ev-smart-charger-dashboard.js"
@@ -189,6 +189,7 @@
 HELPER_NOTIFY_SMART_BLOCKER_SUFFIX = "evsc_notify_smart_blocker_enabled"
 HELPER_NOTIFY_PRIORITY_BALANCER_SUFFIX = "evsc_notify_priority_balancer_enabled"
 HELPER_NOTIFY_NIGHT_CHARGE_SUFFIX = "evsc_notify_night_charge_enabled"
+HELPER_LIVE_ACTIVITIES_ENABLED_SUFFIX = "evsc_live_activities_enabled"
 
 # Persistent notification IDs (fixed → updated in place, never stacked)
 # v2.5.0 (issue #35): surfaced when Priority Balancer is disabled while home
@@ -422,21 +423,23 @@
 # number (evsc_max_battery_discharge_for_ev) → 66. v2.3.0 (issue #32) adds 1
 # always-created number (evsc_night_pv_handoff_threshold) → 67. v2.6.0 (issue #42)
 # adds 2 always-created numbers (nighttime sunset/sunrise offsets) → 69.
+# v2.7.4 adds 1 always-created switch (live activities enabled) → 70.
 # COUPLING (issue #22): the disabled-helper tolerance in
 # __init__._async_wait_for_helper_registration assumes this equals the number
 # of entities actually created when nothing is disabled. If it drifts above
 # reality (cf. v1.6.20), a single user-disabled entity turns the tolerant
 # startup path back into a hard ConfigEntryNotReady. Keep this in sync.
-TOTAL_INTEGRATION_ENTITIES = 69
+TOTAL_INTEGRATION_ENTITIES = 70
 # Verified count (v2.3.0): 53 entities when running in PV-only mode.
 # Unchanged in v2.1.0: the discharge number is battery-only (skipped in PV-only mode).
 # v2.3.0 (issue #32): evsc_night_pv_handoff_threshold is NOT battery-only → +1 → 53.
 # v2.6.0 (issue #42): 2 nighttime offset numbers are NOT battery-only → +2 → 55.
+# v2.7.4: live activities enabled switch is NOT battery-only → +1 → 56.
 # Skipped helpers (13): 2 switches (use_home_battery, preserve_home_battery),
 # 3 numbers (home_battery_min_soc, battery_support_amperage, battery_support_sunset_buffer),
 # 7 daily home min SOC numbers (Monday–Sunday), 1 sensor (today_home_target).
 # Hybrid Mode entities are still created in PV-only mode but stay IDLE (requires soc_home).
-TOTAL_INTEGRATION_ENTITIES_NO_BATTERY = 55
+TOTAL_INTEGRATION_ENTITIES_NO_BATTERY = 56
 
 
 def has_home_battery(config: dict) -> bool:

custom_components/ev_smart_charger/frontend/README.md

@@ -114,7 +114,7 @@ pv_forecast_entity: sensor.pv_forecast_tomorrow
 | **Solar Surplus** | check interval, grid import threshold/delay, surplus drop delay, solar max amperage, use home battery, home battery min SOC, battery support amperage, battery support sunset buffer |
 | **Hybrid Inverter Mode** (v1.8.0) | `evsc_hybrid_inverter_mode`, `evsc_hybrid_battery_full_threshold`, `evsc_hybrid_probe_duration`, `evsc_hybrid_max_import_duration`, `evsc_hybrid_max_failed_probes` |
 | **Safety / Protection** | `evsc_priority_balancer_enabled`, `evsc_smart_charger_blocker_enabled` |
-| **Notifications** | `evsc_notify_smart_blocker_enabled`, `evsc_notify_priority_balancer_enabled`, `evsc_notify_night_charge_enabled` |
+| **Notifications** | `evsc_notify_smart_blocker_enabled`, `evsc_notify_priority_balancer_enabled`, `evsc_notify_night_charge_enabled`, `evsc_live_activities_enabled` (default OFF) |
 | **Logging** | `evsc_trace_logging_enabled`, `evsc_enable_file_logging`, displays current `evsc_log_file_path` |
 | **Diagnostics panel** | `evsc_diagnostic`, `evsc_solar_surplus_diagnostic`, `evsc_hybrid_inverter_diagnostic`, `evsc_cached_ev_soc` |
 

custom_components/ev_smart_charger/frontend/ev-smart-charger-dashboard.js

@@ -124,6 +124,7 @@ const DOMAIN_SUFFIXES = {
   notifySmartBlocker: ["switch", "evsc_notify_smart_blocker_enabled"],
   notifyPriorityBalancer: ["switch", "evsc_notify_priority_balancer_enabled"],
   notifyNightCharge: ["switch", "evsc_notify_night_charge_enabled"],
+  liveActivities: ["switch", "evsc_live_activities_enabled"],
 
   // ── Logging (v1.3.25 / v1.4.15)
   traceLogging: ["switch", "evsc_trace_logging_enabled"],
@@ -487,6 +488,14 @@ const SETTINGS_CATALOG = [
           nl: "Melden wanneer Night Smart Charge een sessie start (BATTERY of GRID).",
         },
         hint: { en: "Filtered by owner presence", it: "Filtrate per presenza del proprietario", nl: "Gefilterd op aanwezigheid eigenaar" } },
+      { entityKey: "liveActivities", kind: "toggle",
+        name: { en: "EV Live Activities", it: "Live Activities EV", nl: "EV Live Activities" },
+        desc: {
+          en: "Show EV charging progress on the Companion app Lock Screen / Dynamic Island when supported.",
+          it: "Mostra l'avanzamento della ricarica EV su Lock Screen / Dynamic Island della Companion app quando supportato.",
+          nl: "Toon EV-laadvoortgang op het vergrendelscherm / Dynamic Island van de Companion-app wanneer ondersteund.",
+        },
+        hint: { en: "Default off", it: "Default off", nl: "Standaard uit" } },
     ],
   },
   {

custom_components/ev_smart_charger/live_activity_monitor.py

@@ -48,6 +48,7 @@ def __init__(
         self._timer_unsub = None
         self._inactive_ticks = 0
         self._live_activity_active = False
+        self._last_enabled = False
 
     async def async_setup(self) -> None:
         """Start the coarse polling monitor."""
@@ -71,6 +72,17 @@ async def async_remove(self) -> None:
 
     async def _async_tick(self, now=None) -> None:
         """Update or clear the Live Activity based on normal charging state."""
+        enabled = self._mobile_notifier.is_live_activity_enabled()
+        if not enabled:
+            if self._last_enabled:
+                await self._mobile_notifier.clear_ev_charging_live_activity()
+            self._inactive_ticks = 0
+            self._live_activity_active = False
+            self._last_enabled = False
+            return
+
+        self._last_enabled = True
+
         if self._is_boost_or_night_active():
             self._inactive_ticks = 0
             self._live_activity_active = False

custom_components/ev_smart_charger/manifest.json

@@ -11,5 +11,5 @@
   "iot_class": "local_push",
   "issue_tracker": "https://github.com/antbald/ha-ev-smart-charger/issues",
   "requirements": [],
-  "version": "2.7.3"
+  "version": "2.7.4"
 }

custom_components/ev_smart_charger/strings.json

@@ -452,6 +452,9 @@
       "evsc_notify_night_charge_enabled": {
         "name": "Notify night charge"
       },
+      "evsc_live_activities_enabled": {
+        "name": "Live activities"
+      },
       "evsc_enable_file_logging": {
         "name": "Enable file logging"
       },

custom_components/ev_smart_charger/switch.py

@@ -16,6 +16,7 @@
     DEFAULT_CAR_READY_WEEKEND,
     DEFAULT_HYBRID_INVERTER_MODE,
     HELPER_HYBRID_INVERTER_MODE_SUFFIX,
+    HELPER_LIVE_ACTIVITIES_ENABLED_SUFFIX,
     HELPER_PRESERVE_HOME_BATTERY_SUFFIX,
     HELPER_TRACE_LOGGING_ENABLED_SUFFIX,
     HELPER_USE_HOME_BATTERY_SUFFIX,
@@ -64,6 +65,7 @@ async def async_setup_entry(
         ("evsc_notify_smart_blocker_enabled", "Notify Smart Blocker", "mdi:bell-outline", True),
         ("evsc_notify_priority_balancer_enabled", "Notify Priority Balancer", "mdi:bell-outline", True),
         ("evsc_notify_night_charge_enabled", "Notify Night Charge", "mdi:bell-outline", True),
+        (HELPER_LIVE_ACTIVITIES_ENABLED_SUFFIX, "Live Activities", "mdi:progress-bolt", False),
         # Logging switches
         ("evsc_enable_file_logging", "Enable File Logging", "mdi:file-document-outline", False),
         (HELPER_TRACE_LOGGING_ENABLED_SUFFIX, "Trace Logging", "mdi:timeline-text-outline", False),

custom_components/ev_smart_charger/translations/en.json

@@ -452,6 +452,9 @@
       "evsc_notify_night_charge_enabled": {
         "name": "Notify night charge"
       },
+      "evsc_live_activities_enabled": {
+        "name": "Live activities"
+      },
       "evsc_enable_file_logging": {
         "name": "Enable file logging"
       },