Skip to content

pylon GigE Configurator (GUI Version)#

This topic gives you an overview of the GUI version of the pylon GigE Configurator.

The GUI version of the pylon GigE Configurator is a simplified version of the CLI tool. It is supposed to help you get started quickly when configuring your system. If you require more detailed control over your devices and systems settings, use the CLI tool.

Using the Configurator#

The configurator automatically detects all cameras that are connected to your computer and lists them. Network adapters are also detected and will be configured but they are not listed.

Info

You need administrator/sudo rights to use the configurator.

Running the Configurator#

To run the GUI version of the pylon GigE Configurator:

  1. Make sure that the cameras that you want to configure are connected to the computer.
  2. Close those cameras.
    If you don't close them now, the tool will prompt you later to close them.
  3. In the Tools menu, click pylon GigE Configurator.
    The configurator opens and all detected cameras are listed.

    Linux

    On Linux, camera detection may not always work as expected because of a certain time element during the detection process. For example, a camera may not have booted completely when you open the configurator and will therefore not be listed by the tool.

    If there are cameras missing from the list that you know are connected to the computer or if no cameras are listed at all, click the Configure button. All connected cameras should be detected then.

  4. Select a configuration mode.

  5. Click Configure.
    If you have started the pylon Viewer without administrator/sudo rights, you will be asked to supply these credentials now. The configuration starts. A log file containing all the changes made by the tool will be created.
  6. If desired, click the link to the log file to see the changes the tool has made.

Log File

Depending on your operating system, the log file will be created in the following location:

  • Windows
    In the path specified either by the TEMP or TMP environment variable:
    • %TEMP%\PylonGigEConfigurator_.log
    • %TMP%\PylonGigEConfigurator_.log
  • Linux
    In the path specified by the TMPDIR environment variable or in /tmp if TMPDIR is not defined:
    • $TMPDIR/PylonGigEConfigurator_.log
    • /tmp/PylonGigEConfigurator_.log

Configuration Modes#

Three configuration modes are available:

Optimize Complete System#

The tool combines the tasks of the Configuring IP Addresses and Configuring Network configuration modes.

It configures the IP addresses and subnet masks of network adapters and attached cameras and optimizes network adapters and system settings for best streaming performance.

Configuring IP Addresses#

The tool configures the IP addresses and subnet masks of network adapters and attached cameras. It scans all local GigE network adapters and checks for connected cameras. If no camera has been detected, the given adapter is skipped and won't be configured.

Then, the tool configures the IP addresses of of all GigE network adapters and their connected cameras in ascending order.

Configuring Network#

The tool optimizes network adapters and system settings for best streaming performance. The following tables show the parameters that will be changed:

Windows#
Parameters Description
Jumbo Packet Size Size of the jumbo packets, i.e., Ethernet packets that exceed the standard packet size of 1518 bytes.
Will be set to the maximum possible value.
Receive Buffers Buffer size of system memory that can be used by the adapter for received packets.
Will be set to the maximum possible value, or to 2048 if the driver doesn't provide a registry setting.
Interrupt Moderation Will be set to ON, if available.
Interrupt Moderation Rate Number of interrupts per second.
Will be set to Extreme, or to the current value if the driver doesn't provide a registry setting.
Linux#
Parameters Description
Maximum Transmission Unit Largest size of an Ethernet packet that can be sent over a TCP/IP networking connection.
Will be set to the maximum possible value.
rtprio Modifies whether a process has realtime or idle priority.
Will be set to 99 in /etc/security/limits.conf.
rp_filter Checks the routing table against the source address of incoming packets. This ensures that packets are coming from the interface as defined in the routing table.
In /etc/sysctl.conf, the net.ipv4.conf.<network name>.rp_filter and net.ipv4.conf.all.rp_filter values will be set to 0.
rmem_max Size of the buffer that receives UDP packets.
In /etc/sysctl.conf, the net.core.rmem_max value will be set to 33554432.
ringbuffer The ring buffer is a circular buffer that stores incoming packets to prevent buffer overflow. For this parameter to be set, you must install ethtool first (see Supported Operating Systems).
Will be set to 4096 for every GigE adapter. The configurator also adds or modifies a network startup script in /etc/NetworkManager/dispatcher.d/pre-up.d/basler-network-config to make the settings permanent.
Interrupt Moderation Rate Number of interrupts per second. For this parameter to be set, you must install ethtool first (see Supported Operating Systems).
Will be set to 84 for every GigE adapter. The configurator also adds or modifies a network startup script in /etc/NetworkManager/dispatcher.d/pre-up.d/basler-network-config to make the settings permanent.

Info

You may have to reboot your computer after optimization (Linux only).