Operator CXPQuadCamera

Operator Library: Hardware Platform

이 오퍼레이터는 CXP 쿼드 채널 카메라와 VisualApplets 간의 이미지 데이터 인터페이스를 나타냅니다.

하드웨어 플랫폼별 사용 가능 여부
mE5 marathon VCX-QP
mE5 ironman VQ8-CXP6D
mE5 ironman VQ8-CXP6B

오퍼레이터는 출력 O에서 이미지 데이터를 제공합니다. 이 출력은 항상 존재합니다.

이 표준 출력 포트 외에도 선택적 입력 및 출력 세트를 구성할 수 있습니다.

오퍼레이터 인스턴스화 중에 다음 팝업 대화상자가 나타납니다.

여기서 CXP 케이블을 통한 범용 입력 및 출력을 위한 선택적 포트와 카메라와의 양방향 선택적 트리거 포트를 지정할 수 있습니다.

특정 GPI(General Purpose Inputs), 특정 GPO(General Purpose Outputs), 트리거 입력 포트, 그리고 트리거 출력 포트의 사용 가능 여부를 정의할 수 있습니다.

포트 사용 가능 여부를 "0"(기본값)으로 설정하면 해당 포트가 operator에 나타나지 않습니다. 포트 사용 가능 여부를 1로 설정하면 특정 포트를 operator 인터페이스에서 사용할 수 있습니다.

이 오퍼레이터는 CameraPort 타입의 리소스 4개를 사용합니다.

[중요] 이미지 너비 및 이미지 높이 수정

너비와 높이를 카메라 고유 설정으로 수정할 수 있습니다. 단, 오퍼레이터 포트 O의 최대 이미지 너비는 포트 O의 Parallelism으로 나누어떨어져야 합니다.

최대 이미지 너비가 포트 O의 Parallelism으로 나누어떨어지는지 확인하십시오!

[중요] Parallelism 값

포트 O의 Parallelism은 최소값(매개변수 MinimalParallelism에 명시됨) 이상으로 설정해야 합니다. Parallelism을 이보다 낮게 설정하는 것은 허용되지 않습니다. 최소 Parallelism은 이 오퍼레이터의 다른 매개변수들에 대해 정의한 값을 바탕으로 VisualApplets에 의해 계산됩니다. 이를 통해 들어오는 데이터를 항상 수신할 수 있습니다.

[중요] 더미 픽셀

출력 데이터에 더미 픽셀이 포함될 수 있습니다. 이는 오퍼레이터가 Parallelism을 두 번 변환할 수 있기 때문에 발생합니다. 먼저, 오퍼레이터는 내부적으로 자신이 계산하여 매개변수 MinimalParallelism에서 읽기 전용 값으로 제공하는 최소 Parallelism으로 변환합니다. 이로 인해 Parallelism 변환으로 인해 추가된 더미 값이 잠재적으로 포함되며 MinimalParallelism으로 나누어떨어지는 내부 이미지 너비가 생성됩니다. 둘째, 첫 번째 Parallelism 변환으로 생성된 패딩된 이미지 너비가 O.Parallelism의 배수가 아닌 경우, 오퍼레이터는 Parallelism을 O.Parallelism으로 변환하여 더 많은 더미 값을 잠재적으로 추가합니다. 따라서 출력 데이터에 더미 픽셀이 포함되는지는 MinimalParallelism 매개변수, 이미지 너비, 그리고 O.Parallelism에 따라 달라집니다. 각 Parallelism 변환은 더미 픽셀을 추가할 수 있습니다. 추가된 더미 픽셀에는 정의되지 않은 데이터 값이 포함되어 있으며 실제 이미지 너비와 다른 이미지 너비를 초래합니다.

예: MinimalParallelism이 20이고 O.Parallelism이 32이며 전송된 이미지 너비가 128픽셀인 경우, MinimalParallelism 파라미터에 정의된 20의 내부 Parallelism으로 인해 오퍼레이터는 내부적으로 너비가 140인 이미지 라인을 생성합니다. 출력의 경우 데이터 벡터가 Parallelism 32(O.Parallelism)로 변환되어 결과적으로 이미지 라인 너비가 160픽셀이 됩니다.

더미 픽셀로 인해 예상되는 출력 이미지 너비는 다음과 같습니다:

