Scheduled Action Commands#

相机的 Scheduled Action Commands 功能允许您发送在同一时间在多个 GigE 相机中执行的操作命令。

如果确切的时间不是您应用中的关键因素，则可以使用 Action Commands 功能。

该功能的使用#

运作原理#

Scheduled Action Command 功能的基本参数与 Action Commands 功能相同：

• 操作设备密钥
• 操作组密钥
• 操作组掩码
• 广播地址

除了这些参数之外，计划操作命令功能还使用操作时间参数：

操作时间#

64 位 GigE Vision 时间戳，用于定义何时执行操作。

相机的内部时间戳值达到指定值后，将立即执行该操作。

在启用 Precision Time Protocol 的情况下，时间戳值将在网络中的所有相机之间同步。结果，该操作将在网络上的所有相机上完全同时执行。

该值必须以 tick 为单位输入。在启用了 Precision Time Protocol 功能的 Basler 相机上，1 tick 等于 1 纳秒。

示例：假设您发出了一条计划操作命令，并且该操作的时间设置为 100 000 000 000。一旦指定网段中所有相机的时间戳值达到 100 000 000 000，就会立即执行该操作。

使用 Scheduled Action Commands#

配置相机#

请遵循“Action Commands”主题中陈述的过程操作。

发出计划操作命令#

一般用法#

若要发出计划操作命令：

1. 通过 Precision Time Protocol 功能确保网络中的所有相机均已同步。
2. Call the IssueScheduledActionCommand method in your application.

The parameters are similar to the IssueActionCommand method. The only difference is the additional 操作时间 parameter.

示例：

发出将在特定延迟后执行的计划操作命令#

要发出将在特定延迟后执行的计划操作命令：

1. 通过 Precision Time Protocol 功能确保网络中的所有相机均已同步。
2. Execute the TimestampLatch command on one of your cameras. If one of your cameras serves as the PTP master clock, use this camera.
   A "snapshot" of the camera's current timestamp value is taken.
3. Get the value of the TimestampLatchValue parameter on the same camera.
   The value is given in ticks. On Basler cameras with the Precision Time Protocol feature enabled, one tick equals one nanosecond.
4. Call the IssueScheduledActionCommand method with the action time set to the value determined in step 3 plus the desired delay in ticks (= nanoseconds).
   For example, if you want the command executed after roughly 30 seconds, set the action time to TimestampLatchValue + 30 000 000 000.

在指定延迟后，网段中的所有相机将同时执行命令。

发出要在精确时间点执行的计划操作命令#

要发出要在精确时间点执行的计划操作命令：

1. 通过 Precision Time Protocol 功能确保网络中的所有相机均已同步到某种时间标准，例如协调世界时 (UTC)。
   例如，这可以通过在网络中集成支持 IEEE 1588 的 UTC 时钟设备来实现。
2. Call the IssueScheduledActionCommand method with the action time set to a coordinated time value.
   For example, if your cameras are synchronized to UTC, you can set the action time to 1 765 537 200 000 000 000 to execute the action command exactly on Fri Dec 12 2025 11:00:00 UTC.

将 Scheduled Action Commands 排入队列#

If the ActionQueueSize parameter is available and its value is greater than one, you can queue scheduled action commands.

这意味着相机可以存储和处理多个计划操作命令。相机将按照操作时间的升序执行这些命令。如果队列已满，将忽略其他命令。

示例： Assume the value of the ActionQueueSize parameter is 2. Now, assume you send the following commands to the camera:

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")

在 10 000 000 000 纳秒后，将首先执行命令 2。在 20 000 000 000 纳秒后，将执行命令 1。由于队列已满，命令 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 轻松设置参数。