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
• 廣播位址

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

Action Time#

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

只要相機的內部 Timestamp 值達到指定的值，就會立即執行動作。

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

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

範例： 假設您發出的 scheduled action command 其動作時間設定為 100 000 000 000。當指定網路區段中所有相機的 timestamp 值達到 100 000 000 000 時，將立即執行該動作。

使用 Scheduled Action Commands#

設定相機#

請遵循 Action Commands 主題中所述的程序。

發出 Scheduled Action Commands#

一般用途#

若要發出 scheduled action command：

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

這些參數類似於 IssueActionCommand 方法。唯一的區別在於額外的 Action Time 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。

範例：

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

若要發出在特定延遲後執行的 scheduled action command：

1. 確保網路中的所有相機都透過 Precision Time Protocol 功能進行同步。
2. 執行 TimestampLatch 在其中一台相機上執行命令。如果您的其中一台相機作為 PTP master clock，請使用這台相機。
   擷取相機目前的 時間戳記 值的「快照」。
3. 取得 TimestampLatchValue 在同一台相機上設定參數。
   該值以 tick 為單位給出。在具備以下功能的 Basler 相機上 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，以確切在 Fri Dec 12 2025 11:00:00 UTC 執行 action command。

將 Scheduled Action Commands 加入佇列#

若 buffer operator 的 ActionQueueSize 為 可用 且其值大於 1，您就可以將 scheduled action commands 加入佇列。

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

範例： 假設 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")

命令 2 將會先執行，在 10 000 000 000 奈秒後。命令 1 將會第二個執行，在 20 000 000 000 奈秒後。命令 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++ 版本。

您也可以 use the pylon Viewer 來輕鬆設定參數。