manualshive.com logo in svg

Matrix Vision mvBlueLYNX-X, Technical Manual, Page: 174 / 236

Share
Download
Matrix Vision mvBlueLYNX-X Technical Manual Download Page 174

Figure 117: Eclipse - Run Configurations

The debugger menu (red box in figure 117) offers several possibilities to debug the application. For
example, you can browse the application step by step and have a look at the parameters.

18.3.7  Creating a new application (Hello World)

To create a new application, e. g. "Hello World", for the mvBlueLYNX-X with the suitable environment
settings, you have to

Open File -> New -> C++ Project.

1. 

mvBlueLYNX-X Technical Manual

164

22 April 2016 Version - 1.49

MATRIX VISION GmbH

Summary of Contents for mvBlueLYNX-X

Page 1: ...mvBlueLYNX X Technical Manual 22 April 2016 Version 1 49 Copyright 2017 MATRIX VISION GmbH...

Page 2: ......

Page 3: ...NUnit License 8 3 Revisions 9 4 Graphic Symbols 13 4 1 Notes Warnings Attentions 13 4 2 Webcasts 13 5 Important Information 15 5 1 Important safety instructions 15 5 2 Operating considerations 15 5 2...

Page 4: ...te 38 8 3 7 Power LED 38 8 3 8 Status LEDs 38 8 3 8 1 How to use the LEDs 38 9 Sensor Data 41 9 1 Output sequence of color sensors RGB Bayer 41 9 2 CCD 41 9 2 1 Details of operation 41 9 2 1 1 Trigger...

Page 5: ...ata 79 10 1 2 Glass filter 79 10 1 2 1 Technical data 79 10 2 Lenses 80 11 Initial Delivery Configuration 81 11 1 Booting 81 11 2 Linux OS environment 81 11 3 Keyboard layout 81 11 4 VGA resolution 82...

Page 6: ...Export images 107 13 4 1 1 6 Bit shifting an image 107 13 4 1 2 How to configure a device 108 13 4 1 2 1 How to see the first image 108 13 4 1 2 2 White balance of a camera device color version 109 1...

Page 7: ...ntroduction 137 17 2 mvIMPACT modules 137 17 3 SDK Installation 137 17 4 Installation on mvBlueLYNX X 138 17 4 1 Installing runtime libraries 138 17 4 2 Licenses 138 17 5 mvIMPACT Manual 138 17 6 Diff...

Page 8: ...cting the hardware 190 20 7 2 1 On the master camera 190 20 7 2 2 On each slave camera 190 20 7 2 3 Between the cameras 190 20 7 3 Programming the acquisition 191 20 7 3 1 Start timer 191 20 7 3 2 Set...

Page 9: ...1 9 mvBlueLYNX X boots but there is no display 207 21 10 How can I find my mvBlueLYNX X in the network 208 21 10 1 Windows 208 21 10 2 Linux 208 22 Glossary 209 22 1 Fast Ethernet 209 22 2 GenICam 209...

Page 10: ...VIII...

Page 11: ...1 mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1 49 1...

Page 12: ...mvBlueLYNX X Technical Manual 2 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 13: ...of errors or is accurate and complete and therefore assumes no liability for loss or damage of any kind incurred directly or indirectly through the use of the information of this document MATRIX VISI...

Page 14: ...eforge net cgi bin index 2 3 Sarissa Parts of the log file creation and the log file display make use of Sarissa Website http dev abiss gr sarissa which is distributed under the GNU GPL version 2 or h...

Page 15: ...CLAIMED 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 SERVIC...

Page 16: ...altered from any source distribution 3 Jean loup Gailly jloup gzip org Mark Adler madler alumni caltech edu 2 10 Expat Expat is used to parse XML strings within the SDK 2 10 1 Expat Copyright Copyrig...

Page 17: ...ermission For written permission please contact openssl core openssl org 4 Products derived from this software may not be called OpenSSL nor may OpenSSL appear in their names without prior written per...

Page 18: ...er it and redistribute it freely subject to the following restrictions The origin of this software must not be misrepresented you must not claim that you wrote the original software If you use this so...

Page 19: ...l format YUV422Packed 22 October 2013 1 37 LAN Added webcast about XForwarding on Windows 21 October 2013 1 36 LAN Updated chapter First Start 15 October 2013 1 35 LAN Added webcast links which are in...

Page 20: ...ons of mvBlueLYNX X 8 May 2012 1 9 LAN Added note about SD card handling section in SD card slot under the small metal plate and Storing Data On SD Cards or USB Devices 20 April 2012 1 8 GRA LAN Added...

Page 21: ...Ubuntu based LiveCD 30 January 2012 0 12b GRA Added proxy information for opkg 27 January 2012 0 11b LAN Now all Eclipse explanations are in a separate chapter 24 January 2012 0 10b LAN Updated the Vi...

Page 22: ...mvBlueLYNX X Technical Manual 12 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 23: ...n 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 statutor...

Page 24: ...mvBlueLYNX X Technical Manual 14 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 25: ...e void any warranties and pose a safety hazard Stop using the camera at the approach of electrical storm thunder audible Protect the camera from rain if using it outdoors In event the camera shows any...

Page 26: ...iquid if needed wipe the cover with dry cloth Do not use benzene thinner alcohol liquid cleaner or spray type cleaner If dust or other debris is located between the CCD and optical filter consult deal...

Page 27: ...mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1 49 17...

Page 28: ...mvBlueLYNX X Technical Manual 18 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 29: ...rt camera The further chapters contain general information about the mvBlueLYNX X including technical data sensor data filters and lenses The general information is followed by the description of the...

Page 30: ...mvBlueLYNX X Technical Manual 20 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 31: ...60 Hz you can work with the mvBlueLYNX X like any other PC with LINUX as operating system The mvBlueLYNX X is ideally suited for all classical areas of machine vision the large processing power and hi...

Page 32: ...NX X As shown in figure 2 the mvIMPACT Acquire interface is stacked on the GenICam layer The mvIMPACT Acquire interface internally uses the GenICam runtime libs so that it can be considered as an user...

