Event Reporting - Basler Pioneer User Manual

13.8 Event Reporting

Event reporting is available on the camera. With event reporting, the camera can generate an
"event" and transmit it to the PC whenever a specific situation has occurred.
Currently, the camera can generate and transmit an event for two types of situations:
An end of an exposure has occurred
An event overrun has occurred
An Example of Event Reporting
As an example of how event reporting works, assume that "end of exposure" event reporting has
been enabled in the camera. Also assume that an end of exposure has just occurred in the camera.
In this case:
1. An "end of exposure event" is created. The event contains:
An Event Type Identifier. In this case, the identifier would show that an end of exposure type
event has occurred.
A Stream Channel Identifier. Currently this identifier is always 0.
A Frame ID. This number indicates the frame count at the time that the event occurred.
A Timestamp. This is a timestamp indicating when the event occurred. (The time stamp
timer starts running at power off/on or at camera reset. The unit for the timer is "ticks" where
one tick = 8 ns. The timestamp is a 64 bit value.)
2. The event is placed in an internal queue in the camera.
3. As soon as network transmission time is available, the camera will transmit an event message.
If only one event is in the queue, the message will contain the single event. If more than one
event is in the queue, the message will contain multiple events.
a. After the camera sends an event message, it waits for an acknowledgement. If no
acknowledgement is received within a specified timeout, the camera will resend the event
message. If an acknowledgement is still not received, the timeout and resend mechanism
will repeat until a specified maximum number of retrys is reached. If the maximum number
of retrys is reached and no acknowledge has been received, the message will be dropped.
During the time that the camera is waiting for an acknowledgement, no new event
messages can be transmitted.
The Event Queue
As mentioned in the example above, the camera has an event queue. The intention of the queue is
to handle short term delays in the camera's ability to access the network and send event messages.
When event reporting is working "smoothly", a single event will be placed in the queue and this
event will be sent to the PC in an event message before the next event is placed in queue. If there
is an occasional short term delay in event message transmission, the queue can buffer several
events and can send them within a single event message as soon as transmission time is available.
Basler pioneer
Standard Features
195