Contributions:RipplePyADC

Introduction

MicroLeadsADC is a source module that allows for utilization of the Micro-Leads StimZ recording and stimulation device within BCI2000.

Video Overview

Versioning

Authors

Dhruva Mehta (mehta@neurotechcenter.org)

Version History

9/22/2023 Initial Creation and Setup

Source Code Revisions

Initial development:
Tested under:
Known to compile under:
Broken since: --

Known Issues

Using the RipplePyADC

To use the Ripple Python ADC, you will need to have a Ripple device that works with Trellis and Ripple's Python API.

Initial Setup

First we will open up the interface executable on the provided laptop. This may be called Stim-Z-GUI or RHD2000Interface.

Trellis

Python API

If you have access to the Python API,

Verifying Device Properties

How to set up with BCPy2000

Now we will set up the research PC. First, follow the BCPy2000 installation guide found [[1]] to install BCPy2000 and compile the solution on your PC.

Creating a Batch File

Debugging

Parameters

SourceCh

The total number of digitized and stored channels. Because of device limitations, this is set to 4 channels explicitly.

SampleBlockSize

Samples per channel per digitized block. Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 1000 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 50 times per second.

SamplingRate

The sample rate of the system. This parameter cannot be edited, and will default to the sampling rate available from the implant which is 21500 Hz. In case you are experiencing problems by higher sampling rates (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications).

SourceChOffset

Offset for each channel.

SourceChGain

Gain for each channel.

ChannelNames

Names of each channel.

ReferenceCh

This list defines what channels will be used as reference. This list is uploaded to the device and set in hardware, effecting the raw bio-signal data that is recorded by BCI2000. If you do not want to effect the raw bio-signal data that is recorded, you can use the spatial filter. If this parameter is set to auto, no reference channels are used.