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

EXAMPLES

129   Unicast Central
130          $ tools/isotest -s XX:XX:XX:XX:XX:XX
131
132   Unicast Central connecting to 2 peers using CIG 0x01
133          $ tools/isotest -G 0x01 -s XX:XX:XX:XX:XX:XX YY:YY:YY:YY:YY:YY
134
135   Unicast Peripheral
136          $ tools/isotest -d
137
138   Broadcaster
139          $ tools/isotest -s 00:00:00:00:00:00
140
141   Broadcast Receiver using hci1
142          $ tools/isotest -i hci1 -d XX:XX:XX:XX:XX:XX
143

RESOURCES

145       http://www.bluez.org
146

REPORTING BUGS

148       linux-bluetooth@vger.kernel.org
149

AUTHOR

151       Luiz Augusto Von Dentz <luiz.von.dentz@intel.com>
152

154       Free use of this software is granted under ther terms of the GNU Lesser
155       General Public Licenses (LGPL).
156
157
158
159
160BlueZ                             May 4, 2022                       ISOTEST(1)
Impressum