Matrix mvBlueFOX3 User manual

ProductFeatures

Table of Contents
1 Imprint..............................................................................................................................................1
1.1 Introduction.......................................................................................................................2
1.2 wxWidgets.........................................................................................................................2
1.3 Sarissa..............................................................................................................................2
1.4 GenICam...........................................................................................................................2
1.5 libusb.................................................................................................................................2
1.6 libusbK..............................................................................................................................2
1.6.1 libusbK license.........................................................................................................3
1.7 Doxygen............................................................................................................................3
1.7.1 Doxygen license.......................................................................................................3
1.8 SHA1 algorithm.................................................................................................................4
1.9 Expat.................................................................................................................................4
1.9.1 Expat Copyright........................................................................................................4
1.10 OpenSSL........................................................................................................................4
1.10.1 OpenSSL License Issues.......................................................................................4
1.10.2 OpenSSL License..................................................................................................4
1.11 CppUnit...........................................................................................................................5
1.12 NUnit...............................................................................................................................5
1.12.1 NUnit License.........................................................................................................5
2 Legal notice.....................................................................................................................................7
2.1 Introduction.......................................................................................................................7
2.2 cJSON...............................................................................................................................7
2.2.1 cJSON license..........................................................................................................7
2.3 Unity..................................................................................................................................7
2.3.1 Unity license.............................................................................................................7
3 Revisions.........................................................................................................................................9
4 Graphic Symbols..........................................................................................................................15
4.1 Notes, Warnings, Attentions...........................................................................................15
4.2 Webcasts........................................................................................................................15
5 Important information..................................................................................................................17
5.1 Important safety instructions...........................................................................................17
5.2 Operating considerations................................................................................................17
5.2.1 Important safety notes............................................................................................17
5.2.2 Handling and cleaning............................................................................................18
5.2.3 Installing.................................................................................................................18
5.2.4 Optimizing performance and life time.....................................................................18
5.2.5 Connectors.............................................................................................................18
5.2.6 Cleaning.................................................................................................................18
5.2.7 Adjusting the C-mount (mvBlueFOX3-2xxx-1xxx)..................................................18
5.2.8 Adjusting the C-mount (mvBlueFOX3-2xxx-2xxx)..................................................19
5.3 European Union Declaration of Conformity statement....................................................20
5.4 Legal notice.....................................................................................................................26
5.4.1 For customers in the U.S.A....................................................................................26
5.4.2 For customers in Canada.......................................................................................26
5.4.3 Pour utilisateurs au Canada...................................................................................26
6 Introduction...................................................................................................................................27
6.1 Software concept............................................................................................................27
6.2 Order code nomenclature...............................................................................................28
6.2.1 Ordering code samples..........................................................................................30
i

