Bluetooth: Peripheral LBS¶
The peripheral LBS sample demonstrates how to use the LED Button Service (LBS).
Overview¶
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 can control the state of LED 3 on the development kit.
Alternatively, you can use this sample to control the color of RGB LED on the nRF52840 Dongle.
Requirements¶
The sample supports the following development kits:
Hardware platforms |
PCA |
Board name |
Build target |
---|---|---|---|
PCA10095 |
|
||
PCA10056 |
|
||
PCA10056 |
|
||
PCA10100 |
|
||
PCA10100 |
|
||
PCA10040 |
|
||
PCA10040 |
|
||
PCA10059 |
|
The sample also requires a phone or tablet running a compatible application, for example nRF Connect for Mobile, nRF Blinky, or nRF Toolbox.
User interface¶
For nRF52840 Dongle:
- RGB LED:
- Red:
On when connected.
- Green:
Controlled remotely from the connected device.
- Button 1:
Sends a notification with the button state: “pressed” or “released”.
For development kits:
- LED 1:
When the main loop is running (device is advertising), blinks with a period of 2 seconds, duty cycle 50%.
- LED 2:
On when connected.
- LED 3:
Controlled remotely from the connected device.
- Button 1:
Sends 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.
See Building and programming a sample application for information about how to build and program the application.
Minimal Build¶
The sample can be built with a minimum configuration as a demonstration of how to reduce code size and RAM usage.
west build samples/bluetooth/peripheral_lbs -- -DCONF_FILE='prj_minimal.conf'
Testing¶
After programming the sample to your dongle or development kit, test it by performing the following steps. This testing procedure assumes that you are using nRF Connect for Mobile.
Power on your development kit or plug in your dongle.
Connect to the device from nRF Connect (the device is advertising as “Nordic_LBS”).
Observe that the services of the connected device are shown.
In “Nordic LED Button Service”, click the Play button for the “Button” characteristic.
Press Button 1 either on the dongle or on the development kit.
Observe that notifications with the following values are received:
00
when Button 1 is released,01
when Button 1 is pressed.
Control the color of RGB LED on the dongle or status of LED 3 on the kit by writing the following values to the “LED” characteristic in the “Nordic LED Button Service”:
00
to switch the LED off on the kit or turn on the red RGB LED on the dongle.01
to switch the LED on on the kit or turn on the green RGB LED on the dongle.
Observe that RGB LED on the dongle or LED 3 on the kit corresponds to the value of the “LED” characteristic.
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
-
include/bluetooth/bluetooth.h
include/bluetooth/hci.h
include/bluetooth/conn.h
include/bluetooth/uuid.h
include/bluetooth/gatt.h