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,.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 | | 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 | | 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 | | Device's serial number | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | FIRMWARE_VERSION | | Firmware version | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | API_VERSION | X.Y | API version | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | BOARD_NAME | | Device's board name | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | BOARD_ID | | Device's board identifier | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ * If the interface provided is ``adbX``: +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | Name | Possible values | Description | +========================================+=============================================================+======================================================================+ | INTERFACE | adbX | Selected interface | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | SNOOP_LOCATION | | Full path of the snoop HCI log file | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | SNOOP_SIZE | | Size (bytes) of the snoop HCI log file | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | INDEX | #X | Device's index number | +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | SERIAL | | 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 ``.pcap``: +----------------------------------------+-------------------------------------------------------------+----------------------------------------------------------------------+ | Name | Possible values | Description | +========================================+=============================================================+======================================================================+ | INTERFACE | .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 !