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 경로에서 찾을 수 있습니다.

어댑터 구성 유틸리티는 다음과 같이 표시됩니다.

“Start"를 클릭하고 “Intel(R) 82574L” 어댑터를 선택합니다.

“Smart Config"를 클릭하면 유틸리티가 나머지 작업을 자동으로 처리합니다.

SwingCatalyst 설정에서 카메라 구성

카메라가 컴퓨터에 연결되어 있고 카메라 뒷면의 LED가 녹색으로 깜박이는지 확인합니다.

SwingCatalyst를 시작하고 설정 -> 카메라를 클릭합니다.

Spinnaker 카메라는 카메라 목록에서 Spinnaker로 표시됩니다.

고급…을 클릭합니다.

고급 카메라 설정 창에서는 유용하게 활용할 수 있는 모든 설정이 표시됩니다. 각 개별 설정을 살펴보겠습니다.

위에 표시된 설정은 기본 카메라 설정이며, 대부분의 설정이 Auto로 지정되어 있습니다. 스포츠 분석을 위한 비디오 이미지 품질을 더 잘 제어하기 위해 이러한 설정을 변경할 수 있습니다.

프레임 레이트 변경:

프레임 레이트 제어 활성화 체크박스를 선택하면 프레임 레이트를 수동으로 설정할 수 있습니다. 이 체크박스를 선택 해제하면 프레임 레이트가 기본적으로 Auto로 설정됩니다 (참고: 이 카메라의 최대 프레임 레이트는 78 FPS입니다. 최대 프레임 레이트를 달성하려면 모든 설정을 수동으로 설정해야 합니다).

프레임 레이트는 셔터 속도 및 디바이스 링크 처리량 설정에 의해 제한될 수 있습니다. 이 경우 최대 프레임 레이트를 달성하려면 처리량을 늘려야 합니다 (자세한 내용은 이후 설명 참조).

셔터 속도 변경:

야외 햇빛 아래가 아닌 경우, 자동 셔터 속도보다는 수동 셔터 속도를 사용하는 것이 좋습니다. 그렇지 않으면 스포츠 분석에 적합하지 않을 정도로 영상이 흐려질 수 있습니다. 블러를 줄이기 위해 셔터 속도를 2ms(2000μs) 미만으로 설정하는 것을 권장하며, 충분한 조명이 확보된 경우 셔터 속도를 1ms(1000μs) 미만으로 설정할 수 있습니다.

비디오 이미지의 밝기는 셔터 속도, Gain 설정, 렌즈 조리개, 그리고 사용 가능한 빛의 양에 따라 결정됩니다.

카메라 Gain 변경:

변화하는 조명 환경에서는 Gain을 Auto로 설정하는 것이 좋지만, 실내 환경에서는 Gain을 수동으로 설정하는 것이 더 효과적입니다.

dB 값이 높을수록 이미지가 밝아지지만, 그만큼 노이즈도 증가하여 전체적인 영상 품질이 저하될 수 있습니다. 때로는 노이즈가 다소 증가하더라도 Gain을 약간 높여 셔터 속도를 낮춤으로써 물체(예: 임팩트 시 클럽, 야구 배트 등)의 선명한 프레임별 영상을 얻는 것이 더 나을 수 있습니다.

Gamma 및 블랙 레벨 변경:

블랙 레벨은 밝기 조정의 한 형태로, 카메라 센서의 모든 픽셀이 반환하는 최솟값에 해당합니다.

블랙 레벨 값을 높이면 이미지를 더 밝게 만들 수 있습니다.

기본값으로 그대로 두는 것을 권장합니다.

비디오 이미지 개선에 관한 자세한 내용과 비교 사진은 다음 지원 문서를 참조하세요: improving-image-quality.md

카메라 화이트 밸런스 변경:

일반적으로 이 설정은 Auto(연속)로 유지하는 것을 권장하지만, 최대 프레임 레이트를 달성하려면 이 기능도 꺼야 합니다.

화이트 밸런스는 비디오 이미지의 색온도에 영향을 미치며, 화이트 밸런스가 크게 어긋나면 이미지가 좋지 않게 보이거나 너무 붉거나 녹색으로 보일 수 있습니다.

