Supported by...
PL-X Cameras
Description
FEATURE_PTP allows 2 or more cameras on the same network, to synchronize their clocks to a ‘Master’ clock using the IEEE1588 / PTPv2 protocol. Pixelink cameras are capable if becoming the master clock on the network, as negotiated via the PTP protocol. An application gets timestamps from a cameras clock via the function PxLGetCurrentTimestamp. What more, a camera timestamp is also returned in the descriptor of each frame received, and with certain other operations, such as event callbacks.
This feature can be particularly useful when attempting to synchronize frame captures across multiple cameras. More specifically, users can use the actions ACTION_SENSOR_SYNC and ACTION_FRAME_TRIGGER to capture images from multiple cameras at virtually the same instant in time. The Pixelink SDK has a number of simple sample applications that show how to do this.
API Control
| Feature | Number of Params | Parameters | Units | Restrictions |
FEATURE_PTP | 4 | FEATURE_PTP_PARAM_MODE | N/A | Integer only |
FEATURE_PTP_PARAM_STATUS | N/A | Integer only | ||
FEATURE_PTP_PARAM_ACCURACY | Seconds | Refresh rate of this camera’s clock. Note this parameter is read only. | ||
FEATURE_PTP_PARAM_OFFSET_ FROM_MASTER | Seconds | Delta between this camera’s clock from the PTP master clock. Note this parameter is read only. |
Note: On reads (PxLGetFeature), all 4 parameters will be valid. However, on writes (PxLSetFeature), only the FEATURE_PTP_PARAM_MODE parameter is settable. See PTP Mode for available PTP modes.
Feature Flags
| Camera | Presence | Read Only | Auto | Manual | One-time Auto | Off | Settable While Streaming |
PL-X cameras | Yes | No | Yes | Yes | No | Yes | No |