Page 33: ...C Mount standard landscape 2 CS Mount landscape 3 C Mount without back focus adjustment landscape 4 CS Mount without back focus adjustment landscape 5 C Mount alternative portrait 6 CS Mount portrait...

Page 34: ...050 2 3 color C mount portrait glass filter etc 2 mvBlueLYNX X122G 2192 CCD 1280 x 960 1 3 gray scale CS mount landscape IR CUT filter filter no case I O extension 3 1111 is the standard delivery vari...

Page 35: ...y with digital I O on separate cable KS BLX VGA USB 01 0 3 in figure 5 VGA and USB Y cable a lens by default the mvBlueLYNX X is shipped without lens a mouse and a keyboard if you require local input...

Page 36: ...Ready made connection cable for power and I O length up to 20 m KS BLX VGA USB 01 0 USB 2 0 cable and VGA cable for mvBlueLYNX X Hirose 12pin to USB2 A and VGA length 1 m KS BLX VGA USB 05 0 USB 2 0...

Page 37: ...ors Remaining sensors Y 32 mm 30 mm Lens protrusion C Mount CS Mount X 8 mm 9 5 mm with max 20 mm 6 mm C Mount CS Mount W approx 15 mm C mount approx 10 mm CS mount Z 17 526 mm in air 12 5 mm in air F...

Page 38: ...512 MBytes Interfaces USB ports 1x Low power OTG Micro USB 100mA max 1x High power Circular connector 250mA max VGA out Circular connector max resolution WXGA Ethernet 100Mbit Power over Ethernet opti...

Page 39: ...4 10 HSD supply 24 VDC 24 V supply for the outputs red light blue 12 11 DigIn1 Line5 black orange 5 12 DigOut1 Line1 purple violet 9 NC red blue bicoloured wire Connector camera side AlysiumTech type...

Page 40: ...ge 5V IF 16mA 2 us Storage time tS 25 Turn Off time tOFF 40 8 3 1 2 Characteristics of the digital outputs High level 12 0 V to 24 V Iout 4x 0 7 A max short circuit Low level max 1 V Each output has a...

Page 41: ...Out mvBlueLYNX X Delay Characteristics Symbol Typ Unit Turn On time tON 20 us Rise time tR 10 Fall time tF 8 Turn Off time tOFF 30 8 3 1 2 2 Example circuit 1 High side switch uses power supply of the...

Page 42: ...e total time If the current always flows P U I will be the determining factor If the current only flows a hundredth of time duty cycle 1 a resistor with a hundredth of power will be enough For the con...

Page 43: ...mainboard connection header Molex 0510211200 The USB connector that is part of the Y cable KS BLX VGA USB 01 0 may be used to connect USB 2 0 peripheral devices At the moment it will not support USB...

Page 44: ...pe 61W 21 0106 6 pins or equivalent Plug matching cable plug AlysiumTech type 61W 00 0106 6 pins or equivalent 8 3 3 1 Characteristics when used as digital inputs There are four inputs parallel with t...

Page 45: ...r male Power Digital I O Additionally the outputs are protected against loss of ground an external power supply is necessary VCC_HSD signal either via pin 1 of this female connector or pin 10 of the c...

Page 46: ...is located under the small metal plate and is not restricted to USB 2 0 only You can open the metal cover with a 1 5 mm Allen key Using a USB A adapter the OTG port will act like a host device You can...

Page 47: ...tic address 192 168 0 202 netmask 255 255 255 0 network 192 168 0 0 Now the USB gadget will start while the system is booting Manually you can unload and start the additional driver like this modprobe...

Page 48: ...Ds The status LEDs can be used or set by the user A standard Linux LED driver is used which can be controlled by pseudo files in the sys directory I e the LEDs can be control by a script or by an appl...

Page 49: ...rigger none mmc0 mmc1 timer heartbeat backlight gpio default on You can write one of these key values after trigger E g echo heartbeat sys devices virtual leds mvblx red usr1 trigger The key values ha...

Page 50: ...mvBlueLYNX X Technical Manual 40 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 51: ...solution of the CCD sensors is 14 bit the image bit depth in memory is 12 bit 9 2 1 Details of operation The process of getting an image from the CCD sensor can be separated into three different phase...

Page 52: ...riggerSoftware command then Image acquisition triggerd by command software trigger OnLowLevel TriggerSelector FrameStart TriggerMode On TriggerSource TriggerActivation LevelLow ExposureMode Timed As l...

Page 53: ...Start the exposure of a frame when the trigger input level changes from high to low or from low to high 9 2 1 2 Exposure After an active trigger the integration phase starts with a maximum jitter of...

Page 54: ...ox 330K pixels Total number of pixels 692 H x 504 V approx 350K pixels Chip size 5 79mm H x 4 89mm V Unit cell size 7 4 m H x 7 4 m V Optical black Horizontal H direction Front 2 pixels rear 31 pixels...

Page 55: ...D 7 99 s 6 13 s 4 90 s treadline Time needed to readout a line 31 95 s 24 50 s 19 60 s tvshift Time needed to shift unused lines away 2 93 s 2 25 s 1 80 s texposure Exposure time 10 s 10s 10 s 10s 10...

Page 56: ...lines exposure time Now when we insert the values using exposure time of for example 8000 us 480 lines and 40MHz pixel clock Expose mode No overlap FPS_max 1 480 1 19 60 us 504 480 1 80 us 4 90 us 800...

Page 57: ...pprox 330K pixels Total number of pixels 692 H x 504 V approx 350K pixels Chip size 7 48mm H x 6 15mm V Unit cell size 9 9 m H x 9 9 m V Optical black Horizontal H direction Front 2 pixels rear 31 pix...

Page 58: ...D 7 99 s 6 13 s 4 90 s treadline Time needed to readout a line 31 95 s 24 50 s 19 60 s tvshift Time needed to shift unused lines away 2 93 s 2 25 s 1 80 s texposure Exposure time 10 s 10s 10 s 10s 10...

