From c446e1bf1ce3e071eff919dccc77f77d7e0bc241 Mon Sep 17 00:00:00 2001 From: Mark Nolan Date: Thu, 24 Sep 2026 17:52:38 +0100 Subject: [PATCH] DEV-1047: tell a NeuroLynQ-mode Verisense from a stock one Both enumerate as 1915:520F. The NeuroLynQ firmware says which it is in its USB product string instead (verisense-firmware #654): "-NeuroLynQ" after the name prefix, whichever prefix the unit carries, as in Verisense-NeuroLynQ-01-2511210195BC. DEV-1047 settled on that string as the only signal, with no PID change. SH_SEARCH.VERISENSE_NEUROLYNQ and isVerisenseNeuroLynQ() are that rule. The two kinds need different drivers: a NeuroLynQ-mode Verisense serves the ShimmerGQ $ dock protocol, and not its native one. API_00013 covers the bench node's string, the unprovisioned and provisioned-prefix forms, a stock unit, and the nRF52840 Span, which says NeuroLynQ too but is not a node. Co-Authored-By: Claude Opus 5.5 --- .../HwDriverShimmerDeviceDetails.java | 16 ++++++ ...PI_00013_VerisenseNeuroLynQMarkerTest.java | 52 +++++++++++++++++++ 2 files changed, 68 insertions(+) create mode 100644 ShimmerDriver/src/test/java/com/shimmerresearch/driverUtilities/API_00013_VerisenseNeuroLynQMarkerTest.java diff --git a/ShimmerDriver/src/main/java/com/shimmerresearch/driverUtilities/HwDriverShimmerDeviceDetails.java b/ShimmerDriver/src/main/java/com/shimmerresearch/driverUtilities/HwDriverShimmerDeviceDetails.java index 82f3f9d78..f42a11aac 100644 --- a/ShimmerDriver/src/main/java/com/shimmerresearch/driverUtilities/HwDriverShimmerDeviceDetails.java +++ b/ShimmerDriver/src/main/java/com/shimmerresearch/driverUtilities/HwDriverShimmerDeviceDetails.java @@ -177,6 +177,14 @@ public static final class MASS_STORAGE_DEVICE { "verisense", }; + /** A Verisense in NeuroLynQ mode says so in its USB product string, e.g. + * "Verisense-NeuroLynQ-01-2511210195BC" (verisense-firmware hal_usb_cdc.c, + * USB_PRODUCT_NAME_MODE_MARKER). It keeps the stock VID/PID, so this is the only + * way a host can tell it from a stock unit (DEV-1047). */ + public static final String[] VERISENSE_NEUROLYNQ = new String[] { + "-NeuroLynQ-", + }; + public static final String[] SHIMMER3R_DFU_DEVICE_BUS_DESCRITION = new String[] { "DFU in HS Mode" }; public static final class SERVICE_DESCRIPTION { @@ -351,6 +359,14 @@ public static boolean isSpanNrf52840(String usbVendorId, String usbProductString && usbProductString!=null && UtilShimmer.stringContainsItemFromListUpperCaseCheck(usbProductString, SH_SEARCH.SPAN_NRF52840); } + + /** Whether a Verisense is in NeuroLynQ mode, from its USB product string (iProduct). + * A NeuroLynQ-mode Verisense serves the ShimmerGQ $ dock protocol and not its native + * one, so the two need different drivers. */ + public static boolean isVerisenseNeuroLynQ(String usbProductString) { + return usbProductString!=null + && UtilShimmer.stringContainsItemFromListUpperCaseCheck(usbProductString, SH_SEARCH.VERISENSE_NEUROLYNQ); + } public static DEVICE_TYPE getDeviceTypeFromLabel(String label){ for (DEVICE_TYPE deviceType:DEVICE_TYPE.values()) { diff --git a/ShimmerDriver/src/test/java/com/shimmerresearch/driverUtilities/API_00013_VerisenseNeuroLynQMarkerTest.java b/ShimmerDriver/src/test/java/com/shimmerresearch/driverUtilities/API_00013_VerisenseNeuroLynQMarkerTest.java new file mode 100644 index 000000000..a544dabea --- /dev/null +++ b/ShimmerDriver/src/test/java/com/shimmerresearch/driverUtilities/API_00013_VerisenseNeuroLynQMarkerTest.java @@ -0,0 +1,52 @@ +package com.shimmerresearch.driverUtilities; + +import static org.junit.Assert.assertFalse; +import static org.junit.Assert.assertTrue; + +import org.junit.Test; + +/** + * How the host tells a NeuroLynQ-mode Verisense from a stock one (DEV-1047). + *

+ * Both enumerate as 1915:520F. The NeuroLynQ firmware adds "-NeuroLynQ" after the name + * prefix in its USB product string, whichever prefix it has, and nothing else changes. + * The first string is the bench node's on 2026-09-24. + */ +public class API_00013_VerisenseNeuroLynQMarkerTest { + + @Test + public void recognisesTheNeuroLynQMarker() { + assertTrue(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("Verisense-NeuroLynQ-01-2511210195BC")); + } + + /** Without a passkey ID, and with the factory string an unprovisioned unit reports */ + @Test + public void recognisesItWithoutAPasskeyOrAProductionConfig() { + assertTrue(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("Verisense-NeuroLynQ-2511210195BC")); + assertTrue(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("Verisense-NeuroLynQ-FFFFFFFF95BC")); + } + + /** The marker follows whatever name prefix the production config carries */ + @Test + public void recognisesItAfterAProvisionedPrefix() { + assertTrue(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("Acme-NeuroLynQ-01-2511210195BC")); + } + + @Test + public void aStockVerisenseIsNotNeuroLynQ() { + assertFalse(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("Verisense-01-2511210195BC")); + assertFalse(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("Verisense-FFFFFFFF95BC")); + } + + /** The nRF52840 Span says NeuroLynQ too, but it is a Span, not a node */ + @Test + public void theSpanIsNotANode() { + assertFalse(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("NeuroLynQ Span")); + } + + @Test + public void noProductStringIsNotNeuroLynQ() { + assertFalse(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ(null)); + assertFalse(HwDriverShimmerDeviceDetails.isVerisenseNeuroLynQ("")); + } +}