Package Naming Convention

Alveo Data Center Accelerator Card Platforms User Guide (UG1120)

Document ID
UG1120
Release Date
2023-10-11
Revision
2.0.1 English

Currently, AMD Alveo™ Data Center accelerator card platforms are delivered through three types of Linux installation packages outlined in the following table.

Table 1. Platform Installation Package Types
Package Description
Partition Contains a device bitstream that implements part of the deployment platform in the Alveo Data Center accelerator card.
Validate Contains code to validate a platform installation and Alveo Data Center accelerator card setup.
Firmware Contains compiled SC and CMC firmware binary files.

The following section describes the package naming convention for partition and validate types. They differ slightly from firmware.

Partition and Validate Package Naming

The partition and validate installation package names are formed by concatenating the following elements:

<name>_<version>-<release>-<architecture>[-<OS version>].<extension>

Each element consists of one or more sub-elements described in the following table.

Table 2. Partition and Validate Package Element Fields
Element Sub-element Description Examples
Name Company Vendor name Xilinx
Card Card name u50

u250

Chassis Connectivity to the server gen3x16-xdma

gen3x4-xdma

Partition Partition name distinguishes the partition type and can be one of base, shell or validate. base

shell

validate

Version Iteration(s) Version of chassis.

Dot separated list of one or more integers. Increments when the corresponding chassis interface changes.

2

1.1

Release Release Integer release number. 2200000
Architecture Architecture

Indicates the architecture the package is built for.

noarch – No Architecture

all

noarch

all

OS Version OS Version

Only present for Ubuntu packages (as the opener to this block).

Indicates supported Ubuntu version for some packages.

New packages will support all Ubuntu releases and are denoted as all.

18.04

all

Extension Extension Package file extension RPM

DEB

The following is an example of a deployment installation package file name.

xilinx-u50-gen3x4-xdma-base_2-2902115_all.deb

Once a deployment partition package is installed, you can use XRT commands xbmgmt and xbutil to display the partition installed on the card.

The following is the partition name displayed for the above deployment partition package. Because the version number indicates compatibility with other partitions, the release number is not displayed.

xilinx_u50_gen3x4_xdma_base_2

Firmware Package Naming

Firmware (SC and CMC) installation package names are generated by concatenating the following elements:

<name>-<version>-<release>-<architecture>[-<OS version>].<extension>

Each element consists of one or more sub-elements described in the following table.

Table 3. Firmware Package Element Fields
Element Sub-element Description Examples
Name Company Vendor name Xilinx
Product Firmware product name cmc

sc-fw

Card Card name u250

u50

Version Version Firmware version number. Three integers joined by dots. 1.0.13

4.3.9

Release Release CMC firmware uses an integer. SC firmware uses an alpha-numeric number separated with a dot. 2500000

1.a9fc625

Architecture Architecture Indicates the architecture the package is built for.

noarch – No Architecture

all

noarch

all

OS Version OS Version Only present for Ubuntu packages.

Indicates the supported Ubuntu version for some packages.

New packages will support all Ubuntu releases and are denoted as all.

18.04

all

Extension Extension Package file extension RPM

DEB

The following are examples of cmc and sc-fw installation package names:

xilinx-cmc-u50_1.0.40-3398385_all.deb
xilinx-sc-fw-u50_5.2.18-1.bf9ba46_all.deb