Matrix Vision mvBlueFOX3 Technical Manual

mvBlueFOX3
Technical Manual
English - Version 1.41
CONTENTS i
Contents
1 About this manual 2
2 Imprint 4
2.6.1 libusbK license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.7.1 Doxygen license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.9.1 Expat Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.10.1 OpenSSL License Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.10.2 OpenSSL License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.12.1 NUnit License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3 Legal notice 10
3.2.1 cJSON license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.3.1 Unity license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
MATRIX VISION GmbH
ii CONTENTS
4 Revisions 12
5 Graphic Symbols 19
6 Important information 20
6.2.1 Important safety notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.2.2 Handling and cleaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6.2.3 Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6.2.4 Optimizing performance and life time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6.2.5 Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6.2.6 Cleaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
6.2.7 Adjusting the C-mount (mvBlueFOX3-2xxx-1xxx) . . . . . . . . . . . . . . . . . . . . . . 22
6.2.8 Adjusting the C-mount (mvBlueFOX3-2xxx-2xxx) . . . . . . . . . . . . . . . . . . . . . . 23
6.4.1 For customers in the U.S.A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.4.2 For customers in Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6.4.3 Pour utilisateurs au Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7 Introduction 30
7.2.1 mvBlueFOX3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.2.2 mvBlueFOX3-M1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
7.2.3 mvBlueFOX3-M2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
7.2.4 Ordering code samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
7.3.1 Accessories for the mvBlueFOX3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
MATRIX VISION GmbH
CONTENTS iii
8 Quickstart 35
8.1.1 NeuroCheck support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
8.1.2 VisionPro support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
8.1.3 HALCON support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
8.1.4 LabVIEW support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
8.1.5 DirectShow support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
8.1.6 Micro-Manager support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
8.2.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
8.2.2 Installing the mvGenTL-Acquire driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
8.2.3 Connecting the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
8.3.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
8.3.2 Installing the mvGenTL-Acquire driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
8.3.3 Connecting the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
8.3.4 Defining udev rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
8.3.5 Optimizing USB performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
9 Technical data 53
9.1.1 Standard model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
9.1.2 Standard model -2xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
9.1.3 Model without housing (-M1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
9.1.4 Model without housing (-M2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
9.2.1 Circular connector male (Power / Digital I/O) . . . . . . . . . . . . . . . . . . . . . . . . . 59
9.2.2 Characteristics of the digital inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
9.2.3 Characteristics of the digital outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
9.3.1 Standard model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
9.3.2 Standard model -2xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
MATRIX VISION GmbH
iv CONTENTS
10 Sensor overview 64
10.3.1 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
10.3.2 Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
11 Filters and Lenses 72
12 Application Usage 74
12.1.1 How to work with wxPropView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
12.1.2 How to configure a device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
12.1.3 Command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
12.2 mvDeviceConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
12.2.1 How to update the firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
12.2.2 Preserving UserSet settings when updating the Firmware . . . . . . . . . . . . . . . . . . 103
12.2.3 How to disable CPU sleep states a.k.a. C states (< Windows 8) . . . . . . . . . . . . . . 103
12.2.4 Command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
MATRIX VISION GmbH
CONTENTS v
13 GenICam and Advanced Features 107
13.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
13.2 Device Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
13.3 Image Format Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
13.4 Acquisition Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
13.5 Counter And Timer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
13.6 Analog Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
13.7 mv Logic Gate Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
13.8 Color Transformation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
13.9 mv Flat Field Correction Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
13.10Event Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
13.11Chunk Data Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
13.12File Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
13.13Digital I/O Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
13.14LUT Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
13.14.1 mvLUTType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
13.14.2 mvLUTInputData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
13.14.3 mvLUTMapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
13.14.4 LUT support in MATRIX VISION cameras . . . . . . . . . . . . . . . . . . . . . . . . . . 121
13.15Sequencer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
13.15.1 Sequencer overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
13.15.2 Configuration of a sequencer set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
13.16Transport Layer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
13.17User Set Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
13.18mv Frame Average Control (only with specific models) . . . . . . . . . . . . . . . . . . . . . . . . 129
13.19mv High Dynanmic Range Control (only with specific sensor models) . . . . . . . . . . . . . . . . 129
14 C developers 130
15 C++ developers 131
16 .NET developers 132
MATRIX VISION GmbH
vi CONTENTS
17 DirectShow Interface 133
17.1 Supported Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.1.1 IAMCameraControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.1.2 IAMDroppedFrames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.1.3 IAMStreamConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.1.4 IAMVideoProcAmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.1.5 IKsPropertySet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.1.6 ISpecifyPropertyPages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.2 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
17.3 Registering and renaming devices for DirectShow usage . . . . . . . . . . . . . . . . . . . . . . . 134
17.3.1 Registering devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
17.3.2 Renaming devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
17.3.3 Make silent registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
18 Troubleshooting 138
18.1 There are Image Error Counts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
18.2 I cannot see the mvBlueFOX3 or I can see it but I cannot use it . . . . . . . . . . . . . . . . . . . 138
18.3 I get an oscillating frame rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
18.4 Accessing log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
18.4.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
18.4.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
18.5 Error code list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
19 Glossary 155
MATRIX VISION GmbH
CONTENTS vii
20 Use cases 162
20.1 GenICam to mvIMPACT Acquire code generator . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
20.1.1 Using the code generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
20.1.2 Using the result of the code generator in an application . . . . . . . . . . . . . . . . . . . 164
20.2 Introducing acquisition / recording possibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
20.2.1 Acquiring a number of images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
20.2.2 Recording sequences in the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
20.2.3 Recording sequences with pre-trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
20.2.4 Creating acquisition sequences (Sequencer Control) . . . . . . . . . . . . . . . . . . . . 169
20.2.5 Working with multiple AOIs (mv Multi Area Mode) . . . . . . . . . . . . . . . . . . . . . . 177
20.2.6 Working with burst mode buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
20.2.7 Using VLC Media Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
20.2.8 Using the linescan mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
20.2.9 Working with Event Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
20.3 Improving the acquisition / image quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
20.3.1 Correcting image errors of a sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
20.3.2 Optimizing the color fidelity of the camera . . . . . . . . . . . . . . . . . . . . . . . . . . 202
20.3.3 Reducing noise by frame averaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
20.3.4 Setting a flicker-free auto expose and auto gain . . . . . . . . . . . . . . . . . . . . . . . 219
20.3.5 Working with binning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
20.3.6 Minimizing sensor pattern of mvBlueFOX3-1100G . . . . . . . . . . . . . . . . . . . . . . 225
20.4 Working with triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
20.4.1 Getting a trigger with an incremental encoder . . . . . . . . . . . . . . . . . . . . . . . . 227
20.4.2 Generating a pulse width modulation (PWM) . . . . . . . . . . . . . . . . . . . . . . . . . 229
20.4.3 Outputting a pulse at every other external trigger . . . . . . . . . . . . . . . . . . . . . . 232
20.4.4 Creating different exposure times for consecutive images . . . . . . . . . . . . . . . . . . 233
20.4.5 Detecting overtriggering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
20.4.6 Triggering of an indefinite sequence with precise starting time . . . . . . . . . . . . . . . . 241
20.5 Working with I/Os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
20.5.1 Controlling strobe or flash at the outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
MATRIX VISION GmbH
viii CONTENTS
20.5.2 Compensating delay of strobe or flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
20.5.3 Creating a debouncing filter at the inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
20.6 Working with HDR (High Dynamic Range Control) . . . . . . . . . . . . . . . . . . . . . . . . . . 248
20.6.1 Adjusting sensor -x02d (-1012d) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
20.6.2 Adjusting sensor -x02e (-1013) / -x04e (-1020) . . . . . . . . . . . . . . . . . . . . . . . . 250
20.6.3 Adjusting sensor -1031C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
20.7 Working with LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
20.7.1 Introducing LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
20.7.2 Working with LUTValueAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
20.7.3 Implementing a hardware-based binarization . . . . . . . . . . . . . . . . . . . . . . . . . 262
20.8 Saving data on the device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
20.8.1 Creating user data entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
20.8.2 Creating user set entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
20.8.3 Working with the UserFile section (Flash memory) . . . . . . . . . . . . . . . . . . . . . . 268
20.9 Working with device features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
20.9.1 Reset timestamp by hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
20.9.2 Synchronizing camera timestamps without IEEE 1588 . . . . . . . . . . . . . . . . . . . . 273
20.9.3 Using the standby mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
20.10Working with several camera simultaneously . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
20.10.1 Creating synchronized acquisitions using timers . . . . . . . . . . . . . . . . . . . . . . . 277
MATRIX VISION GmbH
CONTENTS ix
21 Appendix A.1 Pregius CMOS specific camera / sensor data 282
21.1 mvBlueFOX3-2004 (0.4 Mpix [1456 x 1088]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
21.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
21.1.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
21.1.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
21.1.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
21.2 mvBlueFOX3-2016 (1.6 Mpix [1456 x 1088]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
21.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
21.2.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
21.2.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
21.2.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
21.3 mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
21.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
21.3.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
21.3.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
21.3.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
21.4 mvBlueFOX3-2024a (2.4 Mpix [1936 x 1216]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
21.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
21.4.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
21.4.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
21.4.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
21.5 mvBlueFOX3-2032 (3.2 Mpix [2064 x 1544]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
21.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
21.5.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
21.5.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
21.5.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
21.6 mvBlueFOX3-2032a (3.2 Mpix [2064 x 1544]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
21.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
21.6.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
21.6.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
MATRIX VISION GmbH
x CONTENTS
21.6.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
21.7 mvBlueFOX3-2051 (5.1 Mpix [2464 x 2056]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
21.7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
21.7.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
21.7.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
21.7.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
21.8 mvBlueFOX3-2051a (5.1 Mpix [2464 x 2056]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
21.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
21.8.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
21.8.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
21.8.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
21.9 mvBlueFOX3-2064 (6.4 Mpix [1456 x 1088]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
21.9.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
21.9.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
21.9.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
21.9.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
21.10mvBlueFOX3-2089 (8.9 Mpix [4112 x 2176]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
21.10.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
21.10.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
21.10.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
21.10.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
21.11mvBlueFOX3-2089a (8.9 Mpix [4112 x 2176]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
21.11.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
21.11.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
21.11.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
21.11.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
21.12mvBlueFOX3-2124 (12.4 Mpix [4112 x 3008]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
21.12.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
21.12.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
21.12.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
21.12.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
21.13mvBlueFOX3-2124a (12.4 Mpix [4112 x 3008]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
21.13.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
21.13.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
21.13.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
21.13.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
MATRIX VISION GmbH
CONTENTS 1
22 Appendix A.2 CMOS specific camera / sensor data 331
22.1 mvBlueFOX3-1012b (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
22.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
22.1.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
22.1.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
22.1.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
22.2 mvBlueFOX3-1012d (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
22.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
22.2.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
22.2.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
22.2.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
22.3 mvBlueFOX3-1013 (1.3 Mpix [1280 x 1024]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
22.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
22.3.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
22.3.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
22.3.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
22.4 mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
22.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
22.4.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
22.4.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
22.4.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
22.5 mvBlueFOX3-1020a (1.9 Mpix [1600 x 1200]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
22.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
22.5.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
22.5.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
22.5.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
22.6 mvBlueFOX3-1031 (3.2 Mpix [2048 x 1536]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
22.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
22.6.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
22.6.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
22.6.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
22.7 mvBlueFOX3-1100 (11 Mpix [3856 x 2764]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
22.7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
22.7.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
22.7.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
22.7.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
22.8 mvBlueFOX3-1140 (14 Mpix [4384 x 3288]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
22.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
22.8.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
22.8.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
22.8.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
MATRIX VISION GmbH
2 CONTENTS
1 About this manual
1.1 Goal of the manual
This manual gives you an overview of the mvBlueFOX3, MATRIX VISION's compact USB 3.0 industrial camera family compliant to USB3 Vision, its technical data and basic operation of the mvBlueFOX3. Programming the device is detailed in a separate documentation, which will be available in an online format.
The mvBlueFOX3 manual is based on a modular concept and contains several individual books. That means like in many object-oriented programming languages you have for each functionality your own "class". Instead of classes, you have books. For example, if you want to know anything about the GUI based applications, then you have to go to the Application Usage (p. 74) book. If you want to know how images are acquired with the mvBlueFOX3, have a look in the respective programming language chapter.
1.2 Contents of the manual
At the beginning of the manual, you will get an introduction (p. 30) to the possible usages of the camera. The further chapters contain general information about the mvBlueFOX3 including:
• how to install the mvBlueFOX3 for the first time (p. 35) followed by
Technical data (p. 53)
Sensor overview (p.64)
Filters and Lenses (p.72)
The general information is followed by the description of the
software tools for mvBlueFOX3 (p.74) including the tools
– wxPropView (p.74)
– mvDeviceConfigure (p.100)
GenICam and Advanced Features (p. 107) introduces the GenICam and the Advanced features of the mv←- BlueFOX3 (The mvBlueFOX3 is a GenICam / USB3 Vision compliant camera).
DirectShow developers (p. 133) documents MATRIX VISION's DirectShow_acquire interface.
Use cases (p. 162) describes solutions for general tasks and
Troubleshooting (p. 138) shows how to detect damages and other inconveniences.
• A Glossary (p. 155) explains abbreviations and technical terms.
Appendix A.1 Pregius CMOS specific camera / sensor data (p. 282) contains all data of the Pregius CMOS sensors like timings, details of operation, etc.
Appendix A.2 CMOS specific camera / sensor data (p. 331) contains all data of the other CMOS sensors like timings, details of operation, etc.
MATRIX VISION GmbH
1.2 Contents of the manual 3
Note
For C, C++, .NET developers, there are separate mvIMPACT Acquire manuals
"mvIMPACT_Acquire_API_CPP_manual.chm",
"mvIMPACT_Acquire_API_C_manual.chm", and
"mvIMPACT_Acquire_API_NET_manual.chm"
available as downloads from our website https://www.matrix-vision.com. The manuals contain chapter about
• how to link and build applications using mvIMPACT Acquire,
• how the log output for "mvIMPACT Acquire" devices is configured and how it works in general,
• how to create your own installer packages for Windows and Linux, and
• the general mvIMPACT Acquire API documentation.
MATRIX VISION GmbH
4 CONTENTS
2 Imprint
MATRIX VISION GmbH Talstrasse 16 DE - 71570 Oppenweiler
Telephone: +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
Author
U. Lansche H. Mattfeldt S. Battmer U. Hagmaier D. Neuholz
Date
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, as­sumes 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.
Copyright
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.
MATRIX VISION GmbH
2.1 Introduction 5
2.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.
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.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 GenICam
At least one driver package shipped under the product family name mvIMPACT Acquire makes use of the GenI←- Cam (p. 155) 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 (p. 155) reference implementation are
shipped with the libraries belonging to the GenICam (p. 155) runtime.
2.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).
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.
MATRIX VISION GmbH
6 CONTENTS
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)
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 fol­lowing 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.
MATRIX VISION GmbH
2.8 SHA1 algorithm 7
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).
2.9 Expat
Expat is used to parse XML strings within the SDK.
2.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.
2.10 OpenSSL
OpenSSL is used to perform license authentification.
2.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
openssl-core@openssl.org.
MATRIX VISION GmbH
8 CONTENTS
2.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:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the fol­lowing disclaimer in the documentation and/or other materials provided with the distribution.
3. 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 Open←- SSL Toolkit. (http://www.openssl.org/)"
4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote prod­ucts derived from this software without prior written permission. For written permission, please contact
openssl-core@openssl.org.
5. 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.
6. 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/)"
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 in­cludes software written by Tim Hudson (tjh@cryptsoft.com).
2.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.
2.12 NUnit
The .NET code is tested using the NUnit (http://www.nunit.org/) framework.
MATRIX VISION GmbH
2.12 NUnit 9
2.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:
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original soft­ware. If you use this software in a product, an acknowledgment (see the following) in the product documenta­tion 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
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
MATRIX VISION GmbH
10 CONTENTS
3 Legal notice
3.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.
3.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.
3.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.
3.3 Unity
A slightly modified version of Unity (https://github.com/ThrowTheSwitch/Unity) is used for unit test­ing various modules that eventually build up the firmware.
3.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.
MATRIX VISION GmbH
3.3 Unity 11
The end-user documentation included with the redistribution, if 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.
MATRIX VISION GmbH
12 CONTENTS
4 Revisions
Date Rev. Author Description Driver / Firmware version
04. July 2017 V1.41 LAN Added mvBC_subsection_←- standard_tech_dimensions_←- wo2_s .
13. June 2017 V1.40 LAN Updated Order code nomen- clatures (p. 31) of mvBlueFO←- X3-M2.
29. May 2017 V1.39 LAN Added sensors mvBlueFOX3-
2004 (0.4 Mpix [1456 x 1088])
(p. 282)
mvBlueFOX3-2016 (1.6 Mpix [1456 x 1088]) (p. 285) mvBlueFOX3-2064 (6.4 Mpix [1456 x 1088]) (p. 311) .
15. May 2017 V1.38 LAN Updated use case Work­ing with burst mode buffer
(p. 181).
03. May 2017 V1.37 LAN Added use case Working with binning (p. 223).
20. March 2017 V1.36 LAN Updated frame rates of E2V sensors. Added description of the wizard in Working with multiple AOIs (mv Multi Area Mode) (p. 177).
14. February 2017 V1.35 LAN Added Working with multiple
AOIs (mv Multi Area Mode)
(p. 177) .
Firmware: 2.18.651.0
13. February 2017 V1.34 LAN Added Implementing a
hardware-based binariza­tion (p. 262) .
24. January 2017 V1.33 LAN Added Error code list (p.143).
21. December 2016 V1.32 LAN Updated Setting up multiple
display support and/or work with several capture settings in parallel (p. 89).
Firmware: 2.16.587.0
15. December 2016 V1.31 LAN Added Micro-Manger in Driver concept (p. 35).
Firmware: 2.15.578.0
17. November 2016 V1.29 LAN Added information about the cooling area of mvBlueFOX3-←- M2xxx-1111.
26. October 2016 V1.28 LAN Updated sensor characteristics.
23. August 2016 V1.27 LAN Extended use case Using the standby mode (p.275) . Added Adjusting sensor
-1031C (p. 252).
Firmware: 2.12.406.0
04. August 2016 V1.26 LAN Added sensor IMX267: mv←-
BlueFOX3-2124a (12.4 Mpix [4112 x 3008]) (p. 326) . Added sensor IMX304: mv←- BlueFOX3-2089a (8.9 Mpix [4112 x 2176]) (p. 318).
Firmware:
01. August 2016 V1.25 LAN Added Triggered frame burst
mode (p. 183).
MATRIX VISION GmbH
4 Revisions 13
24. June 2016 V1.24 LAN Updated use case Creating acquisition sequences (Se­quencer Control) (p.169).
Firmware:
21. June 2016 V1.23 LAN Added use case Triggering of
an indefinite sequence with precise starting time (p. 241).
Firmware:
17. June 2016 V1.22 LAN Added sensor IMX264: mv←-
BlueFOX3-2051a (5.1 Mpix [2464 x 2056]) (p. 307) . Added use case Synchronizing camera timestamps without IEEE 1588 (p. 273).
Firmware:
12. May 2016 V1.21 LAN Added sensor IMX255: mv←-
BlueFOX3-2089 (8.9 Mpix [4112 x 2176]) (p. 315) . Added warning in Adjusting the C-mount (mvBlueFOX3­2xxx-1xxx) (p. 22).
Firmware:
21. April 2016 V1.20 LAN Added sensor IMX253: mv←-
BlueFOX3-2124 (12.4 Mpix [4112 x 3008]) (p. 322).
Firmware: 2.8.241.0
21. January 2016 V1.19 LAN Added sensor IMX265: mv←-
BlueFOX3-2032a (3.2 Mpix [2064 x 1544]) (p. 299).
Firmware: 2.6.180.0
02. December 2015 V1.18 LAN Updated CE declarations (p. 23).
30. November 2015 V1.17 LAN Added Minimizing sensor pat-
tern of mvBlueFOX3-1100G
(p. 225).
Firmware: 2.3.70.0
12. November 2015 V1.16 LAN Added mvBlueFOX3-M2 infor- mation (p. 58).
09. November 2015 V1.15 LAN Added sensor IMX252: mv←-
BlueFOX3-2032 (3.2 Mpix [2064 x 1544]) (p. 296).
27. October 2015 V1.14 LAN Added Command-line options (p. 99).
22. October 2015 V1.13 LAN Added sensor IMX250: mv←-
BlueFOX3-2051 (5.1 Mpix [2464 x 2056]) (p. 303).
21. September 2015 V1.12 LAN Added power led states of Stan­dard model -2xxx (p.63).
07. September 2015 V1.11 LAN Changed sensor size of 10 Mpixels resolution CMOS sen­sor (-x100) (p. 67) from 1/2.35"
to 1/2.3".
11. August 2015 V1.10 LAN Added image "Input switching times" in Electrical character- istics (p. 60).
04. August 2015 V1.09 LAN Added Windows 10 support.
31. July 2015 V1.08 LAN Added dimensional drawing of mvBlueFOX3-IO NC (p. 56). Added USB performance im­provements For Odroid-U2 / -←-
U3 Users (p.47) and For Rasp­berry Pi Users (p. 47).
MATRIX VISION GmbH
14 CONTENTS
28. July 2015 V1.07 LAN Added Adjusting the C-mount (mvBlueFOX3-2xxx-1xxx)
(p. 22).
24. July 2015 V1.06 LAN Removed resistor in Connect- ing the hardware (p. 277) in Figure 1. Updated chapter Hardware (p. 38) concerning extension cards and adapters.
21. July 2015 V1.05 LAN Corrected image in Mounting holes (p. 53).
09. July 2015 V1.04 LAN Added Adjusting the C-mount
(mvBlueFOX3-2xxx-2xxx)
(p. 23).
07. July 2015 V1.03 LAN Added dimensional drawings of lensholder options in Standard model -2xxx (p. 54).
23. June 2015 V1.02 LAN Added bottom view of -2xxx model: Option -2xxx (lensh-
older with back focus adjust­ment) (p. 55). Added NVIDIA Tegra TK1 in­stallation notes (p. 48).
23. June 2015 V1.01 LAN Added use case Working with Event Control (p.192).
Driver: 2.13.1; Firmware: 1.6.←-
414.0
19. June 2015 V1.00 LAN Restructured chapter Use cases (p. 162). Added use case Detecting overtriggering (p. 236).
17. June 2015 V0.60b LAN Updated Circular connector
male (Power / Digital I/O)
(p. 59).
15. June 2015 V0.59b LAN Added Creating acquisition
sequences (Sequencer Con­trol) (p.169).
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])
(p. 292).
Firmware: 1.6.393.0
21. May 2015 V0.57b LAN Updated pixel clock of mv←-
BlueFOX3-2024 (2.4 Mpix [1936 x 1216]) (p. 289).
12. May 2015 V0.56b LAN Updated Order code nomen­clatures (p.31).
17. April 2015 V0.55b LAN Adapted the sensor resolution of
mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216]) (p. 289).
Firmware: 1.6.366.0
16. April 2015 V0.54b LAN Updated supported Windows versions.
31. March 2015 V0.53b LAN Added line scan frame rate calculator for the sensors mv←-
BlueFOX3-1020 (1.9 Mpix [1600 x 1200]) (p. 339) and mvBlueFOX3-1020a (1.9 Mpix [1600 x 1200]) (p. 342).
MATRIX VISION GmbH
4 Revisions 15
25. March 2015 V0.52b LAN Upgraded frame rate calcula­tor of mvBlueFOX3-2024 (2.←- 4 Mpix [1936 x 1216]) (p. 289).
11. March 2015 V0.51b LAN Added chapter Accessing log files (p. 92).
05. March 2015 V0.50b LAN Added -2xx Standard model - 2xxx (p. 54).
03. March 2015 V0.49b LAN Added sensor mvBlueFOX3-
1020a (1.9 Mpix [1600 x 1200])
(p. 342) . Corrected max. frame rate of
mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200]) (p. 339).
25. February 2015 V0.48b LAN Added chapter For Odroid-X←- U3 Users (p. 46) in "Optimizing
USB performance".
09. February 2015 V0.47b LAN Updated pixel clock of mv←-
BlueFOX3-2024 (2.4 Mpix [1936 x 1216]) (p. 289) .
02. February 2015 V0.46b LAN Added Pinning of KS-BCX-H←- R12 (p. 59).
Driver: 2.11.9; Firmware: 1.6.←-
295.0
27. January 2015 V0.46b LAN Updated exposure times in Models (p. 67) and added sensor mvBlueFOX3-2024
(2.4 Mpix [1936 x 1216]) (p. 289) . Renewed Order code nomenclatures (p.31).
14. January 2015 V0.45b LAN Updated Order code nomen­clatures (p.31).
13. January 2015 V0.44b LAN Corrected use case Creating synchronized acquisitions using timers (p.277)
Added additional I/O board for mvBlueFOX3-M to Acces-
sories for the mvBlueFOX3
(p. 34).
11. December 2014 V0.43b LAN Corrected pixel clock value of sensor mvBlueFOX3-1012b (1.2 Mpix [1280 x 960]) (p. 331) (66 MHz).
07. December 2014 V0.42b LAN Added use case Adjusting sen-
sor -x02e (-1013) / -x04e (-
1020) (p. 250).
02. December 2014 V0.40b LAN Added Quick Setup Wizard (p. 74).
Driver: 2.11.3; Firmware: 1.6.←-
230.0.
21. October 2014 V0.39b LAN Added figure about how the ad-
ditional I/O board for mv←- BlueFOX3-M (p. 56) is con-
nected correctly. Added description about the record mode in How to see the first image (p.79).
16. October 2014 V0.38b LAN Added dimensional drawing of
additional I/O board for mv←- BlueFOX3-M (p. 56).
MATRIX VISION GmbH
16 CONTENTS
26. September 2014 V0.37b LAN Restructured sensor informa­tion.
23. August 2014 V0.36b LAN Removed ext. power supply in Components (p. 63).
21. August 2014 V0.35b LAN Added use case Using the standby mode (p.275).
18. August 2014 V0.34b LAN Updated Sensor overview (p. 64).
17. July 2014 V0.33b LAN Added use case Introducing LUTs (p. 255).
09. July 2014 V0.32b LAN Added cable color scheme in Circular connector male (Power / Digital I/O) (p. 59).
04. July 2014 V0.31b LAN Board-level model is called mvBlueFOX3-M now.
11. June 2014 V0.30b LAN Added daylight cut filter (p. 72).
05. June 2014 V0.29b LAN Update chapter Using the linescan mode (p. 187).
02. June 2014 V0.28b LAN Removed global reset release mode from mvBlueFOX3-1031
(3.2 Mpix [2048 x 1536])
(p. 345).
27. May 2014 V0.27b LAN Added use case Reducing
noise by frame averaging
(p. 216).
13. May 2014 V0.26b LAN Corrected images in Charac-
teristics of the digital inputs (p. 60) and Characteristics of the digital outputs (p. 61).
09. May 2014 V0.25b LAN Added Model without housing (-M1) (p. 56).
21. Mar. 2014 V0.24b LAN Changed sensor MT9M021 to MT9M031: mvBlueFOX3-
1012b (1.2 Mpix [1280 x 960])
(p. 331).
14. Mar. 2014 V0.23b LAN Added Windows 8 and 8.1 as supported operating systems in Quickstart (p. 35).
10. Mar. 2014 V0.22b LAN mvDeviceConfigure (p.100) extended.
25 Feb. 2014 V0.21b LAN Corrected Ordering code sam-
ples (p. 33).
12 Feb. 2014 V0.20b LAN Updated trigger modes of the
sensors.
07 Feb. 2014 V0.19b LAN Added description of sensor
mvBlueFOX3-1031 (3.2 Mpix [2048 x 1536]) (p. 345).
31 Jan. 2014 V0.18b LAN Changed position of chapter "←-
First Start" and renamed it to Quickstart (p. 35).
MATRIX VISION GmbH
4 Revisions 17
17 Jan. 2014 V0.17b LAN Added note about max. ex-
posure time (global reset re­lease mode) in mvBlueFO←-
X3-1100 (11 Mpix [3856 x 2764]) (p. 347) and mvBlue←- FOX3-1140 (14 Mpix [4384 x 3288]) (p. 351).
20 Dec. 2013 V0.16b LAN Added Sample 1: Triggered
linescan acquisition with ex­posure time of 250 us (p. 189).
9 Dec. 2013 V0.15b LAN Update description of firmware
update (p. 100).
6 Dec. 2013 V0.14b LAN Added information about sup-
ported USB 3.0 adpaters
(p. 38). Added information about
Changing the view of the property grid to assist writing code that shall locate driver features (p. 91).
2 Dec. 2013 V0.13b LAN Manual is now HTML based.
Added sensor mvBlueFOX3-
1020 (1.9 Mpix [1600 x 1200])
(p. 339).
15 Oct. 2013 V0.12b LAN Added Webcasts (p.19) links.
Added chapter Bit-shifting an image (p. 90).
14 Oct. 2013 V0.11b LAN User Set Default Selector
(p. 98) is deprecated and will be replaced by "User Set Default".
07 Oct. 2013 V0.10b LAN Removed links to mvBlueLYNX-
X in chapter Use cases (p. 162).
02 Oct. 2013 V0.9b LAN Added max current consumption
of the Characteristics of the digital inputs (p. 60).
19 Sep. 2013 V0.8b LAN Added Image data flow (p.64).
06 Aug. 2013 V0.7b LAN Added troubleshooting
chapter: I cannot see the
mvBlueFOX3 or I can see it but I cannot use it (p.138). Added information about Status / Power LED (p. 62).
27 May 2013 V0.6b LAN Updated mvBlueFOX3-1100
(11 Mpix [3856 x 2764]) (p.347) and mvBlueFOX3-1140 (14 Mpix [4384 x 3288]) (p. 351).
15 May 2013 V0.5b LAN Added mvBlueFOX3-1140 (14
Mpix [4384 x 3288]) (p. 351).
13 May 2013 V0.4b LAN Added tripod adapter drawing in
Dimensions (p. 53).
18. Apr. 2013 V0.3b LAN Added chapter Supported im-
age formats (p.71).
MATRIX VISION GmbH
18 CONTENTS
28 Mar. 2013 V0.2b LAN Updated chapters Quickstart
(p. 35), Application Usage (p. 74), GenICam and Ad-
vanced Features (p.107), and Use cases (p. 162).
March 2013 V0.1b LAN Initial version
MATRIX VISION GmbH
5.2 Webcasts 19
5 Graphic Symbols
5.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
An attention indicates a potential for property damage, personal injury, or death.
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.
5.2 Webcasts
This icon indicates a webcast about an issue which is available on our website.
MATRIX VISION GmbH
Loading...
+ 335 hidden pages