Configure 10G/25G Link Speeds on PH-25 NICs

The Hermes PH-25-Dual and PH-25-Quad network interface cards (NICs) from Emergent Vision Technologies support manually switchable 10G and 25G link speeds. Link speed configuration is a system-level NIC setting. Configure the speed with operating-system or NIC management tools, then use eCapture Pro or eSDK with the configured link speed.

IMPORTANT: Changing the link speed breaks the current camera connection and interrupts streaming. Before you change the speed, stop acquisition and make sure the connected camera and transceiver support the new speed.

Requirements

Before you configure link speed, confirm that the system uses:

• PH-25-Dual or PH-25-Quad Emergent NIC
• eSDK installer 2.46.01.21002 or later
• NIC firmware 3.06 or later
• Administrator permissions on Windows or root/sudo permissions on Linux
• A camera and transceiver that support the selected link speed

Check the current link speed

This section describes how to check the current link speed of a Hermes PH-25 NIC.

Linux

Run:

sudo ethtool <iface_name>

Review these fields:

• Supported link modes
• Advertised link modes
• Speed
• Link detected

Windows

Run:

evtnicfwmanager.exe -l

Review these columns:

• Supported Speeds
• Advertised Speeds
• Link

Example output:

Port  MAC                 IP              Supported Speeds    Advertised Speeds   Link
0     e0-55-97-00-04-d2   192.168.1.100   10G/25G             10G                 Up
1     e0-55-97-00-04-d3   192.168.2.100   10G/25G             25G                 Down

‍

Configure the link speed

Stop streaming before you change the link speed. Changing the speed disconnects the camera. After you change the speed, reconnect the camera or restart acquisition as needed.

Linux

Set a port to 10G:

sudo ethtool -s <iface_name> speed 10000

Set a port to 25G:

sudo ethtool -s <iface_name> speed 25000

Example:

sudo ethtool -s enp3s0 speed 10000

Windows

Use this command format:

evtnicfwmanager.exe -d <device_id> -p <port_id> -e <speed>

Where:

• <device_id> is the NIC device ID from evtnicfwmanager.exe -l.
• <port_id> is the NIC port number.
• <speed> is 10000 for 10G or 25000 for 25G.

Set port 0 to 10G:

evtnicfwmanager.exe -d 97 -p 0 -e 10000

Set port 1 to 25G:

evtnicfwmanager.exe -d 97 -p 1 -e 25000

‍

Persistence of link speed configuration

This section describes how link speed configuration persists on a Hermes PH-25 NIC.

Linux

On Linux, use a udev rule to persist the link speed configuration across reboots.

1. Get the MAC address of the interface:

udevadm info -a -p /sys/class/net/enp3s0 | grep address

           Example output:

ATTR{address}=="e0:55:97:01:88:95"

2. Create this file:

/etc/udev/rules.d/99-evt-nic.rules

3. Add a rule similar to this example:

ACTION=="add", SUBSYSTEM=="net", ATTR{address}=="e0:55:97:01:88:95", RUN+="/usr/sbin/ethtool -s enp3s0 speed 10000"

4. Reboot the server.

‍

Windows

On Windows, the speed configuration is persisted automatically after you configure it.

Note: The speed configuration is cleared when eSDK is uninstalled or reinstalled. Configure the speed again after reinstalling eSDK.

Firmware notes

Update the NIC firmware to version 3.06 or later before you configure link speed.

IMPORTANT:

• On Windows, reboot the device after the firmware update.
• On Linux, power cycle the server after the firmware update. Do not use restart or reboot.
• If the firmware upgrade fails, do not close the terminal or command prompt, and do not power off the server. Contact Emergent Vision Technologies.

Verify the configuration

After you configure the link speed:

1. Confirm that the configured speed is correct:
   • Linux: run sudo ethtool <iface_name>.
   • Windows: run evtnicfwmanager.exe -l.
2. Confirm that the connected camera and transceiver support the configured speed.
3. Confirm that the link status is correct.
4. Reconnect the camera if needed.
5. Start acquisition again and confirm that streaming works.

Troubleshooting

‍