Scroll to navigation

BTMON(1) Linux System Administration BTMON(1)

NAME

btmon - Bluetooth monitor

SYNOPSYS

btmon [OPTIONS ...]

DESCRIPTION

The btmon(1) command provides access to the Bluetooth subsystem monitor infrastructure for reading HCI traces.

OPTIONS

Read traces in btsnoop format from FILE.
Save traces in btsnoop format to FILE.
Analyze traces in btsnoop format from FILE. It displays the devices found in the FILE with its packets by type.
Start monitor server socket.
Show only priority or lower for user log.

PRIORITY NAME
3 Error
4 Warning
6 Information (Default)
7 Debug. debug can be used.
Show only specified controller. hciNUM is also acceptable. This is useful to capture the traces from the specific controller when the multiple controllers are presented.
Read data from TTY.
Set TTY speed. The default SPEED is 115300
Set the default company identifier. The COMPID is a unique number assigned by the Bluetooth SIG to a member company and can be found/searched from the Bluetooth SIG webpage.

For example, Intel is 2 and Realtek is 93.

Open channel for mgmt events.
Show a time instead of time offset.
Show a time and date information instead of time offset.
Dump SCO traffic in raw hex format.
Dump A2DP stream traffic in a raw hex format.
Send Ellisys HCI Injection.
Disable pager usage while reading the log file.
Read data from RTT. Each options are comma(,) seprated without spaces.

OPTIONS Description
DEVICE Required. Set the target device.
SERIALNO (Optional) Set the USB serial number. Default is 0.
INTERFACE (Optional) Target interface. Default is swd.
SPEED (Optional) Set target interface speed in kHz. Default is 1000.
RTT control block parameters. Each options are comma(,) seprated without spaces.

OPTIONS Description
ADDRESS (Optional) Address of RTT buffer. Default is 0x00
AREA (Optional) Size of range to search in RTT buffer. Default is 0
NAME (Optional) Buffer name. Default is btmonitor
Output width if not a terminal
Set output color. The possible MODE values are: auto|always|never.

Default value is auto

Show version
Show help options

EXAMPLES

Capture the traces from hci0 to hcidump.log file

$ btmon -i hci0 -w hcidump.log


Open the trace file

$ btmon -r hcidump.log


RESOURCES

http://www.bluez.org

REPORTING BUGS

linux-bluetooth@vger.kernel.org

AUTHOR

Marcel Holtmann <marcel@holtmann.org>, Tedd Ho-Jeong An <tedd.an@intel.com>

COPYRIGHT

Free use of this software is granted under ther terms of the GNU Lesser General Public Licenses (LGPL).

April 2021 BlueZ