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
A headset id or a wildcard
For the parameter id , you can use these wildcards:
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
Copy {
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets"
}
Response
Copy {
"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
Copy {
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets"
}
Response
Copy {
"id": 1,
"jsonrpc": "2.0",
"result": []
}
Query a headset by its id
Request
Copy {
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets",
"params": {
"id": "EPOCPLUS-3B9AXXXX"
}
}
Response
Copy {
"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
Copy {
"id": 1,
"jsonrpc": "2.0",
"method": "queryHeadsets",
"params": {
"id": "INSIGHT-*"
}
}
Response
Copy {
"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"
}
}
]
}