Table of Contents
6 Introduction
6.3 What's inside and accessories........................................................................................31
6.3.1 Accessories for the mvBlueFOX3..........................................................................31
7 Quickstart......................................................................................................................................33
7.1 Driver concept.................................................................................................................33
7.1.1 LabVIEW support...................................................................................................35
7.2 Windows.........................................................................................................................35
7.2.1 System requirements.............................................................................................35
7.2.2 Installing the mvGenTL-Acquire driver...................................................................35
7.2.3 Connecting the camera..........................................................................................38
7.3 Linux...............................................................................................................................39
7.3.1 System requirements.............................................................................................39
7.3.2 Installing the mvGenTL-Acquire driver...................................................................40
7.3.3 Connecting the camera..........................................................................................41
7.3.4 Defining udev rules................................................................................................41
7.3.5 Optimizing USB performance.................................................................................42
7.4 Relationship between driver, firmware, FPGA file and user settings..............................45
7.5 Settings behaviour during startup...................................................................................48
8 Technical data...............................................................................................................................51
8.1 Dimensions.....................................................................................................................51
8.1.1 Standard model......................................................................................................51
8.1.2 Standard model -2xxx............................................................................................52
8.1.3 Model without housing (-M1)..................................................................................54
8.1.4 Model without housing (-M2)..................................................................................55
8.2 Camera interfaces...........................................................................................................56
8.2.1 Circular connector male (Power / Digital I/O).........................................................56
8.2.2 Characteristics of the digital inputs........................................................................58
8.2.3 Characteristics of the digital outputs......................................................................59
8.3 Status / Power LED.........................................................................................................59
8.3.1 Standard model......................................................................................................59
8.3.2 Standard model -2xxx............................................................................................60
8.4 Components....................................................................................................................60
9 Sensor overview...........................................................................................................................61
9.1 Image data flow...............................................................................................................61
9.2 Output sequence of color sensors (RGB Bayer).............................................................61
9.3 CMOS sensors................................................................................................................62
9.3.1 Details of operation................................................................................................62
9.3.2 Models....................................................................................................................64
9.4 Supported image formats................................................................................................65
10 Filters and Lenses......................................................................................................................67
10.1 Hot mirror filter..............................................................................................................67
10.2 Cold mirror filter............................................................................................................67
10.3 Glass filter.....................................................................................................................68
10.4 Lenses..........................................................................................................................68
11 GUI...............................................................................................................................................69
11.1 wxPropView..................................................................................................................69
11.1.1 How to work with wxPropView.............................................................................69
11.1.2 How to configure a device....................................................................................86
11.2 mvDeviceConfigure.......................................................................................................93
ii

Table of Contents
11 GUI 11.2.1 How to update the firmware.................................................................................93
11.2.2 Preserving UserSet settings when updating the Firmware..................................97
11.2.3 How to disable CPU sleep states a.k.a. C states (Windows)...............................98
12 GenICam and Advanced Features..........................................................................................101
12.1 Introduction.................................................................................................................101
12.2 Device Control............................................................................................................102
12.3 Image Format Control.................................................................................................102
12.4 Acquisition Control......................................................................................................103
12.5 Counter And Timer Control.........................................................................................106
12.6 Analog Control............................................................................................................107
12.7 mv Logic Gate Control................................................................................................108
12.8 Color Transformation Control......................................................................................109
12.9 mv Flat Field Correction Control.................................................................................110
12.10 Event Control............................................................................................................110
12.11 Chunk Data Control..................................................................................................111
12.12 File Access Control...................................................................................................112
12.13 Digital I/O Control......................................................................................................113
12.14 LUT Control...............................................................................................................114
12.14.1 mvLUTType......................................................................................................114
12.14.2 mvLUTInputData..............................................................................................115
12.14.3 mvLUTMapping................................................................................................115
12.14.4 LUT support in MATRIX VISION cameras.......................................................115
12.15 Sequencer Control....................................................................................................119
12.16 Transport Layer Control............................................................................................120
12.17 User Set Control.......................................................................................................122
12.18 mv Frame Average Control (only with specific models)............................................122
12.19 mv High Dynanmic Range Control (only with specific sensor models).....................123
13 C developers.............................................................................................................................125
14 C++ developers.........................................................................................................................127
15 .NET developers........................................................................................................................129
16 DirectShow Interface................................................................................................................131
16.1 Supported Interfaces...................................................................................................131
16.1.1 IAMCameraControl............................................................................................131
16.1.2 IAMDroppedFrames...........................................................................................131
16.1.3 IAMStreamConfig...............................................................................................131
16.1.4 IAMVideoProcAmp.............................................................................................131
16.1.5 IKsPropertySet...................................................................................................131
16.1.6 ISpecifyPropertyPages.......................................................................................131
16.2 Logging.......................................................................................................................131
16.3 Registering and renaming devices for DirectShow usage..........................................131
16.3.1 Registering devices............................................................................................132
16.3.2 Renaming devices..............................................................................................134
16.3.3 Make silent registration......................................................................................135
17 Troubleshooting.......................................................................................................................137
17.1 There are Image Error Counts....................................................................................137
17.2 I cannot see the mvBlueFOX3 or I can see it but I cannot use it................................137
17.3 I get an oscillating frame rate......................................................................................143
iii

