コンテンツにスキップ

VisualApplets リリース 3.7.0における既知の問題#

概要#

概要: mE5 プラットフォームおよび imaFlex プラットフォームでリソース見積もりが低すぎる場合がある
説明: mE5 プラットフォームおよび imaFlex プラットフォームでは、一部のオペレーターのリソース見積もりが(例: Blob および Histogram) は、使用されるブロックRAMの数を過小評価している可能性があります。モジュールの設定によっては、ブロックRAMリソースの実際の使用量が50%以上増加する場合があります。
回避策: 回避策はありません。
チケット ID: 297790
概要: クリップボードを使用したコンテンツのコピーが機能しない
説明: このバージョンのVisualAppletsで開いたデザインのデザインコンテンツを、クリップボード(コピー&ペースト)を使用してVisualAppletsバージョン3.3.2以前で開いたデザインにコピーすることはできません。ただし、任意のVisualAppletsバージョンからこのバージョンへのコピーは機能します。
回避策: デザインを従来の*.vaファイル形式で保存し、旧バージョンのVisualAppletsで開いて、そこからコンテンツをコピーしてください。
チケット ID: –
概要: デザインを別のハードウェアプラットフォームに変換する際、ハードウェア依存のオペレーターライブラリが利用できない場合がある
説明: VisualAppletsのデザインを別のハードウェアプラットフォームに変換する際、状況によってはターゲットプラットフォーム用のハードウェア依存オペレーターライブラリが利用できない場合があります。
回避策: これを解決するには、VisualAppletsを再起動してください。
チケット ID: –
概要: *.vaファイル名にはASCII文字のみがサポートされる
説明: *.vaファイルの名前付けには、ASCII文字に基づくフォントのみを使用できます。つまり、例えばアジア文字、キリル文字、ギリシャ文字、アラビア文字のフォントはファイル名にはサポートされていません。
回避策: 回避策はありません。
チケット ID: –
概要: 階層型ボックス内の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: –
概要: 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
概要: Simulation Probe Viewerに読み込まれたRGB画像がモノクロ画像(8ビット)として保存される場合がある
説明: Simulation Probe Viewerでは、カラーチャンネル間で同じ値を持つRGB画像は、24ビット画像としてではなく、モノクロ画像(つまり8ビット画像)として保存されます。
回避策: チャンネルを保持する場合は、画像をBMPファイル形式で保存してください。
チケット ID: 266977
概要: 特定の種類のTIF画像のシミュレーション中にVisualAppletsがクラッシュする場合がある
説明: 特定の種類の .tif 画像のシミュレーション中にVisualAppletsがクラッシュする場合があります。
回避策: 別の画像ツールを使用して .tif 画像を再度保存してください。または、この問題が修正されているVisualAppletsバージョン3.8.0以降にアップデートしてください。
チケット ID: 368717

Xilinx#

概要: VivadoでのimaFlexデザインのビルドがOptimizeステップ中に失敗する場合がある
説明: VivadoでのimaFlexデザインのビルドが、Optimize ステップ中に失敗することがあります。この問題は、ビルドプロセスを再度実行することで解決できます。
回避策: ビルドプロセスを再度実行します。ビルドディレクトリへのパスをできるだけ短く保ちます。System Settings ダイアログの Global Build カテゴリ > 設定 Path for building applets で、ビルドディレクトリを明示的に設定できます。
チケット ID: 341870
概要: Xilinx ISEビルドツールチェーンがWindows 11をサポートしていない
説明: Xilinx ISEビルドツールチェーンはWindows 11をサポートしていません。そのため、Xilinx ISEではVisualAppletsデザインのビルドが機能しません。
回避策: Xilinx ISEでビルドする必要があるプラットフォーム用のアプレットをビルドする場合は、Windows 10環境でVisualAppletsをインストールしてください。ターゲットプラットフォームがVivadoによってサポートされている場合は、Xilinx Vivadoでアプレットをビルドします(VivadoはWindows 11をサポートしています)。Vivadoでサポートされているプラットフォームについては、システム要件のトピックを参照してください。
このフォーラムのディスカッションには、公式にはサポートされていないものの、Windows 11の下でISEをインストールするためのいくつかのハックが記載されています。
チケット ID: 236990
概要: VisualAppletsにより、Vivado 2025.1および2025.2を使用したほとんどのプラットフォーム向けのデザインビルドが禁止される
説明: VisualAppletsは、Vivado 2025.1および2025.2を使用したほとんどのプラットフォーム向けのデザインビルドをサポートしていません。これらのバージョンで作成されたデザインは機能しないためです。
唯一の例外はimaFlex 2 Dual 100プラットフォームです。このプラットフォームのデザインは、Vivado 2025.2以降を使用してビルドする必要があります。
回避策: imaFlex 2 Dual 100を除くすべてのプラットフォーム用のアプレットをVivado 2023.2でビルドします。
チケット 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に既知であり、修正が進められています。例:

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 result from a constraint on any of the instances in the shape.

