Upgrade Notes

<< Click to Display Table of Contents >>

Navigation:  About >

Upgrade Notes

This topic lists noteworthy changes that might in rare cases cause compile-time or run-time issues when upgrading EnsensoSDK or uEye driver versions in an existing application.

Note: Enabling or using new EnsensoSDK functions might in some cases cause incompatibilities in older functions and might require you to make small changes to your existing code as well.

Upgrade of EnsensoSDK

To Version


2.0

The structure of the camera Status node was changed.

The structure of the Sensor node was changed for N10 cameras. It now contains separate nodes for the left and right sensor.

The structure of the Output node was changed to allow more flexible configurations.

The EthernetConfiguration command now requires the Configuration parameter.

The StoreCalibration command now requires the specification of either the Link or the Calibration parameter.

The NxLibRemote TCP protocol changed. It is therefore not possible to connect a version 1.x NxLibRemote to a version 2.x NxLib or vice versa. This also means that a version 2.x NxTreeEdit cannot connect to older versions of the NxLib.

1.9.153

Wibu CodeMeter runtime is needed for loading the NxLib library; the EnsensoSDK installer will automatically install a minimal version of the CodeMeter runtime.

Refinement parameter needs to be specified when using CollectPattern to collect patterns for camera calibration.

Restructured pattern buffer API:

oReturn format of GetPatternBuffers was changed (note that SetPatternBuffers still accepts the earlier format of GetPatternBuffers)

oReducePatterns has been dropped and should be replaced by using a Filter with the Reduce parameter, e.g. in FilterPatternBuffer or VisualizePatternBuffer.

oGlobal PatternCount and MonocularPatternCount nodes have been dropped and need to be replaced by PatternCount and StereoPatternCount nodes in the respective buffer view.

oCollectPattern Result node structure changed.

1.9.0

Support for Debian 6 (Squeeze) and older has been dropped.

Support for Windows XP has been dropped.

Pipelining of stereo geometry: Scaling, Binning and AOI parameters are internally stored on the Rectified and DisparityMap binary nodes. This guarantees that multi threaded processing and parameter modifications always deliver correct depth data. Changes to Scaling, Binning and AOI parameters will only take effect when the affected processing steps have been repeated.

1.3.167

A bug fix in the communication interface between NxLib and NxLibRemote required us to make an incompatible change in the TCP protocol. You thus cannot establish TCP connections between NxLib versions ≥1.3.167 and NxLibRemote versions ≤1.3.166.

1.3.146

When using the Recalibrate function of EstimatePatternPose the eeprom format of the calibration data will be upgraded. The respective camera will then not be compatible anymore with SDK versions prior to 1.3.146.

1.3.0

NxLibItem class operator[] now returns const objects with immutable path. This will avoid accidentally setting the path instead of the item value on temporary objects. Trying to set the path on temporaries will now generate compile-time errors. You will encounter compile-time errors where the assignment with operator= changed the path of the left hand side temporary object.

Upgrade of uEye Driver

To Version


4.80

uEye driver 4.80 contains improved blacklevel parametrization of the image sensors. The saved exposure and blacklevel values might therefore need to be updated.

4.72

uEye driver 4.72 fixes communication issues on internal camera buses. This reduces the number of reported image transfer failures. The release also fixes an issue causing error UEyeApiError -1 when opening the camera the first time on certain system configurations.

4.70

Due to a change in GPIO parametrization in uEye Driver 4.70 N10 cameras will not work with EnsensoSDK versions 1.3.167 and below when running uEye drivers 4.70 and newer. Please upgrade to EnsensoSDK version 1.3.170 or higher to run N10 cameras on uEye driver releases 4.70 or newer.

4.62

uEye driver 4.62 fixes a bug which could cause the sensor FPGA to enter a bad state making a camera reboot necessary.

4.61

uEye Driver 4.61 fixed an important issue with black level parametrization on the GigE camera image sensors. This yields huge improvements in image brightness at the same exposure times. You should therefore check and revise exposure times if you have been using fixed exposure settings in your application.