Headset object
Some methods of the API return one or more headset objects, for example queryHeadsets. A session object also includes a headset object.
Description
A headset object include these fields:
Name | Type | Description |
id |
| The id of this headset. |
status |
| Can be "discovered", "connecting", or "connected". |
connectedBy |
| Can be "bluetooth", "dongle", "usb cable", or "extender". |
dongle |
| The version of the dongle firmware. |
firmware |
| The version of the headset firmware. |
motionSensors |
| The names of the motion sensors of this headset. |
sensors |
| The names of the EEG sensors of this headset. Use the international 10-20 system. |
settings |
| An object containing the configuration of the EEG and motion data of this headset. |
flexMappings |
| If the headset is an EPOC Flex, then this field is an object containing information about the mapping of the EEG channels. |
headbandPosition |
| If the headset is an EPOC X, then this field tells you the position of the headband of this headset. Can be "back" or "top". If the headset is not an EPOC X, then this field is null. See updateHeadsetCustomInfo for details. This field was added in Cortex 2.4 |
customName |
| The custom name of the headset. The user can set it in EMOTIV App. This field was added in Cortex 2.4 |
Status
When you want to work with a headset, it is important to check its status.
Status | Description |
discovered | Cortex has detected the headset, but it is not connected. You cannot create a session for a discovered headset. You can call controlDevice to connect the headset. |
connecting | Cortex is trying to connect to this headset. This can take a few seconds. |
connected | Cortex is connected to and receives data from this headset. You can call createSession and start working with this headset. You can call controlDevice to disconnect the headset. |
Settings
The settings object include these fields:
Name | Type | Description |
mode |
| Can be "EPOC", "EPOCPLUS", or "EPOCFLEX" |
eegRate |
| The EEG sample rate, in hertz. |
eegRes |
| The EEG resolution, in bits. |
memsRate |
| The motion data sample rate, in hertz. |
memsRes |
| The motion data resolution, in bits. |
For an Epoc+ headset, the mode can be "EPOC" or "EPOCPLUS", depending on its configuration. See updateHeadset for details. For an Insight or Epoc headset, the mode is always "EPOC". For an Epoc Flex headset, the mode is always "EPOCFLEX".
A motion rate of zero means that the motion sensors are disabled.
Flex Mapping
Currently, the flexMappings object contains a single field. It may include more fields in the future.
Name | Type | Description |
mappings |
| Describe which EEG channel is mapped to which physical connector of EPOC Flex device. The keys are the names of the connectors, the values are the names of the EEG channels. Example: { "CMS": "TP8", "DRL": "P6", "RM": "TP10", "RN": "P4", "RO": "P8" } |
Examples
Insight
Epoc+
Last updated