回避策: 警告は無視してください。この問題は、VisualAppletsで作成されたデザインにとってクリティカルではありません。
チケット ID: –

Library Blob#

BlobDetector1D オペレーター#

概要: BlobDetector1D Line-by-Line Modeでのシミュレーション中にデータが失われる可能性がある
説明: カメラの BlobDetector1D オペレータをライン単位モードで使用する場合、例えば以下の使用時に後段のオペレータがバックプレッシャーを発生させると、オペレータの出力でデータが失われる可能性があります SplitLine operator。この問題はシミュレーションに限定されており、生成されるハードウェアデザインの動作には影響しません。
回避策: ハードウェア上でデザインの動作を確認してください。または、VisualAppletsをバージョン3.8.0以降にアップデートしてください。この問題はそこで修正されています。
チケット ID: 364374

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 Operator Does Not Set the 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#

概要: 一部の色変換が期待通りに動作しない
説明: のオペレーター カラー ライブラリは注意して使用する必要があります。一部の色変換は、ユーザーが想定するようには動作しません:
  • HSI2RGBはHSLをRGBに変換します
  • RGB2YUVはRGBをYCbCrに変換します
  • XYZ2LABは、次の定義に従って定数を使用します: www.easyrgb.com
回避策: 回避策はありません。
チケット ID: –

ColorTransform オペレーター#

概要: 負の変換係数の制限
説明: イメージ ColorTransform オペレーターは、入力フォーマットが符号付きであるか、係数が静的である場合にのみ、負の変換係数をサポートします。
回避策: 回避策はありません。
チケット ID: 251344

BAYER5x5Linear オペレーター#

概要: のリソース見積もり BAYER5x5Linear 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#

CoFCamera オペレーター(imaFlex 2 Dual 100のみ)#

概要: 2つを使用したimaFlex 2 Dual 100のデザインでDRC2が一般的なネットリスト生成エラーを報告する CoFCamera モジュール
説明: 2つの CoFCamera modulesをimaFlex 2 Dual 100のデザインで使用すると、DRC2が一般的なネットリスト生成エラーを報告する場合があります。デザインのビルド自体は可能ですが、生成されたハードウェアデザインが正常に動作しない可能性があります。
回避策: VisualAppletsをバージョン3.8.0以降にアップデートしてください。この問題はそこで修正されています。
チケット ID: 366304

Trigger オペレーター#

概要: トリガーオペレーターがトリガー出力線でスパイクを引き起こす可能性がある
説明: トリガー演算子は、アプレットをフレームグラバーに読み込む際の初期化フェーズにおいて、トリガー出力線にスパイクを引き起こす可能性があります。
回避策: 回避策はありません。
チケット ID: –

ImageBufferMultiRoiDyn オペレーター#

概要: 小さな画像のタイミングエラー
説明: イメージ ImageBufferMultiRoiDyn オペレーターは、非常に小さな入力画像の場合にタイミングエラーを引き起こす可能性があります。
回避策: 回避策はありません。
チケット ID: –

Library Memory#

概要: mE6プラットフォーム上のバッファoperatorでWritePriorityモードが有効な場合のスループット低下
説明: mE6ハードウェアプラットフォームでは、Memory Library内のバッファoperatorで WritePriority modeを有効にすると、達成可能な最大データスループットが低下します。このモードでは効率の低いDRAMアクセス調停戦略が使用されるため、インターフェイス全体のパフォーマンスが低下します。
回避策: アプリケーションで必要な場合を除き、 WritePriority modeを無効にしてください。
チケット ID: 366936

LUTベースのオペレーター#

概要: テキストファイルからインポートされた大きな整数値の精度が失われる可能性がある
説明: 53ビットを超える整数値を含むテキストファイルを整数フィールドパラメータにインポートすると、最下位ビットの一部が失われる場合があります。その結果、インポートされた値が丸められ、ファイルで指定された値と異なる場合があります。これはLUTベースのoperatorや、整数値のファイルインポートをサポートする他のoperatorに影響を与える可能性がありますが、VisualApplets内でのみ発生します。ランタイム時には、値は正しくロードされます。
回避策: インポートする整数値が53ビットを超えないようにしてください。または、VisualAppletsをバージョン3.8.0以降にアップデートしてください。この問題はそこで修正されています。
チケット ID: 363933

LineBuffer imaFlex 2 Dual 100 上のオペレーター#

概要: LineBuffer imaFlex 2 Dual 100でoperatorのスループットが低下する可能性がある
説明: imaFlex 2 Dual 100ハードウェアプラットフォームでは、 LineBuffer operatorは、受信データストリームのタイミング特性に応じてパフォーマンスが低下する場合があります。最悪の場合、達成可能な最大帯域幅が最大50%減少する可能性があります。
回避策: 入力ストリームのタイミング変動を吸収するために、 LineBuffer operatorの上流に十分な大きさのFIFOを挿入してください。
チケット ID: 366936