Known Issues Framegrabber SDK 5.11.4
이 섹션에서는 Basler Framegrabber SDK 버전 5.11.4의 알려진 문제에 대한 정보를 제공합니다.
모든 구성 요소
| 요약 | Vivado 2025.1로 빌드한 Applets이 로드되지 않을 수 있음 |
| 설명 | Vivado 버전 2025.1을 사용하여 생성된 Applets이 간혹 로드에 실패할 수 있습니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 이 문제는 Framegrabber SDK 5.11.6에서 해결되었습니다. 따라서 이 문제를 방지하려면 Framegrabber SDK 5.11.6 이상을 사용하십시오. 또는 Vivado 2023.2로 Applets을 빌드하십시오. |
| 티켓 ID | 341684 |
| 요약 | Gen 3x8 미만의 PCIe에서 Basler CXP-12 Interface Card 1C/2C/4C 및 imaWorx CXP-12 Quad 프레임 그래버를 사용할 경우 카메라의 Acquisition Frame Rate가 감소하고 이미지 손실이 발생할 수 있습니다. |
| 설명 | Basler CXP-12 Interface Card 1C/2C/4C 및 imaWorx CXP-12 Quad 프레임 그래버에는 PCIe Gen 3x8(Direct Memory Access) 이상의 호스트 인터페이스가 필요합니다. 이보다 느린 호스트 인터페이스를 사용하면 카메라의 Acquisition Frame Rate가 감소하고 이미지 손실이 발생할 수 있습니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | Frame Grabber 또는 Interface Card에서 이미지 손실이 발생한 경우, 손실된 이미지는 다음에 전달되는 Buffer에 표시됩니다. |
| 설명 | 사용자 응용 프로그램이 이미지를 전달하기 위해 Buffer를 충분히 빠르게 (재)대기열에 넣지 못하는 등의 이유로 버퍼 오버플로가 발생하여 Frame Grabber 또는 Interface Card에서 이미지가 손실된 경우, 손실된 이미지는 다음에 전달되는 Buffer에 표시됩니다. 손실된 이미지는 다음과 같이 표시됩니다. INCOMPLETE, 해당 파일 크기는 0, 및 사용자 정의 에러 코드 BUFFER_INFO_BASLER_XAPI_ERROR_CODE 로 설정된 경우, 42. 또한 손실된 프레임 하나가 스트림 정보에 추가됩니다. 오버플로로 인해 손실된 프레임 수와 관계없이 손실된 프레임은 하나만 추가된다는 점에 유의하십시오. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | Interface Card로 Applet을 변경하면 잘못된 장치 목록이 표시됨 |
| 설명 | Applet을 변경하는 동안 Interface Card에 연결된 카메라는 더 이상 액세스할 수 없음에도 불구하고 장치 목록에 계속 표시됩니다. 이 상태에서 카메라를 열려고 하면 오류 메시지가 나타납니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | 컴퓨팅 부팅 후 카메라가 감지되지 않을 수 있음 |
| 설명 | 드문 경우지만, 컴퓨터 부팅 후 카메라가 감지되지 않을 수 있습니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 카메라를 감지하려면 카메라의 전원을 껐다 켜십시오. |
| 티켓 ID | – |
| 요약 | Grabbing에 사용되는 Buffer 할당은 Heap Memory를 사용하여 수행해야 합니다. |
| 설명 | Grabbing에 사용되는 Buffer를 할당할 때 Buffer 주소는 8바이트 단위로 정렬되어야 합니다. Heap Memory를 사용하는 경우 이는 자동으로 처리됩니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | Heap Memory를 사용하십시오. |
| 티켓 ID | – |
| 요약 | PC에 pylon 및 Framegrabber SDK을(를) 동시에 설치할 때의 비호환성 문제 |
| 설명 | 컴퓨터에 pylon과 Framegrabber SDK가 모두 설치되어 있는 경우, Basler에서는 pylon 설치 시 CXP 옵션을 선택 해제할 것을 권장합니다. 경쟁하는 CXP Producer로 인해 발생하는 문제를 방지하려면 pylon 또는 Framegrabber SDK 중 하나만 Basler frame grabber 및/d또는 interface card를 제어하도록 해야 합니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 컴퓨터에 pylon과 Framegrabber SDK가 모두 설치되어 있는 경우, pylon 설치 시 CXP 옵션을 선택 해제하십시오. |
| 티켓 ID | – |
| 요약 | 초당 프레임 수(fps) 제한은 50000 fps와 90000 사이입니다. |
| 설명 | 초당 프레임 수(fps) 제한은 버퍼 수와 이미지 크기에 따라 50000 fps에서 90000 사이입니다. - 10개의 버퍼와 최소 이미지 크기 48x1을 사용할 경우 약 50000 fps의 제한이 발생합니다.
- 50개의 버퍼와 최소 이미지 크기 48x1을 사용할 경우 제한은 약 90000 fps입니다.
- 50개의 버퍼와 이미지 크기 8192x1을 사용할 경우 약 50000 fps의 제한이 발생합니다.
|
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | MCF 파일 저장 및 로드 시 배정밀도(Double) 값이 정수로 반올림됨 |
| 설명 | MCF 파일에서 구성을 로드할 때 쉼표 구분자가 있는 배정밀도 값이 가장 가까운 정수로 반올림될 수 있습니다. 이는 Linux 운영 체제의 현재 로케일 설정으로 인해 발생합니다. 로케일에서 점을 구분자로 정의하는 경우에는 반올림이 발생하지 않습니다. |
| 영향을 받는 OS | Linux |
| 임시 해결 방법 | 예를 들어 다음과 같이 적절한 로케일을 설정하십시오. LC_NUMERIC="C" ./<applicationName>, microDisplay X 또는 microDiagnostics를 시작하기 전에 설정하십시오. |
| 티켓 ID | 265213 |
| 요약 | 카메라가 올바른 이미지를 전송하지 않음 |
| 설명 | 링크가 여러 개인 카메라가 링크 전체의 이미지 데이터 분산과 관련된 CXP 표준을 준수하지 않는 경우, 카메라는 이미지를 올바르게 전송하지 못합니다. 이 문제는 JAI SP-12000C-CXP4 카메라에서 관찰되었습니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | 211645 |
| 요약 | Linux 드라이버에 신뢰할 수 있는 Basler 인증서로 서명할 수 없음 |
| 설명 | Linux에서 보안 부팅(UEFI 모드)을 사용하려면 신뢰할 수 있는 인증서로 서명된 드라이버가 필요합니다. 드라이버가 소스 코드로 제공되므로 신뢰할 수 있는 Basler 인증서로 서명할 방법이 없습니다. |
| 영향을 받는 OS | Linux |
| 임시 해결 방법 | 드라이버를 사용하려면 보안 부팅을 비활성화할 수 있습니다. 또는 이 Ubuntu 블로그 항목에 설명된 대로 드라이버에 서명할 수 있습니다. |
| 티켓 ID | – |
Framegrabber API
| 요약 | 높은 프레임 레이트로 이미지 표시 시 입력 지연이 발생할 수 있음 |
| 설명 | display_lib Framegrabber API 라이브러리를 사용할 때(Windows에서만 사용 가능), 높은 프레임 레이트(초당 약 10,000프레임)로 이미지를 표시하면 호스트 컴퓨터에서 입력 지연(예: 키보드 및 마우스 지연)이 발생할 수 있습니다. |
| 영향을 받는 OS | Windows |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
CLComDriver
| 요약 | 시스템에 CLSer 포트보다 더 많은 드라이버가 설치되어 있음 |
| 설명 | Install COM driver(s) for all Ports를 사용할 때 간혹 시스템의 CLSer 포트 수보다 더 많은 드라이버가 설치되는 경우가 있습니다. |
| 영향을 받는 OS | Windows |
| 임시 해결 방법 | 추가 포트를 선택하고 Remove selected COM driver 명령을 사용하여 제거하십시오. |
| 티켓 ID | – |
| 요약 | Basler Runtime 5.9.0 이하 버전에서 보드 유형이 인식되지 않음 |
| 설명 | Basler Runtime 5.9.0 이하 버전에서는 보드 유형이 인식되지 않으며 포트가 CLSer 식별자로만 표시됩니다. |
| 영향을 받는 OS | Windows |
| 임시 해결 방법 | Basler Runtime/Framegrabber SDK 버전을 5.10 이상으로 업데이트하십시오. |
| 티켓 ID | – |
| 요약 | 장치 관리자의 포트 설정이 실제 설정을 반영하지 않음 |
| 설명 | 장치 관리자의 포트 설정이 실제 설정을 반영하지 않으며 변경 사항이 적용되지 않습니다. |
| 영향을 받는 OS | Windows |
| 임시 해결 방법 | 포트 설정을 변경하려면 Windows COM Port API를 사용하십시오. |
| 티켓 ID | – |
Linux Driver
| 요약 | marathon Frame Grabber에서의 획득 작업 시 왜곡된 이미지가 출력됨 |
| 설명 | marathon CXP 및 CL 프레임 grabber에서 획득한 이미지가 왜곡되어 표시될 수 있습니다. 이는 Linux 드라이버가 IOMMU(Input-Output Memory Management Unit) 사용을 지원하지 않기 때문입니다. |
| 영향을 받는 OS | Linux |
| 임시 해결 방법 | 파일에 다음 줄을 추가하여 IOMMU(Input-Output Memory Management Unit)를 비활성화하십시오. etc/default/grub.txt: GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=off" |
| 티켓 ID | 336093 |
GenTL Producer
| 요약 | GenTL Device Discovery가 Camera Link Line Applets에서 작동하지 않음 |
| 설명 | 이 항목에 설명된 대로 ACL 또는 VCL과 같은 marathon Camera Link 프레임 그래버에 연결된 카메라는 GenPC 및 CLP를 통해 액세스할 수 있습니다. 현재 이 기능은 Area Scan Acquisition Applets에서만 작동하며 Line Scan Acquisition Applets에서는 작동하지 않습니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | 335339 |
| 요약 | GenTL BUFFER_INFO_FRAME_ID CXP 이미지 헤더 소스 태그 대신 모든 프레임에 대한 Counter 포함 |
| 설명 | GenTL BUFFER_INFO_FRAME_ID, 이는 다음을 통해 쿼리할 수 있습니다. DSGetBufferInfo,에는 CXP 이미지 헤더의 소스 태그가 포함되어 있지 않습니다. 대신 컴퓨터로 전달된 모든 프레임에 대한 Counter가 포함됩니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | 변경 후 재시작 필요 DeviceUserID 카메라의 |
| 설명 | 언제 DeviceUserID 카메라의 설정이 변경되면 변경 사항이 반영되도록 GenTL Producer를 재시작해야 합니다. 이는 GenTL API를 통한 방식과 pylon Viewer 즉, GenTL을 통해 카메라와 상호 작용하는 GUI를 사용하는 방식 모두에 영향을 미칩니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | GenTL 버전 1.4 이하인 Producer에 대한 제한적인 GenTL 지원 |
| 설명 | GenTL 버전 1.4 이하 Producer에 대한 제한된 GenTL 지원입니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | 이미지 크기는 2GB로 제한됨 |
| 설명 | GenTL Producer의 버퍼 크기 제한으로 인해 이미지 크기는 2GB로 제한됩니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | Acquisition Start 후 변경된 카메라 파라미터가 프레임 grabber에 반영되지 않음 |
| 설명 | 이미지 acquisition 중에 카메라 파라미터가 변경되면 이 변경 사항이 프레임 grabber에 반영되지 않습니다. 이는 GenTL Producer가 acquisition을 시작하기 전에 관련 파라미터(너비, 높이, 이미지 포맷 등)를 검색하고 이를 프레임 grabber와 동기화하기 때문입니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | 195482 및 225591 |
| 요약 | Applet이 변경되면 GenTL Device ID가 변경됨 |
| 설명 | GenTL 표준에 따라 장치 ID는 두 세션 간에 일정하게 유지되어야 합니다. 그러나 Applet이 변경되면 GenTL Device ID가 변경됩니다. 따라서 Device ID는 장치 ID가 생성된 Applet과 이름이 같은 Applet인 경우에만 재사용할 수 있습니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | – |
microDisplay X
| 요약 | Camera 탭을 열 때 microDisplay X가 중단됨 |
| 설명 | 카메라가 아직 검색되는 동안 Camera 탭을 클릭하면 microDisplay X가 중단됩니다. |
| 영향을 받는 OS | Linux 및 Windows |
| 임시 해결 방법 | 이 문제는 Framegrabber SDK 버전 5.11.5에서 해결되었습니다. Framegrabber SDK 버전을 5.11.5 이상으로 업데이트하십시오. |
| 티켓 ID | 333828 |
| 요약 | 로드된 Applet을 삭제한 후 microDisplay X가 응답하지 않음 |
| 설명 | Linux 시스템에서 Applet이 삭제된 후 사용 가능한 Applet에 대해 mE6 프레임 그래버를 다시 스캔하려고 하면 microDisplay X가 응답하지 않을 수 있습니다. |
| 영향을 받는 OS | Linux |
| 임시 해결 방법 | 이 문제는 Framegrabber SDK 버전 5.11.5에서 해결되었습니다. Framegrabber SDK 버전을 5.11.5 이상으로 업데이트하십시오. |
| 티켓 ID | 334080 |
| 요약 | 두 개의 카메라 operator가 포함된 VisualApplets 디자인의 경우 microDisplay X에서 카메라 감지가 작동하지 않을 수 있음 |
| 설명 | 두 개의 카메라 operator 중 적어도 하나의 operator에 두 개의 채널이 있고 리소스 인덱스가 직접 오름차순으로 할당된 VisualApplets 디자인의 경우 microDisplay X에서 카메라 감지가 작동하지 않습니다. 예를 들어, 각각 두 개의 채널이 있는 두 개의 카메라 operator에서 operator A는 포트 0과 1을 사용하고 operator B는 포트 2와 3을 사용합니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 리소스 인덱스를 직접 오름차순으로 할당하지 마십시오. 예를 들어 operator A의 채널을 포트 0과 2에 할당하고 operator B의 채널을 포트 1과 3에 할당하십시오. |
| 티켓 ID | 314206 |
| 요약 | 복잡한 디자인의 HAP 파일을 로드할 때 microDisplay X가 중단됨 |
| 설명 | 일부 매우 복잡한 VisualApplet 디자인은 microDisplay X에서 applet을 로드하는 중 또는 로드한 직후에 중단 현상을 유발할 수 있습니다. SDK 프로그램에서는 이러한 중단 현상이 관찰되지 않았습니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | microDisplay X에서 applet을 다시 로드하십시오. microDisplay X에서 applet 로드는 보통 두 번째나 세 번째 시도 후에 정상적으로 작동합니다. |
| 티켓 ID | 314234 |
| 요약 | 클린 Linux 설치 환경에서 microDisplay X가 시작되지 않음 |
| 설명 | Linux를 새로 설치한 환경에서 microDisplay X가 실행되지 않습니다. 이 문제의 원인은 Linux 클린 설치 시 xcb QT 플랫폼 플러그인이 누락되어 있기 때문입니다. |
| 영향을 받는 OS | Linux |
| 임시 해결 방법 | 다음 명령을 사용하여 누락된 플러그인을 설치하십시오. sudo apt install libxcb-xinerama0 명령입니다. |
| 티켓 ID | 259941 |
| 요약 | Linux 환경에서 microDisplay X 종료 시 충돌 발생 가능성 |
| 설명 | Linux 환경에서 microDisplay X를 닫을 때 간헐적으로 충돌이 발생할 수 있습니다. 이는 추가적인 문제를 야기하지 않으므로 무시해도 무방합니다. |
| 영향을 받는 OS | Linux |
| 임시 해결 방법 | 사용 가능한 임시 해결 방법이 없습니다. |
| 티켓 ID | 211811 |
python Wrapper
| 요약 | imaFlex 플랫폼용 python Wrapper 예제 사용 불가 |
| 설명 | imaFlex 플랫폼용 python Wrapper 예제는 Framegrabber SDK와 함께 제공되지 않습니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 다른 플랫폼용 예제를 사용하여 이에 맞게 조정하십시오. |
| 티켓 ID | – |
C# 래퍼
| 요약 | C# 래퍼가 FieldParameterInt에서 음수 값을 허용하지 않습니다. |
| 설명 | FieldParameterInt.value 은(는) 부호 없는 정수이며 Framegrabber SDK에서 이를 올바르게 처리합니다. C# 래퍼에서는 다음과 같이 음수 값을 할당하면 -1, 컴파일되지 않으므로 SiSoCsRt.Fg_setParameterWithFieldParameterInt 해당 숫자로 직접 호출할 수 없습니다. |
| 영향을 받는 OS | Windows 및 Linux |
| 임시 해결 방법 | 다음으로 값을 할당하십시오. unchecked 호출하기 전에 Fg_setParameterWithFieldParameterInt. 대상: -1, 다음을 사용하십시오 fieldParameter.value = unchecked((uint)-1);. |
| 티켓 ID | 332625 |