Bluetooth: Peripheral LBS
The peripheral LBS sample demonstrates how to use the LED Button Service (LBS).
Requirements
The sample supports the following development kits:
Hardware platforms |
PCA |
Board name |
Board target |
---|---|---|---|
PCA20053 |
|
||
PCA10156 |
|
||
PCA10175 |
|
||
PCA10095 |
|
||
PCA10040 |
|
||
PCA10040 |
|
||
PCA10056 |
|
||
PCA10056 |
|
||
PCA10100 |
|
When built for a board target with the */ns
variant, the sample is configured to compile and run as a non-secure application with Cortex-M Security Extensions enabled.
Therefore, it automatically includes Trusted Firmware-M that prepares the required peripherals and secure services to be available for the application.
The sample also requires a smartphone or tablet running a compatible application. The Testing instructions refer to nRF Connect for Mobile, but you can also use other similar applications (for example, nRF Blinky or nRF Toolbox).
Note
If you build this application for Thingy:53, it enables additional features. See Application guide for Thingy:53 for details.
Overview
You can use the sample to transmit the button state from your development kit to another device.
When connected, the sample sends the state of Button 1 on the development kit to the connected device, such as a phone or tablet. The mobile application on the device can display the received button state and control the state of LED 3 on the development kit.
When connected, the sample sends the state of Button 0 on the development kit to the connected device, such as a phone or tablet. The mobile application on the device can display the received button state and control the state of LED 2 on the development kit.
You can also use this sample to control the color of the RGB LED on the nRF52840 Dongle or Thingy:53.
User interface
The user interface of the sample depends on the hardware platform you are using.
nRF52840 Dongle
- Green LED:
Blinks, toggling on/off every second, when the main loop is running and the device is advertising.
- RGB LED:
The RGB LED channels are used independently to display the following information:
Red - If Dongle is connected.
Green - If user set the LED using Nordic LED Button Service.
- Button 1:
Send a notification with the button state: “pressed” or “released”.
Thingy:53
- RGB LED:
The RGB LED channels are used independently to display the following information:
Red - If the main loop is running (that is, the device is advertising). The LED blinks with a period of two seconds, duty cycle 50%.
Green - If the device is connected.
Blue - If user set the LED using Nordic LED Button Service.
For example, if Thingy:53 is connected over Bluetooth, the LED color toggles between green and yellow. The green LED channel is kept on and the red LED channel is blinking.
- Button 1:
Send a notification with the button state: “pressed” or “released”.
Development kits
- LED 1:
Blinks when the main loop is running (that is, the device is advertising) with a period of two seconds, duty cycle 50%.
- LED 2:
Lit when the development kit is connected.
- LED 3:
Lit when the development kit is controlled remotely from the connected device.
- Button 1:
Send a notification with the button state: “pressed” or “released”.
- LED 0:
Blinks when the main loop is running (that is, the device is advertising) with a period of two seconds, duty cycle 50%.
- LED 1:
Lit when the development kit is connected.
- LED 2:
Lit when the development kit is controlled remotely from the connected device.
- Button 0:
Send a notification with the button state: “pressed” or “released”.
Building and running
This sample can be found under samples/bluetooth/peripheral_lbs
in the nRF Connect SDK folder structure.
When built as firmware image for a board target with the */ns
variant, the sample has Cortex-M Security Extensions (CMSE) enabled and separates the firmware between Non-Secure Processing Environment (NSPE) and Secure Processing Environment (SPE).
Because of this, it automatically includes the Trusted Firmware-M (TF-M).
To read more about CMSE, see Processing environments.
To build the sample, follow the instructions in Configuring and building an application for your preferred building environment. See also Programming an application for programming steps and Testing and optimization for general information about testing and debugging in the nRF Connect SDK.
Note
When building repository applications in the SDK repositories, building with sysbuild is enabled by default.
If you work with out-of-tree freestanding applications, you need to manually pass the --sysbuild
parameter to every build command or configure west to always use it.
Note
Programming the nRF54H20 SoC can sometimes fail due to conflicts in the resource configuration. This can happen if, for example, an application programmed to the nRF54H20 SoC configured the UICRs for one or more cores in a way that is incompatible with the configuration required by the application you are trying to program on the SoC.
To fix this error and erase the UICR for the application core, run the following command:
nrfutil device recover --core Application
If your sample also uses the radio core, you must also erase the UICRs for the radio core. To erase the UICR for the radio core, run the following command:
nrfutil device recover --core Network
For more information on the command, run:
nrfutil device recover --help
You can then run west flash
to program your application.
Minimal build
You can build the sample with a minimum configuration as a demonstration of how to reduce code size and RAM usage, using the -DFILE_SUFFIX=minimal
flag in your build.
See Providing CMake options for instructions on how to add this option to your build. For example, when building on the command line, you can add the option as follows:
west build samples/bluetooth/peripheral_lbs -- -DFILE_SUFFIX=minimal
Testing
After programming the sample to your dongle or development kit, test it by performing the following steps:
Start the nRF Connect for Mobile application on your smartphone or tablet.
Power on the development kit or insert your dongle into the USB port.
Connect to the device from the application. The device is advertising as
Nordic_LBS
. The services of the connected device are shown.In Nordic LED Button Service, enable notifications for the Button characteristic.
Press Button 1 on the device.
Observe that notifications with the following values are displayed:
Button released
when Button 1 is released.Button pressed
when Button 1 is pressed.
Write the following values to the LED characteristic in the Nordic LED Button Service. Depending on the hardware platform, this produces results described in the table.
Hardware platform |
Value |
Effect |
---|---|---|
Development kit |
|
Switch the LED 3 off. |
|
Switch the LED 3 on. |
|
nRF52840 Dongle |
|
Switch the green channel of the RGB LED off. |
|
Switch the green channel of the RGB LED on. |
|
Thingy:53 |
|
Switch the blue channel of the RGB LED off. |
|
Switch the blue channel of the RGB LED on. |
Start the nRF Connect for Mobile application on your smartphone or tablet.
Power on the development kit or insert your dongle into the USB port.
Connect to the device from the application. The device is advertising as
Nordic_LBS
. The services of the connected device are shown.In Nordic LED Button Service, enable notifications for the Button characteristic.
Press Button 0 on the device.
Observe that notifications with the following values are displayed:
Button released
when Button 0 is released.Button pressed
when Button 0 is pressed.
Write the following values to the LED characteristic in the Nordic LED Button Service. Depending on the hardware platform, this produces results described in the table.
Hardware platform |
Value |
Effect |
---|---|---|
Development kit |
|
Switch the LED 2 off. |
|
Switch the LED 2 on. |
|
nRF52840 Dongle |
|
Switch the green channel of the RGB LED off. |
|
Switch the green channel of the RGB LED on. |
|
Thingy:53 |
|
Switch the blue channel of the RGB LED off. |
|
Switch the blue channel of the RGB LED on. |
Dependencies
This sample uses the following nRF Connect SDK libraries:
In addition, it uses the following Zephyr libraries:
include/zephyr/types.h
lib/libc/minimal/include/errno.h
include/sys/printk.h
include/sys/byteorder.h
API:
include/bluetooth/bluetooth.h
include/bluetooth/hci.h
include/bluetooth/conn.h
include/bluetooth/uuid.h
include/bluetooth/gatt.h
The sample also uses the following secure firmware component: