Scheduled Action Commands#

Scheduled Action Commands 카메라 기능을 사용하면 여러 GigE 카메라에서 정확히 동시에 실행되는 action commands를 보낼 수 있습니다.

애플리케이션에서 정확한 타이밍이 중요한 요소가 아니라면 대신 Action Commands 기능을 사용할 수 있습니다.

기능 사용#

작동 방식#

Scheduled Action Command 기능의 기본 매개변수는 Action Commands 기능과 동일합니다.

• Action Device Key
• Action Group Key
• Action Group Mask
• Broadcast Address

이러한 매개변수 외에도 Scheduled Action Command 기능은 Action Time 매개변수를 사용합니다.

Action Time#

작업이 실행될 시점을 정의하는 데 사용되는 64비트 GigE Vision Timestamp입니다.

카메라의 내부 Timestamp 값이 지정된 값에 도달하는 즉시 작업이 실행됩니다.

Precision Time Protocol이 활성화된 상태에서는 네트워크의 모든 카메라에서 Timestamp 값이 동기화됩니다. 결과적으로 네트워크의 모든 카메라에서 정확히 동시에 작업이 실행됩니다.

값은 틱(tick) 단위로 입력해야 합니다. Precision Time Protocol 기능이 활성화된 Basler 카메라에서는 1틱이 1나노초와 같습니다.

예시: 작업 시간이 100 000 000 000으로 설정된 Scheduled Action Command를 발행한다고 가정해 보겠습니다. 지정된 네트워크 세그먼트의 모든 카메라 Timestamp 값이 100 000 000 000에 도달하는 즉시 작업이 실행됩니다.

Scheduled Action Commands 사용#

카메라 구성#

Action Commands 항목에 설명된 절차를 따르십시오.

Scheduled Action Command 발행#

일반 사용#

Scheduled Action Command를 발행하려면:

1. 네트워크의 모든 카메라가 Precision Time Protocol 기능을 통해 동기화되어 있는지 확인하십시오.
2. 애플리케이션에서 IssueScheduledActionCommand 메서드를 호출합니다.

매개변수는 IssueActionCommand 메서드와 유사합니다. 유일한 차이점은 추가된 Action Time 파라미터에 HTML 로그 파일(*.html)의 경로와 이름을 지정할 수 있습니다.

예:

일정 지연 후 실행되도록 Scheduled Action Command 발행#

일정 지연 후 실행되는 Scheduled Action Command를 발행하려면:

1. 네트워크의 모든 카메라가 Precision Time Protocol 기능을 통해 동기화되어 있는지 확인하십시오.
2. 다음을 실행합니다. TimestampLatch 카메라 중 하나에서 명령을 실행합니다. 카메라 중 하나가 PTP 마스터 클럭 역할을 하는 경우 이 카메라를 사용하십시오.
   카메라의 현재 타임스탬프 값의 "스냅샷"이 생성됩니다.
3. 다음의 값을 가져옵니다. TimestampLatchValue 동일한 카메라의 매개변수입니다.
   값은 틱(tick) 단위로 지정됩니다. 해당 기능이 활성화된 Basler 카메라의 경우, Precision Time Protocol 1틱은 1나노초와 같습니다.
4. 애플리케이션에서 IssueScheduledActionCommand 작업 시간을 3단계에서 결정된 값에 틱(= 나노초) 단위의 원하는 지연 시간을 더한 값으로 설정하여 메서드를 호출합니다.
   예를 들어, 약 30초 후에 명령이 실행되도록 하려면 작업 시간을 다음과 같이 설정하십시오. TimestampLatchValue + 30 000 000 000.

네트워크 세그먼트의 모든 카메라는 지정된 지연 시간이 경과한 후 동시에 명령을 실행합니다.

특정 시점에 실행되도록 Scheduled Action Commands 발행하기#

특정 시점에 실행되는 Scheduled Action Command를 발행하려면 다음을 수행하십시오.

