Releases: gorfo66/flashbird-homeassistant
Release list
1.1.7: Re-auth flow fixed !
1.1.6: Maintenance counter is there !
We’re introducing a new maintenance-focused feature to help you keep your bike in optimal condition.
New Feature: Chain Maintenance Incremental Counter
This release adds an incremental counter dedicated to tracking your chain usage over time.
What’s included
- Chain maintenance counter
- Incremental sensor that tracks usage for maintenance purposes.
- Exposed as a standard sensor entity in Home Assistant.
- Reset button
- New button entity to reset the counter after cleaning and greasing the chain.
- Instantly starts a new maintenance cycle.
Build Smart Automations
With this new counter, you can easily create automations in Home Assistant to stay on top of maintenance.
Example ideas
- Send a notification when the counter exceeds a defined threshold (e.g. after a certain distance).
- Trigger a persistent notification in the UI when it’s time to clean and lubricate the chain.
- Push a reminder to your mobile device.
- Display the counter on your dashboard to monitor maintenance status at a glance.
Example Automation Logic
- Trigger: Chain maintenance counter rises above your configured limit
- Action: Send a notification reminding you to clean and grease the chain
- After maintenance: Press the reset button to start counting again
1.1.5: Technical release
No functional changes made. Just updating internal tools and documentation.
Please refer to the 1.1.3 release to know the recent functional changes
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
1.0.4: Bug fix
What's Changed
Last delivery broke the configuration flow.
This version fixes it
Full change log
1.0.3: Pegase support
What's new ?
PEGASE SUPPORT !
A new user of the integration was owning a Pegase tracker (old version of new Flashbird trackers).
This tracker does not offer the same sensors (battery voltages of the bike and tracker does not exist, there is no smart key, ...).
The integration was not flexible enough to deal with missing sensors data and was crashing.
It is now fixed.
In addition to that, the model of the tracker is also dynamically returned from the API and injected in the Homeassistant device model.
Hopefully last and final release that fully manage Pegase tracker.
Finger crossed ...
Full change log
1.0.2
1.0.1
- Fix the integration name: during the HACS refactoring, some typo was introduced which was breaking the installation into home assistant
- Fix the reauthentication mechanism for which some inputs were missing.
Full Changelog: 1.0.0...1.0.1
1.0.0
What's Changed
New Contributors
Full Changelog: https://github.com/gorfo66/flashbird-homeassistant/commits/1.0.0