자동 화이트 밸런스를 활성화하면 일부 프레임 레이트를 희생하게 되어 카메라 최대치인 226 FPS 대신 200 FPS로 제한됩니다.

디바이스 링크 처리량:

GigE 카메라에서 디바이스 링크 처리량과 패킷 크기는 서로 연관되어 있으며, 최대 처리량을 사용하려면 패킷 크기를 9000으로 설정해야 합니다. 최대 프레임 레이트를 달성하려면 이 설정이 반드시 필요합니다.

Region Of Interest (ROI) 적용:

Region of Interest는 이미지 크기와 각 이미지에 필요한 대역폭을 줄이는 방법입니다. 이미지 크기를 줄이면 전체 픽셀 읽기 요구량이 줄어들어 프레임 레이트를 높일 수 있습니다.

높이와 너비를 줄이면 프레임 레이트에 긍정적인 영향을 미치고 대역폭 요구량을 낮출 수 있습니다.

Region of interest를 변경하려면 높이 슬라이더를 왼쪽으로 드래그하여 이미지 높이를 줄일 수 있습니다.

이미지 높이를 변경했으므로, 이미지 크기가 줄어든 것에 따라 카메라를 물리적으로 이동하는 대신 Y 오프셋을 변경하는 방법도 유용할 수 있습니다.

카메라 탭으로 돌아가서 프레임 레이트 항목을 보면, 카메라 센서의 높이를 줄여 Region of Interest를 적용했기 때문에 설정 가능한 최대 프레임 레이트가 증가한 것을 확인할 수 있습니다.

문제 해결

GigE Vision / 기가비트 이더넷 권장 사항을 참조하세요:

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 점보 프레임을 사용하도록 설정하는 것이 중요합니다.

해상도 1440 x 1200, 78 FPS의 GigE 카메라 1대는 카메라당 약 134MB/s의 대역폭을 사용합니다. 따라서 다중 카메라 설정의 경우 (대부분의 경우) 저희 권장 사항에 따라 전용 네트워크 컨트롤러 카드를 갖추는 것이 중요합니다. 저희를 통해 GigE 카메라를 구매하신 경우 설치용 PCI Express 듀얼 포트 네트워크 카드가 함께 제공됩니다.

일반적으로 하나의 네트워크 어댑터에 두 대 이상의 카메라를 연결하는 것은 권장하지 않습니다.

필터 드라이버:

Region Of Interest (ROI):

Region of interest(또는 관심 영역)를 사용하면 전체 이미지 크기가 줄어들고 FPS가 향상될 뿐만 아니라, 대역폭 사용량을 낮춰 프레임 드롭을 줄이는 데도 도움이 될 수 있습니다 (ROI 활용 방법은 위 내용을 참조하세요).

기타 문제:

하드웨어에 따라 선명도 및 노이즈 제거 필터를 활성화하는 것이 적합하지 않을 수 있습니다. 이 필터들을 끄면 CPU 및 GPU 사용량을 일부 줄일 수 있습니다. 카메라 필터는 고급 카메라 설정의 필터 탭에서 찾을 수 있습니다. 필터에 관한 자세한 내용은 여기를 참조하세요: improving-image-quality.md

상태 표시등 설명

LED	의미	권장 조치
꺼짐	전원 없음, LED 비활성 상태, 또는 오류 없는 오류 상태	카메라를 분리했다가 다시 연결해 보세요. 문제가 지속되면 케이블 또는 전원을 확인하세요
녹색 깜박임 (1회)	디바이스가 Link-Local Address (LLA)를 사용하도록 구성됨	문제 없음
녹색 깜박임 (2회)	고정 IP 주소	디바이스가 고정 IP로 구성됨
녹색 깜박임 (3회)	DHCP IP 주소	디바이스가 DHCP를 사용하도록 구성됨 (일반적으로 권장하지 않으며, 정적/고정 IP 설정을 권장합니다)
녹색 고정	수집 시작됨	카메라가 영상을 스트리밍 중입니다
빠른 녹색 깜박임	펌웨어 업데이트	펌웨어 업데이트가 진행 중입니다
녹색 및 빨간색 깜박임	일반 오류	카메라가 오류 상태입니다. 카메라 전원을 껐다가 다시 켜보세요

최종 업데이트: 2025-05-07 | 공식 지원 사이트에서 보기