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
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]>
Copy file name to clipboardExpand all lines: doc/nrf/ug_nrf5340.rst
+12-36Lines changed: 12 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,9 +22,10 @@ The network core is an Arm Cortex-M33 processor with a reduced feature set, desi
22
22
This core is used for radio communication.
23
23
With regards to the nRF5340 samples, this means that the network core runs the radio stack and real-time procedures.
24
24
Currently, the following solutions are available for the network core:
25
+
25
26
* Bluetooth Low Energy Controller - compatible with several BLE samples.
26
27
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.
28
29
To start the network core, this sample requires any sample programmed on the application core.
29
30
For example, you can use :ref:`zephyr:hello_world` for this purpose.
30
31
@@ -38,17 +39,21 @@ Application core
38
39
The application core is a full-featured Arm Cortex-M33 processor including DSP instructions and FPU.
39
40
40
41
Currently, the |NCS| provides the following solutions for the application core:
42
+
41
43
* 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).
44
45
45
46
In general, this core should be used for tasks that require high performance and application-level logic.
46
47
47
48
The board name for the application core in Zephyr is ``nrf5340_dk_nrf5340_cpuapp``.
48
49
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.
52
57
53
58
Inter-core communication
54
59
========================
@@ -74,6 +79,7 @@ Network samples
74
79
===============
75
80
76
81
The |NCS| provides the following samples for the nRF53 network core:
82
+
77
83
* :ref:`zephyr:bluetooth-hci-rpmsg-sample` - a Zephyr sample that implements a Bluetooth Low Energy controller.
78
84
This sample must be programmed to the network core to run standard Bluetooth Low Energy samples on nRF5340.
79
85
@@ -118,36 +124,6 @@ Depending on the sample, you must program only the application core (for example
118
124
Build and program both samples separately by following the instructions in :ref:`gs_programming_ses`.
119
125
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.
120
126
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)
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.
0 commit comments