Observer

Browse source code on GitHub

Overview

A simple application demonstrating Bluetooth Low Energy Observer role functionality. The application will periodically scan for devices nearby. If any found, prints the address of the device, the RSSI value, the Advertising type, and the Advertising data length to the console.

If the used Bluetooth Low Energy Controller supports Extended Scanning, you may enable CONFIG_BT_EXT_ADV in the project configuration file. Refer to the project configuration file for further details.

Requirements

  • A board with Bluetooth Low Energy support

Building and Running

Build and flash the sample as follows, replacing <board> with your target board:

west build -b <board> samples/bluetooth/observer
west flash

The sample will print information about nearby Bluetooth LE devices to the console, including their address, RSSI value, advertising type, and advertising data length.

Building with Extended Scanning support (Zephyr Controller)

west build -b nrf52840dk/nrf52840 samples/bluetooth/observer -- -DCONF_FILE=prj_extended.conf -DEXTRA_CONF_FILE=overlay-bt_ll_sw_split.conf
west flash

Building with Extended Scanning support for BBC Micro Bit

west build -b bbc_microbit samples/bluetooth/observer -- -DCONF_FILE=prj_extended.conf -DEXTRA_CONF_FILE=overlay_bbc_microbit-bt_ll_sw_split.conf
west flash

Thread Analysis for BBC Micro Bit board

Due to resource constraints on the BBC Micro Bit board, thread analysis can be enabled to profile RAM usage and identify the thread stack sizes required to successfully build and run the sample.

west build -b bbc_microbit samples/bluetooth/observer -- -DCONF_FILE=prj_extended.conf "-DEXTRA_CONF_FILE=debug.conf;overlay_bbc_microbit-bt_ll_sw_split.conf"
west flash

See also

Generic Access Profile (GAP)
Bluetooth APIs