isotest - Man Page
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).