Nav apraksta

Reto Schneider 9cc6781093 Allow expansion of BitBake variables in sw-description files 7 gadi atpakaļ
classes 9cc6781093 Allow expansion of BitBake variables in sw-description files 7 gadi atpakaļ
conf 6b311da25c layer.conf: add LAYERSERIES_COMPAT 7 gadi atpakaļ
recipes-bsp 36075a1136 u-boot-fw-utils: fix build with 2017.05 8 gadi atpakaļ
recipes-core e67f35c949 Fix for Yocto deprecation issue on MIT license file. 7 gadi atpakaļ
recipes-devtools e4b0fb27e4 Updated to mtd-utils 2.x 8 gadi atpakaļ
recipes-extended b718d446f0 rescuegui: adjust to sync with SWUpdate 7 gadi atpakaļ
recipes-lua b718d446f0 rescuegui: adjust to sync with SWUpdate 7 gadi atpakaļ
recipes-support 51af7972c0 Allow .bbappend files to overwrite SRCREV 7 gadi atpakaļ
COPYING.MIT 020c327419 Receipes to generate a swupdate image 12 gadi atpakaļ
README 9cc6781093 Allow expansion of BitBake variables in sw-description files 7 gadi atpakaļ

README

meta-swupdate, Yocto layer for deploy tool
==========================================

This layer's purpose is to add support for a deployment
mechanism of Yocto's images based on swupdate project.

Layer dependencies
------------------

This layer depends on:

URI: git://github.com/openembedded/meta-openembedded.git
subdirectory: meta-oe

BitBake variable expansion
--------------------------

To insert the values of BitBake variables into the update file, pre- and postfix
the names with "@@". For example, to automatically set the version tag, use the
line `version = "@@DISTRO_VERSION@@";` in your sw-description file.

Image hashing
-------------

During creation of the update file, occurrences of @IMAGE (where IMAGE is an
image filename) are replaced with the sha256 hash of the image.

SWU image signing
------------

There are 3 signing mechanisms supported by meta-swupdate at the moment:

1. RSA signing:

* Set variable: `SWUPDATE_SIGNING = "RSA"`

* Set `SWUPDATE_PRIVATE_KEY` to the full path of private key file

2. CMS signing:

* Set variable: `SWUPDATE_SIGNING = "CMS"`

* Set `SWUPDATE_CMS_CERT` to the full path of certificate file

* Set `SWUPDATE_CMS_KEY ` to the full path of private key file

3. Custom signing tool:

* Set variable: `SWUPDATE_SIGNING = "CUSTOM"`

* Set variable `SWUPDATE_SIGN_TOOL' to custom string that needs to be
executed in order to perform the signing

sw-description is signed and the signature is written to sw-description.sig
which is included in the SWU file.

Encrypted private keys are not currently supported since a secure
mechanism must exist to provide the passphrase.

Maintainer
----------

Stefano Babic

Submitting patches
------------------

You can submit your patches (or post questions reagarding
this layer to the swupdate Mailing List:

swupdate@googlegroups.com

When creating patches, please use something like:

git format-patch -s --subject-prefix='meta-swupdate][PATCH'

Please use 'git send-email' to send the generated patches to the ML
to bypass changes from your mailer.