Known Issues Runtime 5.9.0#

이 섹션에서는 Basler Runtime 버전 5.9.0의 알려진 문제에 대한 정보를 제공합니다.

모든 구성 요소#

요약	카메라에서 올바른 이미지가 출력되지 않음
설명	여러 링크를 사용하는 카메라가 링크 전체의 이미지 데이터 분산에 관한 CXP 표준을 준수하지 않을 경우, 컴퓨터로 올바른 이미지가 전달되지 않습니다. 이 문제는 JAI SP-12000C-CXP4 카메라에서 관찰되었습니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	TFS 211645

요약	카메라 시뮬레이터의 예기치 않은 동작
설명	Applet의 내부 카메라 시뮬레이터를 사용하면 예상보다 낮은 대역폭이 나타날 수 있습니다. 즉, 현재 시뮬레이터를 사용할 때 특정 오버플로 조건이 발생할 수 있음을 의미합니다. 실제 카메라를 사용할 때는 이러한 현상이 나타나지 않습니다. 이 문제는 내부 카메라 시뮬레이터와만 관련이 있습니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	–

요약	Windows Fast Startup에서 프레임 그래버가 작동하지 않음
설명	Fast Startup(Hybrid Boot 또는 Hybrid Shutdown으로도 알려짐)이 활성화된 Windows 8 이상에서는 하드웨어 구성을 변경하고 시스템을 재시작한 후 프레임 그래버가 더 이상 작동하지 않을 수 있습니다.
영향을 받는 OS	Windows 8 이상
임시 해결 방법	시스템을 재시작하면(종료가 아닌 명시적인 재시작) 이 문제가 해결됩니다. 문제를 완전히 방지하려면 www.windowscentral.com에 설명된 대로 Fast Startup을 비활성화하십시오.
티켓 ID	–

요약	고프레임 레이트로 이미지 표시 시 사용자 입력에 대한 응답이 느려질 수 있는 문제
설명	Framegrabber API 라이브러리 display_lib(Windows에서만 사용 가능)를 사용할 때, 고프레임 레이트(초당 약 10,000프레임)로 이미지를 표시하면 호스트 컴퓨터의 사용자 입력(예: 키보드 및 마우스)에 대한 응답이 느려질 수 있습니다.
영향을 받는 OS	Windows
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	–

요약	신뢰할 수 있는 Basler 인증서로 Linux 드라이버에 서명할 수 없음
설명	Linux에서 보안 부팅(UEFI 모드)을 사용하려면 신뢰할 수 있는 인증서로 서명된 드라이버가 필요합니다. 드라이버가 소스 코드로 제공되므로 신뢰할 수 있는 Basler 인증서로 서명할 방법이 없습니다.
영향을 받는 OS	Linux
임시 해결 방법	드라이버를 사용하려면 보안 부팅을 비활성화할 수 있습니다. 또는 이 Ubuntu 블로그 항목에 설명된 대로 드라이버에 서명할 수 있습니다.
티켓 ID	–

Frame Grabber#

요약	잘못된 이벤트 발생 시 LED 12EXT가 빨간색으로 켜짐
설명	imaWorx가 외부 전원 공급 장치에 연결되지 않은 경우 LED 12EXT가 빨간색으로 켜져야 합니다. 그러나 LED는 외부 전원 커넥터가 연결되어 있고 12V_EXT 대신 12V_DC_UP의 상태를 잘못 반영하는 경우에만 빨간색으로 켜집니다.
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	TFS 206709

Firmware#

요약	CXP-12 Interface Card 1C 카드 PCIe 통신 모듈로 인한 데이터 손실 및 시스템 멈춤 현상
설명	펌웨어 버전 3.0 S1.1 P1(및 해당 applet)이 탑재된 CXP-12 Interface Card 1C 카드의 PCIe 통신 모듈 문제로 인해 컴퓨터의 PCI 하드웨어 민감도에 따라 데이터 전송이 실패하고 시스템이 멈출 수 있습니다. 이는 다음과 같은 경우에 발생할 수 있습니다: 버퍼의 메모리 주소가 PCI 페이로드 크기 경계보다 4바이트 뒤에서 시작하거나 4바이트 앞에서 끝납니다. 카메라는 4의 배수이지만 8의 배수는 아닌 바이트 단위 크기의 프레임을 생성합니다.
영향을 받는 OS	Windows 및 Linux
영향을 받는 하드웨어	펌웨어 버전 3.0 S1.1 P1이 탑재된 CXP-12 Interface Card 1C 카드
임시 해결 방법	8로 나누어떨어지는 메모리 주소에 버퍼를 생성합니다. 원하는 버퍼 크기가 8로 나누어떨어지지 않으면 이 요구사항에 맞게 바이트를 추가로 할당하고 데이터를 처리할 때 이 패딩을 무시합니다.^a
티켓 ID	TFS 184670

