Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page provides usage and release notes for the xlnx-config snap. The xlnx-config snap can be found in the Canonical Snap Store at https://snapcraft.io/xlnx-config.

Note

In Ubuntu 22.04, a xlnx-config has been updated with 22.04-specific changes. Therefore, it’s required to have two different versions of xlnx-config for use 20.04 and 22.04.

  • For 22.04, users should install the 2.x “track” from the snap store (use --channel=2.x)

  • For 20.04, users should install the 1.x track (--channel =1.x)

A key difference between the two versions is that the 2.x version does not include the xmutil or dfx-mgr utilities. These are provided as debian packages in 22.04.

This page will be updated soon to reflect these changes.

Table of Contents

Table of Contents
excludeTable of Contents

...

Code Block
sudo snap install xlnx-config --classic --channel=<1.x or 2.x

Supported Options

Option

Description

ZCU10x

KV260

sudo req’d

--version, -v

returns current version of xlnx-config

--query, -q

Checks for currently available HW configurations, by  searching for manifest files. The locations where it searches are:

  • Platform Snap: /snap/*/current/hwconfig/*/manifest.yaml

  • Manual Install

    • /usr/local/share/xlnx-config/*/hwconfig/*/manifest.yaml

    • /boot/firmware/xlnx-config/*/hwconfig/*/manifest.yaml

--activate, -a <config_name>

Activates a configuration by using its name or, directly, the path to the manifest. It checks the system compatibility by looking at the manifest and then applies the configuration (for instance, it builds and installs the boot and FPGA assets).

--deactivate, -d

Deactivates the currently active configuration, uninstalling its assets. After a reboot, the default boot assets for the board will be loaded.

--xmutil, -x <sub command>

This option specifies that the following arguments will be passed on to the xmutil sub-application.

Info

20.04/1.x track only

-s,--snap <snap install options>

Specify that that the platform name used with the --install argument is a snap

--i,--install <config name>

Copy a PAC configuration into the /lib/firmware/xilinx directory so it can be loaded with xmutil

--get-board, -b:

returns the system's board model (currently, one of zcu102, zcu104, zcu106, zcu111, kv260).

--force, -f

Use jointly with `-a` or `-d` to force activation/deactivation even if the configuration seems already correct.

--is-active, -c

<hwconfig_name_or_manifest>: Check whether a HW configuration (given by name or by manifest path) is currently active.

--update, -u

Update the assets directory to match /usr/lib/dpu.xclbin and deactivate any platform not matching
the current board. This is executed one time every boot as a one-shot daemon. See One-Shot Daemon for more details.

xlnx-config.sysinit

Sub-application that installs Xilinx-specific gstreamer and video packages

xmutil Sub-Commands

Info

20.04/1.x track only

xlnx-config provides a sub-set of the xmutil sub-commands. The following table lists those commands and their options. All xmutil sub-commands require sudo.

...