Baumer VisiLine IP User manual

Baumer VisiLine IP
User's Guide for Gigabit Ethernet Cameras

2

3
Table of Contents
1. General Information ................................................................................................. 6
2. General safety instructions ..................................................................................... 7
3. Intended Use............................................................................................................. 7
4. General Description ................................................................................................. 8
5. Camera Models......................................................................................................... 9
6. Installation .............................................................................................................. 10
6.1 Environmental Requirements................................................................................ 10
6.2 Heat Transmission ................................................................................................ 10
7. Pin-Assignment .......................................................................................................11
7.1 Power Supply and Digital IOs ................................................................................11
7.2 Ethernet Interface (PoE) ........................................................................................11
7.2.1 LED Signaling..................................................................................................11
8. ProductSpecications .......................................................................................... 12
8.1 Spectral Sensitivity................................................................................................ 12
8.2 Field of View Position............................................................................................ 14
8.3 Acquisition Modes and Timings............................................................................. 15
8.3.1 Free Running Mode........................................................................................ 15
8.3.2 Fixed-Frame-Rate Mode ................................................................................ 16
8.3.3 Trigger Mode .................................................................................................. 17
8.3.4 Advanced Timings for GigE Vision®Message Channel.................................. 21
8.4 Software................................................................................................................ 23
8.4.1 Baumer GAPI ................................................................................................. 23
8.4.2 3rd Party Software ........................................................................................... 23
9. Camera Functionalities.......................................................................................... 24
9.1 Image Acquisition.................................................................................................. 24
9.1.1 Image Format ................................................................................................. 24
9.1.2 Pixel Format ................................................................................................... 25
9.1.3 Exposure Time................................................................................................ 27
9.1.4 PRNU / DSNU Correction (FPN - Fixed Pattern Noise) ................................. 28
9.1.5 HDR (High Dynamic Range) .......................................................................... 29
9.1.6 Look-Up-Table ................................................................................................ 30
9.1.7 Gamma Correction ......................................................................................... 30
9.1.8 Region of Interest ........................................................................................... 31
9.1.9 Binning............................................................................................................ 32
9.1.10 Brightness Correction (Binning Correction).................................................. 33
9.1.11 Flip Image ..................................................................................................... 34
9.2 Color Processing................................................................................................... 35

4
9.3 Color Adjustment – White Balance ....................................................................... 35
9.3.1 User-specic Color Adjustment ...................................................................... 35
9.3.2 One Push White Balance ............................................................................... 36
9.4 Analog Controls..................................................................................................... 36
9.4.1 Offset / Black Level......................................................................................... 36
9.4.2 Gain................................................................................................................ 37
9.5 Pixel Correction..................................................................................................... 38
9.5.1 General information........................................................................................ 38
9.5.2 Correction Algorithm....................................................................................... 39
9.5.3 Defectpixellist ................................................................................................. 39
9.6 Process Interface .................................................................................................. 40
9.6.1 Digital IOs....................................................................................................... 40
9.6.2 IO Circuits....................................................................................................... 41
9.6.3 Trigger ............................................................................................................ 42
9.6.4 Trigger Source ................................................................................................ 42
9.6.5 Debouncer...................................................................................................... 43
9.6.6 Flash Signal.................................................................................................... 43
9.6.7 Timers............................................................................................................. 44
9.6.8 Frame Counter ............................................................................................... 44
9.7 Sequencer............................................................................................................. 45
9.7.1 General Information........................................................................................ 45
9.7.2 Baumer Optronic Sequencer in Camera xml-le............................................ 46
9.7.3 Examples........................................................................................................ 46
9.7.4 Capability Characteristics of Baumer-GAPI Sequencer Module .................... 47
9.7.5 Double Shutter ............................................................................................... 48
9.8 Device Reset......................................................................................................... 48
9.9 User Sets .............................................................................................................. 49
9.10 Factory Settings .................................................................................................. 49
9.11 Timestamp........................................................................................................... 49
10. Interface Functionalities ........................................................................................ 50
10.1 Device Information .............................................................................................. 50
10.2 Baumer Image Info Header................................................................................. 50
10.3 Packet Size and Maximum Transmission Unit (MTU)......................................... 51
10.4 Inter Packet Gap ................................................................................................. 51
10.4.1 Example 1: Multi Camera Operation – Minimal IPG..................................... 52
10.4.2 Example 2: Multi Camera Operation – Optimal IPG..................................... 52
10.5 Transmission Delay............................................................................................. 53
10.5.1 Time Saving in Multi-Camera Operation ...................................................... 53
10.5.2 Conguration Example ................................................................................. 54
10.6 Multicast.............................................................................................................. 56
10.7 IP Conguration .................................................................................................. 57
10.7.1 Persistent IP ................................................................................................. 57
10.7.2 DHCP (Dynamic Host Conguration Protocol) ............................................. 57
10.7.3 LLA ............................................................................................................... 58
10.7.4 Force IP........................................................................................................ 58
10.8 Packet Resend.................................................................................................... 59
10.8.1 Normal Case................................................................................................. 59
10.8.2 Fault 1: Lost Packet within Data Stream ...................................................... 59
10.8.3 Fault 2: Lost Packet at the End of the Data Stream ..................................... 59
10.8.4 Termination Conditions ................................................................................. 60
10.9 Message Channel ............................................................................................... 61
10.9.1 Event Generation ......................................................................................... 61
10.10 Action Command / Trigger over Ethernet.......................................................... 62

