Skip to content

Commit ac2764c

Browse files
ahasztagrlubos
authored andcommitted
doc: SUIT How to fetch payloads guide fixes for 2.8.0
This commit updates this part of the documentation taking into account changes for 2.8.0 release Signed-off-by: Artur Hadasz <[email protected]>
1 parent b55423f commit ac2764c

File tree

1 file changed

+8
-10
lines changed

1 file changed

+8
-10
lines changed

doc/nrf/app_dev/device_guides/working_with_nrf/nrf54h/ug_nrf54h20_suit_fetch.rst

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,11 @@ How to fetch payloads
77
:local:
88
:depth: 2
99

10-
In the Software Updates for Internet of Things (SUIT), it is possible for a device to obtain a new firmware in two ways:
10+
In the Software Updates for Internet of Things (SUIT), a device can obtain new firmware in two ways:
1111

12-
1. The push model - where all necessary candidate images are integrated into the SUIT envelope, and uploaded to a device as a single unit.
12+
1. Using the push model - where all necessary candidate images are uploaded to the device along with the envelope before triggering the envelope processing.
1313

14-
#. The fetch model - where the envelope contains 0 or not all necessary candidate images.
14+
#. Using the fetch model - where not all the required payloads are uploaded to the device before triggering the envelope processing.
1515
The manifest contains logic that instructs the device to fetch other required candidate images through a user-defined mechanism during the envelope processing.
1616

1717
This guide explains how to reconfigure an application that uses the push model to a fetch model-based upgrade.
@@ -25,9 +25,11 @@ The push model does not require the SUIT processor to be built into the applicat
2525
The fetch model, on the other hand, requires the SUIT processor to be built into the application firmware in order to execute the ``suit-payload-fetch`` sequence.
2626
You can enable this by using the :kconfig:option:`CONFIG_SUIT_DFU_CANDIDATE_PROCESSING_FULL` Kconfig option.
2727

28-
In the push model, the envelope along with all necessary candidate images must be stored in a continuous memory region in the MCU's non-volatile storage.
29-
In the fetch model, the envelope must still be stored in a continuous memory region in the MCU, but it does not occupy as much space because not all candidate images are integrated into it.
30-
Some or all candidate images can be stored in separate memory regions from the envelope, or on a completely different storage device altogether.
28+
In both models, the SUIT envelope must be stored in a continuous memory region in the MCU's non-volatile storage.
29+
Some or all candidate images can be stored either in separate memory regions from the envelope or on a completely different storage device.
30+
31+
In the push model, all candidate images must be uploaded to the device before the envelope processing starts.
32+
In the fetch model, the device can fetch the candidate images after the envelope processing has started.
3133

3234
Reasons to use the fetch model
3335
******************************
@@ -41,10 +43,6 @@ The fetch model has greater flexibility compared to the push model in the follow
4143
Nordic Semiconductor provides a reference fetch source implementation which uses the SMP protocol over serial or Bluetooth® LE.
4244
You have the option to implement any fetching mechanism needed for the application, such as fetching from an HTTP resource.
4345

44-
* Candidate images can be stored in a different memory partition than the envelope itself.
45-
The SUIT envelope itself must always be stored in non-volatile storage that is integrated into the MCU.
46-
The fetched candidate images do not have restrictions on where they are placed and can be stored on an external memory chip.
47-
4846
Migrating from push-based to fetch-based firmware upgrade
4947
*********************************************************
5048

0 commit comments

Comments
 (0)