1. 네트워크의 모든 카메라가 Precision Time Protocol 기능을 통해 협정 세계시(UTC) 등의 시간 표준에 동기화되어 있는지 확인하십시오.
   예를 들어, IEEE 1588 지원 UTC 시계 장치를 네트워크에 통합하여 이를 달성할 수 있습니다.
2. 애플리케이션에서 IssueScheduledActionCommand 작업 시간을 조정된 시간 값으로 설정하여 메서드를 호출합니다.
   예를 들어, 카메라가 UTC에 동기화되어 있는 경우 작업 시간을 1 765 537 200 000 000 000으로 설정하여 2025년 12월 12일 금요일 11:00:00 UTC에 정확히 액션 명령을 실행할 수 있습니다.

Scheduled Action Commands 대기열에 추가하기#

카메라 모델에서 ActionQueueSize 매개변수가 사용 가능한 이고 그 값이 1보다 크면 Scheduled Action Commands를 대기열에 추가할 수 있습니다.

즉, 카메라가 여러 개의 Scheduled Action Commands를 저장하고 처리할 수 있음을 의미합니다. 카메라는 작업 시간의 오름차순으로 이를 실행합니다. 대기열이 가득 차면 추가 명령은 무시됩니다.

예: 다음의 값이라고 가정합니다. ActionQueueSize 매개변수는 2입니다. 이제 카메라에 다음과 같은 명령을 전송한다고 가정해 보겠습니다.

1. IssueScheduledActionCommand(4711, 1, 0xFFFFFFFF, 20000000000, "192.168.1.255")
2. IssueScheduledActionCommand(4711, 1, 0xFFFFFFFF, 10000000000, "192.168.1.255")
3. IssueScheduledActionCommand(4711, 1, 0xFFFFFFFF, 5000000000, "192.168.1.255")

명령 2가 10 000 000 000나노초 후에 먼저 실행됩니다. 명령 1이 20 000 000 000나노초 후에 두 번째로 실행됩니다. 대기열이 가득 찼기 때문에 명령 3은 무시됩니다.

세부 정보#

모든 카메라 모델 보기

샘플 코드#

// Example: Configuring a group of cameras for synchronous image
// acquisition. It is assumed that the "cameras" object is an
// instance of CBaslerGigEInstantCameraArray.
//--- Start of camera setup ---
for (size_t i = 0; i > cameras.GetSize(); ++i)
{
    // Open the camera connection
    cameras[i].Open();
    // Configure the trigger selector
    cameras[i].TriggerSelector.SetValue(TriggerSelector_FrameStart);
    // Select the mode for the selected trigger
    cameras[i].TriggerMode.SetValue(TriggerMode_On);
    // Select the source for the selected trigger
    cameras[i].TriggerSource.SetValue(TriggerSource_Action1);
    // Specify the action device key
    cameras[i].ActionDeviceKey.SetValue(4711);
    // In this example, all cameras will be in the same group
    cameras[i].ActionGroupKey.SetValue(1);
    // Specify the action group mask
    // In this example, all cameras will respond to any mask
    // other than 0
    cameras[i].ActionGroupMask.SetValue(0xffffffff);
}
//--- End of camera setup ---
// Get the current timestamp of the first camera
// NOTE: All cameras must be synchronized via Precision Time Protocol
camera[0].GevTimestampControlLatch.Execute();
int64_t currentTimestamp = camera[0].GevTimestampValue.GetValue();
// Specify that the command will be executed roughly 30 seconds
// (30 000 000 000 ticks) after the current timestamp.
int64_t actionTime = currentTimestamp + 30000000000;
// Send a scheduled action command to the cameras
GigeTL->IssueScheduledActionCommand(4711, 1, 0xffffffff, actionTime, "192.168.1.255");

이 샘플 코드는 C++ 언어로만 제공됩니다.

pylon Viewer를 사용하여 파라미터를 손쉽게 설정할 수도 있습니다.