pylon GigE Configurator（CLIバージョン）#
コンフィギュレーターの使用#
このツールには3つの設定モードがあります。要件に応じて、ツールを使用してシステム全体を設定するか、システムの一部のみを設定するかを選択します。
さらに、ドライランモードがあり、実際にツールを実行する前に、ツールが行う変更を確認できます。必要に応じて、変更を記録できます。
コンフィギュレーターの実行#
pylon GigE Configuratorのコマンドラインバージョンを実行するには、次の手順を実行します。
- pylonバージョン7.1以降がインストールされていることを確認します。
- コマンドラインを開きます。
- コマンドラインで、%programfiles%\Basler\pylon x\Runtime\x64（Windows）または/opt/pylon x/bin（Linux）などのpylonインストールディレクトリーに移動します。
- コマンドラインからPylonGigEConfiguratorを実行します。
情報
- ネットワークアダプターを設定するには、管理者権限またはsudo権限でコンフィギュレーターを起動する必要があります。
- ネットワークの競合を避けるため、カメラのみがネットワークアダプターまたはスイッチに接続されていることを確認してください。
使用可能なコマンド#
このツールでは、次のコマンドとオプションを使用できます。
| コマンド | 説明 |
|---|---|
list | アクティブなネットワークアダプターとその現在の設定のリストを表示します。 |
auto-ip | ネットワークアダプターおよび接続されたカメラのIPアドレスおよびサブネットマスクを設定します。 |
auto-opt | ネットワークアダプターとシステム設定（Jumbo Frames、Interrupt Moderation Rate、Receive Descriptorsなど）を最適化し、最高のストリーミングパフォーマンスを実現します。 |
auto-all | auto-optとauto-ipの両方を実行します。 |
| オプション | 説明 |
|---|---|
-h または --help | ヘルプを表示します。 |
-l または --log <filename> | Logs to the file specified. Defaults to <TEMP>/<appname>_<timestamp>.log. |
-n または --dry-run | ドライランモードを有効にします。これにより、パラメーターを設定する前に、提案された変更をチェックできます。 |
-a または --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ネットワークとカメラの設定を1つのステップで最適化します。
| コマンド構文 |
|---|
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アドレスを昇順に設定します。
オプションを使用し、その後にアダプター名を指定することで、ネットワークアダプターのIP設定を強制的に実行できます。 -a この場合、カメラが接続されているかどうかにかかわらず、アダプターは常に設定されます。
また、クラスなどの他のネットワーククラスのアドレス範囲内でネットワークアダプターを設定することもできます。 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