huschi.net

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.
       -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 num-
              ber 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  inter- |
                      |          | face. 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 AT vger.org
AUTHOR
       Marcel    Holtmann    <marcel AT holtmann.org>,    Tedd    Ho-Jeong     An
       <tedd.an AT 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)