isotest🔗
ISO testing🔗
- Authors:
Luiz Augusto Von Dentz <luiz.von.dentz@intel.com>
- Version:
BlueZ
- Copyright:
Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL).
- Date:
May 4, 2022
- Manual section:
1
- Manual group:
Linux System Administration
SYNOPSIS🔗
isotest <MODE> [OPTIONS] [bdaddr] [bdaddr1]…
DESCRIPTION🔗
isotest(1) is used to test Isochronous (CIS/BIS) communications on the BlueZ stack
MODES🔗
- -d, –dump=[FILE] Listen and dump incoming data
(CIS server/BIS broadcaster) and optionally save the contents to FILE.
- -c, --reconnect
Reconnect (CIS client).
- -m, --multiple
Multiple connects (CIS client).
- -r, –receive=[FILE] Receive (CIS server/BIS broadcast receiver) and
optionally save the contents to FILE.
- -s, –send=[FILE] Connect and send (CIS client/BIS broadcaster), can
optionally use contents from FILE.
- -n, --silent
Connect and be silent (CIS client/BIS broadcaster).
OPTIONS🔗
- -b, --bytes=<SIZE>
Send or Receive packet size
- -i, --index=<NUM>
Select the specified HCI device index. hciNUM is also acceptable.
- -j, --jitter=<JITTER>
Socket jitter buffer.
-h, –help
- -q, --quiet
Disables packet logging.
- -t, --timeout=<USEC>
Socket send timeout.
- -C, --continue
Continuously send packets starting over in case of a file.
- -W, --defer=<SEC>
Enable deferred setup.
- -M, --mtu=<SDU>
Socket QoS SDU.
- -S, –sca/adv-interval=<SCA/INTERVAL>
Socket QoS CIS SCA/BIS advertising interval.
- -P, --packing=<PACKING>
Socket QoS Packing.
PACKING |
Description |
|---|---|
0x00 |
Sequential |
0x01 |
Interleaved |
- -F, --framing=<FRAMING>
Socket QoS Framing.
FRAMING |
Description |
|---|---|
0x00 |
Unframed |
0x01 |
Framed |
- -I, --interval=<USEC>
Socket QoS Interval.
- -L, --latency=<MSEC>
Socket QoS Latency.
- -Y, --phy=<PHY>
Socket QoS PHY.
PHY |
Description |
|---|---|
0x01 |
LE 1M |
0x02 |
LE 2M |
0x03 |
LE Coded |
- -R, --rtn=<NUM>
Socket QoS retransmissions.
- -B, --preset=<PRESET>
Socket QoS preset.
-G, –CIG/BIG=<ID> Socket QoS CIG/BIG ID.
-T, –CIS/BIS=<ID> Socket QoS CIS/BIS ID.
- -V, --type=<TYPE>
Socket destination address type:
TYPE |
Description |
|---|---|
le_public |
LE Public Address |
le_random |
LE Random Address |
- -e, --enc=<ENCRYPTION>
Socket QoS BIG Encryption
ENCRYPTION |
Description |
|---|---|
0x00 |
BIG unencrypted |
0x01 |
BIG encrypted |
- -k, --bcode=<BCODE>
Socket QoS Broadcast Code
- -N, --nbis=<NBIS>
Number of BISes to create as part of a BIG (BIS broadcaster) or to synchronize to (BIS broadcast receiver)
EXAMPLES🔗
Unicast Central🔗
$ tools/isotest -s XX:XX:XX:XX:XX:XX
Unicast Central connecting to 2 peers using CIG 0x01🔗
$ tools/isotest -G 0x01 -s XX:XX:XX:XX:XX:XX YY:YY:YY:YY:YY:YY
Unicast Peripheral🔗
$ tools/isotest -d
Broadcaster🔗
$ tools/isotest -s 00:00:00:00:00:00
Broadcast Receiver using hci1🔗
$ tools/isotest -i hci1 -d XX:XX:XX:XX:XX:XX