115 lines
6.0 KiB
ReStructuredText
115 lines
6.0 KiB
ReStructuredText
.. _iso_broadcast_benchmark:
|
|
|
|
Bluetooth: Throughput
|
|
#####################
|
|
|
|
The ISO Broadcast Benchmark sample measures and report packet loss and sync loss
|
|
of an ISO broadcaster against one or more ISO broadcast receivers.
|
|
|
|
Overview
|
|
********
|
|
|
|
The sample transmits data from the *broadcaster* to the
|
|
*receiver* (multiple receivers may be used with no effect on the test)
|
|
and measures the quality of the sync.
|
|
|
|
The application is used as both a broadcaster and a receiver, and the mode
|
|
can easily be changed.
|
|
|
|
Requirements
|
|
************
|
|
|
|
* BlueZ running on the host, or
|
|
* A board with Bluetooth Low Energy 5.2 support
|
|
* A Bluetooth Controller and board that supports setting
|
|
CONFIG_BT_CTLR_ADV_ISO=y
|
|
* A remote board running the same sample as the reversed role that supports
|
|
setting CONFIG_BT_CTLR_SYNC_ISO
|
|
|
|
Building and running
|
|
********************
|
|
|
|
This sample can be found under
|
|
:zephyr_file:`samples/bluetooth/iso_broadcast_benchmark` in the Zephyr tree.
|
|
|
|
See :ref:`bluetooth samples section <bluetooth-samples>` for details.
|
|
|
|
|
|
Testing
|
|
=======
|
|
|
|
After programming the sample to both boards, test it by performing the following
|
|
steps:
|
|
|
|
1. Connect to both boards with a terminal emulator (for example, PuTTY or
|
|
minicom).
|
|
#. Reset both boards.
|
|
#. In one of the terminal emulators, type "r" to start the application on the
|
|
connected board in the receiver role.
|
|
#. In the other terminal emulator, type "b" to start the application in the
|
|
broadcaster role.
|
|
#. Optionally modify the broadcasting settings.
|
|
#. Observe that the receiver synchronizes to the broadcaster.
|
|
#. Observe the receive statistics on the receiver(s).
|
|
|
|
Sample output
|
|
==============
|
|
The receiver will output statistics for overall (since boot), current sync
|
|
(since the BIG was synced) and latest 1000 received packets::
|
|
|
|
*** Booting Zephyr OS build zephyr-v2.5.0-3768-g42f09317bfbe ***
|
|
[00:00:00.447,845] <inf> iso_broadcast_main: Starting Bluetooth Throughput
|
|
Choose device role - type r (receiver role) or b (broadcaster role), or q to quit: r
|
|
Receiver role
|
|
[00:00:05.784,698] <inf> iso_broadcast_receiver: Scan started
|
|
[00:00:05.784,698] <inf> iso_broadcast_receiver: Waiting for periodic advertiser
|
|
[00:00:05.793,304] <inf> iso_broadcast_receiver: Found broadcaster with address 28:3B:AD:F5:EE:0C (random) (RSSI -33)
|
|
[00:00:05.793,334] <inf> iso_broadcast_receiver: Periodic advertiser found
|
|
[00:00:05.793,701] <inf> iso_broadcast_receiver: Scan stopped
|
|
[00:00:05.793,701] <inf> iso_broadcast_receiver: Creating Periodic Advertising Sync
|
|
[00:00:05.796,081] <inf> iso_broadcast_receiver: Waiting for periodic sync
|
|
[00:00:06.453,460] <err> bt_scan: Unknown handle 0x0000 for periodic advertising report
|
|
[00:00:06.453,979] <inf> iso_broadcast_receiver: Periodic advertisement synced
|
|
[00:00:06.454,010] <inf> iso_broadcast_receiver: Periodic sync established
|
|
[00:00:06.454,040] <inf> iso_broadcast_receiver: Waiting for BIG info
|
|
[00:00:08.853,485] <inf> iso_broadcast_receiver: BIGinfo received: num_bis 2, nse 1, interval 7 ms, bn 1, pto 0, irc 1, max_pdu 251, sdu_interval 7500 us, max_sdu 251, phy LE 2M, without framing, not encrypted
|
|
[00:00:08.853,515] <inf> iso_broadcast_receiver: Syncing to BIG
|
|
[00:00:08.853,973] <inf> iso_broadcast_receiver: Waiting for BIG sync
|
|
[00:00:11.254,211] <inf> iso_broadcast_receiver: ISO Channel 0x2000124c connected
|
|
[00:00:11.254,333] <inf> iso_broadcast_receiver: BIG sync established
|
|
[00:00:11.254,486] <inf> iso_broadcast_receiver: ISO Channel 0x20001260 connected
|
|
[00:00:11.639,343] <inf> iso_broadcast_receiver: Overall : Received 99/100 (99.00%) - Total packets lost 1
|
|
[00:00:11.639,343] <inf> iso_broadcast_receiver: Current Sync: Received 99/100 (99.00%) - Total packets lost 1
|
|
[00:00:11.639,373] <inf> iso_broadcast_receiver: Latest 1000 : Received 99/100 (99.00%) - Total packets lost 1
|
|
[00:00:12.029,388] <inf> iso_broadcast_receiver: Overall : Received 199/200 (99.50%) - Total packets lost 1
|
|
[00:00:12.029,388] <inf> iso_broadcast_receiver: Current Sync: Received 199/200 (99.50%) - Total packets lost 1
|
|
[00:00:12.029,388] <inf> iso_broadcast_receiver: Latest 1000 : Received 199/200 (99.50%) - Total packets lost 1
|
|
|
|
|
|
The broadcaster will ask if any changes to the current settings are wanted.
|
|
If y/Y is chosen, then it will create a prompt to enter changes to the settings,
|
|
otherwise continue with the current settings. The broadcaster will then start
|
|
the BIG and output the current counter (since the BIG was created)::
|
|
|
|
*** Booting Zephyr OS build zephyr-v2.5.0-3768-g06d4327cc601 ***
|
|
[00:00:00.447,845] <inf> iso_broadcast_main: Starting Bluetooth Throughput
|
|
Choose device role - type r (receiver role) or b (broadcaster role), or q to quit: b
|
|
Broadcaster role
|
|
Change settings (y/N)? (Current settings: rtn=2, interval=7500, latency=10, phy=2, sdu=251, packing=0, framing=0, bis_count=2)
|
|
[00:00:08.802,185] <inf> iso_broadcast_broadcaster: Creating Extended Advertising set
|
|
[00:00:08.804,260] <inf> iso_broadcast_broadcaster: Setting Extended Advertising parameters
|
|
[00:00:08.804,504] <inf> iso_broadcast_broadcaster: Starting Periodic Advertising
|
|
[00:00:08.804,870] <inf> iso_broadcast_broadcaster: Starting Extended Advertising set
|
|
[00:00:08.807,159] <inf> iso_broadcast_broadcaster: Creating BIG
|
|
[00:00:08.807,617] <inf> iso_broadcast_broadcaster: Waiting for BIG complete
|
|
[00:00:08.813,049] <inf> iso_broadcast_broadcaster: ISO Channel 0x20001218 connected
|
|
[00:00:08.813,171] <inf> iso_broadcast_broadcaster: BIG created
|
|
[00:00:08.813,507] <inf> iso_broadcast_broadcaster: ISO Channel 0x2000122c connected
|
|
[00:00:09.196,472] <inf> iso_broadcast_broadcaster: Sending value 100
|
|
[00:00:09.587,036] <inf> iso_broadcast_broadcaster: Sending value 200
|
|
[00:00:09.977,722] <inf> iso_broadcast_broadcaster: Sending value 300
|
|
[00:00:10.368,347] <inf> iso_broadcast_broadcaster: Sending value 400
|
|
[00:00:10.758,972] <inf> iso_broadcast_broadcaster: Sending value 500
|
|
[00:00:11.149,597] <inf> iso_broadcast_broadcaster: Sending value 600
|
|
[00:00:11.540,222] <inf> iso_broadcast_broadcaster: Sending value 700
|