plasma-app 2.2.2__tar.gz → 2.2.3__tar.gz

{plasma_app-2.2.2 → plasma_app-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plasma-app
-Version: 2.2.2
+Version: 2.2.3
 Summary: PLASMA — Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 License: MIT
 Project-URL: Homepage, https://github.com/YuyiChang/PLASMA
@@ -101,7 +101,7 @@ plugins: `msense`, `qb2`, `pupil`, `shimmer`, `obs` (and `all`).
 - [x] linux aarch64 build — `PLASMA_Linux_arm64` for Jetson Orin (JetPack 6); CI job `build-linux-arm64`
 - [ ] infrequent stream (e.g., PLASMA journaler) shows green after recording stop
 - [ ] doc for msense workflow with better screenshots
-- [ ] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
+- [x] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
 
 ## developing a sensor plugin
 

{plasma_app-2.2.2 → plasma_app-2.2.3}/README.md

@@ -53,7 +53,7 @@ plugins: `msense`, `qb2`, `pupil`, `shimmer`, `obs` (and `all`).
 - [x] linux aarch64 build — `PLASMA_Linux_arm64` for Jetson Orin (JetPack 6); CI job `build-linux-arm64`
 - [ ] infrequent stream (e.g., PLASMA journaler) shows green after recording stop
 - [ ] doc for msense workflow with better screenshots
-- [ ] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
+- [x] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
 
 ## developing a sensor plugin
 

{plasma_app-2.2.2 → plasma_app-2.2.3}/plasma/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.2.2"
+__version__ = "2.2.3"
 
 # Short git commit hash baked in by CI (.github/workflows/build.yml) just
 # before a release build is frozen with PyInstaller — a frozen bundle ships no

{plasma_app-2.2.2 → plasma_app-2.2.3}/plasma/devices/msense/config.py

@@ -46,7 +46,12 @@ def merge_msense_records(existing, scanned, overwrite):
 
     ``overwrite=True``  → one fresh record per scanned device, nothing kept.
     ``overwrite=False`` → ``existing`` plus a record for every scanned address
-    not already listed (case-insensitive on "UUID / MAC Address").
+    not already listed (case-insensitive on "UUID / MAC Address"). A scanned
+    address that IS already listed has that record's Name refreshed to the
+    freshly advertised name instead — Nickname/Enabled/IMU Stream are left
+    alone — so a firmware update that changes the advertised name reaches the
+    table via Append without needing Overwrite (which would also reset those
+    per-device toggles for every other configured wristband).
 
     Fresh records use the advertised name as Name, blank Nickname, Enabled on,
     IMU Stream off. Returns ``(records, summary_str)``.
@@ -64,13 +69,30 @@ def merge_msense_records(existing, scanned, overwrite):
         records = [_fresh(dev) for dev in scanned]
         return records, f"Overwrote table with {len(records)} scanned wristband(s)"
 
+    scanned_by_addr = {dev["address"].strip().upper(): dev for dev in scanned}
+    records = []
+    renamed = 0
+    for rec in existing:
+        dev = scanned_by_addr.get(str(rec.get("UUID / MAC Address", "")).strip().upper())
+        if dev and dev["name"] != rec.get("Name", ""):
+            rec = {**rec, "Name": dev["name"]}
+            renamed += 1
+        records.append(rec)
+
     have = {str(rec.get("UUID / MAC Address", "")).strip().upper() for rec in existing}
     added = [_fresh(dev) for dev in scanned if dev["address"].strip().upper() not in have]
-    skipped = len(scanned) - len(added)
-    msg = f"Appended {len(added)} new wristband(s)"
-    if skipped:
-        msg += f" ({skipped} already listed)"
-    return list(existing) + added, msg
+    records += added
+
+    unchanged = len(scanned) - len(added) - renamed
+    parts = []
+    if added:
+        parts.append(f"{len(added)} new")
+    if renamed:
+        parts.append(f"{renamed} renamed")
+    if unchanged:
+        parts.append(f"{unchanged} unchanged")
+    msg = "Appended " + ", ".join(parts) if parts else "No changes"
+    return records, msg
 
 
 # ── device_info.json import (YAMS provisioning format) ───────────────────────

{plasma_app-2.2.2 → plasma_app-2.2.3}/plasma/devices/msense/device.py

@@ -74,6 +74,10 @@ BATTERY_CHAR_UUID = "00002a19-0000-1000-8000-00805f9b34fb"
 
 SQC_MIN_MTU = 128
 SQC_DEBUG = True  # emit per-notification telemetry (printed off the BLE thread)
+# devices with no active SQC/live session still get unsolicited NUS traffic
+# (boot chatter, or firmware that exposes the NUS char but doesn't speak the
+# SQC/live protocol) — coalesce that noise instead of one debug line/packet
+NUS_IDLE_LOG_WINDOW_S = 5.0
 
 # NOTE: the overall per-transaction backstop timeout stays DISABLED — the real
 # BLE data rate is far slower than the handoff doc's provisional 35/45 s
@@ -173,6 +177,11 @@ class MotionSenseHRV(PlasmaDevice):
         # addr -> live INFINITY-stream state (see _new_live_state); only ever
         # one NUS stream (SQC snapshot OR live) active per wristband at a time.
         self.live_state = {}
+        # addr -> {"count", "bytes", "window_start"} — coalesces the
+        # "ignored (no active stream)" debug line so a chatty/idle wristband
+        # doesn't flood the console one line per notification (see
+        # _log_nus_ignored / NUS_IDLE_LOG_WINDOW_S)
+        self._nus_idle_rx = {}
         # addr -> {"status": confirmed|unconfirmed|unverifiable|unknown,
         #          "checked_at": ts} — set by collection_ctl(addr, False), see
         # _confirm_acq_stopped. Cleared on the next collection_ctl(addr, True).
@@ -1325,7 +1334,7 @@ class MotionSenseHRV(PlasmaDevice):
             elif live and live.get("session") and not live["session"].is_terminal:
                 self._handle_live_notification(live, name, bytes(data), now, t_entry)
             else:
-                self._sqc_debug(name, f"rx {len(data)}B ignored (no active stream)")
+                self._log_nus_ignored(name, len(data))
         except Exception as e:
             self.info(f"Error handling NUS data from {name}: {e}")
 
@@ -1520,6 +1529,28 @@ class MotionSenseHRV(PlasmaDevice):
         except queue.Full:
             pass  # never block the BLE thread on a slow console
 
+    def _log_nus_ignored(self, name, nbytes):
+        # first notification in a window prints immediately (so isolated,
+        # one-off chatter is still visible); anything after that within
+        # NUS_IDLE_LOG_WINDOW_S is tallied silently and flushed as one
+        # rolled-up line — keeps a continuously-chattering/no-session
+        # wristband (e.g. firmware that exposes NUS but doesn't speak the
+        # SQC/live protocol) from spamming a line per packet
+        st = self._nus_idle_rx.setdefault(name, {"count": 0, "bytes": 0, "window_start": 0.0})
+        now = time.time()
+        st["count"] += 1
+        st["bytes"] += nbytes
+        if now - st["window_start"] < NUS_IDLE_LOG_WINDOW_S:
+            return
+        if st["count"] > 1:
+            self._sqc_debug(
+                name, f"rx {st['count']}x ({st['bytes']}B total) ignored (no active stream)")
+        else:
+            self._sqc_debug(name, f"rx {nbytes}B ignored (no active stream)")
+        st["count"] = 0
+        st["bytes"] = 0
+        st["window_start"] = now
+
     def _sqc_diag_summary(self, name, store=None):
         d = (store or self.sqc_state).get(name, {}).get("diag")
         if not d:

{plasma_app-2.2.2 → plasma_app-2.2.3}/plasma_app.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plasma-app
-Version: 2.2.2
+Version: 2.2.3
 Summary: PLASMA — Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 License: MIT
 Project-URL: Homepage, https://github.com/YuyiChang/PLASMA
@@ -101,7 +101,7 @@ plugins: `msense`, `qb2`, `pupil`, `shimmer`, `obs` (and `all`).
 - [x] linux aarch64 build — `PLASMA_Linux_arm64` for Jetson Orin (JetPack 6); CI job `build-linux-arm64`
 - [ ] infrequent stream (e.g., PLASMA journaler) shows green after recording stop
 - [ ] doc for msense workflow with better screenshots
-- [ ] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
+- [x] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
 
 ## developing a sensor plugin