跳至內容

Framegrabber SDK 5.11.9 已知問題#

本節提供有關 Basler Framegrabber SDK 5.11.9 版已知問題的資訊。

所有元件#

總結 在低於 PCIe Gen 3x8 的 PCIe 頻寬下使用 Basler CXP-12 Interface Card 2C/4C 與 imaWorx CXP-12 Quad Frame Grabber可能會降低相機的 Acquisition Frame Rate 並導致影像遺失
描述 Basler CXP-12 Interface Card 2C/4C 與 imaWorx CXP-12 Quad frame grabber需要具備 PCIe Gen 3x8（Direct Memory Access）或更高規格的主機介面。使用較慢的主機介面可能會降低相機的 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 –
總結 配置用於擷取的緩衝區必須使用堆積 Memory (Heap Memory)
描述 配置用於擷取的緩衝區時，緩衝區位址必須對齊 8 位元組的倍數。如果使用堆積 Memory，系統會自動處理。
受影響的作業系統 Linux 與 Windows
因應措施 請使用堆積 Memory。
票單 ID –
總結 在 PC 上同時安裝 pylon 與 Framegrabber SDK 時的相容性問題
描述 如果在電腦上同時安裝 pylon 與 Framegrabber SDK，Basler 建議在 pylon 安裝過程中取消選取 CXP 選項。為避免競爭 CXP-producers 產生的問題，應由 pylon 或 Framegrabber SDK 其中之一來負責操作 Basler frame grabbers 和/或介面卡。
受影響的作業系統 Linux 與 Windows
因應措施 如果在電腦上同時安裝 pylon 與 Framegrabber SDK，請在 pylon 安裝過程中取消選取 CXP 選項。
票單 ID –
總結 每秒影格數 (fps) 限制介於 50000 fps 至 90000 fps 之間
描述 每秒影格數 (fps) 限制介於 50000 fps 至 90000 fps 之間，具體取決於緩衝區數量與影像大小：
  • 10 個緩衝區且最小影像尺寸為 48x1 時，限制約為 50000 fps
  • 50 個緩衝區且最小影像尺寸為 48x1 時，限制約為 90000 fps
  • 50 個緩衝區且影像尺寸為 8192x1 時，限制約為 50000 fps
受影響的作業系統 Linux 與 Windows
因應措施 沒有可用的因應措施。
票單 ID –
總結 儲存與載入 MCF-Files 導致倍精確度浮點數被四捨五入為整數
描述 從 MCF-file 載入組態時，使用逗號分隔符號的倍精確度浮點數可能會被四捨五入至最接近的整數。這是由 Linux 作業系統目前的地區設定（locale）所引起的。若地區設定使用點作為分隔符號，則不會發生四捨五入的情況。
受影響的作業系統 Linux
因應措施 在啟動 microDisplay X 或 microDiagnostics 之前，請設定適當的地區設定（locale），例如 LC_NUMERIC="C" ./<applicationName>。
票單 ID 265213
總結 相機無法輸出正確的影像
描述 若具備多個連線（link）的相機在透過連線分配影像資料時不符合 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 驅動程式#

總結 VisualApplets DmaFromPc imaFlex 2 Dual 100 Frame Grabber 上的 operator 不支援 Linux 驅動程式
描述 目前 Linux 驅動程式不支援 imaFlex 2 Dual 100 frame grabber 上的 VisualApplets DmaFromPc operator。因此，無法透過此 operator 將緩衝區從 PC 傳輸到 frame grabber。
受影響的作業系統 Linux
因應措施 沒有可用的因應措施。
票單 ID –
總結 在 marathon Frame Grabbers 上進行擷取會產生失真的影像
描述 在 marathon CXP 與 CL frame grabbers 上擷取的影像可能會顯示失真的影像。這是因為 Linux 執行緒不支援使用輸入輸出記憶體管理單元 (IOMMU)。
受影響的作業系統 Linux
因應措施 透過將以下行新增至檔案來停用輸入-輸出記憶體管理單元 (IOMMU) etc/default/grub.txt: GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=off"
票單 ID 336093

GenTL Producer#

總結 GenTL BUFFER_INFO_FRAME_ID 包含所有影格的 Counter（而非 CXP 影像標頭來源標籤）
描述 GenTL BUFFER_INFO_FRAME_ID（可透過 DSGetBufferInfo，不包含來自 CXP 影像標頭的來源標籤。相反地，它包含傳送至電腦的所有影格的 Counter。
受影響的作業系統 Windows 與 Linux
因應措施 沒有可用的因應措施。
票單 ID –
總結 變更 DeviceUserID 後需要重新啟動
描述 當 DeviceUserID 變更相機的
受影響的作業系統 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 –
總結 Camera Parameters Changed after Image Acquisition Start Aren't Reflected in the Frame Grabber
描述 當在影像擷取期間變更相機參數時，該變更不會反映在擷取卡中。這是因為 GenTL Producer 會在開始擷取之前擷取相關參數（寬度、高度、影像格式等），並將這些參數與擷取卡進行同步。
受影響的作業系統 Windows 與 Linux
因應措施 沒有可用的因應措施。
票單 ID 195482 和 225591
總結 The GenTL Device ID Changes When the Applet Is Changed
描述 根據 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
總結 microDisplay X 載入設計複雜的 HAP 檔案時會發生當機
描述 某些非常複雜的 VisualApplet 設計，可能會導致在microDisplay X 中載入小程式期間或載入完成後立即發生當機。在 SDK 程式中尚未觀察到此類當機情況。
受影響的作業系統 Windows 與 Linux
因應措施 請再次在microDisplay X 載入該小程式。若在microDisplay X 載入該小程式，通常嘗試兩三次後便能成功。
票單 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
總結 microDisplay X 若開啟「相機」分頁，可能會導致程式當機
描述 microDisplay X 若開啟「相機」分頁，系統可能會當機。這種情況會發生在：當系統中僅安裝了一個mE6 抓取器且僅連接一台相機、並已完成裝置偵測後，您在microDisplay X 中首次點擊的對象是「相機」分頁時。
受影響的作業系統 Windows 與 Linux
因應措施 在偵測到相機之前，請開啟「相機」分頁。
票單 ID 333828

C# 包裝函式#

總結 C# Wrapper 不接受 FieldParameterInt 中的負值
描述 FieldParameterInt.value 是一個無符號整數，Framegrabber SDK 可以正確處理。在 C# wrapper 中，指派負值（例如 -1）將無法通過編譯，因此 SiSoCsRt.Fg_setParameterWithFieldParameterInt 無法直接使用該數字進行呼叫。
受影響的作業系統 Windows 與 Linux
因應措施 將值指派給 unchecked 之前，請先使用 Fg_setParameterWithFieldParameterInt對於 -1，則應使用 fieldParameter.value = unchecked((uint)-1);.
票單 ID 332625