コンテンツにスキップ

pylon GigE Configurator(CLIバージョン)#

このトピックでは、pylon GigE Configuratorのコマンドラインバージョンの概要について説明します。

コンフィギュレーターの使用#

このツールには3つの設定モードがあります。要件に応じて、ツールを使用してシステム全体を設定するか、システムの一部のみを設定するかを選択します。

さらに、ドライランモードがあり、実際にツールを実行する前に、ツールが行う変更を確認できます。必要に応じて、変更を記録できます。

コンフィギュレーターの実行#

pylon GigE Configuratorのコマンドラインバージョンを実行するには、次の手順を実行します。

  1. pylonバージョン7.1以降がインストールされていることを確認します。
  2. コマンドラインを開きます。
  3. コマンドラインで、%programfiles%\Basler\pylon x\Runtime\x64(Windows)または/opt/pylon x/bin(Linux)などのpylonインストールディレクトリーに移動します。
  4. コマンドラインからPylonGigEConfiguratorを実行します。

情報

  • ネットワークアダプターを設定するには、管理者権限またはsudo権限でコンフィギュレーターを起動する必要があります。
  • ネットワークの競合を避けるため、カメラのみがネットワークアダプターまたはスイッチに接続されていることを確認してください。

使用可能なコマンド#

このツールでは、次のコマンドとオプションを使用できます。

コマンド 説明
リスト アクティブなネットワークアダプターとその現在の設定のリストを表示します。
auto-ip ネットワークアダプターおよび接続されたカメラのIPアドレスおよびサブネットマスクを設定します。
auto-opt ネットワークアダプターとシステム設定(Jumbo Frames、Interrupt Moderation Rate、Receive Descriptorsなど)を最適化し、最高のストリーミングパフォーマンスを実現します。
auto-all auto-optとauto-ipの両方を実行します。
オプション 説明
-h or --help ヘルプを表示します。
-l or --log <filename> Logs to the file specified. Defaults to <TEMP>/<appname>_<timestamp>.log.
-n or --dry-run ドライランモードを有効にします。これにより、パラメーターを設定する前に、提案された変更をチェックできます。
-a or --adaptername <name> 強制的にIPアドレスを割り当てたり、指定されたアダプターの設定を最適化したりします。
--class <A, B, C> IPアドレスを設定する場合、指定されたネットワーククラスのプライベートアドレスを使用します。有効なネットワーククラスはA、B、またはCです。デフォルトはCです。

#

PylonGigEConfigurator list

PylonGigEConfigurator auto-all -h

PylonGigEConfigurator auto-ip -a "Ethernet 2" --class C

システムの最適化#

The auto-all command optimizes your GigE network and camera setup in one single step.

コマンド構文
PylonGigEConfigurator auto-all [-a <name> ...] [--class <A | B | C>] [-n] [-h] [-l <filename>]

仕組み#

Executing the auto-all command does the following:

  1. Runs the auto-ip command to configure the IP addresses and subnet masks of network adapters and attached cameras.
  2. Runs the auto-opt command to configure your network adapters and your system settings for best streaming performance.

詳細については、両方のコマンドのドキュメントを参照してください。

Configuring IP Addresses#

The auto-ip command configures the IP addresses and subnet masks of network adapters and attached cameras.

コマンド構文
PylonGigEConfigurator auto-ip [-a <name> ...] [--class <A | B | C>] [-n] [-h] [-l <filename>]

The auto-ip command scans all local GigE network adapters and checks for connected cameras. If no camera has been detected, the given adapter is skipped and won't be configured.

その後、ツールは、すべてのGigEネットワークアダプターと接続されたカメラのIPアドレスを昇順に設定します。

You can force the IP configuration of a network adapter by using the -a option, followed by the adapter's name. In this case, the adapter will always be configured, regardless of whether a camera is connected or not.

Also, you can configure a network adapter within the address ranges of other network classes, e.g., class A or class B. To do so, use the the --class option followed by the class type, e.g., --class B.

If you omit the --class option, the tool automatically uses the address range from network class C, e.g., 192.168.xxx.xxx.

#

PylonGigEConfigurator auto-ip
PylonGigEConfigurator auto-ip -a "Ethernet 2" -a "Ethernet 3"
PylonGigEConfigurator auto-ip -a "Ethernet 2" --class C

Configuring Network Settings#

The auto-opt command optimizes your network adapters and your system settings for best streaming performance.

コマンド構文
PylonGigEConfigurator auto-opt [-a <name> ...] [-n] [-h] [-l <filename>]

The auto-opt command scans all local GigE network adapters and checks for connected cameras. If no camera has been detected, the given adapter is skipped and won't be configured.

その後、ツールは、接続されたカメラを使用して、すべてのGigEネットワークアダプターを昇順に最適化します。

You can force the optimization of a network adapter by using the -a option, followed by the adapter's name. In this case, the adapter will always be configured, regardless of whether a camera is connected or not.

最適化されるパラメーターを確認するには、「影響を受けるネットワークパラメーター」トピックを参照してください。

#

PylonGigEConfigurator auto-opt

PylonGigEConfigurator auto-opt -a "Ethernet 2"

ドライランモード#

ドライランモードでは、システムへの変更を適用する前に、変更を確認できます。

ドライランモードでは、ツールの実行時に実行されるすべての設定および最適化手順が、コンフィギュレーターに表示されます。

You can enable the dry-run mode by using the -n or --dry-run option with any command.

#

PylonGigEConfigurator auto-all -n

PylonGigEConfigurator auto-ip -n

PylonGigEConfigurator auto-opt -n

変更の記録#

コンフィギュレーターを使用すると、診断目的でログファイルを作成できます。

コマンド構文
PylonGigEConfigurator auto-opt [-a <name> ...] [-n] [-h] [-l <filename>]

You can log all changes made by the configurator with the -l or --log option. If you want to log the changes to a user-defined file and directory, append the file name, e.g., -l log.txt.

デフォルトでは、コンフィギュレーターは、すべての変更を次の一時フォルダーのログファイルに記録します。

  • Windows : %TEMP%\PylonGigEConfigurator_<timestamp>.log
  • Linux : ~/.local/temp/PylonGigEConfigurator_<timestamp>.log

#

PylonGigEConfigurator auto-all -l log.txt