Event Notification#

Event Notification 카메라 기능을 사용하면 카메라 이벤트 및 이벤트 메시지를 활성화할 수 있습니다.

기능 사용#

Event Notification 활성화#

1. 파라미터를 원하는 EventSelector 매개변수를 다음 값 중 하나로 (사용 가능한 경우):
   • ActionLate
   • CriticalTemperature
   • EventOverrun 또는 Overrun
   • ExposureEnd
   • FrameBufferOverrun
   • FrameBurstStart
   • FrameBurstStartOvertrigger
   • FrameBurstStartWait
   • FrameStart
   • FrameStartOvertrigger
   • FrameStartWait
   • FrameTriggerMissed
   • OverTemperature
   • TemperatureStatusChanged
   • Test
2. 파라미터를 원하는 EventNotification 파라메터 On.
3. 활성화하려는 모든 유형의 Event Notification에 대해 1단계와 2단계를 반복합니다.
4. 애플리케이션에 이벤트 처리를 구현합니다.
   • C++ 구현 예는 pylon API Documentation의 Grab_CameraEvents (C++) 코드 샘플을 참조하십시오.
   • C 및 C .NET 구현 예는 pylon API Documentation의 Events Sample (C) 및 Grab Using Events for USB or GigE Camera (.NET) 코드 샘플을 참조하십시오.

사용 가능한 이벤트#

Action Late Event#

사용 가능한 경우, 과거의 Timestamp가 포함된 예약된 액션 명령을 카메라가 수신하면 Action Late 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Critical Temperature Event#

사용 가능한 경우, 카메라의 Temperature State가 임계 수준에 도달하면 Critical Temperature 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Event Overrun Event#

사용 가능한 경우, 카메라의 내부 이벤트 큐가 오버런되면 Event Overrun 이벤트(오버런 이벤트라고도 함)가 발생합니다. 이는 이벤트가 매우 높은 빈도로 생성되고 이벤트를 전송할 수 있는 대역폭이 충분하지 않을 때 발생합니다.

Event Overrun 이벤트는 이벤트가 삭제되고 있음을 알리는 경고입니다. 알림에는 삭제된 이벤트의 수나 종류에 대한 구체적인 정보가 포함되지 않습니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Exposure End Event#

이미지 노출이 완료될 때마다 Exposure End 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다. 또한 노출된 이미지의 번호를 나타내는 프레임 ID도 포함됩니다.

Frame Buffer Overrun Event#

사용 가능한 경우, 카메라의 내부 프레임 버퍼가 이미 가득 차서 프레임이 건너뛰어질 때마다 Frame Buffer Overrun 이벤트가 발생합니다.

호스트 컨트롤러가 획득한 이미지를 제때 가져오지 못하면 카메라는 내부 프레임 버퍼에 이미지를 버퍼링합니다. 내부 프레임 버퍼가 가득 차면 카메라는 새로 획득한 센서 데이터 건너뛰기를 시작합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Burst Start (= Acquisition Start) Event#

사용 가능한 경우, 카메라에 의해 Frame Burst Start 트리거가 생성되거나(프리런) 외부에서 적용될 때(트리거 이미지 획득) Frame Burst Start 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Burst Start Overtrigger (= Acquisition Start Overtrigger) Event#

사용 가능한 경우, Frame Burst Start 트리거가 과도하게 트리거될 때(Overtrigger) Frame Burst Start Overtrigger 이벤트가 발생합니다. 이는 카메라가 신호를 받을 준비가 되지 않은 상태에서 Frame Burst Start 트리거 신호를 보낼 때 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Burst Start Wait (= Acquisition Start Wait) Event#

사용 가능한 경우, 카메라가 Frame Burst Start 트리거 신호를 수신할 준비가 될 때마다 Frame Burst Start Wait 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Start Event#

카메라에 의해 Frame Start 트리거가 생성되거나(프리런) 외부에서 적용될 때(트리거 이미지 획득) Frame Start 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다. Basler ace 2 카메라의 경우, 노출된 이미지의 번호를 나타내는 프레임 ID도 포함됩니다.

Frame Start Overtrigger Event#

사용 가능한 경우, Frame Start 트리거가 과도하게 트리거될 때(Overtrigger) Frame Start Overtrigger 이벤트가 발생합니다. 이는 카메라가 신호를 받을 준비가 되지 않은 상태에서 Frame Start 트리거 신호를 보낼 때 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Start Wait Event#

