1.. zephyr:code-sample:: mesh_badge
2   :name: Bluetooth Mesh badge
3   :relevant-api: monochrome_character_framebuffer bt_mesh bt_gatt bluetooth
4
5   Implement a smart badge using the reel board and Bluetooth Mesh.
6
7Overview
8********
9
10This sample app for the reel board showcases Bluetooth Mesh.
11
12The app starts off as a regular Bluetooth GATT peripheral application.
13Install the "nRF Connect" app on your phone (available both for
14Android and iOS) to access the service that the app exposes. The service
15can also be accessed with any Bluetooth LE GATT client from your PC,
16however these instructions focus on the necessary steps for phones.
17
18Steps to set up
19***************
20
21#. On your phone, use the nRF Connect app to Scan for devices and look
22   for "reel board"
23#. Connect to the device. You'll see a single service - select it
24#. Request to write to the characteristic by pressing on the upward pointing
25   arrow symbol
26#. Select "Text" to enter text instead of hex
27#. Enter your name (or any other arbitrary text). Multiple words
28   separated by spaces are possible. The font used on the reel display
29   allows three rows of up to 12 characters
30   wide text. You can force line breaks with a comma.
31#. Press "Send" - this will trigger pairing since this is a protected
32   characteristic. The passkey for the pairing will be shown on the board's
33   display. Enter the passkey in your phone.
34#. Once pairing is complete the board will show the text you sent. If
35   you're not happy with it you can try writing something else.
36#. When you're happy with the text, disconnect from the board (exit the app or
37   go back to the device scan page)
38#. Once disconnected the board switches over to Bluetooth Mesh mode, and you
39   can't connect to it anymore over GATT.
40
41If you configure multiple boards like this they can communicate with
42each other over mesh: by pressing the user button on the board the first
43word (name) of the stored text will be sent to all other boards in
44the network and cause the other boards to display "<name> says hi!".
45
46To reset a board to its initial state (disable mesh, erase the stored
47text, and make it connectable over GATT):
48
49#. Keep the user button pressed when powering on (or press the reset button
50   when powered)
51#. Wait until "Resetting Device" is shown
52