已知問題：VisualApplets 版本 3.3.2
資訊
雖然「VisualApplets 3.3.2」的更新 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 支援提供的因應措施，使您的 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 在連結屬性中，從腳本匯入設計會導致錯誤。 |
| 因應措施： | 此問題已在VisualApplets 3.4.0 中修復。請將您的VisualApplets 版本更新至 3.4.0 |
| 工單 ID： | 258727 |
| 摘要： | 載入 TIF 格式的小型圖片會導致 ImageMagick 發生錯誤 |
| 說明： | 載入TIF格式的小型圖片時，有時會失敗並顯示錯誤訊息：「ImageMagick 函式庫：不支援此圖片格式。錯誤代碼：-70002。」 |
| 因應措施： | 在VisualApplets 系統設定中，將「I/O 影像庫」設定為「原生」，而非「ImageMagick」。或者將您的VisualApplets 版本更新至 3.4.0。 |
| 工單 ID： | 265278 |
| 摘要： | VisualApplets 有時無法偵測到 Vivado 的版本號 |
| 說明： | 若您使用 Vivado 2023.1 或更高版本建立小程式，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 進行建置的平台建立小程式，請在Windows 10或8.1上安裝VisualApplets 。若您的目標平台受Vivado支援，請使用Xilinx Vivado來建置小程式（Vivado支援Windows 11）。請參閱系統需求，了解Vivado支援哪些平台。 |
| 工單 ID： | 236990 |
| 摘要： | mE5-CL 平台的 Applet 無法使用特定 Xilinx Vivado 版本建構 |
| 說明： | mE5-CL 平台的 Applet 無法使用 2020.2 至 2021.1 之間的 Vivado 版本建構。 |
| 因應措施： | 此問題已在 Xilinx Vivado 2021.2 版本中修正。因此，為避免此問題，請使用 Vivado 2021.2 或更高版本。 |
| 工單 ID： | 217879 |
| 摘要： | 在Windows 8 上，您必須將使用者目錄設定為目標目錄 |
| 說明： | 在 MicrosoftWindows 8 上，您必須將使用者目錄設定為目標目錄。此外，亦可使用任何具備完全存取權限的其他目錄。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | – |
| 摘要： | 將設計轉換至不同的硬體平台時，硬體相關的運算子庫可能無法使用 |
| 說明： | 將 VisualApplets 設計轉換為不同的硬體平台時，在某些情況下，目標平台的硬體相依算子庫可能無法使用。 |
| 因應措施： | 若要解決此問題，請重新啟動 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 型運算子直接連接到輸入連接埠時發生設計規則檢查錯誤 |
| 說明： | 如果您使用階層式方塊，在某些特定情況下，Design Rules Check 可能會出現以下錯誤訊息：「運算子 ABC（階層式方塊）的輸入 XYZ 必須連接到 O 型運算子，例如 NOP。」原因是因為放置在階層式方塊內的某些 M 型運算子無法直接連接到階層式方塊的輸入連接埠。這僅適用於某些特定的 M 型運算子。 |
| 因應措施： | 您可以透過在階層式方塊的輸入連接埠與 M 型算子的輸入連接埠之間放置 NOP 算子來解決此問題（在階層式方塊內）。 |
| 工單 ID： | – |
| 摘要： | 使用逐行 1D 模擬模式時發生設計規則檢查錯誤 |
| 說明： | 對於某些在舊版 VisualApplets 中通過 Design Rules Check 的設計，可能會回報關於最大影像高度的連結錯誤。特別是在涉及 1D 處理且啟用新的逐行模擬模式（預設）時，可能會發生這種情況。原因在於，在逐行模式下，某些算子將輸入連結的最大影像高度傳播到輸出連結的方式與以前不同。 |
| 因應措施： | 您可以透過切換至舊版模擬模式或新增 SetDimension 模組來調整最大影像高度值，藉此解決此問題。 |
| 工單 ID： | – |
| 摘要： | 使用逐行 1D 模擬模式時運作時間增加 |
| 說明： | 對於某些設計，模擬的運作時間可能會比舊版 VisualApplets 長得多。特別是在涉及 1D 處理、啟用新的逐行模擬模式（預設）且設計包含許多模擬探針時，可能會發生這種情況。 |
| 因應措施： | 您可以透過切換回舊版模擬模式或減少模擬探針的數量來解決此問題。 |
| 工單 ID： | – |
| 摘要： | CXP 專用 SDK：SISO_GenICam 庫的存取必須由使用者進行程式規劃 |
| 說明： | 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 Blob
運算子 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： | – |
| 摘要： | 負轉換係數的限制 |
| 說明： | 運算子 ColorTransform 僅在輸入格式為有符號，或係數為靜態時，才支援負的轉換係數。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | 251344 |
運算子 BAYER5x5Linear
| 摘要： | VisualApplets 中的資源估算 BAYER5x5Linear 與 Xilinx 中的估算不同 |
| 說明： | BAYER5x5Linear：在某些情況下，VisualApplets 中此運算子的資源估算（於對話框 FPGA Resource Usage) 可能與 Place & Route 之後 Xilinx 工具所顯示的估算不同。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | 6426 |
Library Compression
運算子 JPEG_Encoder
| 摘要： | 運算子的輸出傳輸 JPEG_Encoder 早於實際影像資料傳輸開始 |
| 說明： | Operator : 為了最佳化影像輸用率（頻寬），運算子會在啟動標頭產生後立即輸出標頭——甚至在影像資料到達運算子輸入端之前。透過這種方式，標頭資料的傳輸不會中斷影像資料的傳輸，因為標頭是提前傳輸的。此做法的缺點是運算子的輸出傳輸會早於實際影像資料傳輸開始。在特定情況下，這可能會引起混淆：
如果您正在使用運算子 SourceSelector 緊接在 JPEG_Encoder之後：運算子 SourceSelector 一取得標頭資料就會註冊部分處理的影格。因此，如果 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
運算子 FIRKernelNxM
| 摘要： | 運算子 FIRKernelNxM 可能會導致處理錯誤 |
| 說明： | 此運算子 FIRKernelNxM 可能會在參數情況下導致處理錯誤 EdgeHandling 設為常數、欄數 > 2*Parallelism、核心欄數為偶數且 Parallelism > 1 時，可能會導致處理錯誤。此錯誤可在影像的左邊框監控到，該處在畫面內的核心位置使用了錯誤的像素資料。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | 2939 |
觸發運算子
| 摘要： | Trigger Operators May Cause Spikes at the Trigger Output Line |
| 說明： | 將 applet 載入擷取卡期間的初始化階段，觸發運算子可能會在觸發輸出端產生突波。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | – |
Library Memory
運算子 ImageBufferMultiRoiDyn
| 摘要： | Timing Errors with Small Images |
| 說明： | 此運算子 ImageBufferMultiRoiDyn 在輸入影像極小時，可能會導致時序錯誤。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | – |
運算子 ImageSequence
| 摘要： | Build Errors Caused by the Operator ImageSequence |
| 說明： | 此運算子 ImageSequence 可能會導致建置錯誤（時序錯誤）。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | 2422 |