1ISOTEST(1)                Linux System Administration               ISOTEST(1)
2
3
4

NAME

6       isotest - ISO testing
7

SYNOPSIS

9       isotest <MODE> [OPTIONS] [bdaddr] [bdaddr1]...
10

DESCRIPTION

12       isotest(1)  is used to test Isochronous (CIS/BIS) communications on the
13       BlueZ stack
14

MODES

16       -d, --dump=[FILE] Listen and dump incoming data
17              (CIS server/BIS broadcaster) and optionally save the contents to
18              FILE.
19
20       -c, --reconnect
21              Reconnect (CIS client).
22
23       -m, --multiple
24              Multiple connects (CIS client).
25
26       -r, --receive=[FILE] Receive (CIS server/BIS broadcast receiver) and
27              optionally save the contents to FILE.
28
29       -s, --send=[FILE] Connect and send (CIS client/BIS broadcaster), can
30              optionally use contents from FILE.
31
32       -n, --silent
33              Connect and be silent (CIS client/BIS broadcaster).
34

OPTIONS

36       -b,--bytes=<SIZE>
37              Send or Receive packet size
38
39       -i,--index=<NUM>
40              Select  the  specified  HCI device index. hciNUM is also accept‐
41              able.
42
43       -j,--jitter=<JITTER>
44              Socket jitter buffer.
45
46       -h, --help
47
48       -q, --quiet
49              Disables packet logging.
50
51       -t,--timeout=<USEC>
52              Socket send timeout.
53
54       -C, --continue
55              Continuously send packets starting over in case of a file.
56
57       -W,--defer=<SEC>
58              Enable deferred setup.
59
60       -M,--mtu=<SDU>
61              Socket QoS SDU.
62
63       -S, --sca/adv-interval=<SCA/INTERVAL>
64              Socket QoS CIS SCA/BIS advertising interval.
65
66       -P,--packing=<PACKING>
67              Socket QoS Packing.
68
69                               ┌────────┬─────────────┐
70                               │PACKING │ Description │
71                               ├────────┼─────────────┤
72                               │0x00    │ Sequential  │
73                               ├────────┼─────────────┤
74                               │0x01    │ Interleaved │
75                               └────────┴─────────────┘
76
77       -F,--framing=<FRAMING>
78              Socket QoS Framing.
79
80                               ┌────────┬─────────────┐
81                               │FRAMING │ Description │
82                               ├────────┼─────────────┤
83                               │0x00    │ Unframed    │
84                               ├────────┼─────────────┤
85                               │0x01    │ Framed      │
86                               └────────┴─────────────┘
87
88       -I,--interval=<USEC>
89              Socket QoS Interval.
90
91       -L,--latency=<MSEC>
92              Socket QoS Latency.
93
94       -Y,--phy=<PHY>
95              Socket QoS PHY.
96
97                                ┌─────┬─────────────┐
98                                │PHY  │ Description │
99                                ├─────┼─────────────┤
100                                │0x01 │ LE 1M       │
101                                ├─────┼─────────────┤
102                                │0x02 │ LE 2M       │
103                                ├─────┼─────────────┤
104                                │0x03 │ LE Coded    │
105                                └─────┴─────────────┘
106
107       -R,--rtn=<NUM>
108              Socket QoS retransmissions.
109
110       -B,--preset=<PRESET>
111              Socket QoS preset.
112
113       -G, --CIG/BIG=<ID>       Socket QoS CIG/BIG ID.
114
115       -T, --CIS/BIS=<ID>       Socket QoS CIS/BIS ID.
116
117       -V,--type=<TYPE>
118              Socket destination address type:
119
120                           ┌──────────┬───────────────────┐
121                           │TYPE      │ Description       │
122                           ├──────────┼───────────────────┤
123                           │le_public │ LE Public Address │
124                           ├──────────┼───────────────────┤
125                           │le_random │ LE Random Address │
126                           └──────────┴───────────────────┘
127
128       -e,--enc=<ENCRYPTION>
129              Socket QoS BIG Encryption
130
131                           ┌───────────┬─────────────────┐
132                           │ENCRYPTION │ Description     │
133                           ├───────────┼─────────────────┤
134                           │0x00       │ BIG unencrypted │
135                           └───────────┴─────────────────┘
136
137                           │0x01       │ BIG encrypted   │
138                           └───────────┴─────────────────┘
139
140       -k,--bcode=<BCODE>
141              Socket QoS Broadcast Code
142
143       -N,--nbis=<NBIS>
144              Number of BISes to create as part of a BIG (BIS broadcaster)  or
145              to synchronize to (BIS broadcast receiver)
146

EXAMPLES

148   Unicast Central
149          $ tools/isotest -s XX:XX:XX:XX:XX:XX
150
151   Unicast Central connecting to 2 peers using CIG 0x01
152          $ tools/isotest -G 0x01 -s XX:XX:XX:XX:XX:XX YY:YY:YY:YY:YY:YY
153
154   Unicast Peripheral
155          $ tools/isotest -d
156
157   Broadcaster
158          $ tools/isotest -s 00:00:00:00:00:00
159
160   Broadcast Receiver using hci1
161          $ tools/isotest -i hci1 -d XX:XX:XX:XX:XX:XX
162

RESOURCES

164       http://www.bluez.org
165

REPORTING BUGS

167       linux-bluetooth@vger.kernel.org
168

AUTHOR

170       Luiz Augusto Von Dentz <luiz.von.dentz@intel.com>
171

173       Free use of this software is granted under ther terms of the GNU Lesser
174       General Public Licenses (LGPL).
175
176
177
178
179BlueZ                             May 4, 2022                       ISOTEST(1)
Impressum