btmon − Bluetooth monitor
btmon [OPTIONS ...]
The btmon(1) command provides access to the Bluetooth subsystem monitor infrastructure for reading HCI traces.
−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.
−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.
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.
−E IP, −−ellisys IP
Send Ellisys HCI Injection.
Disable pager usage while reading the log file.
−J OPTIONS, −−jlink OPTIONS
Read data from RTT. Each options are comma(,) seprated without spaces.
−R OPTIONS, −−rtt OPTIONS
RTT control block parameters. Each options are comma(,) seprated without spaces.
−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
Show help options
Capture the traces from hci0 to hcidump.log file
$ btmon −i hci0 −w hcidump.log
Open the trace file
$ btmon −r hcidump.log
Marcel Holtmann <mar[email protected]>, Tedd Ho-Jeong An <[email protected]>
Free use of this software is granted under ther terms of the GNU Lesser General Public Licenses (LGPL).