---
name: "isotest"
section: "1"
platform: "linux"
package: "bluez-utils"
version: "5.87-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/isotest"
---

# isotest(1)

ISO testing

## Name

isotest - ISO testing

## SYNOPSIS

**isotest** \<*MODE*\> \[*OPTIONS*\] \[*bdaddr*\] \[*bdaddr1*\]...

## DESCRIPTION

**[isotest(1)](/isotest/1.md)** 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

\<linux-bluetooth@vger.kernel.org\>

## Author

Luiz Augusto Von Dentz \<luiz.von.dentz@intel.com\>

## Copyright

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