Cortex API
Search
K

queryHeadsets

Shows details of any headsets connected to the device via USB dongle, USB cable, or Bluetooth. You can query a specific headset by its id, or you can specify a wildcard for partial matching.

Parameters

Name
Type
Required
Description
id
string
No
A headset id or a wildcard
includeFlexMappings
boolean
No
Set this parameter to true to include the mapping of each EPOC FLEX headset in the result headset object.
For the parameter id, you can use these wildcards:
Wildcard
Filter
INSIGHT-*
All Insight headsets
EPOC-*
All Epoc headsets
EPOCPLUS-*
All Epoc Plus headsets

Result

The result is an array of headset objects, or an empty array if no headset matches the request.

Examples

Query all the headsets

Request
Response
{
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets"
}
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"connectedBy": "dongle",
"customName": "",
"dongle": "6ff",
"firmware": "625",
"id": "EPOCPLUS-3B9AXXXX",
"motionSensors": [
"GYROX",
"GYROY",
"GYROZ",
"ACCX",
"ACCY",
"ACCZ",
"MAGX",
"MAGY",
"MAGZ"
],
"sensors": [
"AF3",
"F7",
"F3",
"FC5",
"T7",
"P7",
"O1",
"O2",
"P8",
"T8",
"FC6",
"F4",
"F8",
"AF4"
],
"settings": {
"eegRate": 256,
"eegRes": 16,
"memsRate": 64,
"memsRes": 16,
"mode": "EPOCPLUS"
},
"status": "connected"
}
]
}
If no headset matches your request, then the result is an empty array.
Request
Response
{
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets"
}
{
"id": 1,
"jsonrpc": "2.0",
"result": []
}

Query a headset by its id

Request
Response
{
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets",
"params": {
"id": "EPOCPLUS-3B9AXXXX"
}
}
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"connectedBy": "dongle",
"customName": "",
"dongle": "6ff",
"firmware": "625",
"id": "EPOCPLUS-3B9AXXXX",
"motionSensors": [
"GYROX",
"GYROY",
"GYROZ",
"ACCX",
"ACCY",
"ACCZ",
"MAGX",
"MAGY",
"MAGZ"
],
"sensors": [
"AF3",
"F7",
"F3",
"FC5",
"T7",
"P7",
"O1",
"O2",
"P8",
"T8",
"FC6",
"F4",
"F8",
"AF4"
],
"settings": {
"eegRate": 256,
"eegRes": 16,
"memsRate": 64,
"memsRes": 16,
"mode": "EPOCPLUS"
},
"status": "connected"
}
]
}

Query all the Insight headsets

Request
Response
{
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets",
"params": {
"id": "INSIGHT-*"
}
}
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"id": "INSIGHT-AAAA0000",
"status": "connected",
"connectedBy": "dongle",
"customName": "",
"dongle": "6ff",
"firmware": "930",
"headbandPosition": null,
"motionSensors": [
"Q0",
"Q1",
"Q2",
"Q3",
"ACCX",
"ACCY",
"ACCZ",
"MAGX",
"MAGY",
"MAGZ"
],
"sensors": [
"AF3",
"T7",
"Pz",
"T8",
"AF4"
],
"settings": {
"eegRate": 128,
"eegRes": 14,
"memsRate": 64,
"memsRes": 14,
"mode": "INSIGHT"
}
}
]
}