pylon GigE Configurator（CLIバージョン）#
コンフィギュレーターの使用#
このツールには3つの設定モードがあります。要件に応じて、ツールを使用してシステム全体を設定するか、システムの一部のみを設定するかを選択します。
さらに、ドライランモードがあり、実際にツールを実行する前に、ツールが行う変更を確認できます。必要に応じて、変更を記録できます。
コンフィギュレーターの実行#
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オプションに続けてアダプター名を使用すると、ネットワークアダプターの最適化を強制的に実行できます。この場合、カメラが接続されているかどうかに関係なく、アダプターは常に設定されます。
最適化されるパラメーターを確認するには、「影響を受けるネットワークパラメーター」トピックを参照してください。
例#
ドライランモード#
ドライランモードでは、システムへの変更を適用する前に、変更を確認できます。
ドライランモードでは、ツールの実行時に実行されるすべての設定および最適化手順が、コンフィギュレーターに表示されます。
ドライランモードを有効にするには、-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