ISOTEST(1)

✨ NAME ✨

isotest — ISO testing, bestie. That's the whole name, no cap. 🦋

---

🎀 SYNOPSIS 🎀

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

---

💖 DESCRIPTION 💖

So isotest(1) is literally the tool you use to test Isochronous (CIS/BIS) communications on the BlueZ stack. That's it, that's the vibe. If you're messing with CIS or BIS on BlueZ, this is your girl. 💅

---

🌈 MODES 🌈

Pick one, she's your main character for the run:

• -d, --dump=[FILE] — Listen and dump incoming data (CIS server / BIS broadcaster), and if you want, save all that content into FILE. 👑
• -c, --reconnect — Reconnect (CIS client). Simple. Clean.
• -m, --multiple — Multiple connects (CIS client). Yes plural, she's social. 💖
• -r, --receive=[FILE] — Receive (CIS server / BIS broadcast receiver), optionally saving the contents to FILE.
• -s, --send=[FILE] — Connect and send (CIS client / BIS broadcaster), and optionally pull the contents from FILE instead. 📤
• -n, --silent — Connect and be silent (CIS client / BIS broadcaster). Not a word. The strong silent type. 🤫

---

💅 OPTIONS 💅

okay this is the long part but stay with me, every single one matters:

• -b, --bytes=<SIZE> — Send or Receive packet size. 📦
• -i, --index=<NUM> — Select the specified HCI device index. Good news: hciNUM is also acceptable, so pick your fave spelling. 🎀
• -j, --jitter=<JITTER> — Socket jitter buffer.
• -h, --help — the help. The original gives no description and honestly? She just is help. 💀
• -q, --quiet — Disables packet logging. (Not the same as --silent, don't get it twisted. 🫶)
• -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. The options are:
  • 0x00 — Sequential
  • 0x01 — Interleaved
• -F, --framing=<FRAMING> — Socket QoS Framing. The options are:
  • 0x00 — Unframed
  • 0x01 — Framed
• -I, --interval=<USEC> — Socket QoS Interval.
• -L, --latency=<MSEC> — Socket QoS Latency.
• -Y, --phy=<PHY> — Socket QoS PHY. The options are:
  • 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:
  • le_public — LE Public Address
  • le_random — LE Random Address
• -e, --enc=<ENCRYPTION> — Socket QoS BIG Encryption. The options are:
  • 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 🦋

Real scenarios, real commands, copy them exactly bestie:

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> — go, absorb the lore. iykyk. 💜

---

🐛 REPORTING BUGS 🐛

<linux-bluetooth@vger.kernel.org> — found something cursed? Tell them, don't suffer in silence. 😭

---

👑 AUTHOR 👑

Luiz Augusto Von Dentz <luiz.von.dentz@intel.com> — legend behavior, fr fr. 🫶

---

⭐ COPYRIGHT ⭐

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

---

This whole page came to you courtesy of BlueZ, dated May 4, 2022 — and that's the tea, bestie. Stay isochronous. ✨