Balluff MATRIX VISION mvBlueFOX Series User manual

mvBlueFOX
Technical Manual
English - Version 3.02

i
1.1 About this manual ............................................ 1
1.1.1 Goal of the manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1.2 Contents of the manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 Imprint .................................................. 2
1.3 Legal notice ............................................... 3
1.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3.2 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3.3 wxWidgets ............................................ 3
1.3.4 Sarissa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3.5 GenICam ............................................ 3
1.3.6 libusb .............................................. 3
1.3.7 libusbK .............................................. 4
1.3.7.1 libusbK license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3.8 Doxygen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3.8.1 Doxygen license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3.9 SHA1 algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.10 Expat .............................................. 5
1.3.10.1 Expat Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.11 CppUnit ............................................ 5
1.3.12 NUnit .............................................. 5
1.3.12.1 NUnit License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.13 cJSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.3.14 Unity .............................................. 6
1.4 Revisions ................................................ 7
1.5 Symbols and Conventions ........................................ 8
1.5.1 Explanation of the warnings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.6 Important Information .......................................... 9
1.6.1 High-Speed USB design guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.6.2 European Union Declaration of Conformity statement . . . . . . . . . . . . . . . . . . . . . 10
1.6.3 Legal notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.6.3.1 For customers in the U.S.A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.6.3.2 For customers in Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.6.3.3 Pour utilisateurs au Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.7 Introduction ............................................... 14
1.7.1 Order code nomenclature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.7.1.1 mvBlueFOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.7.1.2 mvBlueFOX-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.7.1.3 mvBlueFOX-IGC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.7.1.4 mvBlueFOX-MLC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.7.2 What's inside and accessories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.8 Quickstart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.8.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
MATRIX VISION GmbH

ii
1.8.1.1 Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.8.2 Installing the mvIMPACT Acquire driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
1.8.2.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
1.8.2.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
1.8.3 Connecting The Camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
1.8.4 Driver concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
1.8.4.1 NeuroCheck Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
1.8.4.2 VisionPro Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
1.8.4.3 HALCON Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
1.8.4.4 LabVIEW Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.8.4.5 DirectShow Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.8.4.6 Micro-Manager Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.8.5 Relationship between driver, firmware and FPGA file . . . . . . . . . . . . . . . . . . . . . . 28
1.8.5.1 FPGA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.8.5.2 Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
1.8.6 Settings behaviour during startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
1.8.7 Optimizing USB Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
1.8.7.1 Checklist for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
1.8.7.2 Checklist for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
1.8.8 Using mvBlueFOX cameras In A Docker Container . . . . . . . . . . . . . . . . . . . . . . . 35
1.8.8.1 Host Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
1.8.8.2 Building A Docker Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
1.8.8.3 Starting The Docker Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.8.8.4 Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.9 Technical Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.9.1 Power supply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.9.2 Standard version (mvBlueFOX-xxx) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.9.2.1 Dimensions and connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.9.2.2 LED states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.9.2.3 Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.9.3 Board-level version (mvBlueFOX-Mxxx) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
1.9.3.1 Dimensions and connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
1.9.3.2 LED states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
1.9.3.3 Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
1.9.3.4 Accessories mvBlueFOX-Mxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
1.9.4 Single-board version (mvBlueFOX-MLC2xx) . . . . . . . . . . . . . . . . . . . . . . . . . . 51
1.9.4.1 Typical Power consumption @ 5V . . . . . . . . . . . . . . . . . . . . . . . . . . 51
1.9.4.2 Dimensions and connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
1.9.4.3 LED states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
1.9.4.4 Assembly variants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
1.9.5 Single-board version with housing (mvBlueFOX-IGC2xx) . . . . . . . . . . . . . . . . . . . . 58
1.9.5.1 Dimensions and connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
MATRIX VISION GmbH

