release: 1.4.15

- auto-select first detected serial port on startup
- disconnect BLE device before SerialUI shutdown teardown
- allow live pyqtgraph zooming/panning without forced range fights
- fix header parser duplicate labels such as _1 and _2

Author: uutzinger

.codex

@@ -217,8 +217,6 @@ On Windows amr64 platform, llvmlite is not available and numba acceleration is n
 
 ## Contributors
 
-Urs Utzinger, 2022-2025 (University of Arizona), 
-
-Cameron K Brooks, 2024 (Western University), 
-
-GPT-5.3, OpenAI
+- Urs Utzinger, 2022-2026 (University of Arizona)
+- Cameron K Brooks, 2024 (Western University)
+- GPT-5.3,4, (OpenAI)

README.md

@@ -117,14 +117,6 @@ def _run_c_parser_selftest_mode() -> int:
 
     errors = []
 
-    try:
-        from line_parsers import simple_parser  # noqa: F401
-        from line_parsers import header_parser  # noqa: F401
-        print("C parser self-test passed (backend=line_parsers)")
-        return 0
-    except Exception as exc:
-        errors.append(f"line_parsers: {exc}")
-
     try:
         from helpers.line_parsers import simple_parser  # noqa: F401
         from helpers.line_parsers import header_parser  # noqa: F401
@@ -133,6 +125,14 @@ def _run_c_parser_selftest_mode() -> int:
     except Exception as exc:
         errors.append(f"helpers.line_parsers: {exc}")
 
+    try:
+        from line_parsers import simple_parser  # noqa: F401
+        from line_parsers import header_parser  # noqa: F401
+        print("C parser self-test passed (backend=line_parsers)")
+        return 0
+    except Exception as exc:
+        errors.append(f"line_parsers: {exc}")
+
     print(
         "C parser self-test failed: " + " | ".join(errors),
         file=sys.stderr,
@@ -1181,6 +1181,11 @@ def closeEvent(self, event):
             f"[{self.instance_name[:15]:<15}]: Finishing workers..."
         )
 
+        # Keep the BLE worker stack alive while the disconnect handshake completes.
+        if USE_BLE and getattr(self, "ble", None) is not None:
+            self.ble.disconnect_before_shutdown(timeout_ms=5000)
+            QCoreApplication.processEvents()
+
         disconnect(self.mtocRequest,             self.serial.on_mtocRequest)
         disconnect(self.mtocRequest,             self.chart.on_mtocRequest)
         disconnect(self.mtocRequest,             self.usbmonitor.on_mtocRequest)

SerialUI.py

@@ -0,0 +1,28 @@
+# Task List
+
+## Auto select Serial Port
+When program boots up and serial port finds a suitable port it should select the first non empty port automatically and not the empty item.
+[Status: done]
+[Implemented: when the serial port list is refreshed and no port is currently connected, the first detected real port is selected instead of the trailing None entry.]
+
+## BLE Connection
+If BLE serial device is already connected to system a scanning attempt will not find it.
+[Status: done]
+[Implemented: on shutdown, SerialUI now requests BLE disconnect before the BLE worker thread and event loop are torn down, so the device is cleanly disconnected when the program closes.]
+
+
+## Zooming and Panning while Life Update
+When charting is paused or stopped one can pan and zoom but when charting is running autoscaling is enabled and one can not zoom into the data while its updating. pyqtgraph has option to deselect plot items in the legend menu. Is it possible to autoscale only to the the items selected in the legend?
+[Status: done for pyqtgraph, postponed for fastplotlib]
+[Implemented: chart updates keep running while pyqtgraph mouse pan/zoom stays enabled. Manual pan/zoom suspends live x/y follow on the changed axis, and pyqtgraph View All or auto-range can re-enable live follow.]
+
+
+## Label Parsing
+With the data shown below received over BLEserial and displayed in terminal and with C accelerated parser enabled I get duplicate legend lables such as CH0_AVG_1 and and CH0_AVG_2 for all of the items except for "corr". The duplicates do not contain data on the chart.
+
+CH0_AVG:836.9,CH0_RMS:120.36,CH1_AVG:827.1,CH1_RMS:0.00,lag:-15,phase_60Hz:-26.0,corr:0.06
+CH0_AVG:837.4,CH0_RMS:120.35,CH1_AVG:827.1,CH1_RMS:0.00,lag:-8,phase_60Hz:-27.9,corr:0.07
+CH0_AVG:837.9,CH0_RMS:120.29,CH1_AVG:827.1,CH1_RMS:0.00,lag:9,phase_60Hz:-20.1,corr:0.06
+
+[Status: done]
+[Implemented: reproduced the duplicate labels in both the Python and C++ header parsers. The root cause was a trailing comma before the next header being interpreted as an extra empty sub-channel, so labels such as CH0_AVG became CH0_AVG_1 and CH0_AVG_2. Both parsers were updated to ignore that separator-only trailing segment, and the C++ parser module was rebuilt in place.]

