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

       -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.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).

BlueZ                             April 2021                          BTMON(1)