Matrix Vision mvBlueLYNX-X User manual

mvBlueLYNX-X
Technical Manual
22 April 2016 - Version 1.49
Copyright © 2017 MATRIX VISION GmbH

Table of Contents
1 mvBlueLYNX-X Technical Manual..............................................................................................................1
2 Legal Notice and Contact...............................................................................................................................3
2.1 Introduction.......................................................................................................................................3
2.2 wxWidgets........................................................................................................................................4
2.2.1 wxPropGrid.............................................................................................................................4
2.3 Sarissa...............................................................................................................................................4
2.4 Komponenten.GenICam...................................................................................................................4
2.5 libusb.................................................................................................................................................4
2.6 libusbK..............................................................................................................................................4
2.6.1 libusbK license........................................................................................................................5
2.7 Doxygen............................................................................................................................................5
2.7.1 Doxygen license......................................................................................................................5
2.8 SHA1 algorithm................................................................................................................................5
2.9 minizip, zlib......................................................................................................................................6
2.9.1 minizip, zlib license.................................................................................................................6
2.10 Expat...............................................................................................................................................6
2.10.1 Expat Copyright....................................................................................................................6
2.11 OpenSSL.........................................................................................................................................7
2.11.1 OpenSSL License Issues.......................................................................................................7
2.11.2 OpenSSL License..................................................................................................................7
2.12 CppUnit...........................................................................................................................................7
2.13 NUnit..............................................................................................................................................8
2.13.1 NUnit License........................................................................................................................8
3 Revisions..........................................................................................................................................................9
4 Graphic Symbols...........................................................................................................................................13
4.1 Notes, Warnings, Attentions...........................................................................................................13
4.2 Webcasts.........................................................................................................................................13
5 Important Information.................................................................................................................................15
5.1 Important safety instructions...........................................................................................................15
5.2 Operating considerations................................................................................................................15
5.2.1 Important safety notes...........................................................................................................15
5.2.2 Handling and cleaning...........................................................................................................15
5.2.3 Installing................................................................................................................................15
5.2.4 Optimizing performance and life time..................................................................................16
5.2.5 Connectors.............................................................................................................................16
5.2.6 Cleaning.................................................................................................................................16
5.3 European Union Declaration of Conformity statement..................................................................16
6 About this Manual........................................................................................................................................19
6.1 Goal of the manual..........................................................................................................................19
6.2 Contents of the manual...................................................................................................................19
7 Introduction...................................................................................................................................................21
7.1 Nomenclature..................................................................................................................................22
7.2 What's inside and accessories.........................................................................................................24
8 Technical Data...............................................................................................................................................27
8.1 Dimensions of mvBlueLYNX-X....................................................................................................27
8.2 Specifications..................................................................................................................................28
8.3 Camera interfaces............................................................................................................................29
I

