.. zephyr:code-sample:: bluetooth_ibeacon
:name: iBeacon
:relevant-api: bluetooth
Advertise an Apple iBeacon using GAP Broadcaster role.
Overview
********
This simple application demonstrates the GAP Broadcaster role
functionality by advertising an Apple iBeacon. The calibrated RSSI @ 1
meter distance can be set using an IBEACON_RSSI build variable
(e.g. IBEACON_RSSI=0xb8 for -72 dBm RSSI @ 1 meter), or by manually
editing the default value in the ``main.c`` file.
Because of the hard-coded values of iBeacon UUID, major, and minor,
the application is not suitable for production use, but is quite
convenient for quick demonstrations of iBeacon functionality.
Requirements
************
* A board with Bluetooth LE support, or
* QEMU with BlueZ running on the host
Building and Running
********************
This sample can be found under :zephyr_file:`samples/bluetooth/ibeacon` in the
Zephyr tree.
See :zephyr:code-sample-category:`bluetooth` samples for details on how
to run the sample inside QEMU.
For other boards, build and flash the application as follows:
.. zephyr-app-commands::
:zephyr-app: samples/bluetooth/ibeacon
:board: <board>
:goals: flash
:compact:
Refer to your :ref:`board's documentation <boards>` for alternative
flash instructions if your board doesn't support the ``flash`` target.
1db9b009a7