VisualApplets Release 3.6.1における既知の問題#
概要#
| 概要： | 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: | – |
| 概要： | 設定が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処理が含まれており、新しい行単位のシミュレーションモードが有効になっている（デフォルト）場合に発生することがあります。これは、行単位モードでは、一部のオペレータが入力リンクの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 |
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で作成されたデザインが正常に動作しないため、これらのバージョンを使用したデザインのビルドはサポートされていません。 |
| 回避策: | アップレットのビルドにはVivado 2023.2を使用してください。 |
| チケット ID: | 341684 / 348084 |
| 概要： | mE5-CLプラットフォーム用のアップレットを特定のXilinx Vivadoバージョンでビルドできない |
|---|---|
| 説明: | mE5-CLプラットフォーム用のアップレットは、2020.2から2021.1までのVivadoバージョンではビルドできません。 |
| 回避策: | この問題は、Xilinx Vivadoバージョン2021.2で修正されました。したがって、この問題を回避するには、Vivadoバージョン2021.2以降を使用してください。 |
| チケット ID: | 217879 |
| 概要： | アップレットのビルド時にXilinx Vivadoの警告が表示される |
|---|---|
| 説明: | Xilinx Vivadoツールを使用してアップレットをビルドする際、（LinkDesignのビルドステップ中に）クリティカルな警告が表示されることがあります。この警告は、Xilinxツールチェーン内の問題が原因です。この問題はXilinxに既知のものであり、修正が進行中です。例： |
| 回避策: | 警告は無視してください。この問題は、VisualAppletsで作成されたデザインにとってクリティカルではありません。 |
| チケット ID: | – |
Library Accumulator#
Histogram オペレーター#
| 概要： | 連続する同一のピクセル値でヒストグラムの結果が正しくなくなる |
|---|---|
| 説明: | 連続する入力ピクセルが同じ値を持つ場合、Histogramオペレータが正しく動作しません。そのような場合、ヒストグラムのカウントが失われ、結果が不正確になる可能性があります。 |
| 回避策: | VisualApplets 3.7.0以降にアップグレードしてください。この問題はそのバージョンで修正されています。 |
| チケット ID: | 353017 |
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 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#
| 概要： | 一部の色変換が期待通りに動作しない |
|---|---|
| 説明: | のオペレーター カラー ライブラリは注意して使用する必要があります。一部の色変換は、ユーザーが想定するようには動作しません：
|
| 回避策: | 回避策はありません。 |
| チケット 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 チャンネルに切り替わると、最初の画像が失われます。 |
| 回避策: | eVAデバイスで作業する場合は、センサーの転送が開始される前に、出力がデータ転送を受け入れることができることを確認してください。 |
| チケット 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#
LUTベースのオペレーター#
| 概要： | テキストファイルからインポートされた大きな整数値の精度が失われる可能性がある |
|---|---|
| 説明: | 53ビットを超える整数値を含むテキストファイルを整数フィールドパラメータにインポートすると、最下位ビットの一部が失われる場合があります。その結果、インポートされた値が丸められ、ファイルで指定された値と異なる場合があります。これはLUTベースのoperatorや、整数値のファイルインポートをサポートする他のoperatorに影響を与える可能性がありますが、VisualApplets内でのみ発生します。ランタイム時には、値は正しくロードされます。 |
| 回避策: | インポートする整数値が53ビットを超えないようにしてください。または、VisualAppletsをバージョン3.8.0以降にアップデートしてください。この問題はそこで修正されています。 |
| チケット ID: | 363933 |
Library Synchronization#
IsLastPixel オペレーター#
| 概要： | イメージ IsLastPixel オペレーターが画像が空であることを誤って示す |
|---|---|
| 説明: | イメージ IsEmpty の出力 IsLastPixel オペレータは、パラメータが Mode が次のように設定されている場合、自動的に無効になります： Frameこの問題は、シミュレーションとハードウェアの動作の両方に影響します。ハードウェアでは、空のフレームが空ではないと誤ってマークされることがあります。シミュレーションでは、空ではないフレームが空であると誤ってマークされることがあります。 |
| 回避策: | 次の項目を使用しないでください： IsEmpty が Mode = Frame. |
| チケット ID: | 337672 |