What is the purpose of the "version" tag in the top level software entity?

Skip to first unread message


Aug 4, 2016, 5:26:36 AM8/4/16
to swupdate
Hello all,

Looking at some of the sample sw-description files in the documentation, there is always a version tag in the main top level software entity:

software =
version = "0.1.0";

target-1 = {
images: (

What is the purpose of this tag? Does swupdate read it at all? Looking through the documentation, the only reference to *software* versions is where you can specify version numbers for specific images and ask swupdate to only update them if their version number is different than that found in /etc/sw-versions. But that doesn't seem to apply to this top level version tag.

Stefano Babic

Aug 4, 2016, 5:54:00 AM8/4/16
to amrb...@gmail.com, swupdate
Hi Amrbekhit,
The idea of the tag is to add a reference to a possible changes in
future schemas. This could be necessary if, for example, a future
SWUpdate will become incompatible with previous versions, and it is
required to identify the schema. All things that I would prefer to
avoid, frankly.

The tag is not currently used.

Best regards,
Stefano Babic

DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sba...@denx.de

Jörg Krause

Aug 5, 2016, 8:47:54 AM8/5/16
to swupdate, amrb...@gmail.com, sba...@denx.de
Hi Stefano,

so the tag is related to the SWUpdate version. I have mistaken it for the firmware version to update to...

Stefano Babic

Aug 5, 2016, 9:23:03 AM8/5/16
to Jörg Krause, swupdate, amrb...@gmail.com, sba...@denx.de
Hi Jörg,

On 05/08/2016 14:47, Jörg Krause wrote:
> Hi Stefano,
> so the tag is related to the SWUpdate version.

Yes, I have thought originally to introduce a mechanism to distinguish
between different schema.

> I have mistaken it for
> the firmware version to update to...

You have not mistaken because the tag is still unused :-)

Its meaning is becoming "reserved"...

I do not know if my original thoughts are still valid. In the
development, I have introduced more as one parser (at the beginning,
only libconfig was available), and having a versioning-schema makes less
sense. SWUpdate does not use this tag at all, we can still decide if we
have a use case for it (for example, as firmware version as you
thought), but we have at least to document it.

Best regards,
Stefano Babic

> On Thursday, August 4, 2016 at 11:54:00 AM UTC+2, Stefano Babic wrote:
> Hi Amrbekhit,
> sba...@denx.de <javascript:>
> =====================================================================
Reply all
Reply to author
0 new messages