5
10.10.1 Example: Triggering Multiple Cameras ...................................................... 62
11. Start-Stop-Behaviour ............................................................................................. 63
11.1 Start / Stop / Abort Acquisition (Camera)............................................................. 63
11.2 Start / Stop Interface ........................................................................................... 63
11.3 Acquisition Modes ............................................................................................... 63
11.3.1 Free Running ................................................................................................ 63
11.3.2 Trigger........................................................................................................... 63
11.3.3 Sequencer .................................................................................................... 63
12. Cleaning .................................................................................................................. 64
13. Transport / Storage ................................................................................................ 64
14. Disposal .................................................................................................................. 64
15. Warranty Notes....................................................................................................... 65
16. Support.................................................................................................................... 65
17. Conformity .............................................................................................................. 66
17.1 CE ....................................................................................................................... 66
17.2 FCC – Class B Device ........................................................................................ 66

6
General Information1.
Thanks for purchasing a camera of the Baumer family. This User´s Guide describes how
to connect, set up and use the camera.
Read this manual carefully and observe the notes and safety instructions!
Target group for this User´s Guide
This User's Guide is aimed at experienced users, which want to integrate camera(s) into
a vision system.
Copyright
Any duplication or reprinting of this documentation, in whole or in part, and the reproduc-
tion of the illustrations even in modied form is permitted only with the written approval of
Baumer. This document is subject to change without notice.
Classicationofthesafetyinstructions
In the User´s Guide, the safety instructions are classied as follows:
Notice
Gives helpful notes on operation or other general recommendations.
Caution
P i ctogram
Indicates a possibly dangerous situation. If the situation is not avoided, slight
or minor injury could result or the device may be damaged.

7
General safety instructions2.
Caution
Heat can damage the camera. Provide adequate dissipation of heat, to
ensure that the temperatures does not exceed the value (see Heat Trans-
mission).
As there are numerous possibilities for installation, Baumer does not
specify a specic method for proper heat dissipation.
Intended Use3.
The camera is used to capture images that can be transferred over a GigE interface to a
PC.

8
General Description4.
12
4
5
3
No. Description No. Description
1Tube 4Power supply / Digital-IO
2C-Mount lens connection 5Data- / PoE-Interface
3LED´s
All Baumer Gigabit Ethernet cameras of the VisiLine IP family are characterized by:
Best image quality Low noise and structure-free image information▪
High quality mode with minimum noise▪
Flexible image acquisition Industrially compliant process interface with▪
parameter setting capability (trigger and ash)
Fast image transfer Reliable transmission up to 1000 Mbit/sec accord-▪
ing to IEEE802.3
Cable length up to 100 m▪
PoE (Power over Ethernet)▪
Baumer driver for high data volume with low CPU▪
load
High-speed multi-camera operation▪
▪Gen<I>Cam™ and GigE Vision®compliant
Perfect integration Flexible generic programming interface (▪Baumer-
GAPI) for all Baumer cameras
Powerful▪Software Development Kit (SDK) with
sample codes and help les for simple integration
Baumer viewer for all camera functions▪
▪Gen<I>Cam™ compliant XML le to describe the
camera functions
Supplied with installation program with automatic▪
camera recognition for simple commissioning
Compact design Protection class IP 65/67▪
Light weight▪
exible assembly▪
Reliable operation State-of-the-art camera electronics and precision▪
mechanics
Low power consumption and minimal heat genera-▪
tion

