Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: peripheral_lbs: Update testing section with nRF Blinky app #19874

Merged
merged 2 commits into from
Jan 15, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion applications/machine_learning/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,5 @@ See the subpages for detailed documentation on the application and its modules:

app_desc
config_options
intenal_module
internal_module
api
1 change: 1 addition & 0 deletions doc/nrf/links.txt
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@
.. _`sdk-nrfxlib`: https://github.com/nrfconnect/sdk-nrfxlib

.. _`nRF Blinky`: https://github.com/NordicSemiconductor/Android-nRF-Blinky
.. _`nRF Blinky documentation`: https://github.com/NordicSemiconductor/Android-nRF-Blinky?tab=readme-ov-file#nrf-blinky-for-android

.. _`Source code for nRF Wi-Fi Provisioner mobile app for Android`: https://github.com/NordicSemiconductor/Android-nRF-Wi-Fi-Provisioner
.. _`Source code for nRF Wi-Fi Provisioner mobile app for iOS`: https://github.com/NordicSemiconductor/IOS-nRF-Wi-Fi-Provisioner
Expand Down
133 changes: 71 additions & 62 deletions samples/bluetooth/peripheral_lbs/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The sample supports the following development kits:
.. include:: /includes/tfm.txt

The sample also requires a smartphone or tablet running a compatible mobile 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`_).
The `Testing`_ instructions refer to `nRF Connect for Mobile`_ and `nRF Blinky`_, but you can also use other similar applications, such as `nRF Toolbox`_.

.. note::
|thingy53_sample_note|
Expand Down Expand Up @@ -139,70 +139,79 @@ Testing

After programming the sample to your dongle or development kit, one of the LEDs starts blinking to indicate that the advertising loop is active (see `User interface`_ for details).

To test the sample using the `nRF Connect for Mobile`_ application, complete the following steps:

.. tabs::

.. group-tab:: nRF52 and nRF53 DKs

1. Install and 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 |
+========================+=========+==============================================+
| nRF52 and nRF53 DKs | ``OFF`` | Switch the **LED 3** off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the **LED 3** on. |
+------------------------+---------+----------------------------------------------+
| nRF52840 Dongle | ``OFF`` | Switch the green channel of the RGB LED off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the green channel of the RGB LED on. |
+------------------------+---------+----------------------------------------------+
| Thingy:53 | ``OFF`` | Switch the blue channel of the RGB LED off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the blue channel of the RGB LED on. |
+------------------------+---------+----------------------------------------------+

.. group-tab:: nRF54 DKs

.. note::
|nrf54_buttons_leds_numbering|

1. Install and 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 |
+========================+=========+==============================================+
| nRF54 DKs | ``OFF`` | Switch the **LED 2** off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the **LED 2** on. |
+------------------------+---------+----------------------------------------------+
.. group-tab:: nRF Connect for Mobile

To test the sample using the `nRF Connect for Mobile`_ application, complete the following steps:

.. tabs::

.. group-tab:: nRF52 and nRF53 DKs

1. Install and 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 |
+========================+=========+==============================================+
| nRF52 and nRF53 DKs | ``OFF`` | Switch the **LED 3** off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the **LED 3** on. |
+------------------------+---------+----------------------------------------------+
| nRF52840 Dongle | ``OFF`` | Switch the green channel of the RGB LED off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the green channel of the RGB LED on. |
+------------------------+---------+----------------------------------------------+
| Thingy:53 | ``OFF`` | Switch the blue channel of the RGB LED off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the blue channel of the RGB LED on. |
+------------------------+---------+----------------------------------------------+

.. group-tab:: nRF54 DKs

.. note::
|nrf54_buttons_leds_numbering|

1. Install and 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 |
+========================+=========+==============================================+
| nRF54 DKs | ``OFF`` | Switch the **LED 2** off. |
+ +---------+----------------------------------------------+
| | ``ON`` | Switch the **LED 2** on. |
+------------------------+---------+----------------------------------------------+

.. group-tab:: nRF Blinky

To test the sample using the nRF Blinky mobile app, see the `nRF Blinky documentation`_.


Dependencies
Expand Down