Table of Contents
17 Troubleshooting
17.4 Accessing log files......................................................................................................143
17.4.1 Windows.............................................................................................................144
17.4.2 Linux..................................................................................................................144
18 Use cases..................................................................................................................................145
18.1 GenICam to mvIMPACT Acquire code generator.......................................................145
18.1.1 Using the code generator...................................................................................145
18.1.2 Using the result of the code generator in an application....................................148
18.2 Introducing acquisition / recording possibilities...........................................................149
18.2.1 Acquiring a number of images...........................................................................150
18.2.2 Recording sequences in the camera..................................................................151
18.2.3 Recording sequences with pretrigger.................................................................152
18.2.4 Working with burst mode buffer.........................................................................154
18.2.5 Using VLC Media Player....................................................................................158
18.2.6 Using the linescan mode....................................................................................161
18.2.7 Working with Event Control................................................................................166
18.3 Improving the acquisition / image quality....................................................................168
18.3.1 Correcting image errors of a sensor...................................................................168
18.3.2 Optimizing the color fidelity of the camera.........................................................176
18.3.3 Reducing noise by frame averaging...................................................................193
18.3.4 Setting a flicker-free auto expose and auto gain................................................197
18.3.5 Minimizing sensor pattern of mvBlueFOX3-1100G............................................202
18.4 Working with triggers..................................................................................................205
18.4.1 Getting a trigger with an incremental encoder...................................................205
18.4.2 Generating a pulse width modulation (PWM).....................................................207
18.4.3 Outputting a pulse at every other external trigger..............................................210
18.4.4 Creating different exposure times for consecutive images................................212
18.4.5 Detecting overtriggering.....................................................................................217
18.4.6 Triggering of an indefinite sequence with precise starting time.........................222
18.5 Working with I/Os........................................................................................................225
18.5.1 Controlling strobe or flash at the outputs...........................................................225
18.5.2 Compensating delay of strobe or flash...............................................................226
18.5.3 Creating a debouncing filter at the inputs...........................................................228
18.6 Working with HDR (High Dynamic Range Control).....................................................230
18.7 Working with LUTs......................................................................................................231
18.8 Saving data on the device...........................................................................................231
18.8.1 Creating user data entries..................................................................................231
18.8.2 Creating user set entries....................................................................................233
18.8.3 Working with the UserFile section (Flash memory)............................................235
18.9 Working with device features......................................................................................238
18.9.1 Reset timestamp by hardware...........................................................................238
18.9.2 Synchronizing camera timestamps without IEEE 1588......................................240
18.9.3 Using the standby mode....................................................................................242
18.10 Working with several camera simultaneously...........................................................245
18.10.1 Creating synchronized acquisitions using timers.............................................245
19 Glossary....................................................................................................................................251
20 Appendix A.1 Pregius CMOS specific camera / sensor data................................................257
20.1 mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216])..............................................................257
20.1.1 Introduction........................................................................................................257
20.1.2 Spectral Sensitivity.............................................................................................257
20.1.3 Timings...............................................................................................................258
iv

