Skip to content

Commit d8dfa34

Browse files
annwojrlubos
authored andcommitted
doc: update the v3.0 migration guide
Adds CRACEN initialization info Signed-off-by: Anna Wojdylo <[email protected]>
1 parent f8b3209 commit d8dfa34

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

doc/nrf/releases_and_maturity/migration/migration_guide_3.0.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,24 @@ Bluetooth® LE legacy pairing
118118
Using Bluetooth LE legacy pairing introduces, among others, a risk of passive eavesdropping.
119119
Supporting Bluetooth LE legacy pairing makes devices vulnerable to downgrade attacks.
120120

121+
CRACEN initialization
122+
---------------------
123+
124+
.. toggle::
125+
126+
In the |NCS| versions 2.8.0 and 2.9.0, you must explicitly configure the CRACEN initialization.
127+
It is done by adding the :kconfig:option:`CONFIG_CRACEN_LOAD_MICROCODE` Kconfig option to the image configuration.
128+
This option allows to select the given image to initialize CRACEN.
129+
130+
However, from |NCS| 3.0.0, CRACEN is automatically initialized.
131+
The new build configuration option (:kconfig:option:`SB_CONFIG_CRACEN_MICROCODE_LOAD_ONCE`) now controls this process at the sysbuild level.
132+
When enabled, the build system automatically determines which image must handle the initialization of CRACEN.
133+
134+
Unlike in the |NCS| versions 2.8.0 and 2.9.0, where CRACEN initialization is disabled by default in the MCUboot configuration, CRACEN is initialized by the earliest bootloader by default in the |NCS| 3.0.0.
135+
This change can lead to scenarios where CRACEN might be initialized twice or not initialized at all.
136+
When migrating from the |NCS| v2.9.0 to v3.0.0, you must analyze which image is responsible for initializing CRACEN before and after the firmware update to ensure correct operation.
137+
Make sure to adjust your bootloader or application upgrade path accordingly to avoid any issues related to CRACEN initialization.
138+
121139
nRF54H20
122140
========
123141

0 commit comments

Comments
 (0)