VisualApplets Release 3.3.2の既知の問題
情報
VisualApplets 3.3.2のUpdate 2301によりWindows 11でのVisualAppletsの使用が可能になりますが、一部のVivadoのインストール環境では、ビルドフローがDesign-Rules-Check-2ステップの後に停止し、エラーメッセージError: -1 Error checking FPGA softwareが表示されることがあります。この問題が発生した場合は、事前条件チェックが有効にならないようにビルド設定を変更してください。
情報
Xilinx Vivadoのバージョン2017.2または2017.3がインストールされているコンピュータにWindows 10 Fall Creatorsアップデート（バージョン1709）をインストールすると、Xilinx Vivadoが正常に動作しない場合があります。そのため、VisualAppletsで作成したデザインをビルドできなくなることがあります。
Xilinx Vivado 2017.2 または 2017.3 のインストールを再度機能させるには、Xilinx Support が提供する回避策に従ってください。
情報
上記のWindows 10アップデートをインストールすると、Vivado 2017.4より前のXilinxツールを使用したビルドフローが正常に動作しない場合があります。そのため、VisualAppletsで作成したデザインをビルドできなくなることがあります。
Vivado 2017.4より前のバージョンの場合、一部のブラックボックスインスタンスに未定義の内容が含まれていることを示すエラーメッセージがXilinxツールチェーンのログ出力に表示されることがあります。ISEの場合、Xilinxツールのバージョンを特定できず、FPGAタイプチェックが失敗します。
Follow the workaround provided by Xilinx Support to make the ISE installation work again (section "ISE 14.7 64-bit - Turning off SmartHeap"). The same workaround can be used for Vivado where you need to perform the file substitution actions in directory <VivadoInstallDir>/ids_lite/ISE/lib/nt64.
概要
| 概要： | Tclスクリプト（ Color Flavor 値 LAB, XYZ, HSL, HSV、または YCrCb ）の使用によりインポート時にエラーが発生する |
| 説明: | デザインをリンクプロパティに Color Flavor の値 LAB, XYZ, HSL, HSV、または YCrCb が含まれるTclスクリプトにエクスポートすると、スクリプトからのデザインのインポート時にエラーが発生します。 |
| 回避策: | この問題はVisualApplets 3.4.0で修正されています。VisualAppletsのバージョンを3.4.0にアップデートしてください。 |
| チケット ID: | 258727 |
| 概要： | TIF形式の小さな画像の読み込みによりImage Magickエラーが発生する |
| 説明: | TIF形式の小さな画像の読み込み時に、エラーメッセージImage Magick library: Image format is not supported. Error code: -70002が表示されて失敗することがあります。 |
| 回避策: | VisualAppletsのSystem Settingsで、I/O Image LibraryをImage MagickではなくNativeに設定してください。または、VisualAppletsのバージョンを3.4.0にアップデートしてください。 |
| チケット ID: | 265278 |
| 概要： | VisualAppletsがVivadoのバージョン番号を検出しないことがある |
| 説明: | Vivado 2023.1以降でアプレットをビルドする場合、VisualAppletsがVivadoのバージョン番号を検出しません。 |
| 回避策: | VisualAppletsのバージョンを3.4.0にアップデートするか、Vivadoのインストールの vivado.bat ファイルに直接続く行を挿入してパッチを適用してください @echo off:
if "%1"=="-version" (
goto returnVersionInfo
) else (
goto proceed
)
:returnVersionInfo
echo Vivado v2023.1 (64-bit)
:proceed |
| チケット ID: | 285232 |
| 概要： | Xilinx ISEビルドツールチェーンはWindows 11をサポートしていません |
| 説明: | Xilinx ISEビルドツールチェーンはWindows 11をサポートしていません。そのため、Xilinx ISEではVisualAppletsのデザインをビルドできません。 |
| 回避策: | Xilinx ISEでのビルドが必要なプラットフォーム向けにアプレットをビルドする場合は、Windows 10または8.1環境にVisualAppletsをインストールしてください。ターゲットプラットフォームがVivadoに対応している場合は、Xilinx Vivadoでアプレットをビルドしてください（VivadoはWindows 11をサポートしています）。Vivadoでサポートされているプラットフォームについては、システム要件を参照してください。 |
| チケット ID: | 236990 |
| 概要： | mE5-CLプラットフォーム用のアップレットを特定のXilinx Vivadoバージョンでビルドできない |
| 説明: | mE5-CLプラットフォーム用のアップレットは、2020.2から2021.1までのVivadoバージョンではビルドできません。 |
| 回避策: | この問題は、Xilinx Vivadoバージョン2021.2で修正されました。したがって、この問題を回避するには、Vivadoバージョン2021.2以降を使用してください。 |
| チケット ID: | 217879 |
| 概要： | On Windows 8, You Must Define the User Directory as Destination Directory |
| 説明: | Microsoft Windows 8では、ユーザーディレクトリを宛先ディレクトリとして定義する必要があります。または、フルアクセス権を持つ他のディレクトリを使用することもできます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | デザインを別のハードウェアプラットフォームに変換する際、ハードウェア依存のオペレーターライブラリが利用できない場合がある |
| 説明: | VisualAppletsの設計を別のハードウェアプラットフォームに変換する場合、状況によってはターゲットプラットフォーム用のハードウェア依存オペレーターライブラリが利用できないことがあります。 |
| 回避策: | これを解決するには、VisualAppletsを再起動します。 |
| チケット ID: | – |
| 概要： | シミュレーションエラーの発生後はシミュレーション条件のリセットが必要 |
| 説明: | シミュレーションエラーが発生した後は、シミュレーション条件をリセットする必要があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | アップレットのビルド時にXilinx Vivadoの警告が表示される |
| 説明: | Xilinx Vivado Toolsを使用してアプレットをビルドする際、（ビルドステップのLinkDesignにおいて）クリティカル警告が表示されることがあります。この警告は、Xilinxツールチェーン内の問題に起因しています。この問題はXilinx社に認知されており、現在修正が進められています。例:
CRITICAL WARNING: [Shape Builder 18-137] Cannot obey LUTNM/HLUTNM constraint for instances …/PART1174 and …/PART1175. Illegal to place instance …/PART1174 on site SLICE_X2Y0. The location site type does not match the instance type. Instance …/PART1174 belongs to a shape with reference instance …/PART1175. Shape elements have relative placement respect to each other. The invalid location might results from a constraint on any of the instance in the shape..
|
| 回避策: | 警告は無視してください。この問題は、VisualAppletsで作成されたデザインにとってクリティカルではありません。 |
| チケット ID: | – |
| 概要： | *.vaファイル名にはASCII文字のみがサポートされる |
| 説明: | *.vaファイルの命名には、ASCII文字ベースのフォントのみを使用できます。つまり、ファイル名にはアジア文字、キリル文字、ギリシャ文字、アラビア文字などのフォントはサポートされていません。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | 設定がVisualAppletsの最初のインスタンスに対してのみ保存される |
| 説明: | VisualApplets の最初に起動したインスタンスのみが設定を保存できます。後から起動されたすべての VisualApplets インスタンスは一時的な設定のみを持ち、インスタンスが閉じられると破棄されます。これには、例えばビルド設定、ライブラリ設定、システム設定、一般的な VisualApplets 設定などが含まれます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 342725および347964 |
| 概要： | 階層型ボックス内のMタイプオペレータを入力ポートに直接接続したときに発生するデザインルールチェックのエラー |
| 説明: | 階層型ボックスを使用している場合、特定の状況下でDesign Rules Checkにより「オペレータ ABC（階層型ボックス）の入力 XYZ は、NOPなどのOタイプオペレータに接続する必要があります」というエラーメッセージが表示されることがあります。これは、階層型ボックス内に配置された一部のMタイプオペレータを、階層型ボックスの入力ポートに直接接続できないためです。これは特定の一部のMタイプオペレータにのみ該当します。 |
| 回避策: | この問題は、（階層ボックス内で）階層ボックスの入力ポートとMタイプオペレータの入力ポートの間にNOPオペレータを配置することで解決できます。 |
| チケット ID: | – |
| 概要： | 行単位1Dシミュレーションモード使用時のデザインルールチェックのエラー |
| 説明: | VisualAppletsの旧バージョンでDesign Rules Checkを通過した一部のデザインにおいて、最大画像高に関するリンクエラーが報告される場合があります。特に、1D処理が含まれており、新しい行単位シミュレーションモードが有効になっている場合（デフォルト）に発生する可能性があります。これは、行単位モードにおいて、一部のオペレータが入力リンクの最大画像高を出力リンクへ伝播させる挙動が従来と異なるためです。 |
| 回避策: | この問題は、レガシーシミュレーションモードに切り替えるか、最大画像高の値を調整するためにSetDimensionモジュールを追加することで解決できます。 |
| チケット ID: | – |
| 概要： | 行単位1Dシミュレーションモード使用時の動作時間の増加 |
| 説明: | 一部のデザインでは、シミュレーションの処理時間がVisualAppletsの旧バージョンよりも大幅に長くなる場合があります。特に、1D処理が含まれており、新しい行単位シミュレーションモードが有効になっており（デフォルト）、デザインに多数のシミュレーションプローブが含まれている場合に発生する可能性があります。 |
| 回避策: | この問題は、レガシーシミュレーションモードに変更するか、シミュレーションプローブの数を減らすことで解決できます。 |
| チケット ID: | – |
| 概要： | CXP用SDK：SISO_GenICam Libraryへのアクセスはユーザーがプログラムする必要があります |
| 説明: | CXP 用 SDK：SISO_GenICam ライブラリへのアクセスは自動的には生成されず、ユーザーがプログラミングする必要があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | FPGAデザインのクロック周波数を上げるとビルドが遅くなる場合がある |
| 説明: | FPGAデザインのクロック周波数を上げると、タイミング制約を満たせないためにビルドフローに非常に時間がかかったり、失敗したりする結果になることがあります。これはVisualAppletsのデザインの内容に強く依存します。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 8513 |
| 概要： | 大きな画像がシミュレーションプローブに表示されない |
| 説明: | シミュレーションプローブに非常に大きな画像が含まれている場合、メモリの制限によりVisualAppletsがこれらの画像を正しく表示できないことがあります。その場合、灰色の画像（つまりすべてのピクセルの値が205 (0xCD)の画像）が表示されます。 |
| 回避策: | シミュレーションにはより小さな画像を使用してください。 |
| チケット ID: | 6822 |
| 概要： | シミュレーションがサポートするのは2 GB未満の画像のみ |
| 説明: | シミュレーション中、すべての画像の内部バッファサイズは2 GBに制限されます。2 GBを超える画像を使用したシミュレーションでは、エラーメッセージが表示されてシミュレーションが停止します。 |
| 回避策: | シミュレーションには2 GB未満の画像を使用してください。 |
| チケット ID: | 240989 |
Library Blob
オペレーター Blob_Analysis_1D
| 概要： | オペレータ Blob_Analysis_1D がフラグ object size exceeds maximum 期待値と異なる |
| 説明: | パラメータによって定義された最大サイズを超えたためにオブジェクトが切り捨てられた場合、 max_object_height_bitsで定義された最大サイズを超過したためにオブジェクトが切り捨てられた場合、対応するフラグ object size exceeds maximum は、前のオブジェクトではなく切り捨てられたオブジェクトに設定されます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 9685 |
| 概要： | オペレータ Blob_Analysis_1D がフラグを設定しない label overflow |
| 説明: | フラグ label overflow は、すべてのラベルが使用中であり、現在のオブジェクトにタグ付けできないことを示しますが、設定されることはありません。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 9691 |
| 概要： | オペレータ Blob_Analysis_1D 定義された数より1行あたり20個少ないラベルを許可 |
| 説明: | パラメータを介して定義された利用可能なラベルの量 Label_bits が20ラベル減少します。例えば、 Label_bits が5に設定されている場合、予想される32個（2^5）ではなく、12個（2^5 - 20個）のラベルのみが利用可能です。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 9688 |
| 概要： | オペレータのシミュレーション Blob_Analysis_1D がハードウェアの動作と一致しない |
| 説明: | オブジェクト特徴量の出力順序は、ハードウェアとソフトウェアで異なる場合があります。これは、ハードウェアの出力がVisualAppletsではシミュレートできないデータのタイミングに依存するためです。さらに、FlushI入力は画像データ入力に対して非同期であるため、出力フレームの完了を現実的な方法でシミュレートできない場合があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 7709 |
Library Color
| 概要： | 一部の色変換が期待通りに動作しない |
| 説明: | のオペレーター カラー ライブラリは注意して使用する必要があります。一部の色変換は、ユーザーが想定するようには動作しません：
- HSI2RGB は HSL を RGB に変換し、
- RGB2YUV は RGB を YCbCr に変換し、
- XYZ2LABは、次の定義に従って定数を使用します: www.easyrgb.com
|
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | 負の変換係数に関する制限事項 |
| 説明: | オペレーター ColorTransform は、入力フォーマットが符号付きであるか、係数が静的である場合にのみ負の変換係数をサポートします。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 251344 |
オペレーター BAYER5x5Linear
| 概要： | のリソース見積もり BAYER5x5Linear Xilinxの見積もりとは異なります |
| 説明: | BAYER5x5Linear: 場合によっては、このオペレーターの VisualApplets におけるリソース見積もり（ダイアログ FPGAリソース使用量）は、Place & Routeの実行後にXilinxツールに表示される予測値とは異なる場合があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 6426 |
Library Compression
オペレーター JPEG_Encoder
| 概要： | オペレータの出力転送 JPEG_Encoder が実際の画像データの転送よりも早く開始される |
| 説明: | Operator : 画像のスループットレート（帯域幅）を最適化するため、このオペレーターは、画像データがオペレーターの入力に到達する前であっても、ヘッダーの生成が有効化されるとすぐにヘッダーを出力します。これにより、ヘッダーが事前に転送されるため、ヘッダーデータの転送によって画像データの転送が中断されることはありません。この方式の欠点は、オペレーターの出力転送が実際の画像データの転送よりも早く開始されることです。これにより、特定の状況下で問題が発生する可能性があります。
次のオペレーターを使用している場合： SourceSelector 直後に JPEG_Encoder: オペレーター SourceSelector は、ヘッダーデータを取得するとすぐに、部分的に処理されたフレームを登録します。したがって、 SourceSelector から画像データを取得するように切り替えると、 JPEG_Encoder, SourceSelector は常に未完了のフレームを検出するため、他のソースに切り替えることができません。さらに、ヘッダー生成が有効になっていて、 SourceSelector が別のソースから JPEG_Encoder チャンネルに切り替わると、最初の画像が失われます。 |
| 回避策: | eVAデバイスで作業する場合は、センサーの転送が開始される前に、出力がデータ転送を受け入れることができることを確認してください。 |
| チケット ID: | – |
Library Debugging
オペレーター ImageFlowControl
| 概要： | オーバーフロー状況後の破損したフレーム |
| 説明: | ダミーフレーム生成モードで ImageFlowControl オペレータを使用すると、出力フレームが破損する場合があります。これは、オーバーフロー状況の発生後、失われたフレームを補正するために一連のダミーフレームが出力されるときに発生します。 |
| 回避策: | VisualAppletsをバージョン3.6.0にアップデートしてください。この問題はVisualAppletsバージョン3.6.0で修正されています。 |
| チケット ID: | 248227 |
Library Filter
オペレーター FIRKernelNxM
| 概要： | オペレーター FIRKernelNxM 処理エラーの原因となる可能性があります |
| 説明: | オペレータ FIRKernelNxM パラメータ EdgeHandling が定数に設定されている場合、列数 > 2*Parallelism である場合、カーネルの列数が偶数である場合、および Parallelism > 1 である場合に処理エラーを引き起こす可能性があります。このエラーは画像の左端で確認でき、フレーム内のカーネル位置で誤ったピクセルデータが使用されます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 2939 |
Trigger オペレーター
| 概要： | トリガーオペレーターがトリガー出力線でスパイクを引き起こす可能性がある |
| 説明: | トリガー演算子は、アプレットをフレームグラバーに読み込む際の初期化フェーズにおいて、トリガー出力線にスパイクを引き起こす可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
Library Memory
オペレーター ImageBufferMultiRoiDyn
| 概要： | 小さな画像のタイミングエラー |
| 説明: | オペレータ ImageBufferMultiRoiDyn 非常に小さな入力画像の場合にタイミングエラーを引き起こす可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
オペレーター ImageSequence
| 概要： | オペレーターに起因するビルドエラー ImageSequence |
| 説明: | オペレータ ImageSequence ビルドエラー（タイミングエラー）の原因となる可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 2422 |