既知の問題：VisualApplets リリース 3.5.0
情報
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 the <VivadoInstallDir>/ids_lite/ISE/lib/nt64 directory.
概要
| 概要： | Xilinx Vivado 2024.2 でアプレットをビルドできない |
| 説明: | Xilinx Vivado バージョン 2024.2 以降でアプレットをビルドすると、Vivado のクラッシュによりビルド処理が失敗する場合があります。 |
| 回避策: | この問題は VisualApplets バージョン 3.5.1 で修正されています。VisualApplets のインストールをバージョン 3.5.1 にアップデートしてください。または、別の Xilinx Vivado バージョンを使用してください。 |
| チケット ID: | 320463 |
| 概要： | mE5 プラットフォームおよび imaFlex プラットフォームでリソース見積もりが低すぎる場合がある |
| 説明: | mE5 プラットフォームおよび imaFlex プラットフォームでは、一部のオペレーターのリソース見積もりが（例： Blob および Histogram)は、使用されるブロックRAMの数を過小評価している可能性があります。モジュール構成によっては、ブロックRAMリソースの実際の使用量が50%以上多くなることがあります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 297790 |
| 概要： | クリップボードを使用したコンテンツのコピーが機能しない |
| 説明: | このバージョンのVisualAppletsで開いたデザインから、VisualAppletsバージョン3.3.2以前で開いたデザインへ、クリップボード（コピー＆ペースト）を使用してデザインコンテンツをコピーすることはできません。ただし、どのVisualAppletsバージョンからこのバージョンへのコピーは可能です。 |
| 回避策: | デザインを従来の*.vaファイル形式で保存し、旧バージョンのVisualAppletsで開いて、そこからコンテンツをコピーしてください。 |
| チケット ID: | – |
| 概要： | Simulation Probe Viewerに読み込まれたRGB画像がモノクロ画像（8ビット）として保存される場合がある |
| 説明: | Simulation Probe Viewerでは、カラーチャンネル間で同じ値を持つRGB画像は、24ビット画像としてではなく、モノクロ画像（つまり8ビット画像）として保存されます。 |
| 回避策: | チャンネルを保持する場合は、画像をBMPファイル形式で保存してください。 |
| チケット ID: | 266977 |
| 概要： | Xilinx ISEビルドツールチェーンがWindows 11をサポートしていない |
| 説明: | Xilinx ISEビルドツールチェーンはWindows 11をサポートしていません。そのため、Xilinx ISEではVisualAppletsデザインのビルドが機能しません。 |
| 回避策: | Xilinx ISEでのビルドが必要なプラットフォーム用のアップレットをビルドする場合は、Windows 10環境で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 |
| 概要： | デザインを別のハードウェアプラットフォームに変換する際、ハードウェア依存のオペレーターライブラリが利用できない場合がある |
| 説明: | VisualAppletsのデザインを別のハードウェアプラットフォームに変換する際、状況によってはターゲットプラットフォーム用のハードウェア依存オペレーターライブラリが利用できない場合があります。 |
| 回避策: | これを解決するには、VisualAppletsを再起動してください。 |
| チケット ID: | – |
| 概要： | アップレットのビルド時に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 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処理が含まれており、新しい行単位のシミュレーションモードが有効になっている（デフォルト）場合に発生することがあります。これは、行単位モードでは、一部のオペレータが入力リンクの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 |
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 フラグは、後続のオブジェクトではなく切り捨てられたオブジェクトに設定されます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 9685 |
| 概要： | イメージ Blob_Analysis_1D Operator Does Not Set the label overflow フラグ |
| 説明: | イメージ label overflow すべてのラベルが使用中であり、現在オブジェクトにタグを付けられないことを示すフラグは、設定されることはありません。 |
| 回避策: | 回避策はありません。 |
| チケット 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個）のラベルのみが利用可能です。 |
| 回避策: | 回避策はありません。 |
| チケット 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 オペレーターは実際の画像データ転送よりも早く開始されます |
| 説明: | オペレーター：画像のスループットレート（帯域幅）を最適化するために、オペレーターは、画像データがオペレーターの入力に到達する前であっても、ヘッダー生成が有効になるとすぐにヘッダーを出力します。このようにして、ヘッダーが事前に転送されるため、ヘッダーデータの転送が画像データの転送を中断することはありません。この手法の欠点は、オペレーターの出力転送が実際の画像データ転送よりも早く開始されることです。これにより、特定の状況下で問題が発生する可能性があります：
を使用している場合、 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 Debugging
ImageFlowControl オペレーター
| 概要： | オーバーフロー状況後の破損したフレーム |
| 説明: | ImageFlowControl ダミーフレーム生成モードのオペレーターは、出力として破損したフレームを生成する可能性があります。これは、オーバーフロー状況が発生した後に、失われたフレームを補償するために一連のダミーフレームが送信される場合に発生します。 |
| 回避策: | VisualAppletsをバージョン3.6.0にアップデートしてください。この問題はVisualAppletsバージョン3.6.0で修正されています。 |
| チケット ID: | 248227 |
Library Filter
DILATE オペレーター
| 概要： | ハードウェア実装において、 DILATE オペレーターの構造化要素が回転する |
| 説明: | ハードウェア実装における DILATE オペレーターは、シミュレーションおよびドキュメントとは異なります。ハードウェア実装では、構造化要素が回転します。 |
| 回避策: | VisualAppletsをバージョン3.6.0にアップデートしてください。この問題はVisualAppletsバージョン3.6.0で修正されています。 |
| チケット ID: | 267460 |
FIRKernelNxM オペレーター
| 概要： | FIRKernelNxM オペレーターが処理エラーを引き起こす可能性がある |
| 説明: | イメージ FIRKernelNxM operator may cause processing errors in case the EdgeHandling パラメータがconstantに設定され、列数 > 2*Parallelism、カーネルの列数が偶数、かつ Parallelism > 1 の場合。エラーは画像の左端で監視でき、フレーム内のカーネル位置で誤ったピクセルデータが使用されます。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 2939 |
Trigger オペレーター
| 概要： | トリガーオペレーターがトリガー出力線でスパイクを引き起こす可能性がある |
| 説明: | トリガー演算子は、アプレットをフレームグラバーに読み込む際の初期化フェーズにおいて、トリガー出力線にスパイクを引き起こす可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
Library Memory
RamLUTオペレーター
| 概要： | 初期化データの書き込み先： RamLUT アクティベーション中のオペレーターはimaFlexプラットフォームに影響を与えない |
| 説明: | 初期化データの書き込み： RamLUT 取得中のオペレーターはimaFlexプラットフォームに影響を与えません。メモリ内容の設定は、取得が停止している場合にのみ可能です。 |
| 回避策: | 初期化データを書き込む前に取得を停止してください。 RamLUT オペレーター。またはVisualAppletsをバージョン3.6.0にアップデートしてください。この問題はVisualApplets 3.6.0で修正されています。 |
| チケット ID: | 319280 |
ImageBufferMultiRoiDyn オペレーター
| 概要： | 小さな画像のタイミングエラー |
| 説明: | イメージ ImageBufferMultiRoiDyn オペレーターは、非常に小さな入力画像の場合にタイミングエラーを引き起こす可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | – |
| 概要： | イメージ ImageBufferMultiRoiDyn operatorがROI幅の値に対して正しく機能しない Parallelism |
| 説明: | の値の場合 ROI Width の値に等しい Parllelism、ROIが期待どおりに読み出されません。代わりに、最初 ピクセル／ラインが ROI Height 回実行します。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 307592 |
ImageSequence オペレーター
| 概要： | によって引き起こされるビルドエラー ImageSequence オペレーター |
| 説明: | イメージ ImageSequence オペレーターはビルドエラー（タイミングエラー）を引き起こす可能性があります。 |
| 回避策: | 回避策はありません。 |
| チケット ID: | 2422 |