diff mbox series

doc: describe usage of swupdate-image class in OE

Message ID 20210826113705.328392-1-sbabic@denx.de
State Accepted
Headers show
Series doc: describe usage of swupdate-image class in OE | expand

Commit Message

Stefano Babic Aug. 26, 2021, 11:37 a.m. UTC
Signed-off-by: Stefano Babic <sbabic@denx.de>
---
 doc/source/building-with-yocto.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

Comments

Storm, Christian Aug. 26, 2021, 1:07 p.m. UTC | #1
Hi Stefano,

> +Simplified version for just image
> +---------------------------------
> +
> +In many cases there is a single image in the SWU. This is for example when
> +just rootfs is updated. The generic case described above required an additional
> +recipe that must be written and maintained. For this reason, a simplified version
> +of the class is introduced that allowed to build the SWU from the image recipe.
> +
> +Users just need to import the `swupdate-image` class. This already sets some variables.
> +A sw-description must still be added into a `files` directory, that is automatically searched by the class.
> +User still needs to set SWUPDATE_IMAGE_FSTYPES[`your image`] to the fstype that should be packed
> +into the SWU - an error is raised if the flasg 

just a minor typo: s/flasg/flag/

> is not set.
> +
> +In the simple way, your recipe looks like
> +
> +::
> +        <your original recipe code>
> +
> +        SWUPDATE_IMAGES_FSTYPES[<name of your image>] = <fstype to be put into SWU>
> +        inherit swupdate-image


Kind regards,
   Christian
Stefano Babic Aug. 26, 2021, 7:21 p.m. UTC | #2
Hi Christian,

On 26.08.21 15:07, Christian Storm wrote:
> Hi Stefano,
> 
>> +Simplified version for just image
>> +---------------------------------
>> +
>> +In many cases there is a single image in the SWU. This is for example when
>> +just rootfs is updated. The generic case described above required an additional
>> +recipe that must be written and maintained. For this reason, a simplified version
>> +of the class is introduced that allowed to build the SWU from the image recipe.
>> +
>> +Users just need to import the `swupdate-image` class. This already sets some variables.
>> +A sw-description must still be added into a `files` directory, that is automatically searched by the class.
>> +User still needs to set SWUPDATE_IMAGE_FSTYPES[`your image`] to the fstype that should be packed
>> +into the SWU - an error is raised if the flasg
> 
> just a minor typo: s/flasg/flag/

Thanks, fixed ony my branch.

Stefano

> 
>> is not set.
>> +
>> +In the simple way, your recipe looks like
>> +
>> +::
>> +        <your original recipe code>
>> +
>> +        SWUPDATE_IMAGES_FSTYPES[<name of your image>] = <fstype to be put into SWU>
>> +        inherit swupdate-image
> 
> 
> Kind regards,
>     Christian
>
diff mbox series

Patch

diff --git a/doc/source/building-with-yocto.rst b/doc/source/building-with-yocto.rst
index bc7d90c..b410dc0 100644
--- a/doc/source/building-with-yocto.rst
+++ b/doc/source/building-with-yocto.rst
@@ -246,3 +246,24 @@  Template for recipe using the class
         SWUPDATE_IMAGES_FSTYPES[uImage] = ".bin"
 
         inherit swupdate
+
+Simplified version for just image
+---------------------------------
+
+In many cases there is a single image in the SWU. This is for example when
+just rootfs is updated. The generic case described above required an additional
+recipe that must be written and maintained. For this reason, a simplified version
+of the class is introduced that allowed to build the SWU from the image recipe.
+
+Users just need to import the `swupdate-image` class. This already sets some variables.
+A sw-description must still be added into a `files` directory, that is automatically searched by the class.
+User still needs to set SWUPDATE_IMAGE_FSTYPES[`your image`] to the fstype that should be packed
+into the SWU - an error is raised if the flasg is not set.
+
+In the simple way, your recipe looks like
+
+::
+        <your original recipe code>
+
+        SWUPDATE_IMAGES_FSTYPES[<name of your image>] = <fstype to be put into SWU>
+        inherit swupdate-image