btmon - Man Page
Bluetooth monitor
Synopsys
btmon [Options ...]
Description
The btmon(1) command provides access to the Bluetooth subsystem monitor infrastructure for reading HCI traces.
Options
- -r FILE, --read FILE
Read traces in btsnoop format from FILE.
- -w FILE, --write FILE
Save traces in btsnoop format to FILE.
- -a FILE, --analyze FILE
Analyze traces in btsnoop format from FILE. It displays the devices found in the FILE with its packets by type.
- -s SOCKET, --server SOCKET
Start monitor server socket.
- -p PRIORITY, --priority PRIORITY
Show only priority or lower for user log.
PRIORITY | NAME |
3 | Error |
4 | Warning |
6 | Information (Default) |
7 | Debug. debug can be used. |
- -i NUM, --index NUM
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.
- -d TTY, --tty TTY
Read data from TTY.
- -B SPEED, --rate SPEED
Set TTY speed. The default SPEED is 115300
- -V COMPID, --vendor COMPID
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.
- -M, --mgmt
Open channel for mgmt events.
- -t, --time
Show a time instead of time offset.
- -T, --date
Show a time and date information instead of time offset.
- -S, --sco
Dump SCO traffic in raw hex format.
- -A, --a2dp
Dump A2DP stream traffic in a raw hex format.
- -E IP, --ellisys IP
Send Ellisys HCI Injection.
- -P, --no-pager
Disable pager usage while reading the log file.
- -J OPTIONS, --jlink OPTIONS
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. |
- -R OPTIONS, --rtt OPTIONS
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 |
- -C WIDTH, --columns WIDTH
Output width if not a terminal
- -c MODE, --color MODE
Set output color. The possible MODE values are: auto|always|never.
Default value is auto
- -v, --version
Show version
- -h, --help
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
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).