Table of Contents
8 Technical Data
8.3.1 Circular connector male (Power / Digital I/O)......................................................................29
8.3.1.1 Characteristics of the digital inputs.............................................................................29
8.3.1.1.1 Delay..................................................................................................................30
8.3.1.2 Characteristics of the digital outputs...........................................................................30
8.3.1.2.1 Delay..................................................................................................................31
8.3.1.2.2 Example circuit 1: High-side switch uses power supply of the camera.............31
8.3.1.2.3 Example circuit 2: High-side switch uses external (higher) power supply........32
8.3.1.3 Using the serial port.....................................................................................................32
8.3.2 Circular connector female (VGA / USB)..............................................................................32
8.3.3 Circular connector female (Digital I/O; via add-on board BLX-IO)....................................34
8.3.3.1 Characteristics when used as digital inputs.................................................................34
8.3.3.2 Characteristics when used as digital outputs...............................................................35
8.3.4 RJ45 network connector (Fast Ethernet / 100 Mbit).............................................................35
8.3.5 USB-OTG (under the small metal plate)...............................................................................36
8.3.5.1 Linux............................................................................................................................37
8.3.5.2 Windows......................................................................................................................37
8.3.6 µSD card slot (under the small metal plate)..........................................................................38
8.3.7 Power LED............................................................................................................................38
8.3.8 Status LEDs...........................................................................................................................38
8.3.8.1 How to use the LEDs...................................................................................................38
9 Sensor Data....................................................................................................................................................41
9.1 Output sequence of color sensors (RGB Bayer).............................................................................41
9.2 CCD................................................................................................................................................41
9.2.1 Details of operation...............................................................................................................41
9.2.1.1 Trigger.........................................................................................................................42
9.2.1.2 Exposure......................................................................................................................43
9.2.1.3 Readout........................................................................................................................43
9.2.2 Models...................................................................................................................................44
9.2.2.1 mvBlueLYNX-X120a (VGA 640 x 480)....................................................................44
9.2.2.1.1 Spectral Sensitivity.............................................................................................44
9.2.2.1.2 Timings...............................................................................................................45
9.2.2.2 mvBlueLYNX-X120b (VGA 640 x 480)....................................................................47
9.2.2.2.1 Spectral Sensitivity.............................................................................................47
9.2.2.2.2 Timings...............................................................................................................48
9.2.2.3 mvBlueLYNX-X120d (SVGA 776 x 580)..................................................................50
9.2.2.3.1 Spectral Sensitivity.............................................................................................50
9.2.2.3.2 Timings...............................................................................................................51
9.2.2.4 mvBlueLYNX-X122 (SXGA 1280 x 960)..................................................................53
9.2.2.4.1 Spectral Sensitivity.............................................................................................53
9.2.2.4.2 Timings...............................................................................................................54
9.2.2.5 mvBlueLYNX-X123 (SXGA 1360 x 1024)................................................................56
9.2.2.5.1 Spectral Sensitivity.............................................................................................56
9.2.2.5.2 Timings...............................................................................................................57
9.2.2.6 mvBlueLYNX-X124 (UXGA 1600 x 1200)...............................................................59
9.2.2.6.1 Spectral Sensitivity.............................................................................................59
9.2.2.6.2 Timings...............................................................................................................60
9.2.2.7 mvBlueLYNX-X125a (5 Mpix 2448 x 2050).............................................................62
9.2.2.7.1 Spectral Sensitivity.............................................................................................62
9.2.2.7.2 Timings...............................................................................................................63
9.3 CMOS.............................................................................................................................................65
9.3.1 Details of operation...............................................................................................................65
9.3.1.1 Free running mode.......................................................................................................65
II

Table of Contents
9 Sensor Data 9.3.1.2 Snapshot mode.............................................................................................................65
9.3.1.2.1 Trigger................................................................................................................65
9.3.1.2.2 Erase, exposure and readout...............................................................................67
9.3.2 Models...................................................................................................................................68
9.3.2.1 mvBlueLYNX-X100w (WVGA 752 x 480)...............................................................68
9.3.2.1.1 Spectral Sensitivity.............................................................................................68
9.3.2.1.2 Timings...............................................................................................................69
9.3.2.2 mvBlueLYNX-X102b (SXGA 1280 x 960)................................................................70
9.3.2.2.1 Spectral Sensitivity.............................................................................................70
9.3.2.2.2 Timings...............................................................................................................71
9.3.2.3 mvBlueLYNX-X102e (SXGA 1280 x 1024)..............................................................73
9.3.2.3.1 Spectral Sensitivity.............................................................................................73
9.3.2.3.2 Timings...............................................................................................................74
9.3.2.4 mvBlueLYNX-X105 (5MP 2592 x 1944)...................................................................76
9.3.2.4.1 Spectral Sensitivity.............................................................................................77
9.3.2.4.2 Timings...............................................................................................................78
10 Filter and Lenses.........................................................................................................................................79
10.1 Filters............................................................................................................................................79
10.1.1 Hot mirror filter...................................................................................................................79
10.1.1.1 Technical data............................................................................................................79
10.1.2 Glass filter...........................................................................................................................79
10.1.2.1 Technical data............................................................................................................79
10.2 Lenses...........................................................................................................................................80
11 Initial Delivery Configuration...................................................................................................................81
11.1 Booting..........................................................................................................................................81
11.2 Linux OS environment..................................................................................................................81
11.3 Keyboard layout............................................................................................................................81
11.4 VGA resolution.............................................................................................................................82
11.5 Network configuration..................................................................................................................82
11.6 Storing Data On µSD Cards or USB Devices...............................................................................84
11.6.1 Powering Down The Camera..............................................................................................84
11.6.2 Precautions..........................................................................................................................84
11.7 X11................................................................................................................................................85
11.7.1 X11Forwarding...................................................................................................................85
11.8 FTP................................................................................................................................................86
11.9 CPU throttling policy....................................................................................................................86
11.9.1 Green Automation!..............................................................................................................86
11.10 Mounting Windows® Shares......................................................................................................87
11.11 Mounting USB Sticks.................................................................................................................88
11.12 Application Desktop Files..........................................................................................................88
11.13 Autostart Applications................................................................................................................89
11.13.1 GUI Applications..............................................................................................................89
11.13.2 Console Applications........................................................................................................90
12 First Start.....................................................................................................................................................91
12.1 Requirements................................................................................................................................91
12.2 Connecting the camera..................................................................................................................92
12.3 First Look at the Linux OS...........................................................................................................92
12.4 First Image from the Camera........................................................................................................94
12.4.1 Settings behavior during startup..........................................................................................96
III

