Section 1 · User commands
btmon.1
Package: bluez
BTMON
NAME
SYNOPSYS
DESCRIPTION
OPTIONS
EXAMPLES
RESOURCES
REPORTING BUGS
AUTHOR
COPYRIGHT
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
**−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. If gnuplot is installed on the system it also attempts to plot packet latency graph.
**−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.logOpen the trace file
$ btmon −r hcidump.logRESOURCES
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).