zephyr/samples/bluetooth/periodic_sync_rsp
Aleksander Wasaznik 8cfad44852 Bluetooth: Deprecate adv auto-resume
The host-based adv auto-resume function has both a problematic
implementation and disagreement in the community around how it should
behave. See the issue linked resolved below for details.

This patch makes the deprecation visible to the user. The user will be
better served by a auto-resume tailored their applications use case,
based on more primitive host API like `conn_cb.recycled`, which has
obvious behavior that is unlikely to change.

Resolves: https://github.com/zephyrproject-rtos/zephyr/issues/72567

Signed-off-by: Aleksander Wasaznik <aleksander.wasaznik@nordicsemi.no>
2024-10-08 16:57:01 +02:00
..
src Bluetooth: Deprecate adv auto-resume 2024-10-08 16:57:01 +02:00
CMakeLists.txt
README.rst doc: samples: Adopt code-sample-category across tree 2024-09-23 12:00:00 +02:00
prj.conf
sample.yaml

README.rst

.. zephyr:code-sample:: ble_periodic_adv_sync_rsp
   :name: Periodic Advertising with Responses (PAwR) Synchronization
   :relevant-api: bt_gap bluetooth

   Implement Bluetooth LE Periodic Advertising with Responses Synchronization.

Overview
********

A simple application demonstrating the Bluetooth LE Periodic Advertising with
Responses Synchronization functionality.

This sample will echo the data received in subevent indications back to the
advertiser.

Which subevent to listen to and in which response slot to respond is
application specific. In this sample it is decided by the PAwR advertiser.
Upon connection it will write to a GATT characteristic
the assigned subevent and response slot.

Flash this sample to multiple devices and they will be given different
subevents and response slots, to that they can communicate with the
advertiser concurrently.

Requirements
************

* A board with Bluetooth LE support
* A controller that supports the Periodic Advertising with Responses (PAwR) - Scanner feature

Building and Running
********************

This sample can be found under :zephyr_file:`samples/bluetooth/periodic_sync_rsp` in
the Zephyr tree.

Use the sample found under :zephyr_file:`samples/bluetooth/periodic_adv_rsp` on
another board that will start periodic advertising, which will connect to this
sample and transfer the synchronization info.

See :zephyr:code-sample-category:`bluetooth` samples for details.