VisualApplets 3.7.0 版本已知問題#
一般資訊#
| 摘要： | 對於 mE5 平台和 imaFlex 平台，資源估算值可能過低 |
|---|---|
| 描述： | 對於 mE5 和 imaFlex 平台，某些 operator 的資源估算（即 Blob 和 Histogram) 可能會低估所使用的區塊 RAM 數量。根據模組組態，區塊 RAM 資源的實際使用量可能會高出 50% 以上。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 297790 |
| 摘要： | 使用剪貼簿複製內容無法運作 |
|---|---|
| 描述： | 無法使用剪貼簿（複製與貼上）將由此版本 VisualApplets 開啟之設計中的內容，複製到在 VisualApplets 3.3.2 或更早版本中開啟的設計中。不過，從任何 VisualApplets 版本複製到此版本是可以正常運作的。 |
| 因應措施： | 將您的設計儲存為舊版 *.va 檔案格式，在較舊版本的 VisualApplets 中開啟它，然後從那裡複製內容。 |
| 問題單 ID： | – |
| 摘要： | 當將設計轉換為不同的硬體平台時，硬體相依的 operator 庫可能無法使用 |
|---|---|
| 描述： | 將 VisualApplets 設計轉換為不同的硬體平台時，在某些情況下，目標平台的硬體相關 operator library 可能無法使用。 |
| 因應措施： | 若要解決此問題，請重新啟動 VisualApplets。 |
| 問題單 ID： | – |
| 摘要： | *.va 檔案名稱僅支援 ASCII 字元 |
|---|---|
| 描述： | 命名 *.va 檔案時，僅能使用基於 ASCII 字元的字型；這表示例如亞洲字型、斯拉夫字型、希臘字型或阿拉伯字型均不支援用於檔案名稱。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
| 摘要： | 當階層方塊中的 M-Type 運算子直接連接到輸入連接埠時發生設計規則檢查錯誤 |
|---|---|
| 描述： | 如果您使用階層方塊，在某些特定情況下，Design Rules Check 可能會出現以下錯誤訊息：「運算子 ABC（階層方塊）的輸入 XYZ 必須連接到 O-type 運算子，例如 NOP。」原因是放置在階層方塊中的某些 M-type 運算子無法直接連接到階層方塊的輸入連接埠。這僅適用於某些特定的 M-type 運算子。 |
| 因應措施： | 您可以在階層式方塊內放置 NOP 運算子（介於階層式方塊的輸入連接埠與 M 型運算子的輸入連接埠之間），以解決此問題。 |
| 問題單 ID： | – |
| 摘要： | 使用逐行 1D 模擬模式時發生設計規則檢查錯誤 |
|---|---|
| 描述： | 對於在較舊版本 VisualApplets 中通過 Design Rules Check 的某些設計，可能會回報有關最大影像高度的連結錯誤。特別是，當涉及 1D 處理且啟用新的逐行模擬模式（預設）時，可能會發生這種情況。原因是在逐行模擬模式下，某些 Operator 將輸入連結的最大影像高度傳播到輸出連結的方式與以前不同。 |
| 因應措施： | 您透過切換至舊版模擬模式或新增 SetDimension 模組來調整最大影像高度值，即可解決此問題。 |
| 問題單 ID： | – |
| 摘要： | 使用逐行 1D 模擬模式時作業時間增加 |
|---|---|
| 描述： | 對於某些設計，模擬的運作時間可能會比舊版 VisualApplets 長得多。特別是當涉及 1D 處理、啟用新的逐行模擬模式（預設）且設計包含許多模擬探針時，可能會發生這種情況。 |
| 因應措施： | 您切換至舊版模擬模式或減少模擬探測器的數量，即可解決此問題。 |
| 問題單 ID： | – |
| 摘要： | 適用於 CXP 的 SDK：對 SISO_GenICam Library 的存取必須由使用者進行程式設計 |
|---|---|
| 描述： | 適用於 CXP 的 SDK：對 SISO_GenICam 程式庫的存取不會自動產生，必須由使用者進行程式設計。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
| 摘要： | 提高 FPGA 設計時脈頻率可能會導致建置緩慢 |
|---|---|
| 描述： | 提高 FPGA 設計時脈頻率可能會導致建置流程花費很長時間，甚至因為無法滿足時序限制而失敗。這很大程度上取決於 VisualApplets 設計的內容。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 8513 |
| 摘要： | 大影像無法顯示在模擬探測器中 |
|---|---|
| 描述： | 當模擬探測器包含非常大的影像時，VisualApplets 可能會因 Memory 限制而無法正確顯示這些影像。在這種情況下，會顯示灰階影像（即所有像素的值皆為 205 (0xCD)）。 |
| 因應措施： | 請使用較小的影像進行模擬。 |
| 問題單 ID： | 6822 |
| 摘要： | 模擬僅支援小於 2 GB 的影像 |
|---|---|
| 描述： | 在模擬期間，任何影像的內部緩衝區大小限制為 2 GB。若要進行大於 2 GB 的影像模擬，模擬將會停止並顯示錯誤訊息。 |
| 因應措施： | 請使用小於 2 GB 的影像進行模擬。 |
| 問題單 ID： | 240989 |
| 摘要： | 載入至 Simulation Probe Viewer 中的 RGB 影像可能會被儲存為單色影像（8 位元） |
|---|---|
| 描述： | 在 Simulation Probe Viewer 中，各個顏色通道包含相同數值的 RGB 影像會被儲存為單色影像（即 8 位元影像），而不是 24 位元影像。 |
| 因應措施： | 若要保留色頻，請以 BMP 檔案格式儲存您的影像。 |
| 問題單 ID： | 266977 |
| 摘要： | VisualApplets 可能會在模擬特定類型的 TIF 影像時當機 |
|---|---|
| 描述： | VisualApplets 可能會在模擬特定類型的 .tif 影像時當機。 |
| 因應措施： | 請使用其他影像工具重新儲存 .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。因此，建置 VisualApplets 設計無法搭配 Xilinx ISE 運作。 |
| 因應措施： | 如果您想要為需要使用 Xilinx ISE 建置的平台建立 Applet，請在 Windows 10 下安裝 VisualApplets。如果您的目標平台支援 Vivado，請使用 Xilinx Vivado 建置 Applet（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 或更高版本建置。 |
| 因應措施： | 請使用 Vivado 2023.2 為 imaFlex 2 Dual 100 以外的所有平台建置 Applet。 |
| 問題單 ID： | 341684 / 348084 |
| 摘要： | 無法使用某些 Xilinx Vivado 版本為 mE 5 marathon VCL 和 mE 5 marathon VCLx 平台建置 Applet |
|---|---|
| 描述： | 無法使用 2020.2 到 2021.1 之間的 Vivado 版本為 microEnable 5 marathon VCL 和 microEnable 5 marathon VCLx 平台建置 Applet。 |
| 因應措施： | 此問題已在 Xilinx Vivado 2021.2 版本中修正。因此，為避免此問題，請使用 Vivado 2021.2 或更高版本。 |
| 問題單 ID： | 217879 |
| 摘要： | 建置 Applet 時發生 Xilinx Vivado 警告 |
|---|---|
| 描述： | 當您使用 Xilinx Vivado 工具建置 Applet 時，可能會收到嚴重警告（在 LinkDesign 建置步驟期間）。這些警告是由 Xilinx 工具鍊中的問題所引起的。Xilinx 已知悉此問題，目前正在修復中。範例： |
| 因應措施： | 請忽略這些警告。此問題對於在 VisualApplets 中建立的設計並不嚴重。 |
| 問題單 ID： | – |
Library Blob#
BlobDetector1D Operator#
| 摘要： | BlobDetector1D 在逐行模式 (Line-by-Line Mode) 下模擬時可能會遺失資料 |
|---|---|
| 描述： | 當 BlobDetector1D operator 用於逐行模式 (line-by-line mode) 時，如果下游 operators 引入了背壓 (back-pressure)（例如使用 SplitLine 運算子。此問題僅限於模擬，不會影響產生的硬體設計之行為。 |
| 因應措施： | 請在硬體上驗證設計行為。或者，將 VisualApplets 更新至 3.8.0 或更新版本，此問題已在該版本中修正。 |
| 問題單 ID： | 364374 |
Blob_Analysis_1D Operator#
| 摘要： | 影像 Blob_Analysis_1D 運算子設定 object size exceeds maximum 旗標未如預期運作 |
|---|---|
| 描述： | 如果物件因超出最大尺寸而遭到截斷，該尺寸是由 max_object_height_bits 參數所定義的最大大小而被截斷，則對應的 object size exceeds maximum 旗標設定在截斷的物件中，而不是前一個物件中。 |
| 因應措施： | 請改用新的 BlobDetector1D 運算子。此問題已在新運算子中獲得解決。 |
| 問題單 ID： | 9685 |
| 摘要： | 影像 Blob_Analysis_1D 運算子未設定 label overflow Flag |
|---|---|
| 描述： | 影像 label overflow 指出所有標籤均在使用中且目前的物件無法加上標籤的旗標，絕不會被設定。 |
| 因應措施： | 請改用新的 BlobDetector1D 運算子。此問題已在新運算子中獲得解決。 |
| 問題單 ID： | 9691 |
| 摘要： | 影像 Blob_Analysis_1D 運算子允許每行比定義少 20 個標籤 |
|---|---|
| 描述： | 可用標籤的數量是由 Label_bits 參數定義的可用標籤數量減少了 20 個標籤。例如，如果 Label_bits 設定為 5 時，只有 12 個 (2^5 - 20) 標籤可用，而不是預期的 32 個 (2^5)。 |
| 因應措施： | 請改用新的 BlobDetector1D 運算子。此問題已在新運算子中獲得解決。 |
| 問題單 ID： | 9688 |
| 摘要： | 模擬 Blob_Analysis_1D 運算子與硬體行為不符 |
|---|---|
| 描述： | 物件特徵輸出的順序在硬體和軟體中可能會有所不同。這是因為硬體輸出取決於資料的時間點，而這在 VisualApplets 中是無法模擬的。此外，FlushI 輸入相對於影像資料輸入是非同步的，因此可能無法以真實的方式模擬完成輸出影格。 |
| 因應措施： | 請改用新的 BlobDetector1D 運算子。此問題已在新運算子中獲得解決。 |
| 問題單 ID： | 7709 |
Library Color#
| 摘要： | 某些色彩轉換無法如預期運作 |
|---|---|
| 描述： | 以下圖庫的運算子 彩色 應謹慎使用：某些色彩轉換的運作方式可能不符合使用者的預期：
|
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
ColorTransform Operator#
| 摘要： | 負轉換係數的限制 |
|---|---|
| 描述： | 影像 ColorTransform 運算子僅在輸入格式為有號 (signed) 或係數為靜態的情況下，才支援負轉換係數。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 251344 |
BAYER5x5Linear Operator#
| 摘要： | VisualApplets 中的資源估算 BAYER5x5Linear 與 Xilinx 中的估算不同 |
|---|---|
| 描述： | BAYER5x5Linear: 在某些情況下，VisualApplets 中此運算子的資源估算（在 FPGA Resource Usage 對話方塊）可能會與 Place & Route 之後 Xilinx 工具所顯示的估算值有所不同。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 6426 |
Library Compression#
JPEG_Encoder Operator#
| 摘要： | 該 JPEG_Encoder Operator 的輸出傳輸早於實際的影像資料傳輸 |
|---|---|
| 描述： | Operator：為了最佳化其影像產出率（頻寬），該 operator 一旦啟用標頭產生功能便會輸出標頭，甚至在影像資料抵達 operator 輸入端之前就開始輸出。透過這種方式，標頭資料的傳輸不會中斷影像資料的傳輸，因為標頭是提前傳輸的。此做法的缺點是，operator 的輸出傳輸開始時間早於實際的影像資料傳輸。在特定情況下，這可能會引起混淆： 如果您使用的是 SourceSelector operator 直接在 JPEG_Encoder之後： SourceSelector operator 一取得標頭資料，就會將部分處理過的影格登記起來。因此，如果 SourceSelector 切換為從以下來源取得影像資料 JPEG_Encoder, SourceSelector 無法切換至任何其他來源，因為它總是偵測到未完成的影格。此外，當啟用標頭產生且 SourceSelector 從其他來源切換至 JPEG_Encoder 通道時，第一張影像會遺失。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
Library Filter#
FIRKernelNxM Operator#
| 摘要： | FIRKernelNxM Operator 可能會導致處理錯誤 |
|---|---|
| 描述： | 影像 FIRKernelNxM operator 在 EdgeHandling 參數設為常數（constant）、行數 > 2*Parallelism、kernel 欄數為偶數，且 Parallelism > 1。此錯誤可在影像的左邊界進行監控，此處在畫面內部的 kernel 位置使用了錯誤的像素資料。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 2939 |
Library Hardware Platforms#
CoFCamera Operator (僅限 imaFlex 2 Dual 100)#
| 摘要： | 針對使用兩個的 imaFlex 2 Dual 100 設計，DRC2 回報一般網路表產生錯誤 CoFCamera 模組 |
|---|---|
| 描述： | 當兩個 CoFCamera 模組用於 imaFlex 2 Dual 100 設計中時，DRC2 可能會回報一般網路表產生錯誤。該設計仍然可以建置，但產生的硬體設計可能無法正常運作。 |
| 因應措施： | 請將 VisualApplets 更新至 3.8.0 或更新版本，此問題已在該版本中修正。 |
| 問題單 ID： | 366304 |
Trigger Operators#
| 摘要： | 觸發運算子可能會在觸發輸出線上產生突波 |
|---|---|
| 描述： | 將 applet 載入擷取卡期間的初始化階段，觸發運算子可能會在觸發輸出線上造成突波。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
ImageBufferMultiRoiDyn Operator#
| 摘要： | 小影像的時序錯誤 |
|---|---|
| 描述： | 影像 ImageBufferMultiRoiDyn operator 在輸入影像非常小的情況下可能會導致時序錯誤。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
Library Memory#
| 摘要： | 在 mE6 平台上為緩衝區運算子啟用 WritePriority 模式時會降低傳輸量 |
|---|---|
| 描述： | 在 mE6 硬體平台上，為 Memory Library 中的緩衝區運算子啟用 WritePriority 模式會降低最高可達到的資料傳輸量。此模式使用效率較低的 DRAM 存取仲裁策略，導致整體介面效能降低。 |
| 因應措施： | 停用 WritePriority 除非應用程式有所要求，否則請使用此模式。 |
| 問題單 ID： | 366936 |
LUT-based Operators#
| 摘要： | 從文字檔案匯入的大整數數值可能會遺失精度 |
|---|---|
| 描述： | 從文字檔案將包含超過 53 個位元的整數數值匯入整數欄位參數時，某些最低有效位元可能會遺失。因此，匯入的數值可能會被四捨五入，並可能與檔案中指定的數值不同。這可能會影響 LUT-based operators 和其他支援整數數值檔案匯入的運算子，但僅會發生在 VisualApplets 中。在執行時期，這些數值會被正確載入。 |
| 因應措施： | 請確保匯入的整數數值不超過 53 個位元。或者，將 VisualApplets 更新至版本 3.8.0 或更新版本，該問題已在其中獲得修復。 |
| 問題單 ID： | 363933 |
LineBuffer imaFlex 2 Dual 100 上的運算子#
| 摘要： | LineBuffer Operator May Exhibit Reduced Throughput on imaFlex 2 Dual 100 |
|---|---|
| 描述： | On the imaFlex 2 Dual 100 hardware platform, the LineBuffer operator may exhibit reduced performance depending on the timing characteristics of the incoming data stream. In the worst case, the maximum achievable bandwidth can decrease by up to 50%. |
| 因應措施： | Insert a sufficiently large FIFO upstream of the LineBuffer operator to absorb timing variations in the input stream. |
| 問題單 ID： | 366936 |