pylon GigE Configurator（CLIバージョン）#

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

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

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

システムの最適化
Configuring IP Addresses
Configuring Network Settings

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

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

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

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

情報

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

使用可能なコマンド#

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

コマンド	Explanation
`リスト`	アクティブなネットワークアダプターとその現在の設定のリストを表示します。
`auto-ip`	ネットワークアダプターおよび接続されたカメラのIPアドレスおよびサブネットマスクを設定します。
`auto-opt`	ネットワークアダプターとシステム設定（Jumbo Frames、Interrupt Moderation Rate、Receive Descriptorsなど）を最適化し、最高のストリーミングパフォーマンスを実現します。
`auto-all`	auto-optとauto-ipの両方を実行します。

オプション	Explanation
`-h`または`--help`	ヘルプを表示します。
`-l` or `--log <filename>`	Logs to the file specified. Defaults to <TEMP>/<appname>_<timestamp>.log.
`-n`または`--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

システムの最適化#

auto-allコマンドは、GigEネットワークとカメラのセットアップをワンステップで最適化します。

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

仕組み#

auto-allコマンドを実行すると、次の処理が実行されます。

auto-ipコマンドを実行して、ネットワークアダプターと接続されたカメラのIPアドレスおよびサブネットマスクを設定します。
auto-optコマンドを実行して、ネットワークアダプターの設定とシステムの設定を行い、最高のストリーミングパフォーマンスを実現します。

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

Configuring IP Addresses#

auto-ipコマンドは、ネットワークアダプターと接続されたカメラのIPアドレスおよびサブネットマスクを設定します。

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

auto-ipコマンドは、すべてのローカルGigEネットワークアダプターをスキャンし、接続されているカメラを確認します。カメラが検出されなかった場合、指定されたアダプターはスキップされ、設定されません。

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

-aオプションに続けてアダプター名を使用すると、ネットワークアダプターのIP設定を強制的に実行できます。この場合、カメラが接続されているかどうかに関係なく、アダプターは常に設定されます。

また、クラスAやクラスBなど、他のネットワーククラスのアドレス範囲内で、ネットワークアダプターを設定することもできます。これを行うには、--classオプションの後に、クラスタイプ（--class Bなど）を指定します。

--classオプションを省略すると、ツールは、ネットワーククラスCのアドレス範囲を自動的に使用します（例：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#

auto-optコマンドは、ネットワークアダプターとシステム設定を最適化し、最高のストリーミングパフォーマンスを実現します。

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

auto-optコマンドは、すべてのローカルGigEネットワークアダプターをスキャンし、接続されているカメラを確認します。カメラが検出されなかった場合、指定されたアダプターはスキップされ、設定されません。

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

-aオプションに続けてアダプター名を使用すると、ネットワークアダプターの最適化を強制的に実行できます。この場合、カメラが接続されているかどうかに関係なく、アダプターは常に設定されます。

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

例#

PylonGigEConfigurator auto-opt

PylonGigEConfigurator auto-opt -a "Ethernet 2"

ドライランモード#

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

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

ドライランモードを有効にするには、-nまたは--dry-runオプションを、任意のコマンドで使用します。

例#

PylonGigEConfigurator auto-all -n

PylonGigEConfigurator auto-ip -n

PylonGigEConfigurator auto-opt -n

変更の記録#

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

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

-lまたは--logオプションを使用して、コンフィギュレーターによって加えられたすべての変更をログに記録できます。ユーザー定義のファイルとディレクトリーへの変更を記録する場合は、-l log.txtなどのファイル名を付加します。

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

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

例#

PylonGigEConfigurator auto-all -l log.txt