Scheduled Action Commands#

「Scheduled Action Commands 」相機功能可讓您傳送動作指令，這些指令將在多台 GigE 相機上精確同步執行。

如果精確的時機對您的應用程式而言並非關鍵因素，您可以改用「動作指令」功能。

使用功能#

運作原理#

「排程動作指令」功能的基本參數與「動作指令」功能相同：

• Action Device Key
• Action Group Key
• Action Group Mask
• 廣播位址

除了這些參數之外，「排程動作指令」功能還會使用「動作時間」參數：

行動時刻#

一個 64 位元 GigE Vision 時間戳記，用於定義何時執行該動作。

當攝影機的內部時間戳記值達到指定值時，該動作即會立即執行。

當 Precision Time Protocol 功能啟用後，時間戳記值會在網路中的所有攝影機之間進行同步。因此，該動作將在網路中的所有攝影機上於完全相同的時間點執行。

該值必須以「ticks」為單位輸入。在啟用 Precision Time Protocol 功能已啟用的 Basler 攝影機上，一個刻度等於一奈秒。

範例：假設您發出一個排程動作指令，並將動作時間設定為 100 000 000 000。當指定網路區段中所有攝影機的時間戳記值達到 100 000 000 000 時，該動作即會執行。

使用Scheduled Action Commands#

設定相機#

請依照「動作指令」主題中所述的步驟操作。

發出排程動作指令#

一般用途#

要發出排程動作指令：

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

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

範例：

發出將於經過一定延遲後執行的「排程動作指令」#

若要發出將於經過一定延遲後執行的排程動作指令：

1. 確保網路中的所有相機都透過 Precision Time Protocol 功能進行同步。
2. 執行 TimestampLatch 在其中一台攝影機上執行此指令。若其中一台攝影機擔任「PTP 」主時鐘，請使用該台攝影機。
   相機當前狀態的「快照」 時間戳記 取該值。
3. 取得 TimestampLatchValue 在同一台相機上設定參數。
   該值以 tick 為單位。在配備 Precision Time Protocol 功能的 Basler 相機上，一個 tick 等於一奈秒。
4. 呼叫 IssueScheduledActionCommand 將動作時間設定為步驟 3 中確定的值，再加上所需延遲（以 tick 為單位，即奈秒）的此方法。
   例如，若您希望該指令在約 30 秒後執行，請將動作時間設定為 TimestampLatchValue + 30 000 000 000.

網路區段中的所有攝影機都將在指定的延遲時間過後，同時執行該指令。

發出將於特定時間點執行的排程動作指令#

若要發出將在精確時間點執行的排程動作指令：

1. 請確保網路中的所有攝影機皆透過 Precision Time Protocol 功能與某個時間標準（例如協調世界時（UTC））保持同步。
   例如，可透過在網路中整合支援IEEE 1588 的 UTC 時鐘裝置來達成此目標。
2. 呼叫 IssueScheduledActionCommand 將動作時間設定為協調時間值的方法。
   例如，若您的攝影機已與 UTC 同步，您可以將動作時間設定為 1 765 537 200 000 000 000，以便在 2025 年 12 月 12 日（星期五）UTC 時間 11:00:00 精確執行該動作指令。

排隊Scheduled Action Commands#

若 buffer operator 的 ActionQueueSize 為 有貨 且其值大於一，您即可將排程動作指令加入佇列。

這表示攝影機可以儲存並處理多項排程動作指令。攝影機將依照動作時間由小到大的順序執行這些指令。若佇列已滿，額外的指令將會被忽略。

範例： 假設的 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 來輕鬆設定參數。