Page 4
Table of Contents 8 Technical Data 8.3.1 Circular connector male (Power / Digital I/O)..............29 8.3.1.1 Characteristics of the digital inputs................29 8.3.1.1.1 Delay........................30 8.3.1.2 Characteristics of the digital outputs................30 8.3.1.2.1 Delay........................31 8.3.1.2.2 Example circuit 1: High-side switch uses power supply of the camera.....31 8.3.1.2.3 Example circuit 2: High-side switch uses external (higher) power supply..32 8.3.1.3 Using the serial port.....................32 8.3.2 Circular connector female (VGA / USB)................32...
Page 5
Table of Contents 9 Sensor Data 9.3.1.2 Snapshot mode......................65 9.3.1.2.1 Trigger........................65 9.3.1.2.2 Erase, exposure and readout ................67 9.3.2 Models...........................68 9.3.2.1 mvBlueLYNX-X100w (WVGA 752 x 480)...............68 9.3.2.1.1 Spectral Sensitivity .....................68 9.3.2.1.2 Timings .......................69 9.3.2.2 mvBlueLYNX-X102b (SXGA 1280 x 960)..............70 9.3.2.2.1 Spectral Sensitivity .....................70 9.3.2.2.2 Timings .......................71 9.3.2.3 mvBlueLYNX-X102e (SXGA 1280 x 1024)..............73 9.3.2.3.1 Spectral Sensitivity .....................73...
Page 6
14.1.8 mv X Lamp Control......................120 14.1.9 User Set Control........................120 15 mvBlueLYNX-X SDK..........................121 15.1 Introduction..........................121 15.2 Packages ............................121 15.3 Installation..........................121 15.4 Usage ............................122 15.4.1 Makefiles...........................122 15.4.2 Copying files to the mvBlueLYNX-X................122 15.5 Eclipse............................123 15.5.1 Compiler Flags and Options....................123 15.5.1.1 Cross G++ Compiler....................123 15.5.1.2 Optimization......................123...
Page 7
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 Differences between mvIMPACT for mvBlueLYNX-X and mvIMPACT for Windows ..138 17.6.1 Supported languages ......................138 17.6.2 mvIMPACT Base......................138 17.6.3 mvIMPACT Display 3D....................138 18 Eclipse (IDE) ..............................139 18.1 Introduction..........................139...
Page 8
20.11.1.2 Setting the application in wxPropView..............201 21 Troubleshooting............................205 21.1 How to detect that the internal SD card is damaged?..............205 21.2 My USB 2.0 hub doesn't seem to work with the mvBlueLYNX-X? ..........205 21.3 I've got no keyboard, is there a virtual one?................205...
Page 9
21.8 No mvIMPACT Acquire application is running but still seeing "Device or resource busy" debug messages ...........................207 21.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...
MATRIX VISION website. MATRIX VISION cannot guarantee that the data is free of errors or is accurate and complete and, therefore, assumes no liability for loss or damage of any kind incurred directly or indirectly through the use of the information of this document.
(http://www.libusb.org/), which comes under LGPL 2.1. The full license text is included in the Linux distribution of the \b 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 \a others/libusb).
Technical Manual 2.6.1 libusbK license APPLICABLE FOR ALL LIBUSBK BINARIES AND SOURCE CODE UNLESS OTHERWISE SPECIFIED. PLEASE SEE INDIVIDUAL COMPONENTS LICENSING TERMS FOR DETAILS. NOTE: Portions of dpscat use source code from libwdi which is licensed for LGPL use only. (See dpscat.c) NOTE: libusbK-inf-wizard.exe is linked to libwdi which is licensed for LGPL use only.
Technical Manual 2.9 minizip, zlib Parts of this framework make use of minizip (http://www.winimage.com/zLibDll/minizip.html) or zlib respectively. The Zlib library allows to deflate compressed files and to create gzip (.gz) files. Zlib is free software and small. The minizip package has been written by Gilles Vollant.
Technical Manual 2.11 OpenSSL OpenSSL is used to perform license authentification. 2.11.1 OpenSSL License Issues The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are BSD-style Open Source licenses.
Added accessory KS-BLX-PWR. 05 February 2014 1.42 Added use case for linescan mode. 04 December 2013 1.41 Added information about mvBlueLYNX-X option -xx9x (mvBlueLYNX-X without housing) in Technical Data. 29 November 2013 1.40 Corrected nomenclature concerning module version and added order sample.
Page 20
6 September 2012 1.17 Clarified view of connectors (top view) in Technical Data. 5 September 2012 1.16 Added new troubleshooting solution "mvBlueLYNX-X boots but there is no display". 3 September 2012 1.15 Added line number in Circular connector male. 17 August 2012 1.14...
Page 21
Eclipse 12 March 2012 Added frame rate benchmark of sensor -X102e (SXGA 1280 x 1024). Added description how to handle mvBlueLYNX-X as a peripheral device. 06 March 2012 Added note about the short circuit protection of the digital outputs in Characteristics of the digital outputs 01 March 2012 Added Installing the LiveDVD.
Page 22
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
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.
Page 24
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
• We cannot and do not take any responsibility for the damage caused to you or to any other equipment connected to the mvBlueLYNX-X. Similarly, warranty will be void, if a damage is caused by not following the manual. Handle the mvBlueLYNX-X with care. Do not misuse the mvBlueLYNX-X. Avoid shaking, striking, •...
If dust or other debris is located between the CCD and optical filter, consult dealer for cleaning by an optical technician. 5.3 European Union Declaration of Conformity statement The mvBlueLYNX-X is in conformity with all applicable essential requirements necessary for CE marking. It corresponds to the EU EMC guideline 2014/30/EU based on the following harmonized standards...
Page 27
Technical Manual MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 28
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Afterwards, it describes how to install and use software on the mvBlueLYNX-X followed by a general description about the software developement kit. A troubleshooting chapter shows how to detect damages and other inconveniences.
Page 30
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
A graphical user interface based on X window system called Enlightenment is provided. By connecting a standard VESA display (e.g. 1024 x 768 resolution, 24 bit color depths and 60 Hz), you can work with the mvBlueLYNX-X like any other PC with LINUX as operating system.
GenICam inside as a software API but does not have a Gigabit interface and does not use the GigE Vision® protocol over its Fast Ethernet interface. The following figure shows the software concept of the mvBlueLYNX-X and the other MATRIX VISION camera devices: Figure 2: Software concept of mvBlueLYNX-X As shown in figure 2 the mvIMPACT Acquire interface is stacked on the GenICam layer.
Page 33
8 = CS-Mount without back focus adjustment (portrait) The difference between (1) and (5), (2) and (6), (3) and (7) or (4) and (8) is the orientation of the sensor. Figure 3: mvBlueLYNX-X - "Landscape" orientation Figure 4: mvBlueLYNX-X - "Portrait" orientation MATRIX VISION GmbH...
-1111 is the standard delivery variant and for this reason it is not mentioned (see sample 1). 7.2 What's inside and accessories Due to the varying fields of application the mvBlueLYNX-X is shipped with following accessories: • mvBlueLYNX-X (2 in figure 5) •...
Page 35
Technical Manual Figure 5: mvBlueLYNX-X - recommended scope of the order Additionally, to use the mvBlueLYNX-X you will need at least: MV-DC1201 BLX IO (1 in figure 5, power supply with digital I/O on separate cable) • KS-BLX-VGA-USB 01.0 (3 in figure 5, VGA and USB "Y" cable) •...
Page 36
05.0 MICRO SD CARD External MicroSD memory card with 8 GB. MV-DC1201 BLX Power supply 12V for mvBlueLYNX-X with digital I/O on separate cable, length: power 3 m, I/O: 0.5 m 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
8 mm (9.5 mm with max. Ø 20 6 mm C-Mount CS-Mount approx. 15 mm (C-mount) approx. 10 mm (CS-mount) 17.526 mm (in air) 12.5 mm (in air) Figure 7: mvBlueLYNX-X dimensions and connectors order option -xx9x MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Technical Manual 8.3 Camera interfaces 8.3.1 Circular connector male (Power / Digital I/O) Figure 8: AlysiumTech 12-pin (male; top view), digital I/O, power Pin. Signal Line in Digital I/O color Color code of cable Pin. on the wxPropView code of power "KS-BLX-PWR"...
0 to +0.3 V Threshold (Low --> 2.5 V ± 0.5 V High / High --> Low) max. Figure 9: DigIn mvBlueLYNX-X 8.3.1.1.1 Delay Figure 10: DigIn mvBlueLYNX-X Delay Characteristics Symbol Test conditions Typ. Unit Turn-On time R = 2 kOhm, Output voltage...
• undervoltage detection • current limitation overtemperature protection • short circuit protection • 8.3.1.2.1 Delay Figure 12: DigOut mvBlueLYNX-X Delay Characteristics Symbol Typ. Unit Turn-On time Rise time Fall time Turn-Off time 8.3.1.2.2 Example circuit 1: High-side switch uses power supply of the camera...
Technical Manual Figure 13: Bridge circuit between Pin 2 and Pin 10 8.3.1.2.3 Example circuit 2: High-side switch uses external (higher) power supply Following figure shows, how to connect, for example, high power flash LEDs in series at the direct drive...
Page 43
Technical Manual Figure 15: AlysiumTech 12-pin (female; top view), VGA / USB Pin. Signal Pin. on the mainboard connection header USB host D- USB host D+ USB host V+ VGA HSync VGA B VGA R VGA G VGA VSync...
Technical Manual 8.3.3 Circular connector female (Digital I/O; via add-on board BLX-IO) With the order reference "BLX-IO", the mvBlueLYNX-X can be extended by additional digital inputs and outputs. Figure 16: AlysiumTech 6-pin (female; top view), Digital I/O Pin. Signal...
Technical Manual Figure 17: wxPropView - setting the addiitional digital I/Os As shown in the figure, via LineMode you can set the mode of the I/O - either Output or Input. When choosing Input, you can set the mv Input Threshold either to TTL or PLC.
Using a USB "B" adapter or cable the OTG port will act like a peripheral device and may be used, for example, for Ethernet-via-USB. To use the mvBlueLYNX-X as a peripheral device as described in the second point, you will need a configuration file usb-gagdet in /etc/default/.
If you want to have read/write access to userdata.disk on the mvBlueLYNX-X, you have to be sure that the resource is not used on the host PC. Disconnect the mvBlueLYNX-X from the host PC and mount the resource on the mvBlueLYNX-X locally: mkdir -p /media/disk mount -n -t vfat -o loop userdata.disk /media/disk...
The µSD card slot supports cards of up to 32 GB capacity. You can easily damage the µSD card or the mechanics of the mvBlueLYNX-X by improper operation. Please be careful when inserting, removing, or handling the µSD card. Keep the µSD card at right angles to the backplate when inserting it into the slot! 8.3.7 Power LED...
Page 49
Technical Manual > "0" (turn on). E.g.: echo 1 > /sys/devices/virtual/leds/mvblx\:red\:usr1/brightness echo 0 > /sys/devices/virtual/leds/mvblx\:red\:usr1/brightness There is also a pseudo file called trigger: root@mvblx:~# cat /sys/devices/virtual/leds/mvblx\:red\:usr1/trigger [none] mmc0 mmc1 timer heartbeat backlight gpio default-on You can write one of these key values after trigger. E.g.: echo "heartbeat"...
Page 50
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
The ADC resolution 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 phases: Trigger Exposure Readout Figure 21: CCD timing - TriggerOverlap MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Technical Manual In the Trigger Overlap ReadOut mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout 9.2.1.1 Trigger When coming out of reset or ready with the last readout the CCD controller is waiting for a Trigger signal.
Technical Manual TriggerSelector = FrameStart TriggerMode = On TriggerSource = TriggerActivation = RisingEdge ExposureMode = Timed OnHighExpose TriggerSelector = Each rising edge of trigger signal acquires one image, integration time corresponds to pulse width. FrameStart TriggerMode = On TriggerSource =...
Technical Manual Figure 22: Spectral sensitivity mvBlueLYNX-X120aG 9.2.2.1.1.2 Color model Figure 23: Spectral sensitivity mvBlueLYNX-X120aC 9.2.2.1.2 Timings Name Description Pixel clock 24.54 MHz 32 MHz 40 MHz Time from trigger (internal or = approx. 2µs) trig trig vshift turn_on_delay_opto...
Page 56
Technical Manual t_readout < t_exposure: FPS_max = --------------- t_exposure t_readout > t_exposure: FPS_max = --------------- t_readout Example: Frame rate as function of lines & exposure time Now, when we insert the values using exposure time of, for example, 8000 us, 480 lines and 40MHz pixel...
Technical Manual 9.2.2.2 mvBlueLYNX-X120b (VGA 640 x 480) Feature Description Manufacturer Sony Sensor name ICX414AL/AQ Max. frames per second Device Interline CCD image sensor with Had microlens Structure Image size Diagonal 6mm (Type 1/2) Number of 659 (H) x 494 (V) approx. 330K pixels...
Technical Manual Figure 24: Spectral sensitivity mvBlueLYNX-X120bG 9.2.2.2.1.2 Color model Figure 25: Spectral sensitivity mvBlueLYNX-X120bC 9.2.2.2.2 Timings Name Description Pixel clock 24.54 MHz 32 MHz 40 MHz Time from trigger (internal or = approx. 2µs) trig trig vshift turn_on_delay_opto...
Page 59
Technical Manual t_readout < t_exposure: FPS_max = --------------- t_exposure t_readout > t_exposure: FPS_max = --------------- t_readout Example: Frame rate as function of lines & exposure time Now, when we insert the values using exposure time of, for example, 8000 us, 480 lines and 40MHz pixel...
Technical Manual 9.2.2.3 mvBlueLYNX-X120d (SVGA 776 x 580) Feature Description Manufacturer Sony Sensor name ICX415AL/AQ Max. frames per second Device Interline CCD image sensor with Had microlens Structure Image size Diagonal 6mm (Type 1/2) Number of 782 (H) x 582 (V) approx. 460K pixels...
Technical Manual Figure 26: Spectral sensitivity mvBlueLYNX-X120dG 9.2.2.3.1.2 Color model Figure 27: Spectral sensitivity mvBlueLYNX-X120dC 9.2.2.3.2 Timings Name Description Pixel clock 29.5 MHz 48 MHz Time from trigger (internal or trig trig vshift external) to exposure start = approx.
Page 62
Technical Manual t_readout < t_exposure: FPS_max = --------------- t_exposure t_readout > t_exposure: FPS_max = --------------- t_readout Example: Frame rate as function of lines & exposure time Now, when we insert the values using exposure time of, for example, 8000 us, 580 lines and 48MHz pixel...
Technical Manual 9.2.2.4 mvBlueLYNX-X122 (SXGA 1280 x 960) Feature Description Manufacturer Sony Sensor name ICX445ALA/AQA Max. frames per second Device Interline CCD image sensor with ExViewHad microlens Structure Image size Diagonal 6mm (Type 1/3) Number of 1296 (H) x 966 (V) approx. 1.25M pixels...
Technical Manual Figure 28: Spectral sensitivity mvBlueLYNX-X122G 9.2.2.4.1.2 Color model Figure 29: Spectral sensitivity mvBlueLYNX-X122C 9.2.2.4.2 Timings Name Description Pixel clock 36 MHz 50 MHz Time from trigger (internal or = approx. 2µs) trig trig vshift turn_on_delay_opto turn_on_delay_opto external) to exposure start Time after a new trigger is <...
Page 65
Technical Manual t_readout < t_exposure: FPS_max = --------------- t_exposure t_readout > t_exposure: FPS_max = --------------- t_readout Example: Frame rate as function of lines & exposure time Now, when we insert the values using exposure time of, for example, 8000 us, 960 lines and 50MHz pixel...
Technical Manual Figure 30: Spectral sensitivity mvBlueLYNX-X123G 9.2.2.5.1.2 Color model Figure 31: Spectral sensitivity mvBlueLYNX-X123C 9.2.2.5.2 Timings Name Description Pixel clock 28 MHz 56 MHz Time from trigger (internal or = approx. 2µs) trig trig vshift turn_on_delay_opto turn_on_delay_opto external) to exposure start Time after a new trigger is <...
Page 68
Technical Manual (Expose mode: Overlapped): t_readout < t_exposure: FPS_max = --------------- t_exposure t_readout > t_exposure: FPS_max = --------------- t_readout Example: Frame rate as function of lines & exposure time Now, when we insert the values using exposure time of, for example, 8000 us, 1024 lines and 56MHz pixel...
Technical Manual Figure 32: Spectral sensitivity mvBlueLYNX-X124G 9.2.2.6.1.2 Color model Figure 33: Spectral sensitivity mvBlueLYNX-X124C 9.2.2.6.2 Timings Name Description Pixel clock 36 MHz 56 MHz 65 MHz Time from trigger (internal or = approx. 2µs) trig trig vshift turn_on_delay_opto...
Page 71
Technical Manual (Expose mode: Overlapped): t_readout < t_exposure: FPS_max = --------------- t_exposure t_readout > t_exposure: FPS_max = --------------- t_readout Example: Frame rate as function of lines & exposure time Now, when we insert the values using exposure time of, for example, 8000 us, 1024 lines and 56MHz pixel...
Technical Manual 9.2.2.7 mvBlueLYNX-X125a (5 Mpix 2448 x 2050) Feature Description Manufacturer Sony Sensor name ICX655ALA/AQA Max. frames per second Device Interline CCD image sensor with SuperHad microlens Structure Image size Diagonal 11.016mm (Type 2/3) Number of 2456 (H) x 2058 (V) approx. 5.05M pixels...
Technical Manual 9.2.2.7.1.2 Color model Figure 35: Spectral sensitivity mvBlueLYNX-X125aC 9.2.2.7.2 Timings Name Description Pixel clock 60 MHz 66 MHz Time from trigger (internal or trig trig vshift external) to exposure start = approx. turn_on_delay_opto turn_on_delay_opto 2µs) Time after a new trigger is <...
Page 74
Technical Manual (Expose mode: Overlapped): t_readout < t_exposure: FPS_max = --------------- t_exposure t_readout > t_exposure: FPS_max = --------------- t_readout Example: Frame rate as function of lines & exposure time Now, when we insert the values using exposure time of, for example, 8000 us, 1024 lines and 56MHz pixel...
Erase, exposure and readout 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 support the following trigger modes: Mode / Setting Setting (GenICam) Description...
Page 76
Technical Manual TriggerSource = TriggerActivation = LevelLow ExposureMode = Timed OnHighLevel As long as trigger signal is High camera acquires images with TriggerSelector = own timing. FrameStart TriggerMode = On TriggerSource = TriggerActivation = LevelHigh ExposureMode = Timed OnHighExpose TriggerSelector = Each rising edge of trigger signal acquires one image, integration time corresponds to pulse width.
Technical Manual 9.3.1.2.1.1 Example External synchronized image acquisition (high active) Trigger modes • ♦ OnHighLevel: The high level of the trigger has to be shorter than the frame time. In this case, the sensor will make one image exactly. If the high time is longer, there will be images with the possible frequency of the sensor as long as the high level takes.
Technical Manual 9.3.2 Models 9.3.2.1 mvBlueLYNX-X100w (WVGA 752 x 480) The sensor uses a full frame shutter (ShutterMode = FrameShutter), i.e. all pixels are reset at the same time and the exposure commences. It ends with the charge transfer of the voltage sampling.
Technical Manual 9.3.2.1.1.2 Color model Figure 38: mvBlueLYNX-X100wC 9.3.2.1.2 Timings Name Description Pixel clock 27 MHz 40 MHz 50 MHz Horizontal blank Vertical blank 9.3.2.1.2.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula:...
Technical Manual 9.3.2.2 mvBlueLYNX-X102b (SXGA 1280 x 960) The sensor uses a pipelined global snapshot shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential. Feature Description Manufacturer Aptina Sensor name MT9M021 Max. frames 40.6...
Technical Manual 9.3.2.2.1.2 Color model Figure 40: mvBlueLYNX-X102bC 9.3.2.2.2 Timings Name Description Pixel clock 40 MHz 66 MHz Line 1650 Vertical blank 9.3.2.2.2.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula:...
Page 82
Technical Manual ----------------------------------- FrameTime + ExposureTime / 1000000 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Technical Manual 9.3.2.3 mvBlueLYNX-X102e (SXGA 1280 x 1024) The sensor uses a full frame shutter (ShutterMode = FrameShutter), i.e. all pixels are reset at the same time and the exposure commences. It ends with the charge transfer of the voltage sampling.
Technical Manual 9.3.2.3.2 Timings Name Value InternalLineLength InternalADCClock 118.75 9.3.2.3.2.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: ReadOutTime = RowTime * (ImageHeight + 10) / 1000...
Page 85
Technical Manual Finally, in Setting -> Base -> Camera -> GenICam -> Acquisition Control, please adapt the Exposure Time. For high linescan rates the exposure time has to be proportionally low. To achieve the maximum linescan rate of 12.6 kHz (gray scale sensor) the exposure time has to be set to approx. 60 us.
Technical Manual 9.3.2.4 mvBlueLYNX-X105 (5MP 2592 x 1944) This sensor uses two acquisition modes: • rolling shutter (ShutterMode = ElectronicRollingShutter) and • global reset release shutter (ShutterMode = GlobalResetRelease). With the rolling shutter the lines are exposed for the same duration, but at a slightly different point in time: Figure 44: CMOS sensor -X105 - rolling shutter Moving objects together with a rolling shutter can cause a shear in moving objects.
Technical Manual Figure 46: CMOS sensor -X105 - global reset release dig I/O settings In this case, DigOut0 gets a high signal as long as the exposure time (which is synchronized with the GlobalResetRelease). This signal can start a flash light.
Technical Manual Figure 48: Spectral sensitivity mvBlueLYNX-X105C 9.3.2.4.2 Timings Name Description Pixel clock 40 MHz 80 MHz Vertical blank Line 1900 9.3.2.4.2.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula:...
10 Filter and Lenses 10.1 Filters MATRIX VISION offers three filters for the mvBlueLYNX-X camera. The hot mirror filter is part of the standard delivery condition. 10.1.1 Hot mirror filter The hot mirror filter FILTER IR-CUT 20X1 FE has great transmission in the visible spectrum and blocks out a significant portion of the IR energy.
Surface quality polished on both sides P4 Surface 5/3x0.06 on both sides irregularity 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@matrix-vision.com. 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
MATRIX VISION offers special single level µSD cards. These cards allow more write and read cycles than typical multi level cards. If you think the internal µSD card in not working properly, please have a look at the Troubleshooting section.
(You might need to install setxkbmap from the stable feed like this: opkg install setxkbmap) 11.4 VGA resolution By default, the mvBlueLYNX-X has been pre-configured at a resolution of 1024 x 768 pixels, 24 bit @ 60 Hz. DDC - I²C lines are available, however, they are not used for the automatic resolution detection.
Page 93
(e.g. like this: iface static loopback dhcp) before rebooting. Alternatively, use zeroconf networking. In this case the mvBlueLYNX-X will use an IP address in the range 169.254.0.0/255.255.0.0 if it cannot obtain a dynamic address from a DHCP server. It is not possible to wake up the mvBlueLYNX-X using wake-on-LAN magic network packets.
11.6.1 Powering Down The Camera The mvBlueLYNX-X is a small computer with a file system stored on µSD card. Just like desktop PCs it usually makes sense to power down the camera in a controlled manner instead of removing power suddenly.
Linux or Windows PC's. By default, the X11Forwarding is disabled. To use this functionality, you have to Edit the file /etc/ssh/sshd_config on the mvBlueLYNX-X. Change the line X11Forwarding no to read X11Forwarding yes Now create an empty authority file: touch /home/root/.Xauthority...
- XForwarding on Windows 11.8 FTP By default, the mvBlueLYNX-X provides ftp connections with SSH encryption (pre-installed ipk package openssh-sftp-server). However, if you want to use another ftp server like vsftpd, you install the ipk package like this (with sensible...
//triton/vision /mnt -o user=myuser,pass=mypass In the example above //triton/vision is the name of the Windows® PC and shared resource and /mnt is the mount point on the mvBlueLYNX-X. Username and password are given using the options shown above. Please substitute your own values.
<!-- find all removable, hotpluggable USB devices that contain a valid, known filesystem and force the volume's label to a be a known name - this will determine the mountpoint under /media MATRIX VISION / GRA 12.12.2011 --> <deviceinfo version="0.2">...
Technical Manual Figure 51: Application Menu Here you can enter the details for any application, choose an icon etc. Applications entered here can be added to menus or used as autostart applications (see below). Desktop files will be stored in the directory /usr/share/applications and have the file extension .desktop .
Technical Manual Figure 52: Autostart Application Menu Here you can add any known applications (i,e, those with *.desktop files, see above) and also determine their order. The list of autostart applications is stored in the file /home/root/.e/e/applications/startup/.order, which will be created by the GUI.
USB 2.0 hub or connect the mouse to the second USB port (OTG port) in host mode with an adapter. The mini-USB "A" plug tells the mvBlueLYNX-X to work in host mode. Use a USB-OTG type "A" adapter (Hama type numbers: 00041848 or 00074214) e.g.
Technical Manual The mvBlueLYNX-X has been pre-configured at a resolution of 1024 x 768 pixels @ 60 Hz. Almost all standard computer monitors will support this video signal. Other resolutions are possible. See VGA resolution for more details. The following description relates to the MATRIX VISION's recommended equipment.
Page 103
Figure 54: mvBlueLYNX-X OS - start window For 10 seconds, you will see the current IP address of the mvBlueLYNX-X. You can use this IP address to connect to the mvBlueLYNX-X remotely using a VNC viewer. Working remotely, you will not need an analog VGA monitor, USB keyboard and USB mouse anymore.
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 number LX..) and click Use. Now, select the Acquisition Mode e.g. SingleFrame.
Page 105
Technical Manual Figure 57: mvBlueLYNX-X OS - wxPropView If you are using a camera with a high resolution sensor and particularly if it is a color sensor you will notice that wxPropView will show live images at a rate much slower than expected. This is due to the complexity of converting and displaying large amount of image data on such a small machine.
(if existing). So when the user is currently working with a device LX000001 belonging to the product group mvBlueLYNX-X and there is a setting exclusively for this device storing a product specific setting now will automatically delete the setting for LX000001. Otherwise a product specific setting would never be loaded as a device specific setting will always be found first.
Page 107
Technical Manual Whenever storing a device family specific setting, the device specific or product specific setting of the device used for storing will be deleted (if existing). See above to find out why. XML files are the only setting formats understood by the driver framework thus here the driver will also look for them at startup.
Page 108
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
By default, the Opkg configuration files are set to this stable feed on our website: • http://beta.matrix-vision.com/mvblx-feed/stable/. 13.1.1 Changing the feed location To change the feed the mvBlueLYNX-X should use, you have to set the config files in the /etc/opkg/ folder: matrix@mvblx:~$ ls -l /etc/opkg/ total 40...
13.2.1 Updating the mvBlueLYNX-X Please follow these steps to update the mvBlueLYNX-X: The mvBlueLYNX-X should have access to the internet, if you want to use MATRIX VISION's stable feed. You may have to set up proxy details as described above.
The full list of installed packages can be seen by using the list mentioned above. 13.3.1 mvIMPACT Acquire Packages In order for the mvBlueLYNX-X to work as a camera a number of preinstalled packages are essential. Whilst these may be updated to newer versions, they should never be uninstalled completely.
GUI tool to acquire images and to configure the device and to display and modify the device properties of MATRIX VISION GmbH hardware. It is possible to start the wxPropView via the Favorite Applications menu (left-click with the mouse anywhere on the desktop) or with right-click on the desktop directly.
- Introduction To explain the features in the webcasts, other products then mvBlueLYNX-X were used. However, wxPropView is a tool for all MATRIX VISION hardware, for this reason the explained workflows are suitable to mvBlueLYNX-X. 13.4.1.1 How to work with wxPropView...
Technical Manual • Status Tool Bar • Main Window with ♦ Grid (tree control with the device settings accessible by the user) ♦ Display (for the acquired images) ♦ Analysis (information about whole images or an AOI) By clicking on F1 you will get the HELP dialog.
Technical Manual mvBlueCOUGAR-XD). • As Default Settings For All Devices Belonging To The Same Family And Product Type: As the start-up parameters for every device belonging to the same family and product type (e.g. mvBlueCOUGAR-X). • As Default Settings For This Device(Serial Number): As the start-up parameters for this device.
Technical Manual Figure 62: wxPropView - Restore the default value of a property 13.4.1.1.3 Methods Method appears as entries in the tree control as well. However, their name and behavior differs significantly from the behavior of properties. The names of method objects will appear in 'C' syntax like e.g. "int function( char*, int )".
Technical Manual • select Copy grid to clipboard from the pop up menu. Figure 64: wxPropView - Copying grid_data to the clipboard 13.4.1.1.5 Import and Export images wxPropView offers a wide range of image formats that can be used for exporting captured image to a file.
As described above, after the device has been initialized successfully 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 it! wxPropView - Configuring a device 13.4.1.2.1 How to see the first image...
Technical Manual Three different acquisition modes are available: Continuous ("Live Mode") MultiFrame ("Number of Single Snaps") SingleFrame ("Single Snap") The frame rate depends on • the camera, • the pixel clock of the sensor and • the Acquisition Frame Rate.
Technical Manual Figure 69: wxPropView - White balance summary 13.4.1.2.2.1 White balance with pixel format YUV422Packed? With pixel format YUV422Packed the debayering is hardware based. For this reason a host-based white balancing as described above is not possible. In this case you have to adjust the settings of mv OMAP...
13.4.1.2.5 Saving user settings in the non-volatile flash memory The mvBlueLYNX-X camera offers the possiblity, to save up to 4 user sets in the camera's flash memory directly. This means that all camera specific settings you've adjusted via wxPropView can be saved in a non-volatile memory.
Page 123
Technical Manual To save your specific settings, set your properties in the Setting -> Camera -> GenICam section of wxPropView. Then, select in User Set Control your user set with the User Set Selector, for example UserSet1. Afterwards, save the user 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).
Page 124
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
14 GenICam and Advanced Features 14.1 Introduction The GenICam interface layout - the standard interface layout of the mvBlueLYNX-X - allows the most flexible access to the features of the mvBlueLYNX-X. By default the In wxPropView, you can see all GenICam controls of the device in Setting -> Base -> Camera -> GenICam: Figure 73: wxPropView - GenICam controls As you can see, there are some controls with and without the prefix mv.
DeviceClockSelector deviceClockSelector Selects the clock frequency to access from the device DeviceScanType deviceScanType Scan type of the sensor of the device. etc. related to the device and its sensor. MATRIX VISION offers also some information properties about the • mvDeviceSensorName • mvDeviceSensorColorMode 14.1.2 Image Format Control The "Image Format Control"...
Page 127
ExposureMode is Timed and ExposureAuto is Off. ExposureAuto exposureAuto Sets the automatic exposure mode when ExposureMode is Timed. etc. related to the image acquisition, including the triggering mode. Additionally, MATRIX VISION offers numerous additional features like: MATRIX VISION GmbH 22 April 2016 Version - 1.49...
14.1.4 Counter And Timer Control The "Counter And Timer Control" is a powerful feature which MATRIX VISION customers already know under the name Hardware Real-Time Controller (HRTC). mvBlueLYNX-X provides: • 4 counters for counting events or external signals (compare number of triggers vs. number of frames;...
Technical Manual 14.1.5 Analog Control The "Analog Control" contains features like Feature name (acc. to SFNC) Property name Description (acc. to mvIMPACT Acquire) GainSelector gainSelector Selects which Gain is controlled by the various Gain features. Gain[GainSelector] gain Controls the selected gain as an absolute physical value.
Technical Manual 14.1.8 mv X Lamp Control The "mv X Lamp Control" contains features like Feature Property name (acc. to Description name (acc. mvIMPACT Acquire) to SFNC) mvXLampSource Is the "flash" signal. When it is high, all flash LEDs are on which have been enabled.
Customers can install the SDK on a Linux PC and build applications for the mvBlueLYNX-X with the SDK ("cross-compiling"). It is not necessary to install and use a full OpenEmbedded build system. However, these libraries are also available in IPK packages to be used on the mvBlueLYNX-X from our web feed: •...
15.4 Usage 15.4.1 Makefiles Linux applications that are built using GNU-make can usually be "crosscompiled" for the mvBlueLYNX-X without any great problems. Normally it is only necessary to ensure that a few environment variables contain the name of the new compiler and that the directory mentioned above is part of the PATH variable.
In order that user applications stay as compatible as possible to the preinstalled OpenEmbedded libraries, you should try to use the same compiler flags and options that OpenEmbedded / Ångström uses. These are the C / C++ used for the mvBlueLYNX-X, listed as they appear in Eclipse: 15.5.1.1 Cross G++ Compiler -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp 15.5.1.2 Optimization...
Technical Manual 15.5.3.1 Compiler `/usr/local/angstrom/arm/arm-angstrom-linuxgnue-abi/usr/bin/fltk-config --cxxflags` 15.5.3.2 Linker `/usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/usr/bin/fltk-config --ldflags` 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 --cxxflags` 15.5.4.2 Linker `/usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/usr/bin/wx-config --static=no --libs` 22 April 2016 Version - 1.49...
16 mvBlueLYNX-X - LiveDVD and Virtual Machine 16.1 Introduction Since the mvBlueLYNX-X has an Embedded Linux as its operating system, you will need to install a suitable development environment based on Linux with all the software needed, like mvIMPACT Acquire, in order to develop software applications.
If you intend to setup a dual-boot system instead of using a virtual machine then please skip this section and proceed to Starting_the_LiveDVD. mvBlueLYNX-X - Installing LiveDVD ISO on virtual machine 16.2.1 Creating a VirtualBox Virtual Machine image These instructions refer to VirtualBox version 4.1.6. Later versions may look different.
Page 137
Technical Manual Figure 75: VirtualBox - New A software wizard will start. Figure 76: VirtualBox - Wizard Click on Next >. Then, enter a Name for your image and select Linux as Operating System and Ubuntu as Version and MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 138
Technical Manual click on Next > again. Figure 77: VirtualBox - Name and OS Set the memory to 512 MB. Figure 78: VirtualBox - Main memory Now, activate Start-up Disk and Create new hard disk. 22 April 2016 Version - 1.49...
Page 139
Technical Manual Figure 79: VirtualBox - Hard disk Confirm the next dialog by clicking Continue. Figure 80: VirtualBoxVirtual - Warning Afterwards, you have to set the virtual disk. Choose VDI (VirtualBox Disk Image) and click on Next >. MATRIX VISION GmbH...
Page 140
Technical Manual Figure 81: VirtualBox - Virtual Disk Creation Select Dynamically allocated and click on Next >. Figure 82: VirtualBox - Storage Details Enter the size of the Virtual Disk. We recommend 15 GB. 22 April 2016 Version - 1.49...
Page 141
Technical Manual Figure 83: VirtualBox - Disk Size Finally, click on Create. Figure 84: VirtualBox - Create You will see the new created VirtualBox manager. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
If you intend to use the VM's network, in particular if you want to access the VM from the mvBlueLYNX-X by mounting an NFS share, you should change the type of networking device from NAT to Bridged Adapter for the VM.
Page 143
Technical Manual Figure 86: VirtualBox - First Run Wizard Select the mvBlueLYNX-X LiveDVD .iso in the Media Source and click on Next >. Figure 87: VirtualBox - Media Source Afterwards, click on Start. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Technical Manual Figure 88: VirtualBox - Start Now, the LiveDVD will start in the Virtual 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.
Technical Manual Figure 89: Boot menu - Live System After booting, first of all please have a look at the Readme.first file, which can be found on the desktop of the Virtual Machine. 16.2.4 Working with the Virtual Machine image The Virtual Machine is a complete operating system and can be used like a normal PC.
Whilst Ubuntu's installer is very good at setting up dual-boot systems, if you install the mvBlueLYNX-X development system on a real PC then you do it at your own risk. MATRIX VISION cannot be held responsible for the loss of any data on this PC.
Download the current mvIMPACT SDK 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 number like this: mvIMPACT-6.6.0.5794-18299-armv7a.tgz...
17.4.2 Licenses All mvIMPACT modules except mvIMPACT Base require the installation of a license file. mvIMPACT Base is free with any MATRIX VISION hardware. The license file must be copied to the following directory: /etc/matrix-vision/impact/license Make sure the license file is world-readable, if it is not open a root console and type: chmod a+r /etc/matrix-vision/impact/license/[name of license file].reg...
Eclipse. 18.2 Requirements If you want to import and run the samples from the CD/DVD or if you want to develop mvBlueLYNX-X applications, you first have to check if your Eclipse version has the required plugins/software. If you want to use the Virtual Machine for developing all required plugins are already installed.
Page 150
Technical Manual Figure 91: Eclipse - Open Preferences Select General -> Network Connections. 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Figure 92: Eclipse - Enable UI Prompt and change password Change the Proxy entries to your needs and Add the IP address of your mvBlueLYNX-X to Proxy bypass. Again, click on Apply and Ok. 18.3.2 Installing new plugins / software in Eclipse...
Page 152
Technical Manual Figure 93: Eclipse - Install New Software... Select the download source e.g. Indigo - http://download.eclipse.org/releases/indigo/ from the dropdown menu: 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Technical Manual Figure 94: Eclipse - Download source Select the needed plugins. Now, always choose Next and Accept the license, when your asked to do so. In the last dialog click Finish an wait for the plugins to be installed.
Page 154
Technical Manual Figure 95: Eclipse - Import a project select Import..Then select Existing Projects ino Workspace and click Next >. 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Page 155
Technical Manual Figure 96: Eclipse - Select import type Now, activate the radio button Select archive file and browse the MATRIX VISION sample .tgz file. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Technical Manual Figure 97: Eclipse - Select source Finally, click on Finish. You should be able to open the project and check, for example, the Properties (Right-click on the project in the Project Explorer), if every required plugin / software was installed successfully.
Page 157
Technical Manual Figure 98: Eclipse - Create a SSH connection Select Remote Systems. Figure 99: Eclipse - Remote Systems Define a connection to remote system by clicking on the icon as shown in the figure. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 158
Technical Manual Figure 100: Eclipse - Define a connection to remote system Then, in the New Connection dialog select SSH Only. 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Page 159
Technical Manual Figure 101: Eclipse - SSH Only Afterwards, enter the connection information. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 160
Technical Manual Figure 102: Eclipse - Connection 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... : 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Page 161
You have to enter the User ID and Password. User ID: root Password: matrix Figure 104: Eclipse - mvBlueLYNX-X login You are now connected to the mvBlueLYNX-X. You can now launch a Terminal window: MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 162
Technical Manual Figure 105: Eclipse - Launch a Terminal The Terminal window shows you the mvBlueLYNX-X prompt: 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Page 163
Figure 106: Eclipse - Terminal window You can 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: MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Native Native Debug mvBL-X is meant to run on the mvBlueLYNX-X. Native means that it is for the Linux OS of the Virtual Machine, for example, in combination with a mvBlueCOUGAR. 18.3.5.1 Using Sftp (copying the binary to the mvBlueLYNX-X physically) To run a MATRIX VISION sample using Sftp, first you have to build it: Click, for example, on LiveSnap ->...
Page 165
Technical Manual Click on the "hammer icon". Figure 108: Eclipse - Building a sample After building, copy the binary of the sample per drag & drop on the mvBlueLYNX-X. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 166
Technical Manual Figure 109: Eclipse - Copying the sample to the mvBlueLYNX-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 22 April 2016 Version - 1.49...
Page 167
Technical Manual Figure 110: Eclipse - Running the sample to the mvBlueLYNX-X If you see the message ./LiveSnap: Permission denied you have to adjust the rights of the file and make it executable. For this, please use the command chmod a+x LiveSnap.
18.3.5.2 Using NFS mount (mounting a directory in mvBlueLYNX-X) A second way to run and debug the samples remotely is to make the files available to mvBlueLYNX-X via NFS mount. Therefore export your workspace in the NFS configuration /etc/exports like the following way: On the machine with your IDE, open a terminal shell (Applications ->...
18.3.6 Debugging a MATRIX VISION sample For debugging, you may use the gdb GNU project debugger either directly on the mvBlueLYNX-X camera using the native version of gdb, or remotely on your development system or virtual machine. MATRIX VISION GmbH...
18.3.6.1 Debugging a sample on the mvBlueLYNX-X itself To debug a program directly on the camera you have to install the gdb debugger on the mvBlueLYNX-X (see above): Important is the init file .gdbinit for the gdb-debugger. In this file set the path to libraries for the arm crosscompiler/linker.
Page 171
Figure 114: Eclipse - Run Configurations Now, right-click on C/C++ Remote Application -> New and edit the following settings: Connection: Select the IP address of your mvBlueLYNX-X camera. Project: Click on Browse... and select the project e.g. LiveSnap. C/C++ Application: Click on Search Project... and choose e.g. arm - /LiveSnap/mvBL-X Debug/LiveSnap as Qualifier.
Page 172
Technical Manual Figure 115: Eclipse - Run Configurations Afterwards, you can check the configuration by clicking on Run. If the Run works you can now enter the debug configuration settings. Open Run -> Debug Configurations..Select your configuration e.g. LiveSnap mvBL-X and select in the right window the Debugger tab.
Page 173
Technical Manual Figure 116: Eclipse - Run Configurations Finally, you can debug by clicking on Debug. The debugger will be opened in a special environment: MATRIX VISION GmbH 22 April 2016 Version - 1.49...
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 ->...
Page 175
Technical Manual Figure 118: Eclipse - New C++ Project In the C++ Project Dialog, enter the Project name e.g. HelloWorld, select as Project type Hello World C++ Project and select as Toolchains Linux GCC (we will change the toolchain for cross developing later).
Page 176
Technical Manual Figure 119: Eclipse - Enter global settings Afterwards, 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 select Properties. 22 April 2016 Version - 1.49...
Page 177
Technical Manual Figure 120: Eclipse - Properties First of all, change the Tool Chain Editor to Cross GCC. Figure 121: Eclipse - Changing the toolchain Then, select in Discovery Options -> Tools the Cross G++ Compiler and MATRIX VISION GmbH...
Page 178
Technical Manual change the Compiler invocation command to arm-angstrom-linux-gnueabi-g++. Figure 122: Eclipse - Compiler invocation command Now, select Settings -> Cross Settings and enter in Prefix arm-angstrom-linux-gnueabi- and in Path /usr/local/angstrom/arm/bin. 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Page 179
Technical Manual Figure 123: Eclipse - Cross Settings Afterwards, you can enter the settings as listed in chapter Compiler Flags and Options. That means Nothing in Settings -> Cross G++ Compiler -> Preprocessor. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 180
Technical Manual Figure 124: Eclipse - Preprocessor In Settings -> Cross G++ Compiler -> Includes add the include path to mvIMPACT Acquire /usr/local/angstrom/arm/arm-angstrom-linux-gnueabi/usr/include/ mvimpact-acquire. Figure 125: Eclipse - mvIMPACT Acquire included In Settings -> Cross G++ Compiler -> Optimization select Optimize more (-O2).
Page 181
Technical Manual Figure 126: Eclipse - Optimization In Settings -> Cross G++ Compiler -> Debugging select None as the Debug Level. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 183
Technical Manual Figure 129: Eclipse - Miscellaneous Now, if 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 MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 184
Technical Manual Figure 130: Eclipse - Summary In the last step, add in Settings -> Cross 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 mvDeviceManager 22 April 2016 Version - 1.49...
Page 185
Technical Manual Figure 131: Eclipse - Libraries As a test, you can include the mvIMPACT_acquire header MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 186
Technical Manual Figure 132: Eclipse - Libraries and try to run the sample as described in Running a MATRIX VISION sample. You can also try this remotely. 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Linux. 19.2.2 Target System 19.2.2.1 mvBlueLYNX-X To run the .NET samples on the mvBlueLYNX-X you also have to install the mono and mvIMPACT Acquire .NET IPK packages: opkg install mono opkg install mvimpact-acquire-dotnet MATRIX VISION GmbH 22 April 2016 Version - 1.49...
To track down compatibility issues, you can use the Mono Migration Analyzer a.k.a. MoMA (http://www.mono-project.com/MoMA). It does not make sense to call the MATRIX VISION support concerning running poblems as long as the Mono Migration Analyzer ejects errors or failures.
Technical Manual [2]: VD000002(VirtualDevice, family: mvVirtualDevice) Please enter the number in front of the listed device followed by [ENTER] to open it: In the same way, you can generate binaries using Linux or the LiveDVD and Virtual Machine: Assuming the current directory contains the source files for the applications, you can build them using the mono command line compiler gmcs: gmcs ContinuousCapture.cs...
Page 190
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
CPU platform. So it is recommended 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 display so that you will only get the timings for the acquisition itself.
Page 192
Technical Manual Figure 135: Starting an acquisition after one trigger event Figure 136: Starting an acquisition after a second trigger event For this scenario, you have to use the Setting -> Base -> Camera -> Acquisition Control -> Trigger Selector AcquisitionStart.
Afterwards, the camera will start grabbing with a rising edge at line 5 after rising edge at line 4. 20.3 Controlling external strobe or flash Of course, the mvBlueLYNX-X supports strobe or flash lights. However, there are several things you have to keep in mind when using strobes or flash: Be sure that the illumination fits with the movement of the device under test.
Technical Manual Figure 138: Setting the "Line Soruce" to "mvExposureAndAcquisitionActive" This can be combined using an external trigger. 20.3.1 Compensating delay of strobe or flash Normally, the input circuitry of flash has a delay (e.g. low pass filtering). Using ExposureActive to fire strobe would actually illuminate delayed with respect to exposure of the sensor.
Technical Manual Figure 140: Working with Timer and "Trigger Delay" 20.4 Using the HDR mode with sensor -x00w The HDR (High Dynamic Range) mode of the sensor -x00w increases 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.
Technical Manual Figure 141: Diagram of the -x00w sensor's HDR mode 20.4.2 Description • Phase 0 ♦ During T1 all pixels are integrated until they reach the defined signal level of Knee Point 1. ♦ If one pixel reaches the level, the integration will be stopped.
Technical Manual Figure 142: Integration time of different bright pixels In the diagram you can see the signal line of three different bright pixels. The slope depends of the light intensity , thus it is per pixel the same here (granted that the light intensity is temporally constant). Given that the very light pixel is limited soon at the signal levels S1 and S1, the whole integration time is lower compared to the dark pixel.
Technical Manual Figure 143: Multiple exposure capture using 3 different exposure times The longest exposure time (T1) represents the Exposure_us parameter you can set in wxPropView. Afterwards, the signal is fully linearized before going through a compander to be output as a piece-wise linear signal.
Technical Manual 20.5.1.2 Possible settings Possible settings of the mvBlueFOX-x02d in HDR mode are: • HDREnable ♦ Off: Standard mode ♦ On: HDR mode on, reduced amplification ◊ HDRMode: ⋅ Fixed: Fixed setting with exposure-time-ratios: T1 -> T2 ratio / T2 -> T3 ratio ⋅...
The pulse can be connected to a digital output. The digital output can be connected digital to the digital input of one or more cameras to use it as a trigger. The section Using a mvBlueFOX-MLC USB 2.0 camera with mvBlueLYNX-X shows how you can use the mvBlueFOX-MLC as a second image acquisition device.
Technical Manual For the master camera, there are to possiblities how it is triggered: The master camera triggers itself logically (so called Master - Slave, see figure 147), or the master camera uses the external trigger signal, which was created by itself, via digital input (so called Slave - Slave, see figure 148).
Technical Manual GenICam::AcquisitionControl ac(pDev); ac.triggerSelector.writeS( "FrameStart" ); ac.triggerMode.writeS( "On" ); ac.triggerSource.writeS( "Line4" ); ac.triggerActivation.writeS( "RisingEdge" ); mvBlueFOX-MLC // Set Trigger of Slave camera Device* pCamSlave = getDevicePointerFromSomewhere(); CameraSettingsBlueFOX csS(pCamSlave); csS.imageRequestTimeout_ms.write( 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 •...
Page 204
Setting of Timer2 (red box) on the master camera. 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 via digital input.
Technical Manual Figure 151: wxPropView - Trigger setting of the slave camera mvBlueFOX-MLC The red box in figure 150 is showing Master - Slave), which means that the master is triggered internally and the slave camera is set as shown in figure 152.
Technical Manual • 2 timers and • the active signal of the second timer at an output line. 20.8.1 Programming the pulse width modulation You will need two timers and you have to set a trigger. • Timer1 defines the interval between two triggers.
Technical Manual 20.8.2 Programming the pulse width modulation with wxPropView The following figures show, how you can set the timers using the GUI tool wxPropView Setting of Timer1 (blue box) on the master camera: Figure 154: wxPropView - Setting of Timer1...
Technical Manual Switch Trigger Mode to On and Select the Trigger Source, e.g. Line5. Use Counter1 and count the number of input trigger by setting the Counter Duration to 2. Afterwards, start Timer1 at the end of Counter1: Figure 156: wxPropView - Setting the sample The Timer1 appears every second image.
Page 209
To address problems that can arise from these kinds of trigger signals MATRIX VISION offers debouncing filters at the digital inputs of a device.
Technical Manual Figure 159: wxPropView - mv Line Debounce Figure 160: wxPropView - mv Line Debounce 20.11 Using the linescan mode of -x02e The CMOS sensor -x02e from e2v offers a linescan mode. One (gray scale sensor) or two lines (in terms of color sensor) can be selected to be read out of the full line height of 1024 lines.
Technical Manual In linescan mode, the camera adds the single lines to one image of the heigth of max 1024 px. The images are provided with no gap. Due to aberrations at the edges of the lens, you should set an offset in the direction of Y (Offset Y, see the following figure), generally around the half of the sensor's height (a.k.a.
Page 212
Technical Manual Exposure Time (in microseconds) 250.000 Acquisition Control Trigger Mode Acquisition Control Trigger Source Acquisition Line4 Control ImageRequestTimeout_ms (in This is necessary otherwise there will be 0 ms milliseconds) error counts and no frames are created. 22 April 2016 Version - 1.49...
Page 213
Technical Manual Figure 162: Settings in wxPropView MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 214
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
The mvBlueLYNX boots first from the external card slot then from the internal one. After you have tried to boot from the external card and the mvBlueLYNX-X boots correctly, there is a problem with the internal card. Now, it is possible to recover the card. There will be a recovery image on our website soon. The recovery...
This will make the virtual keyboard useable! 21.4 Does the mvBlueLYNX have a hardware real-time controller? The mvBlueLYNX-X has timer/counters similar to those on the mvBlueCOUGAR-X. They can be accessed via the GenICam property tree (see also SFNC). • Counters (part of chunk data) are used for counting events or external signals (compare number of triggers vs.
To correct this file, you will need the IP address of the mvBlueLYNX-X and a ssh client on your PC. Please follow these steps: Connect to the mvBlueLYNX-X: ssh root@A.B.C.D (A.B.C.D is the current IP address of the mvBlueLYNX-X) User: root Password: matrix Afterwards you can change uEnv.txt via the command line, e.g.
Technical Manual echo "dvimode=1024x768-24@60" > /media/mmcblk0p1/uEnv.txt 21.10 How can I find my mvBlueLYNX-X in the network? Depending on the operating system, you can find a mvBlueLYNX-X within the network segment connected to a PC in the following way: 21.10.1 Windows Install Apple's Bonjour Print Services for Windows (https://support.apple.com/kb/DL999) and...
Furthermore, it can be set, how many signal of each phase is charged. 22.6 IDE IDE means I ntegrated D evelopment E nivironment and represents a software application that can be used for software development. MATRIX VISION GmbH 22 April 2016 Version - 1.49...
• mvIMPACT_Acquire_API_NET_manual.chm (.NET developers) • and can be found on the mvBlueLYNX-X SDK DVD or can be downloaded from our website. 22.8 mvIMPACT SDK mvIMPACT SDK 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 system integrators can easily use a huge number of functions for acquisition, processing, enhancement and measurement in their own application.
Page 221
Technical Manual Figure 163: Gnome Network 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: MATRIX VISION GmbH 22 April 2016 Version - 1.49...
Page 222
Technical Manual Figure 165 Setting Link-Local Only After saving, you will find both connections in 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 connection: 22 April 2016 Version - 1.49...
Technical Manual Figure 167: Choosing the network interface 22.10 OpenGL® ES OpenGL® ES is a royalty-free, cross-platform API for full-function 2D and 3D graphics on embedded systems. See the Khronos website for more details. 22.11 Overlapped / pipelined transfer By default, the steps exposure and readout out of an image sensor are done one after the other.
Technical Manual Figure 168: Principle of overlapped and pipelined trigger In overlapped trigger mode, you have to keep in mind the following formular interval between two trigger events >= (readout time - exposure time) 22.12 Proxy In computer networks, a Proxy or a Proxy Server acts as an intermediary for requests from clients seeking resources from other servers.
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 wxPropView and capture images. 22.16 VirtualBox VirtualBox is a virtual machine used for developing software for mvBlueLYNX-X. See also: •...
Page 226
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Figure 5: mvBlueLYNX-X - recommended scope of the order (Introduction) Figure 6: mvBlueLYNX-X dimensions and connectors (Technical Data) Figure 7: mvBlueLYNX-X dimensions and connectors order option -xx9x (Technical Data) Figure 8: AlysiumTech 12-pin (male; top view), digital I/O, power (Technical Data)
Page 232
Figure 75: VirtualBox - New (mvBlueLYNX-X - LiveDVD and Virtual Machine) Figure 76: VirtualBox - Wizard (mvBlueLYNX-X - LiveDVD and Virtual Machine) Figure 77: VirtualBox - Name and OS (mvBlueLYNX-X - LiveDVD and Virtual Machine) Figure 78: VirtualBox - Main memory (mvBlueLYNX-X - LiveDVD and Virtual Machine) Figure 79: VirtualBox - Hard disk (mvBlueLYNX-X - LiveDVD and Virtual Machine) 22 April 2016 Version - 1.49...
Page 233
Figure 88: VirtualBox - Start (mvBlueLYNX-X - LiveDVD and Virtual Machine) Figure 89: Boot menu - Live System (mvBlueLYNX-X - LiveDVD and Virtual Machine) Figure 90: LiveDVD Virtual Machine image - Starting an application e.g. Eclipse (mvBlueLYNX-X - LiveDVD and Virtual Machine)
Page 234
Figure 131: Eclipse - Libraries (Eclipse (IDE)) Figure 132: Eclipse - Libraries (Eclipse (IDE)) Figure 133: Developing mvBlueLYNX-X samples using Microsoft Visual Studio® (MonoDevelop (IDE)) Figure 134: ContinuousCapture sample in MonoDevelop (MonoDevelop (IDE)) Figure 135: Starting an acquisition after one trigger event (Use Cases)
Page 235
Technical Manual Figure 155: wxPropView - Setting of Timer2 (Use Cases) Figure 156: wxPropView - Setting the sample (Use Cases) Figure 157: Assigning the digital output (Use Cases) Figure 158: wxPropView - Configuring Digital Input Debounce Times (Use Cases)
Page 236
Technical Manual 22 April 2016 Version - 1.49 MATRIX VISION GmbH...
Need help?
Do you have a question about the mvBlueLYNX-X and is the answer not in the manual?
Questions and answers