table of contents
| ISOTEST(1) | Linux System Administration | ISOTEST(1) |
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.
| 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¶
REPORTING BUGS¶
linux-bluetooth@vger.kernel.org
AUTHOR¶
Luiz Augusto Von Dentz <luiz.von.dentz@intel.com>
COPYRIGHT¶
Free use of this software is granted under ther terms of the GNU Lesser General Public Licenses (LGPL).
| May 4, 2022 | BlueZ |