在 SwingCatalyst 中設定 FLIR BlackFly S GigE

如何在 SwingCatalyst 中使用 FLiR Blackfly S（GigE）機器視覺相機

本文介紹如何在 SwingCatalyst 中使用相容 Spinnaker 的 GigE Vision 相機。

部分較舊的型號亦受支援，例如 Blackfly GigE（非 S 系列），可作為相應相機的參考指南。各型號之間在可用設定與功能上存在差異，因此本文內容可能與您畫面上顯示的略有不同。

注意：Spinnaker 僅在 SwingCatalyst 9.4 及更新版本中受支援。

本文分為以下幾個章節

開始使用：硬體設定

使用相機隨附的 4 顆黑色十字頭螺絲，將腳架轉接座固定於相機機身。

拆開鏡頭包裝，並確保移除鏡頭的塑膠保護蓋

移除相機上的感光元件保護蓋：

將鏡頭安裝至相機

調整相機鏡頭：

此鏡頭由上至下有三個調整環：

對焦（向 ∞ 符號方向調整，可使背景中較遠的物體對焦清晰）
光圈（Iris 調整，控制通過鏡頭的進光量，光圈縮小可獲得更銳利的影像）
變焦（調整鏡頭的廣角或望遠焦段）

安裝雙埠網路卡

重要：網路卡必須依照建議事項進行配置。

gige-network-setup.md

開始使用：驅動程式安裝

點擊下載驅動程式（若使用 Chrome，請右鍵點擊並選擇「另存連結為」）

下載完成後，點擊執行檔並依照安裝精靈的指示操作。

選擇「Camera Evaluation」。
保持勾選「I will use GigE Cameras」選項。

IP 配置

驅動程式安裝完成後，系統應會提示您執行 AdapterConfigGUI。若未出現提示，可至以下路徑找到該工具：C:\Program Files\FLIR Systems\Spinnaker\shortcuts\utilities

Adapter 配置工具的介面如下所示：

點擊「Start」並選取所有「Intel(R) 82574L」介面卡。

點擊「Smart Config」，工具將自動完成後續配置。

在 SwingCatalyst 設定中配置您的相機

確認相機已連接至電腦，且相機背面的 LED 燈正在閃爍綠色。

啟動 SwingCatalyst 並點擊「設定」->「相機」。

Spinnaker 相機在相機清單中會顯示 Spinnaker 字樣。

點擊「進階…」

「進階相機設定」視窗會顯示所有可能用到的設定選項，讓我們逐一了解各項設定。

上方顯示的設定為預設相機設定，請注意大多數設定均為 Auto 模式，我們可以變更這些設定，以便更好地控制運動分析的影像品質。

變更幀速率：

勾選「Frame rate control enable」（幀速率控制啟用）核取方塊，即可手動設定幀速率；若取消勾選，幀速率實際上會設為 Auto（注意：此相機的最大幀速率為 78 FPS。若要達到最大幀速率，所有設定均需調整為手動模式）。

幀速率可能受快門速度及裝置連結傳輸量設定的限制。在此情況下，若要達到完整幀速率，需要提高傳輸量（詳情請見後續說明）。

變更快門速度：

除非在戶外陽光下拍攝，否則建議使用手動快門速度；若使用 Auto 模式，視訊影像很可能過於模糊，無法用於運動分析。為減少模糊，我們建議快門速度低於 2ms（2000μs），在充足光源下快門速度可低於 1ms（1000μs）。

視訊影像的亮度取決於快門速度、Gain 設定、鏡頭光圈以及可用光線量的綜合效果。

變更相機 Gain：

在光線變化的環境下，將 Gain 設為 Auto 較為理想；但若在室內固定環境中，將 Gain 設為手動會是更好的選擇。

dB 值越高，影像越亮，但同時也會產生更多雜訊，可能使整體視訊品質下降。有時為了將快門速度降低以獲得逐幀清晰的物體影像（例如擊球時的球桿、棒球棒等），適當提高 Gain 值以換取較多雜訊是值得的。

變更 Gamma 與黑色電平：

黑色電平可視為一種亮度調整方式，其值對應相機感光元件上任何像素所能回傳的最小數值。

提高黑色電平數值可使影像變亮。

我們建議保持預設值不變。