Page 59: ...lines exposure time Now when we insert the values using exposure time of for example 8000 us 480 lines and 40MHz pixel clock Expose mode No overlap FPS_max 1 480 1 19 60 us 504 480 1 80 us 4 90 us 800...

Page 60: ...pprox 460K pixels Total number of pixels 823 H x 592 V approx 490K pixels Chip size 7 48mm H x 6 15mm V Unit cell size 8 3 m H x 8 3 m V Optical black Horizontal H direction Front 3 pixels rear 38 pix...

Page 61: ...ut cells in CCD 30 51 s 18 75 s treadline Time needed to readout a line 32 s 19 67 s tvshift Time needed to shift unused lines away 3 25 s 2 s texposure Exposure time 10 s 10s 10 s 10s treadout Image...

Page 62: ...n of lines exposure time Now when we insert the values using exposure time of for example 8000 us 580 lines and 48MHz pixel clock Expose mode No overlap FPS_max 1 580 1 19 67 us 592 580 2 us 18 75 us...

Page 63: ...approx 1 25M pixels Total number of pixels 1348 H x 976 V approx 1 32M pixels Chip size 6 26mm H x 5 01mm V Unit cell size 3 75 m H x 3 75 m V Optical black Horizontal H direction Front 12 pixels rea...

Page 64: ...lls in CCD 16 25 s 11 70 s treadline Time needed to readout a line 45 83 s 33 00 s tvshift Time needed to shift unused lines away 2 06 s 1 48 s texposure Exposure time 10 s 10s 10 s 10s treadout Image...

Page 65: ...lines exposure time Now when we insert the values using exposure time of for example 8000 us 960 lines and 50MHz pixel clock Expose mode No overlap FPS_max 1 960 1 33 00 us 976 960 1 48 us 11 70 us 80...

Page 66: ...M pixels Total number of pixels 1434 H x 1050 V approx 1 5M pixels Chip size 7 6mm H x 4 65mm V Unit cell size 4 65 m H x 4 65 m V Optical black Horizontal H direction Front 2 pixels rear 40 pixels Ve...

Page 67: ...readout cells in CCD 42 86 s 21 43 s treadline Time needed to readout a line 63 93 s 31 96 s tvshift Time needed to shift unused lines away 8 57 s 4 29 s texposure Exposure time 20 s 10s 20 s 10s trea...

Page 68: ...nction of lines exposure time Now when we insert the values using exposure time of for example 8000 us 1024 lines and 56MHz pixel clock Expose mode No overlap FPS_max 1 1024 1 31 96 us 1050 1024 4 29...

Page 69: ...92M pixels Total number of pixels 1688 H x 1248 V approx 2 11M pixels Chip size 8 50mm H x 6 8mm V Unit cell size 4 4 m H x 4 4 m V Optical black Horizontal H direction Front 12 pixels rear 48 pixels...

Page 70: ...s in CCD 35 56 s 22 86 s 19 69 s treadline Time needed to readout a line 53 33 s 34 29 s 29 54 s tvshift Time needed to shift unused lines away 5 56 s 3 57 s 3 08 s texposure Exposure time 20 s 10s 20...

Page 71: ...function of lines exposure time Now when we insert the values using exposure time of for example 8000 us 1024 lines and 56MHz pixel clock Expose mode No overlap FPS_max 1 1200 1 29 54 us 1248 1200 3 0...

Page 72: ...number of pixels 2536 H x 2068 V approx 5 24M pixels Chip size 9 93mm H x 8 70mm V Unit cell size 3 45 m H x 3 45 m V Optical black Horizontal H direction Front 40 pixels rear 40 pixels Vertical V dir...

Page 73: ...87 s 28 06 s treadline Time needed to readout a line 53 20 s 48 36 s tvshift Time needed to shift unused lines away 10 00 s 9 09 s texposure Exposure time 20 s 10s 20 s 10s treadout Image readout time...

Page 74: ...unction of lines exposure time Now when we insert the values using exposure time of for example 8000 us 1024 lines and 56MHz pixel clock Expose mode No overlap FPS_max 1 2050 1 53 20 us 2068 2050 10 0...

Page 75: ...ases Trigger 1 Erase exposure and readout 2 9 3 1 2 1 Trigger Snapshot mode starts with a trigger This can be either a hardware or a software signal The CMOS sensors used in mvBlueLYNX X cameras suppo...

Page 76: ...integration time corresponds to pulse width only with X105 If an external trigger signal occurs e g high or low the sensor will start to expose and readout one image Now if the trigger signal is still...

Page 77: ...the signal OnHighExpose This mode is like OnHighLevel however the exposure time is used like the high time of the signal 9 3 1 2 2 Erase exposure and readout All pixels are light sensitive at the same...

Page 78: ...ufacturer Aptina Sensor name MT9V034 Max frames per second 117 Device Structure CMOS image sensor with HDR SNR DNR normal HDR 55 dB 110 dB Image size Type 1 3 Number of effective pixels 752 H x 480 V...

Page 79: ...ight VerticalBlank PixelClock If exposure time is lower than frame time FPS_max 1 FrameTime 1000000 If exposure time is greater than frame time FPS_max 1 ExposureTime 1000000 9 3 2 1 2 2 Snapshot mode...

Page 80: ...Aptina Sensor name MT9M021 Max frames per second 40 6 Device Structure CMOS image sensor SNR 40 dB DNR normal HDR 61 dB Image size Type 1 3 Number of effective pixels 1280 H x 960 V Unit cell size 3 7...

Page 81: ...lClock VerticalBlank Line PixelClock If exposure time is lower than frame time FPS_max 1 FrameTime 1000000 If exposure time is greater than frame time FPS_max 1 ExposureTime 1000000 9 3 2 2 2 2 Snapsh...

