跳转到内容

Scheduled Action Commands#

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

如果确切的时间不是您应用中的关键因素,则可以使用 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,就会立即执行该操作。

信息

如果输入 0(零)或将操作时间设置为过去的时间,操作命令将立即执行,等效于标准操作命令

使用 Scheduled Action Commands#

配置相机#

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

发出计划操作命令#

一般用法

若要发出计划操作命令:

  1. 通过 Precision Time Protocol 功能确保网络中的所有相机均已同步。
  2. 在应用中调用 IssueScheduledActionCommand 方法。
    此参数类似于 IssueActionCommand 方法。唯一的区别是附加 操作时间 参数。
    示例:
    计划操作命令参数
发出将在特定延迟后执行的计划操作命令

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

信息

  • 必须使用 pylon API 执行以下步骤。
  • 因为在 pylon API 命令的传输与执行之间存在未指定的延迟,因此无法准确实现所需的延迟。
  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 将被忽略。

详情#

显示所有相机型号

相机型号 操作队列大小
a2A1920-51gcBAS 2
a2A1920-51gcPRO 3
a2A1920-51gmBAS 2
a2A1920-51gmPRO 3
a2A1920-160ucBAS 不支持 Scheduled Action Commands 功能
a2A1920-160ucPRO 不支持 Scheduled Action Commands 功能
a2A1920-160umBAS 不支持 Scheduled Action Commands 功能
a2A1920-160umPRO 不支持 Scheduled Action Commands 功能
a2A2590-22gcBAS 2
a2A2590-22gcPRO 3
a2A2590-22gmBAS 2
a2A2590-22gmPRO 3
a2A2590-60ucBAS 不支持 Scheduled Action Commands 功能
a2A2590-60ucPRO 不支持 Scheduled Action Commands 功能
a2A2590-60umBAS 不支持 Scheduled Action Commands 功能
a2A2590-60umPRO 不支持 Scheduled Action Commands 功能
a2A3840-13gcBAS 2
a2A3840-13gcPRO 3
a2A3840-13gmBAS 2
a2A3840-13gmPRO 3
a2A3840-45ucBAS 不支持 Scheduled Action Commands 功能
a2A3840-45ucPRO 不支持 Scheduled Action Commands 功能
a2A3840-45umBAS 不支持 Scheduled Action Commands 功能
a2A3840-45umPRO 不支持 Scheduled Action Commands 功能
acA640-90gc 不支持 Scheduled Action Commands 功能
acA640-90gm 1,ActionQueueSize 参数不可用
acA640-90uc 不支持 Scheduled Action Commands 功能
acA640-90um 不支持 Scheduled Action Commands 功能
acA640-120gc 1,ActionQueueSize 参数不可用
acA640-120gm 1,ActionQueueSize 参数不可用
acA640-120uc 不支持 Scheduled Action Commands 功能
acA640-120um 不支持 Scheduled Action Commands 功能
acA640-121gm 1,ActionQueueSize 参数不可用
acA640-300gc 1,ActionQueueSize 参数不可用
acA640-300gm 1,ActionQueueSize 参数不可用
acA640-750uc 不支持 Scheduled Action Commands 功能
acA640-750um 不支持 Scheduled Action Commands 功能
acA720-290gc 1,ActionQueueSize 参数不可用
acA720-290gm 1,ActionQueueSize 参数不可用
acA720-520uc 不支持 Scheduled Action Commands 功能
acA720-520um 不支持 Scheduled Action Commands 功能
acA780-75gc 1,ActionQueueSize 参数不可用
acA780-75gm 1,ActionQueueSize 参数不可用
acA800-200gc 1,ActionQueueSize 参数不可用
acA800-200gm 1,ActionQueueSize 参数不可用
acA800-510uc 不支持 Scheduled Action Commands 功能
acA800-510um 不支持 Scheduled Action Commands 功能
acA1280-60gc 1,ActionQueueSize 参数不可用
acA1280-60gm 1,ActionQueueSize 参数不可用
acA1300-22gc 1,ActionQueueSize 参数不可用
acA1300-22gm 1,ActionQueueSize 参数不可用
acA1300-30gc 1,ActionQueueSize 参数不可用
acA1300-30gm 1,ActionQueueSize 参数不可用
acA1300-30uc 不支持 Scheduled Action Commands 功能
acA1300-30um 不支持 Scheduled Action Commands 功能
acA1300-60gc 1,ActionQueueSize 参数不可用
acA1300-60gm 1,ActionQueueSize 参数不可用
acA1300-60gmNIR 1,ActionQueueSize 参数不可用
acA1300-75gc 1,ActionQueueSize 参数不可用
acA1300-75gm 1,ActionQueueSize 参数不可用
acA1300-200uc 不支持 Scheduled Action Commands 功能
acA1300-200um 不支持 Scheduled Action Commands 功能
acA1440-73gc 1,ActionQueueSize 参数不可用
acA1440-73gm 1,ActionQueueSize 参数不可用
acA1440-220uc 不支持 Scheduled Action Commands 功能
acA1440-220um 不支持 Scheduled Action Commands 功能
acA1600-20gc 1,ActionQueueSize 参数不可用
acA1600-20gm 1,ActionQueueSize 参数不可用
acA1600-20uc 不支持 Scheduled Action Commands 功能
acA1600-20um 不支持 Scheduled Action Commands 功能
acA1600-60gc 1,ActionQueueSize 参数不可用
acA1600-60gm 1,ActionQueueSize 参数不可用
acA1920-25gc 1,ActionQueueSize 参数不可用
acA1920-25gm 1,ActionQueueSize 参数不可用
acA1920-25uc 不支持 Scheduled Action Commands 功能
acA1920-25um 不支持 Scheduled Action Commands 功能
acA1920-40gc 1,ActionQueueSize 参数不可用
acA1920-40gm 1,ActionQueueSize 参数不可用
acA1920-40uc 不支持 Scheduled Action Commands 功能
acA1920-40ucMED 不支持 Scheduled Action Commands 功能
acA1920-40um 不支持 Scheduled Action Commands 功能
acA1920-40umMED 不支持 Scheduled Action Commands 功能
acA1920-48gc 1,ActionQueueSize 参数不可用
acA1920-48gm 1,ActionQueueSize 参数不可用
acA1920-50gc 1,ActionQueueSize 参数不可用
acA1920-50gm 1,ActionQueueSize 参数不可用
acA1920-150uc 不支持 Scheduled Action Commands 功能
acA1920-150um 不支持 Scheduled Action Commands 功能
acA1920-155uc 不支持 Scheduled Action Commands 功能
acA1920-155ucMED 不支持 Scheduled Action Commands 功能
acA1920-155um 不支持 Scheduled Action Commands 功能
acA1920-155umMED 不支持 Scheduled Action Commands 功能
acA2000-50gc 1,ActionQueueSize 参数不可用
acA2000-50gm 1,ActionQueueSize 参数不可用
acA2000-50gmNIR 1,ActionQueueSize 参数不可用
acA2000-165uc 不支持 Scheduled Action Commands 功能
acA2000-165um 不支持 Scheduled Action Commands 功能
acA2000-165umNIR 不支持 Scheduled Action Commands 功能
acA2040-25gc 1,ActionQueueSize 参数不可用
acA2040-25gm 1,ActionQueueSize 参数不可用
acA2040-25gmNIR 1,ActionQueueSize 参数不可用
acA2040-35gc 1,ActionQueueSize 参数不可用
acA2040-35gm 1,ActionQueueSize 参数不可用
acA2040-55uc 不支持 Scheduled Action Commands 功能
acA2040-55um 不支持 Scheduled Action Commands 功能
acA2040-90uc 不支持 Scheduled Action Commands 功能
acA2040-90um 不支持 Scheduled Action Commands 功能
acA2040-90umNIR 不支持 Scheduled Action Commands 功能
acA2040-120uc 不支持 Scheduled Action Commands 功能
acA2040-120um 不支持 Scheduled Action Commands 功能
acA2440-20gc 1,ActionQueueSize 参数不可用
acA2440-20gm 1,ActionQueueSize 参数不可用
acA2440-35uc 不支持 Scheduled Action Commands 功能
acA2440-35ucMED 不支持 Scheduled Action Commands 功能
acA2440-35um 不支持 Scheduled Action Commands 功能
acA2440-35umMED 不支持 Scheduled Action Commands 功能
acA2440-75uc 不支持 Scheduled Action Commands 功能
acA2440-75ucMED 不支持 Scheduled Action Commands 功能
acA2440-75um 不支持 Scheduled Action Commands 功能
acA2440-75umMED 不支持 Scheduled Action Commands 功能
acA2500-14gc 1,ActionQueueSize 参数不可用
acA2500-14gm 1,ActionQueueSize 参数不可用
acA2500-14uc 不支持 Scheduled Action Commands 功能
acA2500-14um 不支持 Scheduled Action Commands 功能
acA2500-20gc 1,ActionQueueSize 参数不可用
acA2500-20gcMED 1,ActionQueueSize 参数不可用
acA2500-20gm 1,ActionQueueSize 参数不可用
acA2500-20gmMED 1,ActionQueueSize 参数不可用
acA2500-60uc 不支持 Scheduled Action Commands 功能
acA2500-60um 不支持 Scheduled Action Commands 功能
acA3088-16gc 1,ActionQueueSize 参数不可用
acA3088-16gm 1,ActionQueueSize 参数不可用
acA3088-57uc 不支持 Scheduled Action Commands 功能
acA3088-57um 不支持 Scheduled Action Commands 功能
acA3800-10gc 1,ActionQueueSize 参数不可用
acA3800-10gm 1,ActionQueueSize 参数不可用
acA3800-14uc 不支持 Scheduled Action Commands 功能
acA3800-14um 不支持 Scheduled Action Commands 功能
acA4024-8gc 1,ActionQueueSize 参数不可用
acA4024-8gm 1,ActionQueueSize 参数不可用
acA4024-29uc 不支持 Scheduled Action Commands 功能
acA4024-29um 不支持 Scheduled Action Commands 功能
acA4096-11gc 1,ActionQueueSize 参数不可用
acA4096-11gm 1,ActionQueueSize 参数不可用
acA4096-30uc 不支持 Scheduled Action Commands 功能
acA4096-30ucMED 不支持 Scheduled Action Commands 功能
acA4096-30um 不支持 Scheduled Action Commands 功能
acA4096-30umMED 不支持 Scheduled Action Commands 功能
acA4096-40uc 不支持 Scheduled Action Commands 功能
acA4096-40ucMED 不支持 Scheduled Action Commands 功能
acA4096-40um 不支持 Scheduled Action Commands 功能
acA4096-40umMED 不支持 Scheduled Action Commands 功能
acA4112-8gc 1,ActionQueueSize 参数不可用
acA4112-8gm 1,ActionQueueSize 参数不可用
acA4112-20uc 不支持 Scheduled Action Commands 功能
acA4112-20ucMED 不支持 Scheduled Action Commands 功能
acA4112-20um 不支持 Scheduled Action Commands 功能
acA4112-20umMED 不支持 Scheduled Action Commands 功能
acA4112-30uc 不支持 Scheduled Action Commands 功能
acA4112-30ucMED 不支持 Scheduled Action Commands 功能
acA4112-30um 不支持 Scheduled Action Commands 功能
acA4112-30umMED 不支持 Scheduled Action Commands 功能
acA4600-7gc 1,ActionQueueSize 参数不可用
acA4600-10uc 不支持 Scheduled Action Commands 功能
acA5472-5gc 1,ActionQueueSize 参数不可用
acA5472-5gm 1,ActionQueueSize 参数不可用
acA5472-17uc 不支持 Scheduled Action Commands 功能
acA5472-17ucMED 不支持 Scheduled Action Commands 功能
acA5472-17um 不支持 Scheduled Action Commands 功能
boA4096-93cc 不支持 Scheduled Action Commands 功能
boA4096-93cm 不支持 Scheduled Action Commands 功能
boA4112-68cc 不支持 Scheduled Action Commands 功能
boA4112-68cm 不支持 Scheduled Action Commands 功能
daA1280-54lc 不支持 Scheduled Action Commands 功能
daA1280-54lm 不支持 Scheduled Action Commands 功能
daA1280-54uc 不支持 Scheduled Action Commands 功能
daA1280-54um 不支持 Scheduled Action Commands 功能
daA1600-60lc 不支持 Scheduled Action Commands 功能
daA1600-60lm 不支持 Scheduled Action Commands 功能
daA1600-60uc 不支持 Scheduled Action Commands 功能
daA1600-60um 不支持 Scheduled Action Commands 功能
daA1920-15um 不支持 Scheduled Action Commands 功能
daA1920-30uc 不支持 Scheduled Action Commands 功能
daA1920-30um 不支持 Scheduled Action Commands 功能
daA2500-14lc 不支持 Scheduled Action Commands 功能
daA2500-14lm 不支持 Scheduled Action Commands 功能
daA2500-14uc 不支持 Scheduled Action Commands 功能
daA2500-14um 不支持 Scheduled Action Commands 功能
daA2500-60mc 不支持 Scheduled Action Commands 功能
daA2500-60mci 不支持 Scheduled Action Commands 功能
daA4200-30mci 不支持 Scheduled Action Commands 功能
puA1280-54uc 不支持 Scheduled Action Commands 功能
puA1600-60uc 不支持 Scheduled Action Commands 功能
puA1600-60um 不支持 Scheduled Action Commands 功能
puA1920-30uc 不支持 Scheduled Action Commands 功能
puA1920-30um 不支持 Scheduled Action Commands 功能
puA2500-14uc 不支持 Scheduled Action Commands 功能
puA2500-14um 不支持 Scheduled Action Commands 功能

示例代码#

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