ContextQMD
Back to Zephyr

Bluetooth: Isochronous Channels Shell

doc/connectivity/bluetooth/shell/host/iso.rst

4.4.03.3 KB
Original Source

Bluetooth: Isochronous Channels Shell #####################################

Commands

.. code-block:: console

iso --help iso - Bluetooth ISO shell commands Subcommands: cig_create :[dir=tx,rx,txrx] [interval] [packing] [framing] [latency] [sdu] [phy] [rtn] cig_term :Terminate the CIG connect :Connect ISO Channel listen :<dir=tx,rx,txrx> [security level] send :Send to ISO Channel [count] disconnect :Disconnect ISO Channel create-big :Create a BIG as a broadcaster [enc <broadcast code>] broadcast :Broadcast on ISO channels sync-big :Synchronize to a BIG as a receiver <BIS bitfield> [mse] [timeout] [enc <broadcast code>] term-big :Terminate a BIG

Unicast examples

  1. [Central] Create CIG:

Requires to be connected:

.. code-block:: console

uart:~$ iso cig_create CIG created

  1. [Peripheral] Listen to ISO connections

.. code-block:: console

uart:~$ iso listen txrx

  1. [Central] Connect ISO channel:

.. code-block:: console

uart:~$ iso connect ISO Connect pending... ISO Channel 0x20000f88 connected

  1. Send data:

.. code-block:: console

uart:~$ iso send send: 40 bytes of data ISO sending...

  1. Disconnect ISO channel:

.. code-block:: console

uart:~$ iso disconnect ISO Disconnect pending... ISO Channel 0x20000f88 disconnected with reason 0x16

Broadcast examples

Setting up broadcaster

.. code-block:: console

uart:$ bt init Bluetooth initialized uart:$ bt adv-create nconn-nscan ext-adv Created adv id: 0, adv: 0x200025d0 uart:$ bt per-adv-param uart:$ iso create-big BIG created ISO Channel 0x200008c0 connected uart:$ uart:$ bt adv-start Advertiser[0] 0x200025d0 set started uart:$ uart:$ bt per-adv on Periodic advertising started uart:$ uart:$ iso broadcast send: 247 bytes of data with PSN 4350 ISO broadcasting...

If encrypted broadcast is required, then a broadcast code can be provided as

.. code-block:: console

uart:~$ iso create-big enc 00112233445566778899aabbccddffff BIG created

Setting up sync receiver

.. code-block:: console

uart:$ bt init Bluetooth initialized uart:$ bt scan on [DEVICE]: 42:0F:7A:40:AE:21 (random), AD evt type 5, RSSI -27 C:0 S:0 D:0 SR:0 E:1 Prim: LE 1M, Secn: LE 2M, Interval: 0x0780 (2400000 us), SID: 0x0 uart:$ bt per-adv-sync-create 42:0F:7A:40:AE:21 (random) 0 Per adv sync pending PER_ADV_SYNC[0]: [DEVICE]: 42:0F:7A:40:AE:21 (random) synced, Interval 0x0780 (2400000 us), PHY LE 2M, SD 0x0000, PAST peer not present PER_ADV_SYNC[0]: [DEVICE]: 42:0F:7A:40:AE:21 (random), tx_power 127, RSSI -28, CTE 0, data length 0 BIG_INFO PER_ADV_SYNC[0]: [DEVICE]: 42:0F:7A:40:AE:21 (random), sid 0x00, num_bis 1, nse 0x04, interval 0x0008 (10000 us), bn 0x01, pto 0x01, irc 0x03, max_pdu 0x00f7, sdu_interval 0x2710, max_sdu 0x00f7, phy LE 2M, framing 0x00, not encrypted uart:$ iso sync-big 1 BIG syncing ISO Channel 0x200008c0 connected

If encrypted broadcast is required, then a broadcast code can be provided as

.. code-block:: console

uart:~$ iso sync-big 1 enc 00112233445566778899aabbccddffff BIG syncing ISO Channel 0x200008c0 connected