README.rst
1.. zephyr:code-sample:: bluetooth_observer
2 :name: Observer
3 :relevant-api: bt_gap bluetooth
4
5 Scan for Bluetooth devices nearby and print their information.
6
7Overview
8********
9
10A simple application demonstrating Bluetooth Low Energy Observer role
11functionality. The application will periodically scan for devices nearby.
12If any found, prints the address of the device, the RSSI value, the Advertising
13type, and the Advertising data length to the console.
14
15If the used Bluetooth Low Energy Controller supports Extended Scanning, you may
16enable :kconfig:option:`CONFIG_BT_EXT_ADV` in the project configuration file. Refer to the
17project configuration file for further details.
18
19Building Extended Scanning support for BBC Micro Bit board
20**********************************************************
21
22.. code-block:: console
23
24 west build -b bbc_microbit . -- -DCONF_FILE='prj_extended.conf' -DEXTRA_CONF_FILE='overlay_bbc_microbit-bt_ll_sw_split.conf'
25
26Thread Analysis for BBC Micro Bit board
27***************************************
28
29Due to resource constraints on the BBC Micro Bit board, thread analysis can be enabled to profile
30the RAM usage and thread stack sizes be updated to successfully build and run the sample.
31
32.. code-block:: console
33
34 west build -b bbc_microbit . -- -DCONF_FILE='prj_extended.conf' -DEXTRA_CONF_FILE='debug.conf;overlay_bbc_microbit-bt_ll_sw_split.conf'
35
36Requirements
37************
38
39* A board with Bluetooth Low Energy support
40
41Building and Running
42********************
43
44See :zephyr:code-sample-category:`Bluetooth samples section <bluetooth>` for details.
45
