/system76-firmware

System76 Firmware Tool and Daemon

Primary LanguageRustGNU General Public License v3.0GPL-3.0

system76-firmware

The system76-firmware package has a CLI tool for installing firmware updates. Also included is the system76-firmware-daemon package, which has a systemd service that exposes a DBUS API for handling firmware updates.

Dependencies

  • cargo
  • dbus
  • rustc
  • systemd

Make Targets

The following make targets are supported:

  • make all - compile all binaries
  • make clean - remove compiled binaries
  • make install - install binaries and configuration files
  • make uninstall - uninstall binaries and configuration file
  • make vendor - prepare source for offline compilation
  • make distclean - remove prepared source and compiled binaries

Installation

make
sudo make install

Packaging

In order to package this, you need cargo-vendor:

cargo install cargo-vendor

You can then run the following to create an offline-capable package:

make vendor

Now you can compile and install the package.

To clean out the vendor source, you can run this command:

make distclean

API

The system76-firmware-daemon will download the latest firmware package, if it has changed, and will provide a DBUS interface for a user to query the current firmware status, query the update information, and schedule an update.

The DBUS API is as follows:

  • Bios() -> (String model, String version) Query the BIOS model and version.
  • EmbeddedController(Boolean primary) -> (String project, String version) Query the embedded controller for project and version. Optionally, a second embedded controller can be queried.
  • ManagementEngine() -> (Boolean enabled, String version) Query the ME status and version.
  • Download() -> (String digest, String changelog) Download the latest changelog information
  • Schedule(String digest) -> () Prepare the latest firmware update for installation
  • Unschedule() -> () Cancel installation of the latest firmware update