Software Installation¶

uEye Driver / GigE Vision

For N20, N30/N35, N40/N45 and X-series cameras with 1MP sensors (1CP/1FA models) the IDS uEye driver with version 4.81 or higher is required. Please visit www.ensenso.com/download and download and install the recommended driver version for your system.

XR-series cameras use an HTTP-based proprietary connection to the EnsensoSDK and does not need any driver.

N31/N36, N41/N46 and X-series cameras with 1.6 or 5MP sensors (2CP/2FA or 5CP/5FA models) use the GigE Vision protocol. The GigE Vision transport layer interface is integrated in EnsensoSDK versions starting from version 2.2 onwards. The integrated transport layer operates completely in user space and therefore no drivers are needed to operate these cameras.

EnsensoSDK

After the uEye driver installation is complete, download the latest EnsensoSDK software release from www.ensenso.com/download and follow the instructions on screen to install the software.

XR-Series Firmware

XR cameras come with an updatable firmware. It is recommended to always download the current EnsensoSDK and XR firmware together and update both, camera and PC.

Install the EnsensoSDK as described above.

Open NxView and right click the camera and select Update Firmware. You will be prompted whether you want to select an update file manually or download the corresponding firmware for your EnsensoSDK version directly from the internet.

Wait until the firmware was uploaded to the device and then power cycle the camera.

PartFinder

If you would like to use the PartFinder command for locating CAD models you need to install additional software and licenses. Please refer to the PartFinder License guide for instructions.

Halcon Interface

In order to use Halcon with the EnsensoSDK you need to install the interface as described in this topic.

Storage of Settings

The different software components of the EnsensoSDK will create subfolders below the %ENSENSO_INSTALL%/settings folder to store their settings and cached data. A short description of the files is contained in the table below. When you installed components of the EnsensoSDK manually, please make sure that the ENSENSO_INSTALL environment variable exists and the settings directory is writable.

Subfolder	Purpose
NxLib	`camera_cache.json` : A local cache file for EEPROM contents of hardware cameras. This speeds up camera listing because opening all attached cameras and reading their EEPROM or flash memory to read-out their model names, calibration state and similar data can take a long time. `file_cameras.json` : A list of locally available file cameras with their image folder paths corresponding serial number. `virtual_cameras.json` : A list of locally available virtual cameras containing their optical and geometrical properties and serial numbers.
NxView	`settings.json` : Saved global (camera independent) settings saven when last closing NxView. The same file also contains general NxView settings. `camera_settings_<serial>.json` : The last parameters of camera <serial> saved when closing the camera in NxView last time. This file will also be applied to the camera after opening in NxView by default.
NxTreeEdit	`settings.json` : General settings for NxTreeEdit.
cameras	`eeprom_<serial>.json` : A fallback location to save EEPROM content when a camera doesn’t support saving any data on the hardware. These files are currently used to store EEPROM content for file cameras, virtual cameras, and GigE Vision cameras that do not support eeprom or flash storage.
genicam	`genicam_cache_<serial>_<model>_<firmwareVersion>.xml/zip` : Compressed or uncompressed GenICam XML specification of a specific camera and firmware. This is used to speed up the process of opening a GenICam based camera like GigE Vision cameras.