Known Issues Framegrabber SDK 5.11.8
이 섹션에서는 Basler Framegrabber SDK 버전 5.11.8의 알려진 문제에 대한 정보를 제공합니다.
모든 구성 요소
| 요약 | 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 프레임 그래버에는 PCIe Gen 3x8(직접 메모리 액세스) 이상의 호스트 인터페이스가 필요합니다. 더 느린 호스트 인터페이스를 사용하면 카메라의 Acquisition Frame Rate가 저하되고 이미지 손실이 발생할 수 있습니다. |
| Affected OS | Linux 및 Windows |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | 프레임 그래버 또는 인터페이스 카드에서 이미지가 손실된 경우, 손실된 이미지는 다음에 전달되는 버퍼에 표시됩니다. |
| 설명 | 예를 들어 사용자 애플리케이션이 이미지를 전달하기 위해 버퍼를 충분히 빠르게 (재)큐에 넣지 않아 버퍼 오버플로로 인해 프레임 그래버 또는 인터페이스 카드에서 이미지가 손실된 경우, 손실된 이미지는 다음에 전달되는 버퍼에 표시됩니다. 손실된 이미지는 다음과 같이 표시됩니다. INCOMPLETE, 파일 크기는 0, 사용자 지정 오류 코드는 BUFFER_INFO_BASLER_XAPI_ERROR_CODE 이 다음으로 설정된 경우 42. 또한 스트림 정보에 손실된 프레임이 하나 추가됩니다. 오버플로로 인해 손실된 프레임 수와 관계없이 손실된 프레임은 하나만 추가됩니다. |
| Affected OS | Linux 및 Windows |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | Interface Card에서 Applet을 변경하면 잘못된 장치 목록이 표시됨 |
| 설명 | Applet을 변경하는 동안 Interface Card에 연결된 카메라는 더 이상 액세스할 수 없음에도 불구하고 장치 목록에 계속 표시됩니다. 이 상태에서 카메라를 열려고 하면 오류 메시지가 표시됩니다. |
| Affected OS | Linux 및 Windows |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | 컴퓨터 부팅 후 카메라가 감지되지 않을 수 있습니다. |
| 설명 | 드물게 컴퓨터를 부팅한 후 카메라가 감지되지 않을 수 있습니다. |
| Affected OS | Linux 및 Windows |
| 해결 방법 | 카메라를 감지하려면 카메라의 전원을 재부팅하세요. |
| 티켓 ID | – |
| 요약 | 그래빙에 사용되는 버퍼 할당은 힙 메모리를 사용하여 수행해야 합니다. |
| 설명 | 그래빙에 사용되는 버퍼를 할당할 때 버퍼 주소는 8바이트 단위로 정렬되어야 합니다. 힙 메모리를 사용하는 경우 이는 자동으로 충족됩니다. |
| Affected OS | Linux 및 Windows |
| 해결 방법 | 힙 메모리를 사용하세요. |
| 티켓 ID | – |
| 요약 | PC에 pylon과 Framegrabber SDK를 동시에 설치할 때 발생하는 비호환성 문제 |
| 설명 | 컴퓨터에 pylon과 Framegrabber SDK가 모두 설치된 경우, Basler는 pylon 설치 시 CXP 옵션을 선택 해제할 것을 권장합니다. 경쟁하는 CXP-producers로 인한 문제를 방지하려면 pylon 또는 Framegrabber SDK 중 하나가 Basler 프레임 그래버 및/또는 인터페이스 카드를 작동하도록 해야 합니다. |
| Affected OS | 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로 제한됩니다.
|
| Affected OS | Linux 및 Windows |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | MCF 파일 저장 및 로드 시 실수형 값이 정수로 반올림되는 현상 |
| 설명 | MCF 파일에서 구성을 로드할 때 콤마 구분 기호가 있는 실수형 값이 가장 가까운 정수로 반올림될 수 있습니다. 이는 Linux 운영 체제의 현재 로케일 설정으로 인해 발생합니다. 로케일에서 구분 기호로 점을 정의하는 경우 반올림이 발생하지 않습니다. |
| Affected OS | Linux |
| 해결 방법 | 예를 들어 다음과 같이 적절한 로케일을 설정하십시오. LC_NUMERIC="C" ./<applicationName>, microDisplay X 또는 microDiagnostics를 시작하기 전에 설정하세요. |
| 티켓 ID | 265213 |
| 요약 | 카메라에서 올바른 이미지를 출력하지 못함 |
| 설명 | 멀티 링크 카메라가 링크 간 이미지 데이터 분산과 관련된 CXP 표준을 준수하지 않을 경우, 카메라가 이미지를 올바르게 전송하지 못합니다. 이 문제는 JAI SP-12000C-CXP4 카메라에서 관찰되었습니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | 211645 |
| 요약 | Linux 드라이버에 신뢰할 수 있는 Basler 인증서를 서명할 수 없음 |
| 설명 | Linux에서 보안 부팅(UEFI 모드)을 사용하려면 신뢰할 수 있는 인증서로 서명된 드라이버가 필요합니다. 드라이버가 소스 코드로 제공되므로 신뢰할 수 있는 Basler 인증서로 서명할 방법이 없습니다. |
| Affected OS | Linux |
| 해결 방법 | 드라이버를 사용하려면 보안 부팅을 비활성화하면 됩니다. 또는 이 Ubuntu 블로그 항목에 설명된 대로 드라이버에 직접 서명할 수 있습니다. |
| 티켓 ID | – |
Framegrabber API
| 요약 | 높은 프레임 레이트로 이미지 표시 시 입력 지연이 발생할 수 있음 |
| 설명 | display_lib Framegrabber API 라이브러리를 사용하는 경우(Windows에서만 사용 가능), 높은 프레임 레이트(초당 약 10,000프레임)로 이미지를 표시하면 호스트 컴퓨터에 입력 지연(예: 키보드 및 마우스 지연)이 발생할 수 있습니다. |
| Affected OS | Windows |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
CLComDriver
| 요약 | 시스템에 CLSer 포트보다 더 많은 드라이버가 설치되어 있음 |
| 설명 | Install COM driver(s) for all Ports를 사용할 때 때때로 시스템의 CLSer 포트 수보다 더 많은 드라이버가 설치될 수 있습니다. |
| Affected OS | Windows |
| 해결 방법 | 추가 포트를 선택하고 Remove selected COM driver 명령을 사용하여 제거하십시오. |
| 티켓 ID | – |
| 요약 | Basler Runtime 5.9.0 이전 버전에서는 보드 유형이 인식되지 않음 |
| 설명 | Basler Runtime 5.9.0 이전 버전에서는 보드 유형이 인식되지 않으며 포트가 CLSer 식별자로만 표시됩니다. |
| Affected OS | Windows |
| 해결 방법 | Basler Runtime/Framegrabber SDK 버전을 5.10 이상으로 업데이트하십시오. |
| 티켓 ID | – |
| 요약 | 장치 관리자의 포트 설정이 실제 설정을 반영하지 않음 |
| 설명 | 장치 관리자의 포트 설정이 실제 설정을 반영하지 않으며 변경 사항이 적용되지 않습니다. |
| Affected OS | Windows |
| 해결 방법 | 포트 설정을 변경하려면 Windows COM Port API를 사용하십시오. |
| 티켓 ID | – |
Linux Driver
| 요약 | marathon Frame Grabber에서의 획득 결과가 왜곡된 이미지로 출력됨 |
| 설명 | marathon CXP 및 CL frame grabber에서 획득한 이미지가 왜곡되어 표시될 수 있습니다. 이는 Linux 드라이버가 IOMMU(Input-Output Memory Management Unit) 사용을 지원하지 않기 때문입니다. |
| Affected OS | Linux |
| 해결 방법 | 파일에 다음 줄을 추가하여 IOMMU(Input-Output Memory Management Unit)를 비활성화하십시오. etc/default/grub.txt: GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=off" |
| 티켓 ID | 336093 |
GenTL Producer
| 요약 | GenTL BUFFER_INFO_FRAME_ID CXP 이미지 헤더 소스 태그 대신 모든 프레임에 대한 Counter 포함 |
| 설명 | GenTL BUFFER_INFO_FRAME_ID은(는) DSGetBufferInfo에는 CXP 이미지 헤더의 소스 태그가 포함되지 않습니다. 대신 컴퓨터로 전송된 모든 프레임에 대한 Counter가 포함됩니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | 변경 후 재시작 필요: DeviceUserID 카메라의 |
| 설명 | When the DeviceUserID 카메라의 설정이 변경되면, 변경 사항이 반영되도록 GenTL Producer를 재시작해야 합니다. 이는 GenTL API를 사용하는 방법과 GenTL을 통해 카메라와 상호 작용하는 GUI(예: pylon Viewer)를 사용하는 방법 모두에 적용됩니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | GenTL 버전 1.4 이하인 Producer에 대한 제한된 GenTL 지원 |
| 설명 | GenTL 버전 1.4 이하인 Producer에 대한 제한된 GenTL 지원입니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | 이미지 크기는 2 GB로 제한됨 |
| 설명 | GenTL Producer의 버퍼 크기 제한으로 인해 이미지 크기는 2 GB로 제한됩니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
| 요약 | Acquisition Start 이후에 변경된 카메라 파라미터가 프레임 그래버에 반영되지 않음 |
| 설명 | 이미지 취득(Acquisition) 중에 카메라 파라미터가 변경되면 해당 변경 사항이 프레임 그래버에 반영되지 않습니다. 이는 GenTL Producer가 취득 시작 전에 관련 파라미터(너비, 높이, 이미지 형식 등)를 가져와 프레임 그래버와 동기화하기 때문입니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | 195482 및 225591 |
| 요약 | Applet이 변경될 때 GenTL Device ID가 변경됨 |
| 설명 | GenTL 표준에 따르면 Device ID는 두 세션 사이에서 일정하게 유지되어야 합니다. 그러나 Applet이 변경되면 GenTL Device ID가 변경됩니다. 따라서 Device ID는 Device ID가 생성되었던 Applet과 동일한 이름의 Applet인 경우에만 재사용할 수 있습니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | – |
microDisplay X
| 요약 | 두 개의 카메라 오퍼레이터를 포함하는 VisualApplets 디자인의 경우 microDisplay X에서 카메라 감지가 간헐적으로 작동하지 않음 |
| 설명 | 최소한 하나의 오퍼레이터에 두 개의 채널이 있고 리소스 인덱스가 직접 오름차순으로 할당된 두 개의 카메라 오퍼레이터를 포함하는 VisualApplets 디자인의 경우 microDisplay X에서 카메라 감지가 작동하지 않습니다. 예를 들어 각각 두 개의 채널이 있는 두 개의 카메라 오퍼레이터에서 오퍼레이터 A가 포트 0과 1을 사용하고 오퍼레이터 B가 포트 2와 3을 사용하는 경우입니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 리소스 인덱스를 직접 오름차순으로 할당하지 마십시오. 예를 들어 오퍼레이터 A의 채널을 포트 0과 2에 할당하고, 오퍼레이터 B의 채널을 포트 1과 3에 할당하십시오. |
| 티켓 ID | 314206 |
| 요약 | 복잡한 디자인의 HAP 파일을 로드할 때 microDisplay X가 중단됨 |
| 설명 | 매우 복잡한 일부 VisualApplets 디자인의 경우 microDisplay X에서 Applet을 로드하는 동안 또는 로드 직후에 충돌이 발생할 수 있습니다. SDK 프로그램에서는 이러한 충돌이 관찰되지 않았습니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | microDisplay X에서 Applet을 다시 로드하십시오. microDisplay X에서 Applet 로드는 대개 두 번째 또는 세 번째 시도 후에 정상적으로 작동합니다. |
| 티켓 ID | 314234 |
| 요약 | 새로 설치된 Linux 환경에서 microDisplay X가 시작되지 않음 |
| 설명 | 깨끗하게 설치된 Linux 환경에서 microDisplay X가 실행되지 않습니다. 이 문제의 원인은 깨끗하게 설치된 Linux 환경에 xcb Qt 플랫폼 플러그인이 누락되었기 때문입니다. |
| Affected OS | Linux |
| 해결 방법 | 다음 항목을 사용하여 누락된 플러그인을 설치하십시오. sudo apt install libxcb-xinerama0 command. |
| 티켓 ID | 259941 |
| 요약 | Linux에서 microDisplay X를 닫을 때 충돌이 발생할 수 있음 |
| 설명 | Linux에서 microDisplay X를 닫을 때 충돌이 발생할 수 있습니다. 이는 추가적인 문제를 발생시키지 않으므로 무시해도 됩니다. |
| Affected OS | Linux |
| 해결 방법 | 사용 가능한 해결 방법이 없습니다. |
| 티켓 ID | 211811 |
| 요약 | Camera 탭을 열 때 microDisplay X에 충돌이 발생할 수 있음 |
| 설명 | Camera 탭을 열면 microDisplay X에 충돌이 발생할 수 있습니다. 이는 하나의 mE6 그래버에 단일 카메라가 연결되어 있고 검색이 완료된 상태에서, microDisplay X를 실행한 후 첫 번째 클릭이 Camera 탭일 때 발생합니다. |
| Affected OS | Windows 및 Linux |
| 해결 방법 | 카메라가 검색되기 전에 Camera 탭을 여십시오. |
| 티켓 ID | 333828 |