Skip to content

CerebusOSS/CereLink

Folders and files

NameName
Last commit message
Last commit date
Aug 13, 2023
Jun 14, 2023
Jun 14, 2023
Jan 30, 2013
Sep 6, 2023
May 23, 2023
Sep 27, 2023
Sep 27, 2023
Sep 24, 2022
May 16, 2023
Oct 18, 2017
Sep 2, 2021
Dec 8, 2017
Sep 23, 2023
Aug 15, 2023
Sep 5, 2023
Mar 9, 2024
Sep 26, 2018
Aug 13, 2023
Aug 13, 2023
Aug 1, 2023

Repository files navigation

CereLink

Blackrock Microsystems Cerebus Link

The software develoment kit for Blackrock Microsystems neural signal processing hardware includes:

  • c++ library (cbsdk): cross platform library for two-way communication with hardware
  • MATLAB/Octave wrapper (cbmex/cboct): MATLAB executable (mex) to configure and pull data using cbsdk
  • Python wrapper (cerebus.cbpy): Python binding for cbsdk to configure, pull data, and receive callbacks
  • File conversion utility (n2h5): Converts nsx and nev files to hdf5 format

Downloads are on the releases page.

Build

The BUILD.md document has the most up-to-date build instructions.

Usage

Testing with nPlayServer

On Windows, download and install the latest version of Cerebus Central Suite from the Blackrock Neurotech support website (scroll down).

Testing with a localhost client

After installing, navigate an explorer Window to C:\Program Files\Blackrock Microsystems\Cerebus Central Suite\ and run runNPlayAndCentral.bat. This will run a device simulator (nPlayServer) and Central on the localhost loopback. cbsdk / cerebus / cbmex should be able to connect as a Slave (Central is the Master) to the nPlay instance.

Testing with a networked client

If you want to test using nPlayServer on one computer with CereLink on a secondary computer, then you will have to run nPlayServer with special settings. It will also make your life easier if you change the IP address of the network adapter of your Windows machine to mimic that of a Cerebus device (192.168.137.128 for NSP or 192.168.137.200 for Gemini Hub).

Run nPlayServer --help to get a list of available options.

  • Emulating Legacy NSP: nPlayServer -L --network inst=192.168.137.128:51001 --network bcast=192.168.137.255:51002
  • Emulating Gemini Hub: nPlayServer -L --network inst=192.168.137.200:51002 --network bcast=192.168.137.255:51002

cerebus.cbpy

  • Download a wheel from the releases page or build it yourself.
  • Activate a Python environment with pip, Cython, and numpy
  • Install the wheel: pip install path\to\filename.whl
  • Test with python -c "from cerebus import cbpy; cbpy.open(parameter=cbpy.defaultConParams())"
    • You might get RuntimeError: -30, Instrument is offline.. That's OK, depending on your device and network settings.

Getting Help

First, read the frequently asked questions and answers in the project wiki.

Second, search the issues on GitHub.

Finally, open an issue.

This is a community project and is not officially supported by Blackrock Neurotech.