NVIDIA Holoscan SDK v0.5.1
v0.5.1

Emergent Vision Technologies (EVT)

Thanks to a collaboration with Emergent Vision Technologies, the Holoscan SDK now supports EVT high-speed cameras.

Note

The addition of an EVT camera to the Holoscan Developer Kits is optional. The Holoscan SDK has an application that can be run with the EVT camera, but there are other applications that can be run without EVT camera.

The EVT cameras can be connected to Holoscan Developer Kits though Mellanox ConnectX SmartNIC, with the most simple connection method being a single cable between a camera and the devkit. For 25 GigE cameras that use the SFP28 interface, this can be achieved by using SFP28 cable with QSFP28 to SFP28 adaptor.

Note

The Holoscan SDK application has been tested using a SFP28 copper cable of 2M or less. Longer copper cables or optical cables and optical modules can be used but these have not been tested as a part of this development.

Refer to the Clara AGX Developer Kit User Guide or the NVIDIA IGX Orin [ES] Developer Kit User Guide for the location of the QSFP28 connector on the device.

For EVT camera setup, refer to Hardware Installation in EVT Camera User’s Manual. Users need to log in to find be able to download Camera User’s Manual.

Tip

The EVT cameras require the user to buy the lens. Based on the application of camera, the lens can be bought from any online store.

The Emergent SDK needs to be installed in order to compile and run the Clara Holoscan applications with EVT camera. The latest tested version of the Emergent SDK is eSDK 2.37.05 Linux Ubuntu 20.04.04 Kernel 5.10.65 JP 5.0 HP and can be downloaded from here. The Emergent SDK comes with headers, libraries and examples. To install the SDK refer to the Software Installation section of EVT Camera User’s Manual. Users need to log in to find be able to download Camera User’s Manual.

Note

The Emergent SDK depends on Rivermax SDK v1.20 and Mellanox OFED Network Drivers v5.8 which are pre-installed by the SDK Manager on the Holoscan Developer Kits. To avoid duplicate installation of the Rivermax SDK and the Mellanox OFED Network Drivers use the following command when installing the Emergent SDK:

Copy
Copied!
            

sudo ./install_eSdk.sh no_mellanox


After installation of the software, execute the steps below to bring up the camera node on the Holoscan devkits in dGPU mode.

  1. Restart openibd to configure Mellanox device, if not already.

Copy
Copied!
            

sudo /etc/init.d/openibd restart

  1. Find out the logical name of the ethernet interface being used to connect EVT camera to Mellanox CX NIC using below command.

Copy
Copied!
            

sudo ibdev2netdev -v

An example of what output would look like is:

Copy
Copied!
            

0007:03:00.0 mlx5_0 (MT4125 - MCX623106AN-CDAT) ConnectX-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0 x16, No Crypto fw 22.33.1048 port 1 (ACTIVE) ==> eth1 (Up) 0007:03:00.1 mlx5_1 (MT4125 - MCX623106AN-CDAT) ConnectX-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0 x16, No Crypto fw 22.33.1048 port 1 (DOWN ) ==> eth2 (Down)

In above example, the camera is connected to ACTIVE port eth1.

Note
  • The logical name of the ethernet interface can be anything and does not need to be eth1 as in above example.

  • if above command does not yield anything, do following and try again:

Copy
Copied!
            

sudo /etc/init.d/openibd restart

  1. Configure the NIC with IP address, if not already during the Installing EVT hardware step. The following command uses the logical name of the ethernet interface found in step 2.

Copy
Copied!
            

sudo ifconfig eth1 down sudo ifconfig eth1 192.168.1.100 mtu 9000 sudo ifconfig eth1 up

To test if the EVT camera and SDK was installed correctly, run the eCapture application with sudo privileges. First, ensure that a valid Rivermax license file is under /opt/mellanox/rivermax/rivermax.lic, then follow the instructions under the eCapture section of EVT Camera User’s Manual.

  1. Problem: The application fails to find the EVT camera.

Solution:

  1. Problem: The application fails to open the EVT camera.

Solutions:

  • Make sure that the application was run with sudo privileges.

  • Make sure a valid Rivermax license file is located at /opt/mellanox/rivermax/rivermax.lic.

  1. Problem: Fail to find eCapture application in the home window.

Solution:

  • Open the terminal and find it under /opt/EVT/eCapture. The applications needs to be run with sudo privileges.

  1. Problem: The eCapture application fails to connect to the EVT camera with error message “GVCP ack error”.

Solutions: It could be an issue with the HR12 power connection to the camera. Disconnect the HR12 power connector from the camera and try reconnecting it.

  1. Problem: The IP address of the Emergent camera is reset even after setting up with the above steps.

Solutions: Check whether the NIC settings in Ubuntu is set to “Connect automatically”. Go to Settings->Network->NIC for the Camera and then unselect “Connect automatically” and in the IPv6 tab, select Disable.

© Copyright 2022-2023, NVIDIA. Last updated on Jul 28, 2023.