VisualApplets 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 必須連接到 O 型運算子，例如 NOP。」原因是因為放置在階層式方塊內的某些 M 型運算子無法直接連接到階層式方塊的輸入連接埠。這僅適用於某些特定的 M 型運算子。 |
| 因應措施： | 您可以透過在階層式方塊的輸入連接埠與 M 型運算子的輸入連接埠之間放置 NOP 運算子，來解決此問題（在階層式方塊內）。 |
| 工單 ID： | – |
| 摘要： | 使用逐行 1D 模擬模式時發生設計規則檢查錯誤 |
|---|---|
| 說明： | 對於在早期版本的 VisualApplets 中通過 Design Rules Check 的某些設計，可能會回報有關最大影像高度的連結錯誤。特別是，當涉及 1D 處理且啟用了新的逐行模擬模式（預設）時，可能會發生這種情況。原因是在逐行模式下，某些 operator 將輸入連結的最大影像高度傳播到輸出連結的方式與以前不同。 |
| 因應措施： | 您可以透過切換回舊版模擬模式或新增用於調整最大影像高度數值的 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 |
| 摘要： | 載入到模擬探針檢視器 (Simulation Probe Viewer) 中的 RGB 影像可能會被儲存為單色影像 (8 位元) |
|---|---|
| 說明： | 在模擬探針檢視器中，跨色彩頻道包含相同值的 RGB 影像會被儲存為單色影像（即 8 位元影像），而不是 24 位元影像。 |
| 因應措施： | 如果您想要保留通道，請以 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 平台的 Applet 無法使用特定 Xilinx Vivado 版本建構 |
|---|---|
| 說明： | mE5-CL 平台的 Applet 無法使用 2020.2 至 2021.1 之間的 Vivado 版本建構。 |
| 因應措施： | 此問題已在 Xilinx Vivado 2021.2 版本中修正。因此，為避免此問題，請使用 Vivado 2021.2 或更高版本。 |
| 工單 ID： | 217879 |
| 摘要： | 建置 Applet 時發生 Xilinx Vivado 警告 |
|---|---|
| 說明： | 當您使用 Xilinx Vivado 工具建置 applet 時，可能會收到嚴重警告（在 LinkDesign 建置步驟期間）。這些警告是由 Xilinx 工具鏈中的問題所引起的。Xilinx 已知悉此問題，並正在修復中。範例： |
| 因應措施： | 請忽略這些警告。此問題對於在 VisualApplets 中建立的設計並不嚴重。 |
| 工單 ID： | – |
Library Accumulator#
Histogram Operator#
| 摘要： | 連續相同像素值的 Histogram 結果不正確 |
|---|---|
| 說明： | 當連續的輸入像素具有相同數值時，「直方圖」運算子無法正常運作。在此類情況下，直方圖的計數可能會遺漏，導致結果不正確。 |
| 因應措施： | 升級至 VisualApplets 3.7.0 或更新版本；此問題已在該版本中修正。 |
| 工單 ID： | 353017 |
Library Blob#
Blob_Analysis_1D 運算子#
| 摘要： | 當 Blob_Analysis_1D 算子設定 object size exceeds maximum 旗標未如預期 |
|---|---|
| 說明： | 如果物件因超過所定義的最大大小而被截斷 max_object_height_bits 參數，對應的 object size exceeds maximum 旗標會設定在被截斷的物件中，而不是後續的物件中。 |
| 因應措施： | 請改用新的 BlobDetector1D 運算子。此問題已在新運算子中解決。 |
| 工單 ID： | 9685 |
| 摘要： | 當 Blob_Analysis_1D 算子未設定 label overflow 旗標 |
|---|---|
| 說明： | 當 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 運算子#
| 摘要： | 負轉換係數的限制 |
|---|---|
| 說明： | 當 ColorTransform 算子僅在輸入格式為有號數（signed）或係數為靜態的情況下，才支援負轉換係數。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | 251344 |
BAYER5x5Linear 運算子#
| 摘要： | VisualApplets 中的資源估算 BAYER5x5Linear 與 Xilinx 中的估算不同 |
|---|---|
| 說明： | BAYER5x5Linear：在某些情況下，VisualApplets 中此運算子的資源估算（在 FPGA Resource Usage 對話方塊中）可能與 Place & Route 之後 Xilinx 工具所顯示的估算不同。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | 6426 |
Library Compression#
JPEG_Encoder 運算子#
| 摘要： | 輸出傳輸 JPEG_Encoder 運算子啟動時間早於實際影像資料傳輸 |
|---|---|
| 說明： | 運算子：為了最佳化其影像產出率（頻寬），該運算子會在標頭產生啟動後立即輸出標頭——甚至在影像資料到達運算子輸入端之前。如此一來，標頭資料的傳輸就不會中斷影像資料的傳輸，因為標頭是提前傳輸的。此做法的缺點是運算子的輸出傳輸啟動時間早於實際的影像資料傳輸。這在特定情況下可能會造成困擾： 如果您正在使用 SourceSelector 運算子直接在 JPEG_Encoder: SourceSelector 運算子一旦取得標頭資料，就會將部分處理過的畫面註冊為已處理畫面。因此，如果 SourceSelector 切換為從以下來源取得影像資料 JPEG_Encoder, SourceSelector 無法切換到任何其他來源，因為它總是偵測到未完成的畫面。此外，當啟用標頭產生且 SourceSelector 從另一個來源切換至 JPEG_Encoder 通道時，第一張影像將會遺失。 |
| 因應措施： | 如果在 eVA 裝置上運作，請確保輸出能夠在感測器傳輸開始之前接受資料傳輸。 |
| 工單 ID： | – |
Library Filter#
FIRKernelNxM 運算子#
| 摘要： | FIRKernelNxM 運算子可能會導致處理錯誤 |
|---|---|
| 說明： | 當 FIRKernelNxM 若運算子發生處理錯誤的情況 EdgeHandling 參數設定為常數，欄數 > 2*Parallelism，核心欄數為偶數，且 Parallelism > 1。可以在影像的左邊界監控此錯誤，其中在畫面內的核心位置使用了錯誤的像素資料。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | 2939 |
程式庫硬體平台#
觸發運算子#
| 摘要： | Trigger Operators May Cause Spikes at the Trigger Output Line |
|---|---|
| 說明： | 將 applet 載入擷取卡期間的初始化階段，觸發運算子可能會在觸發輸出端產生突波。 |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | – |
ImageBufferMultiRoiDyn 運算子#
| 摘要： | Timing Errors with Small Images |
|---|---|
| 說明： | 當 ImageBufferMultiRoiDyn operator may cause timing errors in case of very small input images. |
| 因應措施： | 沒有可用的因應措施。 |
| 工單 ID： | – |
Library Memory#
基於 LUT 的運算子#
| 摘要： | 從文字檔案匯入的大型整數值可能會遺失精確度 |
|---|---|
| 說明： | 從文字檔案將包含 超過 53 位元的整數值匯入整數欄位引數時，某些最低有效位元可能會遺失。因此，匯入的值可能會被四捨五入，且可能與檔案中指定的值不同。這可能會影響基於 LUT 的運算子以及支援整數值檔案匯入的其他運算子，但僅會發生在 VisualApplets 中。在執行階段，這些值會被正確載入。 |
| 因應措施： | 請確保匯入的整數值不超過 53 位元。或者，將 VisualApplets 更新至 3.8.0 或更新版本，此問題已在該版本中修正。 |
| 工單 ID： | 363933 |
Library Synchronization#
IsLastPixel 運算子#
| 摘要： | 當 IsLastPixel 運算子錯誤地表示某張圖片為空 |
|---|---|
| 說明： | 當 IsEmpty 的輸出 IsLastPixel 當參數為 Mode 設為 Frame. 此問題同時影響模擬與硬體行為。在硬體方面，空幀可能會被錯誤地標記為非空幀；在模擬方面，非空幀可能會被錯誤地標記為空幀。 |
| 因應措施： | 請勿使用 IsEmpty 當……時產出 Mode = Frame. |
| 工單 ID： | 337672 |