iii
1.9.5.2 LED states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
1.9.5.3 Positioning tolerances of sensor chip . . . . . . . . . . . . . . . . . . . . . . . . . 60
1.10 Sensor Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
1.10.1 CCD sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
1.10.2 CMOS sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
1.10.3 Output sequence of color sensors (RGB Bayer) . . . . . . . . . . . . . . . . . . . . . . . . 65
1.10.4 Bilinear interpolation of color sensors (RGB Bayer) . . . . . . . . . . . . . . . . . . . . . . 65
1.11 Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
1.11.1 Hot mirror filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
1.11.2 Cold mirror filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
1.11.3 Glass filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
1.12 GUI tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
1.12.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
1.12.2 wxPropView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
1.12.3 mvDeviceConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
1.12.4 mvIPConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
1.12.5 mvGigEConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
1.13 HRTC - Hardware Real-Time Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
1.13.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
1.13.1.1 Operating codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
1.13.2 How to use the HRTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
1.14 Developing applications using the mvIMPACT Acquire SDK . . . . . . . . . . . . . . . . . . . . . . 72
1.15 DirectShow interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
1.15.1 Supported interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
1.15.1.1 C++ example code using the IKsPropertySet interface . . . . . . . . . . . . . . . 73
1.15.2 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
1.15.3 Setting up devices for DirectShow usage . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
1.15.3.1 Registering devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
1.15.3.2 Renaming devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
1.15.3.3 Using regsvr32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
1.16 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
1.16.1 Accessing log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
1.16.1.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
1.16.1.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
1.17 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
1.18 Use Cases ............................................... 91
1.18.1 Introducing acquisition / recording possibilities . . . . . . . . . . . . . . . . . . . . . . . . 92
1.18.1.1 Generating very long exposure times . . . . . . . . . . . . . . . . . . . . . . . . 92
1.18.1.2 Using Video Stream Recording . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
1.18.2 Improving the acquisition / image quality . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
1.18.2.1 Correcting image errors of a sensor . . . . . . . . . . . . . . . . . . . . . . . . . 104
1.18.2.2 Optimizing the color/luminance fidelity of the camera . . . . . . . . . . . . . . . . 113
MATRIX VISION GmbH