9
Camera Models5.
Camera Type Sensor
Size Resolution
Full
Frames
[max. fps]
CCD Sensor (monochrome / color)
VLG-02M.I / VLG-02C.I 1/4" 656 x 490 160
VLG-12M.I / VLG-12C.I 1/3" 1288 x 960 42
VLG-20M.I / VLG-20C.I 1/1.8" 1624 x 1228 27
CMOS Sensor (monochrome / color)
VLG-22M.I / VLG-22C.I 2/3" 2044 x 1084 55
VLG-40M.I / VLG-40C.I 1" 2044 x 2044 29
Dimensions
2 - M3 depth 5
4 - M3 depth 5
2 - M3 depth 5
12,9 12,920,2
26
45,8 52,9 12,9
46
46
14 3
49,5ø
8,3
41,5 3,1
26
8,3
◄Figure1
Dimensions of a
Baumer VisiLine IP
camera

10
Installation6.
Lens mounting
Notice
Avoid contamination of the sensor and the lens by dust and airborne particles when
mounting the support or the lens to the device!
Therefore the following points are very important:
Install the camera in an environment that is as dust free as possible!▪
Keep the dust cover (bag) on camera as long as possible!▪
Hold the print with the sensor downwards with unprotected sensor.▪
Avoid contact with any optical surface of the camera!▪
Environmental Requirements6.1
Temperature
Storage temperature -10°C ... +70°C ( +14°F ... +158°F)
Operating temperature* see Heat Transmission
* If the environmental temperature exceeds the values listed in the table below, the cam-
era must be cooled. (see Heat Transmission)
Humidity
Storage and Operating Humidity 10% ... 90%
Non-condensing
Heat Transmission6.2
Caution
Heat can damage the camera. Provide adequate dissipation of heat, to
ensure that the temperature does not exceed 50°C (122°F).
As there are numerous possibilities for installation, Baumer does not
specify a specic method for proper heat dissipation.
T
Measure Point Maximal Temperature
T 50°C (122°F)
Figure2►
Temperature measuring
point

11
7. Pin-Assignment
7.1 Power Supply and Digital IOs
Power supply / Digital-IO
(SACC-CI-M12MS-8CON-SH TOR 32)
wire colors of the connecting cable
1
2
3
4
567
8
1 OUT 3 white 7 Power GND blue
2 Power Vcc+ brown 8 OUT 2 red
3 IN 1 green
4 IO GND yellow Notice
The electrical data are available in the
respective data sheet.
5 Uext OUT grey
6 OUT 1 pink
Ethernet7.2 Interface (PoE)
Notice
The VisiLine IP supports PoE (Power over Ethernet) IEEE 802.3af Clause 33, 48V
Power supply.
Ethernet
(SACC-CI-M12FS-8CON-L180-10G)
2
1
8
7
6
5
4
3
1 MX1+ white
2 MX1- brown
3 MX2+ green
4 MX2- yellow
5 MX4+ grey
6 MX4- pink
7 MX3- blue
8 MX3+ red
7.2.1 LED Signaling
1
2
LED Signal Meaning
1green Link active
green ash Receiving
2 yellow Transmitting
◄Figure3
LED positions on Baum-
er VisiLine cameras.

12
8. ProductSpecications
8.1 Spectral Sensitivity
The spectral sensitivity characteristics of monochrome and color matrix sensors for Visi-
Line IP cameras are displayed in the following graphs. The characteristic curves for the
sensors do not take the characteristics of lenses and light sources without lters into
consideration.
Values relating to the respective technical data sheets of the sensors.
400 500 600 700 800 900 1000
0
0 2
0 4
0 6
0 8
1 0
Wave Length [nm]
Relative Response
VLG-02M.I
400 450 500 550 600 650 700
0
0 2
0 4
0 6
0 8
1 0
Wave Length [nm]
Relative Response
VLG-02C.I
400 500 600 700 800 900 1000
0
0 2
0 4
0 6
0 8
1 0
Wave Length [nm]
Relative Response
VLG-12M.I
400 450 500 550 600 650 700
0
0 2
0 4
0 6
0 8
1 0
Wave Length [nm]
Relative Response
VLG-12C.I
400 500 600 700 800 900 1000
0
0 2
0 4
0 6
0 8
1 0
Wave Length [nm]
Relative Response
VLG-20M.I
400 450 500 550 600 650 700
0
0 2
0 4
0 6
0 8
1 0
Wave Length [nm]
Relative Response
VLG-20C.I
Figure4►
Spectral sensitivities for
Baumer cameras with
0.3 MP CCD sensor.
Figure5►
Spectral sensitivities for
Baumer cameras with
1,2 MP CCD sensor.
Figure6►
Spectral sensitivities for
Baumer cameras with
2.0 MP CCD sensor.

