已知問題 Framegrabber SDK 5.11.7
本節提供有關 Basler Framegrabber SDK 5.11.7 版本的已知問題資訊。
所有元件
| 摘要 | 載入程式庫需要 Visual Studio 2022 可轉發套件 |
| 描述 | GenTL Producer 現在使用 Visual Studio 2022 編譯。因此，必須在目標系統上安裝 Microsoft Visual Studio 2022 可轉發套件。如果缺少這些可轉發套件，SDK 程式庫可能會載入失敗。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 在載入或部署 SDK 程式庫之前，請在系統上安裝適當的 Microsoft Visual C++ 2022 可轉發套件（需符合目標架構，例如 x64）。您可以從 Microsoft 官方網站取得這些可轉發套件，或將其納入您的應用程式安裝程式中。 |
| 問題單 ID | - |
| 摘要 | 使用 VisualApplets 3.6.1 或更新版本建立的 microEnable 5 marathon Applet 無法使用 Framegrabber SDK 5.11.6 或更高版本進行燒錄 |
| 描述 | 針對 microEnable 5 marathon 擷取卡建置、且 VisualApplets 版本大於 3.6.0 的 Applet，無法使用 Framegrabber SDK 5.11.6 或更高版本進行燒錄。完成燒錄後，該 Applet 即可搭配 Framegrabber SDK 5.11.6 或更高版本運作。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 請使用 VisualApplets 3.6.0 或更早版本建置 Applet，或使用 Framegrabber SDK 5.11.6 或更早版本進行燒錄。 |
| 問題單 ID | 355906 |
| 摘要 | 若搭配低於 Gen 3x8 的 PCIe 使用 Basler CXP-12 Interface Card 2C/4C 與 imaWorx CXP-12 Quad 擷取卡，可能會降低相機的 Acquisition Frame Rate 並導致影像遺失 |
| 描述 | Basler CXP-12 Interface Card 2C/4C 與 imaWorx CXP-12 Quad Frame Grabber 需要具備 PCIe Gen 3x8（直接記憶體存取）或更高規格的主機介面。使用較慢的主機介面可能會降低相機的 Acquisition Frame Rate 並導致影像遺失。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
| 摘要 | 如果在 Frame Grabber 或介面卡上遺失影像，遺失的影像將由下一個傳送的緩衝區指示 |
| 描述 | 如果在 Frame Grabber 或介面卡上因緩衝區溢位而遺失影像（例如，當使用者應用程式未夠快地（重新）將緩衝區排入佇列以傳送影像時），遺失的影像將由下一個傳送的緩衝區指示。遺失的影像標記為 INCOMPLETE，其檔案大小為 0，且自訂錯誤代碼為 BUFFER_INFO_BASLER_XAPI_ERROR_CODE 設為 42。此外，串流資訊中會新增一個遺失的影格。請注意，無論因溢位遺失多少影格，都只會新增一個遺失的影格。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
| 摘要 | 使用介面卡變更 Applet 會導致裝置清單不正確 |
| 描述 | 在變更 Applet 期間，連接至介面卡的相機仍會顯示在裝置清單中，即使它們已無法存取。在此狀態下嘗試開啟相機會導致錯誤訊息。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
| 摘要 | 啟動電腦後可能偵測不到相機 |
| 描述 | 在罕見的情況下，啟動電腦後可能偵測不到相機。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 若要偵測相機，請將相機重新上電。 |
| 問題單 ID | – |
| 摘要 | 配置用於擷取的緩衝區必須使用 Heap Memory 進行 |
| 描述 | 配置用於擷取的緩衝區時，緩衝區位址必須對齊 8 位元組倍數。如果使用 Heap Memory，就會自動符合此條件。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 使用 Heap Memory。 |
| 問題單 ID | – |
| 摘要 | 在電腦上同時安裝 pylon 與 Framegrabber SDK 時的相容性問題 |
| 描述 | 如果在您的電腦上同時安裝了 pylon 和 Framegrabber SDK，Basler 建議在 pylon 安裝過程中取消勾選 CXP 選項。為避免因互相競爭的 CXP-producers 而產生問題，應僅由 pylon 或 Framegrabber SDK 來負責操作 Basler 擷取卡及／或介面卡。 |
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 如果在您的電腦上同時安裝了 pylon 和 Framegrabber SDK，請在 pylon 安裝過程中取消勾選 CXP 選項。 |
| 問題單 ID | – |
| 摘要 | 每秒張數 (FPS) 限制在 50000 FPS 至 90000 FPS 之間 |
| 描述 | 每秒張數 (FPS) 限制在 50000 FPS 至 90000 FPS 之間，具體取決於緩衝區數量與影像尺寸： - 對於 10 個緩衝區且最小影像尺寸為 48x1 的情況，限制約為 50,000 FPS。
- 對於 50 個緩衝區且最小影像尺寸為 48x1 的情況，限制約為 90,000 FPS。
- 對於 50 個緩衝區且影像尺寸為 8192x1 的情況，限制約為 50,000 FPS。
|
| 受影響的作業系統 | Linux 與 Windows |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | 295445 |
| 摘要 | 儲存和載入 MCF 檔案會導致倍精確度數值被四捨五入為整數 |
| 描述 | 從 MCF 檔案載入組態時，帶有逗號分隔符號的倍精確度數值可能會被四捨五入到最接近的整數。這是由 Linux 作業系統的當前地區設定所引起的。如果地區設定將點定義為分隔符號，則不會發生四捨五入。 |
| 受影響的作業系統 | Linux |
| 因應措施 | 設定適當的地區設定，例如： LC_NUMERIC="C" ./<applicationName>，然後再啟動 microDisplay X 或 microDiagnostics。 |
| 問題單 ID | 265213 |
| 摘要 | 相機無法輸出正確的影像 |
| 描述 | 如果多連結相機不符合 CXP 標準關於影像資料在各連結間分發的規範，相機將無法正確傳輸影像。
在使用 JAI SP-12000C-CXP4 相機時觀察到了此問題。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | 211645 |
| 摘要 | Linux 驅動程式無法使用受信任的 Basler 憑證進行簽署 |
| 描述 | 在 Linux 中使用安全開機 (UEFI 模式) 需要使用以受信任憑證簽署的驅動程式。由於驅動程式是以原始碼形式提供，因此無法使用受信任的 Basler 憑證進行簽署。 |
| 受影響的作業系統 | Linux |
| 因應措施 | 若要使用該驅動程式，可以停用安全開機。或者，您可以按照此 Ubuntu 部落格文章中的說明來簽署驅動程式。 |
| 問題單 ID | – |
Framegrabber API
| 摘要 | 顯示高幀率影像可能會導致輸入延遲 |
| 描述 | 當使用 display_lib Framegrabber API 程式庫（僅適用於 Windows）時，顯示高幀率（約每秒 10,000 幀）的影像可能會導致主機電腦出現輸入延遲（例如鍵盤和滑鼠延遲）。 |
| 受影響的作業系統 | Windows |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
CLComDriver
| 摘要 | 系統中安裝的驅動程式多於 CLSer 連接埠 |
| 描述 | 有時在使用 Install COM driver(s) for all Ports 時，安裝的驅動程式數量會多於系統中的 CLSer 連接埠數量。 |
| 受影響的作業系統 | Windows |
| 因應措施 | 選取額外的連接埠，並使用 Remove selected COM driver 命令將其移除。 |
| 問題單 ID | – |
| 摘要 | 使用 Basler Runtime 5.9.0 或較舊版本時無法辨識板卡類型 |
| 描述 | 使用 Basler Runtime 5.9.0 或較舊版本時，無法辨識板卡類型，且連接埠僅會使用 CLSer 識別碼顯示。 |
| 受影響的作業系統 | Windows |
| 因應措施 | 將您的 Basler Runtime/Framegrabber SDK 版本更新至 5.10 或更高版本。 |
| 問題單 ID | – |
| 摘要 | 裝置管理員中的連接埠設定無法反映實際設定 |
| 描述 | 裝置管理員中的連接埠設定無法反映實際設定，且變更不會生效。 |
| 受影響的作業系統 | Windows |
| 因應措施 | 請使用 Windows COM Port API 來變更連接埠設定。 |
| 問題單 ID | – |
Linux Driver
| 摘要 | marathon 擷取卡的擷取作業產生失真影像 |
| 描述 | marathon CXP 和 CL 擷取卡所擷取的影像可能會顯示失真。這是因為 Linux 驅動程式不支援使用輸入輸出記憶體管理單元 (IOMMU)。 |
| 受影響的作業系統 | Linux |
| 因應措施 | 請透過在下列檔案中新增這一行來停用輸入輸出記憶體管理單元 (IOMMU) etc/default/grub.txt: GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=off" |
| 問題單 ID | 336093 |
GenTL Producer
| 摘要 | 在初始化後不久關閉日誌記錄時發生死結 |
| 描述 | 當 SDK 設定為連線至 pylon Event Logger，如果在初始化後直接關閉日誌記錄，可能會發生死結。常見的情形包括：- 呼叫
Fg_FreeLibraries() 後不久呼叫 Fg_InitLibraries() - 呼叫
Fg_... 未透過明確生命週期管理的函數 Fg_InitLibraries() 進行明確的生命週期管理即呼叫 Fg_FreeLibraries(). - 呼叫
GCCloseLib() 後不久呼叫 GCInitLib() 。(3) 對 GenTL Producer 呼叫
|
| 受影響的作業系統 | Windows |
| 因應措施 | 為避免此問題，請確保日誌記錄子系統和相關程式庫在 SDK 使用期間保持完整初始化，並避免在初始化後立即關閉它們。 |
| 問題單 ID | 360731 |
| 摘要 | GenTL BUFFER_INFO_FRAME_ID 包含所有畫格的 Counter，而非 CXP 影像標頭來源標籤 |
| 描述 | GenTL BUFFER_INFO_FRAME_ID（可透過 DSGetBufferInfo進行查詢）不包含來自 CXP 影像標頭的來源標籤。相反地，它包含傳送至電腦的所有畫格的 Counter。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
| 摘要 | 變更相機的 DeviceUserID 後需要重新啟動 |
| 描述 | 當 DeviceUserID 相機的設定變更後，需要重新啟動 GenTL Producer 才能使變更生效。這會影響使用 GenTL Producer 的兩種方式：透過 GenTL API，以及使用 GUI 透過 GenTL 與相機互動（即 pylon Viewer）。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
| 摘要 | GenTL 版本 1.4 及以下版本的 Producer 的 GenTL 支援有限 |
| 描述 | GenTL 版本 1.4 及以下版本的 Producer 的 GenTL 支援有限。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
| 摘要 | 影像大小限制為 2 GB |
| 描述 | 由於 GenTL Producer 緩衝區大小的限制，影像大小限制為 2 GB。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | 231049 |
| 摘要 | 在 Acquisition Start 後變更的相機參數不會反映在擷取卡中 |
| 描述 | 如果在影像擷取期間變更相機參數，該變更將不會反映在擷取卡中。這是因為 GenTL Producer 在開始擷取前會擷取相關參數（寬度、高度、影像格式等），並將這些參數與擷取卡進行同步。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | 195482 和 225591 |
| 摘要 | 當變更 Applet 時，GenTL 裝置 ID 會隨之改變 |
| 描述 | 根據 GenTL 標準，兩次工作階段之間的裝置 ID 應保持不變。然而，當變更 Applet 時，GenTL 裝置 ID 會改變。因此，只有在 Applet 的名稱與產生該裝置 ID 的 Applet 名稱相同時，才能重複使用裝置 ID。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | – |
microDisplay X
| 摘要 | 對於包含兩個 Camera 運算元的 VisualApplets 設計，相機偵測有時在 microDisplay X 中無法運作 |
| 描述 | 對於包含兩個 Camera 運算元（其中至少一個運算元具有兩個通道且資源索引以直接遞增順序指派）的 VisualApplets 設計，相機偵測在 microDisplay X 中無法運作。例如，兩個 Camera 運算元各具兩個通道，運算元 A 使用連接埠 0 和 1，而運算元 B 使用連接埠 2 和 3。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 請勿以直接遞增順序指派資源索引。例如，將運算元 A 的通道指派給連接埠 0 和 2，並將運算元 B 的通道指派給連接埠 1 和 3。 |
| 問題單 ID | 314206 |
| 摘要 | 載入具有複雜設計的 HAP 檔案時，microDisplay X 會當機 |
| 描述 | 某些非常複雜的 VisualApplets 設計可能會導致在 microDisplay X 中載入 Applet 期間或載入後立即當機。在 SDK 程式中未觀察到此類當機情況。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 再次在 microDisplay X 中載入 Applet。在 microDisplay X 中載入 Applet 通常在第二次或第三次嘗試後即可成功。 |
| 問題單 ID | 314234 |
| 摘要 | 在全新的 Linux 安裝上，microDisplay X 無法啟動 |
| 描述 | 在全新的 Linux 安裝上，microDisplay X 無法啟動。此問題的原因是，在全新的 Linux 安裝上， xcb 缺少 QT 平台外掛程式。 |
| 受影響的作業系統 | Linux |
| 因應措施 | 請安裝缺少的外掛程式： sudo apt install libxcb-xinerama0 指令。 |
| 問題單 ID | 259941 |
| 摘要 | 在 Linux 上，關閉 microDisplay X 時可能會發生當機 |
| 描述 | 在 Linux 上，關閉 microDisplay X 時可能會發生當機。這不會造成其他後果，可以忽略。 |
| 受影響的作業系統 | Linux |
| 因應措施 | 沒有可用的因應措施。 |
| 問題單 ID | 211811 |
| 摘要 | 如果開啟 Camera 標籤頁，microDisplay X 可能會當機 |
| 描述 | 如果開啟 Camera 標籤頁，microDisplay X 可能會當機。如果僅安裝一個連接一台相機的 mE6 擷取卡、探索已完成，且您在 microDisplay X 中的第一次點擊是點擊 Camera 標籤頁，就會發生此情況。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 在探索相機之前開啟 Camera 標籤頁。 |
| 問題單 ID | 333828 |
python Wrapper
| 摘要 | 不提供適用於 imaFlex 平台的 python Wrapper 範例 |
| 描述 | Framegrabber SDK 未隨附適用於 imaFlex 平台的 python Wrapper 範例。 |
| 受影響的作業系統 | Windows 和 Linux |
| 因應措施 | 請使用適用於其他平台的範例並進行修改。 |
| 問題單 ID | – |