Repository navigation
v0.6-beta-3
Pre-release
Pre-release
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 fast120s (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 toReady. - On-demand Outage Boost: Adds an Outage Boost Poll button entity per generator and a
generac.boost_pollingaction (duration_minutes1–120, default30, optionalentry_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_increasingonrun_timeandprotection_time;measurementonbattery_voltage,exercise_minutes,outdoor_temperature,capacity,fuel_level,remaining_fuel,estimated_runtime,signal_strength,device_battery_level, andhours_until_service) for multi-year graphs beyond Home Assistant's 10-day recorder purge window—reportingunknownwhen 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, default2.2gal/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 andrun_timeincreases between polls while ignoring transient0dips), 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.2V),missed_exercise(default> 16days),maintenance_due(default100run hours or generator MobileLink maintenance flag), andsubscription_dunning. - 3 Auto-Installed Automation Blueprints: Automatically installs ready-to-use blueprints into
<config>/blueprints/automation/generac/on setup:- Generac Outage Load Shedding (
generac_outage_load_shedding.yaml) — sheds high-draw loads onRunning(ignoringExercising) and stagger-restores previously active loads onceReadystabilizes, even across mid-outage status flaps. - Generac Fault & Dealer Contact Alert (
generac_fault_dealer_alert.yaml) — sends clean multi-line fault notifications populated with status, optionalerror_code, diagnostic text, and preferred dealer contact details. - 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.
- Generac Outage Load Shedding (
Upgrade & Configuration Notes
- Zero breaking changes: All existing entity
unique_ids andentity_keys are preserved—no orphaned entities or_2duplicates on upgrade. - No day-1 false alarms: Existing generators initialize their maintenance baseline to the first valid
run_timereading 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, andlow_battery_thresholdanytime 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, andpttranslations - Remove redundant
homeassistantpin fromrequirements.txt(#325)
📦 Dependencies
- Bump
release-drafter/release-drafterfrom 7.7.0 to 7.11.0 (#330)