コンテンツにスキップ

Scheduled Action Commands#

The Scheduled Action Commands camera feature allows you to send action commands that are executed in multiple GigE cameras at exactly the same time.

用途において正確なタイミングが重要な要素でない場合は、代わりに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に達すると、すぐに実行されます。

情報

0(ゼロ)を入力した場合、またはアクション時間を過去の時刻に設定した場合、アクションコマンドは、標準アクションコマンドと同じように、ただちに実行されます。

Scheduled Action Commandsの使用#

カメラの設定#

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

Issuing a Scheduled Action Command#

General Use

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

  1. ネットワーク内のすべてのカメラがPrecision Time Protocol機能を介して同期されていることを確認します。
  2. アプリケーションでIssueScheduledActionCommandメソッドを呼び出します。

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

例:

Scheduled Action Command Parameters

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

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

情報

  • pylon APIを使用して次の手順を実行する必要があります。
  • pylon APIコマンドの送信と実行の間に詳細不明な遅延があるため、目的の遅延を正確に実行することはできません。
  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は無視されます。

特性#

すべてのカメラモデルを表示します

カメラモデル Action Queue Size
a2A1920-51gcBAS 2
a2A1920-51gcPRO 3
a2A1920-51gmBAS 2
a2A1920-51gmPRO 3
a2A1920-160ucBAS Scheduled Action Commands機能はサポートされていません
a2A1920-160ucPRO Scheduled Action Commands機能はサポートされていません
a2A1920-160umBAS Scheduled Action Commands機能はサポートされていません
a2A1920-160umPRO Scheduled Action Commands機能はサポートされていません
a2A2590-22gcBAS 2
a2A2590-22gcPRO 3
a2A2590-22gmBAS 2
a2A2590-22gmPRO 3
a2A2590-60ucBAS Scheduled Action Commands機能はサポートされていません
a2A2590-60ucPRO Scheduled Action Commands機能はサポートされていません
a2A2590-60umBAS Scheduled Action Commands機能はサポートされていません
a2A2590-60umPRO Scheduled Action Commands機能はサポートされていません
a2A3840-13gcBAS 2
a2A3840-13gcPRO 3
a2A3840-13gmBAS 2
a2A3840-13gmPRO 3
a2A3840-45ucBAS Scheduled Action Commands機能はサポートされていません
a2A3840-45ucPRO Scheduled Action Commands機能はサポートされていません
a2A3840-45umBAS Scheduled Action Commands機能はサポートされていません
a2A3840-45umPRO Scheduled Action Commands機能はサポートされていません
a2A4504-5gcBAS 2
a2A4504-5gcPRO 3
a2A4504-5gmBAS 2
a2A4504-5gmPRO 3
a2A4504-18ucBAS Scheduled Action Commands機能はサポートされていません
a2A4504-18ucPRO Scheduled Action Commands機能はサポートされていません
a2A4504-18umBAS Scheduled Action Commands機能はサポートされていません
a2A4504-18umPRO Scheduled Action Commands機能はサポートされていません
a2A5320-7gcBAS 2
a2A5320-7gcPRO 3
a2A5320-7gmBAS 2
a2A5320-7gmPRO 3
a2A5320-23ucBAS Scheduled Action Commands機能はサポートされていません
a2A5320-23ucPRO Scheduled Action Commands機能はサポートされていません
a2A5320-23umBAS Scheduled Action Commands機能はサポートされていません
a2A5320-23umPRO Scheduled Action Commands機能はサポートされていません
a2A5328-4gcBAS 2
a2A5328-4gcPRO 3
a2A5328-4gmBAS 2
a2A5328-4gmPRO 3
a2A5328-15ucBAS Scheduled Action Commands機能はサポートされていません
a2A5328-15ucPRO Scheduled Action Commands機能はサポートされていません
a2A5328-15umBAS Scheduled Action Commands機能はサポートされていません
a2A5328-15umPRO Scheduled Action Commands機能はサポートされていません
acA640-90gc Scheduled Action Commands機能はサポートされていません
acA640-90gm 1、ActionQueueSizeパラメーターは使用できません
acA640-90uc Scheduled Action Commands機能はサポートされていません
acA640-90um Scheduled Action Commands機能はサポートされていません
acA640-120gc 1、ActionQueueSizeパラメーターは使用できません
acA640-120gm 1、ActionQueueSizeパラメーターは使用できません
acA640-120uc Scheduled Action Commands機能はサポートされていません
acA640-120um Scheduled Action Commands機能はサポートされていません
acA640-121gm 1、ActionQueueSizeパラメーターは使用できません
acA640-300gc 1、ActionQueueSizeパラメーターは使用できません
acA640-300gm 1、ActionQueueSizeパラメーターは使用できません
acA640-750uc Scheduled Action Commands機能はサポートされていません
acA640-750um Scheduled Action Commands機能はサポートされていません
acA720-290gc 1、ActionQueueSizeパラメーターは使用できません
acA720-290gm 1、ActionQueueSizeパラメーターは使用できません
acA720-520uc Scheduled Action Commands機能はサポートされていません
acA720-520um Scheduled Action Commands機能はサポートされていません
acA780-75gc 1、ActionQueueSizeパラメーターは使用できません
acA780-75gm 1、ActionQueueSizeパラメーターは使用できません
acA800-200gc 1、ActionQueueSizeパラメーターは使用できません
acA800-200gm 1、ActionQueueSizeパラメーターは使用できません
acA800-510uc Scheduled Action Commands機能はサポートされていません
acA800-510um Scheduled Action Commands機能はサポートされていません
acA1280-60gc 1、ActionQueueSizeパラメーターは使用できません
acA1280-60gm 1、ActionQueueSizeパラメーターは使用できません
acA1300-22gc 1、ActionQueueSizeパラメーターは使用できません
acA1300-22gm 1、ActionQueueSizeパラメーターは使用できません
acA1300-30gc 1、ActionQueueSizeパラメーターは使用できません
acA1300-30gm 1、ActionQueueSizeパラメーターは使用できません
acA1300-30uc Scheduled Action Commands機能はサポートされていません
acA1300-30um Scheduled Action Commands機能はサポートされていません
acA1300-60gc 1、ActionQueueSizeパラメーターは使用できません
acA1300-60gm 1、ActionQueueSizeパラメーターは使用できません
acA1300-60gmNIR 1、ActionQueueSizeパラメーターは使用できません
acA1300-75gc 1、ActionQueueSizeパラメーターは使用できません
acA1300-75gm 1、ActionQueueSizeパラメーターは使用できません
acA1300-200uc Scheduled Action Commands機能はサポートされていません
acA1300-200um Scheduled Action Commands機能はサポートされていません
acA1440-73gc 1、ActionQueueSizeパラメーターは使用できません
acA1440-73gm 1、ActionQueueSizeパラメーターは使用できません
acA1440-220uc Scheduled Action Commands機能はサポートされていません
acA1440-220um Scheduled Action Commands機能はサポートされていません
acA1600-20gc 1、ActionQueueSizeパラメーターは使用できません
acA1600-20gm 1、ActionQueueSizeパラメーターは使用できません
acA1600-20uc Scheduled Action Commands機能はサポートされていません
acA1600-20um Scheduled Action Commands機能はサポートされていません
acA1600-60gc 1、ActionQueueSizeパラメーターは使用できません
acA1600-60gm 1、ActionQueueSizeパラメーターは使用できません
acA1920-25gc 1、ActionQueueSizeパラメーターは使用できません
acA1920-25gm 1、ActionQueueSizeパラメーターは使用できません
acA1920-25uc Scheduled Action Commands機能はサポートされていません
acA1920-25um Scheduled Action Commands機能はサポートされていません
acA1920-40gc 1、ActionQueueSizeパラメーターは使用できません
acA1920-40gm 1、ActionQueueSizeパラメーターは使用できません
acA1920-40uc Scheduled Action Commands機能はサポートされていません
acA1920-40ucMED Scheduled Action Commands機能はサポートされていません
acA1920-40um Scheduled Action Commands機能はサポートされていません
acA1920-40umMED Scheduled Action Commands機能はサポートされていません
acA1920-48gc 1、ActionQueueSizeパラメーターは使用できません
acA1920-48gm 1、ActionQueueSizeパラメーターは使用できません
acA1920-50gc 1、ActionQueueSizeパラメーターは使用できません
acA1920-50gm 1、ActionQueueSizeパラメーターは使用できません
acA1920-150uc Scheduled Action Commands機能はサポートされていません
acA1920-150um Scheduled Action Commands機能はサポートされていません
acA1920-155uc Scheduled Action Commands機能はサポートされていません
acA1920-155ucMED Scheduled Action Commands機能はサポートされていません
acA1920-155um Scheduled Action Commands機能はサポートされていません
acA1920-155umMED Scheduled Action Commands機能はサポートされていません
acA2000-50gc 1、ActionQueueSizeパラメーターは使用できません
acA2000-50gm 1、ActionQueueSizeパラメーターは使用できません
acA2000-50gmNIR 1、ActionQueueSizeパラメーターは使用できません
acA2000-165uc Scheduled Action Commands機能はサポートされていません
acA2000-165um Scheduled Action Commands機能はサポートされていません
acA2000-165umNIR Scheduled Action Commands機能はサポートされていません
acA2040-25gc 1、ActionQueueSizeパラメーターは使用できません
acA2040-25gm 1、ActionQueueSizeパラメーターは使用できません
acA2040-25gmNIR 1、ActionQueueSizeパラメーターは使用できません
acA2040-35gc 1、ActionQueueSizeパラメーターは使用できません
acA2040-35gm 1、ActionQueueSizeパラメーターは使用できません
acA2040-55uc Scheduled Action Commands機能はサポートされていません
acA2040-55um Scheduled Action Commands機能はサポートされていません
acA2040-90uc Scheduled Action Commands機能はサポートされていません
acA2040-90um Scheduled Action Commands機能はサポートされていません
acA2040-90umNIR Scheduled Action Commands機能はサポートされていません
acA2040-120uc Scheduled Action Commands機能はサポートされていません
acA2040-120um Scheduled Action Commands機能はサポートされていません
acA2440-20gc 1、ActionQueueSizeパラメーターは使用できません
acA2440-20gm 1、ActionQueueSizeパラメーターは使用できません
acA2440-35uc Scheduled Action Commands機能はサポートされていません
acA2440-35ucMED Scheduled Action Commands機能はサポートされていません
acA2440-35um Scheduled Action Commands機能はサポートされていません
acA2440-35umMED Scheduled Action Commands機能はサポートされていません
acA2440-75uc Scheduled Action Commands機能はサポートされていません
acA2440-75ucMED Scheduled Action Commands機能はサポートされていません
acA2440-75um Scheduled Action Commands機能はサポートされていません
acA2440-75umMED Scheduled Action Commands機能はサポートされていません
acA2500-14gc 1、ActionQueueSizeパラメーターは使用できません
acA2500-14gm 1、ActionQueueSizeパラメーターは使用できません
acA2500-14uc Scheduled Action Commands機能はサポートされていません
acA2500-14um Scheduled Action Commands機能はサポートされていません
acA2500-20gc 1、ActionQueueSizeパラメーターは使用できません
acA2500-20gcMED 1、ActionQueueSizeパラメーターは使用できません
acA2500-20gm 1、ActionQueueSizeパラメーターは使用できません
acA2500-20gmMED 1、ActionQueueSizeパラメーターは使用できません
acA2500-60uc Scheduled Action Commands機能はサポートされていません
acA2500-60um Scheduled Action Commands機能はサポートされていません
acA3088-16gc 1、ActionQueueSizeパラメーターは使用できません
acA3088-16gm 1、ActionQueueSizeパラメーターは使用できません
acA3088-57uc Scheduled Action Commands機能はサポートされていません
acA3088-57ucMED Scheduled Action Commands機能はサポートされていません
acA3088-57um Scheduled Action Commands機能はサポートされていません
acA3088-57umMED Scheduled Action Commands機能はサポートされていません
acA3800-10gc 1、ActionQueueSizeパラメーターは使用できません
acA3800-10gm 1、ActionQueueSizeパラメーターは使用できません
acA3800-14uc Scheduled Action Commands機能はサポートされていません
acA3800-14um Scheduled Action Commands機能はサポートされていません
acA4024-8gc 1、ActionQueueSizeパラメーターは使用できません
acA4024-8gm 1、ActionQueueSizeパラメーターは使用できません
acA4024-29uc Scheduled Action Commands機能はサポートされていません
acA4024-29um Scheduled Action Commands機能はサポートされていません
acA4096-11gc 1、ActionQueueSizeパラメーターは使用できません
acA4096-11gm 1、ActionQueueSizeパラメーターは使用できません
acA4096-30uc Scheduled Action Commands機能はサポートされていません
acA4096-30ucMED Scheduled Action Commands機能はサポートされていません
acA4096-30um Scheduled Action Commands機能はサポートされていません
acA4096-30umMED Scheduled Action Commands機能はサポートされていません
acA4096-40uc Scheduled Action Commands機能はサポートされていません
acA4096-40ucMED Scheduled Action Commands機能はサポートされていません
acA4096-40um Scheduled Action Commands機能はサポートされていません
acA4096-40umMED Scheduled Action Commands機能はサポートされていません
acA4112-8gc 1、ActionQueueSizeパラメーターは使用できません
acA4112-8gm 1、ActionQueueSizeパラメーターは使用できません
acA4112-20uc Scheduled Action Commands機能はサポートされていません
acA4112-20ucMED Scheduled Action Commands機能はサポートされていません
acA4112-20um Scheduled Action Commands機能はサポートされていません
acA4112-20umMED Scheduled Action Commands機能はサポートされていません
acA4112-30uc Scheduled Action Commands機能はサポートされていません
acA4112-30ucMED Scheduled Action Commands機能はサポートされていません
acA4112-30um Scheduled Action Commands機能はサポートされていません
acA4112-30umMED Scheduled Action Commands機能はサポートされていません
acA4600-7gc 1、ActionQueueSizeパラメーターは使用できません
acA4600-10uc Scheduled Action Commands機能はサポートされていません
acA5472-5gc 1、ActionQueueSizeパラメーターは使用できません
acA5472-5gm 1、ActionQueueSizeパラメーターは使用できません
acA5472-17uc Scheduled Action Commands機能はサポートされていません
acA5472-17ucMED Scheduled Action Commands機能はサポートされていません
acA5472-17um Scheduled Action Commands機能はサポートされていません
acA5472-17umMED Scheduled Action Commands機能はサポートされていません
boA4096-93cc Scheduled Action Commands機能はサポートされていません
boA4096-93cm Scheduled Action Commands機能はサポートされていません
boA4112-68cc Scheduled Action Commands機能はサポートされていません
boA4112-68cm Scheduled Action Commands機能はサポートされていません
boA4500-45cc Scheduled Action Commands機能はサポートされていません
boA4500-45cm Scheduled Action Commands機能はサポートされていません
boA6500-36cc Scheduled Action Commands機能はサポートされていません
boA6500-36cm Scheduled Action Commands機能はサポートされていません
boA8100-16cc Scheduled Action Commands機能はサポートされていません
boA8100-16cm Scheduled Action Commands機能はサポートされていません
daA1280-54lc Scheduled Action Commands機能はサポートされていません
daA1280-54lm Scheduled Action Commands機能はサポートされていません
daA1280-54uc Scheduled Action Commands機能はサポートされていません
daA1280-54um Scheduled Action Commands機能はサポートされていません
daA1600-60lc Scheduled Action Commands機能はサポートされていません
daA1600-60lm Scheduled Action Commands機能はサポートされていません
daA1600-60uc Scheduled Action Commands機能はサポートされていません
daA1600-60um Scheduled Action Commands機能はサポートされていません
daA1920-15um Scheduled Action Commands機能はサポートされていません
daA1920-30uc Scheduled Action Commands機能はサポートされていません
daA1920-30um Scheduled Action Commands機能はサポートされていません
daA1920-160uc Scheduled Action Commands機能はサポートされていません
daA1920-160um Scheduled Action Commands機能はサポートされていません
daA2500-14lc Scheduled Action Commands機能はサポートされていません
daA2500-14lm Scheduled Action Commands機能はサポートされていません
daA2500-14uc Scheduled Action Commands機能はサポートされていません
daA2500-14um Scheduled Action Commands機能はサポートされていません
daA3840-45uc Scheduled Action Commands機能はサポートされていません
daA3840-45um Scheduled Action Commands機能はサポートされていません
puA1280-54uc Scheduled Action Commands機能はサポートされていません
puA1600-60uc Scheduled Action Commands機能はサポートされていません
puA1600-60um Scheduled Action Commands機能はサポートされていません
puA1920-30uc Scheduled Action Commands機能はサポートされていません
puA1920-30um Scheduled Action Commands機能はサポートされていません
puA2500-14uc Scheduled Action Commands機能はサポートされていません
puA2500-14um Scheduled Action Commands機能はサポートされていません

サンプルコード#

// 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を使用して、パラメーターを簡単に設定することもできます。