VisualApplets リリース 3.8.0 における既知の問題#
概要#
| 概要： | mE5 プラットフォームおよび imaFlex プラットフォームでリソース見積もりが低すぎる場合がある |
|---|---|
| 説明: | mE5 プラットフォームおよび imaFlex プラットフォームでは、一部のオペレーターのリソース見積もりが（例： Blob および Histogram) は、使用されるブロックRAMの数を過小評価している可能性があります。モジュールの設定によっては、ブロックRAMリソースの実際の使用量が50%以上増加する場合があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 297790 |
| 概要： | デザインを別のハードウェアプラットフォームに変換する際、ハードウェア依存のオペレーターライブラリが利用できない場合がある |
|---|---|
| 説明: | VisualAppletsのデザインを別のハードウェアプラットフォームに変換する際、状況によってはターゲットプラットフォーム用のハードウェア依存オペレーターライブラリが利用できない場合があります。 |
| 回避策: | これを解決するには、VisualAppletsを再起動してください。 |
| チケット ID: | – |
| 概要： | *.vaファイル名にはASCII文字のみがサポートされる |
|---|---|
| 説明: | *.vaファイルの名前付けには、ASCII文字に基づくフォントのみを使用できます。つまり、例えばアジア文字、キリル文字、ギリシャ文字、アラビア文字のフォントはファイル名にはサポートされていません。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | CXP用SDK：SISO_GenICam Libraryへのアクセスはユーザがプログラムする必要があります |
|---|---|
| 説明: | CXP 用 SDK：SISO_GenICam ライブラリへのアクセスは自動的には生成されず、ユーザーがプログラミングする必要があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | FPGAデザインのクロック周波数を上げるとビルドが遅くなる場合がある |
|---|---|
| 説明: | FPGAデザインのクロック周波数を上げると、タイミング制約を満たせないためにビルドフローに非常に時間がかかったり、失敗したりする結果になることがあります。これはVisualAppletsのデザインの内容に強く依存します。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 8513 |
| 概要： | imaFlex プラットフォームでのカスタムオペレーターが Memory インターフェイスの書き込みフラグをサポートしていない |
|---|---|
| 説明: | imaFlex プラットフォームでは、カスタムオペレーターの Memory インターフェイスは書き込みフラグをサポートしていません。Memory インターフェイスのポート ivMemWrFlag および iMemWrFlagValid は常にゼロに設定されます。 |
| 回避策: | 書き込みフラグを必要としないメモリダンプアクセススキームを実装してください。 |
| チケット ID: | 361865 |
デザイン ルール チェック (DRC)#
| 概要： | 階層型ボックス内のMタイプオペレータを入力ポートに直接接続したときに発生するデザインルールチェックのエラー |
|---|---|
| 説明: | 階層型ボックスを使用している場合、特定の状況下でDesign Rules Checkにより「オペレータ ABC（階層型ボックス）の入力 XYZ は、NOPなどのOタイプオペレータに接続する必要があります」というエラーメッセージが表示されることがあります。これは、階層型ボックス内に配置された一部のMタイプオペレータを、階層型ボックスの入力ポートに直接接続できないためです。これは特定の一部のMタイプオペレータにのみ該当します。 |
| 回避策: | この問題は、階層型ボックスの入力ポートとMタイプオペレータの入力ポートの間にNOPオペレータを配置することで解決できます（階層型ボックス内）。 |
| チケット ID: | – |
| 概要： | 行単位1Dシミュレーションモード使用時のデザインルールチェックのエラー |
|---|---|
| 説明: | VisualAppletsの以前のバージョンで Design Rules Check に合格した一部のデザインでは、最大画像ハイトに関するリンクエラーが報告される場合があります。特に、1D処理が関与しており、新しいライン単位のシミュレーションモードが有効になっている場合（デフォルト）に発生する可能性があります。その理由は、ライン単位のモードでは、一部のオペレーターが入力リンクのmax. image heightを出力リンクに伝播する方法が以前と異なるためです。 |
| 回避策: | この問題は、レガシーシミュレーションモードに変更するか、最大画像ハイト値を調整するためのSetDimensionモジュールを追加することで解決できます。 |
| チケット ID: | – |
シミュレーション#
| 概要： | 行単位1Dシミュレーションモード使用時の動作時間の増加 |
|---|---|
| 説明: | 一部のデザインでは、シミュレーションの動作時間がVisualAppletsの以前のバージョンよりも大幅に長くなる場合があります。特に、1D処理が含まれ、新しい行単位のシミュレーションモードが有効になっており（デフォルト）、デザインに多くのシミュレーションプローブが含まれている場合に発生することがあります。 |
| 回避策: | この問題は、レガシーシミュレーションモードに変更するか、シミュレーションプローブの数を減らすことで解決できます。 |
| チケット ID: | – |
| 概要： | 大きな画像がシミュレーションプローブに表示されない |
|---|---|
| 説明: | シミュレーションプローブに非常に大きな画像が含まれている場合、メモリの制限によりVisualAppletsがこれらの画像を正しく表示できないことがあります。その場合、灰色の画像（つまりすべてのピクセルの値が205 (0xCD)の画像）が表示されます。 |
| 回避策: | シミュレーションにはより小さな画像を使用してください。 |
| チケット ID: | 6822 |
| 概要： | シミュレーションがサポートするのは2 GB未満の画像のみ |
|---|---|
| 説明: | シミュレーション中、すべての画像の内部バッファサイズは2 GBに制限されます。2 GBを超える画像を使用したシミュレーションでは、エラーメッセージが表示されてシミュレーションが停止します。 |
| 回避策: | シミュレーションには2 GB未満の画像を使用してください。 |
| チケット ID: | 240989 |
| 概要： | Simulation Probe Viewerに読み込まれたRGB画像がモノクロ画像（8ビット）として保存される場合がある |
|---|---|
| 説明: | Simulation Probe Viewerでは、カラーチャンネル間で同じ値を持つRGB画像は、24ビット画像としてではなく、モノクロ画像（つまり8ビット画像）として保存されます。 |
| 回避策: | チャンネルを保持する場合は、画像をBMPファイル形式で保存してください。 |
| チケット ID: | 266977 |
Xilinx#
| 概要： | 2026.1 未満のバージョンの Vivado を使用して imaFlex デザインをビルドすると、Optimize ステップ中に失敗する場合がある |
|---|---|
| 説明: | 2026.1 未満のバージョンの Vivado を使用して imaFlex デザインをビルドすると、Optimize ステップ中に失敗することがあります。この問題は、ビルドプロセスを再度実行することで解決できます。 |
| 回避策: | Vivado バージョン 2026.1 を使用してデザインをビルドします。このバージョンでは、Vivado Design Suite の Core エディション以上が必要です。上位エディション (PRO、Enterprise、Gold) もサポートされています。無料の Basic エディションでは不十分です。または、ビルドプロセスを再度実行します。ビルドディレクトリのパスはできるだけ短くしてください。System Settings ダイアログの Global Build カテゴリ > Path for building applets 設定で、ビルドディレクトリを明示的に指定できます。 |
| チケット ID: | 341870 |
| 概要： | Xilinx ISEビルドツールチェーンがWindows 11をサポートしていない |
|---|---|
| 説明: | Xilinx ISEビルドツールチェーンはWindows 11をサポートしていません。そのため、Xilinx ISEではVisualAppletsデザインのビルドが機能しません。 |
| 回避策: | Xilinx Vivado でアプレットをビルドします (Vivado は Windows 11 をサポートしています)。Vivado でサポートされているプラットフォームについては、システム要件トピックを参照してください。 この フォーラムディスカッションでは、公式にはサポートされていないものの、Windows 11 に ISE をインストールするためのいくつかの回避策を確認できます。 |
| チケット ID: | 236990 |
| 概要： | VisualApplets が Vivado 2025.1 および 2025.2 を使用した imaFlex CXP-12 プラットフォームのデザインビルドを禁止している |
|---|---|
| 説明: | VisualApplets では、これらのバージョンで作成されたデザインが機能しないため、Vivado 2025.1 および 2025.2 を使用した imaFlex CXP-12 プラットフォームのデザインビルドはサポートされていません。 |
| 回避策: | すべての imaFlex CXP-12 プラットフォームを、Vivado バージョン 2023.2 ～ 2024.2、または 2026.1 以降でビルドします。唯一の例外は imaFlex 2 Dual 100 プラットフォームです。このプラットフォームのデザインは、Vivado 2025.2 以降を使用してビルドする必要があります。Vivado Design Suite 2026.1 以降では、Core エディション以上が必要です。上位エディション (PRO、Enterprise、Gold) もサポートされています。無料の Basic エディションでは不十分です。 |
| チケット ID: | 341684 / 348084 |
| 概要： | mE 5 marathon VCLおよびmE 5 marathon VCLxプラットフォーム用のアプレットを特定のXilinx Vivadoバージョンでビルドできない |
|---|---|
| 説明: | プラットフォームmicroEnable 5 marathon VCLおよびmicroEnable 5 marathon VCLx用のアプレットは、2020.2から2021.1の間のVivadoバージョンではビルドできません。 |
| 回避策: | この問題は、Xilinx Vivadoバージョン2021.2で修正されました。したがって、この問題を回避するには、Vivadoバージョン2021.2以降を使用してください。 |
| チケット ID: | 217879 |
| 概要： | アップレットのビルド時にXilinx Vivadoの警告が表示される |
|---|---|
| 説明: | Xilinx Vivadoツールを使用してアプレットをビルドする際、クリティカル警告が表示される場合があります（LinkDesignビルドステップ中）。この警告は、Xilinxツールチェーン内の問題が原因です。この問題はXilinxに既知であり、修正が進められています。例: |
| 回避策: | 警告は無視してください。この問題は、VisualAppletsで作成されたデザインにとってクリティカルではありません。 |
| チケット ID: | – |
Library Blob#
Blob_Analysis_1D オペレーター#
| 概要： | Blob_Analysis_1D オペレーターが「object size exceeds maximum」フラグを期待通りに設定しない |
|---|---|
| 説明: | によって定義された最大サイズを超過したためにオブジェクトが切り捨てられた場合、 max_object_height_bits parameter, the corresponding object size exceeds maximum フラグは、先行するオブジェクトではなく、切り捨てられたオブジェクトに設定されます。 |
| 回避策: | 新しく BlobDetector1D operatorを代わりに使用してください。この問題は新しいoperatorで解決されています。 |
| チケット ID: | 9685 |
| 概要： | Blob_Analysis_1D オペレーターが「label overflow」フラグを設定しない |
|---|---|
| 説明: | イメージ label overflow すべてのラベルが使用中であり、現在オブジェクトにタグを付けられないことを示すフラグは、設定されることはありません。 |
| 回避策: | 新しく BlobDetector1D operatorを代わりに使用してください。この問題は新しいoperatorで解決されています。 |
| チケット ID: | 9691 |
| 概要： | Blob_Analysis_1D オペレーターが定義値より 1 ラインあたり 20 個少ないラベルを許可する |
|---|---|
| 説明: | によって定義された利用可能なラベルの数は、 Label_bits parameter is reduced by 20 labels. For example, if Label_bits が5に設定されている場合、予想される32個（2^5）ではなく、12個（2^5 - 20個）のラベルのみが利用可能です。 |
| 回避策: | 新しく BlobDetector1D operatorを代わりに使用してください。この問題は新しいoperatorで解決されています。 |
| チケット ID: | 9688 |
| 概要： | Blob_Analysis_1D オペレーターのシミュレーションがハードウェアの動作と一致しない |
|---|---|
| 説明: | オブジェクト特徴量の出力順序は、ハードウェアとソフトウェアで異なる場合があります。これは、ハードウェアの出力がVisualAppletsではシミュレートできないデータのタイミングに依存するためです。さらに、FlushI入力は画像データ入力に対して非同期であるため、出力フレームの完了を現実的な方法でシミュレートできない場合があります。 |
| 回避策: | 新しく BlobDetector1D operatorを代わりに使用してください。この問題は新しいoperatorで解決されています。 |
| チケット ID: | 7709 |
Library Color#
| 概要： | 一部の色変換が期待通りに動作しない |
|---|---|
| 説明: | のオペレーター カラー ライブラリは注意して使用する必要があります。一部の色変換は、ユーザーが想定するようには動作しません：
|
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
ColorTransform オペレーター#
| 概要： | 負の変換係数の制限 |
|---|---|
| 説明: | イメージ ColorTransform オペレーターは、入力フォーマットが符号付きであるか、係数が静的である場合にのみ、負の変換係数をサポートします。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 251344 |
BAYER5x5Linear オペレーター#
| 概要： | BAYER5x5Linear に対する VisualApplets 内のリソース見積もりが Xilinx での見積もりと異なる |
|---|---|
| 説明: | BAYER5x5Linear: 場合によっては、VisualAppletsにおけるこのオペレーターのリソース見積もり（ FPGAリソース使用量 ダイアログ）は、配置＆配線（Place & Route）後にXilinxツールによって表示される見積もりと異なる場合があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 6426 |
Library Compression#
JPEG_Encoder オペレーター#
| 概要： | JPEG_Encoder オペレーターの出力転送が実画像データの転送よりも早く開始される |
|---|---|
| 説明: | オペレーター：画像スループットレート（帯域幅）を最適化するために、オペレーターは画像データがオペレーターの入力に到達する前であっても、ヘッダー生成が有効になるとすぐにヘッダーを出力します。このようにして、ヘッダーが事前に転送されるため、ヘッダーデータの転送が画像データの転送を中断しません。この方法の欠点は、オペレーターの出力転送が実画像データの転送よりも早く開始されることです。これにより、特定の状況下で混乱が生じる可能性があります： を使用している場合、 SourceSelector operator directly after JPEG_Encoder: The SourceSelector operator registers a partly processed frame as soon as it gets the header data. Therefore, if SourceSelector から画像データを取得するように切り替えると、 JPEG_Encoder, SourceSelector 未完了のフレームが常に検出されるため、他のソースに切り替えることができません。さらに、ヘッダー生成が有効で、かつ SourceSelector が別のソースから JPEG_Encoder チャンネルに切り替わると、最初の画像が失われます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
Library Filter#
FIRKernelNxM オペレーター#
| 概要： | FIRKernelNxM オペレーターが処理エラーを引き起こす場合がある |
|---|---|
| 説明: | イメージ FIRKernelNxM operator may cause processing errors in case the EdgeHandling パラメータがconstantに設定され、列数 > 2*Parallelism、カーネルの列数が偶数、かつ Parallelism > 1 の場合。エラーは画像の左端で監視でき、フレーム内のカーネル位置で誤ったピクセルデータが使用されます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 2939 |
Library Hardware Platforms#
Trigger オペレーター#
| 概要： | トリガーオペレーターがトリガー出力線でスパイクを引き起こす可能性がある |
|---|---|
| 説明: | トリガー演算子は、アプレットをフレームグラバーに読み込む際の初期化フェーズにおいて、トリガー出力線にスパイクを引き起こす可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
ImageBufferMultiRoiDyn オペレーター#
| 概要： | 小さな画像のタイミングエラー |
|---|---|
| 説明: | イメージ ImageBufferMultiRoiDyn オペレーターは、非常に小さな入力画像の場合にタイミングエラーを引き起こす可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
Library Memory#
| 概要： | URAM を使用するオペレーターがタイミング要件を満たせない場合がある |
|---|---|
| 説明: | のモジュールが ImageFifo, LineMemory, FrameMemory、または LUT オペレーターが複数の UltraRAM (URAM) FPGA リソースを使用する場合、アプレットのビルド時にデザインがタイミング要件を満たせないことがあります。これは、例えばオペレーターがディープバッファ用に URAM リソースをカスケード接続する場合などに発生する可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 364659 |
CoefficientBuffer オペレーター#
| 概要： | シミュレーションで48-bit RGB画像を生成する際にCoefficientBuffer Operatorが24-bit RGB画像を読み込めない |
|---|---|
| 説明: | 次を使用する場合： CoefficientBuffer operatorを使用して48-bit RGB画像を生成する場合、シミュレーションでオペレーターを初期化するために24-bit RGB画像を読み込むことはできません。24-bit RGBから48-bit RGBへのマッピングも、実行時にはサポートされていません。 |
| 回避策: | 次の出力リンクを設定します： CoefficientBuffer モノクロ形式へのオペレーター。データをモジュールにロードできるように、画像データをモノクロに変換します。 CoefficientBuffer モジュール。次に、の出力を変換します CoefficientBuffer operatorをRGB48に設定します。 |
| チケット ID: | 215233 |