isotest1
Iso testing
Usage
isotest <MODE>
[OPTIONS]
[bdaddr]
[bdaddr1] ...
Overview
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
Resources
<http://www.bluez.org>
Releases
3 releases since Debian 12 (Bookworm); the text changed 2 times.
--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).