Reference

isotest(1)

ISO testing

Name

isotest - ISO testing

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.

PACKINGDescription
0x00Sequential
0x01Interleaved
-F,--framing=<FRAMING>

Socket QoS Framing.

FRAMINGDescription
0x00Unframed
0x01Framed
-I,--interval=<USEC>

Socket QoS Interval.

-L,--latency=<MSEC>

Socket QoS Latency.

-Y,--phy=<PHY>

Socket QoS PHY.

PHYDescription
0x01LE 1M
0x02LE 2M
0x03LE 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:

TYPEDescription
le_publicLE Public Address
le_randomLE Random Address
-e,--enc=<ENCRYPTION>

Socket QoS BIG Encryption

ENCRYPTIONDescription
0x00BIG unencrypted
0x01BIG 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

RESOURCES

<http://www.bluez.org>

REPORTING BUGS

<[email protected]>

Author

Luiz Augusto Von Dentz <[email protected]>

Copyright

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL).

History

--bcode since Debian 13 (Trixie); --enc since Debian 13 (Trixie); --nbis since Debian 13 (Trixie); -N since Debian 13 (Trixie); -e since Debian 13 (Trixie); -k since Debian 13 (Trixie).