Page 82: ...FrameTime ExposureTime 1000000 mvBlueLYNX X Technical Manual 72 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 83: ...er E2V Sensor name EV76C560 Max frames per second 60 Device Structure CMOS image sensor SNR 41 dB DNR normal HDR 62 dB Image size Type 1 1 8 Number of effective pixels 1280 H x 1024 V Unit cell size 5...

Page 84: ...rms of color sensor can be selected to be read out of the full line height of 1024 lines This or these lines are grouped to a pseudo frame of selectable height in the internal buffer of the camera The...

Page 85: ...may use longer exposure times at the expense of scanning frequency You can use either Continuous or a trigger mode as Acquisition Mode in Setting Base Camera GenICam Acquisition Control However if an...

Page 86: ...operation starts the exposure of all rows simultaneously and the reset to each row is released simultaneously too However the readout of the lines is equal to the readout of the rolling shutter line...

Page 87: ...P031 Max frames per second 11 7 Device Structure CMOS image sensor SNR 38 dB DNR normal HDR 70 dB Image size Type 1 2 5 Number of effective pixels 2592 H x 1944 V Chip size 5 70 H x 4 28mm V Unit cell...

Page 88: ...nk Line PixelClock If exposure time is lower than frame time FPS_max 1 FrameTime 1000000 If exposure time is greater than frame time FPS_max 1 ExposureTime 1000000 9 3 2 4 2 2 Snapshot mode To calcula...

Page 89: ...1 1 Technical data Diameter 20 0 mm Thickness 1 0 mm Material Borofloat Characteristics T 50 650 10 nm T 92 390 620 nm Ravg 95 700 1150 nm AOI 0 degrees ground with protection chamfer Surface quality...

Page 90: ...sides P4 Surface irregularity 5 3x0 06 on both sides 10 2 Lenses MATRIX VISION offers a high quality selection of lenses If you have questions about our accessories please contact our sales team info...

Page 91: ...properly please have a look at the Troubleshooting section By default there are two users root matrix only with this user wxPropView is running at the moment 1 matrix matrix no camera access at the m...

Page 92: ...resolution depends on the pixel clock not exceeding 75MHz i e a resolution of WXGA 1280 x 800 60Hz 71MHz is possible 11 5 Network configuration By default the mvBlueLYNX X gets its IP address via DHCP...

Page 93: ...ox Click on desktop Menu Applications Settings Network Setup are known to write incorrect information to the file etc network interfaces If you do use this dialogbox then please check the file etc net...

Page 94: ...ve data integrity if applications do write data to a SD card Wherever possible make use of the standard GNU Linux commands halt reboot or shutdown instead of suddenly removing power from the camera 1...

Page 95: ...d x etc init d gpe dm 2 Reboot afterwards 3 To turn the X server back on again by default chmod x etc init d psplash chmod x etc init d gpe dm Now reboot 11 7 1 X11Forwarding X window systems like Enl...

Page 96: ...cheme unchanged in order to save power and prolong the life of the components Otherwise you may change the CPU throttling policy if your application requires a constant CPU frequency For this you can...

Page 97: ...To see more details just type mount cifs If you need to access your shared resource regularly it makes sense to load the kernel module automatically after every new start To do this please enter the f...

Page 98: ...s behaviour by adding a new hal XML file called etc hal etc hal fdi policy 50 usbstorage fdi and containing exactly these lines xml version 1 0 encoding UTF 8 SGML find all removable hotpluggable USB...

Page 99: ...file wxPropView desktop as a good example for the entries required if you would like to create or edit a desktop file by hand 11 13 Autostart Applications 11 13 1 GUI Applications The Enlightenment G...

Page 100: ...it d myapp Then put a symbolic link to this script in one of the etc rc d directories depending on where in the sequence you want the program to start e g Create an executable script called etc init d...

Page 101: ...g digital I Os connecting digital I Os etc including connection cable connected to 7 5 VGA and USB Y cable KS BLX VGA USB 01 0 connected to 7 6 mvBlueLYNX X 7 Power supply with digital I O on separate...

Page 102: ...een indicating that Linux is starting 2 After around 25 seconds you may see an image of the camera followed by an ngstr m logo and eventually the Enlightenment desktop This means the camera is ready T...

Page 103: ...will also be displayed on the top right of the screen On the bottom you will see the toolbar shelf of the Linux OS Figure 55 mvBlueLYNX X OS toolbar shelf The toolbar offers several sections 4x Virtua...

Page 104: ...plication wxPropView via the Favorite Applications menu left click with the mouse anywhere on the desktop Click on wxPropView The application will start Then select the mvBlueLYNX X device serial numb...

Page 105: ...ch interests you 1 Turn off the Fit to Screen function right click on the live image to get the menu so that no software scaling of the display takes place 2 Try reducing the input format from 12bpp t...

Page 106: ...orm of data acquisition Now whenever a device is opened the driver will execute following procedure Figure 58 wxPropView Device setting start procedure Each setting location step in the figure from ab...

Page 107: ...fter a device has been opened the settings will be loaded automatically as described above All the information about storing and restoring of settings that have been given so far will bind settings fo...

Page 108: ...mvBlueLYNX X Technical Manual 98 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 109: ...d conf rw r r 1 root root 1090 Aug 11 13 30 opkg conf arch conf contains details about the different ARM packages and should not be changed opkg conf contains the configuration of the update program o...

Page 110: ...mypassword proxy mycompany com 3128 option ftp_proxy http myusername mypassword proxy mycompany com 3128 option proxy_username username option proxy_password password 13 2 Working with ipks 13 2 1 Upd...

Page 111: ...path of the file or change into the directory and you also have to add the file suffix opkg install PATH gpe scap ipk 13 2 3 Removing single applications To remove an application there s the command...

Page 112: ...wing packages are not pre installed on the mvBueLYNX X and are only needed for additional functions or devices libmvBlueFOX libmvVirtualDevice libmvV4L This package and its dependencies e g mono are n...

Page 113: ...to work with wxPropView wxPropView Working with wxPropView After starting wxPropView you will see the following window Figure 59 wxPropView started wxPropView consists of several areas Menu Bar to wor...

