VisualApplets 3.7.0 版本中的已知問題#
一般資訊#
| 摘要： | 對於 mE5 平台和 imaFlex 平台，資源估算值可能過低 |
|---|---|
| 說明： | 對於 mE5 和 imaFlex 平台，某些運算子的資源估算（即 Blob 進行明確的生命週期管理即呼叫 Histogram) 可能會低估已使用的區塊 RAM 數量。視模組配置而定，區塊 RAM 資源的實際使用量可能比估算值高出 50% 以上。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | 297790 |
| 摘要： | 無法透過剪貼簿複製內容 |
|---|---|
| 說明： | 無法透過剪貼簿（複製與貼上）將在此版本的VisualApplets 中開啟的設計內容，複製到VisualApplets 3.3.2 或更早版本中開啟的設計中。不過，從任何版本的VisualApplets 複製到此版本則是可行的。 |
| 解決方法： | 請將您的設計儲存為舊版*.va檔案格式，在較舊版本的VisualApplets 中開啟該檔案，並從中複製內容。 |
| 票務編號： | – |
| 摘要： | 將設計轉換至不同的硬體平台時，可能無法取得依賴硬體的操作子函式庫 |
|---|---|
| 說明： | 在將VisualApplets 設計轉換至其他硬體平台時，在某些情況下，目標平台的硬體相關運算子函式庫可能無法取得。 |
| 解決方法： | 要解決此問題，請重新啟動VisualApplets 。 |
| 票務編號： | – |
| 摘要： | *.va 檔案名稱僅支援 ASCII 字元 |
|---|---|
| 說明： | 在為*.va檔案命名時，僅可使用基於 ASCII 字元的字型；這表示，例如亞洲、西里爾、希臘或阿拉伯字型均不支援用於檔案名稱。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | – |
| 摘要： | 當層級框中的 M 型運算子直接連接至輸入埠時，會發生設計規則檢查錯誤 |
|---|---|
| 說明： | 若您使用階層式方塊，在某些特定情況下，設計規則檢查可能會顯示以下錯誤訊息：「運算子 ABC（階層式方塊）的輸入端 XYZ 必須連接至 O 型運算子，例如 NOP。」 原因在於，某些置於階層式方塊內的 M 型運算子無法直接連接至該階層式方塊的輸入埠。此限制僅適用於特定類型的 M 型運算子。 |
| 解決方法： | 您可以在（階層化方塊內）透過在階層化方塊的輸入埠與 M 型運算子的輸入埠之間插入一個 NOP 運算子，來解決這個問題。 |
| 票務編號： | – |
| 摘要： | 使用逐行一維模擬模式時出現的設計規則檢查錯誤 |
|---|---|
| 說明： | 對於某些在VisualApplets 早期版本中通過「設計規則檢查」的設計，系統可能會報告與最大影像高度相關的連結錯誤。特別是當涉及一維處理，且啟用了新的逐行模擬模式（預設）時，可能會發生此情況。原因在於，在逐行模式下，某些運算子將輸入連結的最大影像高度傳遞至輸出連結的方式，與先前不同。 |
| 解決方法： | 您可以透過切換至傳統模擬模式，或新增「SetDimension」模組來調整最大影像高度值，藉此解決此問題。 |
| 票務編號： | – |
| 摘要： | 使用逐行一維模擬模式時，運作時間會增加 |
|---|---|
| 說明： | 對於某些設計，模擬的執行時間可能會比《VisualApplets 》的早期版本長得多。特別是當涉及一維處理、啟用了新的逐行模擬模式（預設設定），且設計中包含大量模擬探針時，可能會發生這種情況。 |
| 解決方法： | 您可以透過切換至傳統模擬模式，或減少模擬探針的數量來解決此問題。 |
| 票務編號： | – |
| 摘要： | CXP 開發套件 (SDK)：使用者必須自行編寫程式來存取 SISO_GenICam 函式庫 |
|---|---|
| 說明： | CXP 的 SDK：對 SISO_GenICam 程式庫的存取不會自動產生，必須由使用者進行程式設計。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | – |
| 摘要： | 提高 FPGA 設計時脈頻率可能會導致建置速度變慢 |
|---|---|
| 說明： | 提高 FPGA 設計的時脈頻率，可能會導致建置流程耗時甚久，甚至因無法滿足時序約束而失敗。這在很大程度上取決於VisualApplets 設計的內容。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | 8513 |
| 摘要： | 模擬探針中不會顯示大圖像 |
|---|---|
| 說明： | 當模擬探針包含非常大的影像時，由於記憶體限制，VisualApplets 可能無法正確顯示這些影像。在這種情況下，系統會顯示一張灰階影像（即所有像素的值皆為 205（0xCD））。 |
| 解決方法： | 在模擬時請使用較小的圖片。 |
| 票務編號： | 6822 |
| 摘要： | 模擬功能僅支援小於 2 GB 的圖片 |
|---|---|
| 說明： | 在模擬過程中，任何影像的內部緩衝區大小均限制為 2 GB。若模擬所使用的影像大於 2 GB，系統將顯示錯誤訊息並中止模擬。 |
| 解決方法： | 進行模擬時，請使用小於 2 GB 的影像檔案。 |
| 票務編號： | 240989 |
| 摘要： | 載入至模擬探針檢視器的 RGB 影像可能會被儲存為單色影像（8 位元） |
|---|---|
| 說明： | 在「模擬探針檢視器」中，各色彩通道值均相同的 RGB 影像會以單色影像（即 8 位元影像）的形式儲存，而非 24 位元影像。 |
| 解決方法： | 若要保留通道，請將圖片儲存為BMP檔案格式。 |
| 票務編號： | 266977 |
| 摘要： | VisualApplets 在模擬過程中，若使用特定類型的 TIF 影像，可能會導致程式當機 |
|---|---|
| 說明： | VisualApplets 在模擬過程中，若使用特定類型的.tif圖像，系統可能會當機。 |
| 解決方法： | 請使用其他影像處理工具重新儲存該.tif影像。或者，將VisualApplets 更新至 3.8.0 或更新版本，該版本已修正此問題。 |
| 票務編號： | 368717 |
Xilinx#
| 摘要： | 使用 Vivado 建置 imaFlex 設計時，可能會在「最佳化」步驟中失敗 |
|---|---|
| 說明： | 偶爾，使用 Vivado 建置 imaFlex 設計時，會在「最佳化」步驟中發生失敗。此問題可透過重新執行建置流程來解決。 |
| 解決方法： | 請重新執行建置程序。請盡可能將建置目錄的路徑設定得盡可能短。您可以在「系統設定」對話方塊的「全域建置」類別 >「設定建置小程式的路徑」中，明確設定建置目錄。 |
| 票務編號： | 341870 |
| 摘要： | Xilinx ISE 建置工具鏈不支援Windows s 11 |
|---|---|
| 說明： | Xilinx 的ISE建置工具鏈不支援Windows 11。因此，無法使用Xilinx 的ISE來建置VisualApplets 設計。 |
| 解決方法： | 若您想為需透過Xilinx ISE 進行編譯的平台建置 Applet，請在Windows 10 環境下安裝VisualApplets 。若您的目標平台受 Vivado 支援，請使用Xilinx Vivado 來建置 Applet（Vivado 支援Windows 11）。有關 Vivado 所支援的平台，請參閱「系統需求」主題。 在這則論壇討論中，您可找到一些技巧，說明如何在Windows 11 環境下安裝 ISE，儘管這並非官方所支援的做法。 |
| 票務編號： | 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 除外）建置您的應用程式。 |
| 票務編號： | 341684 / 348084 |
| 摘要： | 無法使用某些版本的 Vivado（Xilinx ）為 mE 5marathon VCL 及 mE 5marathon VCLx 平台編譯 Applet |
|---|---|
| 說明： | 針對 microEnable 5marathon VCL 以及 microEnable 5marathon VCLx 等平台的 Applet，無法使用 2020.2 至 2021.1 之間的 Vivado 版本進行編譯。 |
| 解決方法： | 此問題已透過Xilinx 中的 Vivado 2021.2 版本修復。因此，為避免此問題，請使用 Vivado 2021.2 或更高版本。 |
| 票務編號： | 217879 |
| 摘要： | Xilinx 建置 Applet 時出現的 Vivado 警告 |
|---|---|
| 說明： | 當您使用Xilinx 的 Vivado 工具建置 Applet 時，可能會收到關鍵警告（發生於 LinkDesign 建置步驟期間）。這些警告是由於Xilinx 工具鏈中的問題所致。此問題已通報給Xilinx ，目前正在進行修復。範例： |
| 解決方法： | 請忽略這些警告。對於在VisualApplets 中建立的設計而言，此問題並不嚴重。 |
| 票務編號： | – |
Library Blob#
BlobDetector1D 運算子#
| 摘要： | BlobDetector1D 在逐行模擬過程中可能會遺失資料——Line Mode |
|---|---|
| 說明： | 當 BlobDetector1D 若在逐行模式下使用該運算子，當下游運算子產生背壓時（例如在使用 SplitLine 運算子。此問題僅限於模擬階段，不會影響所產生硬體設計的運作行為。 |
| 解決方法： | 請在硬體上驗證設計行為。或者，將VisualApplets 更新至 3.8.0 或更新版本，該版本已修正此問題。 |
| 票務編號： | 364374 |
Blob_Analysis_1D 運算子#
| 摘要： | 當 Blob_Analysis_1D 運算子 設定 object size exceeds maximum 標記「與預期不符」 |
|---|---|
| 說明： | 若某個物件因超過由 max_object_height_bits 參數，對應的 object size exceeds maximum 該標記設定於截斷的物件中，而非前一個物件中。 |
| 解決方法： | 請使用新的 BlobDetector1D 改用該運算子。此問題已在新版運算子中獲得解決。 |
| 票務編號： | 9685 |
| 摘要： | 當 Blob_Analysis_1D 運算子並未設定該 label overflow 旗幟 |
|---|---|
| 說明： | 當 label overflow 表示所有標籤均已使用且無法對當前物件進行標記的標誌，絕不會被設定。 |
| 解決方法： | 請使用新的 BlobDetector1D 改用該運算子。此問題已在新版運算子中獲得解決。 |
| 票務編號： | 9691 |
| 摘要： | 當 Blob_Analysis_1D 運算子允許每行比定義值少 20 個標籤 |
|---|---|
| 說明： | 由……所定義的可用標籤數量為 Label_bits 該參數減少了 20 個標籤。舉例來說，如果 Label_bits 若設定為 5，則僅有 12 個（2^5 - 20）標籤可用，而非預期中的 32 個（2^5）。 |
| 解決方法： | 請使用新的 BlobDetector1D 改用該運算子。此問題已在新版運算子中獲得解決。 |
| 票務編號： | 9688 |
| 摘要： | 《》的模擬 Blob_Analysis_1D 運算子不等於硬體行為 |
|---|---|
| 說明： | 物件特徵輸出的順序在硬體與軟體中可能有所不同。這是因為硬體輸出取決於資料的時序，而此時序無法在VisualApplets 中進行模擬。此外，FlushI 輸入與影像資料輸入是異步的，因此可能無法以貼近實際的方式模擬已完成的輸出幀。 |
| 解決方法： | 請使用新的 BlobDetector1D 改用該運算子。此問題已在新版運算子中獲得解決。 |
| 票務編號： | 7709 |
Library Color#
| 摘要： | 某些色彩轉換的效果與預期不符 |
|---|---|
| 說明： | 該的營運商 彩色 應謹慎使用此函式庫：某些顏色轉換的結果可能與使用者預期不符：
|
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | – |
ColorTransform 運算子#
| 摘要： | 負轉換係數的限制 |
|---|---|
| 說明： | 當 ColorTransform 該運算子僅在輸入格式為有符號格式，或係數為靜態時，才支援負的轉換係數。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | 251344 |
BAYER5x5Linear 運算子#
| 摘要： | VisualApplets 中的資源估算功能，適用於 BAYER5x5Linear 與以下估算不同：Xilinx |
|---|---|
| 說明： | BAYER5x5Linear: 在某些情況下，VisualApplets 中針對此運算子的資源估算（在 FPGA Resource Usage （對話方塊）可能與「Xilinx 」工具在完成佈置與佈線後所顯示的估算結果有所不同。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | 6426 |
Library Compression#
JPEG_Encoder 運算子#
| 摘要： | 的輸出傳輸 JPEG_Encoder 運算子啟動的時間早於實際影像資料的傳輸時間 |
|---|---|
| 說明： | 操作員：為了優化影像吞吐量（頻寬），操作員會在啟用標頭生成功能後立即輸出標頭——即使影像資料尚未抵達操作員的輸入端。如此一來，由於標頭是預先傳輸的，因此標頭資料的傳輸不會中斷影像資料的傳輸。 此做法的缺點在於，操作器的輸出傳輸會比實際影像資料的傳輸更早開始。在特定情況下，這可能會造成困擾： 如果您使用的是 SourceSelector 運算子緊接在……之後 JPEG_Encoder: SourceSelector 操作員一收到標頭資料，便會將部分處理過的幀登錄至寄存器中。因此，如果 SourceSelector 已切換為從 JPEG_Encoder, SourceSelector 無法切換至任何其他訊號源，因為系統總是偵測到未完成的畫面。此外，當啟用標頭產生功能時，且 SourceSelector 從另一個來源切換至 JPEG_Encoder 通道中，第一張圖片遺失了。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | – |
Library Filter#
FIRKernelNxM 運算子#
| 摘要： | FIRKernelNxM 運算子可能會導致處理錯誤 |
|---|---|
| 說明： | 當 FIRKernelNxM 若發生以下情況，該運算子可能會導致處理錯誤： EdgeHandling 當參數設定為常數、欄數 > 2*並行度、核心欄數為偶數，且並行度 > 1 時，可在影像的左邊緣觀察到誤差，該處畫面內的核心位置會使用錯誤的像素資料。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | 2939 |
圖書館硬體平台#
CoFCamera 操作員（僅限imaFlex 2 Dual 100 ）#
| 摘要： | DRC2 回報，針對採用兩組的imaFlex 2 Dual 100 設計，出現一般性網表產生錯誤 CoFCamera Modules |
|---|---|
| 說明： | 當兩個 CoFCamera 若在imaFlex 2 Dual 100 設計中使用模組，DRC2 可能會報告一般性的網表生成錯誤。雖然仍可建立該設計，但生成的硬體設計可能無法正常運作。 |
| 解決方法： | 請將 `VisualApplets ` 更新至 3.8.0 或更新版本，此問題已在該版本中修正。 |
| 票務編號： | 366304 |
觸發運算子#
| 摘要： | 觸發運算子可能會導致觸發輸出線出現突波 |
|---|---|
| 說明： | 將 applet 載入擷取卡期間的初始化階段，觸發運算子可能會在觸發輸出端產生突波。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | – |
ImageBufferMultiRoiDyn 運算子#
| 摘要： | 小圖片的時序錯誤 |
|---|---|
| 說明： | 當 ImageBufferMultiRoiDyn 當輸入影像非常小時，此運算子可能會導致時序錯誤。 |
| 解決方法： | 目前沒有任何解決方法。 |
| 票務編號： | – |
Library Memory#
| 摘要： | 在mE6 平台上為緩衝區運算子啟用 WritePriority 模式時，吞吐量會降低 |
|---|---|
| 說明： | 在mE6 硬體平台上，啟用 WritePriority 記憶體函式庫中緩衝區運算子的此種運作模式，會降低可達到的最大資料吞吐量。此模式採用效率較低的 DRAM 存取仲裁策略，導致整體介面效能降低。 |
| 解決方法： | 停用 WritePriority 除非應用程式有此需求，否則應採用此模式。 |
| 票務編號： | 366936 |
基於 LUT 的運算子#
| 摘要： | 從文字檔匯入的大型整數值可能會損失精確度 |
|---|---|
| 說明： | 將包含超過 53 位元的整數值從文字檔匯入整數欄位參數時，部分最低有效位元可能會遺失。因此，匯入的值可能會被四捨五入，並可能與檔案中指定的值有所不同。此情況會影響基於 LUT 的運算子以及其他支援匯整數值的運算子，但僅發生於VisualApplets 中。在執行階段，這些值會正確載入。 |
| 解決方法： | 請確保匯入的整數值不超過 53 位元。或者，將VisualApplets 更新至 3.8.0 或更新版本，該版本已修正此問題。 |
| 票務編號： | 363933 |
LineBuffer 操作員在線imaFlex 2 Dual 100#
| 摘要： | LineBuffer 操作員在以下情況下可能出現吞吐量下降：imaFlex 2 Dual 100 |
|---|---|
| 說明： | 在imaFlex 2 Dual 100 硬體平台上，該 LineBuffer 根據傳入資料流的時序特性，該運算子的效能可能會降低。在最壞的情況下，可達成的最大頻寬可能會減少多達 50%。 |
| 解決方法： | 在……的上游插入一個足夠大的 FIFO， LineBuffer 運算子，用於吸收輸入資料流中的時序波動。 |
| 票務編號： | 366936 |