You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/nrf-bm/includes/configure_and_build_sample.txt
+7-6Lines changed: 7 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,15 @@ Follow these steps to create your first build configuration for this sample:
7
7
8
8
You will need the following information:
9
9
10
-
* The |NCS| version and toolchain version the current |BMshort| release is based on: v3.0.1
11
-
* The board target onto which you want to program the firmware (**Requirements** section).
10
+
* The |NCS| version and toolchain version that the current |BMshort| release is based on: |ncs_release|
11
+
* The board target onto which you want to program the firmware (see `Requirements`_).
12
12
13
13
This information will be used in the steps that follow.
14
14
15
15
.. note::
16
16
The following steps will use the **Hello SoftDevice** sample as reference.
17
17
18
-
#. In the `Applications View`_, click on :guilabel:`Add build configuration`.
18
+
#. In the `Applications View`_, click :guilabel:`Add build configuration`.
19
19
20
20
.. figure:: /images/add_build_configuration.png
21
21
:alt: Add Build Configuration
@@ -33,7 +33,7 @@ Follow these steps to create your first build configuration for this sample:
33
33
34
34
#. Select the board target onto which you want to program the firmware.
35
35
36
-
For your very first build configuration, select a compatible board target from the dropdown menu.
36
+
For your very first build configuration, select a compatible board target from the drop-down menu.
37
37
38
38
.. figure:: /images/board_target.png
39
39
:alt: Board target drop-down menu
@@ -44,11 +44,12 @@ Follow these steps to create your first build configuration for this sample:
44
44
45
45
For more details on how to configure builds, see `How to build an application`_ in |VSC| extension documentation.
46
46
47
-
#. Click the :guilabel:`Generate and Build` button.
47
+
#. Click :guilabel:`Generate and Build`.
48
48
49
49
The |VSC| extension generates the configuration file and triggers the build process, which can take some time. You can monitor its progress in the notification that appears.
50
50
51
-
When the process is complete, the `Actions View`_ appears. In this View, you can trigger the build process again, flash the built application, start a debug session, or generate a memory report.
51
+
When the process is complete, the `Actions View`_ appears.
52
+
In this View, you can trigger the build process again, flash the built application, start a debug session (if debug options were set when building), or generate a memory report.
52
53
The build files appear in the build's `Details View`_, which is named after your application.
Copy file name to clipboardExpand all lines: doc/nrf-bm/includes/softdevice_flash.txt
+7-3Lines changed: 7 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -8,19 +8,19 @@ To flash the S115 SoftDevice binary to your device, open the terminal and run th
8
8
9
9
.. code-block:: console
10
10
11
-
cd C:/ncs/v0.7.0/nrf-bm
11
+
cd C:/ncs/bm_v0.7.0/nrf-bm
12
12
13
13
.. group-tab:: Linux
14
14
15
15
.. code-block:: console
16
16
17
-
cd ~/ncs/v0.7.0/nrf-bm
17
+
cd ~/ncs/bm_v0.7.0/nrf-bm
18
18
19
19
.. group-tab:: macOS
20
20
21
21
.. code-block:: console
22
22
23
-
cd /opt/nordic/ncs/v0.7.0/nrf-bm
23
+
cd /opt/nordic/ncs/bm_v0.7.0/nrf-bm
24
24
25
25
#. Then, make sure that your device is erased:
26
26
@@ -49,3 +49,7 @@ To flash the S115 SoftDevice binary to your device, open the terminal and run th
49
49
.. code-block:: console
50
50
51
51
nrfutil device program --firmware subsys/softdevice/hex/s115/s115_9.0.0-2.prototype+offset-0x05D000_softdevice.hex
52
+
53
+
.. note::
54
+
Keep in mind that the flashed SoftDevice variant must be in sync with the board target that you are planning to use in the build configuration of the sample.
55
+
For example, for the ``bm_nrf54l15dk/nrf54l15/cpuapp/softdevice_s115`` board target, you must use the SoftDevice binary :file:`s115_9.0.0-2.prototype+offset-0x15D000_softdevice.hex` .
Copy file name to clipboardExpand all lines: doc/nrf-bm/index.rst
+25-6Lines changed: 25 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,17 +4,36 @@
4
4
Introduction
5
5
############
6
6
7
-
|BMlong| is an enhancement to the |NCS|, offering an optional configuration for developing Bluetooth LE applications that do not benefit from utilizing an RTOS nor require advanced features.
7
+
The |BMlong| is a streamlined enhancement of the |NCS|, tailored for developers who are working on Bluetooth® LE applications that do not require the complexities of an RTOS or the full suite of advanced features.
8
+
This option is particularly beneficial for applications that require a lightweight, responsive solution.
8
9
9
-
You can use this development option for the following:
10
+
A major component of the |BMshort| configuration is the SoftDevice.
11
+
To facilitate Bluetooth LE operations without an RTOS, a new SoftDevice variant supporting the latest nRF54L devices has been released.
12
+
This new variant maintains a similar functionality and API to those found in the existing nRF52 SoftDevices, ensuring a smooth transition and familiarity for developers.
10
13
11
-
* Development of threadless applications without the use of Zephyr RTOS.
12
-
* Migration of applications originally created for the nRF52 devices using the nRF5 SDK.
14
+
The |BMshort| codebase is structured to include libraries and modules that are specifically designed to operate without an RTOS.
15
+
This ensures that all included components are optimized for threadless, bare metal environments.
16
+
17
+
The |BMshort| option is ideal for:
18
+
19
+
* Developing simple, threadless applications without the need for Zephyr RTOS.
20
+
* Migrating applications initially developed for nRF52 devices using the nRF5 SDK.
21
+
22
+
Integration and structure
23
+
*************************
24
+
25
+
The |BMlong| is a distinct repository that incorporates elements from the existing |NCS|:
26
+
27
+
* **Repository-Level Filtering:** |BMshort| utilizes a repository-level filtering mechanism designed to include components beneficial for bare metal development.
28
+
However, this approach is based on the best possible method available, which means that some components that are not ideally suited for bare metal applications will also be included.
29
+
Developers should be aware of these limitations and exercise discretion when utilizing the repository.
30
+
* **Tools:** Tools such as the compiler and linker from the original |NCS| are reused in the Bare Metal option.
31
+
The existing nRF Connect extension in |VSC| is the recommended IDE for working with Bare Metal.
0 commit comments