pylon GigE Configurator（CLI 版本）#
使用 Configurator#
该工具提供了三种配置模式。根据您的要求，选择是要使用该工具来配置整个系统，还是仅配置部分系统：
此外，还有一种试运行模式，可让您在实际运行该工具之前检查该工具所做的更改。如果需要，可以记录任何更改。
运行 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 | 优化网络适配器和系统设置（例如，巨型帧、中断调整率、接收描述符）以实现最佳流媒体性能。 |
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 网络和相机设置。
| 命令语法 |
|---|
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 配置。在这种情况下，无论是否连接了相机，都会对适配器进行配置。
要了解哪些参数将被优化，请阅读“受影响的网络参数”主题。
示例#
试运行模式#
试运行模式允许您在应用更改之前检查对系统的更改。
在试运行模式下，配置器会向您显示在您执行该工具时将执行的所有配置和优化步骤。
您可以通过对任何命令使用 -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