Page 114: ...by the user Only the properties which actually have an impact on the resulting image will be visible Therefore certain properties might appear or disappear when modifying another properties To permane...

Page 115: ...chine in e g wxPropView select in the Menu Bar Action Capture Settings Load From The Default Settings Location For This Devices Family And Product Type explicitly load the device specific settings sto...

Page 116: ...ate the parameters by blanks So to call a function expecting a string and an integer value you e g might enter testString 0 into the edit control left of the method The return value in almost every ca...

Page 117: ...a at a later time All image formats that can be exported can also be imported again Importing a file can be done in 3 different ways via the menu via the Menu Bar Action Load image 1 by dragging an im...

Page 118: ...ccessfully in the Grid area of the GUI the available interface layout properties are displayed in a hierarchy tree GenICam is the default interface layout of the mvBlueLYNX X and we recommend to use i...

Page 119: ...1 2 2 White balance of a camera device color version Start the wxPropView and initialize the device by clicking Use and start a Continuous acquisition Figure 66 wxPropView Continuous mode While using...

Page 120: ...Figure 67 wxPropView Selecting WhiteBalance profile Figure 68 wxPropView WhiteBalanceCalibration mvBlueLYNX X Technical Manual 110 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 121: ...f mv OMAP Preview Config Figure 70 wxPropView White balance with pixel format YUV422Packed 13 4 1 2 3 Configuring different trigger modes To configure a device for a triggered acquisition in wxPropVie...

Page 122: ...istered by right clicking on the property you are interested in again Now select Attach Callback from the pop up menu and switch to the Output tab in the lower right section of wxPropView Analysis tab...

Page 123: ...r set with int UserSetSave Finally if you want that the camera starts with a specific user set after power up you have to select it with the User Set Default Selector Deprecated The User Set Default S...

Page 124: ...mvBlueLYNX X Technical Manual 114 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 125: ...re 73 wxPropView GenICam controls As you can see there are some controls with and without the prefix mv mv prefix features are unique non standard features developed by MATRIX VISION Without mv are st...

Page 126: ...mvIMPACT Acquire Description SensorWidth sensorWidth Effective width of the sensor in pixels SensorHeight sensorHeight Effective height of the sensor in pixels Width width Width of the image provided...

Page 127: ...riggerOverlap TriggerSelector triggerOverlap Specifies the type trigger overlap permitted with the previous frame TriggerOverlap is only intented for external trigger which is usually non overlapped i...

Page 128: ...scription CounterSelector counterSelector Selects which Counter to configure CounterEventSource CounterSelector counterEventSource Selects the events that will be the source to increment the Counter C...

Page 129: ...cts the physical line or pin of the external device connector to configure LineMode LineSelector fileOperationSelector Controls if the physical Line is used to Input or Output a signal UserOutputSelec...

Page 130: ...igure UserSetLoad UserSetSelector userSetLoad Loads the User Set specified by UserSetSelector to the device and makes it active UserSetSave UserSetSelector userSetSave Endianess of the device register...

Page 131: ...tar bz2 2 Normally the extras package is not needed 15 3 Installation You will need a Linux PC running an up to date distribution i e at least Ubuntu 10 10 You will need root rights for the installati...

Page 132: ...om linux gnueabi strings rwxr xr x 1 root root 636812 2011 02 26 01 28 arm angstrom linux gnueabi strip rwxr xr x 1 root root 281763 2011 02 26 00 07 i686 linux libtool rwxr xr x 1 root root 281763 20...

Page 133: ...er march armv7 a mtune cortex a8 mfpu neon mfloat abi softfp 15 5 1 2 Optimization O2 15 5 1 3 Warnings Wall 15 5 1 4 Miscellaneous c fmessage length 0 Wl rpath link usr local angstrom arm arm angstro...

Page 134: ...gs 15 5 4 wxWidgets For wxWidgets applications you can use wx config to find out the correct options and paths e g 15 5 4 1 Compiler usr local angstrom arm arm angstrom linux gnueabi usr bin wx config...

Page 135: ...l Machine image using VirtualBox together with the LiveDVD and How to work with the Virtual Machine 16 1 1 Requirements To be able to setup and use the LiveDVD you will need at least Host PC running W...

Page 136: ...ng a VirtualBox Virtual Machine image These instructions refer to VirtualBox version 4 1 6 Later versions may look different After Downloading 1 Installing the VirtualBox platform at least version 4 1...

Page 137: ...d will start Figure 76 VirtualBox Wizard Click on Next 2 Then enter a Name for your image and 3 select Linux as Operating System and 1 Ubuntu as Version and 2 4 mvBlueLYNX X Technical Manual MATRIX VI...

Page 138: ...re 77 VirtualBox Name and OS 5 Set the memory to 512 MB Figure 78 VirtualBox Main memory 6 Now activate Start up Disk and Create new hard disk 7 mvBlueLYNX X Technical Manual 128 22 April 2016 Version...

Page 139: ...xt dialog by clicking Continue Figure 80 VirtualBoxVirtual Warning 8 Afterwards you have to set the virtual disk Choose VDI VirtualBox Disk Image and click on Next 9 mvBlueLYNX X Technical Manual MATR...

Page 140: ...Creation Select Dynamically allocated and click on Next Figure 82 VirtualBox Storage Details 10 Enter the size of the Virtual Disk We recommend 15 GB 11 mvBlueLYNX X Technical Manual 130 22 April 201...

Page 141: ...83 VirtualBox Disk Size Finally click on Create Figure 84 VirtualBox Create 12 You will see the new created VirtualBox manager mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1...

Page 142: ...an NFS share you should change the type of networking device from NAT to Bridged Adapter for the VM 16 2 2 Running the Virtual Machine Now you can click on Start to start the Virtual Machine image Wh...

Page 143: ...un Wizard Select the mvBlueLYNX X LiveDVD iso in the Media Source and click on Next Figure 87 VirtualBox Media Source 2 Afterwards click on Start 3 mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22...

