Harden Quick Key parse against an undefined function value

The 2-bit function field has 4 possible values but only 3 are defined.
A firmware variant or a corrupted BLE byte reporting the undefined 4th
(0b11) now logs and surfaces the function as unknown, keeping the
well-defined enable and trigger bits, instead of passing a stray value
to the select. Mirrors the same fix in the upstream pySwitchbot PR
(sblibs/pySwitchbot#515). Bumps version to 0.3.1.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: mayerwin

custom_components/switchbot_quickkey/coordinator.py

@@ -24,6 +24,7 @@
     CMD_READ,
     CONFIRM_READ_DEADLINE_S,
     DOMAIN,
+    FUNCTION_LABELS,
     MASK_FUNCTION,
     READ_DEADLINE_S,
     RETRY_BACKOFF_S,
@@ -90,11 +91,21 @@ async def write_config(dev: SwitchbotLock, mask: int, value: int,
 def parse_config(cfg: int | None) -> dict:
     if cfg is None:
         return {"raw": None, "enabled": None, "double_press": None, "function": None}
+    func = cfg & MASK_FUNCTION
+    if func not in FUNCTION_LABELS:
+        # The 2-bit function field has 4 possible values but only 3 are defined.
+        # A firmware variant or a corrupted BLE byte could report the undefined 4th
+        # (0b11); keep the well-defined enable/trigger bits and surface the function
+        # as unknown rather than guessing or passing a stray value to the select.
+        _LOGGER.warning(
+            "Unknown Quick Key function value: 0x%02x (config byte 0x%02x)", func, cfg
+        )
+        func = None
     return {
         "raw": cfg,
         "enabled": bool(cfg & BIT_ENABLE),
         "double_press": bool(cfg & BIT_DOUBLE),
-        "function": cfg & MASK_FUNCTION,
+        "function": func,
     }
 
 

custom_components/switchbot_quickkey/manifest.json

@@ -1,7 +1,7 @@
 {
   "domain": "switchbot_quickkey",
   "name": "SwitchBot Lock Quick Key (interim)",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "config_flow": true,
   "documentation": "https://github.com/mayerwin/ha-switchbot-lock-quick-key-support",
   "issue_tracker": "https://github.com/mayerwin/ha-switchbot-lock-quick-key-support/issues",