Mvbluefox3 Technical Manual (Pdf)
Total Page:16
File Type:pdf, Size:1020Kb
mvBlueFOX3 Technical Manual English - Version 3.04 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.2.1 Introduction ........................................... 3 1.2.2 wxWidgets............................................ 3 1.2.3 Sarissa ............................................. 3 1.2.4 GenICam ............................................ 3 1.2.5 libusb .............................................. 3 1.2.6 libusbK.............................................. 3 1.2.6.1 libusbK license .................................... 3 1.2.7 Doxygen............................................. 4 1.2.7.1 Doxygen license ................................... 4 1.2.8 SHA1 algorithm......................................... 4 1.2.9 Expat .............................................. 5 1.2.9.1 Expat Copyright.................................... 5 1.2.10 CppUnit ............................................ 5 1.2.11 NUnit.............................................. 5 1.2.11.1 NUnit License.................................... 5 1.3 Legal notice............................................... 6 1.3.1 Introduction ........................................... 6 1.3.2 cJSON.............................................. 6 1.3.3 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 Important Safety Instructions.................................. 9 1.6.2 Operating considerations.................................... 9 1.6.2.1 Important Safety Notes................................ 9 1.6.2.2 Handling And Cleaning................................ 10 1.6.2.3 Installing ....................................... 10 1.6.2.4 Optimizing performance and life time......................... 11 1.6.2.5 Connectors...................................... 11 1.6.2.6 Cleaning ....................................... 11 1.6.3 Additional notices........................................ 21 1.6.3.1 For customers in the U.S.A............................... 21 1.6.3.2 For customers in Canada............................... 21 1.6.3.3 Pour utilisateurs au Canada ............................. 21 1.7 Introduction ............................................... 22 1.7.1 Software concept ........................................ 23 1.7.2 Order code nomenclatures ................................... 24 MATRIX VISION GmbH ii 1.7.2.1 mvBlueFOX3-1.................................... 24 1.7.2.2 mvBlueFOX3-M1................................... 25 1.7.2.3 mvBlueFOX3-2.................................... 26 1.7.2.4 mvBlueFOX3-M2................................... 28 1.7.2.5 mvBlueFOX3-3M................................... 30 1.7.2.6 mvBlueFOX3-4.................................... 31 1.7.2.7 mvBlueFOX3-5M................................... 32 1.7.2.8 Ordering code samples................................ 33 1.7.3 What's inside and accessories ................................. 34 1.7.3.1 Accessories for the mvBlueFOX3........................... 35 1.8 Quickstart................................................ 37 1.8.1 System Requirements...................................... 37 1.8.1.1 Host System ..................................... 37 1.8.1.2 Supported Operating Systems............................ 37 1.8.2 Installing The mvGenTL-Acquire Package ........................... 38 1.8.2.1 Windows ....................................... 39 1.8.2.2 Linux ......................................... 42 1.8.3 Connecting The Camera .................................... 45 1.8.3.1 Communicating With The Camera.......................... 45 1.8.3.2 Setting Up The Camera................................ 45 1.8.3.3 About Settings .................................... 46 1.8.4 Driver concept.......................................... 48 1.8.4.1 NeuroCheck Support................................. 49 1.8.4.2 VisionPro Support .................................. 50 1.8.4.3 HALCON Support................................... 50 1.8.4.4 LabVIEW Support................................... 50 1.8.4.5 DirectShow Support ................................. 50 1.8.4.6 Micro-Manager Support................................ 50 1.8.5 Relationship Between Driver, Firmware And SDK ....................... 51 1.8.6 Optimizing USB Performance.................................. 54 1.8.6.1 Checklist for Windows ................................ 54 1.8.6.2 Checklist for Linux .................................. 54 1.8.7 Using USB3 Vision™ Devices In A Docker Container ..................... 56 1.8.7.1 Host Preparation ................................... 57 1.8.7.2 Building A Docker Image............................... 57 1.8.7.3 Starting The Docker Container............................ 58 1.8.7.4 Validation....................................... 59 1.9 Technical Data.............................................. 59 1.9.1 Dimensions ........................................... 59 1.9.1.1 Standard model (mvBlueFOX3-1) .......................... 59 1.9.1.2 Standard model (mvBlueFOX3-2) .......................... 60 1.9.1.3 Model without housing (mvBlueFOX3-M1)...................... 62 MATRIX VISION GmbH iii 1.9.1.4 Model without housing (mvBlueFOX3-M2)...................... 64 1.9.1.5 Single-board Model for Embedded Vision (mvBlueFOX3-3M)............ 67 1.9.1.6 Hi-res model (mvBlueFOX3-4)............................ 67 1.9.1.7 Board-level Model for Embedded Vision (mvBlueFOX3-5M)............. 68 1.9.2 Camera interfaces (mvBlueFOX3-1,mvBlueFOX3-2,mvBlueFOX3-M1,mvBlueFOX3-M2,mv - BlueFOX3-4) ......................................... 69 1.9.2.1 Circular connector male (Power / Digital I/O)..................... 69 1.9.2.2 Characteristics of the digital inputs.......................... 70 1.9.2.3 Characteristics of the digital outputs ......................... 71 1.9.3 Status / Power LED....................................... 72 1.9.3.1 Standard model (mvBlueFOX3-1) .......................... 72 1.9.3.2 Standard model (mvBlueFOX3-2) .......................... 73 1.9.4 BFembedded interface (mvBlueFOX3-3M,mvBlueFOX3-5M).................. 73 1.9.4.1 Pin assignment.................................... 74 1.9.4.2 Boards for the BFembedded interface (mvBlueFOX3-3M,mvBlueFOX3-5M) . 76 1.9.5 Components........................................... 82 1.10 Sensor Overview............................................ 84 1.10.1 Image data flow ........................................ 84 1.10.2 Output sequence of color sensors (RGB Bayer)........................ 84 1.10.3 Bilinear interpolation of color sensors (RGB Bayer)...................... 85 1.10.4 CMOS sensors......................................... 85 1.10.4.1 Details of operation ................................. 85 1.10.4.2 Models........................................ 87 1.10.5 Supported image formats ................................... 96 1.11 Filters and lenses ........................................... 96 1.11.1 Hot Mirror Filter ........................................ 96 1.11.2 Cold mirror filter ........................................ 98 1.11.3 Glass filter........................................... 99 1.11.4 Lenses............................................. 99 1.12 GUI tools................................................ 100 1.12.1 Introduction .......................................... 100 1.12.2 wxPropView .......................................... 100 1.12.3 mvDeviceConfigure ...................................... 100 1.13 GenICam and advanced features ................................... 101 1.13.1 Introduction .......................................... 101 1.13.2 Device Control......................................... 102 1.13.3 Image Format Control..................................... 103 1.13.4 Acquisition Control....................................... 104 1.13.5 Counter And Timer Control .................................. 108 1.13.6 Analog Control......................................... 110 1.13.7 Color Transformation Control ................................. 112 1.13.8 Event Control.......................................... 113 MATRIX VISION GmbH iv 1.13.9 Chunk Data Control ...................................... 114 1.13.10 File Access Control...................................... 115 1.13.11 Digital I/O Control....................................... 115 1.13.12 Encoder Control ....................................... 116 1.13.13 Sequencer Control...................................... 117 1.13.13.1 Sequencer overview................................ 117 1.13.13.2 Configuration of a sequencer set.......................... 117 1.13.14 Transport Layer Control.................................... 122 1.13.15 User Set Control ....................................... 123 1.13.16 mv Logic Gate Control .................................... 124 1.13.17 mv Flat Field Correction Control ............................... 125 1.13.18 mv Serial Interface Control.................................. 126 1.13.19 mv I2C Interface Control ................................... 126 1.13.20 mv Defective Pixel Correction Control ............................ 127 1.13.21 mv Frame Average Control (only with specific models)...................