Page 144: ...Machine 16 2 3 Starting the LiveDVD After starting the Virtual Machine or development PC with the LiveDVD in the drive and you have to press the Enter key so that the live system will boot mvBlueLYNX...

Page 145: ...ten will be lost when you restart the system Therefore it only makes sense to use the LiveDVD like this in order to try out the SDK tools and environment Normally the contents should be installed on a...

Page 146: ...ole virtual disk If you are installing on a real PC that already uses another operating system e g Microsoft Windows the wizard will detect this and offer to repartition your desk so that a dual boot...

Page 147: ...from the MATRIX VISION website You will find it in the download section for the mvBlueLYNX X camera and also in the mvIMPACT download section The file is a tgz archive The name contains the version n...

Page 148: ...ot console and type chmod a r etc matrix vision impact license name of license file reg 17 5 mvIMPACT Manual The mvIMPACT SDK manual can be downloaded from the MATRIX VISION website 17 6 Differences b...

Page 149: ...ready installed First of all please be sure that the Eclipse IDE runs in C C view mode Afterwards following plugins are required C C GCC Cross Compiler Support and 1 C C GNU Toolchain Debug Support 2...

Page 150: ...Figure 91 Eclipse Open Preferences Select General Network Connections 2 mvBlueLYNX X Technical Manual 140 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 151: ...YNX X to Proxy bypass 4 Again click on Apply and Ok 5 18 3 2 Installing new plugins software in Eclipse You can install new plugins software for Eclipse like the following way please check if you have...

Page 152: ...lipse Install New Software Select the download source e g Indigo http download eclipse org releases indigo from the dropdown menu 2 mvBlueLYNX X Technical Manual 142 22 April 2016 Version 1 49 MATRIX...

Page 153: ...do so 5 In the last dialog click Finish an wait for the plugins to be installed 6 After that Eclipse wants to restart 7 Now all installed plugins are available 8 18 3 3 Importing samples To import sa...

Page 154: ...Figure 95 Eclipse Import a project select Import 2 Then select Existing Projects ino Workspace and 3 click Next 4 mvBlueLYNX X Technical Manual 144 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 155: ...6 Eclipse Select import type Now activate the radio button Select archive file and 5 browse the MATRIX VISION sample tgz file 6 mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1...

Page 156: ...t click on the project in the Project Explorer if every required plugin software was installed successfully 18 3 4 Setting up remote connection For the remote debugging feature to work you have to set...

Page 157: ...onnection Select Remote Systems Figure 99 Eclipse Remote Systems 2 Define a connection to remote system by clicking on the icon as shown in the figure 3 mvBlueLYNX X Technical Manual MATRIX VISION Gmb...

Page 158: ...Figure 100 Eclipse Define a connection to remote system Then in the New Connection dialog select SSH Only 1 mvBlueLYNX X Technical Manual 148 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 159: ...Figure 101 Eclipse SSH Only Afterwards enter the connection information 2 mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1 49 149...

Page 160: ...tion information Now you can connect to the mvBlueLYNX X Just right click on one of the new possiblities e g Ssh Terminals and click on Connect 3 mvBlueLYNX X Technical Manual 150 22 April 2016 Versio...

Page 161: ...r the User ID and Password User ID root 1 Password matrix Figure 104 Eclipse mvBlueLYNX X login 2 4 You are now connected to the mvBlueLYNX X You can now launch a Terminal window 5 mvBlueLYNX X Techni...

Page 162: ...Figure 105 Eclipse Launch a Terminal The Terminal window shows you the mvBlueLYNX X prompt 6 mvBlueLYNX X Technical Manual 152 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 163: ...n also access the file system via Sftp Files SSH connection possible with the pre installed ipk package openssh sftp server and copy files to the mvBlueLYNX X 7 mvBlueLYNX X Technical Manual MATRIX VI...

Page 164: ...K was installed Each sample is available for different target systems mvBL X 1 mvBL X Debug 2 Native 3 Native Debug 4 mvBL X is meant to run on the mvBlueLYNX X Native means that it is for the Linux O...

Page 165: ...hammer icon Figure 108 Eclipse Building a sample 2 After building copy the binary of the sample per drag drop on the mvBlueLYNX X 3 mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Vers...

Page 166: ...BlueLYNX X You could make a separate folder for your applications e g work in the home directory Now click on the Terminals tab and enter cd home root work LiveSnap 1 mvBlueLYNX X Technical Manual 156...

Page 167: ...rmission denied you have to adjust the rights of the file and make it executable For this please use the command chmod a x LiveSnap Afterwards the sample is running and you can quit it by pressing the...

Page 168: ...er sudo vi etc exports You have to enter the password of the user matrix which is matrix 2 Enter the following line read only rights otherwise keep the default value home matrix workspace ro no_subtre...

Page 169: ...minals tab without copying it e g cd mnt workspace LiveSnap mvBL X LiveSnap or you can edit the Run Configurations so that the binary is executed directly see Debugging a sample on the mvBlueLYNX X re...

Page 170: ...ueabi lib Separate Paths with and write this command only in one line Setting the path to the file gdbinit Run Debug Configurations Debugger GDB command file gdbinit Now you can start gdb passing your...

Page 171: ...path on the mvBlueLYNX X e g mnt workspace LiveSnap mvBL X Debug LiveSnap to continue the sample in the NFS mount chapter 4 N B If the application is intended to use the graphical display e g wxPropVi...

Page 172: ...onfiguration settings Open Run Debug Configurations 1 Select your configuration e g LiveSnap mvBL X and 2 select in the right window the Debugger tab 3 Enter or Browse the GDB debugger which can be fo...

Page 173: ...16 Eclipse Run Configurations Finally you can debug by clicking on Debug The debugger will be opened in a special environment 5 mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1...

Page 174: ...ou can browse the application step by step and have a look at the parameters 18 3 7 Creating a new application Hello World To create a new application e g Hello World for the mvBlueLYNX X with the sui...