13
350 450 550 650 750 850 950 1050
Wave Length [nm]
Quantum Efficiency [%]
VLG-22M.I / VLG-40M.I
350 450 550 650 750 850 950 1050
Wave Length [nm]
Quantum Efficiency [%]
VLG-22C.I / VLG-40C.I
◄Figure7
Spectral sensitivities
for Baumer cameras
with 5.0, 4,0 MP CMOS
sensor.

14
8.2 Field of View Position
The typical accuracy by assumption of the root mean square value is displayed in the
gure and the table below:
photosensitive
surface of the
sensor
cover glas
of sensor
thickness: D
front cover glass
thickness: 1 ± 0.1 mm
optical path
c-mount (17.526 mm)
0 5
0,5
± α
±XR
±YR
±XM
±YM
± Z
A
14,6
60,2
7,2
15,6
Camera
Type
± XM
[mm]
± YM
[mm]
± XR
[mm]
± YR
[mm]
± zZyp
[mm]
± αtyp
[°]
A
[mm]
D**
[mm]
VLG.I-02* 0.09 0.09 0.09 0.09 0.025 0.7 16.1 0.75
VLG.I-12* 0.06 0.06 0.06 0.06 0.025 0.7 16.6 0.5
VLG.I-20* 0.06 0.06 0.06 0.06 0.025 0.7 16.6 0.5
VLG.I-22* 0.07 0,07 0.07 0.07 0.025 0,5 16.2 0.55 ± 0.05
VLG.I-40* 0.07 0,07 0.07 0.07 0.025 0,5 16.2 0.55 ± 0.05
typical accuracy by assumption of the root mean square value
* C or M
** Dimension D in this table is from manufacturer datasheet (edition 06/2012)
Figure8►
Sensor accuracy of the
Baumer VisiLine IP

15
8.3 Acquisition Modes and Timings
The image acquisition consists of two separate, successively processed components.
Exposing the pixels on the photosensitive surface of the sensor is only the rst part of the
image acquisition. After completion of the rst step, the pixels are read out.
Thereby the exposure time (texposure) can be adjusted by the user, however, the time need-
ed for the readout (treadout) is given by the particular sensor and image format.
Baumer cameras can be operated with three modes, the Free Running Mode, the Fixed-
Frame-Rate Mode and the Trigger Mode.
The cameras can be operated non-overlapped*) or overlapped. Depending on the mode
used, and the combination of exposure and readout time:
Non-overlapped Operation Overlapped Operation
Here the time intervals are long enough
to process exposure and readout succes-
sively.
In this operation the exposure of a frame
(n+1) takes place during the readout of
frame (n).
Exposure
Readout
Exposure
Readout
8.3.1 Free Running Mode
In the "Free Running" mode the camera records images permanently and sends them to
the PC. In order to achieve an optimal result (with regard to the adjusted exposure time
texposure and image format) the camera is operated overlapped.
In case of exposure times equal to / less than the readout time (texposure ≤ treadout), the maxi-
mum frame rate is provided for the image format used. For longer exposure times the
frame rate of the camera is reduced.
Exposure
Readout
Flash
texposure(n)
tflash(n)
tflashdelay
tflash(n+1)
treadout(n+1) treadout(n)
texposure(n+1)
tash = texposure
*) Non-overlapped means the same as sequential.
Image parameters:
Offset
Gain
Mode
Partial Scan
Timings:
A - exposure time
frame (n) effective
B - image parameters
frame (n) effective
C - exposure time
frame (n+1) effective
D - image parameters
frame (n+1) effective

16
Fixed-Frame-Rate Mode8.3.2
With this feature Baumer introduces a clever technique to the VisiLine IP camera series,
that enables the user to predene a desired frame rate in continous mode.
For the employment of this mode the cameras are equipped with an internal clock genera-
tor that creates trigger pulses.
Notice
From a certain frame rate, skipping internal triggers is unavoidable. In general, this de-
pends on the combination of adjusted frame rate, exposure and readout times.

