ble_info¶

Presentation¶

ble_info displays some informations about a specific interface. The supported devices and their corresponding interfaces are listed here. The displayed informations and the output parameters changes according to the provided interface.

Compatible devices¶

HCI Device

BTLEJack Device

Ubertooth Device

NRFSniffer Device

ADB Device

HCIdump Device

ButteRFly Device

Sniffle Device

HackRF Device

PCAP Files

Input parameters¶

Name	Default value	Possible values	Description
INTERFACE	hci0	hciX,microbitX,ubertoothX,adbX,hcidumpX,nrfsnifferX,sniffleX,hackrfX,butterflyX,<filename>.pcap	Interface to display
SHOW_CAPABILITIES	yes	yes\|no	Indicates if the capabilities of the interface should be displayed

Output parameters¶

If the interface provided is hciX:

Name

Possible values

Description

INTERFACE

hciX

Selected interface

ADDRESS

XX:XX:XX:XX:XX:XX

BD address associated to the selected interface

MODE

NORMAL | ADVERTISING | SCANNING

Mode associated to the selected interface

MANUFACTURER

<string>

Device’s manufacturer

CHANGEABLE_ADDRESS

yes | no

Boolean indicating if the BD address is changeable

If the interface provided is ubertoothX:

Name

Possible values

Description

INTERFACE

ubertoothX

Selected interface

MODE

BT | BLE

Mode actually in use in the selected interface

SERIAL

<string>

Serial number

INDEX

#X

Device’s index number

VERSION

X.Y

Firmware version

If the interface provided is microbitX:

Name

Possible values

Description

INTERFACE

microbitX

Selected interface

CUSTOM_FIRMWARE

yes | no

Boolean indicating if the custom firmware for Mirage is available

INDEX

#X

Device’s index number

VERSION

X.Y

Firmware version

If the interface provided is nrfsnifferX:

Name

Possible values

Description

INTERFACE

nrfsnifferX

Selected interface

INDEX

#X

Device’s index number

VERSION

X.Y

Firmware version

If the interface provided is sniffleX:

Name

Possible values

Description

INTERFACE

sniffleX

Selected interface

INDEX

#X

Device’s index number

VERSION

X.Y

Firmware version

If the interface provided is butterflyX:

Name

Possible values

Description

INTERFACE

butterflyX

Selected interface

INDEX

#X

Device’s index number

VERSION

X.Y

Firmware version

If the interface provided is hackrfX:

Name

Possible values

Description

INTERFACE

hackrfX

Selected interface

INDEX

#X

Device’s index number

SERIAL

<string>

Device’s serial number

FIRMWARE_VERSION

<string>

Firmware version

API_VERSION

X.Y

API version

BOARD_NAME

<string>

Device’s board name

BOARD_ID

<integer>

Device’s board identifier

If the interface provided is adbX:

Name

Possible values

Description

INTERFACE

adbX

Selected interface

SNOOP_LOCATION

<string>

Full path of the snoop HCI log file

SNOOP_SIZE

<integer>

Size (bytes) of the snoop HCI log file

INDEX

#X

Device’s index number

SERIAL

<string>

Serial number of the smartphone

If the interface provided is hcidumpX:

Name

Possible values

Description

INTERFACE

adbX

Selected interface

INDEX

#X

Device’s index number

HCI_INTERFACE

hciX

HCI Interface to monitor

If the interface provided is <filename>.pcap:

Name

Possible values

Description

INTERFACE

<filename>.pcap

Selected interface

MODE

read | write

Mode in use

Usage¶

If you want to display the informations related to an HCI interface :

$ mirage ble_info INTERFACE=hci0
[INFO] Module ble_info loaded !
[SUCCESS] HCI Device (hci0) successfully instanciated !
┌───────────┬───────────────────┬──────────────┬───────────────────────────────────┬────────────────────┐
│ Interface │ BD Address        │ Current Mode │ Manufacturer                      │ Changeable Address │
├───────────┼───────────────────┼──────────────┼───────────────────────────────────┼────────────────────┤
│ hci0      │ D0:C5:D3:7C:3B:46 │ NORMAL       │ Realtek Semiconductor Corporation │ no                 │
└───────────┴───────────────────┴──────────────┴───────────────────────────────────┴────────────────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to a Ubertooth sniffer :

$ mirage ble_info INTERFACE=ubertooth0
[INFO] Module ble_info loaded !
[SUCCESS] Ubertooth Device (ubertooth0) successfully instanciated !
┌────────────┬──────┬──────────────┬──────────────────┬───────────────────────────────────┐
│ Interface  │ Mode │ Device Index │ Firmware Version │ Serial Number                     │
├────────────┼──────┼──────────────┼──────────────────┼───────────────────────────────────┤
│ ubertooth0 │ BLE  │ #0           │ 1.6              │ 1160010b201835ae6d474553-79e1ff0b │
└────────────┴──────┴──────────────┴──────────────────┴───────────────────────────────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to a BTLEJack sniffer :

