1.1.3 : Time for live updates !
🚀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