Skip to content

Commit 75b0f91

Browse files
committed
doc: add changes requested by grochu
Removing SES section (not applicable to new SES). Adding information about building for secure and non-secure domains. Signed-off-by: Bartosz Gentkowski <[email protected]>
1 parent 3075c3d commit 75b0f91

File tree

1 file changed

+12
-36
lines changed

1 file changed

+12
-36
lines changed

doc/nrf/ug_nrf5340.rst

Lines changed: 12 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,10 @@ The network core is an Arm Cortex-M33 processor with a reduced feature set, desi
2222
This core is used for radio communication.
2323
With regards to the nRF5340 samples, this means that the network core runs the radio stack and real-time procedures.
2424
Currently, the following solutions are available for the network core:
25+
2526
* Bluetooth Low Energy Controller - compatible with several BLE samples.
2627
Both the BLE Controller from Zephyr and :ref:`nrfxlib:ble_controller` are supported.
27-
* the :ref:`radio_test` sample that runs only on the network core and is used for testing the Radio peripheral.
28+
* The :ref:`radio_test` sample that runs only on the network core and is used for testing the Radio peripheral.
2829
To start the network core, this sample requires any sample programmed on the application core.
2930
For example, you can use :ref:`zephyr:hello_world` for this purpose.
3031

@@ -38,17 +39,21 @@ Application core
3839
The application core is a full-featured Arm Cortex-M33 processor including DSP instructions and FPU.
3940

4041
Currently, the |NCS| provides the following solutions for the application core:
42+
4143
* high-level radio stack (the host part of the Bluetooth Low Energy stack) and application logic,
42-
* samples running only on the application core.
43-
For example, NFC samples with nRF53 support.
44+
* samples running only on the application core (for example, NFC samples with nRF53 support).
4445

4546
In general, this core should be used for tasks that require high performance and application-level logic.
4647

4748
The board name for the application core in Zephyr is ``nrf5340_dk_nrf5340_cpuapp``.
4849

49-
.. note::
50-
The M33 TrustZone divides the application core into secure (``nrf5340_dk_nrf5340_cpuapp``) and non-secure (``nrf5340_dk_nrf5340_cpuappns``) domains.
51-
However, all nRF5340 samples currently run in the secure domain, so you should not use the ``nrf5340_dk_nrf5340_cpuappns`` board.
50+
The user application can run in the secure or non-secure domain.
51+
Therefore, it can be built for two different board targets:
52+
53+
* ``nrf5340_dk_nrf5340_cpuapp`` for the secure domain,
54+
* ``nrf5340_dk_nrf5340_cpuappns`` for the non-secure domain.
55+
56+
When built for the ``nrf5340_dk_nrf5340_cpuappns`` board, the :ref:`nrf9160_ug_secure_partition_manager` is automatically included in the build.
5257

5358
Inter-core communication
5459
========================
@@ -74,6 +79,7 @@ Network samples
7479
===============
7580

7681
The |NCS| provides the following samples for the nRF53 network core:
82+
7783
* :ref:`zephyr:bluetooth-hci-rpmsg-sample` - a Zephyr sample that implements a Bluetooth Low Energy controller.
7884
This sample must be programmed to the network core to run standard Bluetooth Low Energy samples on nRF5340.
7985

@@ -118,36 +124,6 @@ Depending on the sample, you must program only the application core (for example
118124
Build and program both samples separately by following the instructions in :ref:`gs_programming_ses`.
119125
Make sure to use ``nrf5340_dk_nrf5340_cpunet`` as board name when building the network sample, and ``nrf5340_dk_nrf5340_cpuapp`` when building the application sample.
120126

121-
.. important::
122-
When programming the samples built with an older version of |SES|, you might get an error message stating that the target cannot be identified.
123-
In this case, you can either modify your |SES| installation and projects to add support for programming nRF5340, or program the generated HEX files from the command line instead.
124-
125-
See the following sections for more information.
126-
127-
128-
Adding support for programming nRF5340 in SES (versions earlier than v4.40a)
129-
============================================================================
130-
131-
The older versions of the Nordic Edition of |SES| (older than v4.40a) do not include SEGGER J-Link version v6.54c.
132-
However, this J-Link version is required to program nRF5340 devices.
133-
134-
To add support for programming nRF5340 in |SES|, complete the following steps:
135-
136-
1. Download and install the latest `J-Link Software and Documentation Pack`_ (v6.54c or later).
137-
#. Copy the :file:`JLink_x64.dll` file from the J-Link installation directory into the ``bin`` folder of your |SES| (Nordic Edition) folder, replacing the existing file.
138-
On Windows, this file is by default located in ``C:/Program Files (x86)/SEGGER/JLink/JLink_x64.dll``.
139-
Note that the file might be named differently for other operating systems.
140-
#. Restart |SES|.
141-
#. Open an |NCS| project with the full path to ``boards/arm/nrf5340_dk_nrf5340`` in the Zephyr repository as board directory and either ``nrf5340_dk_nrf5340_cpunet`` or ``nrf5340_dk_nrf5340_cpuapp`` as board name.
142-
#. Right-click on the project in the Project Explorer and select **Options**.
143-
#. Navigate to **Debug** > **Debugger**.
144-
#. Double-click the value for **Target Device** and select **nRF9160** from the list.
145-
nRF5340 is not included in the list yet, but selecting nRF9160 sets the required configuration.
146-
#. Double-click the value for **Target Device** again and enter **nRF5340** in the search field.
147-
Click **OK** to use this value.
148-
149-
You can now build and program the sample for nRF5340.
150-
151127

152128
Programming from the command line
153129
=================================

0 commit comments

Comments
 (0)