README.rst
1.. zephyr:code-sample:: bluetooth_ibeacon
2 :name: iBeacon
3 :relevant-api: bluetooth
4
5 Advertise an Apple iBeacon using GAP Broadcaster role.
6
7Overview
8********
9
10This simple application demonstrates the GAP Broadcaster role
11functionality by advertising an Apple iBeacon. The calibrated RSSI @ 1
12meter distance can be set using an IBEACON_RSSI build variable
13(e.g. IBEACON_RSSI=0xb8 for -72 dBm RSSI @ 1 meter), or by manually
14editing the default value in the ``main.c`` file.
15
16Because of the hard-coded values of iBeacon UUID, major, and minor,
17the application is not suitable for production use, but is quite
18convenient for quick demonstrations of iBeacon functionality.
19
20Requirements
21************
22
23* A board with Bluetooth LE support, or
24* QEMU with BlueZ running on the host
25
26Building and Running
27********************
28
29See :zephyr:code-sample-category:`bluetooth` samples for details on how
30to run the sample inside QEMU.
31
32For other boards, build and flash the application as follows:
33
34.. zephyr-app-commands::
35 :zephyr-app: samples/bluetooth/ibeacon
36 :board: <board>
37 :goals: flash
38 :compact:
39
40Refer to your :ref:`board's documentation <boards>` for alternative
41flash instructions if your board doesn't support the ``flash`` target.
42
