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. アプリケーションでIssueScheduledActionCommandメソッドを呼び出します。

パラメーターは、IssueActionCommandメソッドに類似しています。唯一の違いは、Action Timeパラメーターが追加されていることです。

例：

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

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

1. ネットワーク内のすべてのカメラがPrecision Time Protocol機能を介して同期されていることを確認します。
2. いずれかのカメラでTimestampLatchコマンドを実行します。いずれかのカメラがPTPマスタークロックとして機能している場合は、このカメラを使用します。
   カメラの現在のタイムスタンプ値の「スナップショット」が取得されます。
3. 同じカメラでTimestampLatchValueパラメーターの値を取得します。
   値は目盛単位で指定されます。Precision Time Protocol機能が有効になっているBaslerカメラでは、1目盛りは1ナノ秒に相当します。
4. アクション時間をステップ3で決定した値に加えて、必要な遅延（= ナノ秒）を加えた値に設定した、IssueScheduledActionCommandメソッドを呼び出します。
   たとえば、約30秒後にコマンドを実行する場合は、アクション時間を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. アクション時間を協定時間値に設定してIssueScheduledActionCommandメソッドを呼び出します。
   例えば、カメラがUTCに同期されている場合、アクション時間を1 765 537 200 000 000 000に設定すると、アクションコマンドを2025年12月12日（金）11:00:00UTCに正確に実行できます。

Queueing Scheduled Action Commands#

ActionQueueSizeパラメーターが使用可能で、その値が1より大きい場合は、スケジュールされたアクションコマンドをキューに入れることができます。

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

例：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ナノ秒後に最初に実行されます。コマンド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を使用して、パラメーターを簡単に設定することもできます。