SWUpdate - Software Update for Embedded Linux Devices

SWUpdate is a Linux Update agent with the goal toprovide an efficient and safe way to updatean embedded Linux system in field. SWUpdate supports local and OTAupdates, multiple update strategies and it is designed with securityin mind.

Getting started

To start with SWUpdate, it is suggested you look at the documentationand build for one evaluation board (or you run SWUpdate on your hostfor a first overview).

Features

SWUpdate is a framework with a lot of configurable options:

• Update of all components of device (rootfs, kernel, bootloader, microcontroller FW)
• Install on embedded media (eMMC, SD, Raw NAND, UBIFS, NOR and SPI-NOR flashes)
• Partitioner for GPT and MBR partition table
• Allow single image delivery on multiple devices
• Streaming mode without temporary copies of artifacts
• Multiple interfaces (local and OTA) for getting software
  • local storage (USB, etc.)
  • integrated web server
  • integrated REST client connector to hawkBit for fleet updates.
  • remote server download
• Software delivered as images, gzipped tarball, etc.
• Allow custom handlers for installing FPGA firmware, microcontroller firmware via custom protocols.
• Delta updates based on librsync.
• Fail safe and atomic update
• Lua interpreter to extend the update rules on your needs
• Hardware / Software compatibility.
• Small footprint to generate a rescue system to restore the device.
• Cryptographic sign and verification of updates
  • support for OpenSSL
  • support for mbedTLS
  • support for WolfSSL
• Encryption of artifacts via symmetric AES key.
• pre and post update scripts
• small resources required.
• controllable via library
• progress interface to report update status to an application / HMI.
• ...and many others.

Take a look at features.

Technical documentation

Documentation is part of the project and can be generated, or you accessto the Online Documentation.

Building

SWUpdate is well integrated in the Yocto build system by addingthe meta-swupdate layer.It is also integrated in Buildroot.Debian (and Debian-like distributions) has merged a package.

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

License

SWUpdate is released under GPLv2. A library to control SWUpdate is part of theproject and it is released under LGPLv2.1.License information for any file is either explicitly statedor defaults to GPL version 2.0. Extension written in Lua are subjected toLua license (MIT).

Community support

A community support takes place on the SWUpdate's Mailing List:

swupdate@googlegroups.com

The Mailing List is open without need to be registered.

Contributing to the project

Contributions are welcome ! You can submit your patches (or post questionsregarding the project) to the Mailing List.

Please read the contributingchapter in the documentation how to contribute to the project.

Patches are collected by Patchwork