Skip to main content

Core Module Update Interface

Project description

Device Updater Plugin

Exposes a messagebus API to check for and initiate OS-level updates. This plugin expects an update-initramfs system service to be installed to apply InitramFS updates and for the SquashFS update path to be applied upon restarting.

Configuration

The remote URLs and local paths for InitramFS and SquashFS files used by this plugin may be set in configuration. The messagebus API supports branch in data which is used to fill string templates in configured URLs; this is generally used to select a git branch.

PHAL:
  admin:
    neon-phal-plugin-device-updater:
      enabled: True
      initramfs_url: "https://github.com/NeonGeckoCom/neon_debos/raw/{}/overlays/02-rpi4/boot/firmware/initramfs"
      initramfs_path: /opt/neon/firmware/initramfs
      initramfs_update_path: /opt/neon/initramfs
      squashfs_path: /opt/neon/update.squashfs
      default_track: dev

Messagebus API

The following Messagebus listeners are exposed by this plugin. The track data parameter is optional and will default to the configured default_track if not specified.

Check for InitramFS Updates

Check for an available InitramFS update and emit a response with data: update_available and track.

Message("neon.check_update_initramfs", {'track': 'dev'})

Update InitramFS

Install an available InitramFS update and emit a response with data: updated and optionally error.

Message("neon.update_initramfs", {'track': 'dev'})

Check for SquashFS Updates

Check for an available SquashFS update and emit a response with data: update_available and track.

Message("neon.check_update_squashfs", {'track': 'dev'})

Update SquashFS

Check for an available InitramFS update and emit a response with data: new_version or error.

Message("neon.update_squashfs", {'track': 'dev'})

Get Build Info

Get metadata for currently installed build:

Message("neon.device_updater.get_build_info")

Get Download Status

Query the plugin if an update is currently downloading:

Message("neon.device_updater.get_download_status")

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neon-phal-plugin-device-updater-0.3.0.tar.gz (10.1 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file neon-phal-plugin-device-updater-0.3.0.tar.gz.

File metadata

File hashes

Hashes for neon-phal-plugin-device-updater-0.3.0.tar.gz
Algorithm Hash digest
SHA256 7468fe62cb743b3bef6dba166b8b03efe7a5d541f175c259a560ccdb540ab044
MD5 7e314a73120707503646021aa5f65b10
BLAKE2b-256 cb891353e7f61bde09043aca9cf8ba1d7584dc2d31ca225461d01321b5abdba8

See more details on using hashes here.

File details

Details for the file neon_phal_plugin_device_updater-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for neon_phal_plugin_device_updater-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3225376e39f6fbd4e1f0d08c56633fcdd9d5d076dfa450b7b770e6e9252f56c2
MD5 558fb954cf3bd7e08411f2142a0e3276
BLAKE2b-256 d6901c59ed902de5ab73c11612fce704248f9eb8be1492dc7e3c7e54bae7e77e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page