Generator of Update Packages (SWU) for SWUpdate OTA Agent
Project description
A host tool to generate SWU update package for SWUpdate.
SYNOPSIS
- usage: SWUGenerator [-h] [-K ENCRYPTION_KEY_FILE] [-k SIGN] -s SW_DESCRIPTION
[-a ARTIFACTORY] -o SWU_FILE [-c CONFIG] command
Generator SWU Packages for SWUpdate
- positional arguments:
command command to be executed, one of : create
- optional arguments:
- -h, --help
show this help message and exit
- -K ENCRYPTION_KEY_FILE, --encryption-key-file ENCRYPTION_KEY_FILE
AES Key to encrypt artifacts
- -n, --no-compress
Do not compress files
- -k SIGN, --sign SIGN
RSA key or certificate to sign the SWU
- -s SW_DESCRIPTION, --sw-description SW_DESCRIPTION
sw-description template
- -t, --encrypt-swdesc
Encrypt sw-description
- -a ARTIFACTORY, --artifactory ARTIFACTORY
list of directories where artifacts are searched
- -o SWU_FILE, --swu-file SWU_FILE
SWU output file
- -c CONFIG, --config CONFIG
configuration file
Description
swugenerator is a tool running on host to create and modify SWUpdate’s Update files (SWU). SWU file contains a meta description of the release (sw-description), and swugenerator adds components to a template passed from command line. This tool requires openssl to run and to sign the SWU. It is goal of the tool to fill the gap with Yocto/OE, where SWU generation is done by classes in the meta-swupdate layer, but other buildsystems like Debian or Buildroot have no tools to create a SWU.
The tool signs the SWU and can encrypt the artifacts. The tool parses the libconf based sw-description (tool does not work for JSON based sw-description) and provides the following features:
replace occurrencies of variables found in the CONFIG file
add sha256 to each artifact
check if an artifact should be encrypted and encrypts it
sign sw-description with one of the methods accepted by SWUpdate
pack all artifacts into a SWU file
Installation
To install swugenerator clone the repository, and from the main project folder run pip (pip3 required):
pip install .
To uninstall:
pip uninstall swugenerator
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for swugenerator-0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 166f73b772b5a56391f94ba5b63254808d40cea11f1b92b3dc0673f7744ed688 |
|
MD5 | a7d74859da07c47269b392221f8c76e3 |
|
BLAKE2b-256 | a75bb1cb588a6055579424f7a41a04c672e872e3a44f9a15096a45619b565405 |