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. 在您的应用程序中调用 IssueScheduledActionCommand 方法。

参数类似于 IssueActionCommand 方法。唯一的区别是附加的 Action Time 参数。

示例：

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

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

1. 通过 Precision Time Protocol 功能确保网络中的所有相机均已同步。
2. 在其中一台相机上执行 TimestampLatch 命令。如果您的一台相机用作 PTP 主时钟，请使用此相机。
   获取相机当前时间戳值的“快照”。
3. 在同一相机上获取 TimestampLatchValue 参数的值。
   该值以滴答声为单位。在启用了 Precision Time Protocol 功能的 Basler 相机上，1 声滴答等于 1 纳秒。
4. 调用 IssueScheduledActionCommand 方法，将操作时间设置为在步骤 3 中确定的值，再加上所需的延迟（以滴答声为单位）（=纳秒）。
   例如，如果要在大约 30 秒后执行命令，则将操作时间设置为 TimestampLatchValue + 30 000 000 000。

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

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

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

1. 通过 Precision Time Protocol 功能确保网络中的所有相机均已同步到某种时间标准，例如协调世界时 (UTC)。
   例如，这可以通过在网络中集成支持 IEEE 1588 的 UTC 时钟设备来实现。
2. 在将操作时间设置为协调时间值的情况下，调用 IssueScheduledActionCommand 方法。
   例如，如果您的相机已根据 UTC 时间同步，则可以将操作时间设置为 1 765 537 200 000 000 000，以便恰好在 Fri Dec 12 2025 11:00:00 UTC 执行操作命令。

将 Scheduled Action Commands 排入队列#

如果 ActionQueueSize 参数可用并且其值大于 1，则可以对计划操作命令进行排队。

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

示例：假设 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")

在 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 轻松设置参数。