michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: mgmt: img_mgmt: Fix description of hash and sha

Browse source 
Fixes an issue with the documentation whereby the wrong hash/sha
sections were described, also adds a link to upstream MCUboot
documentation for further information.

Signed-off-by: Jamie McCrae <jamie.mccrae@nordicsemi.no>
This commit is contained in:
Jamie McCrae 2023-01-16 09:11:59 +00:00 • committed by Carles Cufí
commit 1d14e42e40
1 changed files with 18 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

27
doc/services/device_mgmt/smp_groups/smp_group_1.rst
View file

@ -151,12 +151,16 @@ where:
| "version" | string representing image version, as set with |
| | ``imgtool`` |
+-----------------------+---------------------------------------------------+
| "hash" | hash of an upload; this is used to identify |
| | an upload session, for example to allow mcumgr |
| | library to continue broken session. This must be |
| | a full sha256 of the whole image being uploaded, |
| | and is optionally used for image verification |
| "hash" | SHA256 hash of the image header and body. Note |
| | that this will not be the same as the SHA256 of |
| | the whole file, it is the field in the MCUboot |
| | TLV section that contains a hash of the data |
| | which is used for signature verification |
| | purposes. |
| | |
| | .. note:: |
| | See ``IMAGE_TLV_SHA256`` in the MCUboot image |
| | format documentation link below. |
+-----------------------+---------------------------------------------------+
| "bootable" | true if image has bootable flag set; |
| | this field does not have to be present if false |
@ -189,6 +193,9 @@ where:
For more information on how does image/slots function, please refer to
the MCUBoot documentation
https://www.mcuboot.com/documentation/design/#image-slots
For information on MCUboot image format, please reset to the MCUboot
documentation https://docs.mcuboot.com/design.html#image-format
Set state of image request
==========================
@ -280,10 +287,12 @@ where:
+-----------------------+---------------------------------------------------+
| "off" | offset of image chunk the request carries |
+-----------------------+---------------------------------------------------+
| "sha" | string identifying update session; it should only |
| | be present if "off" is zero; although name |
| | suggests it might be SHA, it can actually be any |
| | string |
| "sha" | SHA256 hash of an upload; this is used to |
| | identify an upload session, for example to allow |
| | MCUmgr to continue a broken session. This must be |
| | a full SHA256 of the whole image being uploaded, |
| | and is optionally used for image verification |
| | purposes. Should only be present if "off" is zero |
+-----------------------+---------------------------------------------------+
| "data" | optional image data |
+-----------------------+---------------------------------------------------+