[중요] Bit Width 및 형식 타입

포트 O(이미지 포트)의 Bit Width는 선택한 형식 타입(매개변수 FormatType)에 따라 다릅니다:

  • FormatType = Gray인 경우: Bit Width는 임의의 값을 가질 수 있습니다(VAF_Gray 및 FL_NONE).
  • FormatType = RGB인 경우: Bit Width는 3의 배수입니다(VAF_Color 및 FL_RGB).
  • FormatType = RGBA인 경우: Bit Width는 4의 배수입니다(VAF_Gray 및 FL_NONE).
  • FormatType = RAW인 경우: Bit Width는 32입니다(VAF_Gray 및 FL_NONE).

I/O Properties

Property Value
Operator Type M
Input Links - TriggerI(선택 사항), CXP 채널을 통해 프레임 그래버에서 카메라로 전송되는 트리거. 이 포트는 라인 스캔 카메라를 트리거하는 데 자주 사용됩니다.
- GPIx(선택 사항), CXP 채널을 통해 프레임 그래버에서 카메라로 전송되는 범용 입력 [x]. 사용 가능한 항목은 GPI0, GPI1, GPI2, GPI3, GPI4, GPI5, GPI6 및 GPI7입니다.
Output Links - O, 이미지 데이터 출력
- TriggerO(선택 사항), CXP 채널을 통해 카메라에서 프레임 그래버로 전송되는 트리거.
- GPOx(선택 사항), CXP 채널을 통해 카메라에서 프레임 그래버로 전송되는 범용 출력 [x]. 사용 가능한 항목은 GPO0, GPO1, GPO2, GPO3, GPO4, GPO5, GPO6 및 GPO7입니다.

Supported Link Format

Link Parameter 출력 링크 - O Input Link - TriggerI (선택 사항) Output Link - TriggerO (선택 사항) Input Link - GPIx (선택 사항) Output Link - GPOx (선택 사항)
Bit Width any 1 1 1 1
Arithmetic unsigned unsigned unsigned unsigned unsigned
Parallelism any1 1 1 1 1
Kernel Columns 1 1 1 1 1
Kernel Rows 1 1 1 1 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} (default: VALT_IMAGE2D) VALT_SIGNAL VALT_SIGNAL VALT_SIGNAL VALT_SIGNAL
Color Format {VAF_GRAY, VAF_COLOR}

VAF_GRAY = FL_NONE

VAF_COLOR = FL_RGB

(Color Format이 VAF_GRAY인 경우 Color Flavor는 FL_NONE이며, Color Format이 VAF_COLOR인 경우 Color Flavor는 FL_RGB입니다.)

VAF_GRAY VAF_GRAY VAF_GRAY VAF_GRAY
Color Flavor {FL_NONE, FL_RGB}

VAF_GRAY = FL_NONE

VAF_COLOR = FL_RGB

(Color Format이 VAF_GRAY인 경우 Color Flavor는 FL_NONE이며, Color Format이 VAF_COLOR인 경우 Color Flavor는 FL_RGB입니다.)

FL_NONE FL_NONE FL_NONE FL_NONE
Max. Img Width 임의 (기본값: 1024) 1 1 1 1
Max. Img Height 임의 (기본값: 1024) 1 1 1 1

1

파라미터 MinimalParallelism에 명시된 최소값 이상으로 설정해야 합니다.

MinimalParallelism와 O.Paralleism이 서로 다를 경우, Parallelism이 두 번 변환되며 매번 더미 값이 추가될 수 있습니다. 이러한 더미 픽셀로 인해 예상되는 출력 이미지 너비는 다음과 같습니다.

Parameters

CameraID
Type static write parameter
Default
Range {-1, 0, 1, 2, 3}

CameraID 파라미터는 카메라 오퍼레이터의 펌웨어에 대한 CXP 마스터 포트 ID를 정의하여 자동 CXP 토폴로지 검색(카메라에서 앱렛으로, 앱렛에서 카메라로)을 허용합니다.