Table of Contents
13 Application Installation and Usage...........................................................................................................99
13.1 Introduction...................................................................................................................................99
13.1.1 Changing the feed location..................................................................................................99
13.1.2 Using a Proxy......................................................................................................................99
13.2 Working with ipks......................................................................................................................100
13.2.1 Updating the mvBlueLYNX-X.........................................................................................100
13.2.1.1 Restarting the camera...............................................................................................101
13.2.2 Installing single applications.............................................................................................101
13.2.3 Removing single applications...........................................................................................101
13.2.4 Listing packages................................................................................................................101
13.3 Preinstalled Packages..................................................................................................................101
13.3.1 mvIMPACT Acquire Packages.........................................................................................101
13.3.1.1 Essential Packages...................................................................................................102
13.3.1.2 Installed, Optional Packages....................................................................................102
13.3.1.3 Optional Packages....................................................................................................102
13.4 Main Applications.......................................................................................................................102
13.4.1 wxPropView......................................................................................................................102
13.4.1.1 How to work with wxPropView..............................................................................103
13.4.1.1.1 Storing and restoring settings.........................................................................104
13.4.1.1.2 Properties........................................................................................................105
13.4.1.1.3 Methods..........................................................................................................106
13.4.1.1.4 Copy grid data to the clipboard......................................................................106
13.4.1.1.5 Import and Export images..............................................................................107
13.4.1.1.6 Bit-shifting an image......................................................................................107
13.4.1.2 How to configure a device.......................................................................................108
13.4.1.2.1 How to see the first image..............................................................................108
13.4.1.2.2 White balance of a camera device (color version).........................................109
13.4.1.2.3 Configuring different trigger modes..............................................................111
13.4.1.2.4 Testing the digital inputs................................................................................112
13.4.1.2.5 Saving user settings in the non-volatile flash memory..................................112
14 GenICam and Advanced Features..........................................................................................................115
14.1 Introduction.................................................................................................................................115
14.1.1 Device Control..................................................................................................................116
14.1.2 Image Format Control.......................................................................................................116
14.1.3 Acquisition Control...........................................................................................................116
14.1.4 Counter And Timer Control..............................................................................................118
14.1.5 Analog Control..................................................................................................................119
14.1.6 Digital I/O Control............................................................................................................119
14.1.7 Transport Layer Control....................................................................................................119
14.1.8 mv X Lamp Control..........................................................................................................120
14.1.9 User Set Control................................................................................................................120
15 mvBlueLYNX-X SDK...............................................................................................................................121
15.1 Introduction.................................................................................................................................121
15.2 Packages......................................................................................................................................121
15.3 Installation..................................................................................................................................121
15.4 Usage...........................................................................................................................................122
15.4.1 Makefiles...........................................................................................................................122
15.4.2 Copying files to the mvBlueLYNX-X..............................................................................122
15.5 Eclipse.........................................................................................................................................123
15.5.1 Compiler Flags and Options..............................................................................................123
15.5.1.1 Cross G++ Compiler................................................................................................123
15.5.1.2 Optimization............................................................................................................123
IV

