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 權限啟動此組態工具。
為避免網路衝突，請確保僅將相機連接至您的網路介面卡或交換器。

可用指令#

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

指令	說明
`list`	顯示使用中的網路介面卡清單及其目前組態。
`auto-ip`	設定網路介面卡與所連接相機的 IP 位址和子網路遮罩。
`auto-opt`	最佳化網路介面卡和系統設定（例如 Jumbo Frames、Interrupt Moderation Rate、Receive Descriptors），以獲得最佳串流效能。
`auto-all`	同時執行自動最佳化（auto-opt）與自動 IP（auto-ip）。

選項	說明
`-h` 或 `--help`	顯示說明。
`-l` 或 `--log <filename>`	Logs to the file specified. Defaults to <TEMP>/<appname>_<timestamp>.log.
`-n` 或 `--dry-run`	啟用乾跑模式（dry-run mode）。這可讓您在設定任何 Property 之前，先檢查建議的變更。
`-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 網路和相機設定。

指令語法
`PylonGigEConfigurator auto-all [-a <name> ...] [--class <A \| B \| C>] [-n] [-h] [-l <filename>]`

運作原理#

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

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

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

設定 IP 位址#

影像 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

設定網路設定#

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

指令語法
`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）模式允許您在套用變更之前檢查系統的變更。

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

您可以透過使用來啟用模擬執行模式 -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.

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

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

範例#

PylonGigEConfigurator auto-all -l log.txt