murban1 / swupdate

Software Update for Embedded Systems

SWUpdate - Software Update for Embedded Systems

SWUpdate is a Linux Update agent with the goal to provide an efficient and safe way to update an embedded system. SWUpdate supports local and remote updates, multiple update strategies and it can be well integrated in the Yocto build system by adding the meta-swupdate layer.

Examples using this layer with evaluation boards (Beaglebone, RPI3) are provided in meta-swupdate-boards layer.

It supports the common media on embedded devices such as as NOR / NAND flashes, UBI volumes, SD / eMMC, and can be easy extended to introduce project specific update procedures.

Pre- and postinstall scripts are supported, and a LUA interpreter helps to customize the update process.

An update package is described by the sw-description file, using the libconfig syntax or JSON. It is even possible to use Lua with a custom syntax.

Here a short list of the main features:

• Install on embedded media (eMMC, SD, Raw NAND, NOR and SPI-NOR flashes)
• Allow delivery single image for multiple devices
• Multiple interfaces for getting software
  • local storage
  • integrated web server
  • integrated REST client connector to hawkBit
  • remote server download
• Software delivered as images, gzipped tarball, etc.
• Allow custom handlers for installing FPGA firmware, microcontroller firmware via custom protocols.
• Power-Off safe
• Hardware / Software compatibility.

This software is licensed under GPL Version 2.0+

Please check inside doc directory for documentation or the online documentation (generated from doc/) at: http://sbabic.github.io/swupdate

Submitting patches

Contributions are welcome ! You can submit your patches (or post questions regarding the project) to the swupdate Mailing List:

[email protected]

When creating patches, please use something like:

git format-patch -s <revision range>

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

Patches are tracked by patchwork (see http://jk.ozlabs.org/projects/patchwork/). You can see the status of your patches at http://patchwork.ozlabs.org/project/swupdate/list.