zephyr/samples/bluetooth/direct_adv
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_direct_adv
   :name: Direct Advertising
   :relevant-api: bluetooth

   Advertise directly to a bonded central device.

Overview
********

Application demonstrating the Bluetooth LE Direct Advertising capability. If no device is bonded
to the peripheral, casual advertising will be performed. Once bonded, on every subsequent
boot direct advertising to the bonded central will be performed. Additionally this sample
provides two Bluetooth LE characteristics. To perform write, devices need to be bonded, while read
can be done just after connection (no bonding required).

Please note that direct advertising towards iOS based devices is not allowed.
For more information about designing Bluetooth LE devices for Apple products refer to
"Accessory Design Guidelines for Apple Devices".

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

* A board with Bluetooth LE support
* Second Bluetooth LE device acting as a central with enabled privacy. For example another Zephyr board
  or any modern smartphone

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

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

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