ezmsg-blackrock 0.1.0__tar.gz

ezmsg_blackrock-0.1.0/.github/workflows/python-publish-ezmsg-blackrock.yml

@@ -0,0 +1,26 @@
+name: Upload Python Package - ezmsg-blackrock
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: build and upload release to PyPI
+    runs-on: ubuntu-latest
+    environment: "release"
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+
+      - name: Build Package
+        run: uv build
+
+      - name: Publish package distributions to PyPI
+        run: uv publish

ezmsg_blackrock-0.1.0/.github/workflows/python-tests.yml

@@ -0,0 +1,41 @@
+name: Test package
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        python-version: [3.9, "3.10", "3.11", "3.12"]
+        os:
+          - "ubuntu-latest"
+          - "windows-latest"
+          - "macos-latest"
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install the project
+        run: uv sync --all-extras --dev
+
+      - name: Lint
+        run:
+          uv tool run ruff check --output-format=github src
+
+      - name: Run tests
+        run: uv run pytest tests

ezmsg_blackrock-0.1.0/.gitignore

@@ -0,0 +1,162 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+src/ezmsg/blackrock/__version__.py

ezmsg_blackrock-0.1.0/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2023 Johns Hopkins University Applied Physics Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

ezmsg_blackrock-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.3
+Name: ezmsg-blackrock
+Version: 0.1.0
+Summary: Blackrock Cerebus ecosystem interface for ezmsg
+Author-email: Griffin Milsap <chadwick.boulay@gmail.com>, Chadwick Boulay <chadwick.boulay@gmail.com>
+Requires-Python: >=3.9
+Requires-Dist: ezmsg-event
+Requires-Dist: ezmsg>=3.6.0
+Requires-Dist: pycbsdk>=0.2.0
+Provides-Extra: test
+Requires-Dist: pytest>=8.3.3; extra == 'test'
+Description-Content-Type: text/markdown
+
+# ezmsg.blackrock
+
+Interface for Blackrock Cerebus ecosystem (incl. Neuroport) using `pycbsdk`
+
+## Installation
+`pip install git+https://github.com/CerebusOSS/ezmsg-blackrock`
+
+## Dependencies
+
+* `python` >=3.9
+* `pycbsdk` 
+* `ezmsg-sigproc`
+
+## Setup (Development)
+
+1. Install `ezmsg` either using `pip install ezmsg` or set up the repo for development as described in the `ezmsg` readme.
+2. `cd` to this directory and run `pip install -e .`
+3. Blackrock components are available under `import ezmsg.blackrock`
+
+## Setup Notes
+
+__IMPORTANT NOTE:__ _`pycbsdk` is only compatible with Central Neuroport/Cerebus Suite/NSP Firmware `7.0.5+`, built using `cbhwlib`/hardware library/network protocol `3.11+`.  Anything older is not supported by `pycbsdk`_.  Check this requirement in Central by navigating to `Help > About Central`
+
+Blackrock Neuroport/Cerebus uses UDP multicast traffic to deliver upwards of 30000 packets/sec of data with low latency.  There are better ways to do this now, but back when this hardware was made, the engineers were dealing with the limitations of the hardware they had.  UDP comes with no packet delivery guarantee, but dropped packets can be catastrophic when interfacing with the Blackrock hardware.  As such, do your best to locate the highest quality networking equipment you can find, and have a high tolerance for blaming ethernet adapters and/or your router/switch for errors during troubleshooting.
+
+The NSP startup procedure involves blasting several thousand UDP packets from the NSP to the interfacing computer in a few milliseconds.  Many low-quality adapters and network switches will simply drop some of these UDP packets, but this will result in errors during startup.
+
+### Hardware Setup
+
+This setup describes a setup with a Legacy NSP, a Windows PC (called "Central PC") running Central Suite that can configure the NSP, and a third machine (Windows, MacOS, or Linux) that will be running `ezmsg-blackrock`, henceforth forward referred to as the "Client PC". The documentation highlights the differences when using Blockrock's newer ("Gemini") NSP and Hubs.
+
+Central cannot run on the same PC simultaneously as `ezmsg-blackrock` because `pycbsdk` exclusively binds the port that central would use to communicate with the NSP.  The NSP has too many settings to implement in `ezmsg-blackrock`, so in practice, we use Central to configure the NSP then acquire live data thereafter.  If you want to, you _can_ use `ezmsg-blackrock` on the Central PC once you've configured the NSP and closed Central.  When you do this, the Central PC and the Client PC are the same PC/IP address.  Its assumed that this PC is running windows because Central Suite is only available on Windows.
+
+Find the highest quality ethernet (yes, wired) network switch or router that you can.  Look for 1+ Gigabit speed ratings (2.5 Gigabit better, 10 Gigabit is best), and features like QoS (Quality of Service) that can guarantee packet delivery. Ensure both the Central PC and the Client PC have high quality ethernet network adapters.  Not every ethernet adapter will work, due to packet buffering requirements. High quality ethernet cables are also important; aim for Cat6E or better.
+
+1. Attach the NSP, Central PC, and Client PC to the router or switch using ethernet cables.
+1. Blackrock NSP and Gemini Hubs use hard-coded static IP addresses.
+    * If using a router (recommended), configure the router to sit at `192.168.137.254` and configure static DHCP assignments (mapping adapter MAC addresses to preset IP addresses) for:
+        * NSP (Legacy or Gemini) -- `192.168.137.128`
+        * Gemini Hub1 -- `192.168.137.200`
+        * Gemini Hub2 -- `192.168.137.201`
+        * Central PC -- `192.168.137.1` (Central likes to run on IP addresses below `192.168.137.16`)
+        * Client PC -- `192.168.137.32` (Arbitrary address within subnet)
+    * If using a network switch, configure the network adapters on the Central PC and Client PC to the aforementioned IP addresses
+1. At this point, it's handy to make sure you can ping the NSP and Client PC from the Central PC and that you can ping the NSP and the Central PC from the Client PC.  Adjust firewall settings accordingly, enabling multicast UDP traffic on the ethernet adapters, and all TCP/UDP traffic on ports `51001` and `51002`.
+1. Download and install the Central Suite on the Central PC from the [Blackrock Support](https://blackrockneurotech.com/support/) site: 
+    * The public "Cerebus Central Suite" will not function with the FDA approved Neuroport system, which will instead require the "Neuroport Central Suite".  Acquiring this installer will require you to submit a ticket to Blackrock Support because the download is NOT public.
+
+#### Emulate an NSP (Useful for development without an NSP)
+
+It is possible to emulate Blackrock hardware while playing back previously recorded data using a software tool called "nPlayServer".
+The publicly-available and supported nPlayServer is only available on Windows but unsupported Mac and Linux binaries (x86 or ARM) are available. Open an issue to ask.  
+
+1. Power down the NSP if you already have it on the switch/router.
+1. Download and extract the "Real Sample Data" from the [Blackrock Support](https://blackrockneurotech.com/support/) site. Extract the `*.ns6` file somewhere memorable in the filesystem (like `Documents`)
+1. Run nPlayServer. On Windows, use the nPlayServer shortcut on the desktop to start Central and use the nPlay control window to navigate to the `*.ns6` file directory, select the file to replay, and start replaying it.  Then close Central/nPlayServer. This is important for using the `-L` flag with `nPlayServer.exe` later.
+1. Navigate to the installation directory (e.g., "C:\Program Files\Blackrock Microsystems\Cerebus Central Suite") and locate the `nPlayServer.exe` executable.  Right click it and create a shortcut on the desktop.
+1. Rename the shortcut to "Simulate NSP" or another friendly name.
+
+If your intention is to only test on 'localhost' (i.e., ezmsg-blackrock and nPlayServer on the same machine), then there is nothing more to be done.
+However, if your intention is for the emulation PC to be a different machine than the client PC, nPlayServer must be configured to work over the network.
+
+1. Reconfigure the emulation host PC to have an IP address matching the emulated device (see addresses listed above). 
+1. Right click the shortcut and go to "Properties".  Set the "Target" line to: `"C:\Program Files (x86)\Blackrock Microsystems\Neuroport Central Suite\nPlayServer.exe" --network bcast=192.168.137.255:51002 --network inst=192.168.137.128:51001 -L`, adjusting for the actual install path of your Central suite.
+    * `bcast` address is `.255` because that's the UDP multicast address.
+    * `inst` address is `.128` to emulate Legacy NSP. See the list above for Gemini hardware. Also, Gemini hardware requires the instrument port to be set to `51002`.
+    * `-L` uses the last `.nsX` file for replay.  You can also manually specify an `.nsX` file for replay, but be aware nothing will replay when using `-L` if you've never replayed a file using nPlayServer, or if that file has moved or no longer exists.
+
+### Software Setup
+
+* Use Central to set up the NSP hardware.
+* If running Central and `ezmsg-blackrock` on the same PC, shut down Central
+* Assuming `pycbsdk` is installed in your python environment (which it should be, considering it's a dependency of `ezmsg-blackrock` that automatically gets installed with a `pip install -e .`), you should have the `pycbsdk-rates` command on your path.  Test the connection and hardware/software setup using `pycbsdk-rates --inst_addr 192.168.137.128 --inst_port 51001 --protocol 3.11`
+    * Note that this command line is for Legacy NSP with hard-coded address `192.168.137.128` running on port 51001
+    * Also note that network protocol is not automatically detected.  Our old hardware can only be updated to firmware `7.0.6` which uses hardware library/protocol `3.11`.  This can be checked by opening Central and navigating to "About Central" which will tell you which hardware library the firmware is running (assuming your NSP's firmware and Central version match). As of this writing, most Gemini hardware should be using protocol 4.1 (default).
+
+### Troubleshooting
+
+* When in doubt, restart equipment.
+* Try software multiple times.  If you get different results every time you run, you might have ethernet adapters/network equipment of insufficient quality (it might be dropping packets, especially during configuration).
+* Make sure the Central PC and the Client PC can ping each other and the NSP.
+* Ensure NSP Firmware matches Central version.
+* Ensure the protocol version you specify matches the firmware's protocol version.
+* `pycbsdk-rates` and Wireshark + [a dissector](https://github.com/CerebusOSS/CerebusWireshark) are your friends. Godspeed.

ezmsg_blackrock-0.1.0/README.md

@@ -0,0 +1,84 @@
+# ezmsg.blackrock
+
+Interface for Blackrock Cerebus ecosystem (incl. Neuroport) using `pycbsdk`
+
+## Installation
+`pip install git+https://github.com/CerebusOSS/ezmsg-blackrock`
+
+## Dependencies
+
+* `python` >=3.9
+* `pycbsdk` 
+* `ezmsg-sigproc`
+
+## Setup (Development)
+
+1. Install `ezmsg` either using `pip install ezmsg` or set up the repo for development as described in the `ezmsg` readme.
+2. `cd` to this directory and run `pip install -e .`
+3. Blackrock components are available under `import ezmsg.blackrock`
+
+## Setup Notes
+
+__IMPORTANT NOTE:__ _`pycbsdk` is only compatible with Central Neuroport/Cerebus Suite/NSP Firmware `7.0.5+`, built using `cbhwlib`/hardware library/network protocol `3.11+`.  Anything older is not supported by `pycbsdk`_.  Check this requirement in Central by navigating to `Help > About Central`
+
+Blackrock Neuroport/Cerebus uses UDP multicast traffic to deliver upwards of 30000 packets/sec of data with low latency.  There are better ways to do this now, but back when this hardware was made, the engineers were dealing with the limitations of the hardware they had.  UDP comes with no packet delivery guarantee, but dropped packets can be catastrophic when interfacing with the Blackrock hardware.  As such, do your best to locate the highest quality networking equipment you can find, and have a high tolerance for blaming ethernet adapters and/or your router/switch for errors during troubleshooting.
+
+The NSP startup procedure involves blasting several thousand UDP packets from the NSP to the interfacing computer in a few milliseconds.  Many low-quality adapters and network switches will simply drop some of these UDP packets, but this will result in errors during startup.
+
+### Hardware Setup
+
+This setup describes a setup with a Legacy NSP, a Windows PC (called "Central PC") running Central Suite that can configure the NSP, and a third machine (Windows, MacOS, or Linux) that will be running `ezmsg-blackrock`, henceforth forward referred to as the "Client PC". The documentation highlights the differences when using Blockrock's newer ("Gemini") NSP and Hubs.
+
+Central cannot run on the same PC simultaneously as `ezmsg-blackrock` because `pycbsdk` exclusively binds the port that central would use to communicate with the NSP.  The NSP has too many settings to implement in `ezmsg-blackrock`, so in practice, we use Central to configure the NSP then acquire live data thereafter.  If you want to, you _can_ use `ezmsg-blackrock` on the Central PC once you've configured the NSP and closed Central.  When you do this, the Central PC and the Client PC are the same PC/IP address.  Its assumed that this PC is running windows because Central Suite is only available on Windows.
+
+Find the highest quality ethernet (yes, wired) network switch or router that you can.  Look for 1+ Gigabit speed ratings (2.5 Gigabit better, 10 Gigabit is best), and features like QoS (Quality of Service) that can guarantee packet delivery. Ensure both the Central PC and the Client PC have high quality ethernet network adapters.  Not every ethernet adapter will work, due to packet buffering requirements. High quality ethernet cables are also important; aim for Cat6E or better.
+
+1. Attach the NSP, Central PC, and Client PC to the router or switch using ethernet cables.
+1. Blackrock NSP and Gemini Hubs use hard-coded static IP addresses.
+    * If using a router (recommended), configure the router to sit at `192.168.137.254` and configure static DHCP assignments (mapping adapter MAC addresses to preset IP addresses) for:
+        * NSP (Legacy or Gemini) -- `192.168.137.128`
+        * Gemini Hub1 -- `192.168.137.200`
+        * Gemini Hub2 -- `192.168.137.201`
+        * Central PC -- `192.168.137.1` (Central likes to run on IP addresses below `192.168.137.16`)
+        * Client PC -- `192.168.137.32` (Arbitrary address within subnet)
+    * If using a network switch, configure the network adapters on the Central PC and Client PC to the aforementioned IP addresses
+1. At this point, it's handy to make sure you can ping the NSP and Client PC from the Central PC and that you can ping the NSP and the Central PC from the Client PC.  Adjust firewall settings accordingly, enabling multicast UDP traffic on the ethernet adapters, and all TCP/UDP traffic on ports `51001` and `51002`.
+1. Download and install the Central Suite on the Central PC from the [Blackrock Support](https://blackrockneurotech.com/support/) site: 
+    * The public "Cerebus Central Suite" will not function with the FDA approved Neuroport system, which will instead require the "Neuroport Central Suite".  Acquiring this installer will require you to submit a ticket to Blackrock Support because the download is NOT public.
+
+#### Emulate an NSP (Useful for development without an NSP)
+
+It is possible to emulate Blackrock hardware while playing back previously recorded data using a software tool called "nPlayServer".
+The publicly-available and supported nPlayServer is only available on Windows but unsupported Mac and Linux binaries (x86 or ARM) are available. Open an issue to ask.  
+
+1. Power down the NSP if you already have it on the switch/router.
+1. Download and extract the "Real Sample Data" from the [Blackrock Support](https://blackrockneurotech.com/support/) site. Extract the `*.ns6` file somewhere memorable in the filesystem (like `Documents`)
+1. Run nPlayServer. On Windows, use the nPlayServer shortcut on the desktop to start Central and use the nPlay control window to navigate to the `*.ns6` file directory, select the file to replay, and start replaying it.  Then close Central/nPlayServer. This is important for using the `-L` flag with `nPlayServer.exe` later.
+1. Navigate to the installation directory (e.g., "C:\Program Files\Blackrock Microsystems\Cerebus Central Suite") and locate the `nPlayServer.exe` executable.  Right click it and create a shortcut on the desktop.
+1. Rename the shortcut to "Simulate NSP" or another friendly name.
+
+If your intention is to only test on 'localhost' (i.e., ezmsg-blackrock and nPlayServer on the same machine), then there is nothing more to be done.
+However, if your intention is for the emulation PC to be a different machine than the client PC, nPlayServer must be configured to work over the network.
+
+1. Reconfigure the emulation host PC to have an IP address matching the emulated device (see addresses listed above). 
+1. Right click the shortcut and go to "Properties".  Set the "Target" line to: `"C:\Program Files (x86)\Blackrock Microsystems\Neuroport Central Suite\nPlayServer.exe" --network bcast=192.168.137.255:51002 --network inst=192.168.137.128:51001 -L`, adjusting for the actual install path of your Central suite.
+    * `bcast` address is `.255` because that's the UDP multicast address.
+    * `inst` address is `.128` to emulate Legacy NSP. See the list above for Gemini hardware. Also, Gemini hardware requires the instrument port to be set to `51002`.
+    * `-L` uses the last `.nsX` file for replay.  You can also manually specify an `.nsX` file for replay, but be aware nothing will replay when using `-L` if you've never replayed a file using nPlayServer, or if that file has moved or no longer exists.
+
+### Software Setup
+
+* Use Central to set up the NSP hardware.
+* If running Central and `ezmsg-blackrock` on the same PC, shut down Central
+* Assuming `pycbsdk` is installed in your python environment (which it should be, considering it's a dependency of `ezmsg-blackrock` that automatically gets installed with a `pip install -e .`), you should have the `pycbsdk-rates` command on your path.  Test the connection and hardware/software setup using `pycbsdk-rates --inst_addr 192.168.137.128 --inst_port 51001 --protocol 3.11`
+    * Note that this command line is for Legacy NSP with hard-coded address `192.168.137.128` running on port 51001
+    * Also note that network protocol is not automatically detected.  Our old hardware can only be updated to firmware `7.0.6` which uses hardware library/protocol `3.11`.  This can be checked by opening Central and navigating to "About Central" which will tell you which hardware library the firmware is running (assuming your NSP's firmware and Central version match). As of this writing, most Gemini hardware should be using protocol 4.1 (default).
+
+### Troubleshooting
+
+* When in doubt, restart equipment.
+* Try software multiple times.  If you get different results every time you run, you might have ethernet adapters/network equipment of insufficient quality (it might be dropping packets, especially during configuration).
+* Make sure the Central PC and the Client PC can ping each other and the NSP.
+* Ensure NSP Firmware matches Central version.
+* Ensure the protocol version you specify matches the firmware's protocol version.
+* `pycbsdk-rates` and Wireshark + [a dissector](https://github.com/CerebusOSS/CerebusWireshark) are your friends. Godspeed.

ezmsg_blackrock-0.1.0/examples/demo.py

@@ -0,0 +1,80 @@
+import sys
+
+import ezmsg.core as ez
+from ezmsg.util.debuglog import DebugLog
+import typer
+from typing_extensions import Annotated
+
+from ezmsg.blackrock.nsp import NSPSource, NSPSourceSettings
+
+
+def main(
+    inst_addr: Annotated[
+        str,
+        typer.Option(
+            help="ipv4 address of device. pycbsdk will send control packets to this address. Subnet OK. Use 127.0.0.1 "
+            "for use with nPlayServer (non-bcast). The default is 0.0.0.0 (IPADDR_ANY) on Mac and Linux. On "
+            "Windows, known IPs will be searched."
+        ),
+    ] = "192.168.137.128",
+    inst_port: Annotated[
+        int,
+        typer.Option(
+            help="Network port to send control packets. Use 51002 for Gemini and 51001 for Legacy NSP."
+        ),
+    ] = 51001,
+    client_addr: Annotated[
+        str,
+        typer.Option(
+            help="ipv4 address of this machine's network adapter we will receive packets on. Defaults to INADDR_ANY. "
+            "If address is provided, assumes Cerebus Subnet."
+        ),
+    ] = "",
+    client_port: Annotated[
+        int,
+        typer.Option(
+            help="Network port to receive packets. This should always be 51002."
+        ),
+    ] = 51002,
+    recv_bufsize: Annotated[
+        int, typer.Option(help="UDP socket recv buffer size.")
+    ] = (8 if sys.platform == "win32" else 6) * 1024 * 1024,
+    protocol: Annotated[
+        str, typer.Option(help="Protocol Version. 3.11, 4.0, or 4.1 supported.")
+    ] = "3.11",
+    cont_buffer_dur: Annotated[
+        float,
+        typer.Option(
+            help="Duration of buffer for continuous data. Note: buffer may occupy ~15 MB / second."
+        ),
+    ] = 0.5,
+):
+    source_settings = NSPSourceSettings(
+        inst_addr,
+        inst_port,
+        client_addr,
+        client_port,
+        recv_bufsize,
+        protocol,
+        cont_buffer_dur,
+    )
+
+    comps = {
+        "SRC": NSPSource(source_settings),
+        # TODO: SparseResample(fs=1000.0, max_age=0.005),
+        # TODO: EventRates(),
+        "SPKLOG": DebugLog(name="SPK"),
+        "GRPLOG": DebugLog(name="GRP"),
+    }
+
+    conns = (
+        (comps["SRC"].OUTPUT_SPIKE, comps["SPKLOG"].INPUT),
+        (comps["SRC"].OUTPUT_SIGNAL, comps["GRPLOG"].INPUT),
+    )
+
+    ez.run(components=comps, connections=conns)
+
+
+
+if __name__ == "__main__":
+    typer.run(main)

ezmsg_blackrock-0.1.0/examples/enable_cont.py

@@ -0,0 +1,74 @@
+import sys
+import time
+from typing_extensions import Annotated
+
+from pycbsdk import cbsdk
+from pycbsdk.cbhw.packet.common import CBChannelType
+import typer
+
+
+def main(
+    smp_group: int,
+    inst_addr: Annotated[
+        str,
+        typer.Option(
+            help="ipv4 address of device. pycbsdk will send control packets to this address. Subnet OK. Use 127.0.0.1 "
+            "for use with nPlayServer (non-bcast). The default is 0.0.0.0 (IPADDR_ANY) on Mac and Linux. On "
+            "Windows, known IPs will be searched."
+        ),
+    ] = "192.168.137.128",
+    inst_port: Annotated[
+        int,
+        typer.Option(
+            help="Network port to send control packets. Use 51002 for Gemini and 51001 for Legacy NSP."
+        ),
+    ] = 51001,
+    client_addr: Annotated[
+        str,
+        typer.Option(
+            help="ipv4 address of this machine's network adapter we will receive packets on. Defaults to INADDR_ANY. "
+            "If address is provided, assumes Cerebus Subnet."
+        ),
+    ] = "",
+    client_port: Annotated[
+        int,
+        typer.Option(
+            help="Network port to receive packets. This should always be 51002."
+        ),
+    ] = 51002,
+    recv_bufsize: Annotated[
+        int, typer.Option(help="UDP socket recv buffer size.")
+    ] = (8 if sys.platform == "win32" else 6) * 1024 * 1024,
+    protocol: Annotated[
+        str, typer.Option(help="Protocol Version. 3.11, 4.0, or 4.1 supported.")
+    ] = "3.11",
+):
+
+    params = cbsdk.create_params(
+        inst_addr=inst_addr,
+        inst_port=inst_port,
+        client_addr=client_addr,
+        client_port=client_port,
+        recv_bufsize=recv_bufsize,
+        protocol=protocol,
+    )
+    device = cbsdk.NSPDevice(params)
+    run_level = device.connect(startup_sequence=False)
+    if not run_level:
+        raise ValueError(f"Failed to connect to NSP; {params=}")
+    config = cbsdk.get_config(device, force_refresh=True)
+    for chid in [
+        k
+        for k, v in config["channel_infos"].items()
+        if config["channel_types"][k]
+           in (CBChannelType.FrontEnd, CBChannelType.AnalogIn)
+    ]:
+        _ = cbsdk.set_channel_config(
+            device, chid, "smpgroup", smp_group
+        )
+    # Refresh config
+    time.sleep(0.5)  # Make sure all the config packets have returned.
+
+
+if __name__ == "__main__":
+    typer.run(main)

ezmsg_blackrock-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "ezmsg-blackrock"
+description = "Blackrock Cerebus ecosystem interface for ezmsg"
+authors = [
+  { name = "Griffin Milsap", email = "chadwick.boulay@gmail.com" },
+  { name = "Chadwick Boulay", email = "chadwick.boulay@gmail.com" },
+]
+readme = "README.md"
+requires-python = ">=3.9"
+dynamic = ["version"]
+dependencies = [
+    "ezmsg-event",
+    "ezmsg>=3.6.0",
+    "pycbsdk>=0.2.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.3.3",
+]
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/ezmsg/blackrock/__version__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ezmsg"]
+
+[tool.uv]
+dev-dependencies = [
+    "ruff>=0.6.8",
+    "typer>=0.12.5",
+]

ezmsg_blackrock-0.1.0/src/ezmsg/blackrock/__init__.py

@@ -0,0 +1 @@
+from .__version__ import __version__ as __version__

ezmsg_blackrock-0.1.0/src/ezmsg/blackrock/__version__.py

@@ -0,0 +1,16 @@
+# file generated by setuptools_scm
+# don't change, don't track in version control
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple, Union
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)