Operator TrgPortLine

Operator Library: Hardware Platform

이 오퍼레이터는 카메라의 트리거(Exsync)를 생성합니다. 또한 취득한 라인을 이미지로 조립하는 역할도 합니다.

내부 신호 제어기(GrabberControlled)를 사용하거나 외부 신호(트리거 확장 보드의 입력 신호(TTL Trigger 보드 또는 OPTO Trigger 보드) 또는 소프트웨어를 통해)에서 신호 제어기를 트리거할 수 있습니다. 신호 제어기는 유연한 지연 시간, 펄스 폭 및 극성을 가진 Exsync 신호를 생성할 수 있습니다. 또한 트리거 확장 보드에서 사용할 수 있는 플래시 신호가 생성됩니다.

이 오퍼레이터는 CC 신호를 위해 4개의 디지털 출력과 하나의 카메라 포트를 점유합니다. 따라서 CameraControl 유형의 VisualApplets 리소스 하나가 사용됩니다. 리소스 색인이 0으로 설정된 경우 디지털 출력 0~2와 카메라 포트 A가 사용됩니다. 리소스 색인이 1로 설정된 경우 디지털 출력 4~6과 카메라 포트 B가 사용됩니다. 출력 3과 7은 이 오퍼레이터에서 사용되지 않습니다. 다른 오퍼레이터는 이러한 하드웨어 리소스를 사용할 수 없습니다. 리소스 대화 상자에서 리소스 색인을 설정하십시오.

하드웨어 플랫폼별 사용 가능 여부
microEnable IV VD1-CL/-PoCL
microEnable IV VD4-CL/-PoCL

I/O Properties

Property Value
Operator Type P
Input Link I, data input
Output Link O, data output

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 64] as I
Arithmetic {unsigned, signed} as I
Parallelism any as I
Kernel Columns 1 as I
Kernel Rows 1 as I
Img Protocol VALT_LINE1D VALT_IMAGE2D
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height 65536 as I

Parameters

YOffset
Type 동적/정적 읽기/쓰기 파라미터
Default 0
Range [0, 224]

이 파라미터는 프레임의 시작 부분에서 생략할 라인 수를 정의합니다.

YLength
Type 동적/정적 읽기/쓰기 파라미터
Default 1024
Range [8, 224]

이 파라미터는 프레임의 라인 수를 정의합니다.

MaxGatedHeight
Type 동적 읽기/쓰기 파라미터
Default 제한됨
Range {restricted, unrestricted}

파라미터 MaxGatedHeight를 사용하면 이미지 트리거 모드(ImgTriggerMode)가 ExternSw_Gate로 설정된 경우 최대 이미지 높이를 제한할 수 있습니다.

이미지 트리거 모드(ImgTriggerMode)가 ExternSw_Gate로 설정되고 파라미터 MaxGatedHeight가 제한 없음(unrestricted)으로 설정된 경우, 이미지 높이는 게이트가 열려 있는 시간, 즉 외부 이미지 트리거 신호의 펄스 폭 또는 값이 1인 소프트웨어 트리거의 지속 시간에 의해 정의됩니다. 이제 게이트가 오랜 시간 동안 열려 있으면 이미지 높이가 커집니다. 파라미터 MaxGatedHeight가 제한됨(restricted)으로 설정된 경우, 게이트가 여전히 열려 있더라도 이미지 높이는 YLength 이미지 라인으로 제한됩니다. 오퍼레이터는 추가 라인을 폐기하고 다음으로 열리는 게이트를 기다려 새 프레임을 시작합니다.

반면, 파라미터가 제한 없음(unrestricted)으로 설정된 경우 이미지 높이는 오직 게이트에 의해서만 정의됩니다.

[경고] Link Property 위반 가능성

제한 없음 모드에서 이 파라미터를 사용하면 VisualApplets 링크 프로토콜 위반이 발생할 수 있습니다. 이미지 높이가 TrgPortLine 오퍼레이터의 출력 링크에 정의된 허용 최대 이미지 높이를 초과할 수 있습니다. 제한 없음 모드를 사용할 때는 주의하십시오. 링크 속성에 대한 자세한 내용은 'Link Properties'를 참조하십시오.

A successive SplitImage operator can divide large images into chunks (smaller images).

LineTriggerMode
Type 동적/정적 읽기/쓰기 파라미터
Default GrabberControlled
Range {GrabberControlled, Extern_Trigger, GrabberControlled_Gated_by_Img, Extern_Trigger_Gated_by_Img}