Table of Contents
20 Appendix A.1 Pregius CMOS specific camera / sensor data
20.1.4 Device Feature And Property List......................................................................261
20.2 mvBlueFOX3-2024a (2.4 Mpix [1936 x 1216])............................................................357
20.2.1 Introduction........................................................................................................357
20.2.2 Spectral Sensitivity.............................................................................................357
20.2.3 Timings...............................................................................................................358
20.2.4 Device Feature And Property List......................................................................361
20.3 mvBlueFOX3-2032 (3.2 Mpix [2064 x 1544])..............................................................456
20.3.1 Introduction........................................................................................................456
20.3.2 Spectral Sensitivity.............................................................................................457
20.3.3 Timings...............................................................................................................458
20.3.4 Device Feature And Property List......................................................................460
20.4 mvBlueFOX3-2032a (3.2 Mpix [2064 x 1544])............................................................556
20.4.1 Introduction........................................................................................................556
20.4.2 Spectral Sensitivity.............................................................................................557
20.4.3 Timings...............................................................................................................558
20.4.4 Device Feature And Property List......................................................................560
20.5 mvBlueFOX3-2051 (5.1 Mpix [2464 x 2056])..............................................................654
20.5.1 Introduction........................................................................................................654
20.5.2 Spectral Sensitivity.............................................................................................655
20.5.3 Timings...............................................................................................................656
20.5.4 Device Feature And Property List......................................................................658
20.6 mvBlueFOX3-2051a (5.1 Mpix [2464 x 2056])............................................................754
20.6.1 Introduction........................................................................................................755
20.6.2 Spectral Sensitivity.............................................................................................755
20.6.3 Timings...............................................................................................................756
20.6.4 Device Feature And Property List......................................................................758
20.7 mvBlueFOX3-2089 (8.9 Mpix [4112 x 2176])..............................................................852
20.7.1 Introduction........................................................................................................853
20.7.2 Spectral Sensitivity.............................................................................................853
20.7.3 Timings...............................................................................................................854
20.7.4 Device Feature And Property List......................................................................856
20.8 mvBlueFOX3-2089a (8.9 Mpix [4112 x 2176])............................................................952
20.8.1 Introduction........................................................................................................952
20.8.2 Spectral Sensitivity.............................................................................................953
20.8.3 Timings...............................................................................................................953
20.8.4 Device Feature And Property List......................................................................956
20.9 mvBlueFOX3-2124 (12.4 Mpix [4112 x 3008])..........................................................1049
20.9.1 Introduction......................................................................................................1049
20.9.2 Spectral Sensitivity...........................................................................................1049
20.9.3 Timings.............................................................................................................1050
20.9.4 Device Feature And Property List....................................................................1053
20.10 mvBlueFOX3-2124a (12.4 Mpix [4112 x 3008])......................................................1149
20.10.1 Introduction....................................................................................................1149
20.10.2 Spectral Sensitivity.........................................................................................1149
20.10.3 Timings...........................................................................................................1150
20.10.4 Device Feature And Property List..................................................................1153
21 Appendix A.2 CMOS specific camera / sensor data............................................................1247
21.1 mvBlueFOX3-1012b (1.2 Mpix [1280 x 960])............................................................1247
21.1.1 Introduction......................................................................................................1247
21.1.2 Spectral Sensitivity...........................................................................................1247
21.1.3 Timings.............................................................................................................1248
21.1.4 Device Feature And Property List....................................................................1250
v

Table of Contents
21 Appendix A.2 CMOS specific camera / sensor data
21.2 mvBlueFOX3-1012d (1.2 Mpix [1280 x 960])............................................................1342
21.2.1 Introduction......................................................................................................1342
21.2.2 Spectral Sensitivity...........................................................................................1343
21.2.3 Timings.............................................................................................................1344
21.2.4 Device Feature And Property List....................................................................1345
21.3 mvBlueFOX3-1013 (1.3 Mpix [1280 x 1024])............................................................1438
21.3.1 Introduction......................................................................................................1438
21.3.2 Spectral Sensitivity...........................................................................................1439
21.3.3 Timings.............................................................................................................1439
21.3.4 Device Feature And Property List....................................................................1441
21.4 mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200])............................................................1575
21.4.1 Introduction......................................................................................................1575
21.4.2 Spectral Sensitivity...........................................................................................1576
21.4.3 Timings.............................................................................................................1576
21.4.4 Device Feature And Property List....................................................................1578
21.5 mvBlueFOX3-1020a (1.9 Mpix [1600 x 1200])..........................................................1670
21.5.1 Introduction......................................................................................................1670
21.5.2 Spectral Sensitivity...........................................................................................1670
21.5.3 Timings.............................................................................................................1671
21.5.4 Device Feature And Property List....................................................................1673
21.6 mvBlueFOX3-1031 (3.2 Mpix [2048 x 1536])............................................................1763
21.6.1 Introduction......................................................................................................1763
21.6.2 Spectral Sensitivity...........................................................................................1764
21.6.3 Timings.............................................................................................................1765
21.6.4 Device Feature And Property List....................................................................1766
21.7 mvBlueFOX3-1100 (11 Mpix [3856 x 2764]).............................................................1815
21.7.1 Introduction......................................................................................................1815
21.7.2 Spectral Sensitivity...........................................................................................1817
21.7.3 Timings.............................................................................................................1818
21.7.4 Device Feature And Property List....................................................................1819
21.8 mvBlueFOX3-1140 (14 Mpix [4384 x 3288]).............................................................1914
21.8.1 Introduction......................................................................................................1914
21.8.2 Spectral Sensitivity...........................................................................................1916
21.8.3 Timings.............................................................................................................1917
21.8.4 Device Feature And Property List....................................................................1918
22 Appendix B. Linux commands..............................................................................................1965
22.1 List of the most important shell commands...............................................................1965
vi

