Scheduled Action Commands#

Scheduled Action Commandsのカメラ機能を使用すると、複数のGigEカメラで完全に同時に実行されるアクションコマンドを送信できます。

用途において正確なタイミングが重要な要素でない場合は、代わりにAction Commands機能を使用できます。

機能を使用する#

仕組み#

Scheduled Action Command機能の基本パラメーターは、Action Commands機能と同じです。

• アクションデバイスキー
• アクショングループキー
• アクショングループマスク
• ブロードキャストアドレス

これらのパラメーターに加えて、Scheduled Action Command機能ではAction Timeパラメーターを使用します。

Action Time#

アクションを実行するタイミングを定義するために使用される64ビットのGigE Visionタイムスタンプ。

このアクションは、カメラの内部タイムスタンプ値が指定された値に達するとすぐに実行されます。

Precision Time Protocolを有効にすると、ネットワーク内のすべてのカメラでタイムスタンプ値が同期されます。その結果、アクションはネットワーク内のすべてのカメラで同時に実行されます。

値は目盛単位で入力する必要があります。Precision Time Protocol機能が有効になっているBaslerカメラでは、1目盛は1ナノ秒に相当します。

例：アクション時間を100 000 000 000に設定してスケジュールされたアクションコマンドを発行するとします。このアクションは、指定されたネットワークセグメント内のすべてのカメラのタイムスタンプ値が100 000 000 000に達すると、すぐに実行されます。

Scheduled Action Commandsの使用#

カメラの設定#

Action Commandsトピックで説明されている手順に従います。

Issuing a Scheduled Action Command#

General Use#

スケジュールされたアクションコマンドを出すには：

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.

例：

Issuing a Scheduled Action Command to Be Executed after a Certain Delay#

特定の遅延後に実行されるスケジュールされたアクションコマンドを出すには：

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.

ネットワークセグメント内のすべてのカメラは、指定された遅延後に同時にコマンドを実行します。

Issuing a Scheduled Action Command to Be Executed at a Precise Point in Time#

正確な時点で実行されるスケジュールされたアクションコマンドを出すには：

1. ネットワーク内のすべてのカメラがPrecision Time Protocol機能を通して、Coordinated Universal Time（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.

Queueing Scheduled Action Commands#

If the ActionQueueSize parameter is available and its value is greater than one, you can queue scheduled action commands.

これは、カメラが複数のスケジュールされたアクションコマンドを保存および処理できることを意味します。カメラはアクション時間の昇順で実行します。キューがいっぱいの場合、追加のコマンドは無視されます。

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

コマンド2は、10,000,000ナノ秒後に最初に実行されます。コマンド1は20,000,000ナノ秒後に2番目に実行されます。キューがいっぱいであるため、コマンド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を使用して、パラメーターを簡単に設定することもできます。