이 파라미터는 내부 Exsync 신호 제어기의 작동 모드를 선택합니다. 외부 트리거 입력 소스는 LineTrgInSourceA 및 LineTrgInSourceB 파라미터를 통해 선택할 수 있습니다(아래 참조).

GrabberControlled: 내부 신호 제어기에 의해 주기적으로 Exsync가 생성됩니다.

Extern_Trigger: 외부 트리거 신호를 사용하여 신호 제어기를 한 번 시작합니다.

GrabberControlled_Gated_by_Img: 프레임 취득 중에 내부 신호 제어기에 의해 주기적으로 Exsync가 생성됩니다.

Extern_Trigger_Gated_by_Img: 프레임 취득 중에 외부 트리거 신호를 사용하여 신호 제어기를 트리거합니다.

ExsyncEnable
Type 동적 읽기/쓰기 파라미터
Default OFF
Range {OFF, ON}

카메라로 향하는 Exsync 출력을 활성화 또는 비활성화합니다.

LineTrgInSourceA
Type 동적/정적 읽기/쓰기 파라미터
Default InSignal0
Range {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

이 파라미터는 Exsync 신호 제어기를 트리거하는 데 사용되는 신호 소스를 지정합니다. 이것은 TriggerMode가 Extern_Trigger로 설정된 경우에만 관련이 있습니다.

LineTrgInSourceB
Type 동적/정적 읽기/쓰기 파라미터
Default InSignal0
Range {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

이 파라미터는 Exsync 신호 제어기를 트리거하는 데 사용되는 신호 소스를 지정합니다. 이것은 TriggerMode가 Extern_Trigger로 설정되고 EncoderABMode가 Signal_AB_Filter로 설정된 경우에만 관련이 있습니다.

EncoderABMode
Type 동적/정적 읽기/쓰기 파라미터
Default Signal_A_Only
Range {Signal_A_Only, Signal_AB_Filter, Signal_ABx2_Filter, Signal_ABx4_Filter}

이 파라미터는 Exsync 생성을 위해 단일 트리거 입력(A만 해당)을 사용하는지 아니면 신호 A와 B를 모두 사용하는지 지정합니다.

신호 A/B 지원을 사용하면 샤프트 엔코더의 회전 방향을 판별하고 역회전을 억제 및 보상할 수 있습니다.

Signal_A_Only: LineTrgInSourceA에 의해 선택된 트리거 입력이 Exsync 생성에 사용됩니다.

Signal_AB_Filter: Exsync is generated for a forward rotation of the shaft encoder in single resolution, i.e., a trigger pulse for a rising edge of LineTrgInSourceA.

Signal_ABx2_Filter: 2배 해상도로 샤프트 엔코더가 정방향 회전할 때 Exsync가 생성됩니다. 즉, LineTrgInSourceA의 상승 에지와 하강 에지에 대한 트리거 펄스가 생성됩니다. LineTrgInSourceA의 두 에지가 모두 사용됩니다.

Signal_ABx4_Filter: 4배 해상도로 샤프트 엔코더가 정방향 회전할 때 Exsync가 생성됩니다. 즉, LineTrgInSourceA의 상승 및 하강 에지, 그리고 LineTrgInSourceB의 상승 및 하강 에지에 대한 트리거 펄스가 생성됩니다.

AB 지원이 활성화된 경우의 관련 파라미터:

  • EncoderABLead (전진 방향 정의를 전환할 수 있는 기능)

EncoderABMode 파라미터를 Signal_A_Only 값으로 설정하여 샤프트 엔코더를 재설정할 수 있습니다.

EncoderABLead
Type 동적/정적 읽기/쓰기 파라미터
Default Signal_AB
Range {Signal_AB, Signal_BA}

파라미터가 Signal_AB로 설정된 경우 신호 B보다 신호 A의 상승 에지에 의해 전진 이동이 정의되며, 그 반대의 경우도 마찬가지입니다.

Signal_AB: 전진은 B 이전의 A로 정의됩니다.

Signal_BA: 전진은 A 이전의 B로 정의됩니다.

LineTrgInPolarity
Type 동적 읽기/쓰기 파라미터
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 외부 입력 트리거 신호 LineTrgInSourceA 및 LineTrgInSourceB의 극성을 정의합니다. LowActive로 설정하면 Exsync 제너레이터는 ImgTrgInSource 파라미터로 지정된 신호의 하강 에지에서 시작됩니다. 그렇지 않으면 Exsync 생성은 상승 에지에서 시작됩니다. 이는 TriggerMode가 Extern_Trigger로 설정된 경우에만 유효합니다.

LineTrgDownscaler
Type 동적/정적 읽기/쓰기 파라미터
Default 1
Range [1, 256]

이 파라미터는 Exsync를 생성하는 데 필요한 외부 입력 트리거 신호의 개수를 지정합니다. 이는 TriggerMode가 외부 트리거 모드로 설정된 경우에만 유효합니다.

LineTrgPhase
Type 동적/정적 읽기/쓰기 파라미터
Default 1
Range [1, 256]

이 파라미터는 프레임의 첫 번째 Exsync를 생성하는 데 필요한 외부 입력 트리거 신호의 개수를 지정합니다. 이는 TriggerMode가 Extern_Trigger_Gated_by_Img로 설정된 경우에만 유효합니다.

ExsyncPeriod
Type 동적/정적 읽기/쓰기 파라미터
Default 100 µs
Range [1.024, 4000] μs

이 파라미터는 Exsync 신호의 주기를 지정합니다. 따라서 연결된 카메라를 트리거하기 위해 프레임 그래버 제어 모드를 사용할 때 라인 주파수를 정의합니다.

ExsyncExposure
Type 동적/정적 읽기/쓰기 파라미터
Default 20 µs
Range [1.024, 2000] μs, ExsyncPeriod를 초과할 수 없음

이 파라미터는 많은 카메라에서 Exposure Time을 지정하는 데 사용할 수 있는 Exsync 신호의 펄스 폭을 지정합니다. 따라서 그랩 중에도 소프트웨어를 통해 Exposure Time을 조절할 수 있습니다.

Exsync2Delay
Type 동적/정적 읽기/쓰기 파라미터
Default 0 µs
Range [0, 2000] μs, ExsyncPeriod를 초과할 수 없음

이 파라미터는 외부 트리거 입력에 대한 생성된 Exsync 신호의 지연을 지정합니다. 따라서 Exsync2 신호는 Exsync의 지연된 복제본입니다 (극성, 주기 등은 Exsync와 동일함).

ExsyncPolarity
Type 동적/정적 읽기/쓰기 파라미터
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 연결된 카메라에서 허용하는 극성에 맞게 Exsync 신호 제너레이터의 극성을 조절합니다. 카메라가 하강 에지에서 셔터를 열면 LowActive를 사용하고, 그렇지 않으면 HighActive를 사용하십시오.

ImgTriggerMode
Type 동적/정적 읽기/쓰기 파라미터
Default FreeRun
Range {FreeRun, ExternSw_Trigger, ExternSw_Gate}

이 파라미터는 내부 Image Gate의 작동 모드를 선택합니다.

이미지 트리거 입력 신호는 외부(주변) 장치(예: 샤프트 엔코더) 또는 소프트웨어에 의해 생성될 수 있습니다. 외부 이미지 트리거 입력의 소스는 ImgTrgInSource 파라미터를 통해 선택할 수 있습니다 (아래 참조).

The values of parameter ImgTriggerMode induce the following behaviour:

  • FreeRun:

    • 카메라에서 전송되는 모든 들어오는 라인이 수락됩니다.

    • Image Gate가 무시됩니다.

    • 파라미터 YLength는 EOF(프레임 종료)가 생성되는 시점을 정의합니다.

    • yOffset 파라미터가 0보다 큰 경우, 두 순차 이미지 사이의 yOffset 라인 수가 생략됩니다.

      예시: yOffset = 0, YLength = 2:

      예시: yOffset = 2, YLength = 2:

  • ExternSw_Trigger:

    • 허용된 이미지 트리거 입력 신호의 상승 에지에서 새 프레임이 시작되며, 들어오는 라인은 YLength까지 이미지에 추가됩니다.

    • 파라미터 YLength는 EOF(프레임 종료)가 생성되는 시점을 정의합니다.

    • 이미지 트리거의 새로운 상승 에지는 YLength 라인이 추가되고 EOF가 생성된 후에만 허용됩니다. YLength 라인이 이미지에 추가되고 EOF가 생성되기 전에 발생하는 이미지 트리거의 새로운 상승 에지는 무시됩니다.

      예시: YLength가 값 2로 설정됨:

  • ExternSw_Gate:

    • 게이트 모드에서는 이미지 게이트 신호로 작동하므로 이미지 트리거 입력 신호가 얼마나 오래 활성화되어 있는지가 중요합니다.

    • 이 모드의 정확한 동작은 파라미터 MaxGatedHeight를 통해 정의할 수 있습니다. (MaxGatedHeight를 사용하여 이미지의 최대 이미지 높이를 제한할지 아니면 제한하지 않을지 정의할 수 있습니다. 자세한 내용은 파라미터 MaxGatedHeight의 설명을 참조하십시오.)

      파라미터 MaxGatedHeight가 "Unrestricted"로 설정된 경우 ExternSW_Gate 모드의 동작

      • Image Gate 신호가 활성화되어 있는 동안 수신되는 라인이 이미지에 추가됩니다.

      • Image Gate는 유효한 이미지 라인을 제어합니다.

        • Image Gate 신호가 활성화되어 있는 동안 수신되는 라인이 허용됩니다. (그림 참조, 예: n+8 및 n+9 라인)

        • Image Gate 신호가 활성화되어 있지 않은 동안 수신되는 라인은 무시됩니다. (그림 참조, 예: n+3 라인)

        • Image Gate 신호가 활성화된 상태에서 시작되는 각 라인은 유효합니다. (그림 참조: n+1, n+2, n+4, n+5, n+6, n+8 및 n+9는 유효함)

          마지막 라인의 모든 데이터가 취득되기 전에 Image Gate의 하강 에지가 발생하더라도, 해당 라인은 여전히 유효하며 완전히 취득됩니다. (그림 참조: n+2 및 n+6)

        • 항상 완전한 라인이 전송됩니다.

        • Image Gate가 닫혀 있는 동안 시작되는 각 라인은 유효하지 않습니다. (그림 참조: 라인 n 및 n+7은 유효하지 않으며, 라인 n+4는 유효함)

        • 라인 끝(EoL) 및 프레임 끝(EoF)은 새 라인 시작 직전이나 Image Gate의 하강 에지에서 생성됩니다.

          새 라인 시작 직전의 EoL: 라인의 하강 에지가 열린 Image Gate 내에서 발생하고 Image Gate가 다음 라인의 시작을 포함하는 경우, EoL은 다음 라인의 상승 에지 직전에 생성됩니다. (그림 참조: n+1, n+4, n+5 및 n+8)

          새 라인 시작 직전의 EoL 및 EoF 동시 생성: Image Gate의 하강 에지가 라인의 하강 에지보다 먼저 발생하는 경우, EoL과 EoF는 다음 라인의 상승 에지 직전에 생성됩니다. (그림 참조: 이미지 m 및 이미지 m+1)

          Image Gate 하강 에지에서의 EoL 및 EoF 동시 생성: 라인의 하강 에지가 열린 Image Gate 내에서 발생하고 Image Gate의 하강 에지가 다음 라인의 상승 에지보다 먼저 발생하는 경우, EoL과 EoF는 Image Gate의 하강 에지 직후에 생성됩니다. (그림 참조: 이미지 m+2)

      파라미터 MaxGatedHeight가 "Restricted"로 설정된 경우 Mode ExternSW_Gate의 동작

      파라미터 MaxGatedHeight 가 "restricted"로 설정된 경우의 동작은 앞서 설명한 MaxGatedHeight (값이 "unrestricted"인 경우)과 동일하며, 다음 예외가 적용됩니다:

      • image gate가 열려 있는 동안 라인은 최대 이미지 높이인 YLength까지 추가됩니다. Image Gate 신호의 다음 상승 에지가 발생할 때까지 후속 라인은 모두 생략됩니다.

      • YLength 라인이 추가되기 전에 Image Gate 신호의 하강 에지가 발생하는 경우: Image Gate 신호의 하강 에지가 이미지의 높이를 정의하며, 이미지가 YLength 높이에 도달하지 않았더라도 마찬가지입니다. (이미지 높이에 대한 자세한 내용은 파라미터 MaxGatedHeight 참조)

      • 아래의 예시(그림)는 MaxGatedHeight = restricted 및 YLength = 3일 때의 동작을 보여줍니다.

ImgTrgInSource
Type 동적/정적 읽기/쓰기 파라미터
Default InSignal0
Range {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

이 파라미터는 이미지 취득을 트리거하는 데 사용되는 신호 소스를 지정합니다. 이는 ImgTriggerMode가 ExternSw_Trigger 또는 ExternSw_Gate로 설정된 경우에만 유효합니다.

ImgTrgInPolarity
Type 동적 읽기/쓰기 파라미터
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 외부 입력 트리거 신호의 극성을 정의합니다.

ImgTrgDelay
Type 동적 읽기/쓰기 파라미터
Default 0
Range {0, 4095}

이 파라미터는 지정된 이미지 라인 수만큼 이미지 트리거 신호를 지연시킵니다.

FlashEnable
Type 동적 읽기/쓰기 파라미터
Default OFF
Range {OFF, ON}

플래시 출력을 활성화 또는 비활성화합니다. 플래시 신호의 펄스 폭은 하나의 라인 주기와 같습니다.

FlashPolarity
Type 동적/정적 읽기/쓰기 파라미터
Default LowActive
Range {LowActive, HighActive}

이 파라미터는 생성된 Flash 신호의 극성을 정의합니다.

FlashDelay
Type 동적/정적 읽기/쓰기 파라미터
Default 0
Range {0, 4095}

이 파라미터는 외부 트리거 입력에 대해 생성된 플래시 신호를 지연시킬 라인 수를 지정합니다. 따라서 플래시를 외부 트리거 입력에 동기화할 수 있습니다.

플래시 신호의 펄스 폭은 1라인 주기와 같습니다.

SoftwareTrgPulse
Type 동적/정적 쓰기 파라미터
Default
Range {1}

이 파라미터를 1로 설정하면 software trigger가 생성됩니다. 이는 Trigger Mode가 외부 trigger 모드로 설정되어 있고 ImgTrgInSource가 SoftwareTrigger로 설정된 경우에만 유효합니다.

SoftwareTrgInput
Type 동적/정적 쓰기 파라미터
Default
Range {0, 1}

이 파라미터를 사용하여 image trigger 모드 ExternSw_Gate에 대한 software gate를 생성할 수 있습니다.

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

ImgTrgIsBusy 파라미터를 사용하면 image trigger의 busy 상태를 소프트웨어로 판독할 수 있습니다. busy 상태인 경우 이 파라미터는 진행 중인 image capture를 반영하기 위해 1로 설정됩니다. 0으로 설정되면 연산 장치가 busy 상태가 아님을 나타냅니다.

CC1output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC1 라인에서 사용할 수 있는 신호를 지정합니다.

CC2output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC2 라인에서 사용할 수 있는 신호를 지정합니다.

CC3output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC3 라인에서 사용할 수 있는 신호를 지정합니다.

CC4output
Type 동적/정적 쓰기 파라미터
Default Exsync
Range {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

이 파라미터는 CameraLink 케이블의 CC4 라인에서 사용할 수 있는 신호를 지정합니다.

ImgTrgDebouncingMaxTime
Type static write parameter
Default 65.520 us
Range [0.016, 1000000] us

이 파라미터는 ImgTrgDebouncingTime 파라미터의 최대 시간을 지정합니다. 최대 시간이 짧을수록 debouncing Timer를 구현하는 데 필요한 FPGA 리소스가 적게 소모됩니다.

ImgTrgDebouncingTime
Type 동적/정적 쓰기 파라미터
Default 0.112 us
Range [0.016, ImgTrgDebouncingMaxTime] us

이 파라미터는 입력된 image trigger 신호가 감지되기 위해 유지해야 하는 debouncing 시간을 지정합니다. debounce 시간 내의 빠른 신호 변경은 필터링되어 제외됩니다.

LineTrgDebouncingMaxTime
Type static write parameter
Default 65.520 us
Range [0.016, 1000000] us

이 파라미터는 LineTrgDebouncingTime 파라미터의 최대 시간을 지정합니다. 최대 시간이 짧을수록 debouncing Timer를 구현하는 데 필요한 FPGA 리소스가 적게 소모됩니다.

LineTrgDebouncingTime
Type 동적/정적 쓰기 파라미터
Default 0.112 us
Range [0.016, ImgTrgDebouncingMaxTime] us

이 파라미터는 입력된 line trigger 신호들이 감지되기 위해 유지해야 하는 debouncing 시간을 지정합니다. debounce 시간 내의 빠른 신호 변경은 필터링되어 제외됩니다.

사용 예제

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