跳转到内容

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,就会立即执行该操作。

信息

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

使用 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 Action Time parameter.

示例:

计划操作命令参数

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

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

信息

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

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

Example: 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 将被忽略。

详情#

显示所有相机型号

相机型号 操作队列大小
a2A640-240gmSWIR 2
a2A640-240umSWIR 不支持 Scheduled Action Commands 功能
a2A1280-80gmSWIR 2
a2A1280-125umSWIR 不支持 Scheduled Action Commands 功能
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 功能
a2A1920-165g5cBAS 2
a2A1920-165g5mBAS 2
a2A2440-98g5cBAS 2
a2A2440-98g5mBAS 2
a2A2448-23gcBAS 2
a2A2448-23gcPRO 3
a2A2448-23gmBAS 2
a2A2448-23gmPRO 3
a2A2448-75ucBAS 不支持 Scheduled Action Commands 功能
a2A2448-75ucPRO 不支持 Scheduled Action Commands 功能
a2A2448-75umBAS 不支持 Scheduled Action Commands 功能
a2A2448-75umPRO 不支持 Scheduled Action Commands 功能
a2A2448-105g5cBAS 2
a2A2448-105g5mBAS 2
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 功能
a2A2600-20gcBAS 2
a2A2600-20gcPRO 3
a2A2600-20gmBAS 2
a2A2600-20gmPRO 3
a2A2600-64ucBAS 不支持 Scheduled Action Commands 功能
a2A2600-64ucPRO 不支持 Scheduled Action Commands 功能
a2A2600-64umBAS 不支持 Scheduled Action Commands 功能
a2A2600-64umPRO 不支持 Scheduled Action Commands 功能
a2A2840-14gcBAS 2
a2A2840-14gcPRO 3
a2A2840-14gmBAS 2
a2A2840-14gmPRO 3
a2A2840-48ucBAS 不支持 Scheduled Action Commands 功能
a2A2840-48ucPRO 不支持 Scheduled Action Commands 功能
a2A2840-48umBAS 不支持 Scheduled Action Commands 功能
a2A2840-48umPRO 不支持 Scheduled Action Commands 功能
a2A2840-67g5cBAS 2
a2A2840-67g5mBAS 2
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 功能
a2A4096-9gcBAS 2
a2A4096-9gcPRO 3
a2A4096-9gmBAS 2
a2A4096-9gmPRO 3
a2A4096-30ucBAS 不支持 Scheduled Action Commands 功能
a2A4096-30ucPRO 不支持 Scheduled Action Commands 功能
a2A4096-30umBAS 不支持 Scheduled Action Commands 功能
a2A4096-30umPRO 不支持 Scheduled Action Commands 功能
a2A4096-44g5cBAS 2
a2A4096-44g5mBAS 2
a2A4200-12gcBAS 2
a2A4200-12gcPRO 3
a2A4200-12gmBAS 2
a2A4200-12gmPRO 3
a2A4200-40ucBAS 不支持 Scheduled Action Commands 功能
a2A4200-40ucPRO 不支持 Scheduled Action Commands 功能
a2A4200-40umBAS 不支持 Scheduled Action Commands 功能
a2A4200-40umPRO 不支持 Scheduled Action Commands 功能
a2A4504-5gcBAS 2
a2A4504-5gcPRO 3
a2A4504-5gmBAS 2
a2A4504-5gmPRO 3
a2A4504-18ucBAS 不支持 Scheduled Action Commands 功能
a2A4504-18ucPRO 不支持 Scheduled Action Commands 功能
a2A4504-18umBAS 不支持 Scheduled Action Commands 功能
a2A4504-18umPRO 不支持 Scheduled Action Commands 功能
a2A4504-27g5cBAS 2
a2A4504-27g5mBAS 2
a2A4508-6gcBAS 2
a2A4508-6gcPRO 3
a2A4508-6gmBAS 2
a2A4508-6gmPRO 3
a2A4508-20ucBAS 不支持 Scheduled Action Commands 功能
a2A4508-20ucPRO 不支持 Scheduled Action Commands 功能
a2A4508-20umBAS 不支持 Scheduled Action Commands 功能
a2A4508-20umPRO 不支持 Scheduled Action Commands 功能
a2A5320-7gcBAS 2
a2A5320-7gcPRO 3
a2A5320-7gmBAS 2
a2A5320-7gmPRO 3
a2A5320-23ucBAS 不支持 Scheduled Action Commands 功能
a2A5320-23ucPRO 不支持 Scheduled Action Commands 功能
a2A5320-23umBAS 不支持 Scheduled Action Commands 功能
a2A5320-23umPRO 不支持 Scheduled Action Commands 功能
a2A5320-34g5cBAS 2
a2A5320-34g5mBAS 2
a2A5328-4gcBAS 2
a2A5328-4gcPRO 3
a2A5328-4gmBAS 2
a2A5328-4gmPRO 3
a2A5328-15ucBAS 不支持 Scheduled Action Commands 功能
a2A5328-15ucPRO 不支持 Scheduled Action Commands 功能
a2A5328-15umBAS 不支持 Scheduled Action Commands 功能
a2A5328-15umPRO 不支持 Scheduled Action Commands 功能
a2A5328-22g5cBAS 2
a2A5328-22g5mBAS 2
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 功能
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-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-20uc 不支持 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-165uc 不支持 Scheduled Action Commands 功能
acA2000-165um 不支持 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-57ucMED 不支持 Scheduled Action Commands 功能
acA3088-57um 不支持 Scheduled Action Commands 功能
acA3088-57umMED 不支持 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 功能
acA5472-5gc 1,ActionQueueSize 参数不可用
acA5472-5gm 1,ActionQueueSize 参数不可用
acA5472-17uc 不支持 Scheduled Action Commands 功能
acA5472-17ucMED 不支持 Scheduled Action Commands 功能
acA5472-17um 不支持 Scheduled Action Commands 功能
acA5472-17umMED 不支持 Scheduled Action Commands 功能
boA1936-400cc 不支持 Scheduled Action Commands 功能
boA1936-400cm 不支持 Scheduled Action Commands 功能
boA2448-250cc 不支持 Scheduled Action Commands 功能
bo2448-250cm 不支持 Scheduled Action Commands 功能
boA2832-190cc 不支持 Scheduled Action Commands 功能
bo2832-190cm 不支持 Scheduled Action Commands 功能
boA4096-93cc 不支持 Scheduled Action Commands 功能
boA4096-93cm 不支持 Scheduled Action Commands 功能
boA4096-180cc 不支持 Scheduled Action Commands 功能
bo4096-180cm 不支持 Scheduled Action Commands 功能
boA4112-68cc 不支持 Scheduled Action Commands 功能
boA4112-68cm 不支持 Scheduled Action Commands 功能
boA4500-45cc 不支持 Scheduled Action Commands 功能
boA4500-45cm 不支持 Scheduled Action Commands 功能
boA4504-100cc 不支持 Scheduled Action Commands 功能
boA4504-100cm 不支持 Scheduled Action Commands 功能
boA5120-150cc 不支持 Scheduled Action Commands 功能
boA5120-150cm 不支持 Scheduled Action Commands 功能
boA5120-230cc 不支持 Scheduled Action Commands 功能
boA5120-230cm 不支持 Scheduled Action Commands 功能
boA5320-150cc 不支持 Scheduled Action Commands 功能
boA5320-150cm 不支持 Scheduled Action Commands 功能
boA5328-100cc 不支持 Scheduled Action Commands 功能
boA5328-100cm 不支持 Scheduled Action Commands 功能
boA6500-36cc 不支持 Scheduled Action Commands 功能
boA6500-36cm 不支持 Scheduled Action Commands 功能
boA8100-16cc 不支持 Scheduled Action Commands 功能
boA8100-16cm 不支持 Scheduled Action Commands 功能
boA9344-30cc 不支持 Scheduled Action Commands 功能
boA9344-30cm 不支持 Scheduled Action Commands 功能
boA9344-70cc 不支持 Scheduled Action Commands 功能
boA9344-70cm 不支持 Scheduled Action Commands 功能
boA13440-17cm 不支持 Scheduled Action Commands 功能
daA720-520uc 不支持 Scheduled Action Commands 功能
daA720-520um 不支持 Scheduled Action Commands 功能
daA1280-54uc 不支持 Scheduled Action Commands 功能
daA1280-54um 不支持 Scheduled Action Commands 功能
daA1440-220uc 不支持 Scheduled Action Commands 功能
daA1440-220um 不支持 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 功能
daA1920-160uc 不支持 Scheduled Action Commands 功能
daA1920-160um 不支持 Scheduled Action Commands 功能
daA2448-70uc 不支持 Scheduled Action Commands 功能
daA2448-70um 不支持 Scheduled Action Commands 功能
daA2500-14uc 不支持 Scheduled Action Commands 功能
daA2500-14um 不支持 Scheduled Action Commands 功能
daA3840-45uc 不支持 Scheduled Action Commands 功能
daA3840-45um 不支持 Scheduled Action Commands 功能
puA1280-54uc 不支持 Scheduled Action Commands 功能
puA1280-54um 不支持 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 轻松设置参数。