pylon GigE Configurator (CLI 版本)#

本主題概述命令列版本的 pylon GigE Configurator。

使用 Configurator#

此工具提供三種組態模式。根據您的需求，選擇是要使用此工具來設定整個系統還是僅設定部分系統：

最佳化系統
設定 IP 位址
設定網路設定

此外，還有一種模擬執行模式 (dry-run mode)，可讓您在實際執行工具之前檢查工具將進行的變更。如果需要，可以將任何變更記錄至日誌。

執行 Configurator#

若要執行命令列版本的 pylon GigE Configurator：

請確保已安裝 pylon 7.1 或更高版本。
開啟命令列。
在命令列上，導覽至您的 pylon 安裝目錄，例如 %programfiles%\Basler\pylon x\Runtime\x64 (Windows) 或 /opt/pylon x/bin (Linux)。
從命令列執行 PylonGigEConfigurator。

資訊

若要設定網路介面卡，必須以管理者或 sudo 權限啟動 configurator。
為避免網路衝突，請確保僅將相機連接至您的網路介面卡或交換器。

可用指令#

此工具接受以下命令與選項：

命令	說明
`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`	啟用乾跑模式 (dry-run mode)。這可讓您在設定任何參數之前，先檢查建議的變更。
`-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 網路和相機設定。

Command Syntax
`PylonGigEConfigurator auto-all [-a <name> ...] [--class <A \| B \| C>] [-n] [-h] [-l <filename>]`

運作原理#

執行 auto-all 指令會執行以下操作：

執行 auto-ip 指令以設定網路介面卡和所連接相機的 IP 位址以及子網路遮罩。
執行 auto-opt 指令以設定您的網路介面卡以及系統設定，以獲得最佳的串流效能。

如需詳細資訊，請參閱這兩個指令的文件。

設定 IP 位址#

當 auto-ip 指令會設定網路介面卡和所連接相機的 IP 位址以及子網路遮罩。

Command Syntax
`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

設定網路設定#

當 auto-opt 指令會最佳化您的網路介面卡和系統設定，以達到最佳的串流效能。

Command Syntax
`PylonGigEConfigurator auto-opt [-a <name> ...] [-n] [-h] [-l <filename>]`

當 auto-opt 指令會掃描所有本機 GigE 網路介面卡並檢查連接的相機。如果未偵測到相機，將會略過該介面卡且不會進行設定。

然後，此工具會以遞增順序最佳化所有連接相機的 GigE 網路介面卡。

您可以使用 -a 選項（後面接著介面卡名稱）來強制執行網路介面卡的 IP 設定。在這種情況下，無論是否連接相機，都會進行介面卡設定。

若要了解將最佳化哪些參數，請參閱受影響的網路參數 (Affected Network Parameters) 主題。

範例#

PylonGigEConfigurator auto-opt

PylonGigEConfigurator auto-opt -a "Ethernet 2"

乾跑模式 (Dry-run Mode)#

模擬執行 (Dry-run) 模式允許您在套用變更之前檢查對系統所做的變更。

在模擬執行模式下，組態工具會顯示您執行工具時將執行的所有組態和最佳化步驟。

您可以透過使用 -n 或 --dry-run 選項與任何指令來啟用模擬執行模式。

範例#

PylonGigEConfigurator auto-all -n

PylonGigEConfigurator auto-ip -n

PylonGigEConfigurator auto-opt -n

記錄變更#

組態工具允許您建立用於診斷目的的記錄檔。

Command Syntax
`PylonGigEConfigurator auto-opt [-a <name> ...] [-n] [-h] [-l <filename>`]

您可以使用 -l 或 --log 選項來記錄組態工具所做的一切變更。如果您想將變更記錄到使用者自訂的檔案與目錄，請附加檔名，例如 -l log.txt.

根據預設，組態工具會將所有變更記錄在以下 temp 資料夾中的記錄檔：

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

範例#

PylonGigEConfigurator auto-all -l log.txt