Known Issues Runtime 5.9.0#

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

모든 구성 요소#

요약	카메라가 올바른 이미지를 전송하지 않음
설명	링크가 여러 개인 카메라가 링크 간 이미지 데이터 분배와 관련된 CXP 표준을 준수하지 않는 경우, 컴퓨터로 올바른 이미지가 전송되지 않습니다. 이 문제는 JAI SP-12000C-CXP4 카메라에서 관찰되었습니다.
Affected OS	Windows 및 Linux
해결 방법	사용 가능한 해결 방법이 없습니다.
티켓 ID	TFS 211645

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

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

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

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

Frame Grabber#

요약	잘못된 이벤트 발생 시 LED 12EXT가 빨간색으로 켜짐
설명	LED 12EXT는 imaWorx가 외부 전원 공급 장치에 연결되지 않았을 때 빨간색으로 켜지도록 되어 있습니다. 그러나 이 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의 배수는 아닙니다.
Affected OS	Windows 및 Linux
영향을 받는 하드웨어	펌웨어 버전 3.0 S1.1 P1이 탑재된 CXP-12 Interface Card 1C 카드
해결 방법	8로 나누어 떨어지는 메모리 주소에 버퍼를 생성합니다. 원하는 버퍼 크기가 8로 나누어 떨어지지 않는 경우, 이 요구사항을 충족하도록 바이트를 추가로 할당하고 데이터를 처리할 때 이 패딩을 무시합니다.^a
티켓 ID	TFS 184670

요약	변경 사항: `DeviceUserID` GenTL Producer 또는 기타 응용 프로그램 재시작 필요
설명	When the `DeviceUserID` (정확히는 CXP 부트스트랩 레지스터의 값 `DeviceUserID`카메라의 )이(가) 변경되면 변경 사항이 GenTL API를 통해 반영되도록 GenTL Producer를 다시 시작해야 합니다. GenTL을 통해 카메라와 상호작용하기 위해 GUI(예: pylon Viewer)를 사용할 때는 변경 사항이 표시되도록 해당 응용 프로그램을 다시 시작해야 합니다.
Affected 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" 오류 메시지가 기록됩니다. 카메라 검색은 연결되지 않은 포트를 프로빙하고 그에 따라 링크 속도를 변경하므로, 응용 프로그램이 연결되지 않은 포트에서 새로운 카메라를 지속적으로 검색하려고 시도할 때 이 문제가 발생할 수 있습니다.
Affected OS	Windows 및 Linux
해결 방법	applet 다시 로드: 다른 applet을 로드한 다음 원래 applet을 다시 로드하여 applet을 다시 로드할 수 있습니다. 이름이 `SISO_FORCE_RELOAD_APPLET` 인 환경 변수가 값 예(으)로 정의된 경우, 다른 applet을 먼저 로드하지 않고도 다시 로드가 작동합니다.
티켓 ID	TFS 197127

SDK#

요약	카메라에서 프레임 그래버로의 느린 이미지 전송으로 인한 프레임 손상
설명	버퍼 (재)큐잉이 카메라에서 프레임 그래버로 이미지를 전송하는 것보다 느린 경우 손상된 이미지가 전달됩니다. 이 동작은 이미지 데이터를 검사해야만 감지할 수 있습니다.
Affected OS	Windows 및 Linux
해결 방법	이러한 손상된 이미지를 방지하려면 이미지 처리 및 버퍼 재대기열 작업이 카메라의 프레임 레이트보다 빨라야 합니다. 프레임 grabber의 내부 버퍼는 스케줄링 등으로 인한 사소한 지연을 상쇄하기에 충분합니다. 이 문제로 인해 생성된 손상된 프레임은 구성된 크기보다 작으므로, 예상치보다 작은 프레임을 이를 나타내는 지표로 사용할 수 있습니다. 프레임 데이터의 크기는 다음과 같이 확인할 수 있습니다. GenTL Producer 사용: 호출 `DSGetBufferInfo` (각각 `BUFFER_INFO_SIZE_FILLED` (으)로 명령을 실행합니다. 실행 NOT 두 개의 독립된 카메라를 병합하기 위해 `BUFFER_INFO_IS_INCOMPLETE` 및 확인하지 마십시오 `BUFFER_INFO_SIZE_FILLED` < `BUFFER_INFO_DATA_SIZE`. 이러한 검사는 항상 false. 자세한 내용은 다음 섹션을 참조하십시오. GenTL Producer. Framegrabber SDK / Fglib 사용: 호출 `Fg_getParameterEx` (각각 `FG_TRANSFER_LEN` 을 파라미터로 사용하십시오.
티켓 ID	TFS 207873

Cognex Adapter#

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

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

GenTL Producer#

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

요약	`BUFFER_INFO_DATA_SIZE` 프레임 크기 대신 전송된 바이트 수를 포함함
설명	버퍼 속성 `BUFFER_INFO_DATA_SIZE` 이(가) 예상대로 작동하지 않음: `BUFFER_INFO_DATA_SIZE` 은(는) 설정된 프레임 크기를 포함해야 합니다. 그러나 와 마찬가지로 실제 전송된 바이트 수를 포함합니다 `BUFFER_INFO_SIZE_FILLED`. 따라서 Property `BUFFER_INFO_IS_INCOMPLETE` 은(는) 항상 false.
Affected OS	Windows 및 Linux
해결 방법	의 의도된 값 `BUFFER_INFO_DATA_SIZE` usually equals the image's `width * height * pixel size`.
티켓 ID	TFS 211972

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

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

microDisplay X#

요약	설정 `TriggerState` 에서 활성 취득 시간 초과를 유발할 수 있음
설명	카메라에서 취득을 시작하기 전에 앱릿 파라미터 `TriggerState` 에서 활성 을(를) 설정하면 이미지가 전달되지 않고 취득 시간 초과가 발생할 수 있습니다.
Affected OS	Windows 및 Linux
해결 방법	이를 방지하려면 `TriggerState` 이(가) 취득이 시작된 후에만 활성화되는지 확인하십시오.
티켓 ID	TFS 191631

요약	Linux에서 microDisplay X를 닫을 때 충돌이 발생할 수 있음
설명	Linux에서 microDisplay X를 닫을 때 충돌이 발생할 수 있습니다. 이는 추가적인 문제를 발생시키지 않으므로 무시해도 됩니다.
Affected 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);

↩