Skip to content

1.1.3 : Time for live updates !

Choose a tag to compare

@gorfo66 gorfo66 released this 22 Nov 16:45
174b003

🚀WebSocket & Real-time Alerts

Overview

Major update bringing real-time WebSocket connectivity and comprehensive alert monitoring to your Flashbird integration.

🌐 WebSocket Implementation

Real-time Device Communication

  • Live Updates: Connected to Flashbird API via WebSocket for instant device status updates
  • Intelligent Throttling: Automatic rate limiting (max 1 update per 5 seconds) reduces unnecessary state changes while maintaining responsiveness
  • Auto-Reconnection: Built-in exponential backoff ensures reliable connection recovery
  • Optimized Performance: Async-native implementation with minimal CPU/memory overhead

Monitoring & Diagnostics

  • Refresh Rate Sensor - Track WebSocket communication frequency in Hz with 10-minute rolling average
    • Monitor API health and device connectivity patterns
    • Instantly spot communication issues
    • Marked as DIAGNOSTIC for easy discovery

🚨 Alert Sensors - Enhanced Security Monitoring

New Alert Tracking Capabilities

Three new sensors provide comprehensive alert monitoring:

1. Alert Status (Real-time Alert Level)

Monitor your device's security status with 4 distinct alert states:

  • 🟢 No alert - Device secure
  • 🟡 Shake detected - Vibration/movement alert triggered
  • 🟠 Repeated shake detected - Multiple vibration events (escalated threat)
  • 🔴 Movement detected - Significant movement detected (highest alert level)

2. Last Alert Time (Alert Timestamp)

  • Precise timestamp of the most recent alert event
  • Perfect for automation triggers and event logging
  • Helps you track when your device was last disturbed

3. Refresh Rate (Bonus Monitoring)

  • Diagnose WebSocket health by monitoring update frequency
  • Useful for troubleshooting connectivity issues

🎯 Key Benefits

Instant Notifications - React immediately to security alerts via real-time WebSocket updates
Detailed Alert History - Track exact times and types of disturbances
Smart Automation - Build automations based on alert level changes
System Health Monitoring - Watch refresh rates to ensure reliable device communication
Fully Localized - French translations included for all new features

📊 What's New in Details

Feature Type Benefits
WebSocket Connection Infrastructure Real-time updates, reduced latency
Alert Status Sensor Diagnostic 4-level security state monitoring
Last Alert Time Diagnostic Precise event timestamp tracking
Refresh Rate Monitor Diagnostic API health & connectivity insights
Intelligent Throttling Performance Optimized state changes, lower CPU usage

🔧 Technical Highlights

  • Async Implementation: Uses Python asyncio for non-blocking operations
  • Data Buffering: Multiple rapid updates intelligently consolidated
  • 10-Minute Rolling Window: Stable refresh rate calculation
  • DIAGNOSTIC Entities: All monitoring sensors properly categorized

Full change log: 1.0.4...1.1.3