Vitis Functional Simulation (VFS) ユーザーガイド (UG1864) - 2026.1 日本語 - UG1864

Document_ID: UG1864
Release_Date: 2026-06-23
Version: 2026.1 日本語

概要
このユーザーガイドについて
第 1 章: VFS の概要
VFS とは
VFS を使用する理由
アーキテクチャの概要
次の手順
第 2 章: インストールと環境セットアップ
VFS のエディターオートコンプリートおよび Docstring の有効化
問題
前提条件
ソリューション
手順 1: Vitis 環境の読み込み (source)
手順 2: vfs.pth ファイルの作成
手順 3: エディターの再起動
削除
トラブルシューティング
VFS スタンドアロンインストール
概要
利点
前提条件
スタンドアロンインストールの作成
手順 1: 環境のセットアップ
手順 2: スクリプトの実行
スクリプトの動作
スタンドアロンインストールの使用
出力コンテンツ
移植性
トラブルシューティング
XILINX_VITIS が設定されていない
コンポーネント不足の警告
サポートされる Python および MATLAB バージョン
関連情報
第 3 章: クイックスタート/Hello VFS
前提条件
Hello HLS Kernel
Python
MATLAB
3.2 Hello AIE Graph
Python
MATLAB
次の手順
第 4 章: varray データモデル
サポートされるデータ型の概要
varray AXI4-Stream Axis ユーザーガイド
はじめに
主な機能
varray.axis 設定クラス
コンストラクターパラメーター
条件付きで存在するフィールド
オプションのフィールド
Axis を使用した配列の作成
基本的な Axis 設定
オプションフィールドを持つ Axis
サイドバンドフィールドリファレンス
tlast
tkeep
tstrb
tuser
tid
tdest
サイドバンドフィールドの読み書き
フィールドへのアクセス (Python)
フィールドへのアクセス (MATLAB)
インデックスとスライス
set_axis() を使用した Axis 設定の変更
プレーンな配列への Axis の追加
配列からの Axis の削除
Axis を別の設定に置き換え
表示と表記
デフォルト Axis (すべてのサイドバンドが有効)
TLAST のみの Axis (tkeep と tstrb が無効)
オプションフィールドを持つ Axis
バイト単位のパッキング
HLS インターフェイスとの関係
ap_axis
hls::axis
サポートされる設定
入力 Axis の検証
検証がチェックする内容
Error: port expects axis but varray has none
Error: port has no axis but varray has one
Error: axis field mismatch
AIE グラフ
MATLAB のエラー ID
Python エラー型
例
tlast を使用したパケット境界のマーキング
Axis を使用した固定小数点型および複素数型
エンドツーエンドの HLS カーネル例
TUSER のみのストリーム (TDATA なし)
ベストプラクティス
8.enable_tkeep、enable_tstrb、および strict をカーネルに一致させる
トラブルシューティング
Python: "The 'axis' parameter must be an instance of varray.axis"
Python: tuser、tid、または tdest に対する AttributeError
MATLAB: tuser、tid、または tdest へのアクセスエラー
予期しない tkeep/tstrb のデフォルト値
MATLAB: 幅の広いサイドバンド値が警告なしで切り捨てられる
TypeError: "Input port N expects AXI-Stream axis sidebands"
TypeError: "Input port N does not expect axis sidebands"
TypeError: "Input port N axis config mismatch"
TypeError: "Input port N axis config mismatch" for enable_tdata
Axis 付き varray を AIE グラフに渡すときのエラー
API リファレンス
varray.axis クラス
コンストラクター
メソッドとプロパティ
varray.array メソッド
Axis を使用した配列の構築
サイドバンド属性
関連情報
MATLAB varray
セットアップとバージョン確認
サポートされるデータ型
整数
浮動小数点
複素数
固定小数点 (fi、cfi)
バイト幅の計算
マイクロスケーリング (mx4、mx6、mx9)
配列の作成
配列プロパティ
型固有のプロパティ
配列操作
インデックス、代入、およびスライス
再形成、連結、転置
算術演算および数学演算 (サポートなし)
比較
MATLAB 相互運用性
ネイティブ MATLAB 型へのキャスト
varray 型間のキャスト
varray で直接動作する MATLAB 関数
固定小数点、マイクロスケーリング、および半精度型
固定小数点量子化
マイクロスケーリングブロック
HLS half と float16 の比較
トラブルシューティング
API リファレンス
コンストラクター
すべての型に共通のプロパティ
すべての型に共通のメソッド
AXI4-Stream サイドバンドヘルパー
型固有のプロパティとメソッド
ヘルパー
バージョン
関連情報
Python varray
セットアップとインポート
サポートされるデータ型
整数
浮動小数点
複素数
固定小数点 (fi、cfi)
バイト幅の計算
マイクロスケーリング (mx4、mx6、mx9)
配列の作成
リストまたはタプルから: dtype は必須
NumPy 配列から: dtype はオプション
スカラーから
配列プロパティ
配列操作
インデックスとスライス
再形成 (reshape)
算術演算および数学演算 (サポートなし)
astype(): 型間の変換
view(): バイトの再解釈
NumPy との相互運用性
NumPy への変換
サポートされる NumPy 関数
比較演算
複素数配列
固定小数点、マイクロスケーリング、および半精度型
固定小数点量子化
マイクロスケーリングブロック
HLS half と float16 の比較
トラブルシューティング
API リファレンス
varray.array
型ファクトリ
ヘルパー
関連情報
第 5 章: VFS API
どの言語を選択すべきか
MATLAB API
セットアップ
実行モード: release と debug
コンポーネントのライフサイクル
vfs.hlsKernel
コンストラクター
vfs_build_dir に含める必要があるもの
例
実行
出力シェイプ
ポートの検査
ゼロ入力カーネル (setNumKernelRuns)
vfs.aieGraph
コンストラクター
vfs_build_dir に含める必要があるもの
例
実行
ポートダンプ
AIE と HLS を組み合わせたワークフロー
ユーティリティの機能
API リファレンス
vfs.hlsKernel
vfs.aieGraph
トラブルシューティング
関連情報
Python API
セットアップ
コンポーネントのライフサイクル
vfs.hlsKernel
コンストラクター
vfs_build_dir に含める必要があるもの
例
実行
出力シェイプ
ポートの検査
ゼロ入力カーネル (setNumKernelRuns)
vfs.aieGraph
コンストラクター
vfs_build_dir に含める必要があるもの
例
実行
ポートダンプ
AIE と HLS を組み合わせたワークフロー
API リファレンス
vfs.hlsKernel
vfs.aieGraph
vfs.readDumpFile.read_dump_file(path)
shape= 値
トラブルシューティング
関連情報
第 6 章 — コンポーネントインターフェイスと動作
AIE ストリームおよびバッファーインターフェイス
インターフェイスの種類
ストリームインターフェイス
バッファー/ウィンドウインターフェイス
データ処理の動作
ストリームベースカーネル
バッファー/ウィンドウベースカーネル
各インターフェイスの使用場面
混在入力: 同期パラメーターと非同期パラメーター
ケース 1: 同期パラメーター
ケース 2: 非同期パラメーター
ケース 1 と 2 のまとめ
サマリ
関連情報
HLS ストリームおよびバッファーインターフェイス
インターフェイスの種類
ストリームインターフェイス
バッファー/アレイインターフェイス
データ処理の動作
ストリームベースカーネル
バッファー/アレイベースカーネル
混在インターフェイスタイプ (ストリームとスカラー)
各インターフェイスの使用場面
サマリ
関連ページ
その他のリソースおよび法的通知
サポートリソース
改訂履歴
お読みください: 重要な法的通知
自動車用アプリケーションの免責条項
商標

Back to home page