idevicebtlogger - Man Page
Capture HCI traffic of a connected device.
Synopsis
idevicebtlogger [Options] <FILE>
Description
Capture HCI traffic of a connected device. Requires Bluetooth logging profile to be installed on device with iOS 13 or higher. See https://www.bluetooth.com/blog/a-new-way-to-debug-iosbluetooth-applications/ for iOS device configuration.
The HCI traffic can be stored in Apple's native PacketLogger format or converted into PCAP format for live feedback in Wireshark.
Options
- -u, --udid UDID
target specific device by UDID
- -n, --network
connect to network device
- -f, --format FORMAT
set log format: PacketLogger (default), or pcap
- -x, --exit
exit when device disconnects
- -d, --debug
enable communication debugging
- -h, --help
prints usage information
- -v, --version
prints version information.
Examples
- idevicebtlogger -u 00008030-0000111ABC000DEF
Capture HCI traffic of device with UDID 00008030-0000111ABC000DEF.
- idevicebtlogger -x
Capture HCI traffic of device and exit when the device is unplugged.
- idevicebtlogger -f pcap
Capture HCI traffic of device in PCAP format.
- idevicebtlogger -f pcap - | wireshark -k -i -
Capture HCI traffic and pipe it into Wireshark for live feedback.
Authors
Geoffrey Kruse
Matthias Ringwald