SD Card recording import

Functions to import recordings from the SD card. More...

Functions
BBT_SDK_API int	bbt_mount_versatile_plus_sd_card (bbt_device_t *device)
	Mount SD volume in Versatile Plus devices to import data from them.
BBT_SDK_API int	bbt_device_import_sd_record (const char *input_folder, const char *recording_name, const char *output_folder, enum bbt_device_type_t dev_type, enum bbt_powerline_frequency_t powerline_info, const char *version)
	Imports a recording from the SD Card of any Bitbrain device except from a 64-channels versatile device.
BBT_SDK_API int	bbt_device_import_eeg64_sd_record (const char *left_input_folder, const char *right_input_folder, const char *recording_name, const char *output_folder, enum bbt_device_type_t dev_type, enum bbt_powerline_frequency_t powerline_info, const char *version)
	Imports a recording from the SD Card of a 64-channels versatile device.

Detailed Description

Functions to import recordings from the SD card.

All the devices can be configured to record data in the internal SD Card of the device using bbt_device_enable_sd_card, at the same time that the data is transmitted.

Data in the SD card is encoded and requires a specific import process to be decoded and stored in the hard drive of the computer. Functions in this group perform this import process.

The access to the SD Card content may vary from device to device. Some of them have direct physical access to the SD Card and can be extracted and read in a computer. Some other devices have a virtual SD Card that is accessed through a mass storage profile when connected by USB.

Either way, the import functions need the path to the folder where the recording files are stored in the SD Card and the name of the recording to import, as configured in bbt_device_enable_sd_card. The folders can be safely copied into the hard drive of the computer to perform the import process from there, as long as the content is not modified.

The output of the import process is a set of CSV files with the data from each signal and a JSON file with the metadata of the recording. Each line of the CSV files contains the data from all the channels of the signal at a given time instant.

Function Documentation

bbt_mount_versatile_plus_sd_card()

BBT_SDK_API int bbt_mount_versatile_plus_sd_card

(

bbt_device_t *

device

)

Mount SD volume in Versatile Plus devices to import data from them.

To import SD card recordings, the amplifier must be connected to the computer using the USB cable and the Isolator accessory.

Steps:

1. Ensure that the amplifier is powered off.
2. Connect the amplifier to the computer using the USB cable and the Isolator.
3. Once connected, press the amplifier power button. A status LED will turn on.
4. Wait a few seconds until the operating system detects the device (a beep sound in Windows will be played).
5. Use this function to mount the SD volume.

Note

In order to continue with recordings after importing SD card data, a restart of the amplifier is required.

Parameters

device

The handle to the device

Returns

True on success. False otherwise

bbt_device_import_sd_record()

BBT_SDK_API int bbt_device_import_sd_record	(	const char *	input_folder,
		const char *	recording_name,
		const char *	output_folder,
		enum bbt_device_type_t	dev_type,
		enum bbt_powerline_frequency_t	powerline_info,
		const char *	version
	)

Imports a recording from the SD Card of any Bitbrain device except from a 64-channels versatile device.

Parameters

input_folder	The path to the folder where the files from the SD Card of the device are
recording_name	The name of the recording to import, as configured with bbt_device_enable_sd_card
output_folder	The path to the folder in the hard drive of the computer where the imported files will be stored
dev_type	Device from which the importing is going to be made, see bbt_device_type_t
powerline_info	The powerline frequency related information (disabled or frequency in Hz, see bbt_powerline_frequency_t)
version	Hardware version for the device (especially useful for the impedance calculation in ikon devices)

bbt_device_import_eeg64_sd_record()

BBT_SDK_API int bbt_device_import_eeg64_sd_record	(	const char *	left_input_folder,
		const char *	right_input_folder,
		const char *	recording_name,
		const char *	output_folder,
		enum bbt_device_type_t	dev_type,
		enum bbt_powerline_frequency_t	powerline_info,
		const char *	version
	)

Imports a recording from the SD Card of a 64-channels versatile device.

As a complex device, the 64-channels versatile is composed of two interconnected devices that record data in two different SD Cards. As a result, the import process requires the path to the folders in both SD Cards in the correct order. Note that, internally, the left and right devices use the same recording folder and name in their corresponding SD Cards. However, these folders can be different once copied into the hard drive of the computer.

Parameters

left_input_folder	The path to the folder where the files from the SD Card of the left device are
right_input_folder	The path to the folder where the files from the SD Card of the right device are
recording_name	The name of the recording to import, as configured with bbt_device_enable_sd_card
output_folder	The path to the folder in the hard drive of the computer where the imported files will be stored
dev_type	Device from which the importing is going to be made, see bbt_device_type_t
powerline_info	The powerline frequency related information (disabled or frequency in Hz, see bbt_powerline_frequency_t)
version	Hardware version for the device (especially useful for the impedance calculation in ikon devices)