17
8.3.3 Trigger Mode
After a specied external event (trigger) has occurred, image acquisition is started. De-
pending on the interval of triggers used, the camera operates non-overlapped or over-
lapped in this mode.
With regard to timings in the trigger mode, the following basic formulas need to be taken
into consideration:
Case Formula
texposure < treadout
(1) tearliestpossibletrigger(n+1) = treadout(n) - texposure(n+1)
(2) tnotready(n+1) = texposure(n) + treadout(n) - texposure(n+1)
texposure > treadout
(3) tearliestpossibletrigger(n+1) = texposure(n)
(4) tnotready(n+1) = texposure(n)
8.3.3.1 Overlapped Operation: texposure(n+2) = texposure(n+1)
In overlapped operation attention should be paid to the time interval where the camera is
unable to process occuring trigger signals (tnotready). This interval is situated between two
exposures. When this process time tnotready has elapsed, the camera is able to react to
external events again.
After tnotready has elapsed, the timing of (E) depends on the readout time of the current im-
age (treadout(n)) and exposure time of the next image (texposure(n+1)). It can be determined by the
formulas mentioned above (no. 1 or 3, as is the case).
In case of identical exposure times, tnotready remains the same from acquisition to acquisi-
tion.
Exposure
Readout
texposure(n)
treadout(n+1) treadout(n)
texposure(n+1)
ttriggerdelay
tmin
Trigger
Flash
tflash(n)
tflashdelay
tflash(n+1)
TriggerReady
tnotready
Image parameters:
Offset
Gain
Mode
Partial Scan
Timings:
A - exposure time
frame (n) effective
B - image parameters
frame (n) effective
C - exposure time
frame (n+1) effective
D - image parameters
frame (n+1) effective
E - earliest possible trigger

18
8.3.3.2 Overlapped Operation: texposure(n+2) > texposure(n+1)
If the exposure time (texposure) is increased from the current acquisition to the next acquisi-
tion, the time the camera is unable to process occurring trigger signals (tnotready) is scaled
down.
This can be simulated with the formulas mentioned above (no. 2 or 4, as is the case).
Exposure
Readout
texposure(n)
treadout(n+1) treadout(n)
texposure(n+1) texposure(n+2)
ttriggerdelay
tmin
Trigger
Flash
tflash(n)
tflashdelay
tflash(n+1)
TriggerReady
tnotready
Image parameters:
Offset
Gain
Mode
Partial Scan
Timings:
A - exposure time
frame (n) effective
B - image parameters
frame (n) effective
C - exposure time
frame (n+1) effective
D - image parameters
frame (n+1) effective
E - earliest possible trigger

19
8.3.3.3 Overlapped Operation: texposure(n+2) < texposure(n+1)
If the exposure time (texposure) is decreased from the current acquisition to the next acquisi-
tion, the time the camera is unable to process occurring trigger signals (tnotready) is scaled
up.
When decreasing the texposure such, that tnotready exceeds the pause between two incoming
trigger signals, the camera is unable to process this trigger and the acquisition of the im-
age will not start (the trigger will be skipped).
Exposure
Readout
texposure(n)
treadout(n+1) treadout(n)
texposure(n+1) texposure(n+2
ttriggerdelay
tmin
Trigger
Flash
tflash(n)
tflashdelay
tflash(n+1)
TriggerReady
tnotready
Notice
From a certain frequency of the trigger signal, skipping triggers is unavoidable. In gen-
eral, this frequency depends on the combination of exposure and readout times.
Image parameters:
Offset
Gain
Mode
Partial Scan
Timings:
A - exposure time
frame (n) effective
B - image parameters
frame (n) effective
C - exposure time
frame (n+1) effective
D - image parameters
frame (n+1) effective
E - earliest possible trigger
F - frame not started /
trigger skipped

20
8.3.3.4 Non-overlapped Operation
If the frequency of the trigger signal is selected for long enough, so that the image acquisi-
tions (texposure + treadout) run successively, the camera operates non-overlapped.
Exposure
Readout
texposure(n)
treadout(n+1) treadout(n)
texposure(n+1)
ttriggerdelay
tmin
Trigger
Flash
tflash(n)
tflashdelay
tflash(n+1)
TriggerReady
tnotready
Image parameters:
Offset
Gain
Mode
Partial Scan
Timings:
A - exposure time
frame (n) effective
B - image parameters
frame (n) effective
C - exposure time
frame (n+1) effective
D - image parameters
frame (n+1) effective
E - earliest possible trigger