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")

Release files for neon-phal-plugin-device-updater 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for neon-phal-plugin-device-updater 0.3.1
File	Size	Uploaded
neon-phal-plugin-device-updater-0.3.1.tar.gz	10.1 kB	Mar 14, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for neon-phal-plugin-device-updater 0.3.1
File	Interpreter	ABI	Platform	Reset
neon_phal_plugin_device_updater-0.3.1-py3-none-any.whl 9.9 kB Mar 14, 2025	Python 3	none	any	Details

Total release size: 20.0 kB

Release files / neon-phal-plugin-device-updater-0.3.1.tar.gz

Download URL	neon-phal-plugin-device-updater-0.3.1.tar.gz
Size	10.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`fc6b6a20996a314f4dde8ab472a3f91897cfc8e986bd4e0d59c3abbc0b6d0b5d`
BLAKE2b-256 checksum How to use checksums	`0e2bc4f0f7a4f10173ec63a44a618d65f389ea1b131661e91dcadcd9b5ee64e2`
Upload date	Mar 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Release files / neon_phal_plugin_device_updater-0.3.1-py3-none-any.whl

Download URL	neon_phal_plugin_device_updater-0.3.1-py3-none-any.whl
Size	9.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cd200b941ea104a471868019026590f539ff853ed98896fd423b3c6aaa8195c8`
BLAKE2b-256 checksum How to use checksums	`5feb4c5fb332cc014c3b3d81b19e897c0aa940065549819d2907358c5cc8315f`
Upload date	Mar 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.9`