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 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命令来配置您的网络适配器和系统设置，以实现最佳流媒体性能。
如需了解详情，请参阅这两个命令的文档。
配置 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 选项强制网络适配器的优化，后跟适配器的名称。在这种情况下，无论是否连接了相机，都将始终配置适配器。
要了解哪些参数将被优化，请阅读“受影响的网络参数”主题。
示例#
试运行模式#
试运行模式允许您在应用更改之前检查对系统的更改。
在试运行模式下，配置器会向您显示在您执行该工具时将执行的所有配置和优化步骤。
您可以通过将 -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