Data Extraction Plug-In Commands
This section describes automation commands and statuses for the Data Extraction Plug-in. The plug-in pulls data from various decoded Bluetooth protocols and profiles. Once you have extracted the data, you can save them into different file types, such as text files, graphic files, email files, .mp3 files, and more.
Automation commands are sent by the client to the plug-in.
Automation statuses are sent by the plug-in to the client.
The "Open Capture File", command is needed in order to use the plug-in.
A Data Extraction Plug-in command has the following format (multiple parameters are comma-separated):
Plugin Command;Plugin Name=Data and Audio Extraction;Command=command;Parameters=parameter(s)
A status message has one of the following formats:
Plugin Command;Plugin Name=Data and Audio Extraction;SUCCEEDED;timestamp;State=state;Description=description[;label=value]...
Plugin Command;Plugin Name=Data and Audio Extraction;FAILED;timestamp;Reason=reason;Description=description [;label=value]...
A status message is sent immediately after the command is received. If the command will take time to execute, one or more additional status messages are sent later.
The State and Reason fields indicate the meaning of each SUCCEEDED and FAILED message respectively. Where possible, corresponding State and Reason values are the same except that the Reason value has 9000 added to it. The Description field contains a description of the State or Reason value. Additional fields are copied from the original command for reference.
|
Status |
State |
Description |
|
SUCCEEDED |
10 |
Command completed |
|
SUCCEEDED |
11 |
Command accepted |
|
SUCCEEDED |
30 |
Extraction completed |
|
SUCCEEDED |
40 |
File opened |
|
SUCCEEDED |
41 |
File closed |
|
SUCCEEDED |
60 |
In live mode |
|
SUCCEEDED |
63 |
In standby mode |
|
FAILED |
9010 |
Invalid syntax (explanation) |
|
FAILED |
9011 |
Unknown command |
|
FAILED |
9012 |
Missing parameter (explanation) |
|
FAILED |
9013 |
Invalid parameter (explanation) |
|
FAILED |
9014 |
Too many parameters |
|
FAILED |
9020 |
Path does not exist |
|
FAILED |
9021 |
Invalid basename |
|
FAILED |
9030 |
No data found to extract |
|
FAILED |
9040 |
File open error |
|
FAILED |
9041 |
File close error |
|
FAILED |
9042 |
File write error |
|
FAILED |
9043 |
File does not exist |
|
FAILED |
9044 |
File not open |
|
FAILED |
9060 |
Already in live mode |
|
FAILED |
9061 |
Already not in live mode |
|
FAILED |
9062 |
Unable to enter live mode |
|
FAILED |
9063 |
Unable to exit live mode |
|
FAILED |
9998 |
Still executing previous user command |
|
FAILED |
9999 |
Still executing previous automation command |