mosart_scan¶
Presentation¶
mosart_scan allows to identify Mosart devices thanks to the promiscuous mode provided by the RFStorm Device. It allows to provide a specific range of channels to scan using the START_CHANNEL and END_CHANNEL parameters. There is a possiblity to limit the execution time with the TIME parameter (execution duration in seconds). If this parameter is set to an empty string (“”), the execution doesn’t automatically stop. You can also decide if you want to include dongle packets by setting the DONGLE_PACKETS parameter to yes.
Warning
Please note the fact that in promiscuous mode, only a subset of frames are received by the device. It may require multiple executions in order to identify your target.
Compatible devices¶
Input parameters¶
Name |
Default value |
Possible values |
Description |
---|---|---|---|
INTERFACE |
rfstorm0 |
rfstormX |
Interface to use |
START_CHANNEL |
0 |
<integer> |
First channel of the range to scan |
END_CHANNEL |
99 |
<integer> |
Last channel of the range to scan |
TIME |
10 |
<integer> |
Execution duration |
DONGLE_PACKETS |
no |
yes|no |
Dongle packets have to be captured |
Output parameters¶
If no devices have been identified, no output parameters are generated. If there is only one device identified, the output parameters are listed in the following table :
Name |
Possible values |
Description |
---|---|---|
TARGET |
<Mosart address> |
Mosart address of the identified device |
DEVICE_TYPE |
mouse|keyboard|dongle|unknown |
Type of device |
CHANNEL |
<integer> |
First channel detected |
CHANNELS |
<integer> |
List of all channels detected |
If multiple devices have been identified, the same output parameters are generated, but are suffixed by the number of the device :
Name |
Possible values |
Description |
---|---|---|
TARGET1 |
<Mosart address> |
Mosart address of the first identified device |
DEVICE_TYPE1 |
mouse|keyboard|dongle|unknown |
Type of device (first device) |
CHANNEL1 |
<integer> |
First channel detected (first device) |
CHANNELS1 |
<integer> |
List of all channels detected (first device) |
TARGET2 |
<Mosart address> |
Mosart address of the second identified device |
DEVICE_TYPE2 |
mouse|keyboard|dongle|unknown |
Type of device (second device) |
CHANNEL2 |
<integer> |
First channel detected (second device) |
CHANNELS2 |
<integer> |
List of all channels detected (second device) |
... |
... |
... |
Usage¶
If you want to list the devices during 10 seconds :
$ mirage mosart_scan
[INFO] Module mosart_scan loaded !
┌─────────────┬──────────┬─────────────┐
│ Address │ Channels │ Device type │
├─────────────┼──────────┼─────────────┤
│ F4:82:F7:16 │ 20 │ mouse │
└─────────────┴──────────┴─────────────┘
[INFO] Mirage process terminated !
If you want to list the devices using the interface rfstorm1 without stopping the module after 10 seconds, use the following input parameters:
$ mirage mosart_scan INTERFACE=rfstorm1 TIME=""
[INFO] Module mosart_scan loaded !
┌─────────────┬──────────┬─────────────┐
│ Address │ Channels │ Device type │
├─────────────┼──────────┼─────────────┤
│ F4:82:F7:16 │ 20 │ mouse │
└─────────────┴──────────┴─────────────┘
[...]
You can provide a range of channels to scan using the END_CHANNEL and START_CHANNEL parameters:
$ mirage mosart_scan START_CHANNEL=10 END_CHANNEL=30
[INFO] Module mosart_scan loaded !
┌─────────────┬──────────┬─────────────┐
│ Address │ Channels │ Device type │
├─────────────┼──────────┼─────────────┤
│ F4:82:F7:16 │ 20 │ mouse │
└─────────────┴──────────┴─────────────┘
[INFO] Mirage process terminated !
Finally, you can ask to capture dongle packets by setting the DONGLE_PACKETS parameter to yes:
$ mirage mosart_scan DONGLE_PACKETS=yes
[INFO] Module mosart_scan loaded !
┌─────────────┬──────────┬─────────────┐
│ Address │ Channels │ Device type │
├─────────────┼──────────┼─────────────┤
│ F4:82:F7:16 │ 20 │ dongle │
│ F0:82:F7:16 │ 20 │ dongle │
└─────────────┴──────────┴─────────────┘
[INFO] Mirage process terminated !