samples/bluetooth/iso_broadcast_benchmark/README.rst - third_party/github/zephyrproject-rtos/zephyr - Git at Google

 .. zephyr:code-sample:: bluetooth_isochronous_broadcaster_benchmark
    :name: Isochronous Broadcaster Benchmark
    :relevant-api: bt_iso bluetooth

    Measure packet loss and sync loss of an ISO broadcaster against one or more receivers.

 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 :zephyr:code-sample-category:`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
	.. zephyr:code-sample:: bluetooth_isochronous_broadcaster_benchmark
	:name: Isochronous Broadcaster Benchmark
	:relevant-api: bt_iso bluetooth

	Measure packet loss and sync loss of an ISO broadcaster against one or more receivers.

	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 :zephyr:code-sample-category:`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