Matrix Vision mvBlueLYNX-X Technical 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
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.2 Characteristics of the digital outputs...........................................................................30
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
Table of Contents
8.3.1.1.1 Delay..................................................................................................................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
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: +49-7191-9432-0
Fax: +49-7191-9432-288
Website: http://www.matrix-vision.de
E-Mail
info@matrix-vision.de•
support@matrix-vision.de•
jobs@matrix-vision.de•
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: info@matrix-vision.de
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
mvBlueLYNX-X Technical Manual
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.
4 22 April 2016 Version - 1.49 MATRIX VISION GmbH
mvBlueLYNX-X Technical Manual
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).
MATRIX VISION GmbH 22 April 2016 Version - 1.49 5
mvBlueLYNX-X Technical Manual
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
1.
software. If you use this software in a product, an acknowledgment in the product documentation
would be appreciated but is not required.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the
2.
original software.
This notice may not be removed or altered from any source distribution.3.
Jean-loup Gailly, jloup@gzip.org•
Mark Adler, madler@alumni.caltech.edu•
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.
6 22 April 2016 Version - 1.49 MATRIX VISION GmbH
mvBlueLYNX-X Technical Manual
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
openssl-core@openssl.org.
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
1.
following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
2.
the following disclaimer in the documentation and/or other materials provided with the distribution.
All advertising materials mentioning features or use of this software must display the following
3.
acknowledgment: "This product includes software developed by the OpenSSL Project for use in the
OpenSSL Toolkit. (http://www.openssl.org/)"
The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote
4.
products derived from this software without prior written permission. For written permission, please
contact openssl-core@openssl.org.
Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in
5.
their names without prior written permission of the OpenSSL Project.
Redistributions of any form whatsoever must retain the following acknowledgment: "This product
6.
includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit
(http://www.openssl.org/)"
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 (eay@cryptsoft.com). This product
includes software written by Tim Hudson (tjh@cryptsoft.com).
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.
MATRIX VISION GmbH 22 April 2016 Version - 1.49 7
mvBlueLYNX-X Technical Manual
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
1.
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
Altered source versions must be plainly marked as such, and must not be misrepresented as being the
2.
original software.
This notice may not be removed or altered from any source distribution.3.
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
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
29 November 2013 1.40 LAN Corrected nomenclature concerning module version and added
25 November 2013 1.39 RIN
LAN
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:
14 October 2013 1.34 LAN User Set Default Selector is deprecated and will be replaced by
Corrected info about OpenGL® ES and added glossary term.
Added color code of cable KS-BLX-PWR in Circular connector
male.
(mvBlueLYNX-X without housing) in Technical Data.
order sample.
Information about file .gdbinit for the eclipse gdb debugger
Updated scope of supply.
.
Added chapter Bit-shifting an image.
User Set Default.
02 October 2013 1.33 LAN Added max current consumption of the digital inputs.
12 September 2013 1.32 GRA
LAN
23 July 2013 1.31 LAN Added note about Power over Ethernet (PoE). With the POE
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
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.
MATRIX VISION GmbH 22 April 2016 Version - 1.49 9
Added note about the need to install the recommended packages
when debugging threaded applications.
Corrected dimensional drawing in Dimensions of
mvBlueLYNX-X.
option, the camera is a class 2 compliant PoE device.
IPK.
Added new chapter X11.
mvBlueLYNX-X Technical Manual
GRA Extended section CPU throttling policy.
4 February 2013 1.24 GRA
LAN
29 January 2013 1.23 LAN Added table with summary of technical data.
16 November 2012 1.22 GRA
LAN
14 November 2012 1.21 LAN Updated Characteristics of the digital inputs.
22 October 2012 1.20 LAN Added CE conformity declaration.
21 September 2012 1.18 GRA /
LAN
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
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.
Added section with List of mvIMPACT Acquire packages.
Added protection class and storage temperature to the table
summary of technical data.
Updated Nomenclature for PoE -Option.
Removed copy & paste note in Trigger.
Added sensors in Nomenclature.
Added note about network setup dialog box.
Added new sensors -X120d, -X102b and -X102d.
but there is no display".
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
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
21 March 2012 1.5 LAN Rearranged chapter Application Installation and Usage and
Added new section: Application Desktop Files
Added new section: Autostart Applications
Added new section: Linescan mode (-102e)
Added new section: Device or resource busy debug messages
Added new section: Still seeing resource busy debug messages
Added new section: Restarting the camera
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
10 22 April 2016 Version - 1.49 MATRIX VISION GmbH
mvBlueLYNX-X Technical Manual
trigger.
Added section Building the MATRIX VISION samples without
Eclipse
12 March 2012 1.4 LAN Added frame rate benchmark of sensor -X102e (SXGA 1280 x
1024).
Added description how to handle mvBlueLYNX-X as a
peripheral device.
06 March 2012 1.3 LAN Added note about the short circuit protection of the digital
outputs in Characteristics of the digital outputs
01 March 2012 1.2 GRA Added Installing the LiveDVD. Changed all references of
LiveCD to LiveDVD
28 February 2012 1.1 LAN Added KS-BLX-VGA-USB 05.0 and MicroSD card to the
accessories.
23 February 2012 1.0 LAN Changed manual revision to 1.0
20 February 2012 0.14b GRA Added mvIMPACT SDK Installation on PC/VM
01 February 2012 0.13b LAN Changed mvIMPACT SDK - Virtual Machine to mvIMPACT
SDK - Ubuntu based LiveCD
30 January 2012 0.12b GRA Added proxy information for opkg
27 January 2012 0.11b LAN Now, all Eclipse explanations are in a separate chapter
24 January 2012 0.10b LAN Updated the Virtual Machine description
23 January 2012 0.9b GRA Updated and corrected VGA, digital I/O and network connector
descriptions and pinouts in Technical Data
19 December 2011 0.8b LAN Added mvIMPACT SDK - Virtual Machine description. Added
chapter Use Cases
09 December 2011 0.7b GRA Added Mounting Windows® Shares
03 November 2011 0.6b LAN Added mvIMPACT SDK description
13 October 2011 0.5b LAN Added -X102e sensor data.
06 October 2011 0.4b LAN Added delays of digital input and output.
05 October 2011 0.3b LAN Added MV-X I/O-BOX to the accessories.
26 September 2011 0.2b LAN Updated CMOS sensor data. Added sensor orientation figures.
August 2011 0.1b LAN Initial version.
MATRIX VISION GmbH 22 April 2016 Version - 1.49 11
mvBlueLYNX-X Technical Manual
12 22 April 2016 Version - 1.49 MATRIX VISION GmbH
4 Graphic Symbols
4.1 Notes, Warnings, Attentions
NOTE A NOTE indicates important information that helps you optimize usage of the products.
WARNING A WARNING indicates how to avoid either potential damage to hardware or loss of data.
ATTENTION
All due care and attention has been taken in preparing this manual. In view of our policy of continuous
product improvement, however, we can accept no liability for completeness and correctness of the
information contained in this manual. We make every effort to provide you with a flawless product.
In the context of the applicable statutory regulations, we shall accept no liability for direct damage, indirect
damage or third-party damage resulting from the acquisition or operation of a MATRIX VISION product. Our
liability for intent and gross negligence is unaffected. In any case, the extend of our liability shall be limited to
the purchase price.
An ATTENTION indicates a potential for property damage, personal injury, or
death.
4.2 Webcasts
WEBCAST This icon indicates a webcast about an issue which is available on our website.
MATRIX VISION GmbH 22 April 2016 Version - 1.49 13
mvBlueLYNX-X Technical Manual
14 22 April 2016 Version - 1.49 MATRIX VISION GmbH
5 Important Information
5.1 Important safety instructions
We cannot and do not take any responsibility for the damage caused to you or to any other equipment
•
connected to the mvBlueLYNX-X. Similarly, warranty will be void, if a damage is caused by not
following the manual.
Handle the mvBlueLYNX-X with care. Do not misuse the mvBlueLYNX-X. Avoid shaking, striking,
•
etc. The mvBlueLYNX-X could be damaged by faulty handling or shortage.
Do not use accessories not recommended by the product manufacturer as they may cause hazards.•
The product should be situated away from heat sources such as radiators, heat registers, stoves, or
•
other products (including amplifiers) that produce heat.
5.2 Operating considerations
5.2.1 Important safety notes
Use this camera with a 12V to 24V DC power supply with following specifications: 12V, 2.5A ± 5%
•
or 24V, 1,25A, ± 5%. MATRIX VISION offers a suitable power supply with part # MV-DC1201
BLX IO.
Observe that flammable objects, water or metal do not enter the camera interior. These may lead to
•
failure or accident.
Do not modify the camera or use the camera with external covers removed. These may cause failure,
•
void any warranties and pose a safety hazard.
Stop using the camera at the approach of electrical storm (thunder audible). Protect the camera from
•
rain if using it outdoors.
In event the camera shows any abnormality, switch off the camera and disconnect the power cord.
•
Contact MATRIX VISION.
5.2.2 Handling and cleaning
Do not attempt to disassemble camera.•
When installing or removing a lens, take care that water or dust does not enter the inside of the
•
camera.
5.2.3 Installing
Avoid installing or storing the camera in the following environments:
•
Environments exposed to direct sunlight, rain or snow.♦
Environments where combustible or corrosive gas exists.♦
Excessively warm or cold environment (Operating ambient temperature: 0 to 50 °C)♦
Humid or dusty environment.♦
Place subjected to excessive vibration or shock.♦
Environment exposed to strong electric or magnetic field.♦
It is recommended to mount the camera on a thermoconducting surface such as aluminum or other
•
metals rather than plastic or wood.
Please contact manufacturer or local distributor if you want to use additional enclosures for higher
•
ingress protection.
Do not aim the camera lens at the sun or other very strong light sources.•
CCD phenomenon: Smearing: Vertical smearing may appear in the image. However, this is not a
MATRIX VISION GmbH 22 April 2016 Version - 1.49 15
mvBlueLYNX-X Technical Manual
failure of the camera, but a technical fact of a CCD sensor.
5.2.4 Optimizing performance and life time
If the camera is used continuously for long time under high ambient temperature, the inside electrical parts
may deteriorate, resulting in shorter life span. Additional cooling by e.g. air convection is recommended.
5.2.5 Connectors
Confirm the power is off before connecting or disconnecting a signal cable. Handle connectors by the body,
not by the attached wires.
5.2.6 Cleaning
Use a blower or a lens brush to remove dust on the lens or the optical filter.•
Do not disassemble front flange.•
Clean case with dry soft cloth. Use neutral detergent liquid if needed; wipe the cover with dry cloth.•
Do not use benzene, thinner, alcohol, liquid cleaner or spray-type cleaner.•
If dust or other debris is located between the CCD and optical filter, consult dealer for cleaning by an
•
optical technician.
5.3 European Union Declaration of Conformity statement
The mvBlueLYNX-X is in conformity with all applicable essential requirements necessary for
CE marking. It corresponds to the EU EMC guideline 2014/30/EU based on the following
harmonized standards
Electromagnetic compatibility (EMC)
- Interference emmision EN 61000-6-3 / 2007
- Interference immunity EN 61000-6-2 / 2005
MATRIX VISION corresponds to the EU guideline WEEE 2002/96/EG on waste electrical and
electronic equipment and is registered under WEEE-Reg.-No. DE 25244305.
16 22 April 2016 Version - 1.49 MATRIX VISION GmbH
mvBlueLYNX-X Technical Manual
MATRIX VISION GmbH 22 April 2016 Version - 1.49 17
mvBlueLYNX-X Technical Manual
18 22 April 2016 Version - 1.49 MATRIX VISION GmbH
6 About this Manual
6.1 Goal of the manual
This manual gives you an overview of the mvBlueLYNX-X, MATRIX VISION’s next generation smart
camera family, its technical data and basic operation of the mvBlueLYNX-X. Programming the device is
detailled in a separate documentation, which will be available in an online format.
6.2 Contents of the manual
At the beginning of the manual, you will get an introduction to the possible usages of the smart camera. The
further chapters contain general information about the mvBlueLYNX-X including:
technical data•
sensor data•
filters and lenses•
The general information is followed by the description of the
delivered default configuration and•
how to start with the mvBlueLYNX-X for the first time.•
Afterwards, it describes how to install and use software on the mvBlueLYNX-X followed by a general
description about the software developement kit. A troubleshooting chapter shows how to detect damages and
other inconveniences. Last but not least, a glossary explains abbreviations and technical terms.
MATRIX VISION GmbH 22 April 2016 Version - 1.49 19
mvBlueLYNX-X Technical Manual
20 22 April 2016 Version - 1.49 MATRIX VISION GmbH
Loading...