Merge dev-v1.5.5 into main for v1.5.5 release

Author: DerekSeaman

RELEASE_NOTES_v1.5.4.md

@@ -0,0 +1,19 @@
+# Release Notes v1.5.5
+
+## Bug Fixes
+
+- **Fixed thread safety race conditions**: Six pairing/polling state fields were accessed across threads without mutex protection, risking missed IRK captures on dual-core ESP32 variants.
+- **Fixed 32-bit timer overflow**: Absolute timer comparisons would fail after ~49.5 days of uptime. All timer checks now use wraparound-safe arithmetic.
+- **Fixed post-disconnect IRK lookup**: Used the event's embedded connection descriptor instead of `ble_gap_conn_find`, which could fail after NimBLE removed the descriptor.
+- **Fixed config defaults mismatch**: Python schema defaults now match the intended C++ behavior (`continuous_mode=true`, `max_captures=10`).
+- **Fixed BLE name validation**: Compile-time limit reduced from 29 to 12 bytes to match the runtime Samsung S24/S25 compatibility constraint.
+
+## Improvements
+
+- IRK cache size now scales with `max_captures` setting instead of being hardcoded to 10.
+- Replaced `esp_restart()` with `App.safe_reboot()` to avoid watchdog timeouts on profile change.
+- Consolidated `dump_config` output into a single log line, removing `vTaskDelay` workarounds.
+- Replaced magic number for NimBLE DHKey error with a named constant.
+- Simplified `is_valid_irk`, MAC generation, and NVS health check logic.
+- Added input validation for BLE profile select to reject invalid values.
+- Removed unused `on_auth_complete` method and `to_hex_fwd` dead code.

RELEASE_NOTES_v1.5.5.md

@@ -18,12 +18,13 @@
 
 
 def validate_ble_name(value):
-    """Validate BLE name length (BLE spec: max 29 bytes for advertising packet)"""
+    """Validate BLE name length (12 bytes max for Samsung S24/S25 compatibility)"""
     value = cv.string(value)
-    if len(value.encode("utf-8")) > 29:
+    if len(value.encode("utf-8")) > 12:
         raise cv.Invalid(
             f"BLE name too long ({len(value.encode('utf-8'))} bytes). "
-            f"Maximum 29 bytes for BLE advertising packet. Shorten your name."
+            f"Maximum 12 bytes for Samsung S24/S25 compatibility with "
+            f"single-UUID advertising. Shorten your name."
         )
     return value
 
@@ -59,8 +60,8 @@ def validate_continuous_mode_config(config):
             cv.GenerateID(): cv.declare_id(IRKCaptureComponent),
             cv.Optional(CONF_BLE_NAME, default="IRK Capture"): validate_ble_name,
             cv.Optional(CONF_START_ON_BOOT, default=True): cv.boolean,
-            cv.Optional(CONF_CONTINUOUS_MODE, default=False): cv.boolean,
-            cv.Optional(CONF_MAX_CAPTURES, default=1): cv.int_range(min=0, max=255),
+            cv.Optional(CONF_CONTINUOUS_MODE, default=True): cv.boolean,
+            cv.Optional(CONF_MAX_CAPTURES, default=10): cv.int_range(min=0, max=255),
         }
     ).extend(cv.COMPONENT_SCHEMA),
     validate_continuous_mode_config,  # Cross-field validation