사용 가능한 경우, Frame Start Wait 이벤트는 카메라가 Frame Start 트리거 신호를 수신할 준비가 될 때마다 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Trigger Missed Event#

이 이벤트는 Frame Start Overtrigger 이벤트와 동일하며 이름만 다릅니다.

Line Trigger Missed Event#

사용 가능한 경우, Line Trigger Missed 이벤트는 카메라가 신호를 수신할 준비가 되지 않은 상태에서 라인 트리거 신호가 인가될 때마다 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Line Timout Event#

사용 가능한 경우, Line Timeout 이벤트는 BslLinetimeout 새로운 라인 트리거를 수신하지 못한 채 파라미터에 지정된 시간이 경과할 때마다 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Over Temperature Event#

사용 가능한 경우, Over Temperature 이벤트는 카메라의 Temperature State가 과열 수준에 도달했을 때 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Temperature Status Changed Event#

사용 가능한 경우, Temperature Status Changed 이벤트는 카메라의 Temperature State가 변경될 때마다 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 EventTemperatureStatusChangedStatus 파라미터가 포함됩니다. 이 파라미터는 이벤트 발생 후 적용되는 새로운 온도 상태를 나타냅니다:

• Ok: 온도 상태가 Ok로 변경되었습니다.
• Critical: 온도 상태가 Critical로 변경되었습니다.
• Error: 온도 상태가 Error로 변경되었습니다.

또한 해당 메시지에는 이벤트가 생성된 시간을 나타내는 timestamp가 포함됩니다.

Test Event#

사용 가능한 경우, Test 이벤트를 통해 Event Notification 기능을 테스트할 수 있습니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

이벤트 알림을 테스트하는 방법:

1. 다음을 실행합니다. TestEventGenerate command.
2. 애플리케이션에서 Test 이벤트를 처리합니다.

세부 정보#

모든 카메라 모델 보기

샘플 코드#

// Enable the Exposure End event notification
camera.EventSelector.SetValue(EventSelector_ExposureEnd);
camera.EventNotification.SetValue(EventNotification_On);
// Enable the Critical Temperature event notification
camera.EventSelector.SetValue(EventSelector_CriticalTemperature);
camera.EventNotification.SetValue(EventNotification_On);
// Now, you must implement event handling in your application.
// For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
// "Events" code samples in the pylon API Documentation

INodeMap& nodemap = camera.GetNodeMap();
// Enable the Exposure End event notification
CEnumParameter(nodemap, "EventSelector").SetValue("ExposureEnd");
CEnumParameter(nodemap, "EventNotification").SetValue("On");
// Enable the Critical Temperature event notification
CEnumParameter(nodemap, "EventSelector").SetValue("CriticalTemperature");
CEnumParameter(nodemap, "EventNotification").SetValue("On");
// Now, you must implement event handling in your application.
// For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
// "Events" code samples in the pylon API Documentation

// Enable the Exposure End event notification
camera.Parameters[PLCamera.EventSelector].SetValue(PLCamera.EventSelector.ExposureEnd);
camera.Parameters[PLCamera.EventNotification].SetValue(PLCamera.EventNotification.On);
// Enable the Critical Temperature event notification
camera.Parameters[PLCamera.EventSelector].SetValue(PLCamera.EventSelector.CriticalTemperature);
camera.Parameters[PLCamera.EventNotification].SetValue(PLCamera.EventNotification.On);
// Now, you must implement event handling in your application.
// For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
// "Events" code samples in the pylon API Documentation

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Enable the Exposure End event notification */
errRes = PylonDeviceFeatureFromString(hdev, "EventSelector", "ExposureEnd");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "EventNotification", "On");
CHECK(errRes);
/* Enable the Critical Temperature event notification */
errRes = PylonDeviceFeatureFromString(hdev, "EventSelector", "CriticalTemperature");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "EventNotification", "On");
CHECK(errRes);
/* Now, you must implement event handling in your application. */
/* For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and */
/* "Events" code samples in the pylon API Documentation */

# Enable the Exposure End event notification
camera.EventSelector.Value = "ExposureEnd"
camera.EventNotification.Value = "On"
# Enable the Critical Temperature event notification
camera.EventSelector.Value = "CriticalTemperature"
camera.EventNotification.Value = "On"
# Now, you must implement event handling in your application.
# For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
# "Events" code samples in the pylon API Documentation

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