1 Imprint
MATRIX VISION GmbH
Talstrasse 16
DE - 71570 Oppenweiler
Telephone: [phone]
Fax: [phone]
Website: http://www.matrix-vision.de
E-Mail:
[email protected]
[email protected]
[email protected]
Author:
U. Lansche
H. Mattfeldt
S. Battmer
U. Hagmaier
D. Neuholz
Date: 2013
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.
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.•
GenICam™ is a trademark of the GenICam™ standard group.• GigE Vision™ and the distinctive logo are trademarks owned by the Automated Imaging
Association and may only be used under license for compliant products registered with the
AIA.
•
1

1.1 Introduction
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 whose code helped in the creation of the mvIMPACT Acquire SDK.
1.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.
1.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.
1.4 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.
1.5 libusb
The Linux version of the 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 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 others/libusb).
1.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.
1 Imprint
2

1.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)
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.
1.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.
1.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.
1 Imprint
3

1.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).
1.9 Expat
Expat is used to parse XML strings within the SDK.
1.9.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.
1.10 OpenSSL
OpenSSL is used to perform license authentification.
1.10.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].
1.10.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.
1 Imprint
4

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]).
1.11 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.
1.12 NUnit
The .NET code is tested using the NUnit (http://www.nunit.org/) framework.
1.12.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.
1 Imprint
5

This notice may not be removed or altered from any source distribution.3.
1 Imprint
6

2 Legal notice
2.1 Introduction
The firmware running on mvBlueCOUGAR-X,mvBlueCOUGAR-XD and mvBlueFOX3 devices
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 whose code helped in the creation of
this software.
2.2 cJSON
A slightly modified version of cJSON (http://sourceforge.net/projects/cjson/) is used inside some of
the modules that eventually build up the firmware.
2.2.1 cJSON license
Copyright (c) 2009 Dave Gamble
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.
2.3 Unity
A slightly modified version of Unity (https://github.com/ThrowTheSwitch/Unity) is used for unit
testing various modules that eventually build up the firmware.
2.3.1 Unity license
Copyright (c) 2007-2010 Mike Karlesky, Mark VanderVoord, Greg Williams
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 end-user documentation included with the redistribution, if
7

any, must include the following acknowledgment: "This product
includes software developed for the Unity Project, by Mike Karlesky,
Mark VanderVoord, and Greg Williams and other contributors", in
the same place and form as other third-party acknowledgments.
Alternately, this acknowledgment may appear in the software
itself, in the same form and location as other such third-party
acknowledgments.
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.
2 Legal notice
8

3 Revisions
Date Rev. Author Description Driver / Firmware version
23. August
2016 V1.27 LAN
Extended use case Using the standby
mode .
Added
UseCases_section_HDR_1031C .
Firmware: 2.12.406.0
04. August
2016 V1.26 LAN
Added sensor IMX267:
mvBlueFOX3-2124a (12.4 Mpix [4112
x 3008]) .
Added sensor IMX304:
mvBlueFOX3-2089a (8.9 Mpix [4112 x
2176]) .
Firmware:
1. August
2016 V1.25 LAN Added Triggered frame burst mode .
24. June
2016 V1.24 LAN Updated use case UseCases_section_Sequencer_Mode . Firmware:
21. June
2016 V1.23 LAN Added use case Triggering of an
indefinite sequence with precise
starting time . Firmware:
17. June
2016 V1.22 LAN
Added sensor IMX264:
mvBlueFOX3-2051a (5.1 Mpix [2464 x
2056]) .
Added use case Synchronizing camera
timestamps without IEEE 1588 .
Firmware:
12. May
2016 V1.21 LAN
Added sensor IMX255:
mvBlueFOX3-2089 (8.9 Mpix [4112 x
2176]) .
Added warning in Adjusting the
C-mount (mvBlueFOX3-2xxx-1xxx) .
Firmware:
21. April
2016 V1.20 LAN Added sensor IMX253:
mvBlueFOX3-2124 (12.4 Mpix [4112 x
3008]) . Firmware: 2.8.241.0
21. January
2016 V1.19 LAN Added sensor IMX265:
mvBlueFOX3-2032a (3.2 Mpix [2064 x
1544]) . Firmware: 2.6.180.0
02.
December
2015 V1.18 LAN Updated CE declarations.
30.
November
2015 V1.17 LAN Added Minimizing sensor pattern of
mvBlueFOX3-1100G.Firmware: 2.3.70.0
12.
November
2015 V1.16 LAN Added mvBlueFOX3-M2 information .
9

09.
November
2015 V1.15 LAN Added sensor IMX252:
mvBlueFOX3-2032 (3.2 Mpix [2064 x
1544]) .
27. October
2015 V1.14 LAN Added Starting wxPropView via command line.
22. October
2015 V1.13 LAN Added sensor IMX250:
mvBlueFOX3-2051 (5.1 Mpix [2464 x
2056]) .
21.
September
2015 V1.12 LAN Added power led states of Standard
model-2 .
07.
September
2015 V1.11 LAN Changed sensor size of 10 Mpixels
resolution CMOS sensor (-x100) from
1/2.35\" to 1/2.3\".
11. August
2015 V1.10 LAN Added image "Input switching times" in Electrical characteristics.
04. August
2015 V1.09 LAN Added Windows 10 support.
31. July
2015 V1.08 LAN
Added dimensional drawing of
mvBlueFOX3-IO NC.
Added USB performance
improvements For Odroid-U2 / -U3
Users and For Raspberry Pi Users.
28. July
2015 V1.07 LAN Added Adjusting the C-mount (mvBlueFOX3-2xxx-1xxx).
24. July
2015 V1.06 LAN
Removed resistor in Connecting the
hardware in Figure 1.
Updated chapter Hardware concerning
extension cards and adapters.
21. July
2015 V1.05 LAN Corrected image in Mounting holes.
09. July
2015 V1.04 LAN Added Adjusting the C-mount (mvBlueFOX3-2xxx-2xxx).
07. July
2015 V1.03 LAN Added dimensional drawings of
lensholder options in Standard
model-2.
23. June
2015 V1.02 LAN
Added bottom view of -2xxx model:
Standard model-2-2xxx.
Added NVIDIA Tegra TK1 installation
notes.
23. June
2015 V1.01 LAN Added use case Working with Event Control.Driver: 2.13.1; Firmware: 1.6.414.0
19. June
2015 V1.00 LAN Restructured chapter Use cases.
Added use case Detecting
overtriggering.
3 Revisions
10

17. June
2015 V0.60b LAN Updated Circular connector male (Power / Digital I/O).
15. June
2015 V0.59b LAN Added UseCases_section_Sequencer_Mode. Driver: 2.12.5; Firmware: 1.6.403.0
11. June
2015 V0.58b LAN Added sensor mvBlueFOX3-2024a (2.4 Mpix [1936 x 1216]).Firmware: 1.6.393.0
21. May
2015 V0.57b LAN Updated pixel clock of
mvBlueFOX3-2024 (2.4 Mpix [1936 x
1216]).
12. May
2015 V0.56b LAN Updated Order code nomenclature.
17. April
2015 V0.55b LAN Adapted the sensor resolution of
mvBlueFOX3-2024 (2.4 Mpix [1936 x
1216]).Firmware: 1.6.366.0
16. April
2015 V0.54b LAN Updated supported Windows versions.
31. March
2015 V0.53b LAN
Added linescan frame rate calculator
for the sensors mvBlueFOX3-1020 (1.9
Mpix [1600 x 1200]) and
mvBlueFOX3-1020a (1.9 Mpix [1600 x
1200]).
25. March
2015 V0.52b LAN Upgraded frame rate calculator of
mvBlueFOX3-2024 (2.4 Mpix [1936 x
1216]).
11. March
2015 V0.51b LAN Added chapter Accessing log files.
05. March
2015 V0.50b LAN Added -2xx Standard model-2 .
03. March
2015 V0.49b LAN
Added sensor mvBlueFOX3-1020a
(1.9 Mpix [1600 x 1200]) .
Corrected max. frame rate of
mvBlueFOX3-1020 (1.9 Mpix [1600 x
1200]) .
25.
February
2015 V0.48b LAN Added chapter For Odroid-XU3 Users
in "Optimizing USB performance" .
09.
February
2015 V0.47b LAN Updated pixel clock of
mvBlueFOX3-2024 (2.4 Mpix [1936 x
1216]) .
02.
February
2015 V0.46b LAN Added Pinning of KS-BCX-HR12 . Driver: 2.11.9; Firmware:
1.6.295.0
27. January
2015 V0.46b LAN Updated exposure times in Models and added sensor mvBlueFOX3-2024 (2.4
Mpix [1936 x 1216]) . Renewed Order
3 Revisions
11

code nomenclature .
14. January
2015 V0.45b LAN Updated Order code nomenclature .
13. January
2015 V0.44b LAN
Corrected use case Creating
synchronized acquisitions using timers
Added additional I/O board for
mvBlueFOX3-M to Accessories for the
mvBlueFOX3 .
11.
December
2014 V0.43b LAN Corrected pixel clock value of sensor
mvBlueFOX3-1012b (1.2 Mpix [1280 x
960]) (66 MHz).
07.
December
2014 V0.42b LAN Added use case
UseCases_section_HDR_x04e.
05.
December
2014 V0.41b LAN Corrected values of Frame rate
calculator (area mode).
02.
December
2014 V0.40b LAN Added Quick Setup Wizard.Driver: 2.11.3; Firmware:
1.6.230.0 .
21. October
2014 V0.39b LAN
Added figure about how the additional
I/O board for mvBlueFOX3-M is
connected correctly.
Added description about the record
mode in How to see the first image.
16. October
2014 V0.38b LAN Added dimensional drawing of
additional I/O board for
mvBlueFOX3-M.
26.
September
2014 V0.37b LAN Restructured sensor information.
23. August
2014 V0.36b LAN Removed ext. power supply in Components.
21. August
2014 V0.35b LAN Added use case Using the standby mode.
18. August
2014 V0.34b LAN Updated Sensor overview.
17. July
2014 V0.33b LAN Added use case UseCases_section_WorkingLUT.
09. July
2014 V0.32b LAN Added cable color scheme in Circular connector male (Power / Digital I/O).
04. July
2014 V0.31b LAN Board-level model is called mvBlueFOX3-M now.
11. June
2014 V0.30b LAN Added daylight cut filter.
3 Revisions
12