isotest - ISO testing
Contents
Copyright
Free use of this software is granted under ther terms of the GNU Lesser General Public Licenses (LGPL).
BlueZ May 4, 2022 ISOTEST(1)
Description
isotest(1) is used to test Isochronous (CIS/BIS) communications on the BlueZ stack
Examples
UnicastCentral
$ tools/isotest -s XX:XX:XX:XX:XX:XX
UnicastCentralconnectingto2peersusingCIG0x01
$ tools/isotest -G 0x01 -s XX:XX:XX:XX:XX:XX YY:YY:YY:YY:YY:YY
UnicastPeripheral
$ tools/isotest -d
Broadcaster
$ tools/isotest -s 00:00:00:00:00:00
BroadcastReceiverusinghci1
$ tools/isotest -i hci1 -d XX:XX:XX:XX:XX:XX
Modes
-d,--dump=[FILE]Listenanddumpincomingdata
(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(CISserver/BISbroadcastreceiver)and
optionally save the contents to FILE.
-s,--send=[FILE]Connectandsend(CISclient/BISbroadcaster),can
optionally use contents from FILE.
-n, --silent
Connect and be silent (CIS client/BIS broadcaster).
Name
isotest - ISO testing
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)
Reporting Bugs
Resources
Synopsis
isotest <MODE> [OPTIONS] [bdaddr] [bdaddr1]...
