1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
=====
btmon
=====
-----------------
Bluetooth monitor
-----------------
:Authors: - 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).
:Version: BlueZ
:Date: April 2021
:Manual section: 1
:Manual group: Linux System Administration
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.
.. list-table::
:header-rows: 1
:widths: auto
:stub-columns: 1
* - *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.
.. list-table::
:header-rows: 1
:widths: auto
:stub-columns: 1
* - *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.
.. list-table::
:header-rows: 1
:widths: auto
:stub-columns: 1
* - *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
------------------------------------------------
.. code-block::
$ btmon -i hci0 -w hcidump.log
Open the trace file
-------------------
.. code-block::
$ btmon -r hcidump.log
RESOURCES
=========
http://www.bluez.org
REPORTING BUGS
==============
linux-bluetooth@vger.kernel.org
|
