VisualApplets Release 3.3.2 已知問題
資訊
雖然 VisualApplets 3.3.2 的 Update 2301 允許在 Windows 11 中使用 VisualApplets，但在某些 Vivado 安裝中，建置流程可能會在 Design-Rules-Check-2 步驟後停止，並顯示錯誤訊息 Error: -1 Error checking FPGA software。如果您遇到此問題，請修改您的建置設定，以便不啟用先決條件檢查。
資訊
如果您在安裝了 Xilinx Vivado 2017.2 或 2017.3 版本的電腦上安裝 Windows 10 Fall Creators 更新（版本 1709），Xilinx Vivado 可能無法正常運作。因此，您可能無法建置使用 VisualApplets 建立的設計。
請遵循 Xilinx Support 提供的因應措施，使您的 Xilinx Vivado 2017.2 或 2017.3 安裝恢復正常運作。
資訊
如果您安裝上述 Windows 10 更新，使用舊於 Vivado 2017.4 的 Xilinx 工具時，建置流程可能無法正常運作。因此，您可能無法建置使用 VisualApplets 建立的設計。
對於舊於 Vivado 2017.4 的 Vivado 版本，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 directory <VivadoInstallDir>/ids_lite/ISE/lib/nt64.
一般資訊
| 摘要： | 包含以下內容的 Tcl 指令碼 Color Flavor 數值 LAB, XYZ, HSL, HSV或 YCrCb 會在匯入期間造成錯誤 |
| 描述： | 當將設計匯出至包含以下內容的 Tcl 指令碼時 Color Flavor 值 LAB, XYZ, HSL, HSV或 YCrCb 在 link properties 中，從指令碼匯入設計會導致錯誤。 |
| 因應措施： | 此問題已在 VisualApplets 3.4.0 中修正。請將您的 VisualApplets 版本更新至 3.4.0 |
| 問題單 ID： | 258727 |
| 摘要： | 載入 TIF 格式的小型影像會導致 Image Magick 錯誤 |
| 描述： | 載入 TIF 格式的小型影像有時會失敗，並顯示錯誤訊息 Image Magick library: Image format is not supported. Error code: -70002。 |
| 因應措施： | 在 VisualApplets System Settings 中，將 I/O Image Library 設定為 Native，而不是 Image Magick。或者將您的 VisualApplets 版本更新至 3.4.0。 |
| 問題單 ID： | 265278 |
| 摘要： | VisualApplets 有時無法偵測 Vivado 版本號碼 |
| 描述： | 如果您使用 Vivado 2023.1 或更高版本建置 applet，VisualApplets 將無法偵測 Vivado 版本號碼。 |
| 因應措施： | 請將您的 VisualApplets 版本更新至 3.4.0，或修補檔案 vivado.bat 在您的 Vivado 安裝中，於以下內容之後直接插入下列幾行 @echo off:
if "%1"=="-version" (
goto returnVersionInfo
) else (
goto proceed
)
:returnVersionInfo
echo Vivado v2023.1 (64-bit)
:proceed |
| 問題單 ID： | 285232 |
| 摘要： | Xilinx ISE 建置工具鏈不支援 Windows 11 |
| 描述： | Xilinx ISE 建置工具鏈不支援 Windows 11。因此，無法使用 Xilinx ISE 建置 VisualApplets 設計。 |
| 因應措施： | 如果您想要為需要透過 Xilinx ISE 建置的平台建置 applet，請在 Windows 10 或 8.1 下安裝 VisualApplets。如果您的目標平台支援 Vivado，請使用 Xilinx Vivado 建置 applet（Vivado 支援 Windows 11）。請參閱系統需求以了解 Vivado 支援哪些平台。 |
| 問題單 ID： | 236990 |
| 摘要： | 無法使用特定的 Xilinx Vivado 版本建置適用於 mE5-CL Platforms 的 Applet |
| 描述： | 無法使用 2020.2 到 2021.1 之間的 Vivado 版本建置適用於 mE5-CL platforms 的 applet。 |
| 因應措施： | 此問題已在 Xilinx Vivado 2021.2 版本中修正。因此，為避免此問題，請使用 Vivado 2021.2 或更高版本。 |
| 問題單 ID： | 217879 |
| 摘要： | 在 Windows 8 上，您必須將使用者目錄定義為目標目錄 |
| 描述： | 在 Microsoft Windows 8 上，您必須將使用者目錄定義為目標目錄。或者，也可以使用任何其他具有完整存取權限的目錄。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
| 摘要： | 當將設計轉換為不同的硬體平台時，硬體相依的 operator 庫可能無法使用 |
| 描述： | 當將 VisualApplets 設計轉換為不同的硬體平台時，在某些情況下，目標平台的硬體相依 operator 庫可能無法使用。 |
| 因應措施： | 若要解決此問題，請重新啟動 VisualApplets。 |
| 問題單 ID： | – |
| 摘要： | 您需要在發生模擬錯誤後重設模擬條件 |
| 描述： | 發生模擬錯誤後，需要重設模擬條件 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
| 摘要： | 建置 Applet 時發生 Xilinx Vivado 警告 |
| 描述： | 當您使用 Xilinx Vivado Tools 建置 Applet 時，可能會收到嚴重警告（在建置步驟 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 results 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-Type 運算子直接連接到輸入連接埠時發生設計規則檢查錯誤 |
| 描述： | 如果您使用階層方塊，在某些特定情況下，Design Rules Check 可能會出現以下錯誤訊息：「運算子 ABC（階層方塊）的輸入 XYZ 必須連接到 O-type 運算子，例如 NOP。」原因是放置在階層方塊中的某些 M-type 運算子無法直接連接到階層方塊的輸入連接埠。這僅適用於某些特定的 M-type 運算子。 |
| 因應措施： | 您可以在階層式方塊的輸入連接埠與 M 型運算子的輸入連接埠之間放置一個 NOP 運算子來解決此問題（在階層式方塊內）。 |
| 問題單 ID： | – |
| 摘要： | 使用逐行 1D 模擬模式時發生設計規則檢查錯誤 |
| 描述： | 對於在舊版 VisualApplets 中通過 Design Rules Check 的某些設計，可能會回報有關 max. image height 的連結錯誤。特別是在涉及 1D 處理且啟用新的逐行模擬模式（預設）時，可能會發生這種情況。原因是在逐行模式下，某些運算子將輸入連結的 max. image height 傳播到輸出連結的方式與以前不同。 |
| 因應措施： | 您切換至舊版模擬模式或新增用於調整 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 可能會因 Memory 限制而無法正確顯示這些影像。在這種情況下，會顯示灰階影像（即所有像素的值皆為 205 (0xCD)）。 |
| 因應措施： | 請使用較小的影像進行模擬。 |
| 問題單 ID： | 6822 |
| 摘要： | 模擬僅支援小於 2 GB 的影像 |
| 描述： | 在模擬期間，任何影像的內部緩衝區大小限制為 2 GB。若要進行大於 2 GB 的影像模擬，模擬將會停止並顯示錯誤訊息。 |
| 因應措施： | 請使用小於 2 GB 的影像進行模擬。 |
| 問題單 ID： | 240989 |
Library Blob
Operator Blob_Analysis_1D
| 摘要： | 運算子 Blob_Analysis_1D 設定旗標 object size exceeds maximum 不如預期 |
| 描述： | 如果物件因超出參數所定義的最大尺寸而被截斷 max_object_height_bits，則會在截斷的物件中設定對應的旗標 object size exceeds maximum 設定在被截斷的物件中，而不是在前面的物件中。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 9685 |
| 摘要： | 運算子 Blob_Analysis_1D 未設定旗標 label overflow |
| 描述： | 旗標 label overflow 表示所有標籤均已在使用中且目前的物件無法被標記，此旗標從未被設定。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 9691 |
| 摘要： | 運算子 Blob_Analysis_1D 每行允許少 20 個定義的標籤 |
| 描述： | 透過參數定義的可用標籤數量 Label_bits 減少 20 個標籤。例如，如果 Label_bits 設定為 5 時，只有 12 個 (2^5 - 20) 標籤可用，而不是預期的 32 個 (2^5)。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 9688 |
| 摘要： | 運算子的模擬 Blob_Analysis_1D 與硬體行為不符 |
| 描述： | 物件特徵輸出的順序在硬體和軟體中可能會有所不同。這是因為硬體輸出取決於資料的時間點，而這在 VisualApplets 中是無法模擬的。此外，FlushI 輸入相對於影像資料輸入是非同步的，因此可能無法以真實的方式模擬完成輸出影格。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 7709 |
Library Color
| 摘要： | 某些色彩轉換無法如預期運作 |
| 描述： | 以下圖庫的運算子 彩色 應謹慎使用：某些色彩轉換的運作方式可能不符合使用者的預期：
- HSI2RGB 將 HSL 轉換為 RGB，
- RGB2YUV 將 RGB 轉換為 YCbCr，
- XYZ2LAB 根據以下定義使用常數：www.easyrgb.com
|
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
| 摘要： | 負轉換係數的限制 |
| 描述： | Operator ColorTransform 僅在輸入格式為帶號 (signed) 或係數為靜態的情況下支援負轉換係數。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 251344 |
Operator BAYER5x5Linear
| 摘要： | VisualApplets 中的資源估算 BAYER5x5Linear 與 Xilinx 中的估算不同 |
| 描述： | BAYER5x5Linear：在某些情況下，VisualApplets 中此運算子的資源估算（於對話方塊 FPGA Resource Usage) 可能與 Xilinx 工具在進行 Place & Route 後所顯示的估算結果不同。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 6426 |
Library Compression
Operator JPEG_Encoder
| 摘要： | 運算子的輸出傳輸 JPEG_Encoder 早於實際的影像資料傳輸開始 |
| 描述： | Operator : 為了最佳化影像輸貫量（頻寬），運算子會在啟動標頭產生時立即輸出標頭 - 甚至在影像資料抵達運算子輸入端之前。如此一來，標頭資料的傳輸就不會中斷影像資料的傳輸，因為標頭是提前傳輸的。此做法的缺點是運算子的輸出傳輸會早於實際的影像資料傳輸開始。在特定情況下，這可能會引起困擾：
如果您使用的是運算子 SourceSelector 之後使用運算子 JPEG_Encoder：運算子 SourceSelector 一取得標頭資料就會註冊部分處理的影格。因此，如果 SourceSelector 切換為從以下來源取得影像資料 JPEG_Encoder, SourceSelector 無法切換至任何其他來源，因為它總是偵測到未完成的影格。此外，當啟用標頭產生且 SourceSelector 從其他來源切換至 JPEG_Encoder 通道時，第一張影像會遺失。 |
| 因應措施： | 如果在 eVA 裝置上運作，請確保輸出能夠在感測器傳輸開始之前接收資料傳輸。 |
| 問題單 ID： | – |
Library Debugging
Operator ImageFlowControl
| 摘要： | 發生溢位狀況後的受損畫格 |
| 描述： | 使用 operator ImageFlowControl 在虛擬影格 (dummy frame) 產生模式下可能會導致輸出的影格受損。這發生在發生溢位情況之後，當發出一系列虛擬影格來補償遺失的影格時。 |
| 因應措施： | 將 VisualApplets 更新至版本 3.6.0。此問題已在 VisualApplets 3.6.0 版本中修正。 |
| 問題單 ID： | 248227 |
Library Filter
Operator FIRKernelNxM
| 摘要： | Operator FIRKernelNxM 可能會導致處理錯誤 |
| 描述： | 操作員 FIRKernelNxM 在參數情況下可能會導致處理錯誤 EdgeHandling 設為常數、欄數 > 2*Parallelism、核心欄數為偶數，且 Parallelism > 1，可能會導致處理錯誤。此錯誤可在影像的左邊界進行監控，該處在影格內部的核心位置使用了錯誤的像素資料。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 2939 |
Trigger Operators
| 摘要： | 觸發運算子可能會在觸發輸出線上產生突波 |
| 描述： | 將 applet 載入擷取卡期間的初始化階段，觸發運算子可能會在觸發輸出線上造成突波。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
Library Memory
Operator ImageBufferMultiRoiDyn
| 摘要： | 小影像的時序錯誤 |
| 描述： | 操作員 ImageBufferMultiRoiDyn 在輸入影像非常小的情況下，可能會導致時序錯誤。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | – |
Operator ImageSequence
| 摘要： | 由運算子引起的建置錯誤 ImageSequence |
| 描述： | 操作員 ImageSequence 可能會導致建置錯誤（時序錯誤）。 |
| 因應措施： | 沒有可用的因應措施。 |
| 問題單 ID： | 2422 |