요약	변경 사항: `DeviceUserID` GenTL Producer 또는 기타 응용 프로그램 재시작 필요
설명	언제 `DeviceUserID` (정확히는 CXP 부트스트랩 레지스터의 값 `DeviceUserID`)가 변경되면, 해당 변경 사항이 GenTL API를 통해 반영되도록 GenTL Producer를 재시작해야 합니다. GenTL을 통해 GUI로 카메라와 상호 작용하는 경우(예: pylon Viewer), 변경 사항이 적용되도록 해당 응용 프로그램을 재시작해야 합니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	TFS 207518

CXP-12 Interface Card 1C Applet#

요약	빈번한 링크 속도 변경으로 인한 오류 발생
설명	한 포트에서 CXP 링크 속도가 빈번하게 변경되면 속도 변경이 더 이상 작동하지 않는 상황이 발생할 수 있습니다. 이 경우 "Failed to set bitrate of uplink transceivers" 및 "Failed to set bitrate of downlink transceivers" 오류 메시지가 기록됩니다. 카메라 검색은 연결되지 않은 포트도 조사하여 링크 속도를 변경하므로, 응용 프로그램이 연결되지 않은 포트에서 새 카메라를 자주 검색하려고 할 때 이 문제가 발생할 수 있습니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	Applet 다시 로드: 다른 applet을 로드한 다음 원래 applet을 다시 로드하여 applet을 다시 로드할 수 있습니다. 만약 이름이 `SISO_FORCE_RELOAD_APPLET` 인 환경 변수가 다음 값으로 정의되어 있는 경우 yes, 다른 applet을 먼저 로드하지 않고도 다시 로드할 수 있습니다.
티켓 ID	TFS 197127

SDK#

요약	카메라에서 프레임 그래버로의 느린 이미지 전송으로 인한 손상된 프레임
설명	버퍼 (재)큐잉 속도가 카메라에서 프레임 그래버로 이미지를 전송하는 속도보다 느리면 손상된 이미지가 전달됩니다. 이 현상은 이미지 데이터를 검사해야만 감지할 수 있습니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	이러한 손상된 이미지를 방지하려면 이미지 처리 및 버퍼 재대기열 작업이 카메라의 프레임 레이트보다 빨라야 합니다. 프레임 그래버의 내부 버퍼는 스케줄링 등으로 인한 사소한 지연을 상쇄하기에 충분합니다. 이 문제로 인해 생성된 손상된 프레임은 설정된 크기보다 작으므로, 예상보다 작은 프레임을 이를 나타내는 지표로 사용할 수 있습니다. 프레임 데이터의 크기는 다음과 같이 확인할 수 있습니다. GenTL Producer 사용: 호출 `DSGetBufferInfo` 호출 `BUFFER_INFO_SIZE_FILLED` 을(를) 명령어로 사용합니다. Do NOT use `BUFFER_INFO_IS_INCOMPLETE` 그리고 다음을 확인하지 않습니다. `BUFFER_INFO_SIZE_FILLED` < `BUFFER_INFO_DATA_SIZE`. These checks will always be false. 자세한 내용은 다음 섹션을 참조하세요. GenTL Producer. 프레임 그래버 SDK / fglib 사용: 호출 `Fg_getParameterEx` 호출 `FG_TRANSFER_LEN` 파라미터로 사용하십시오.
티켓 ID	TFS 207873

Cognex Adapter#

요약	Cognex VisionPro는 Admin 사용자 권한으로 시작해야 합니다.
설명	프레임 그래버에 액세스하려면 Cognex VisionPro를 Admin 사용자 권한으로 시작해야 합니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	TFS 187245

요약	메모리 부족으로 인해 대형 이미지의 Acquisition 실패 발생
설명	큰 ROI(예: 4096 x 3000)를 설정할 때 "The acquisition failed abnormally. (Adapter image pool full.)" 메시지와 함께 Acquisition 시작이 실패할 수 있습니다. 이는 VisionPro가 벤더별 어댑터에서 사용할 수 있는 Memory를 제한하기 때문에 발생합니다.
영향을 받는 OS	Windows
임시 해결 방법	이를 방지하려면 Cognex VisionPro Adapter Manual에 설명된 대로 Windows 레지스트리를 통해 한도를 늘리세요.
티켓 ID	TFS 203605