如需更多關於提升視訊影像品質的詳細資訊，請參閱這篇附有對比照片的支援文章：improving-image-quality.md

變更相機白平衡：

通常我們建議將此設定保留為 Auto（連續），但若要達到最大幀速率，也需要將其關閉。

白平衡會影響視訊影像的色溫，若白平衡偏差過大，影像看起來會很不自然，通常會使影像偏紅或偏綠。

啟用 Auto 白平衡後，幀速率會有所犧牲，使其降至 200 FPS 而非相機最大值 226 FPS。

裝置連結傳輸量：

在 GigE 相機上，裝置連結傳輸量與封包大小相互關聯，也就是說，若要使用最大傳輸量，封包大小需設定為 9000。若要達到完整幀速率，必須完成此設定。

套用 Region of Interest（ROI）：

Region of Interest 是一種縮減影像尺寸的方式，同時也可降低每張影像所需的頻寬。透過縮小影像尺寸，可以提高幀速率，因為整體像素讀取需求較小。

縮減高度和寬度對提升幀速率及降低頻寬需求均有正面效果。

若要變更 Region of Interest，可將高度滑桿向左拖曳以縮減影像高度。

由於我們已變更影像高度，現在也可以調整 Y 軸偏移量，這在因影像尺寸縮小而無需實際移動相機的情況下非常有用。

返回「相機」頁籤並查看幀速率，您會發現最大幀速率現在可設定得更高，這是因為我們透過縮減相機感光元件的高度套用了 Region of Interest。

疑難排解

請參閱我們的 GigE Vision / Gigabit Ethernet 建議事項：

gige-network-setup.md

**注意：**我們建議所有使用 Blackfly BFS-PGE-04S2C 型號的使用者更新每台相機的韌體：

FLIR 提供的韌體更新說明：http://softwareservices.flir.com/BFS-U3-50S5-BD2/latest/Family/Firmware.htm

韌體檔案下載：https://flir.app.boxcn.net/s/jr65evml5bkuqnh29sx49lm3clf7nr0k

掉幀：

儘管大多數 GigE 相機非常可靠，但依據網路設定和相機配置的不同，可能需要微調設定以避免掉幀。

請確認封包大小設定為 9000，這對於良好的性能至關重要，否則很可能發生掉幀。同樣重要的是，網路介面卡也需設定為使用 9kB Jumbo Frames，以確保相機與網路介面卡的設定一致。

一台解析度為 1440 x 1200、幀速率 78 FPS 的 GigE 相機，每台約使用 134MB/s 的頻寬。因此，在多相機設定的情況下（大多數情況），依照我們的建議配備專用網路控制卡非常重要。若您是透過我們購買 GigE 相機，將會附有一張 PCI Express 雙埠網路卡供安裝。

我們通常不建議在同一網路介面卡上運行超過一台相機。

濾波器驅動程式：

Region of Interest（ROI）：

使用 Region of Interest（或感興趣區域）可縮減整體影像尺寸並提升 FPS，同時也有助於降低頻寬使用量，進而減少掉幀情況（請參閱上方關於如何使用 ROI 的說明）。

其他問題：

依據您的硬體狀況，開啟銳化與降噪濾波器可能並不理想，關閉這些濾波器可減少部分 CPU 與 GPU 的使用量。您可以在「進階相機設定」的「濾波器」頁籤中找到相機濾波器設定。更多關於濾波器的資訊請見：improving-image-quality.md

狀態指示燈說明

LED	含義	建議措施
無燈光	未供電、LED 處於非啟用狀態，或 LED 處於無錯誤的錯誤狀態	嘗試拔除相機後重新連接；若問題持續，請檢查線纜或電源
閃爍綠色（1 次）	裝置已配置為使用連結本地位址（LLA）	無問題
閃爍綠色（2 次）	持久性 IP 位址	裝置已配置為使用持久性 IP
閃爍綠色（3 次）	DHCP IP 位址	裝置已配置為使用 DHCP（通常不建議，我們建議設定靜態／持久性 IP）
常亮綠色	擷取已開始	相機正在串流視訊
快速閃爍綠色	韌體更新中	韌體更新正在進行
綠色與紅色交替閃爍	一般錯誤	相機處於錯誤狀態，請嘗試重新啟動相機電源

最後更新：2025-05-07 | 在官方支援網站上檢視