Page 175: ...nter the Project name e g HelloWorld 2 select as Project type Hello World C Project and 3 select as Toolchains Linux GCC we will change the toolchain for cross developing later 4 mvBlueLYNX X Technica...

Page 176: ...s the project will be created Now we have to adapt the properties of the project Therefore Right click on the HelloWorld in the Project Explorer and 1 select Properties 2 mvBlueLYNX X Technical Manual...

Page 177: ...f all change the Tool Chain Editor to Cross GCC Figure 121 Eclipse Changing the toolchain 3 Then select in Discovery Options Tools the Cross G Compiler and 4 mvBlueLYNX X Technical Manual MATRIX VISIO...

Page 178: ...nueabi g Figure 122 Eclipse Compiler invocation command 5 Now select Settings Cross Settings and 6 enter in Prefix arm angstrom linux gnueabi and in Path usr local angstrom arm bin 7 mvBlueLYNX X Tech...

Page 179: ...s Afterwards you can enter the settings as listed in chapter Compiler Flags and Options That means Nothing in Settings Cross G Compiler Preprocessor 1 8 mvBlueLYNX X Technical Manual MATRIX VISION Gmb...

Page 180: ...o mvIMPACT Acquire usr local angstrom arm arm angstrom linux gnueabi usr include mvimpact acquire Figure 125 Eclipse mvIMPACT Acquire included 2 In Settings Cross G Compiler Optimization select Optimi...

Page 181: ...Figure 126 Eclipse Optimization In Settings Cross G Compiler Debugging select None as the Debug Level 4 mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1 49 171...

Page 182: ...r c fmessage length 0 Wl rpath link usr local angstrom arm arm angstrom linux gnueabi usr lib hash style gnu mthumb interwork mno thumb isystem usr local angstrom arm arm angstrom linux gnueabi usr in...

Page 183: ...you click on Settings Cross G Compiler you have to enter in Command g march armv7 a mtune cortex a8 mfpu neon mfloat abi softfp then it will look like this 9 mvBlueLYNX X Technical Manual MATRIX VISI...

Page 184: ...G Linker Libraries the path to the MATRIX VISION libraries usr local angstrom arm arm angstrom linux gnueabi usr lib and the libraries themselves mvPropHandling 1 mvDeviceManager 2 10 mvBlueLYNX X Te...

Page 185: ...Figure 131 Eclipse Libraries As a test you can include the mvIMPACT_acquire header mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1 49 175...

Page 186: ...132 Eclipse Libraries and try to run the sample as described in Running a MATRIX VISION sample You can also try this remotely mvBlueLYNX X Technical Manual 176 22 April 2016 Version 1 49 MATRIX VISIO...

Page 187: ...install MonoDevelop and the mv impact acquire assembly for Ubuntu users Since firmware version 1 5 this installation process is not necessary when using the LiveDVD and Virtual Machine because the Liv...

Page 188: ...low With Mono it is possible to develop mvBlueLYNX X using Microsoft s Visual Studio The workflow will look like this Figure 133 Developing mvBlueLYNX X samples using Microsoft Visual Studio To track...

Page 189: ...mpact acquire r mv impact acquire out ContinuousCapture no display exe Figure 134 ContinuousCapture sample in MonoDevelop 19 4 Resources For more information please have a look at the following websit...

Page 190: ...mvBlueLYNX X Technical Manual 180 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 191: ...mmended to just use it for setting up image acquisition parameters For getting timing results you can use MATRIX VISION s standard demo program LiveSnap which comes with the camera and does no image d...

Page 192: ...second trigger event For this scenario you have to use the Setting Base Camera Acquisition Control Trigger Selector AcquisitionStart The following figure shows how to set the scenario shown in figure...

Page 193: ...es or flash Be sure that the illumination fits with the movement of the device under test 1 Bright illumination and careful control of exposure time are usually required 2 To compensate blur in the im...

Page 194: ...nate delayed with respect to exposure of the sensor The figure 139 shows the problem Figure 139 Flash delay with ExposureActive Do solve this issue you can use following procedure Do not use ExposureA...

Page 195: ...ases the usable contrast range This is achieved by dividing the integration time in two or three phases The exposure time proportion of the three phases can be set independently Furthermore it can be...

Page 196: ...hus the signal increase during T2 is lower as during T1 The max signal level of Knee Point 2 is higher than of Knee Point 1 Phase 2 During T2 all pixels are integrated until the possible saturation T3...

Page 197: ...ved However if you want to divide the integration thresholds into three parts that is S2 2 x S1 and S3 3 x S1 a hundredfold brightness of one pixel s step from S2 to S3 compared to the step from 0 and...

Page 198: ...compander to be output as a piece wise linear signal the next figure shows this Figure 144 Piece wise linear signal 20 5 1 1 Description Exposure ratios are set programmatically Two rations are used...

Page 199: ...tamp by hardware This feature can be used for precise control of timestamp 1 for one camera or 2 to synchronize timestamp of multitude of cameras 3 The latter sample can be achieved by follwing steps...

Page 200: ...0 camera with mvBlueLYNX X shows how you can use the mvBlueFOX MLC as a second image acquisition device 20 7 2 Connecting the hardware One camera is used as master M which generates the trigger signal...

Page 201: ...to synchronize the cameras exactly As you can see in figure 147 and figure 148 you will need a dropping resistor of 2 kOhm because the opto isolated inputs of the mvBlueFOX MLC are not designed for hi...

Page 202: ...e g Line4 3 20 7 3 2 Set digital I O In this step the signal has to be connected to the digital output e g Line0 Set Digital I O GenICam DigitalIOControl io pDev io lineSelector writeS Line0 io lineSo...

Page 203: ...0 csS triggerMode write ctmOnHighLevel csS triggerSource write ctsDigIn0 Now the two timers will work like the following figure illustrates which means Timer1 is the trigger event and Timer2 the trigg...

Page 204: ...mera 2 Setting the trigger slave camera s The red box in figure 150 for mvBlueLYNX X and figure 151 for mvBlueFOX MLC is showing Slave Slave which means that both master and slave camera are connected...