$ sudo mirage ble_info INTERFACE=microbit0
[INFO] Module ble_info loaded !
[SUCCESS] BTLEJack device #0 successfully instantiated (firmware version : 3.14)
[INFO] Custom Mirage Firmware used ! Advertisements sniffing and jamming will be supported.
┌───────────┬──────────────┬─────────┬─────────────────┐
│ Interface │ Device Index │ Version │ Custom Firmware │
├───────────┼──────────────┼─────────┼─────────────────┤
│ microbit0 │ #0           │ 3.14    │ yes             │
└───────────┴──────────────┴─────────┴─────────────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to a NRFSniffer sniffer :

$ sudo mirage ble_info INTERFACE=nrfsniffer0
[INFO] Module ble_info loaded !
[SUCCESS] NRFSniffer device #0 successfully instantiated (firmware version : 1111)
┌────────────┬──────────────┬─────────┐
│ Interface  │ Device Index │ Version │
├────────────┼──────────────┼─────────┤
│ nrfsniffer │ #0           │ 1111    │
└────────────┴──────────────┴─────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to a Sniffle device :

$ sudo mirage ble_info INTERFACE=sniffle0
[sudo] Mot de passe de rcayre :
[INFO] Module ble_info loaded !
[SUCCESS] Sniffle device #0 successfully instantiated (firmware version : 1.5)
┌───────────┬──────────────┬─────────┐
│ Interface │ Device Index │ Version │
├───────────┼──────────────┼─────────┤
│ sniffle0  │ #0           │ 1.5     │
└───────────┴──────────────┴─────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to a ButteRFly device :

$ sudo mirage ble_info INTERFACE=butterfly0
[INFO] Module ble_info loaded !
[SUCCESS] ButteRFly device successfully instantiated !
┌────────────┬──────────────┬─────────┬────────────┐
│ Interface  │ Device Index │ Version │ Controller │
├────────────┼──────────────┼─────────┼────────────┤
│ butterfly0 │ #0           │ 1.0     │ BLE        │
└────────────┴──────────────┴─────────┴────────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to a HackRF device :

$ sudo mirage ble_info INTERFACE=hackrf0
[INFO] Module ble_info loaded !
[SUCCESS] HackRF API initialized !
[SUCCESS] HackRF successfully initialized !
┌───────────┬──────────────┬──────────────────────────────────┬────────────┬──────────┬──────────────────┬─────────────┐
│ Interface │ Device Index │ Serial number                    │ Board Name │ Board ID │ Firmware Version │ API Version │
├───────────┼──────────────┼──────────────────────────────────┼────────────┼──────────┼──────────────────┼─────────────┤
│ hackrf0   │ #0           │ 0000000000000000a06063c8234e925f │ HackRF One │ 2        │ git-a9945ff      │ 1.4         │
└───────────┴──────────────┴──────────────────────────────────┴────────────┴──────────┴──────────────────┴─────────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to an ADB device :

$ sudo mirage ble_info INTERFACE=adb0
[INFO] Module ble_info loaded !
[SUCCESS] ADB Device found: 3e95c5e
[INFO] Trying to send adb shell commands ...
[SUCCESS] Yeah, we can send commands.
[INFO] Looking for HCI logs ...
[SUCCESS] Log found: /sdcard/MIUI/debug_log/common/btsnoop_hci.log
[INFO] Calculating size ...
[SUCCESS] Size found: 11295121
┌───────────┬──────────────┬───────────────┬───────────────────────────────────────────────┬────────────────┐
│ Interface │ Device Index │ Serial number │ Snoop Location                                │ Snoop Size     │
├───────────┼──────────────┼───────────────┼───────────────────────────────────────────────┼────────────────┤
│ adb0      │ #0           │ 3e95c5e       │ /sdcard/MIUI/debug_log/common/btsnoop_hci.log │ 11295122 bytes │
└───────────┴──────────────┴───────────────┴───────────────────────────────────────────────┴────────────────┘
[INFO] Mirage process terminated !

If you want to display the informations related to an HCIDump device :

$ sudo mirage ble_info INTERFACE=hcidump0
[INFO] Module ble_info loaded !
[SUCCESS] Hcidump successfully attached to device : hci0
┌───────────┬──────────────┬─────────────────────────┐
│ Interface │ Device Index │ Monitored HCI Interface │
├───────────┼──────────────┼─────────────────────────┤
│ hcidump0  │ #0           │ hci0                    │
└───────────┴──────────────┴─────────────────────────┘
[INFO] Mirage process terminated !