xbmgmt ユーティリティ - レガシ - 2021.1 Japanese

Vitis 統合ソフトウェア プラットフォームの資料: アプリケーション アクセラレーション開発 (UG1393)

Document ID
UG1393
Release Date
2022-03-29
Version
2021.1 Japanese
ヒント: ここでは、xbmgmt --legacy コマンドを呼び出してアクセスできる xbmgmt コマンドのレガシ バージョンについて説明します。

ザイリンクス® ボード管理 (xbmgmt) ユーティリティは、ザイリンクス ランタイム (XRT) インストール パッケージに含まれるスタンドアロンのコマンド ライン ツールです。xbmgmt コマンドは、Alveo データセンター アクセラレータ カードとエンベデッド ベースのプラットフォームの両方をサポートします。

アクセラレータ カードはユーザー機能と管理機能に分割されており、異なるカード アクセス レベルを提供します。ユーザー機能はユーザーがアプリケーションを読み込んで実行できるようにし、管理機能はシステム管理者がカードを管理できるようにします。xbutil ユーティリティは、ユーザー機能の操作に使用します。xbmgmt ユーティリティは、管理機能の操作に使用し、実行にはルート権限が必要です。機能アクセスを 2 つのユーティリティに分割しているのは、ツールの管理機能にセキュリティを提供するためです。

重要: xbmgmt ユーティリティは、ザイリンクスが提供するシェル/プラットフォームを含む Alveo カードでのみ使用可能です。XRT は、カスタム Vivado® デザインでは機能しません。

このユーティリティは、カードのインストールおよび管理に使用します。実行するには、sudo 権限が必要です。xbmgmt でサポートされるタスクには、カード ファームウェアのフラッシュ メモリへの書き込み、現在のデバイス コンフィギュレーションのスキャンなどがあります。

xbmgmt コマンド ラインの構文は次のとおりです。

xbmgmt <command> [options]

サポートされるサブコマンドは、次のとおりです。

config
デーモン/デバイス コンフィギュレーションを解析またはアップデートします。
flash
デバイスの SC ファームウェアまたはシェルをアップデートします。
help
サブコマンドのヘルプ メッセージを表示します。
partition
パーティションを表示してデバイスにダウンロードします。
--scan
検出されたすべての mgmt PCIe® 関数をリストします。
version
XRT ビルド バージョンを表示します。
ヒント: help コマンドを使用すると、使用可能な xbmgmt コマンドおよびオプションがリストされ、次を使用すると各コマンドのヘルプを表示できます。
xbmgmt help <command>
各サブコマンドの詳細は、次を使用します。
xbmgmt help <subcommand>

次のスクリプトを使用して xbmgmt コマンドを設定します。

  • csh シェル:
    $ source /opt/xilinx/xrt/setup.csh
  • bash シェル:
    $ source /opt/xilinx/xrt/setup.sh