2.5.0

[DennisMoschina]

Release 2.5.0 supports firmware 2.3.x while preserving compatibility with older firmware, including 2.2.9.

• Decode compact PPG and IMU BLE samples per device firmware version, preserving public values, float types, units, metadata, and legacy SD/.oe parsing (Decode compact PPG and support firmware 2.3.x #154, Decode compact IMU BLE samples without changing public units #155, Select compact sensor decoding from the actual firmware version #156).
• Read back the configured LED color and status mode on firmware 2.3.x.
• Correct battery status decoding (fix(battery): correct GATT status decoding #151).
• Complete failed or aborted FOTA preparation without leaving the app stuck (fix(fota): finish preparation failures and early aborts #152).
• Release native Bluetooth connections after adapter power cycles and Flutter engine shutdown (Recover wearable connections after Bluetooth power cycles #153, Release Android BLE clients when the app engine closes #158).
• Depend on published open_earable_protocols 0.0.4; remove temporary Git overrides and update the example lockfile.

Validated with the repository's Flutter 3.44.0 and the published protocol package: analysis clean, all 49 library tests and the example test pass, example web build succeeds, and publication dry-run reports zero warnings. Tests cover compact and legacy decoding, unchanged SD parsing, firmware selection, battery fields, LED readback, FOTA failure handling, and Bluetooth cleanup.

Earlier Android Recorder checks measured 99.67 Hz IMU and 512.27 Hz PPG in separate 30-second windows on firmware 2.3.0, with finite values, valid PPG range, no backward timestamps, and zero parsing exceptions; a connected legacy device remained correct. These are earlier hardware checks, not a new full hardware validation of the publication changes.

After merging, tag v2.5.0 triggers the existing pub.dev publishing workflow. This PR does not release the app or firmware. Older audio feature PRs #148/#150 are excluded.

[github-actions]

Visit the preview URL for this PR (updated for commit 149fbc9):

https://open-earable-lib-web-example--pr149-2-5-0-ced828x3.web.app

_{(expires Tue, 03 Nov 2026 16:40:30 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 7f6db4d9d00b851ad49af109fa949061904b3151}

[TobiasRoeddiger]

Reviewed for the authorized package release. Compact BLE decoding remains selected per firmware, with legacy and SD parsing preserved. Validated against hosted open_earable_protocols 0.0.4 on Flutter 3.44.0: clean analysis, 49 library tests and the example test passing, successful example web build, and publication dry-run with zero warnings. GitHub checks pass at this commit. Review and checks were performed by Codex; this does not claim a fresh full hardware test.