zephyr/samples/bluetooth/st_ble_sensor
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:: bluetooth_st_ble_sensor
   :name: ST Bluetooth LE Sensor Demo
   :relevant-api: bt_gatt bluetooth

   Export vendor-specific GATT services over BLE.

Overview
********

This application demonstrates Bluetooth LE peripheral by exposing vendor-specific
GATT services. Currently only button notification and LED service are
implemented. Other Bluetooth LE sensor services can easily be added.
See `BlueST protocol`_ document for details of how to add a new service.

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

* `ST Bluetooth LE Sensor Android app`_
* A board with Bluetooth LE support

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

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

Open ST Bluetooth LE Sensor app and click on "CONNECT TO A DEVICE" button to scan Bluetooth LE devices.
To connect click on the device shown in the Device List.
After connected, tap LED image on Android to test LED service.
Push SW0 button on embedded device to test button service.

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

.. _ST Bluetooth LE Sensor Android app:
    https://play.google.com/store/apps/details?id=com.st.bluems

.. _BlueST protocol:
    https://www.st.com/resource/en/user_manual/dm00550659.pdf