Scheduled Action Commands#

透過 Scheduled Action Commands camera feature，您可以傳送 action commands，在多個 GigE 相機上完全同時執行。

如果您的應用對精確計時的要求不高，您可以改用 Action Commands 功能。

使用此功能#

運作原理#

Scheduled Action Command 功能的基本參數與 Action Commands 功能相同：

• Action Device Key
• Action Group Key
• Action Group Mask
• Broadcast Address

除了這些參數之外，Scheduled Action Command 功能還使用 Action Time 參數：

Action Time#

用於定義執行動作時間的 64 位元 GigE Vision timestamp。

一旦相機的內部 timestamp 值達到指定值，就會執行該動作。

啟用 Precision Time Protocol 後，timestamp 值會在網路中的所有相機之間進行同步。因此，該動作將在網路中的所有相機上完全同時執行。

必須以 tick 為單位輸入數值。在啟用了 Precision Time Protocol 功能的 Basler 相機上，一個 tick 等於一奈秒。

範例：假設您發出一個排程動作指令，將動作時間設為 100 000 000 000。一旦指定網路區段中所有相機的 timestamp 值達到 100 000 000 000，就會執行該動作。

使用 Scheduled Action Commands#

設定相機#

請遵循 Action Commands 主題中概述的步驟。

發出 Scheduled Action Commands#

一般用途#

若要發出排程動作指令：

1. 確保網路中的所有相機都透過 Precision Time Protocol 功能進行同步。
2. 在您的應用程式中呼叫 IssueScheduledActionCommand 方法。

這些參數與 IssueActionCommand 方法相似。唯一的區別在於額外的 Action Time 參數的值。

範例：

發出在特定延遲後執行的 Scheduled Action Command#

若要發出在特定延遲後執行的排程動作指令：

1. 確保網路中的所有相機都透過 Precision Time Protocol 功能進行同步。
2. 執行 TimestampLatch 在其中一台相機上執行命令。如果其中一台相機擔任 PTP master clock，請使用這台相機。
   取得相機目前 時間戳記 值的「快照」。
3. 取得 TimestampLatchValue 位於同一台相機上的 Property。
   該值以 tick 為單位。在已啟用 Precision Time Protocol 功能的 Basler 相機上，一個 tick 等於一奈秒。
4. 在您的應用程式中呼叫 IssueScheduledActionCommand 方法，並將動作時間設定為步驟 3 中確定的值加上所需的延遲（以 tick 為單位，即奈秒）。
   例如，如果您希望大約 30 秒後執行命令，請將動作時間設定為 TimestampLatchValue + 30 000 000 000。

網路區段中的所有相機將在指定的延遲後同時執行命令。

發出在精確時間點執行的 Scheduled Action Commands#

若要發出在精確時間點執行的 scheduled action command：

1. 確保網路中的所有相機都透過 Precision Time Protocol 功能同步至時間標準，例如協調世界時 (UTC)。
   例如，這可以透過在網路中整合啟用 IEEE 1588 的 UTC 時鐘裝置來達成。
2. 在您的應用程式中呼叫 IssueScheduledActionCommand 方法，並將動作時間設定為協調時間值。
   例如，如果您的相機已同步至 UTC，您可以將動作時間設定為 1 765 537 200 000 000 000，以在 2025 年 12 月 12 日星期五 11:00:00 UTC 準時執行 action command。

將 Scheduled Action Commands 加入佇列#

如果已啟用 ActionQueueSize 參數設為 可用 且其值大於 1，您可以將 scheduled action commands 加入佇列。

這表示相機可以儲存並處理多個 scheduled action command。相機將按照動作時間的遞增順序執行它們。如果佇列已滿，其他命令將被忽略。

範例： 假設 ActionQueueSize Property 的值為 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")

Command 2 將會先執行，在 10 000 000 000 奈秒後。Command 1 將會第二個執行，在 20 000 000 000 奈秒後。Command 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 來輕鬆設定參數。