Table of Contents
15 mvBlueLYNX-X SDK
15.5.1.3 Warnings..................................................................................................................123
15.5.1.4 Miscellaneous..........................................................................................................123
15.5.1.5 Linker.......................................................................................................................123
15.5.2 mvIMPACT Acquire.........................................................................................................123
15.5.2.1 Libraries...................................................................................................................123
15.5.3 FLTK.................................................................................................................................123
15.5.3.1 Compiler..................................................................................................................124
15.5.3.2 Linker.......................................................................................................................124
15.5.4 wxWidgets.........................................................................................................................124
15.5.4.1 Compiler..................................................................................................................124
15.5.4.2 Linker.......................................................................................................................124
16 mvBlueLYNX-X - LiveDVD and Virtual Machine................................................................................125
16.1 Introduction.................................................................................................................................125
16.1.1 Requirements.....................................................................................................................125
16.1.2 LiveDVD Image Description............................................................................................125
16.1.2.1 Login data................................................................................................................125
16.2 Working with the LiveDVD.......................................................................................................126
16.2.1 Creating a VirtualBox Virtual Machine image.................................................................126
16.2.2 Running the Virtual Machine............................................................................................132
16.2.3 Starting the LiveDVD.......................................................................................................134
16.2.4 Working with the Virtual Machine image.........................................................................135
16.2.4.1 Eclipse (IDE)...........................................................................................................135
16.2.5 Installing the LiveDVD.....................................................................................................136
16.2.5.1 Updates....................................................................................................................136
17 mvIMPACT SDK......................................................................................................................................137
17.1 Introduction.................................................................................................................................137
17.2 mvIMPACT modules..................................................................................................................137
17.3 SDK Installation.........................................................................................................................137
17.4 Installation on mvBlueLYNX-X.................................................................................................138
17.4.1 Installing runtime libraries................................................................................................138
17.4.2 Licenses.............................................................................................................................138
17.5 mvIMPACT Manual...................................................................................................................138
17.6 Differences between mvIMPACT for mvBlueLYNX-X and mvIMPACT for Windows..........138
17.6.1 Supported languages..........................................................................................................138
17.6.2 mvIMPACT Base..............................................................................................................138
17.6.3 mvIMPACT Display 3D...................................................................................................138
18 Eclipse (IDE)..............................................................................................................................................139
18.1 Introduction.................................................................................................................................139
18.2 Requirements..............................................................................................................................139
18.3 Working with Eclipse.................................................................................................................139
18.3.1 Setting the Proxy...............................................................................................................139
18.3.2 Installing new plugins / software in Eclipse......................................................................141
18.3.3 Importing samples.............................................................................................................143
18.3.4 Setting up remote connection............................................................................................146
18.3.5 Running a MATRIX VISION sample...............................................................................154
18.3.5.1 Using Sftp (copying the binary to the mvBlueLYNX-X physically)......................154
18.3.5.2 Using NFS mount (mounting a directory in mvBlueLYNX-X)..............................158
18.3.6 Debugging a MATRIX VISION sample...........................................................................159
18.3.6.1 Debugging a sample on the mvBlueLYNX-X itself................................................160
18.3.6.2 Debugging a sample on the mvBlueLYNX-X remotely.........................................160
V

Table of Contents
18 Eclipse (IDE)
18.3.7 Creating a new application (Hello World)........................................................................164
19 MonoDevelop (IDE)..................................................................................................................................177
19.1 Introduction.................................................................................................................................177
19.2 Requirements..............................................................................................................................177
19.2.1 Development System.........................................................................................................177
19.2.1.1 Windows..................................................................................................................177
19.2.1.2 Linux........................................................................................................................177
19.2.2 Target System....................................................................................................................177
19.2.2.1 mvBlueLYNX-X.....................................................................................................177
19.3 Development Workflow..............................................................................................................178
19.4 Resources....................................................................................................................................179
20 Use Cases....................................................................................................................................................181
20.1 Using a mvBlueFOX-MLC USB 2.0 camera with mvBlueLYNX-X........................................181
20.2 Acquiring a number of images....................................................................................................181
20.3 Controlling external strobe or flash............................................................................................183
20.3.1 Compensating delay of strobe or flash..............................................................................184
20.4 Using the HDR mode with sensor -x00w...................................................................................185
20.4.1 Functionality......................................................................................................................185
20.4.2 Description........................................................................................................................186
20.5 Using the HDR mode with sensor -x02d....................................................................................187
20.5.1 Functionality......................................................................................................................187
20.5.1.1 Description...............................................................................................................188
20.5.1.2 Possible settings.......................................................................................................189
20.6 Reset timestamp by hardware.....................................................................................................189
20.7 Synchronized acquisitions using timers......................................................................................190
20.7.1 Basics.................................................................................................................................190
20.7.2 Connecting the hardware...................................................................................................190
20.7.2.1 On the master camera..............................................................................................190
20.7.2.2 On each slave camera..............................................................................................190
20.7.2.3 Between the cameras...............................................................................................190
20.7.3 Programming the acquisition.............................................................................................191
20.7.3.1 Start timer................................................................................................................191
20.7.3.2 Set digital I/O...........................................................................................................192
20.7.3.3 Set trigger.................................................................................................................192
20.7.3.3.1 Master - Slave.................................................................................................192
20.7.3.3.2 Slave - Slave...................................................................................................192
20.7.4 Programming the synchronized acquisition using wxPropView......................................193
20.8 Generating a pulse width modulation (PWM)............................................................................195
20.8.1 Programming the pulse width modulation........................................................................196
20.8.2 Programming the pulse width modulation with wxPropView..........................................197
20.9 Outputting a pulse at every other external trigger......................................................................197
20.10 Creating a debouncing filter at the inputs.................................................................................198
20.11 Using the linescan mode of -x02e.............................................................................................200
20.11.1 Sample: Triggered linescan acquisition with exposure time of 250 us...........................200
20.11.1.1 Initial situation and settings...................................................................................200
20.11.1.2 Setting the application in wxPropView.................................................................201
21 Troubleshooting........................................................................................................................................205
21.1 How to detect that the internal SD card is damaged?.................................................................205
21.2 My USB 2.0 hub doesn't seem to work with the mvBlueLYNX-X?..........................................205
21.3 I've got no keyboard, is there a virtual one?...............................................................................205
VI