iv
1.18.2.3 Working With Gain And Black-Level Values Per Color Channel . . . . . . . . . . . 122
1.18.3 Saving data on the device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
1.18.3.1 Creating user data entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
1.18.4 Working with several cameras simultaneously . . . . . . . . . . . . . . . . . . . . . . . . . 132
1.18.4.1 Using 2 mvBlueFOX-MLC cameras in Master-Slave mode . . . . . . . . . . . . . 132
1.18.4.2 Synchronize the cameras to expose at the same time . . . . . . . . . . . . . . . 137
1.18.5 Working with HDR (High Dynamic Range Control) . . . . . . . . . . . . . . . . . . . . . . 138
1.18.5.1 Adjusting sensor of camera models -x00w . . . . . . . . . . . . . . . . . . . . . 138
1.18.5.2 Adjusting sensor of camera models -x02d (-1012d) . . . . . . . . . . . . . . . . . 141
1.18.6 Working with I2C devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
1.18.6.1 Working with the I2C interface (I2C Control) . . . . . . . . . . . . . . . . . . . . 145
1.18.6.2 Using mvBlueFOX-MLC with motorized lenses (MotorFocusControl) . . . . . . . . 148
1.18.7 Working with LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
1.18.7.1 Introducing LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
1.18.8 Working with triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
1.18.8.1 Using external trigger with CMOS sensors . . . . . . . . . . . . . . . . . . . . . 160
1.18.9 Working with 3rd party tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
1.18.9.1 Using VLC Media Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
1.18.10 Working with the Hardware Real-Time Controller (HRTC) . . . . . . . . . . . . . . . . . . 164
1.18.10.1 Achieve a defined image frequency (HRTC) . . . . . . . . . . . . . . . . . . . . 164
1.18.10.2 Delay the external trigger signal (HRTC) . . . . . . . . . . . . . . . . . . . . . . 166
1.18.10.3 Creating double acquisitions (HRTC) . . . . . . . . . . . . . . . . . . . . . . . 167
1.18.10.4 Take two images after one external trigger (HRTC) . . . . . . . . . . . . . . . . 167
1.18.10.5 Take two images with different expose times after an external trigger (HRTC) . . 168
1.18.10.6 Edge controlled triggering (HRTC) . . . . . . . . . . . . . . . . . . . . . . . . . 170
1.18.10.7 Delay the expose start of the following camera (HRTC) . . . . . . . . . . . . . . 171
1.19 Appendix A. Specific Camera / Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
1.19.1 A.1 CCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
1.19.1.1 mvBlueFOX-[Model]220 (0.3 Mpix [640 x 480]) . . . . . . . . . . . . . . . . . . . 173
1.19.1.2 mvBlueFOX-[Model]220a (0.3 Mpix [640 x 480]) . . . . . . . . . . . . . . . . . . 178
1.19.1.3 mvBlueFOX-[Model]221 (0.8 Mpix [1024 x 768]) . . . . . . . . . . . . . . . . . . 183
1.19.1.4 mvBlueFOX-[Model]223 (1.4 Mpix [1360 x 1024]) . . . . . . . . . . . . . . . . . . 187
1.19.1.5 mvBlueFOX-[Model]224 (1.9 Mpix [1600 x 1200]) . . . . . . . . . . . . . . . . . . 192
1.19.2 A.2 CMOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
1.19.2.1 mvBlueFOX-[Model]200w (0.4 Mpix [752 x 480]) . . . . . . . . . . . . . . . . . . 198
1.19.2.2 mvBlueFOX-[Model]202a (1.3 Mpix [1280 x 1024]) . . . . . . . . . . . . . . . . . 201
1.19.2.3 mvBlueFOX-[Model]202v (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . 204
1.19.2.4 mvBlueFOX-[Model]202b (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . 208
1.19.2.5 mvBlueFOX-[Model]202d (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . 211
1.19.2.6 mvBlueFOX-[Model]205 (5.0 Mpix [2592 x 1944]) . . . . . . . . . . . . . . . . . . 215
1.20 Appendix B. Product Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
1.21 Appendix C. Tested ARM platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
MATRIX VISION GmbH

v
1.21.1 C.1 ARM64 based devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
1.21.1.1 NVIDIA Jetson AGX Xavier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
1.21.1.2 NVIDIA Jetson Xavier NX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
1.21.1.3 NVIDIA Jetson Nano . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
1.21.1.4 NVIDIA Jetson TX2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
1.21.1.5 i.MX8M Mini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
1.21.2 C.2 ARMhf based devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
1.21.2.1 Raspberry Pi 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
MATRIX VISION GmbH

1.1 About this manual 1
1.1 About this manual
1.1.1 Goal of the manual
This manual gives you an overview of the mvBlueFOX, MATRIX VISION's compact USB2 industrial camera fam-
ily, its technical data and basic operation of the mvBlueFOX. Programming the device is detailed in a separate
documentation, which will be available in an online format.
1.1.2 Contents of the manual
At the beginning of the manual, you will get an introduction (p. 14) to the possible usages of the camera. The
following chapters contain general information about the camera including:
•Quickstart (p. 19) followed by
•Technical Data (p. 38)
•Sensor Overview (p. 61)
•Filters (p. 66)
The general information is followed by the description of the
•Software tools for the camera (p. 68) including the tools
•HRTC - Hardware Real-Time Controller (p. 70) shows how to use the FPGA built-in functionality called
Hardware Real-Time Controller (short: HRTC).
•Developing applications using the mvIMPACT Acquire SDK (p. 72)
•DirectShow developers (p. 73) documents MATRIX VISION's mvIMPACT Acquire to DirectShow interface( -
DirectShow_acquire).
•Troubleshooting (p. 80) shows how to detect damages and other inconveniences.
•Use Cases (p. 91) describes solutions for general tasks and
• A Glossary (p. 81) explains abbreviations and technical terms.
•Appendix A. Specific Camera / Sensor Data (p. 173) contains all data of the sensors like timings, details of
operation, etc.
– A.1 CCD (p. 173) contains all data of the CCD sensors like timings, details of operation, etc.
– A.2 CMOS (p. 197) contains all data of the other CMOS sensors like timings, details of operation, etc.
Appendix C. Tested ARM platforms (p. 219) contains a list of ARM platforms tested with this product and informa-
tion on how to setup these systems for achieving optimal results
MATRIX VISION GmbH

2
1.2 Imprint
MATRIX VISION GmbH
Talstrasse 16
DE - 71570 Oppenweiler
Telephone: [phone]
Fax: [phone]
Website: https://www.matrix-vision.de
E-Mail:
•[email protected]
•[email protected]
Author
U. Lansche
Date
2020
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® Vista, Windows® 7, 8, 10, 11 are trademarks of Microsoft, Corp.
• Linux® is a trademark of Linus Torvalds.
• Jetson is a registered trademark of NVIDIA Corporation.
• NVIDIA and Jetson are trademarks and/or registered trademarks of NVIDIA Corporation in the U.S. and other
countries.
• Arm and Cortex are registered trademarks of Arm Limited (or its subsidiaries) in the US and/or elsewhere.
All other product and company names in this document may be the trademarks and tradenames of their
respective owners and are hereby acknowledged.
MATRIX VISION GmbH

1.3 Legal notice 3
1.3 Legal notice
1.3.1 Introduction
The firmware running on MATRIX VISION 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:
1.3.2 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.3.3 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.4 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.3.5 GenICam
At least one driver package shipped under the product family name mvIMPACT Acquire makes use of the Gen -
ICam (p. 82) 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. 82) reference implementation are
shipped with the libraries belonging to the GenICam (p. 82) runtime.
1.3.6 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).
MATRIX VISION GmbH

4
1.3.7 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.3.7.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.
1.3.8 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.3.8.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