이 파라미터를 사용하여 오퍼레이터 내에서 ID를 직접 지정할 수 있습니다. 그러나 Resources 대화상자에서 오퍼레이터의 리소스를 지정하는 것을 권장합니다. (Resources 대화상자를 열려면 카메라 오퍼레이터를 강조 표시하고 Design 메뉴에서 Resources 메뉴 항목을 선택하면 됩니다.) CameraID 파라미터는 리소스 대화상자 파라미터를 사용하여 올바른 마스터 포트로 자동 업데이트됩니다. 다음 예시는 단일 카메라와 듀얼 카메라 각각 하나를 사용하는 경우를 보여줍니다.

module3(단일 카메라)의 CameraID(CXP 마스터 포트 ID)는 2입니다. module5(듀얼 카메라)의 CameraID(CXP 마스터 포트 ID)는 1입니다.

듀얼 카메라는 2개의 CXP 카메라 포트가 필요합니다. (쿼드 카메라는 4개의 포트가 필요합니다.) 오퍼레이터의 CameraID 파라미터에는 마스터 포트만 반영됩니다.

가능한 것보다 더 많은 CameraPort 리소스를 정의하는 경우(최대 4개), 예를 들어 5개의 "CXPSingleCamera" 오퍼레이터를 인스턴스화할 때 CameraPort 리소스를 가장 마지막에 요청하는 카메라 오퍼레이터(사용 가능한 4개가 이미 모두 점유된 상태)는 자신의 CameraID를 -1로 설정합니다. 이 경우 디자인 규칙 검사에서 오류가 보고됩니다.

파라미터 CameraID의 범위는 {-1,0,1,2,3}입니다.

MinimalParallelism
Type 정적 읽기 파라미터
Default 20
Range [1 : 512]

데이터 손실 없이 카메라의 최대 대역폭을 전송할 수 있는 출력 링크 O의 minimal parallelism을 제공하는 읽기 전용 파라미터입니다. Minimal parallelism은 자동으로 계산됩니다.

값은 파라미터 FormatMode에서 선택한 pixel format에 따라 다릅니다.

파라미터 FormatMode를 동적(dynamic) 파라미터로 정의하는 경우(아래의 파라미터 FormatMode 설명 참조), 발생할 수 있는 가장 작은 minimal parallelism이 계산됩니다.

Minimal parallelism로 인해 더미 픽셀이 생성될 수 있는데, 오퍼레이터가 parallelism을 두 번 변환하고 이 과정에서 더미 값을 추가할 수 있기 때문입니다. 이러한 더미 픽셀로 인해 예상되는 출력 이미지 너비는 다음과 같습니다.

Status
Type 동적 읽기 파라미터
Default
Range {0; 2^7-1}

Status 파라미터는 카메라 오퍼레이터의 현재 상태를 나타내는 런타임 읽기 전용 파라미터입니다. Bit[0]은 CXP 스트림 패킷 손실 감지를 나타냅니다. Bit[1]은 CXP 스트림 패킷의 단일 바이트 오류 수정을 나타냅니다. Bit[2]는 CXP 스트림 패킷의 다중 바이트 오류 감지를 나타냅니다. Bit[3..6]은 예약되어 있습니다. 이 파라미터는 향후 버전에서 변경될 수 있습니다.

FormatType
Type static write parameter
Default GRAY
Range GRAY, RGB, RGBA, RAW

여기서는 수신할 Pixel Format 종류(CXP 사양에 정의된 대로)를 선택할 수 있습니다. 여기서 선택한 값에 따라 FormatMode 파라미터에서 선택할 수 있는 Pixel Format이 결정됩니다. 따라서 이 파라미터의 설정은 FormatMode 파라미터에 직접적인 영향을 미칩니다. 아래의 FormatMode 파라미터 문서도 참조하십시오.

FormatMode
Type static or dynamic (user-defined) write parameter
Default Mono8
Range {Mono8, Mono10, Mono12, Mono14, Mono16, BayerGR8, BayerGR10, BayerGR12, BayerGR14, BayerGR16, BayerRG8, BayerRG10, BayerRG12, BayerRG14, BayerRG16, BayerGB8, BayerGB10, BayerGB12, BayerGB14, BayerGB16, BayerBG8, BayerBG10, BayerBG12, BayerBG14, BayerBG16, RGB8, RGB10, RGB12, RGB14, RGB16, RGBA8, RGBA10, RGBA12, RGBA14, RGBA16, Raw}

이 파라미터는 FormatType 파라미터에서 선택한 포맷 타입에 속하는 모든 Pixel Format(CXP 사양에 정의된 대로)을 제공합니다.