GenTL Producer#

요약	Acquisition Start 후에 변경된 카메라 Parameter는 프레임 그래버에 반영되지 않음
설명	이미지 획득 중에 카메라 파라미터를 변경해도 변경 사항이 frame grabber에 반영되지 않습니다. 이는 GenTL Producer가 획득 시작 전에 관련 파라미터(너비, 높이, 이미지 포맷 등)를 조회하여 이를 frame grabber와 동기화하기 때문입니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	TFS 195482

요약	`BUFFER_INFO_DATA_SIZE` 프레임 크기 대신 전송된 바이트 수를 포함합니다.
설명	버퍼 Property `BUFFER_INFO_DATA_SIZE` 예상대로 작동하지 않습니다. `BUFFER_INFO_DATA_SIZE` 에는 구성된 프레임 크기가 포함되어야 합니다. 그러나 다음과 같이 실제 전송된 바이트 수가 포함됩니다. `BUFFER_INFO_SIZE_FILLED`따라서 Property `BUFFER_INFO_IS_INCOMPLETE` 은(는) 항상 다음으로 유지됩니다. false.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	의 의도된 값은 다음과 같습니다. `BUFFER_INFO_DATA_SIZE` 은(는) 대개 이미지의 `width * height * pixel size`.
티켓 ID	TFS 211972

요약	Applet이 변경되면 GenTL Device ID가 변경됨
설명	GenTL 표준에 따르면 디바이스 ID는 두 세션 간에 일정하게 유지되어야 합니다. 그러나 Applet이 변경되면 GenTL 디바이스 ID가 변경됩니다. 따라서 하나의 Applet으로 조회한 디바이스 ID는 디바이스 ID가 생성된 원본 Applet과 이름이 같은 경우에만 다른 보드 및 다른 Applet에서 사용할 수 있습니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	–

요약	`BUFFER_INFO_FRAME_ID` CXP 이미지 헤더의 소스 태그 대신 모든 프레임에 대한 Counter를 포함합니다.
설명	GenTL `BUFFER_INFO_FRAME_ID`, 다음을 통해 쿼리할 수 있습니다. `DSGetBufferInfo`,에는 CXP 이미지 헤더의 소스 태그가 포함되어 있지 않습니다. 대신 컴퓨터로 전달된 모든 프레임에 대한 Counter가 포함됩니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	TFS 197430

microDisplay X#

요약	Setting `TriggerState` (으)로 활성 Acquisition 타임아웃을 유발할 수 있음
설명	Applet Parameter `TriggerState` (으)로 활성 을(를) 카메라에서 Acquisition을 시작하기 전에 설정하면 이미지가 전달되지 않고 Acquisition 타임아웃이 발생할 수 있습니다.
영향을 받는 OS	Windows 및 Linux
임시 해결 방법	이를 방지하려면 `TriggerState` 이(가) Acquisition이 시작된 후에만 활성화되도록 하세요.
티켓 ID	TFS 191631

요약	Linux 환경에서 microDisplay X 종료 시 충돌 발생 가능성
설명	Linux 환경에서 microDisplay X를 닫을 때 간헐적으로 충돌이 발생할 수 있습니다. 이는 추가적인 문제를 야기하지 않으므로 무시해도 무방합니다.
영향을 받는 OS	Linux
임시 해결 방법	사용 가능한 임시 해결 방법이 없습니다.
티켓 ID	TFS 211811

다음 코드 예제를 사용하여 이러한 데이터 전송 문제가 없는 버퍼를 생성할 수 있습니다.


 // create a ROI that could trigger the issue (for demonstration purposes only!)

    size_t imageWidthPx = 252;

    size_t imageHeightPx = 15;

    size_t pixelSizeBytes = 1;

// compute the required buffer size for one image

size_t imageSizeBytes = imageWidthPx * imageHeightPx * pixelSizeBytes;

// set the buffer size to the nearest larger size that is divisible by 8

size_t bufferSizeBytes = ((imageSizeBytes + 7) / 8) * 8;

// add 4 more bytes so we can add an offset of 4 bytes if the address ends up being only 4 byte aligned

bufferSizeBytes += 4;

// allocate the buffer

uint8_t* imageBuffer = (uint8_t*)malloc(bufferSizeBytes);

// sanitize the address

uint8_t* sanitizedImageBuffer = (((uintptr_t)(imageBuffer)) % 8 == 0)

    ? imageBuffer

    : imageBuffer + 4;

 /* [use the sanitized buffer] */

// free the original(!) buffer

free(imageBuffer);

↩︎