RDA tools (rdatools)

Some useful tools to work with BrainVision RDA (Remote Data Access) API

rdatools.check_received(n, msg)

Checks whether the message is completely received. If OK, return nothing, else, raises an exception

Parameters :

n : int

number of bytes received (returned by socket.recv_int())

msg : ctypes structure

message received

rdatools.rda_read_data_msg(s, hdr, nChannels)

Reads an RDA data message from socket given the header

Parameters :

s : socket

socket object

hdr : rda_msg_hdr_t

message header

nChannels : int

number of channels (from start message)

Returns :

msg : rda_msg_data_full_t

complete data message including variable fields

rdatools.rda_read_start_msg(s, hdr)

Reads an RDA start message from socket given the header

Parameters :

s : socket

socket object

hdr : rda_msg_hdr_t

message header

Returns :

mgs : rda_msg_start_full_t

complete start message including variable fields

rdatools.startmsg2string(msg)

Converts an RDA start message (rda_msg_start_full_t) to string

Parameters :

msg : rda_msg_start_full_t:

RDA start message

Returns :

string :

rdatools.ubyte2string(array)

Converts a ctypes ubyte array to string

Parameters array : ctypes byte array

input array

Returns :string :

rdatools.validate_rda_guid(hdr)

Checks whether the signature of the message is valid, given its header

Parameters :

hdr : rda_msg_hdr_t

message header

Returns :

result : bool

verification result