Skip to content

Release 1.0.0

Choose a tag to compare

@github-actions github-actions released this 23 Nov 18:41

🎉 Version 1.0 - Major Release! 🎉

We're thrilled to announce version 1.0 of the LEDnetWF BLE integration! This milestone release represents a significant transformation of how the integration works, delivering better reliability and a improved user experience.

🌟 What's New in 1.0

Passive Bluetooth Monitoring

  • Automatic State Updates Without Active Connections - Your devices now update their state in Home Assistant automatically by listening to Bluetooth advertisements they broadcast every few seconds
  • Survives Home Assistant Restarts - No more incorrect states after restarting Home Assistant! The integration immediately picks up the current state from advertisements
  • Reduced Bluetooth Interference - By not maintaining constant connections, your Bluetooth network is free for other devices
  • Real-Time Updates - Changes made via physical remotes or other apps are reflected in Home Assistant within seconds, even when disconnected

This feature works completely transparently in the background - no configuration needed!

Major User Experience Improvements

Smarter Effect Management:

  • "Solid Color" Mode - Renamed "Static Effect 1" to "Solid Color" for clarity, and it now behaves like a simple color mode instead of an effect
  • Reordered Effect Lists - The most useful options now appear first:
    • 0x56/0x80 devices: Solid Color → Static Effects → Dynamic Effects → Sound Reactive → Cycle Modes
    • 0x54/0x55/0x62 devices: Effect Off → Effects 1-21 → Candle Mode → Sound Reactive
    • 0x5b devices: Effect Off → RGB Jump → Effects 0-20 → Candle Mode
  • Smart Background Light Control - The background light entity is now only available when using static effects that actually support background colors (Static Effect 2-10), preventing accidental effect interruption

Better Background Color Handling:

  • Background colors now initialize to match your current foreground color and brightness instead of blasting full-brightness white

Critical Bug Fixes

  • Fixed effect state synchronization - Speed slider changes now correctly apply to the current effect, even when the effect was changed externally
  • Fixed music mode crashes - Resolved UnboundLocalError when enabling sound reactive modes
  • Improved callback system - Centralized callback registration prevents initialization race conditions

Enhanced Device Support

  • Added support for devices advertising as "iotb" prefix
  • Improved device detection and initialization
  • Better handling of unknown device modes and effects

⚠️ Important Upgrade Notice

Due to significant changes in the underlying schema and control mechanisms, some devices may need to be deleted and re-added after upgrading to version 1.0:

  1. Navigate to Settings → Devices & Services → LEDnetWF BLE
  2. Click on your device
  3. Click the three-dot menu and select "Delete"
  4. The device should be automatically rediscovered
  5. Add it again through the integration

This one-time step ensures your device benefits from all the new features and improvements. Your device settings (LED count, chip type, color order) will be auto-detected during setup.

🙏 Getting to 1.0

Reaching version 1.0 is a huge milestone! This integration has evolved from a basic device controller to a robust, reliable system that truly integrates LEDnetWF devices into your smart home.

A massive thank you to everyone who has:

  • Reported issues and provided feedback
  • Tested beta versions
  • Contributed code and documentation

📋 Full Changelog

Added

  • Passive Bluetooth advertisement monitoring for real-time state updates
  • Centralized callback registration system
  • "Solid Color" effect mode (replacing confusing "Static Effect 1")
  • Conditional background light availability based on effect type
  • Support for "iotb" device name prefix
  • Comprehensive debug logging for troubleshooting
  • Smart background color initialization

Changed

  • Effect lists now display in logical order instead of alphabetical
  • Background brightness initializes to match foreground instead of maximum
  • Improved manufacturer data parsing across all device models
  • Better separation of concerns in model architecture

Fixed

  • Effect state synchronization in speed slider
  • Device state persistence across Home Assistant restarts
  • UnboundLocalError when enabling music/sound reactive modes
  • Callback initialization race conditions
  • PEP 8 compliance issues
  • Various edge cases in effect and color handling

🚀 What's Next?

With the solid foundation of version 1.0 in place, future updates will focus on:

  • Supporting additional device models
  • Adding advanced features for supported devices
  • Further performance optimizations
  • Community-requested enhancements

Thank you for being part of the LEDnetWF BLE community. Here's to version 1.0 and beyond! 🎊


Need Help? Check out our documentation or open an issue if you encounter any problems.

Want to Support Development? Consider buying me a coffee to help with purchasing new devices for testing and expanding support!