pyneurosdk2 1.0.3.0

Python wrapper for NeuroSDK2

Python NeuroSDK 2

Welcome to the Python NeuroSDK 2. The library is intended for python version 3.7 and higher, Windows version 10 and higher.

Documentation

• Installing
• Description
• Searching device
• Connection
• Parameters
• Receiving signal
• Clean up

Installing

pip install pyneurosdk2

Description

The package has the following structure:

• neurosdk - the main package with the implementation of methods with sample
• libs - contain dll library files

The library provides three main modules:

• scanner - to search for devices

from neurosdk.scanner import Scanner

• sensor - methods of interaction with the device

from neurosdk.sensor import Sensor

• types - implementation of all types of the library, you can either connect everything or only those necessary for a specific task

from neurosdk.cmn_types import *

Here is a description of how to work with a BrainBit device.

Searching device

The Scanner class is used to search for a device. For a correct search, you must specify the list of device types, in this case the list will consist of one type - BrainBit. Instance creation:

scanner = Scanner([SensorFamily.SensorLEBrainBit])

Search start:

scanner.Start()

Stop search:

scanner.Stop()

All found devices can be obtained using the method:

sensors = scanner.Sensors()

During the search, an sensorsChanged callback will be called, which will display a list of found devices. If the device leaves the scanner's field of view for any reason, the device will disappear from the list after 12 seconds.

def sensorFound(scanner, sensors):
   for i in range(len(sensors)):
       print('Sensor %s' % sensors[i])

scanner.sensorsChanged = sensorFound

The sensor's list will contain records of the SensorInfo type with fields:

• SensFamily: SensorFamily
• SensModel: int
• Name: str
• Address: str
• SerialNumber: str
• PairingRequired: bool

Connection

Next, you can create any device from the list using the method:

sensor = scanner.CreateSensor(sensInfo)

When created, the device will connect automatically. This is a blocking function, so it is desirable to call it from an separate thread. Upon successful connection, a sensor instance will be returned. If unsuccessful, an exception is thrown. On subsequent connections and disconnections, a callback will be called indicating the state of the device.

To disconnect from the device, use the following method:

sensor.Disconnect()

To connect to a device created but not connected for any reason, the method:

sensor.Connect()

It is blocking too.

Parameters

SDK allows you to get information about the connected device:

print(sensor.SensFamily) # SensorFamily.SensorLEBrainBit
print(sensor.Features) # [<SensorFeature.FeatureSignal: 0>, ...]
print(sensor.Commands) # [<SensorCommand.CommandStartSignal: 0>,...]
print(sensor.Parameters)
print(sensor.Name) # BrainBit
print(sensor.State) # SensorState.StateInRange
print(sensor.Address) # AA:BB:CC:DD:EE:FF
print(sensor.SerialNumber) # 123456
print(sensor.BattPower) # 50
print(sensor.SamplingFrequency) # SensorSamplingFrequency.FrequencyHz250
print(sensor.Gain) # SensorGain.SensorGain6
print(sensor.DataOffset) # SensorDataOffset.DataOffset0
print(sensor.Version) # SensorVersion(FwMajor=50, FwMinor=0, FwPatch=0, HwMajor=1, HwMinor=0, HwPatch=0, ExtMajor=65)

If you need to change any property, you first need to check if it is writable. This can be done by reading the list of device parameters, where each parameter will have an access level:

[ParameterInfo(Param=<SensorParameter.ParameterOffset: 8>, ParamAccess=<SensorParamAccess.ParamAccessRead: 0>),  
 ParameterInfo(Param=<SensorParameter.ParameterState: 1>,  ParamAccess=<SensorParamAccess.ParamAccessReadNotify: 2>)
 ...]

And also check the support of certain modules:

sensor.IsSupportedFeature(sensor_future)
sensor.IsSupportedCommand(sensor_command)
sensor.IsSupportedParameter(sensor_parameter)

Receiving signal

You can start the signal with the following command:

sensor.ExecCommand(SensorCommand.CommandStartSignal)

Stop:

sensor.ExecCommand(SensorCommand.CommandStopSignal)

You can get the signal value using the callback:

def onBrainBitSignalDataReceived(sensor, data):
   print(data)

sensor.brainBitSignalDataReceived = onBrainBitSignalDataReceived

After you have finished working with the signal, you can unsubscribe from the callback as follows:

sensor.brainBitSignalDataReceived = None

It gives a list of packages. Each package contains:

• PackNum: int
• Marker: int
• O1: float
• O2: float
• T3: float
• T4: float

It is values from 4 channels in mV, a number for each packet and a marker if it was sent and this feature is supported by the device.

Similarly, to get resistance values:

def onBrainBitResistDataReceived(sensor, data):
   print(data)

sensor.brainBitResistDataReceived = onBrainBitResistDataReceived

sensor.ExecCommand(SensorCommand.CommandStartResist)
sensor.ExecCommand(SensorCommand.CommandStopResist)

The callback returns one packet of samples, each packet contains the resistance values in mV:

• O1: float
• O2: float
• T3: float
• T4: float

After you have finished working with the resistance, you can unsubscribe from the callback as follows:

sensor.brainBitResistDataReceived = None

Clean up

After you finish working with the device, you need to clean up the resources used. This happens in the destructor of the scanner and sensor, so if they were not called by the system, you must call them manually.

del sensor
del scanner

License

Copyright (c) Brainbit Inc. All rights reserved.

Licensed under the MIT license.