여기서 선택할 수 있는 Pixel Format은 FormatType 파라미터의 설정에 따라 다릅니다. 따라서 항상 전체 값 범위의 사전 설정된 일부 페이로드만 사용할 수 있습니다.

다른 Pixel Format 세트를 얻으려면 FormatType 파라미터의 설정을 변경하십시오. 위의 FormatType 파라미터 문서도 참조하십시오.

구체적으로, FormatType 파라미터의 다음 설정은 FormatMode 파라미터에서 다음과 같은 Pixel Format을 제공합니다.

FormatType == GRAY: {Mono8, Mono10, Mono12, Mono14, Mono16, BayerGR8, BayerGR10, BayerGR12, BayerGR14, BayerGR16, BayerRG8, BayerRG10, BayerRG12, BayerRG14, BayerRG16, BayerGB8, BayerGB10, BayerGB12, BayerGB14, BayerGB16, BayerBG8, BayerBG10, BayerBG12, BayerBG14, BayerBG16}

FormatType == RGB: {RGB8, RGB10, RGB12, RGB14, RGB16}

FormatType == RGBA: {RGBA8, RGBA10, RGBA12, RGBA14, RGBA16}

FormatType == RAW: {Raw} Pixel format Raw has a fix bit width of 32Bit. The data are interpreted as received.

이 파라미터를 동적 파라미터로 사용할지 정적 파라미터로 사용할지 결정할 수 있습니다. Parameter Type 열에서 선택하십시오.

TxTriggerPacketMode
Type dynamic write parameter
Default CxpStandard
Range {CxpStandard, RisingEdgeOnly}

TxTriggerPacketMode 파라미터를 사용하면 프레임 그래버와 카메라를 연결하는 CXP 케이블의 대역폭을 늘릴 수 있습니다. 대역폭의 증가는 카메라 트리거 신호 해석을 약간 수정하여 달성됩니다.

이 기능은 해당 기능을 지원하는 특정 카메라에서만 사용할 수 있습니다. 자세한 내용은 현지 대리점이나 Basler Support department에 문의하십시오.

TxTriggerPacketMode 파라미터는 두 가지 값(CxpStandard, RisingEdgeOnly)을 허용합니다.

  • CxpStandard: 권장 설정은 CxpStandard 값입니다. CxpStandard 값으로 설정하면 카메라 트리거가 CXP 사양에 따라 작동합니다. (CXP 사양에서는 프레임 그래버가 카메라를 한 번 트리거하기 위해 CXP 케이블을 통해 카메라로 두 개의 패킷을 전송하도록 정의합니다.)

  • RisingEdgeOnly: RisingEdgeOnly 값으로 설정하면 프레임 그래버가 카메라를 한 번 트리거하기 위해 하나의 패킷만 카메라로 전송합니다. 그 결과 대역폭이 증가하고 라인 레이트가 높아집니다.

TxTriggerEventCount
Type 동적 읽기 파라미터
Default 0
Range {0;2^20-1}

TxTriggerEventCount 파라미터는 카메라로 전송된 트리거 에지 이벤트의 수를 나타냅니다.

TxTriggerAcknowledgementCount
Type 동적 읽기 파라미터
Default 0
Range {0;2^20-1}

TxTriggerAcknowledgementCount 파라미터는 (이전에 전송된 트리거 에지 패킷에 대한 응답으로) 카메라가 전송한 트리거 확인 패킷 중 프레임 그래버가 수신한 패킷의 수를 나타냅니다.

TxTriggerWaveformViolation
Type 동적 읽기 파라미터
Default 0
Range {0,1}

TriggerI 포트의 두 트리거 에지 간 간격이 최소 에지 주파수를 위반하는 경우 카메라 오퍼레이터가 이 파라미터를 1로 설정합니다. 모든 microEnable 5 플랫폼에서 최소 에지 주파수는 550 ns(나노초)입니다. 이 파라미터는 읽힐 때까지 값을 유지합니다. 읽은 후 파라미터 값이 업데이트됩니다. 주파수 제어는 상시 실행되며 파라미터의 읽기 상태에 영향을 받지 않습니다.

사용 예제

CXPQuadCamera 오퍼레이터의 사용법은 다음 예시와 같습니다.