ToDo.md

@@ -6,7 +6,7 @@
 from helpers.colors import color_names_sweet16 as COLORS
 ################################################################################################################################
 # Constants General
-VERSION                 = "1.4.13"               # this version
+VERSION                 = "1.5.0"               # this version
 AUTHOR                  = "Urs Utzinger"         # me
 DATE                    = "2026"                 # year of last update
 ################################################################################################################################
@@ -52,7 +52,7 @@
 ################################################################################################################################
 # Constants BLE
 # Medibrick
-DEFAULT_TARGET_DEVICE_NAME = "MediBrick"        # The name of the BLE device to search for,  
+DEFAULT_TARGET_DEVICE_NAME = "BLESerialDevice"  # The name of the BLE device to search for if its already connected  
                                                 # Program searches for all Nordic Serial UART service by default
 BLEPIN                  = "123456"              # Known pairing pin for Medibrick_BLE
 # UUIDs for the Nordic Serial UART service and characteristics

config.py

@@ -17,6 +17,7 @@
 from config import (FLUSH_INTERVAL_MS,
                     BLEPIN, 
                     BLESCAN_SHORT, BLESCAN_LONG,
+                    DEFAULT_TARGET_DEVICE_NAME,
                     SERVICE_UUID, RX_CHARACTERISTIC_UUID, TX_CHARACTERISTIC_UUID,
                     USE_BLUETOOTHCTL, BLEMTUMAX, BLEMTUNORMAL, ATT_HDR, BLEMTUDEFAULT,
                     PROFILEME, DEBUGSERIAL, DEBUG_LEVEL,
@@ -673,6 +674,8 @@ def on_deviceListReady(self, devices:list):
         # save current selected device 
         currentIndex   = self.ui.comboBoxDropDown_Device.currentIndex()
         selectedDevice = self.ui.comboBoxDropDown_Device.itemData(currentIndex)
+        selected_address = getattr(selectedDevice, "address", None)
+        current_address = getattr(self.device, "address", None)
 
         self.ui.comboBoxDropDown_Device.blockSignals(True)
         self.ui.comboBoxDropDown_Device.clear()
@@ -681,7 +684,14 @@ def on_deviceListReady(self, devices:list):
 
         # search for previous device and select it
         index_to_select = -1
-        if selectedDevice is not None:
+        if selected_address or current_address:
+            for index in range(self.ui.comboBoxDropDown_Device.count()):
+                device = self.ui.comboBoxDropDown_Device.itemData(index)
+                device_address = getattr(device, "address", None)
+                if device_address and device_address in {selected_address, current_address}:
+                    index_to_select = index
+                    break
+        elif selectedDevice is not None:
             for index in range(self.ui.comboBoxDropDown_Device.count()):
                 if self.ui.comboBoxDropDown_Device.itemData(index) == selectedDevice:
                     index_to_select = index
@@ -1157,6 +1167,66 @@ def on_disconnectingSuccess(self, success):
 
         self.ui.statusBar().showMessage('BLE device  disconnected.', 2000)
 
+    def disconnect_before_shutdown(self, timeout_ms: int = 5000) -> bool:
+        """
+        Request a BLE disconnect while the worker thread and event loop are still alive.
+
+        The disconnect button path works because it always queues the request to the
+        worker and lets the worker decide whether a client is still connected. Reuse
+        that same approach for shutdown instead of relying on cross-thread reads of
+        `client.is_connected`, which can be stale or already cleared by teardown.
+        """
+        bleakWorker = getattr(self, "bleakWorker", None)
+        if not bleakWorker or not qobject_alive(bleakWorker):
+            return False
+
+        try:
+            bleakWorker.reconnect = False
+        except Exception:
+            pass
+
+        button_connected = False
+        try:
+            button_connected = (self.ui.pushButton_BLEConnect.text() == "Disconnect")
+        except Exception:
+            pass
+
+        client = getattr(bleakWorker, "client", None)
+        needs_disconnect = any((
+            button_connected,
+            bool(client is not None),
+            bool(getattr(bleakWorker, "disconnecting", False)),
+            bool(self.device_info.get("connected", False)),
+            bool(self.receiverIsRunning),
+        ))
+        if not needs_disconnect:
+            return False
+
+        self.logSignal.emit(logging.INFO,
+            f"[{self.instance_name[:15]:<15}]: Requesting BLE device disconnect before shutdown."
+        )
+        if not getattr(bleakWorker, "disconnecting", False):
+            self.disconnectDeviceRequest.emit()
+
+        ok, args, reason = wait_for_signal(
+            bleakWorker.disconnectingSuccess,
+            timeout_ms=timeout_ms,
+            sender=bleakWorker,
+        )
+        if not ok and reason != "destroyed":
+            self.logSignal.emit(logging.WARNING,
+                f"[{self.instance_name[:15]:<15}]: BLE disconnect before shutdown timed out because of {reason}."
+            )
+            return False
+
+        if args and args[0] is False:
+            self.logSignal.emit(logging.WARNING,
+                f"[{self.instance_name[:15]:<15}]: BLE disconnect before shutdown reported failure."
+            )
+            return False
+
+        return bool(ok)
+
     # Bluetoothctl SUCCESS
     # ----------------------------------------
 
@@ -1270,6 +1340,9 @@ def cleanup(self):
         btWorker    = getattr(self, "bluetoothctlWorker", None)
         btThread    = getattr(self, "bluetoothctlThread", None)
 
+        # Explicit disconnect must happen before the worker thread is asked to finish.
+        self.disconnect_before_shutdown(timeout_ms=5000)
+
         # Request both workers to finish (single signal wired to both)
         self.finishWorkerRequest.emit()
 
@@ -1926,17 +1999,35 @@ async def _scanDevices(self, timeout: float = BLESCAN_LONG):
             )
 
         self.NSUdevices = []