Table of Contents
21 Troubleshooting
21.4 Does the mvBlueLYNX have a hardware real-time controller?.................................................206
21.5 Building the MATRIX VISION samples without Eclipse.........................................................206
21.6 My application does not work - How do I see more debug messages?......................................206
21.7 "Device or resource busy" debug messages................................................................................207
21.8 No mvIMPACT Acquire application is running but still seeing "Device or resource busy"
debug messages...................................................................................................................................207
21.9 mvBlueLYNX-X boots but there is no display...........................................................................207
21.10 How can I find my mvBlueLYNX-X in the network?.............................................................208
21.10.1 Windows..........................................................................................................................208
21.10.2 Linux...............................................................................................................................208
22 Glossary.....................................................................................................................................................209
22.1 Fast Ethernet...............................................................................................................................209
22.2 GenICam.....................................................................................................................................209
22.3 Gigabit Ethernet (GigE)..............................................................................................................209
22.4 GigEVision®..............................................................................................................................209
22.5 High Dynamic Range (HDR)......................................................................................................209
22.6 IDE..............................................................................................................................................209
22.7 mvIMPACT Acquire..................................................................................................................210
22.8 mvIMPACT SDK.......................................................................................................................210
22.9 LLA.............................................................................................................................................210
22.10 OpenGL® ES............................................................................................................................213
22.11 Overlapped / pipelined transfer.................................................................................................213
22.12 Proxy.........................................................................................................................................214
22.13 SFNC........................................................................................................................................214
22.14 SSH...........................................................................................................................................214
22.15 Virtual Network Computing (VNC).........................................................................................215
22.16 VirtualBox................................................................................................................................215
22.17 Virtual Machine........................................................................................................................215
23 Index...........................................................................................................................................................217
24 Table of Figures.........................................................................................................................................221
VII

VIII

1 mvBlueLYNX-X
Technical Manual
MATRIX VISION GmbH 22 April 2016 Version - 1.49 1

mvBlueLYNX-X Technical Manual
2 22 April 2016 Version - 1.49 MATRIX VISION GmbH

2 Legal Notice and Contact
Post address
MATRIX VISION GmbH
Talstrasse 16
DE - 71570 Oppenweiler
Phone: [phone]
Fax: [phone]
Website: http://www.matrix-vision.de
E-Mail
[email protected]• [email protected]• [email protected]•
Authors
U. Lansche• H. Mattfeldt• H. Gray• M. Jones•
Date
22 April 2016•
This document assumes a general knowledge of PCs and programming.
Since the documentation is published electronically an updated version may be available online. For this
reason we recommend checking for updates on the MATRIX VISION website.
MATRIX VISION cannot guarantee that the data is free of errors or is accurate and complete and, therefore,
assumes no liability for loss or damage of any kind incurred directly or indirectly through the use of the
information of this document.
MATRIX VISION reserves the right to change technical data and design and specifications of the described
products at any time without notice.
Email: [email protected]
Copyright © 2013 MATRIX VISION GmbH. All rights reserved. The text, images and graphical content
are protected by copyright and other laws which protect intellectual property. It is not permitted to copy or
modify them for trade use or transfer. They may not be used on websites.
Windows® XP, Windows® Vista, Windows® 7 are trademarks of Microsoft, Corp.• Linux® is a trademark of Linus Torvalds.•
2.1 Introduction
MATRIX VISION GmbH 22 April 2016 Version - 1.49 3

