esb_scan

Presentation

esb_scan allows to identify Enhanced ShockBurst 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.

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

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

<ESB address>

ESB address of the identified device

PROTOCOL

logitech|microsoft|chicony|generic

Applicative protocol of the identified device

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

<ESB address>

ESB address of the first identified device

PROTOCOL1

logitech|microsoft|chicony|generic

Applicative protocol of the first identified device

TARGET2

<ESB address>

ESB address of the second identified device

PROTOCOL2

logitech|microsoft|chicony|generic

Applicative protocol of the second identified device

Usage

If you want to list the devices during 10 seconds :

$ mirage esb_scan
[INFO] Module esb_scan loaded !
┌────────────────┬──────────┬──────────┐
│ Address        │ Channels │ Protocol │
├────────────────┼──────────┼──────────┤
│ E8:46:F9:2F:A4 │ 74       │ logitech │
└────────────────┴──────────┴──────────┘
[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 esb_scan INTERFACE=rfstorm1 TIME=""
[INFO] Module esb_scan loaded !
┌────────────────┬──────────┬──────────┐
│ Address        │ Channels │ Protocol │
├────────────────┼──────────┼──────────┤
│ E8:46:F9:2F:A4 │ 74       │ logitech │
└────────────────┴──────────┴──────────┘
[...]

Finally, you can provide a range of channels to scan using the END_CHANNEL and START_CHANNEL parameters:

$ mirage esb_scan START_CHANNEL=10 END_CHANNEL=50
[INFO] Module esb_scan loaded !
┌────────────────┬──────────┬──────────┐
│ Address        │ Channels │ Protocol │
├────────────────┼──────────┼──────────┤
│ E8:46:F9:2F:A4 │ 48,44    │ logitech │
└────────────────┴──────────┴──────────┘
[INFO] Mirage process terminated !