+        seen_addresses = set()
+        known_addresses = {
+            getattr(self.device, "address", None),
+            getattr(self.device_backup, "address", None),
+        }
+        known_addresses = {address for address in known_addresses if address}
+        known_names = {
+            getattr(self.device, "name", None),
+            getattr(self.device_backup, "name", None),
+            DEFAULT_TARGET_DEVICE_NAME,
+        }
+        known_names = {name.strip() for name in known_names if isinstance(name, str) and name.strip()}
         for device, adv in devices.values():
             self.logSignal.emit(logging.INFO, 
                 f"[{self.instance_name[:15]:<15}]: Found device: {device.name} ({device.address}) RSSI: {adv.rssi} dBm"
             )
             suids = adv.service_uuids or ()
-            for service_uuid in suids:
-                # self.logSignal.emit(logging.INFO, 
-                #     f"[{self.instance_name[:15]:<15}]: Found service UUID: {service_uuid}"
-                # )
-                if service_uuid.lower() == SERVICE_UUID.lower():
+            service_match = any(service_uuid.lower() == SERVICE_UUID.lower() for service_uuid in suids)
+            name_match = bool(device.name and device.name.strip() in known_names)
+            address_match = bool(device.address and device.address in known_addresses)
+
+            if service_match or name_match or address_match:
+                if device.address not in seen_addresses:
                     self.NSUdevices.append(device)
+                    seen_addresses.add(device.address)
+                if not service_match and (name_match or address_match):
+                    self.logSignal.emit(logging.INFO,
+                        f"[{self.instance_name[:15]:<15}]: Keeping known BLE device without advertised NUS UUID: {device.name} ({device.address})"
+                    )
 
         if not self.NSUdevices:
             self.logSignal.emit(logging.INFO,