1.3 Legal notice 5
1.3.9 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.3.10 Expat
Expat is used to parse XML strings within the SDK.
1.3.10.1 Expat Copyright
Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1.3.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.3.12 NUnit
The .NET code is tested using the NUnit ( http://www.nunit.org/) framework.
1.3.12.1 NUnit License
Copyright © 2002-2014, 2018 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 documen-
tation is required. Portions Copyright © 2002-2014, 2018 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

6
1.3.13 cJSON
A slightly modified version of cJSON is used inside some of the modules that eventually build up the firmware.
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.
1.3.14 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.
MATRIX VISION GmbH

1.4 Revisions 7
1.4 Revisions
Date Rev. Author Description Driver / Firmware version
06. December 2022 V3.02 LAN Updated main page .
22. August 2022 V3.01 LAN Removed "L" option of the digital I/Os
(mvBlueFOX-MLC (p. 17)) .
03. May 2021 V3.00 LAN Corrected Symbols and Conventions
(p. 8).
03. February 2021 V2.01 LAN Added mvBlueFOX-[Model]202v (1. -
2 Mpix [1280 x 960]) (p. 204).
13. January 2021 V2.00 LAN Seperated GUI tools (p. 68).
MATRIX VISION GmbH

8
1.5 Symbols and Conventions
Note
This symbol indicates general notes.
1.5.1 Explanation of the warnings
Always observe the warnings in these instructions and the measures described to avoid hazards. The warnings
used here contain various signal words and are structured as follows:
Attention
SIGNAL WORD
"Type and source of the hazard"
Consequences if not complied with
→Measures to avoid hazards.
The individual signal words mean:
Attention
Indicates a danger that can lead to damage or destruction of the product.
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.
MATRIX VISION GmbH

1.6 Important Information 9
1.6 Important Information
We cannot and do not take any responsibility for the damage caused to you or to any other equipment
connected to the mvBlueFOX. Similarly, warranty will be void, if a damage is caused by not following
the manual.
Handle the mvBlueFOX with care. Do not misuse the mvBlueFOX. Avoid shaking, striking, etc. The
mvBlueFOX could be damaged by faulty handling or shortage.
Use a soft cloth lightly moistened with a mild detergent solution when cleaning the camera.
Never face the camera towards the sun. Whether the camera is in use or not, never aim at the sun or
other extremely bright objects. Otherwise, blooming or smear may be caused.
Please keep the camera closed or mount a lens on it to avoid the CCD or the CMOS from getting
dusty.
Clean the CCD/CMOS faceplate with care. Do not clean the CCD or the CMOS with strong or abrasive
detergents. Use lens tissue or a cotton tipped applicator and ethanol.
Never connect two USB cables to the mvBlueFOX even if one is only connected to a PC.
The mvBlueFOX is bus powered <2.5 W.
The mvBlueFOX meets IP40 standards.
Using the single-board or board-level versions:
• Handle with care and avoid damage of electrical components by electrostatic discharge (ESD):
–Discharge body static (contact a grounded surface and maintain contact).
–Avoid all plastic, vinyl, and styrofoam (except antistatic versions) around printed circuit
boards.
–Do not touch components on the printed circuit board with your hands or with conductive
devices.
MATRIX VISION GmbH

10
1.6.1 High-Speed USB design guidelines
If you want to make own High-Speed (HS) USB cables, please pay attention to following design guidelines:
• Route High-Speed (HS) USB signals with a minimum number of vias and sharp edges!
• Avoid stubs!
• Do not cut off power planes VCC or GND under the signal line.
• Do not route signals no closer than 20 ∗h to the copper layer edge if possible (h means height over the
copper layer).
• Route signal lines with 90 Ohm +- 15% differential impedance.
–7.5 mil printed circuit board track with 7.5 mil distance result in approx. 90 Ohm @ 110 um height over
GND plane.
–There are other rules when using double-ply printed circuit boards.
• Be sure that there is 20 mil minimum distance between High-Speed USB signal pair and other printed circuit
board tracks (optimal signal quality).
1.6.2 European Union Declaration of Conformity statement
The mvBlueFOX complies with the provision of the following European Directives:
• 2014/30/EU (EMC directive)
• 2014/35/EU (LVD - low voltage directive)
• For EN 61000-6-3:2007, mvBlueFOX-IGC with digital I/O needs the Steward snap-on ferrite
28A0350-0B2 on I/O cable.
• For EN 61000-6-3:2007, mvBlueFOX-MLC with digital I/O needs the Würth Elektronik snap-on
ferrite WE74271142 on I/O cable and copper foil on USB.
MATRIX VISION corresponds to the EU guideline WEEE 2002/96/EG on waste electrical and elec-
tronic equipment and is registered under WEEE-Reg.-No. DE 25244305.
MATRIX VISION GmbH

1.6 Important Information 11
MATRIX VISION GmbH

12
MATRIX VISION GmbH