Technical Notes

Manpages - 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

<http://www.bluez.org>

REPORTING BUGS

AUTHOR

Luiz Augusto Von Dentz <[email protected]>

COPYRIGHT

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