Skip to content

v0.6.0

Latest

Choose a tag to compare

@binarydev binarydev released this 21 Nov 00:40
e90e52e

Highlights in v0.6.0

This release brings three major upgrades focused on faster outage response, multi-year historical analytics, and proactive generator readiness:

⚡ State-Aware Adaptive Polling & Outage Boost

  • Gentle when idle, fast when active: Keeps the API-friendly 900s (15-minute) idle polling interval during standby, and automatically switches to a fast 120s (2-minute) active interval whenever a generator is Running, Exercising, or Warning (or when any device is connecting/warning), with a 5-minute cooldown after returning to Ready.
  • On-demand Outage Boost: Adds an Outage Boost Poll button entity per generator and a generac.boost_polling action (duration_minutes 1–120, default 30, optional entry_id) so local grid-loss automations (UPS, smart meter, inverter) can immediately refresh telemetry and hold fast polling.

📊 Long-Term Statistics, Propane Fuel Autonomy & Fault/VPP Telemetry

  • Home Assistant Long-Term Statistics (LTS): Operational numeric sensors now declare state_class (total_increasing on run_time and protection_time; measurement on battery_voltage, exercise_minutes, outdoor_temperature, capacity, fuel_level, remaining_fuel, estimated_runtime, signal_strength, device_battery_level, and hours_until_service) for multi-year graphs beyond Home Assistant's 10-day recorder purge window—reporting unknown when properties are transiently omitted to prevent bogus meter-reset spikes.
  • Propane Gallons & Outage Runtime Estimation: Propane tank monitors now expose Remaining Fuel (gal) and Estimated Runtime Remaining (h), backed by a configurable Estimated fuel burn rate option (fuel_burn_rate, default 2.2 gal/h).
  • Fault Codes, VPP & Clean Device Cards: Exposes generator Error Code (eCodeLabel), conditional Virtual Power Plant sensors (VPP Enrolled, Active VPP Event), and Subscription Billing Alert (subscription_dunning), while grouping 15 static metadata sensors under Home Assistant's Diagnostic category.

🛡️ Proactive Readiness Alerts, Maintenance Timer & Bundled Blueprints

  • Maintenance & Exercise Tracking: Adds Hours Until Service (sensor), Missed Exercise (binary_sensor, catching both live exercise states and run_time increases between polls while ignoring transient 0 dips), and a Reset Maintenance Timer (button) persisted cleanly via Home Assistant storage without triggering integration reloads.
  • New Home Assistant Repairs Warnings: Surfaces actionable Repairs alerts for low_battery_voltage (default < 12.2 V), missed_exercise (default > 16 days), maintenance_due (default 100 run hours or generator MobileLink maintenance flag), and subscription_dunning.
  • 3 Auto-Installed Automation Blueprints: Automatically installs ready-to-use blueprints into <config>/blueprints/automation/generac/ on setup:
    1. Generac Outage Load Shedding (generac_outage_load_shedding.yaml) — sheds high-draw loads on Running (ignoring Exercising) and stagger-restores previously active loads once Ready stabilizes, even across mid-outage status flaps.
    2. Generac Fault & Dealer Contact Alert (generac_fault_dealer_alert.yaml) — sends clean multi-line fault notifications populated with status, optional error_code, diagnostic text, and preferred dealer contact details.
    3. Generac Pre-Storm Readiness Digest (generac_storm_readiness_digest.yaml) — sends a multi-line pre-storm summary of battery voltage, connectivity, service hours, and optional propane level, remaining gallons, and estimated runtime when a weather alert triggers.

Upgrade & Configuration Notes

  • Zero breaking changes: All existing entity unique_ids and entity_keys are preserved—no orphaned entities or _2 duplicates on upgrade.
  • No day-1 false alarms: Existing generators initialize their maintenance baseline to the first valid run_time reading and exercise timestamp after upgrading.
  • Configurable in UI: Tune enabled platforms, scan_interval / active_scan_interval, fuel_burn_rate, service_interval_hours, exercise_interval_days, and low_battery_threshold anytime under Settings → Devices & services → Generac MobileLink → Configure.

Changes

🚀 Features

  • Add proactive readiness Repairs alerts, service & exercise tracking, maintenance reset button, and bundled automation blueprints (#327)
  • Add state-aware adaptive polling and outage boost trigger (#328)
  • Add long-term statistics, propane fuel autonomy, fault/VPP telemetry, and diagnostic entity categorization (#329)

🪲 Fixes

  • Harden LTS missing-value handling, readiness tracking, platform toggles, option validation, and bundled blueprints (#331)
  • Fix issue-tracker repository URL in en, fr, nb, and pt translations
  • Remove redundant homeassistant pin from requirements.txt (#325)

📦 Dependencies

  • Bump release-drafter/release-drafter from 7.7.0 to 7.11.0 (#330)