Skip to content

Affected Network Parameters#

This topic tells you which network parameters will be optimized by the pylon GigE Configurator.

You can run the optimization by using the GUI version of the configurator or by using the auto-opt / auto-all commands of the CLI version.

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.
Receive Side Scaling Enables Receive Side Scaling (RSS). RSS balances receive traffic across multiple CPUs or CPU cores. It also sets the Receive Side Scaling Queues to 1. This is recommended when low CPU utilization is required. The RSS setting has no effect if your system has only one processing unit.

Info

If you experience buffer underruns or unexpected packet drops, e.g., when running an area scan camera in line scan mode, change the Interrupt Moderation Rate (IMR) setting.

  • First, try setting the IMR to Low or Minimal. This may result in higher CPU load, but it services buffers faster, and requires fewer ringbuffers.
  • If you require low latency performance and don't care about CPU load, you can disable interrupt moderation entirely, which enables the interrupts to fire as fast as possible.
    To do so, set the IMR to Disabled or Off.

For more information, see the Network Configuration (GigE Cameras) topic.

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).

Info

If you experience buffer underruns or unexpected packet drops, e.g., when running an area scan camera in line scan mode, change the Interrupt Moderation Rate (IMR) setting.

  • First, try setting the IMR to 62 µs.
    To do so, open a command line and type: #ethtool -C ethX adaptive-rx off adaptive-tx off rx-usecs 62 tx-usecs 62.
  • If you require low latency performance and don't care about CPU load, you can disable interrupt moderation entirely, which enables the interrupts to fire as fast as possible.
    To do so, open a command line and type: #ethtool -C ethX adaptive-rx off adaptive-tx off rx-usecs 0 tx-usecs 0.

For more information, see the Network Configuration (GigE Cameras) topic.