51 lines
2.1 KiB
ReStructuredText
51 lines
2.1 KiB
ReStructuredText
.. _mesh_badge:
|
|
|
|
Mesh Badge
|
|
##########
|
|
|
|
Overview
|
|
********
|
|
|
|
This sample app for the reel board showcases Bluetooth mesh
|
|
|
|
The app starts off as a regular Bluetooth GATT peripheral application.
|
|
Install the the "nRF Connect" app on your phone (available both for
|
|
Android and iOS) to access the service that the app exposes. The service
|
|
can also be accessed with any Bluetooth LE GATT client from your PC,
|
|
however these instructions focus on the necessary steps for phones.
|
|
|
|
Steps to set up
|
|
***************
|
|
|
|
#. On your phone, use the nRF Connect app to Scan for devices and look
|
|
for "reel board"
|
|
#. Connect to the device. You'll see a single service - select it
|
|
#. Request to write to the characteristic by pressing on the upward pointing
|
|
arrow symbol
|
|
#. Select "Text" to enter text instead of hex
|
|
#. Enter your name (or any other arbitrary text). Multiple words
|
|
separated by spaces are possible. The font used on the reel display
|
|
allows three rows of up to 12 characters
|
|
wide text. You can force line breaks with a comma.
|
|
#. Press "Send" - this will trigger pairing since this is a protected
|
|
characteristic. The passkey for the pairing will be shown on the board's
|
|
display. Enter the passkey in your phone.
|
|
#. Once pairing is complete the board will show the text you sent. If
|
|
you're not happy with it you can try writing something else.
|
|
#. When you're happy with the text, disconnect from the board (exit the app or
|
|
go back to the device scan page)
|
|
#. Once disconnected the board switches over to Bluetooth mesh mode, and you
|
|
can't connect to it anymore over GATT.
|
|
|
|
If you configure multiple boards like this they can communicate with
|
|
each other over mesh: by pressing the user button on the board the first
|
|
word (name) of the stored text will be sent to all other boards in
|
|
the network and cause the other boards to display "<name> says hi!".
|
|
|
|
To reset a board to its initial state (disable mesh, erase the stored
|
|
text, and make it connectable over GATT):
|
|
|
|
#. Keep the user button pressed when powering on (or press the reset button
|
|
when powered)
|
|
#. Wait until "Resetting Device" is shown
|