Skip to content

Commit ea52a6b

Browse files
committed
doc: Add support for nRF52840 dongle bare variant
Add a documentation, describing nRF52840 dongle bare variant. Signed-off-by: Tomasz Chyrowicz <[email protected]>
1 parent 809c81b commit ea52a6b

File tree

4 files changed

+29
-10
lines changed

4 files changed

+29
-10
lines changed

doc/nrf/app_dev/board_names.rst

Lines changed: 21 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -46,15 +46,27 @@ While the board name is always present, other elements, such as the board revisi
4646
Check the Product Specification of the given SoC for more information about the available CPU clusters.
4747

4848
* :ref:`Variant <zephyr:glossary>` - You can use this board qualifier to build for a particular type or configuration of a build for a combination of SoC and CPU cluster.
49-
In the |NCS|, variants are used for indicating the usage of Cortex-M Security Extensions (CMSE) (security by separation):
49+
In the |NCS|, board variants are used for the following purposes:
5050

51-
* Entries without ``*/ns`` (for example, ``cpuapp``) - When you choose this target, you build the application core firmware as a single execution environment that does not use CMSE (:ref:`Trusted Firmware-M (TF-M) <ug_tfm>`).
52-
* Entries with ``*/ns`` (for example, ``cpuapp/ns``) - Recommended for more security.
53-
When you choose this target, you build the application with CMSE using security by separation.
54-
The application core firmware is placed in Non-Secure Processing Environment (NSPE) and uses Secure Processing Environment (SPE) for security features.
55-
By default, the build system automatically includes :ref:`Trusted Firmware-M (TF-M) <ug_tfm>` in SPE and merges it with NSPE.
51+
* Changing the default memory map:
52+
This applies to the entry for the nRF52840 Dongle with the ``*/bare`` variant (``nrf52840dongle/nrf52840/bare``).
53+
When you select this target, the firmware does not account for the onboard USB bootloader.
54+
This corresponds to using :zephyr:board:`flashing option 3 with an external debug probe <nrf52840dongle>`.
5655

57-
Read more about separation of processing environments on the :ref:`ug_tfm_security_by_separation` page.
56+
* Indicating the use of Cortex-M Security Extensions (CMSE), also known as security by separation:
57+
58+
* Variants without ``*/ns`` (for example, ``cpuapp``):
59+
When you select this target, you build the application core firmware as a single execution environment without CMSE.
60+
See :ref:`Trusted Firmware-M (TF-M) <ug_tfm>` for more information.
61+
62+
* Variants with ``*/ns`` (for example, ``cpuapp/ns``):
63+
Recommended for enhanced security.
64+
When you select this target, you build the application with CMSE enabled, using security by separation.
65+
66+
The application core firmware is placed in Non-Secure Processing Environment (NSPE) and uses Secure Processing Environment (SPE) for security features.
67+
By default, the build system automatically includes :ref:`Trusted Firmware-M (TF-M) <ug_tfm>` in SPE and merges it with NSPE.
68+
69+
Read more about separation of processing environments on the :ref:`ug_tfm_security_by_separation` page.
5870

5971
.. note::
6072
This board name scheme was introduced in the |NCS| before the v2.7.0 release following changes in Zephyr v3.6.0.
@@ -125,6 +137,8 @@ Also see the :ref:`zephyr:boards` section in the Zephyr documentation.
125137
| | | :ref:`nrf52840dk <zephyr:nrf52840dk_nrf52811>` | ``nrf52840dk/nrf52811`` |
126138
+-------------------+------------+-----------------------------------------------------+-----------------------------------------------------------------------+
127139
| nRF52840 Dongle | PCA10059 | :zephyr:board:`nrf52840dongle <nrf52840dongle>` | ``nrf52840dongle/nrf52840`` |
140+
| | | | |
141+
| | | | ``nrf52840dongle/nrf52840/bare`` |
128142
+-------------------+------------+-----------------------------------------------------+-----------------------------------------------------------------------+
129143
| nRF52833 DK | PCA10100 | :zephyr:board:`nrf52833dk <nrf52833dk>` | ``nrf52833dk/nrf52833`` |
130144
| | | | |

doc/nrf/app_dev/device_guides/nrf52/index.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,8 @@ Zephyr and the |NCS| provide support and contain board definitions for developin
5555
- `Product Specification <nRF52805 Product Specification_>`_
5656
* - :zephyr:board:`nrf52840dongle`
5757
- PCA10059
58-
- ``nrf52840dongle/nrf52840``
58+
- | ``nrf52840dongle/nrf52840``
59+
| ``nrf52840dongle/nrf52840/bare``
5960
- | `Product Specification <nRF52840 Product Specification_>`_
6061
| `User Guide <nRF52840 Dongle User Guide_>`_
6162
* - :zephyr:board:`nrf21540dk`

doc/nrf/includes/sample_board_rows.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@
1414

1515
| :ref:`nRF52840 Dongle <ug_nrf52>` | PCA10059 | :zephyr:board:`nrf52840dongle <nrf52840dongle>` | ``nrf52840dongle/nrf52840`` |
1616

17+
.. nrf52840dongle_nrf52840_bare
18+
19+
| nRF52840 Dongle (:ref:`variant without onboard USB bootloader <app_boards>`) | PCA10059 | :zephyr:board:`nrf52840dongle <nrf52840dongle>` | ``nrf52840dongle/nrf52840/bare`` |
20+
1721
.. nrf9160dk_nrf9160
1822

1923
| :ref:`nRF9160 DK <ug_nrf9160>` | PCA10090 | :ref:`nrf9160dk <zephyr:nrf9160dk_nrf9160>` | ``nrf9160dk/nrf9160`` |

west.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ manifest:
6565
# https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/zephyr/guides/modules.html
6666
- name: zephyr
6767
repo-path: sdk-zephyr
68-
revision: f28ed0b510bd0ba3d9d3d6b719dfd93d481ca52c
68+
revision: pull/3007/head
6969
import:
7070
# In addition to the zephyr repository itself, NCS also
7171
# imports the contents of zephyr/west.yml at the above
@@ -128,7 +128,7 @@ manifest:
128128
compare-by-default: true
129129
- name: mcuboot
130130
repo-path: sdk-mcuboot
131-
revision: c3950c6eea9c4ad0b34436778d479128e5ba3dcb
131+
revision: pull/469/head
132132
path: bootloader/mcuboot
133133
- name: qcbor
134134
url: https://github.com/laurencelundblade/QCBOR

0 commit comments

Comments
 (0)