Page 205: ...et as shown in figure 152 Figure 152 wxPropView Trigger setting of the master camera using Master Slave 2 Assigning timer to DigOut orange box in figure 148 4 20 8 Generating a pulse width modulation...

Page 206: ...atcMaster timerDuration write 1000000 catcMaster timerTriggerSource writeS Timer1End catcMaster timerSelector writeS Timer2 catcMaster timerDelay write 0 catcMaster timerDuration write 10000 catcMaste...

Page 207: ...the master camera Figure 154 wxPropView Setting of Timer1 1 Setting of Timer2 blue box on the master camera Figure 155 wxPropView Setting of Timer2 2 Assigning timer to DigOut orange box in figure 154...

Page 208: ...pears every second image Now you can assign Timer1Active to a digital output e g Line3 Figure 157 Assigning the digital output You can delay the pulse if needed 20 10 Creating a debouncing filter at t...

Page 209: ...al input Figure 158 wxPropView Configuring Digital Input Debounce Times Each digital input LineMode equals Input that can be selected via the LineSelector property will offer its own property to confi...

Page 210: ...the sensor x02e using an external trigger provided by an incremental encoder 20 11 1 1 Initial situation and settings An incremental encoder triggers in a specific frequency In our example the increm...

Page 211: ...or the illumination These settings result in a frame rate of 2 5 frames per second To adjust the opto mechanics focus distance illumination etc you can use the area mode of the sensor That s a main a...

Page 212: ...On Acquisition Control Trigger Source Line4 Acquisition Control ImageRequestTimeout_ms in milliseconds 0 ms This is necessary otherwise there will be error counts and no frames are created mvBlueLYNX...

Page 213: ...Figure 162 Settings in wxPropView mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 2016 Version 1 49 203...

Page 214: ...mvBlueLYNX X Technical Manual 204 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 215: ...he recovery if the SD still shows a strange behavior the SD is damaged Please use the RMA form on our website for a repair 21 2 My USB 2 0 hub doesn t seem to work with the mvBlueLYNX X You should use...

Page 216: ...Eclipse Calling the script like this opt mvimpact acquire make_mvia armv7a all samples will be built in this directory If you want to build single samples like Live Snap just change the directory and...

Page 217: ...cquire applications will believe that the hardware is still in use If you are sure that this is not the case you can remove the locking files by hand and restart your application The locking files are...

Page 218: ...d B _ssh _tcp This command lists all PCs in the network with ssh _Service 3 One of them should be called mvblx local or similar Use this command to see its IP address ping mvblx local 21 10 2 Linux On...

Page 219: ...ertain parameter from the device These description files are written in XML For further informations on this topic please have a look at http www genicam org 22 3 Gigabit Ethernet GigE The term Gigabi...

Page 220: ...DK is a comprehensive library with high performance algorithms for fast image processing The library offers a software architecture designed for the future with an object oriented design OEMs and syst...

Page 221: ...work Manager In Wired you can add interfaces via Add Figure 164 Adding an interface In the tab IPv4 Setting you have to set Link Local Only mvBlueLYNX X Technical Manual MATRIX VISION GmbH 22 April 20...

Page 222: ...the summary Figure 166 Network Connections summary Now you can select the wished connection using the left mouse button in the Network Manager menu In the LLA case it is just the new created connectio...

Page 223: ...t of an image sensor are done one after the other By design CCD sensors support overlap capabilities also combined with trigger see figure In contrast so called pipelined CMOS sensors only support the...

Page 224: ...or IP addresses 22 13 SFNC S tandard F eature N aming C onvention of GenICam camera features See also The latest GenICam properties list can be found here http www emva org genicam genicam E2 84 A2_do...

Page 225: ...tart a VNC viewer and 2 point it to the mvBlueLYNX X 3 You won t need a password Of course you won t get a very fast live image display via the network with VNC but you should be able to start wxPropV...

Page 226: ...mvBlueLYNX X Technical Manual 216 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 227: ...figuration Cross G Compiler Eclipse IDE Cross G Compiler mvBlueLYNX X SDK D Data Matrix mvIMPACT SDK Daylight Application Installation and Usage Daylight cut filter Filter and Lenses Debouncing Use Ca...

Page 228: ...ient temperature Important Information OPKG Application Installation and Usage P Plugins Eclipse IDE Power LEDs Technical Data Power supply with following specifications Important Information Powering...

Page 229: ...plication Installation and Usage V VGA Initial Delivery Configuration Virtual Desktop First Start Virtual Machine mvBlueLYNX X LiveDVD and Virtual Machine W WEEE Important Information White balance Ap...

Page 230: ...mvBlueLYNX X Technical Manual 220 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Page 231: ...l I Os Technical Data Figure 18 Setting of digital outputs Technical Data Figure 19 RJ45 LAN Technical Data Figure 20 Output sequence of RAW data Sensor Data Figure 21 CCD timing TriggerOverlap Sensor...

Page 232: ...re the default value of a property Application Installation and Usage Figure 63 wxPropView Calling a method object Application Installation and Usage Figure 64 wxPropView Copying grid_data to the clip...

Page 233: ...Figure 96 Eclipse Select import type Eclipse IDE Figure 97 Eclipse Select source Eclipse IDE Figure 98 Eclipse Create a SSH connection Eclipse IDE Figure 99 Eclipse Remote Systems Eclipse IDE Figure...

Page 234: ...ed by an external signal Use Cases Figure 138 Setting the Line Soruce to mvExposureAndAcquisitionActive Use Cases Figure 139 Flash delay with ExposureActive Use Cases Figure 140 Working with Timer and...

Page 235: ...LED pairs Use Cases Figure 162 wxPropView mv X Lamp Control section Use Cases Figure 161 Sensor s view and settings Use Cases Figure 162 Settings in wxPropView Use Cases Figure 163 Gnome Network Manag...

Page 236: ...mvBlueLYNX X Technical Manual 226 22 April 2016 Version 1 49 MATRIX VISION GmbH...

Reviews:

No comments