The mvIMPACT Acuire SDK and its underlying libraries and drivers as well as some of the applications
shipped with the mvIMPACT Acquire packages make use of a couple of third party software packages that
come with various licenses. This section is meant to list all these packages and to give credit to those whos
code helped in the creation of the mvIMPACT Acquire SDK.
2.2 wxWidgets
Most of the applications offering a graphical user interface have been written using wxWidgets
(http://www.wxwidgets.org/).
wxWidgets is a C++ library that lets developers create applications for Windows, OS X, Linux and Unix on
32-bit and 64-bit architectures as well as several mobile platforms including Windows Mobile, iPhone SDK
and embedded GTK+. Please refer to the wxWidgets website for detailed license information.
The source code of the applications provided by MATRIX VISION GmbH (http://www.matrix-vision.com)
using wxWidgets is either part of the packet this document was taken from or can be obtained by contacting
MATRIX VISON GmbH.
2.2.1 wxPropGrid
Some of the applications based using wxWidgets make also use of a modified version of an additional control
written by Jaakko Salli called \a wxPropGrid. The latest stable version can be obtained from here:
http://wxpropgrid.sourceforge.net/cgi-bin/index.
2.3 Sarissa
Parts of the log file creation and the log file display make use of Sarissa (Website: http://dev.abiss.gr/sarissa)
which is distributed under the GNU GPL version 2 or higher, GNU LGPL version 2.1 or higher and Apache
Software License 2.0 or higher. The Apache Software License 2.0 is part of this driver package.
2.4 Komponenten.GenICam
At least one driver package shipped under the product family name mvIMPACT Acquire makes use of the
GenICam reference implementation, which is hosted by the EVMA and can be downloaded from their
website: http://www.emva.org. All license files belonging to the GenICam reference implementation are
shipped with the libraries belonging to the GenICam runtime.
2.5 libusb
The Linux version of the \b mvBlueFOX driver package makes use of a modified version of libusb
(http://www.libusb.org/), which comes under LGPL 2.1. The full license text is included in the Linux
distribution of the \b mvBlueFOX driver package. The source code for the modified version of libusb can be
obtained by contacting MATRIX VISION GmbH or it can be downloaded from here:
http://gpl.matrix-vision.com (navigate to \a others/libusb).
2.6 libusbK
The USB3 Vision implementation currently makes use of libusbK (http://libusbk.sourceforge.net) written by
Travis Lee Robinson who owns all rights for the source code of all modules belonging to the libusbK
framework.
mvBlueLYNX-X Technical Manual
4 22 April 2016 Version - 1.49 MATRIX VISION GmbH

2.6.1 libusbK license
APPLICABLE FOR ALL LIBUSBK BINARIES AND SOURCE CODE UNLESS OTHERWISE
SPECIFIED. PLEASE SEE INDIVIDUAL COMPONENTS LICENSING TERMS FOR DETAILS.
NOTE: Portions of dpscat use source code from libwdi which is licensed for LGPL use only. (See dpscat.c)
NOTE: libusbK-inf-wizard.exe is linked to libwdi which is licensed for LGPL use only.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that
the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
•
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
the following disclaimer in the documentation and/or other materials provided with the distribution.
•
Neither the name of Travis Lee Robinson nor the names of its contributors may be used to endorse or
promote products derived from this software without specific prior written permission.
•
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL TRAVIS ROBINSON BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2.7 Doxygen
All the documentation belonging to the mvIMPACT Acquire framework has been generated using Doxygen
(http://www.doxygen.org/) written by Dimitri van Heesch.
2.7.1 Doxygen license
Copyright © 1997-2013 by Dimitri van Heesch.
Permission to use, copy, modify, and distribute this software and its documentation under the terms of the
GNU General Public License is hereby granted. No representations are made about the suitability of this
software for any purpose. It is provided "as is" without express or implied warranty. See the GNU General
Public License for more details.
Documents produced by doxygen are derivative works derived from the input used in their production; they
are not affected by this license.
2.8 SHA1 algorithm
Parts of this framework make use of an open source implementation of the SHA1 algorithm written by
Dominik Reichl (http://www.dominik-reichl.de).
mvBlueLYNX-X Technical Manual
MATRIX VISION GmbH 22 April 2016 Version - 1.49 5

2.9 minizip, zlib
Parts of this framework make use of minizip (http://www.winimage.com/zLibDll/minizip.html) or zlib
respectively. The Zlib library allows to deflate compressed files and to create gzip (.gz) files. Zlib is free
software and small. The minizip package has been written by Gilles Vollant.
2.9.1 minizip, zlib license
Copyright notice:
© 1995-2010 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held
liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and
to alter it and redistribute it freely, subject to the following restrictions:
The origin of this software must not be misrepresented; you must not claim that you wrote the original
software. If you use this software in a product, an acknowledgment in the product documentation
would be appreciated but is not required.
1.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the
original software.
2.
This notice may not be removed or altered from any source distribution.3.
Jean-loup Gailly, [email protected]• Mark Adler, [email protected]•
2.10 Expat
Expat is used to parse XML strings within the SDK.
2.10.1 Expat Copyright
Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of
the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
mvBlueLYNX-X Technical Manual
6 22 April 2016 Version - 1.49 MATRIX VISION GmbH

2.11 OpenSSL
OpenSSL is used to perform license authentification.
2.11.1 OpenSSL License Issues
The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the
original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are
BSD-style Open Source licenses. In case of any license issues related to OpenSSL please contact
[email protected].
2.11.2 OpenSSL License
Copyright (c) 1998-2000 The OpenSSL Project. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that
the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
1.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
the following disclaimer in the documentation and/or other materials provided with the distribution.
2.
All advertising materials mentioning features or use of this software must display the following
acknowledgment: "This product includes software developed by the OpenSSL Project for use in the
OpenSSL Toolkit. (http://www.openssl.org/)"
3.
The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote
products derived from this software without prior written permission. For written permission, please
contact [email protected].
4.
Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in
their names without prior written permission of the OpenSSL Project.
5.
Redistributions of any form whatsoever must retain the following acknowledgment: "This product
includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit
(http://www.openssl.org/)"
6.
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.
This product includes cryptographic software written by Eric Young ([email protected]). This product
includes software written by Tim Hudson ([email protected]).
2.12 CppUnit
The C and C++ code is tested using the CppUnit (http://cppunit.sourceforge.net) framework, which come
under GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999.
mvBlueLYNX-X Technical Manual
MATRIX VISION GmbH 22 April 2016 Version - 1.49 7

2.13 NUnit
The .NET code is tested using the NUnit (http://www.nunit.org/) framework.
2.13.1 NUnit License
Copyright © 2002-2008 Charlie Poole Copyright © 2002-2004 James W. Newkirk, Michael C. Two, Alexei
A. Vorontsov Copyright © 2000-2002 Philip A. Craig
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held
liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and
to alter it and redistribute it freely, subject to the following restrictions:
The origin of this software must not be misrepresented; you must not claim that you wrote the original
software. If you use this software in a product, an acknowledgment (see the following) in the product
documentation is required. Portions Copyright © 2002-2008 Charlie Poole or Copyright © 2002-2004
James W. Newkirk, Michael C. Two, Alexei A. Vorontsov or Copyright © 2000-2002 Philip A. Craig
1.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the
original software.
2.
This notice may not be removed or altered from any source distribution.3.
mvBlueLYNX-X Technical Manual
8 22 April 2016 Version - 1.49 MATRIX VISION GmbH

3 Revisions
Date Rev. Author Description
22 April 2016 1.49 LAN Removed sensor -102d.
15 April 2015 1.47 LAN Added lens protrusion data.
2 February 2015 1.46 LAN Removed Gigabit Ethernet cables from accessories.
10 July 2014 1.46 LAN Corrected distance of the mounting holes on the back in
Dimensions of mvBlueLYNX-X.
02 July 2014 1.45 LAN Added new troubleshooting solution How can I find my
mvBlueLYNX-X in the network?.
27 March 2014 1.44 GRA
LAN Corrected info about OpenGL® ES and added glossary term. Added color code of cable KS-BLX-PWR in Circular connector
male.
19 March 2014 1.43 LAN Added accessory KS-BLX-PWR.
05 February 2014 1.42 LAN Added use case for linescan mode.
04 December 2013 1.41 LAN Added information about mvBlueLYNX-X option -xx9x
(mvBlueLYNX-X without housing) in Technical Data.
29 November 2013 1.40 LAN Corrected nomenclature concerning module version and added
order sample.
25 November 2013 1.39 RIN
LAN Information about file .gdbinit for the eclipse gdb debugger Updated scope of supply.
7 November 2013 1.38 LAN Added White balance with pixel format YUV422Packed.
22 October 2013 1.37 LAN Added webcast about XForwarding on Windows.
21 October 2013 1.36 LAN Updated chapter First Start.
15 October 2013 1.35 LAN Added webcast links which are indicated by following symbol:
.
Added chapter Bit-shifting an image.
14 October 2013 1.34 LAN User Set Default Selector is deprecated and will be replaced by
User Set Default.
02 October 2013 1.33 LAN Added max current consumption of the digital inputs.
12 September 2013 1.32 GRA
LAN Added note about the need to install the recommended packages when debugging threaded applications.
Corrected dimensional drawing in Dimensions of
mvBlueLYNX-X.
23 July 2013 1.31 LAN Added note about Power over Ethernet (PoE). With the POE
option, the camera is a class 2 compliant PoE device.
19 June 2013 1.30 LAN Added figure in add-on board BLX-IO.
13.06.2013 1.29 LAN Added information about add-on board BLX-IO.
26 April 2013 1.28 GRA Added information about the mvimpact-acquire-dotnet-apps
IPK.
18 April 2013 1.27 LAN Added chapter Using the serial port.
28 March 2013 1.26 LAN Updated use case Creating a debouncing filter at the inputs.
19 February 2013 1.25 LAN Added section MonoDevelop (IDE) for .NET developers.
Added new chapter X11.
MATRIX VISION GmbH 22 April 2016 Version - 1.49 9

GRA Extended section CPU throttling policy.
4 February 2013 1.24 GRA
LAN Added section with List of mvIMPACT Acquire packages. Added protection class and storage temperature to the table
summary of technical data.
29 January 2013 1.23 LAN Added table with summary of technical data.
16 November 2012 1.22 GRA
LAN Updated Nomenclature for PoE -Option. Removed copy & paste note in Trigger.
14 November 2012 1.21 LAN Updated Characteristics of the digital inputs.
Added sensors in Nomenclature.
22 October 2012 1.20 LAN Added CE conformity declaration.
21 September 2012 1.18 GRA /
LAN Added note about network setup dialog box. Added new sensors -X120d, -X102b and -X102d.
6 September 2012 1.17 LAN Clarified view of connectors (top view) in Technical Data.
5 September 2012 1.16 LAN Added new troubleshooting solution "mvBlueLYNX-X boots
but there is no display".
3 September 2012 1.15 LAN Added line number in Circular connector male.
17 August 2012 1.14 LAN Added use case Using the HDR mode with sensor -x02d.
16 August 2012 1.13 LAN Added description about LLA.
18 July 2012 1.12 LAN Added use case Creating a debouncing filter at the inputs.
4 July 2012 1.11 LAN Added Index and Table of Figures.
25 June 2012 1.10 LAN Corrected dimensional drawing in Dimensions of
mvBlueLYNX-X.
8 May 2012 1.9 LAN Added note about µSD card handling section in µSD card slot
(under the small metal plate) and Storing Data On µSD Cards or
USB Devices
20 April 2012 1.8 GRA /
LAN Added new section: Application Desktop Files Added new section: Autostart Applications
Added new section: Linescan mode (-102e)
16 April 2012 1.7 GRA Added new section: Storing Data On µSD Cards or USB Devices
3 April 2012 1.6 GRA Added new section: Debug messages
Added new section: Device or resource busy debug messages
Added new section: Still seeing resource busy debug messages
Added new section: Restarting the camera
21 March 2012 1.5 LAN Rearranged chapter Application Installation and Usage and
added section about wxPropView.
Added chapter Settings behavior during startup.
Added entry in glossary about Overlapped / pipelined transfer.
Added chapter GenICam and Advanced Features.
Added use case Reset timestamp by hardware.
Added use case Acquiring a number of images.
Added use case Controlling external strobe or flash.
Added use case Using the HDR mode with sensor -x00w.
Added use case External trigger by incremental encoder.
Added use case Creating different exposure times for
consecutive images.
Added use case Synchronized acquisitions using timers.
Added use case Generating a pulse width modulation (PWM).
Added use case Outputting a pulse at every other external
mvBlueLYNX-X Technical Manual
10 22 April 2016 Version - 1.49 MATRIX VISION GmbH