Mesa Imaging AG, 3D camera, SR4000, SwissRanger Time of flight 3D-camera, range finder, distance measurement, 3D-sensor, 3D-measurement, phase measurement, depth measurement

 

Driver Change Log

Known issues

  • SR_SetMode() in SR4000 with Firmware 0x3d and earlier:
    600ms delay is required after changing into triggered mode before calling Acquire().
    This is a workaround to avoid an internal synchronization loss of the camera so that the image data wraps around over time, but eventually returning to normal operation.
  • SR_Open() called too soon after SR_Close():
    When calling SR_Close(), if you want to call SR_OpenUSB() again you must wait 500ms (empirical number) between calls otherwiseSR_OpenUSB() can fail with a return value of 0. There is not a similar problem for Ethernet cameras.This is fixed in SR4k with firmware > 0x60.
  • No hardware trigger timeout:
    This problem can occur in hardware trigger mode in Ethernet cameras, when Acquire is called, but the hardware trigger signal is never given.In this case the Acquire call returns success, but gives two TCPIP receive error messages and no new image is acquired. All following callsto Acquire have the same result. There is no way to recover from this state other than powering off the camera. USB camera fails gracefully inthis situation, with a return value of -2.

Documentation issues

  • no known issues

Release Notes version: 1.0.14.x (>= 12.7.2010 build 665)

  • update documentation
  • modify definesSR.h to make it C and C++ conform
  • enhance Swissranger3D visualization (internal only)
  • enhance embedded library (internal only)
  • fix various minor bugs

Release Notes version: 1.0.14.x (>= 1.6.2010 build 653)

  • adding preliminary SR_CoordTrfPntUint16 SR_CoordTrfPntDbl SR_CoordTrfPntFlt functions
  • enhanced lens parameter
  • enhance srs-file handling
  • enhance acquire falure and TCP/IP reconnection
  • fix various minor bugs

Release Notes version: 1.0.14.x (>= 1.3.2010 build 620)

  • enhanced calibration with optimized lens parameter
  • fix bugs in SR_SetCallback
  • fix various minor bugs

Release Notes version: 1.0.12.x (>= 4.11.2009 build 608)

  • code cleanup
  • support Linux 64 bit
  • support ARTTS camera
  • fix up to 8 frames delay on ETH cameras
  • fix in amplitude correction
  • support ROI (for special camera firmwares)
  • fix bug in SR_CoordTrfUint16()
  • add function SR_GetFront2RayCross()
  • fix various minor bugs

Release Notes version: 1.0.12.x (>= 17.6.2009 build 583)

  • Rename the library from libusbSR to libMesaSR
  • add libMesaSR linux SDK
  • add 14.5/15.5 MHz support for sr4k (the camera MUST be calibrated to that frq.)
  • support WFOV lens for SR4k (Beta: calibration not yet ready)
  • restructuring calibration and coord transformation code
  • rework on amplitude correction function (faster, more precise)
  • fix bug exit on autoproxy error
  • fixing image shift after flash access (SR4k-ETH)
  • fixing stability issue of auto exposure function
  • documentation and installer fixes

version: 1.0.10.x (>= 2.3.2009 build 564)

  • Fix sync lost after SR_SetMode() or SR_SetModulationFrequency()

version: 1.0.10.x (>= 12.2.2009 build 558)

  • SR4000 Ethernet support
  • Support for SR4000 Selectable modulation frequencies of 29 & 31MHz
  • Linux: Changed from .rpm to .deb package

version: 1.0.10.x (>= 22.7.2008 build 505)

  • Support of SR-4k
  • WARNING: Some functions were previously documented as returning -1 for error and 0 for success.This is not always the case. To be safe, it should be assumed unless specifically documented that functions return a negative number for error,and 0 or a positive number for success.
  • WARNING: return value of SR_OpenXXX is the number of opened cameras:so 0=fails and 1=success..
  • WARNING: update interface: Old code must be adapted to the new interface
  • SR_SetAutoExposure() renamed to SR_SetAutoIllum()
  • SR_SetConfidenceMap() and SR_GetConfidenceMap() moved to deprecated functions
  • SR_GetImageList() added
  • SetBuffer() and associated functions deprecated. See notes in API documentation regarding new approach to memory management.
  • buffers are managed by the library and not any more by the caller.
  • Cleanup sample code
  • new location of application data 'C:/Documents and Settings/All Users/Application Data/MESA/Swissranger' (firmware, calibration data etc.)
  • major documentation changes
  • major code changes and cleanup
  • Changed installation folder from Mesa to MesaImaging
  • improved thread safety

version: 1.0.9.x (1.3.2008)

  • Open Dialog Box
  • Dynamically load dll at runtime
  • Support camera SR3100
  • Download firmware via http on request
  • fixes in SR_GetAmplitudeTreshold / SR_GetSaturationTreshold
  • SR_SetConfidenceMap and SR_GetConfidenceMap added
  • Migration to SVN

version: 1.0.8.x (04.05.2007)

  • Add Python Sample Files
  • Update to MESA Manufactory ID

version: 1.0.7.x (27.02.2007)

  • malfunction of SR_Open (xxx, serialNr)
  • Add new Vendor ID
  • wrong link for version update
  • Sample GUI crash when no calibration file available
  • include newest Firmware SHM & IPM
  • Modulation Frequency as global variable attached to xml-file of each SR-3000

version: 1.0.6.x (13.06.2006)

  • SR_Open crash without xml file
  • Insert a link to the manual in the start menu
  • Integrate new Firmware into the Driver

version: 1.0.5.0 (2.2.2006):

  • Porting to Linux
  • Wrong texts in the settings dialog of the camera registers
  • sr_read requests 512 bytes instead 64 bytes when 32 Words are requested
  • New Checkbox in SwissrangerSampleGUI

version: 1.0.4.16 (5.1.2006):

  • Support of Median filtering

version: 1.0.4.x (22.12.2005):

  • Major changes to the interface
  • XLM-support for calibration cata and firmware
  • Calibration data download via HTTP
  • Check for driver updates via HTTP
  • Documentation update of header files

version: 1.0.1.x (10.8.2005):

  • new firmware for SR-3000
  • supports new sr-3000 camera
  • Preliminary new functions prototypes for calibration, filtering coordinate transformation
  • Interface Changes: instead of a devID a handle is returned of an own type
  • Implementation of multiple camera support
  • Major changes in the internal file structure (libMesaSR.[h,cpp], libMesaSRloc.[h,cpp])
  • Some minor bug fixes

version: 1.0.0.8 (18.5.2005): (not officially published version)

  • Some minor bug fixes
  • Preliminary new functions prototypes for calibration, filtering coordinate transformation

version: 1.0.0.7 (18.5.2005):

  • First Installation Setup with Inno
  • It replaces the older Swissranger1.0.0.5.msi library.