USERS MANUAL
SVCam-ECO Line eco204, eco424, eco415, eco267 and eco274
Gigabit Ethernet

Digital Progressive Area-Scan Camera
Version 1.3
Last Update 21.07.2009

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 2

Contact:
SVS-VISTEK GmbH
Mühlbachstraße 20
82229 Seefeld/Obb.
Germany
Tel. +49-(0)8152-99 85-0
www.svs-vistek.com

Service contact:
E-Mail: service@svs-vistek.com

Users Manual – eco424, eco204, eco415, eco267, eco274
Last Update 21.07.2009

p. 3

Content
1

INTRODUCTION .................................................................................................................................................. 72

PINOUT AND INSTALLATION............................................................................................................................... 8
2.1
UNPACKING .......................................................................................................................................................... 8
POWER SUPPLY ...................................................................................................................................................... 8
2.2
CONNECTORS ........................................................................................................................................................ 9
2.3
2.3.1 One common signal connector for: ............................................................................................................... 9
HR10A-10P-12S (MATING CONNECTOR HR10A-10R-12PB)................................................................................................... 9
2.3.2 “Ethernet” Connector .................................................................................................................................... 9
INSTALLATION/GETTING STARTED: RECOMMENDED PC ................................................................................................. 9
2.4
HARDWARE......................................................................................................................................................... 11
2.5
AVAILABLE OPERATION MODES ............................................................................................................................... 11
2.6
2.6.1 General........................................................................................................................................................ 11
2.6.2 Operation Modes ........................................................................................................................................ 12
LED SIGNALS SVCAM-ECO ................................................................................................................................... 12
2.7
CAMERA STATUS ............................................................................................................................................................... 12
BLINK CODES .................................................................................................................................................................... 12

3

SOFTWARE ........................................................................................................................................................13
3.1
SVCAPTURE/GIGE VISION CAMERA VIEWER ............................................................................................................. 13
ADJUSTING TCP/IP RESPECTIVE NETWORK SETTINGS .................................................................................................. 14
3.2
3.2.1 Network address assignment...................................................................................................................... 15
3.2.2 Persistent Network address assignment ..................................................................................................... 16
3.2.3 Using jumbo frames .................................................................................................................................... 17
3.2.4 Performance considerations ....................................................................................................................... 17
3.2.5 Multicast ..................................................................................................................................................... 18

4

WINDOWS X64 SUPPORT ..................................................................................................................................19

5

CAMERA SETTINGS DIALOG ...............................................................................................................................20
5.1.1 Camera ........................................................................................................................................................ 21
5.1.2 Network ...................................................................................................................................................... 21
5.1.3 Acquisition................................................................................................................................................... 21
IMAGE ............................................................................................................................................................... 22
5.2
GAIN ................................................................................................................................................................. 23
5.3
OFFSET .............................................................................................................................................................. 23
5.4
AUTOGAIN/AUTOEXPOSURE .................................................................................................................................. 24
5.5
ADJUSTING AN AOI (AREA OF INTEREST) ................................................................................................................... 24
5.6
5.7
STROBE .............................................................................................................................................................. 24
PERSISTENCE ....................................................................................................................................................... 24
5.8

6

SAVING IMAGES TO DISK...................................................................................................................................25

7

ASSIGNING IO LINES ..........................................................................................................................................26

8

DISPLAYING A CAMERA’S XML FILE ...................................................................................................................27

9

DISPLAYING A CAMERA’S FEATURE LIST ............................................................................................................28

10

OTHER MENU ITEMS .....................................................................................................................................28

11

CONTEXT MENU ............................................................................................................................................29
11.1
11.2

12

FILTER DRIVER ..................................................................................................................................................... 30
FIRMWARE UPDATE .............................................................................................................................................. 31
TECHNICAL DATA ..........................................................................................................................................32

12.1
CCD USED/COSMETIC ISSUES:................................................................................................................................. 32
SIGNAL CONDITIONING .......................................................................................................................................... 32
12.2
OPTICAL AND MECHANICAL ISSUES ........................................................................................................................... 32
12.3
HR10A-10P-12S (MATING CONNECTOR HR10A-10R-12PB)................................................................................................. 34

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 4

OPTION ........................................................................................................................................................................... 34
BASIC ELECTRO-OPTIC SPECIFICATIONS OF CAMERAS ................................................................................................................ 34
BASIC ELECTRO-OPTIC SPECIFICATIONS OF CAMERAS ................................................................................................................ 35
ENVIRONMENTAL ISSUES ....................................................................................................................................... 38
12.4
SPECTRAL RESPONSE CURVES .................................................................................................................................. 39
12.5
COMMENTS ON CAMERA TEMPERATURE ................................................................................................................... 40
12.6
COMMENTS ON COLOR VERSION ............................................................................................................................. 40
12.7
13

WARRANTY TERMS .......................................................................................................................................41
13.1
13.2

14

STANDARD PRODUCTS WARRANTY AND ADJUSTMENT .................................................................................................. 41
DEVELOPMENT PRODUCT WARRANTY ...................................................................................................................... 41
APPENDIX A – TROUBLESHOOTING ...............................................................................................................42

14.1

GET CAMERA DIAGNOSTICS .................................................................................................................................... 42

15

TROUBLESHOOTING REQUEST LIST V1.3 .......................................................................................................45

16

APPENDIX B – BASIC TIMING FOR DIFFERENT OPERATION MODES ...............................................................46
16.1
16.2
16.3

17

FREE RUNNING .................................................................................................................................................... 46
EXTERNAL TRIGGER AND PULSEWIDTH OF TRIGGER ..................................................................................................... 46
EXTERNAL AND SOFTWARE TRIGGER AND INTERNAL EXPOSURE TIME SETTING ................................................................... 46
APPENDIX C: SDK DESCRIPTION FOR CAMERA CONTROL ..............................................................................47

17.1 OVERVIEW ....................................................................................................................................................... 48
17.2 PREREQUISITES .............................................................................................................................................. 48
SVGIGE SDK COMPONENTS.......................................................................................................................... 48
17.3
DEVELOPMENT ENVIRONMENTS...................................................................................................................... 49
17.4
W INDOWS X64 SUPPORT ................................................................................................................................ 49
17.5
DOCUMENTATION ............................................................................................................................................ 50
17.6
17.7 SYSTEM ARCHITECTURE ................................................................................................................................. 50
17.8 FUNCTION GROUPS ......................................................................................................................................... 51
17.9 DETAILED FUNCTION LISTING .......................................................................................................................... 52
BEST PROGRAMMING PRACTICES ............................................................................................................... 58
17.10
17.10.1 Connecting to the camera container ..................................................................................................... 58
17.10.2 Connecting to a camera ......................................................................................................................... 58
17.10.3 Identifying a camera .............................................................................................................................. 59
17.10.4 Opening a streaming channel ............................................................................................................... 59
17.10.5 Receiving images in a callback function................................................................................................ 60
17.10.6 Processing image data ........................................................................................................................... 60
17.10.7 Decoding 12-bit images ......................................................................................................................... 61
17.10.8 Adjusting tap balance automatically .................................................................................................... 61
17.10.9 Distributing image streams by multicast .............................................................................................. 62
Receiving messages asynchronously ................................................................................................ 64
17.10.10
18

APPENDIX D ..................................................................................................................................................65
18.1

19

APPENDIX E ...................................................................................................................................................71
19.1
19.2

20

PC AND OS REQUIREMENTS................................................................................................................................... 71
FIREWALL CONSIDERATIONS.................................................................................................................................... 71
APPENDIX F ...................................................................................................................................................73

20.1
21

INSTALLATION INSTRUCTION FOR FILTER DRIVER INSTALLATION ..................................................................................... 65

FIRMWARE-UPDATE WITH “GIGE UPDATE TOOL.EXE“ PROGRAM .................................................................................. 73
APPENDIX G ..................................................................................................................................................75

BASIC CIRCUITS FOR HARDWARE INTERFACING ........................................................................................................75
TTL INPUT CIRCUIT/ OUTPUT ( I.E STROBE ) ...............................................................................................................75

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 5

APPENDIX H ..................................................................................................................................................76

22
22.1
22.2
22.3

DEFINITION OF MARKINGS ...................................................................................................................................... 76
RESTRICTED FOR USE ............................................................................................................................................ 79
CASES FOR INDEMINITY (LIMITED WARRANTY) ........................................................................................................... 79

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 6

1

Introduction
Thank you for purchasing a SVS-VISTEK product. We hope that you will besatisfied by our service. This camera uses CCD`s as optical image sensors.
They feature low dark current and high speed readout.
The SVS GigE Line cameras offer full image with one shot, combined with digital
output (non interlaced, progressive scan cameras) via Ethernet technology.
Further, they feature an excellent S/N ratio at low prices.
The exposure time can be adjusted in different ways. 3 operation modes areavailable to cover most applications in image processing and optical metrology.
The following types are covered in this manual:
eco424
1/3” CCD, 640 x480 pixel, 12 Bit gray level resolution, ca. 130 fps;
monochrome and color version
eco 415
1/2” CCD, 782 x 494 pixel, 12 Bit gray level resolution, ca. 60
fps; monochrome and color version ( PRELIMINARY)
eco204
1/3”lCCD, 1024 x 768 pixel, 12 Bit gray level resolution, ca. 30
fps; monochrome and color version
eco2671/2” CCD, 1360 x 1024 pixel, 12 Bit gray level resolution, ca. 25
fps; monochrome and color version
eco2741/2” CCD, 1600 x 1200 pixel, 12 Bit gray level resolution, ca. 15
fps; monochrome and color version .

For standard applications only 8 Bit are transmitted due to data load.
For more information on the color versions, please see chapter 12.7.
If you need modifications, we will be glad to offer you a custom camera suitable
to your application.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 7

2

Pinout and Installation
Warning:
The CCD camera is built with CMOS-LSI circuits. All internal electronics in thecamera are sensitive to high voltage or electrostatic discharge. The camera canbe destroyed if carelessly handled, so extreme care should be taken during set
up and operation.
Do not expose the sensor to a direct laser beam as this could damage thesensor! See Safety Instructions at Appendix H. Warranty will be void if
not followed.

2.1 Unpacking
•
•
•
•
•
•

CameraPower supply (if ordered/option)
Mating connector (first cameras delivered)User Manual
Disk with SDK including “High Performance Driver”, API and GUI“SVCapture” (for GigE camera) program. Also a Firmware update tool.
XML File according to GenIcam standard released by AIA committee.

2.2 Power supply
Current consumption:= 300 mA (typical)
Peak current on “Power on” up to 500 mA!
Current consumption increases rapidly when “partial scan” feature is
used!

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 8

2.3 Connectors
2.3.1

One common signal connector for:
•
•
•
•
•

Trigger and TTL input to trigger camera
General purpose I/Os
UART communication
Strobe Output (e.g. light )Power

HR10A-10P-12S (mating connector HR10A-10R-12PB)
1 VIN- (GND)
2 VIN+ (9 to 24VDC)
3 RXD data to camera (RS232 Level)
4 TXD data from camera (RS232 Level)
5 IN1 (open drain 3- 30 V)
6 IN2 (open drain 3- 30 V)
7 OUT1 (open drain max 30 V)
8 OUT2 (open drain max 30 V
9 IN3+, 10 IN3- (RS422 Level)
11 OUT3+, 2 OUT3- (RS422 Level)
See outline in chapter 12.3

2.3.2

“Ethernet” Connector
RJ 45 “Western” Connector complies with Autosensing 100 T Ethernet
and Gigabit specification. Features Auto MDIX.
1 LED for status indication

2.4 Installation/Getting started: Recommended PC
It is recommended to use a PC with a Pentium P4 processor at 2,4 GHz or
higher. The camera is working also on lower frequencies but it might notdeliver the full frame rate in those cases.
If the camera is connected to the PC directly without using a network switch, a
fixed IP-Address and Subnet-Mask has to be configured in the PC’s
TCP/IP settings:
See: Start -> Settings -> Network connections -> LAN-connection ->Properties -> TCP/IP
A Gigabit Ethernet network adapter is needed (100 MBit adapters would also
work, but with reduced frame rates). If your PC does not have a Gigabit
interface card purchase a card using an original INTEL (TM) Chip set.

Currently PCI(e) bus cards with 82541 chip set version have been tested successfully.
Currently we can recommend Intel pro 1000 GT or MT. Recently problems with the “CT”
version have been reported.

DO NOT USE INTEL PRO 1000 CT !!
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 9

If you do not follow this, a significantly reduced data transmission rate
is observed. Also the loss of data can appear.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 10

2.5 Hardware••

Install camera in the desired location. You can use the ¼’’ tripot adapter or
use the 4 M3 holes in the adapter of the camera.
Connect the power supply. If you have ordered a P/S connect it to thecamera. If you use your own power supply (must be 12 V DC) make sure
you connect it to Pin1(GND) and Pin 2 (+12 V). Use SHIELD for Pin 3.

If you – by mistake – supply line with GND pin the camera can bedamaged! If power supply was ordered, do not modify it.
Connect an Ethernet cable to your PC or a network switch like you would build
up a PC Network. Please note that cable length should not exceed 100 m fortheses camera (Cat 5E version). In doubt consult your local distributor.
Wait 15 seconds until the green LED at the RJ45 connector of the Camera blinks
sometimes.
Then start “SVCapture.exe”.

2.6 Available operation modes
2.6.1

GeneralAll modes are set by the interface which connects via Ethernet standard
cable.
CAT 5E quality is required.
The default factory setting is Free Running/ Fixed frequency using theinternal logic for exposure control. You can also trigger the camera by hardwareand by PC (software trigger).
The color version will come on request with free software algorithm which willallow processing of the color image inside the PC or the camera. This must to
be done in order to interpolate the colors for each pixel. Please note that noresponsibility can be taken for the algorithm. It might be necessary to change
the algorithm according to the application.
See chapter 12.7

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 11

2.6.2

Operation Modes•

Free Running• Triggered, external exposure control
If you want to trigger the camera and determine the exposure time by thepulse width of Exsync, choose this mode. Then apply a trigger signal at theappropriate pins e.g. on pins of Phoenix connector (see 2.3.1). With thestarting edge of the pulse the camera will start exposure time. The exposure
time ends with next upcoming edge of Exsync. Please check the timing diagramin the appendix of this manual.
• External triggered, internal camera exposure control
If you want to trigger the camera and use the convenient exposure time
control of the micro controller then use this mode. You still can use the
SVCapture GUI for setting exposure time (see “Exposure time”-field below).
However you need to use the Exsync signal in order to trigger the camera (see“Trigger”-buttons below).
•

External triggered via Software trigger with internal exposure
control
If you want to trigger the camera with a software trigger and use the
SVCapture exposure time control of camera logic then use this mode.

2.7 LED Signals SVCam-ECO
Camera status
•
•
•
•
•
•
•
•

Signals:
No connection with network cable (yellow slow)
Allotment of the network address (yellow quick)
Network address allotted (yellow)
Connected with application (green)
Streaming channel available (green slow)
Acquisition enabled (green quick)
Problem with initialization (red slow)
Overheating (red quick)•••

Optional instead of “acquisition enabled”:
Waiting for trigger (blue)
Exposure active (cyan)
Readout/FVAL (violet)

Blink codes
•
•
•

On
Slowly (approx. 1 Hz)
Quickly (approx. 8 Hz)

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 12

3 Software
3.1 SVCapture/GigE Vision Camera Viewer
Overview
You can use the SVCapture without the “High performance Driver” but if you
want to lower the CPU load when grabbing images install it now.
You will observe a loss of frames if you do not use the driver.
If you have installed the camera and connected the power, you can install thedriver and the GUI to do the first test. Copy the “SVCapture.exe” to your disk
drive, double click on the SVCapture icon and a window will open.
The software SVCapture displays images sent from SVS-GigE-Cameras via
Gigabit Ethernet to your PC (with Windows XP) and allows adjusting basic
camera settings.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 13

3.2 Adjusting TCP/IP respective Network Settings
If the live image is not displayed, this is most often caused by inappropriate
network settings. In this case the camera’s network settings have to be
adjusted first before getting it into an operational mode.
Adjust settings accordingly
Settings -> Network connections -> LAN-connection -> Properties -> TCP/IP

In a network with a DHCP server the camera will obtain its IP address
automatically and the settings shown in the screenshot above will be on “Obtainan IP address automatically.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 14

3.2.1

Network address assignment
The main components of a network address are the IP (Internet Protocol)
address and the network mask. The usually applied network mask
“255.255.255.0” for small networks up to 254 PCs represents a 32-bit long bit
mask where the first 24 bits are set to 1 and the last 8 bits are set to 0. This
network mask instructs the network hardware to let those devices exchange
information with each other where the first 24 bits of the IP addresses match
for all devices.
Thus the variable range of addresses is made from all possible combinations of
the last 8 bits for which the network mask is set to 0. Exceptions are the first
address 0 and the last address 255 which have special meanings for network
management functions. All other 254 combinations are usually free forassigning them to network devices.
For a peer-to-peer connection of a GigE camera to a PC a network address
assignment based on LLA (Local Link Address) is recommended. This involves a
network mask “255.255.0.0” as well as a fixed first part “169.254.xxx.xxx” ofthe network address range. A GigE camera will fall back to LLA soon after
recognizing that no DHCP server is available and that no fixed network address
was assigned to the camera.
In case a camera can not be reached by the SVCapture application a dialog willappear that allows for adjusting a camera’s network parameters. The simplest
way is to click on “Automatic” which will provide to a search for a free IP
address and to assigning it to the camera given that the interface IP could bedetermined properly.

That dialog can also be brought up when right clicking on an entry in the
discover dialog and subsequently selecting “Force IP address” in the context
menu. However, when adjusting the PC network settings to LLA the camera
must not get assigned a fixed network address
NOTE: The network settings performed in the “Force IP address” dialog
are only valid until the next shutdown and restart of a camera. For
permanently changing a camera’s network settings the “Network
settings” dialog can be used instead. That dialog can also be opened in
the context menu which is displayed when right-clicking on an entry inthe discover dialog.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 15

3.2.2

Persistent Network address assignment
Open the dialog by selecting “Network settings” in the context menu that comesup when right-clicking on an entry in the discovery dialog:

All settings in the “Network configuration” dialog will be transferred to thecamera and they will be made persistent on the EEPROM inside the camera.
Therefore this dialog allows for assigning a non-volatile network address to acamera which it will maintain also over shutdown and restart cycles.
Network settings performed in this dialog become valid but after areboot of the camera.
In addition to a persistent network address it can be decided whether thecamera will try to obtain a dynamic network address from a DHCP server onstart-up. If this option is used the camera can no longer be identified uniquely
by IP address. Instead, other items like MAC address, serial number or the user
defined name can be used for this purpose. Usually the DHCP method isconvenient for involving a camera in to an already existing network ofcomputers which all obtain their IP addresses from a DHCP server. The camera
will well behave in this environment when adjusting it also to the DHCP mode.
In some cases it may be that a camera will be connected for performancereasons directly to a dedicated network card. Given that this network card has
not got assigned a valid IP address there is a fall-back procedure defined
which takes automatically a network address from a special range that has
been assigned for this purpose. This is the so called “Link Local Address(LLA)” behavior that constitutes the last item in a chain of fallback cases. It
has been defined in the GigE Vision standard document that the LLA fallback procedure can never be deactivated. Therefore the LLA checkbox isdeactivated but always in a checked state.
Currently the Default gateway setting is not used and therefore deactivated.
This is related to performance considerations which recommend to operate GigE
cameras in the same network segment where the clients exist and not to routethe data stream in to other networks.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 16

3.2.3Using jumbo frames
The transport efficiency in the streaming channel can be improved when using“jumbo frames” in network transport. This will reduce the overhead which is
caused by maintaining header data with each data packet. A network packet
has usually a size of about 1500 bytes which can be increased to e.g. 16112 byswitching “jumbo frames” on. In addition to the network card “jumbo frames”
have to be supported also by a switch that forwards the image data stream
from a camera to the PC.
Adjusting higher packet sizes requires network cards that support jumbopackets, e.g. Intel PRO/1000 PT which offers a single network port or Intel
PRO/1000 MT which offers two network ports. Other cards have to be checked
whether they contain an adjustment which allows for switching “jumbo frames”
on.

NOTE: For Intel Pro/1000 cards the settings should be adjusted as follows:
Flow control:
Generate
Interrupt throttling rate: Minimal
Jumbo frames:
adjust to maximal value
All SVCam-GigE cameras support flow control and jumbo frames upto 16112
bytes.

3.2.4

Performance considerations
Each GigE camera is a high-performance device. In order to use the full
performance of a GigE camera a PC is required that meets at least the datatransfer figures that the connected camera is capable to deliver to theapplication.
For example, a SVS625MFGE camera delivers a compound image data stream
consisting of two times 50 Megabytes/sec. of payload data plus network
overhead. Therefore the PC that operates that camera should be capable oftransferring that amount of data as a net data stream over all its internal
components like network card, PCI bus and others. A PC with a dual core

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 17

Pentium D 3.0 GHz processor and an Intel PRO 1000 MT network card is an
example of a well equipped system.
NOTE: All SVS GigE cameras can also be operated with computers of lessperformance than the camera delivers at highest frame rate. In this case themaximal available framerate will be below the camera’s maximum. This is avalid operating mode, however one has to be aware of the limits.
HINT: Notebooks are in most cases not capable to operate data
streams at the maximum level that SVS GigE cameras deliver. One has tobe aware that connecting a SVS GigE camera to an average notebook will notallow for operating the camera at highest framerate but only on lower
framerates.

3.2.5

MulticastWhen images from a single camera are to be delivered to multiple PCs the usual
way is to use multicast (RFC 2236). A switch receives an image data stream
from a camera and distributes it to multiple destinations in this mode.
Since a GigE camera always needs a single controlling application, there will be
only one master application. That controlling master application has to open acamera in multicast mode (IP 232.x.x.x for local multicast groups) for allowing
other applications to connect to the same image data stream. Other
applications will become listeners to an existing image data stream. They will
not get control access to the camera, however their eventual packet resendrequests will be served in the same way as for the controlling application.

When using SVCapture as the controlling application, the “Multicast” checkbox
has to be checked in the Device Discovery dialog before opening a camera.

It is important to enter a suitable maximal packet size. This packet size isdetermined as the minimum packet size from all intended listeners. When for
example all applications but one have jumbo frames adjusted to 16112 bytes
and the one application has jumbo frames adjusted to 9000 bytes then theminimum (9000) has to be entered in the above shown dialog.
A multicast data stream can be identified in SVCapture by a change in a camera
view’s title. A multicast group (232.x.x.x) along with the used port will beshown instead of a camera’s MAC that is usually displayed in that place.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 18

Further the camera is operated as usual in the controlling application without
any changes to normal mode.
A listening application will see a hint “MULTICAST” in the “IP address” field of
the discovery dialog for a camera that is streaming in multicast mode along
withthe IP address of the multicast group.

The “Multicast” group box will display the packet size that applies to the running
image data stream. The listening application has to have at least thatpacket size available (jumbo frames) in order to properly connect tothe image data stream.
After selecting the multicast camera in the camera list of the discovery dialog
the OK button can be clicked or the camera entry can be double clicked in order
to connect to the already running image data stream.
Since the listening application does not have control access, all controls in the‘SVCam Settings’ dialog will be disabled except the Close button.

4 Windows x64 support
The SVGigE SDK supports x64 natively by providing a SVGigE driver along with
DLLs and a sample application which are compiled for x64 platforms.
Although the SVCapture.exe program is a Win32 application, it can be used withsome limitations also on Windows x64 PCs using the win32 compatibility mode.
When running SVCapture on x64 platforms in the compatibility mode the
SVGigE driver will not be available because a win32 application is not capable ofhandling the 64-bit image buffer addresses which are provided by the driver.
Nevertheless SVCapture can use Winsock for both, communicating to a camera
as well as streaming image data from the camera to the application.
NOTE: Though a Winsock connection to a camera can be established properly
also on x64 platforms, there exist the same limitation for image streams
regarding transport reliability also on that platform. Usually a certain amount of
network packets gets lost when working over Winsock. Though the GigE Vision
standard allows for resending lost packets it might be that under certain
circumstances visible failures in images can result from loosing network packets
dependent on the system load.
Therefore the recommended and most reliable way for streaming image datafrom a camera to a PC is by using the filter driver. The
SVGigE_ExampleVC8.x64.exe allows for running a connection with both, filter
driver as well as Winsock and for comparing those modes and their main
characteristics against each other.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 19

5

Camera settings dialog
Double clicking into the image area or selecting the “Camera settings” entry in
the “Camera” menu brings up a settings dialog that allows for accessing thevarious camera settings:

While adjusting settings in the dialog the new values are transferred to thecamera continuously and the live image will respond to all changes
immediately.
In particular the following information and settings are available:

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 20

In particular the following information and settings are available:

5.1.1

CameraIn the camera panel the following information is queried from the camera anddisplayed:• Model name: ecoZZZXVGE• Manufacturer name: SVS-VISTEK• Serial number• Device version• User defined name• Manufacturer specific information

5.1.2

Network
The network panel shows the currently used network related settings andparameters. These are in particular:• The camera’s MAC address• The camera’s IP address• The camera’s subnet mask
• The camera’s streaming port and streaming packet size
• The actual data rate
• The actual frame rate

5.1.3

Acquisition
The acquisition panel contains the settings that are related to image acquisition
as follows:• Acquisition mode: (free running, software trigger, external trigger withinternal/external exposure) Free Running: At the first installation it should be this mode. In thismode the camera creates all sync signals itself. There is no need totrigger the camera (by EXSYNC) in order to get data. The Exposure
time can be set by using the software Interface of the PC. It is
controlled by the internal FPGA. No further external signals. The enclosed
program allows the user to set the values from e.g. about 1/100.000/sec
to 1 second. Exposure time can be changed online during operation.

 External trigger and using Pulse width of Trigger (external

exposure): In this mode the camera is waiting for an external trigger
which causes the integration and read out. The exposure time can bevaried by the length of EXSYNC between the high going edge and the low
going edge. The Time settings in the control menu are not activated. Thismode is useful in applications where the light level of the scene changes
during operation. A frame to frame variation is allowed. Trigger must be
fed directly to the camera by into the Hirose connector. A TTL (min. 5V)
signal is provided from encoder, flashlight or any other source. Details
see Appendix G.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 21

 Software triggered and using PC: The frame rate is determined by the
number of Software TRIGGER pulses generated inside the PC per time.
With each “Software pulse” the camera will readout a frame. The
Exposure time is set as in free running mode. Exposure time can bechanged online during operation.
•

Frame rate: It allows to alter the frame rate between 1 and the specified
maximum value.

•

Exposure: The exposure time can be set in µsec. The minimal exposure time
is about 50 µsec (depending on the camera type and speed). The longest isabout several seconds (triggered modes). Due to the internal timing of thecamera the program will adjust the values to the appropriate values.

•

Acquisition control (Start/Stop)•

Single capture button (Snap)•

Exposure•

Exposure delay•

Trigger polarity (positive/negative)•

Single capture button: Takes a single shot of the actual scene•

Inter-packet delay

The inter-packet delay has impact on a camera’s bandwidth usage. A setting of
an inter-packet delay of zero will send all image packets as fast as they areavailable dependent on the camera’s pixel clock, e.g. at 50 MHz. This is thepreferred setting when operating a single camera on a network interface.
In case of multiple cameras or other devices working on the same physicalnetwork it might be desirable to send the packets of a camera’s streaming
channel with a certain inter-packet delay in order to allow multiple cameras ordevices to share a given network bandwidth.
NOTE: The inter-packet delay should be below the value which would
decrease the frame rate.

5.2 Image•The image panel displays information about the picture geometry, the pixel
clock and it allows for the following settings:
AOI (area of interest) which can be less or equal the imager size•

Binning mode (off, vertical, horizontal, 2x2)
No Binning = full resolution: horizontal x 1, vertical x 1 (default setting)H2 x V2 x: vertical 2 x and horizontal 2 x at the same time; Resolution:
horizontal x ½, vertical x ½, Sensitivity is 4 x, pixel frequency is halved, max.
frame rate is almost doubled. “No Binning” sets the camera to full resolution,
H1 x 2 and 2 x 1 binning is also available•

If you need other binning mode configurations consult factory or your nearest
distributor.
Please note: Using binning with a color version of the camera will cause
incorrect colors and strange effects! However, for fast focusing it might beuseful.
Pixel depth (8-bit, 12-bit, 16-bit, if supported by camera)

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 22

•
•
•
•
•
•

Color (On/Off)
Bayer method (Disabled, Nearest neighbor, Simple, Bilinear, HQ Linear, Edge
Sense, Gray)
Factors for white balance (Red, Green, Blue)“Balance” button for performing automatic white balance“Equalize” button for setting all colors to 100%
Freeze (display switched off while acquisition continuous, for test purposes)
In addition the number of transferred frames is displayed as well as the numberof eventually lost frames. A frame loss may happen for example in case of an
insufficient network bandwidth or if the network connection gets interrupted fora short time or in case of other network failures.
Further the number of resent network packets is displayed. The second number
is the last resent packet number and the first number indicates the total
number of resent packets.

5.3 Gain
The gain panel allows for adjusting gain and autogain (planned) with thefollowing controls:
The default gain setting is “0” dB. You may change the gain up to 6 dB (orhigher) in steps of 1/10th. Note that the dark offset will increase and dynamic
range will not be improved. Please note that noise also is amplified. For good
image quality do not increase gain more than 6 dB; higher Gain is possible
but not specified!
For “F” version of svs1020,1050,2020 2050,2150 and 4021 only:
Please note that the CCD is used with 2 outputs. Therefore there are a“right” and a “left” image half. If you use the slider both channels are amplified.
However depending on the amplifications there might be different values
necessary in order to make both channels equal. Fine tuning in “Gain Value”
is necessary. It is still possible to have 1-2 counts difference between both
image halfs. This is NOT a camera problem and must be adjusted by anexperienced user. Same is true for the offset.
•

Gain (0…..18 dB) (The edit field allows for an extended gain upto about +36 dB, dependent on
the camera’s capabilities)

Autogain function can be enabled to avoid manual tuning. Note that
continuous tap balancing needs a few frames to adjust !!

5.4 Offset
Dark level offset adjustment is possible. When 8 Bit are transmitted it can bechanged from 0 to 255. Please note that factory adjustment is optimized for
S/N ratio and sensitivity. You may lose dynamic range. Alter only if you operate
at high temperatures like +40 °C. It can be altered for each channel separately(for 2 tap Kodak CCDs).

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 23

5.5 AutoGain/AutoExposure
When the “Auto” checkbox is activated for cameras that provide for the
AutoGain/AutoExposure feature, the “Luminance” panel changes to show thesettings that apply to this mode of operation. The manual settings for gain andoffset will disappear since the luminance will be controlled automatically.
The automated luminance control algorithm takes advantage of both, exposureand gain settings. First the exposure will be tried to adjust it such that a set
brightness value will be met. Once the highest exposure value has beenreached the algorithm will further increase luminance by increasing camera’s
gain. The upper and lower limits for both controls are available in the“Luminance” panel once the “Auto” checkbox is checked.
The actual exposure is shown on the “Acquisition” panel and the actual gain isdisplayed in the “Luminance” panel on the left to the “min” and “max” gain
settings.

5.6 Adjusting an AOI (area of interest)
When clicking on the “AOI” button in the “Image” panel a graph tablet becomesvisible that allows for defining an AOI by dragging and resizing a gray target
area with a red border inside the imager limits, represented by a rectangle withblack borders.

Whenever the left mouse button is released after dragging/resizing the target
area, the camera will be adjusted to the new settings. Alternatively the target
area can be defined numerically by entering values into the edit fields forSize/Offset and subsequently clicking on “Apply”. After clicking on “Apply” thegraph tablet will disappear and the new settings are stored in the camera.

5.7 Strobe•••

The strobe panel allows for accessing the following settings for controlling lightsources:
Strobe duration
Strobe delay (Start of strobe related to a trigger pulse)
Strobe polarity (positive/negative)

5.8 Persistence
The buttons in the persistence panel allow for saving and restoring all settings:

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 24

•
•
•
•

Save to EEPROM
Restore from EEPROM
Factory defaults
Close

6 Saving images to disk
The live image can be saved to disk with the “Save as” item in the Image
menu. After selecting a path and specifying a file name a picture in one of theformats JPEG, PNG (Portable Network Graphics), BMP or PIX (raw pixel data)
will be saved to disk. Saving of 16-bit images is supported by the PNG and PIX(raw pixel data) formats.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009p. 25

7 Assigning IO lines•

If a camera supports IO settings then the input and output lines can bearbitrarily assigned to actual data lines.
The following outputs are available:
OUT0

•

OUT1

•

OUT2

•

OUT3

•

OUT_TXDThe following input lines are available:•

UART_IN•

Trigger
When clicking on ‘Apply’ after making all adjustments then the new
assignments take effect. One has to click on ‘Save to EEPROM’ in order to makethem persistent. In case of any problems the ‘Factory defaults’ can be restored
by clicking on that button.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 26

8 Displaying a camera’s XML file
Accordingly to the GigE Vision standard a GigE camera provides for an XML filethat defines the camera’s capabilities. Though the XML file will usually beprocessed by software, the SVCapture application allows for displaying acamera’s XML file on screen and saving it to disk. This functionality is available
in the “Camera” menu when clicking on the “Show XML file” entry.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 27

9 Displaying a camera’s feature list
A SVGigE camera provides for a set of features out of a list of all definedfeatures. The “Feature list” entry in the “Camera” menu allows for getting
information which features a given camera provides for and which are notavailable.

10 Other menu items
File | Enable filter driver - Enable or disable a filter driver
File | Exit
- Leaving application
Window | Cascade- Cascade camera views in main window
Window | Tile
- Assign each camera view a share of main window
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 28

Window | Delete
About- Close camera view that currently has the focus- Program and version information

11 Context menu•

A context menu can be activated in the image window by right clicking on themouse inside that window. The following functions can be controlled by thismenu:
Displaying pixel coordinates and values•

Reducing the size of an image to 12,5%•

Reducing the size of an image to 25%•

Reducing the size of an image to 50%•

Restoring the original 100% size of an image•

Magnifying resolution to 200% (image fragment scrolled by left mouse click)•

Magnifying resolution to 400% (image fragment scrolled by left mouse click)•

Magnifying resolution to 800% (image fragment scrolled by left mouse click)

If “Pixel values” is selected the display switches in the bottom left corner todisplaying the min and max values at cursor position along with the difference
max-min which represents the image’s noise amplitude at cursor position:

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 29

11.1 Filter Driver
In order to lower CPU load on some PCs it is useful to save CPU power for othertasks. The driver delivered with the camera helps to do so. See Appendix D for
installation.

It is recommended always to enable the filter driver, otherwise
images can be lost!

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 30

11.2 Firmware update
A separate tool called “Firmware Update Tool.exe” is provided to execute a
firmware update.
Depending on the serial number a firmware update for the internal
camera logic might be useful or necessary. This can be essential in order to
use the current available SVCapture or SDK.
Using unmatched hardware and software (e.g. HW 1.2 with SW 1.4)
will NOT work. Numbering is consistent. So 1.4 SW requires 1.4 firmware!
In doubt please contact your local distributor.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 31

12 Technical Data
An easy logic allows the control of the camera by different signals to achieve
optimum image quality.

12.1 CCD used/cosmetic issues:•

Sony: ICX 424, ICX204, ICX267, ICX274, ICX 415 +ICX655 ( planned)

For Details see Sony ICX datasheets
Please note: Factory settings for gain/offset will be irrevocably
overwritten when confirming the final message box with OK.

12.2 Signal conditioning
The analog output of the sensor is conditioned by Correlated Double Sampling(CDS) for optimum S/N ratio. Dark level drift is compensated by an “auto zero”
amplifier circuit and fed into a video ADC with 14 Bit Bit resolution (typedependant). The data are fed into an internal 64 MB Memory. The camera iscontrolled by an FPGA and the data packages are sent via an Ethernet controller
to the PC.

12.3 Optical and mechanical issues•

Camera size: 38mm x 38mm x 33mm (without connectors and lens)•

Weight:•Front plate with CS-Mount adapter. 5 mm adapter for C-mount.

•

Distance from Chip surface to frontplate: 11.65mm when C-mountlens is used

Approx. 100 gram

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 32

Views on Camera eco424, 415, eco204, eco267, eco274
front plate with CS-Mount adapter

44,5
39,5

26

38

38
26

4x

M3
32,5

Use 4 x M3 holes in frontplate for mounting !!!
Proper heatsinking is required !!

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 33

Rear View

HR10A-10P-12S (mating connector HR10A-10R-12PB)
1 VIN- (GND)
2 VIN+ (9 to 24VDC)
3 RXD data to camera (RS232 Level)
4 TXD data from camera (RS232 Level)
5 IN1 (open drain 3- 30 V) +/- can be reversed
6 IN2 (open drain 3- 30 V) +/- can be reversed
7 OUT1 (open drain max 30 V) +/- can be reversed
8 OUT2 (open drain max 30 V +/- can be reversed
9 IN3+ (RS422 Level)
10 IN3- (RS422 Level)
11 OUT3 + (RS422 Level)
12 OUT3- (RS422 Level)

OptionMounting Bracket ( do not scale)

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 34

Basic electro-optic Specifications of Cameras
eco424CCD ICX 424 1 1/3”
Interline

640 x 480 Pixel

Pixelclock
Frame Rate (max.)
Frame Rate
(2 x 2 Binning)
OffsetGain
S/N Ratio

1 x 50 MHz
124 fps

Fixed Pattern Noise
Photo Response Nonuniformity (PRNU)
Spectral Response
Exposure Time(mode 2)
Power consumption

Pixel Size 7.4 x
7.4 µmca. 40 counts in 12 Bit
18 db> 54dB (9 Bit),(Saturation/Dark Noise(RMS))
ca. 8 counts in 12 Bit+/- 10%380 – 950 nm
3 µsec – 2 sec

Monochrome

3.3W (0.27A @ 12V)

eco415CCD ICX 415 1/2”
Interline

780 x 580 Pixel

Pixelclock
Frame Rate (max.)
Frame Rate
(2 x 2 Binning)
OffsetGain
S/N Ratio

1 x 50 MHz
86 fpsFixed Pattern Noise
Photo Response Nonuniformity (PRNU)
Spectral Response
Exposure Time(mode 2)
Power consumption

Pixel Size 8.3 x
8,3 µmca. 40 counts in 12 Bit
18 db> 54dB (9 Bit),(Saturation/Dark Noise(RMS))
ca. 8 counts in 12 Bit+/- 10%380 – 950 nm
22 µsec – 2 sec

Monochrome

3.5W (0.29A @ 12V)

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 35

eco204
CCD ICX 204 1/3”
Interline

1024 x 768 Pixel

Pixelclock
Frame Rate (max.)
Frame Rate (2 x 2
Binning)
Offset1 x 50 MHz
47 fps

Gain

18 db

S/N Ratio> 50dB (8.5 Bit),(Saturation/Dark Noise(RMS))
ca. 40 counts in 12 Bit

Fixed Pattern Noise
Photo Response Nonuniformity (PRNU)
Spectral Response
Exposure Time(mode 2)
Power consumption

Pixel Size 4,65 x
4,65 µm

ca. 40 counts in 12 Bit+/- 10%380 – 950 nm
17 µsec – 2 sec

Monochrome

3.4W (0.28A @ 12V)

eco267CCD ICX 267 1/2”
Interline

1360 x 1024 Pixel

Pixelclock
Frame Rate (max.)
Frame Rate (2 x 2
Binning)
Offset1 x 50 MHz
25 fps

Gain

18 db

S/N Ratio> 54dB (9 Bit),(Saturation/Dark Noise(RMS))
ca. 8 counts in 12 Bit

Fixed Pattern Noise
Photo Response Nonuniformity (PRNU)
Spectral Response
Exposure Time(mode 2)
Power consumption

Pixel Size 4,65 x
4,65 µm

ca. 40 counts in 12 Bit+/- 10%380 - 950 nm
40 µsec – 2 sec

Monochrome

3.5W (0.29A @ 12V)

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 36

eco274
CCD ICX 274 1/2”
Interline

1600 x 1200 Pixel

Pixelclock
Frame Rate (max.)
Frame Rate (2 x 2
Binning)
Offset1 x 50 MHz
20 fpsGain

1 to 2

S/N Ratio> 54dB (9 Bit),(Saturation/Dark Noise(RMS))
ca. 8 counts in 12 Bit

Fixed Pattern Noise
Photo Response Nonuniformity (PRNU)
Spectral Response
Exposure Time(mode 2)
Power consumption

Pixel Size 4,4 x
4,4 µmca. 40 counts in 12 Bit+/- 10%380 - 950 nm
26 µsec – 2 sec

Monochrome

3.9W (0.32A @ 12V)

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 37

12.4 Environmental Issues
4.8.1 Europe
The camera is CE tested and the rules of EN 50022-2 apply.
4.8.2 USA and Canada
I. Labeling requirements:
This device complies with part 15 of the FCC Rules. Operation is subject to thefollowing two conditions: (1) This device may not cause harmful interference,and (2) this device must accept any interference received, includinginterference that may cause undesired operation.
II. Information to the user:
Note: This equipment has been tested and found to comply with the limits for aClass A digital device, pursuant to part 15 of the FCC Rules. These limits aredesigned to provide reasonable protection against harmful interference whenthe equipment is operated in a commercial environment. This equipment
generates, uses, and can radiate radio frequency energy and, if not installed
and used in accordance with the instruction manual, may cause harmfulinterference to radio communications. Operation of this equipment in a
residential area is likely to cause harmful interference in which case the user
will be required to correct the interference at his own expense.
It is necessary to use a shielded power supply cable. You can than use the“shield contact” on the connector which has GND contact to the camera
housing. This is essential for any use. If not done and camera is destroyed due
to Radio Magnetic Interference (RMI) WARRANTY is void!
•

Operating temperature Spec: -10 to +40 °C
In order to keep dark current low. To achieve 9 optical Bit, operation at
25 °C max. is recommended.

•Power:
US/UK and European line adapter can be delivered.
Otherwise use +10 to +24V DC with filtered and stabilized power supply.

•

Shock is tested: About 30 g in 6 ms. Vibration test is 10 g in 6 ms•

RoHS: All cameras comply with the recommendation of the European Union
concerning RoHS Rules.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 38

12.5 Spectral response curves
Monochrome Version
All Color Version
eco424, eco 415, eco204, eco267, eco247
1.0

1.0

0.9
0.8

0.7

Relative response

Relative resp onse

0.8

0.6
0.5
0.4
0.3

0.6

0.4

0.2

0.2
0.1
0.0
400

0.0

500

600

700

800

900

1000

400

Wavelength [nm]Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

450

500

550

600

650

700

Wavelength [nm]p. 39

12.6 Comments on camera temperature
There is no need to worry because the camera has been tested at higher
temperatures than specified (40 °C).

12.7 Comments on Color Version
If you have purchased a color version (e.g. ecoZZZXVGE) of this camera,
please note the following:
In all electrical terms the camera is identical to the black and white versions.
The camera uses a CCD which has a color mosaic filter. This filter is called"Bayer"-filter named after the person who invented it. It has a pattern on thelines which alternates as follows, e.g.:First line:
Second line:

RGRGRG.... and so on (R = Red, B = Blue, G = Green)
GBGBGB.... and so on

Please note that about half of the pixel are green, a quarter red and a quarter
blue. This is due to the maximum sensitivity of the human eye at about 550 nm(green).
Note that the green pixel in the “red” line has different sensitivity than
the green pixel in the “blue” line.
Because this camera is a single chip camera it is necessary to use an algorithm
which interpolates those colors which are "not known" by the specific pixel. E.g.
the red pixel does not know its green and blue components.
This means that the performance of the image depends on the software used.
Please be aware that it is not possible to incorporate the algorithm into thecamera so easily. Unlike NTSC/PAL cameras there is no hardware chip available
which can do that for such large images. The user has the advantage to alter
the colors depending on his needs. Thus the color image must be processed in
the PC.
We offer several algorithms in the SVCapture program which influence display
rate and image quality. However a color source code is available on request for
those who want to write an application.
We offer a complete set for a system setup containing camera, cable, power
supply, and software to help solving your applications.
Note that you can disable the color in the SVCapture program. Color
processing is not done inside the camera but in the PC. So some CPU
power is consumed.
If you have questions do not hesitate to contact us or your local dealer.
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 40

13 Warranty Terms
13.1 Standard products warranty and adjustment
Seller warrants that the article to be delivered under this order will be free fromdetects in material and workmanship under normal use and service for a periodof TWO years from date of shipment. The liability of Seller under this warranty
is limited solely to replacing or repairing or issuing credit (at the discretion for
Seller) for such products that become defective during the warranty period.
In order to permit Seller to properly administer this warranty, Buyer shall notify
Seller promptly in writing of any claims,; provide Seller with an opportunity toinspect and test the products claimed to be detective. Such inspection may be
on customer’s premises or Seller may request return of such products at
customer’s expense. Such expense will subsequently be reimbursed tocustomer if the product is found to be defective and Buyer shall not return any
product without prior return authorization from Seller.
If a returned product is found to be out of warranty or found to be within theapplicable specification, Buyer will have to pay an evaluation and handlingcharge, independent of possible repair and/or replacement costs. Seller will
notify Buyer of the amount of said evaluation and handling charges at the time
the return authorization is issued. The Seller will inform the Buyer of related
repair and/or replacement costs and request authorization before incurring suchcosts. Buyer shall identify all returned material with Sellers invoice number,
under which material has been received.
If more than one invoice applies, material has to be clearly segregated andidentified by applicable invoice numbers. Adjustment is contingent upon Sellers
examination of product, disclosing that apparent defects have not been causedby misuse, abuse, improper installation of application, repair, alteration,
accident or negligence in use, storage, transportation or handling. In no event
shall Seller be liable to Buyer for loss of profits, loss of use, or damages of any
kind based upon a claim for breach of warranty.

13.2 Development Product Warranty
Developmental products of Seller are warranted to be free from defects inmaterials and workmanship and to meet the applicable preliminary specification
only at the time of receipt by Buyer and for no longer period of time in all otherrespects the warranties made above apply to development products.
The aforementioned provisions do not extend the original warranty period of
any article which has been repaired or replaced by Seller. If Warranty Label ofcamera is broken Warranty is void!
SELLER MAKES NO OTHER WARRANTIES; EXPRESS OR IMPLIED; AND
SPECIFICALLY; SELLER MAKES NO WARRANTY OF MERCHANTABILITY OF
FITNESS FOR PARTICULAR PURPOSE.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 41

14 Appendix A – Troubleshooting
14.1 Get camera diagnostics
When clicking on the Camera | Diagnostics menu entry a dialog will open thatallows for receiving camera diagnostics information.

The content of the Diagnostics window is low level register information. Usually
it is needed only for remote analysis purposes of problem situations.

The following items provide some hints how to solve problem situations where aconnection between a PC and a camera can not be established successfully.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 42

Problem:A camera does not appear in the discovery dialog

Solutions:

Click on “Refresh” in order to repeat the Discovery action.
Disconnect and reconnect the camera’s power cable and repeat
the Discovery action after a few seconds. Make sure the PC has
got a valid IP address.Shutdown and restart the PC and repeat the
Discovery action. Check firewall settings (See “Firewall
considerations” below).

Problem:A camera does not display a picture after it has been
discovered and selected

Solutions:

Force a valid IP address in to the camera using the dialog thatcomes up when right- clicking on an entry in the discovery dialog.
Close the camera view and select the camera again in the
Discovery dialog. Shutdown and restart the PC and select thecamera again after discovery. Check firewall settings (e.g. disablefirewall temporarily and select the camera again after discovery).
Check if the processor speed of the PC is sufficient for displaying
images at the chosen frame rate. If available, connect the camera
to a different network card.

Problem:

No communication is possible between the camera and thePC

Solution:

Check if a firewall is active. This can prevent to establish any
communication because this is a network issue check firewall
setting. Try to disable temporary the firewall and try again.

Problem:

The video stream stops when adjusting the camera settings

Solution:

This situation happens when the product between frame rate andexposure time becomes 1 second or greater. Any of the settings
can be reduced in order to get the camera operational again. The
exposure settings field will become red in order to signal that oneof the frame rate or exposure setting has to be reduced.

Problem:

Camera does not respond to light

Solution:

Please execute following steps:
Check if camera is in a “Free Running”-mode. When done, checkwith “SVCapture” program if you can read back any data from thecamera like: Type of CCD, S/N number exposure time settings andso on. If you trigger the camera by hardware: Check if the Exsync
signal is present. The signal swing for must be minimum 5V (max.
24V) Source must provide 10 mA. Below such level the drivers in
the camera will not work. Check also the quality and swing. If
these signals are not there or do not have the right quality (likespikes) the camera can not read out any frame or delivers
distorted images.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 43

Problem:

The image is present but distorted

Solution:

Try different operation mode. Like if triggered gives bad results try“Free Running” mode and reduce frame rate to minimum half
possible one. Check if you are using original “INTEL”® chip set inyour PC! If problem still exist call your local support.

Problem:

The image of a color version camera looks “ugly” or false
colors appear.

Solution:If the raw image looks ok than pixel need to be shifted by either
one or one line. The image color depends on the algorithm used. If
the algorithm is starting with the wrong pixel such effects appear.

Problem:

The colors of a color version are not perfect especially whenusing halogen light

Solution:

Halogen light contains strong portions of IR radiation. Use cut off
filters at around 730 nm like Schott KG 3 to prevent IR radiation
reaching the CCD.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 44

15 Troubleshooting Request List V1.3
Dear valued customer,
In order to help you with your camera and any interfacing problems we requestthat you fill in a description of your problems when you use the camera. Please
fax this form to us:
1)

Type of camera (e.g. eco247XVGE)

2)

Serial Number

3)

Accessories used and where purchased or self madea) Power supplyb) Cablec) Lens type and focal length4)

Firmware version as well as operation mode, (send screenshot of
SVCapture program)

5)

Description of the phenomena, e.g.:a) missing lines or columnsb) distorted or noisy image (if possible send jpg image)c) solarization effectd) missing Bit, contrast less image

6)

PC used, Chip Set/Brand and type of Ethernet card

7)

Operating system used, e.g. WIN/2000/XP

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 45

16 Appendix B – Basic timing for different operation
modes
16.1 Free Running
A frame is readout automatically. There is no need to trigger the camera inorder to get data. The enclosed software allows the user to set exposure time inµSec. The time set stays resident after power off if the configuration is saved tocamera if stored before.
Exposure
time

Data

16.2 External Trigger and Pulsewidth of Trigger
In this mode the camera is waiting for an external trigger which starts
integration and read out. Exposure time can be varied using the length of the
Trigger pulse (I.E. between the high going edge and the low going edge). The
time settings in the control software are not activated. This mode is useful inapplications where the light level of the sceen changes during operation and theframegrabber can provide such a signal. Change of exposure time is possible
from one frame to the next.
Trigger
Exposuretime
Data

16.3 External and Software trigger and internal exposure time
setting
The frame rate is determined by the number of Trigger pulses per time unit.
With each positive transition (going high) the camera will readout a frame.
Exposuretime is set in the same way as in the free running mode. Exposure
time can be changed online during operation. The time set stays resident after
power off, if the configuration is saved to the camera.

Trigger
Exposuretime
Data

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 46

17 Appendix C: SDK Description for Camera Control

SVGigE API
GigE Vision Camera
Software Development Kit (SDK)

Version:Date:

1.4.16.38
30.06.2009

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 47

17.1 Overview
The GigE Vision standard is an award-winning specification for connecting
cameras to computers by a Gigabit Ethernet cable. That type of connection iswell suited for transferring the huge data streams that are usually related toimage capturing devices. The current SVS GigE API software development kit(SDK) provides for integrating GigE cameras into own applications.

17.2 Prerequisites
In order to give an example for data transfer requirements, a camera with aresolution of 1600 by 1200 pixels and which is running at 35 frames per second
will generate a data stream of 1600 x 1200 x 35 = 67,2 Mbytes per second. The
bandwidth of the network connection must be capable of transferring the image
data stream from the camera to the client computer with the image viewing orprocessing application.
Before a GigE camera can be successfully used in a system, all network
parameters have to be adjusted to appropriate settings. This will be done by
the SVCapture program which usage is described in the “SVCapture user guide”
document. A successful work with the SVS GigE API software development kit
can be accomplished only when it has been proved that a camera can be
operated over the network on full frame rate from the PC where the softwaredevelopment takes place.

17.3 SVGigE SDK components
The SVGigE SDK consists of the following components:•

SVGigE.h•

SVGigE.cpp•

SVGigE.dll•

SVGigE.sys•

SVGigETLFilter.dll•

SVGigETLWinsock.dll•

SVGigE SDK user guide.pdf (this document)
The DLL components have to be in the same directory as the executableor alternatively they can be put into the windows\system32 directory. The
header file and the cpp file will usually be put into the development directories.
They are needed for developing applications under various development
environments.
Before running the SVGigEFilter.dll the SVGigE driver has to be installedaccordingly to the instructions in the “SVCapture user guide” documentation.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 48

17.4 Development environments
The SVGigE SDK has been designed as DLL components (one API and two
transport layers: filter driver and winsock based) which export C-style functions
to be used by applications. A cpp file is provided in the SDK which implements
the more than 100 functions that constitute the SVGigE API. The cpp fileforwards function calls from the software application to the corresponding
functions that are contained in the API-DLL module. For this purpose the DLL
modules will be loaded once when the first function call arrives in the API.
The chosen programming interface of the API-DLL module is the least common
denominator which should ensure a broad applicability of the DLL module inmost programming environments that can compile C code. Three example
applications are currently provided that comprise the Borland C++ Builder 6environment, the Microsoft VisualStudio 6 as well as the Microsoft Visual Studio2005 environments.
The example applications show how to get a handle on a camera in the own
network, how to adjust settings like frame rate and exposure time as well as
how to receive the image data stream by a callback function in the application.
For demonstration purposes the image data stream is being displayed on screen
as a live image from the selected camera.

17.5 Windows x64 support
The SVGigE SDK supports 64-bit platforms. All functions in the SVGigE API
apply to x64 platforms in the same way as they do for Win32 platforms.
Although win32 applications like SVCapture.exe are also supported on x64
platforms in the compatibility mode, there exists a set of runtime componentsthat run natively on x64 platforms:•

x64\SVGigE.sys – a filter driver for high-performance image streaming•

SVGigETLFilter.x64.dll – a transport layer DLL for the SVGigE driver•

SVGigETLWinsock.x64.dll – a transport layer DLL based on Winsock•

SVGigE.x64.dll – the SVGigE API DLL used by camera applications•

SVGigE_ExampleVC8.x64.exe – a sample application using all listed
components

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 49

17.6 Documentation
The SVGigE API documentation is provided in the following documents:•

SVGigE SDK user guide.pdf – an overview documentation (this document)•

SVGigE.h – a header file with inline documentation for each function•

Documentation\index.html – a html based documentation that has been
generated from the inline information in the SVGigE.h document

17.7 System architecture

DLL
Cameracontainer
client 1

Cameradevice 1

Camera 1
Streamingchannel 1

Cameradevice 2

Cameracontainer

Cameracontainer
client 2

Camera 2
Streamingchannel 2

Camera Y
Cameradevice C

Cameracontainer
client X

Streamingchannel Z

The system architecture has been chosen accordingly to the following
objectives:•

Multiple cameras can be connected over the network to a single PC where a
SVGigE.dll along with transport layer DLLs provide for a simultaneous access toall cameras•

Multiple client applications can use the same SVGigE.dll for connecting tocameras•An application can use a subset or all of the cameras simultaneously•

Multiple streaming channels can be opened by an application, one to each of thecameras in order to perform different further image processing, for example
sending all images to a viewer and running an image processing on them foreach of the images
NOTE: Currently each camera should be controlled only by a single dedicatedapplication although the system architecture would allow for connecting
multiple applications to a single camera. The reason is that each camera
maintains only a single control channel. Thus a second client application would

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 50

not get a handle on the camera as long as another client maintains a control
channel to that camera.
Looking at the system architecture it should become obvious that the DLL needsa handle for performing operations on a camera container, on a camera or on a
streaming channel respectively. The client application will obtain those handles
when registering for a camera container client, a camera or a streaming
channel respectively. Those handles have to be stored locally and be used in all
subsequent function calls to the different areas in the DLL. All handles will bevalid until closure activities will be performed for a streaming channel, a camera
or a camera container client respectively.

17.8 Function groups* Function categories:* --------------------------------------------------------* 1 - Camera: Discovery and bookkeeping* 2 - Camera: Connection* 3 - Camera: Information* 4 - Stream: Channel control and statistics* 5 - Stream: Transfer parameters* 6 - Stream: Image access* 7 - Stream: Image conversion* 8 - Stream: Image characteristics* 9 - Stream: Image statistics* 10 - Stream: Messaging channel* 11 - Controlling camera: Frame rate
* 12 - Controlling camera: Exposure* 13 - Controlling camera: Gain and offset* 14 - Controlling camera: Auto gain/exposure* 15 - Controlling camera: Acquisition trigger* 16 - Controlling camera: Strobe* 17 - Controlling camera: Tap balance* 18 - Controlling camera: Image parameter* 19 - Controlling camera: Image appearance* 20 - Special control: IOMux configuration* 21 - Special control: IO control* 22 - Special control: Serial communication* 23 - Special control: Direct register and memory access* 24 - Special control: Persistent settings and recovery* 25 - General functions* 26 - Diagnostics* --------------------------------------------------------* 99 - Deprecated functions

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 51

17.9 Detailed function listing** 0 - GigE DLL (implicitly called)* --------------------------------* isVersionCompliantDLL()* isLoadedGigEDLL()* getCamera()** 1 - Camera: Discovery and bookkeeping* ------------------------------------* CameraContainer_create()* CameraContainer_delete()* CameraContainer_discovery()* CameraContainer_getNumberOfCameras()* CameraContainer_getCamera()* CameraContainer_findCamera()** 2 - Camera: Connection* ---------------------* Camera_openConnection()* Camera_closeConnection()* Camera_setIPAddress()* Camera_forceValidNetworkSettings()** 3 - Camera: Information* ---------------------* Camera_getManufacturerName()* Camera_getModelName()* Camera_getDeviceVersion()* Camera_getManufacturerSpecificInformation()* Camera_getSerialNumber()* Camera_setUserDefinedName()* Camera_getUserDefinedName()* Camera_getMacAddress()* Camera_getIPAddress()* Camera_getSubnetMask()* Camera_getPixelClock()* Camera_isCameraFeature()* Camera_readXMLFile()** 4 - Stream: Channel control and statistics* -----------------------------------------* StreamingChannel_create()* StreamingChannel_delete()* StreamingChannel_setReadoutTransfer()* StreamingChannel_getReadoutTransfer()* StreamingChannel_getFrameLoss()* StreamingChannel_getActualFrameRate()* StreamingChannel_getActualDataRate()* StreamingChannel_getPeakDataRate()** 5 - Stream: Transfer parameters
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 52

* ------------------------------* Camera_evaluateMaximalPacketSize()* Camera_setStreamingPacketSize()* Camera_setInterPacketDelay()* Camera_getInterPacketDelay()* Camera_setMulticastMode()* Camera_getMulticastMode()* Camera_getMulticastGroup()** 6 - Stream: Image access* -----------------------* Image_getDataPointer()* Image_getBufferIndex()* Image_getSignalType()* Image_getCamera()* Image_release()** 7 - Stream: Image conversion* ---------------------------* Image_getImageRGB()* Image_getImageGray()* Image_getImage12bitAs8bit()* Image_getImage12bitAs16bit()* Image_getImage16bitAs8bit()** 8 - Stream: Image characteristics* --------------------------------* Image_getSizeX()* Image_getSizeY()* Image_getPitch()* Image_getImageSize()* Image_getPixelType()** 9 - Stream: Image statistics* ---------------------------* Image_getImageID()* Image_getTimestamp()* Image_getTransferTime()* Image_getPacketCount()* Image_getPacketResend()** 10 - Stream: Messaging channel* -----------------------------* Stream_createEvent()* Stream_addMessageType()* Stream_removeMessageType()* Stream_isMessagePending()* Stream_registerEventCallback()* Stream_unregisterEventCallback()* Stream_getMessage()* Stream_getMessageData()* Stream_getMessageTimestamp()* Stream_releaseMessage()* Stream_flushMessages()
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 53

* Stream_closeEvent()** 11 - Controlling camera: Frame rate
* ----------------------------------* Camera_setFrameRate()* Camera_getFrameRate()* Camera_getFrameRateMin()* Camera_getFrameRateMax()* Camera_getFrameRateRange()* Camera_getFrameRateIncrement()** 12 - Controlling camera: Exposure* --------------------------------* Camera_setExposureTime()* Camera_getExposureTime()* Camera_getExposureTimeMin()* Camera_getExposureTimeMax()* Camera_getExposureTimeRange()* Camera_getExposureTimeIncrement()* Camera_setExposureDelay()* Camera_getExposureDelay()* Camera_getExposureDelayMax()* Camera_getExposureDelayIncrement()** 13 - Controlling camera: Gain and offset* ---------------------------------------* Camera_setGain()* Camera_getGain()* Camera_getGainMax()* Camera_getGainMaxExtended()* Camera_getGainIncrement()* Camera_setOffset()* Camera_getOffset()* Camera_getOffsetMax()** 14 - Controlling camera: Auto gain/exposure* ------------------------------------------* Camera_setAutoGainEnabled()* Camera_getAutoGainEnabled()* Camera_setAutoGainBrightness()* Camera_getAutoGainBrightness()* Camera_setAutoGainDynamics()* Camera_getAutoGainDynamics()* Camera_setAutoGainLimits()* Camera_getAutoGainLimits()* Camera_setAutoExposureLimits()* Camera_getAutoExposureLimits()** 15 - Controlling camera: Acquisition trigger* -------------------------------------------* Camera_setAcquisitionControl()* Camera_getAcquisitionControl()* Camera_setAcquisitionMode()* Camera_setAcquisitionModeAndStart()
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009p. 54

* Camera_getAcquisitionMode()* Camera_softwareTrigger()* Camera_softwareTriggerID()* Camera_softwareTriggerIDEnable()* Camera_setTriggerPolarity()* Camera_getTriggerPolarity()** 16 - Controlling camera: Strobe* ------------------------------* Camera_setStrobePolarity()* Camera_getStrobePolarity()* Camera_setStrobePosition()* Camera_getStrobePosition()* Camera_getStrobePositionMax()* Camera_getStrobePositionIncrement()* Camera_setStrobeDuration()* Camera_getStrobeDuration()* Camera_getStrobeDurationMax()* Camera_getStrobeDurationIncrement()** 17 - Controlling camera: Tap balance* -----------------------------------* Camera_saveTapBalanceSettings()* Camera_loadTapBalanceSettings()* Camera_setTapConfiguration()* Camera_getTapConfiguration()* Camera_setAutoTapBalanceMode()* Camera_getAutoTapBalanceMode()* Camera_setTapBalance()* Camera_getTapBalance()** 18 - Controlling camera: Image parameter* --------------------------------------* Camera_getImagerWidth()* Camera_getImagerHeight()* Camera_getSizeX()* Camera_getSizeY()* Camera_getPitch()* Camera_getImageSize()* Camera_setBinningMode()* Camera_getBinningMode()* Camera_setAreaOfInterest()* Camera_getAreaOfInterest()* Camera_getAreaOfInterestRange()* Camera_getAreaOfInterestIncrement()* Camera_stampTimestamp()* Camera_getTimestamp()** 19 - Controlling camera: Image appearance* ----------------------------------------* Camera_getPixelType()* Camera_setPixelDepth()* Camera_getPixelDepth()* Camera_setWhiteBalance()
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009p. 55

* Camera_getWhiteBalance()* Camera_getWhiteBalanceMax()* Camera_setGammaCorrection()* Camera_setLookupTableMode()* Camera_getLookupTableMode()* Camera_setLookupTable()* Camera_getLookupTable()** 20 - Special control: IOMux configuration* ------------------------------------------------------* Camera_getMaxIOMuxIn()* Camera_getMaxIOMuxOut()* Camera_setIOAssignment()* Camera_getIOAssignment()** 21 - Special control: IO control* ------------------------------------------------------* Camera_setIOMuxIn()* Camera_getIOMuxIn()* Camera_setIO()* Camera_getIO()* Camera_setAcqLEDOverride()* Camera_getAcqLEDOverride()* Camera_setLEDIntensity()* Camera_getLEDIntensity()** 22 - Special control: Serial communication* ------------------------------------------------------* Camera_setUARTBuffer()* Camera_getUARTBuffer()* Camera_setUARTBaud()* Camera_getUARTBaud()** 23 - Special control: Direct register and memory access* ------------------------------------------------------* Camera_setGigECameraRegister()* Camera_getGigECameraRegister()* Camera_writeGigECameraMemory()* Camera_readGigECameraMemory()** 24 - Special control: Persistent settings and recovery* -----------------------------------------------------* Camera_writeEEPROM()* Camera_readEEPROM()* Camera_restoreFactoryDefaults()** 25 - General functions* ---------------------* SVGigE_estimateWhiteBalance()* SVGigE_writeImageToBitmapFile()** 26 - Diagnostics* ---------------* getErrorMessage()
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009p. 56

* Camera_registerForLogMessages()** --------------------------------------------------------* 99 - Deprecated functions* --------------------------------------------------------* Camera_startAcquisitionCycle()* Camera_setTapCalibration()* Camera_getTapCalibration()* Camera_setLUTMode()* Camera_getLUTMode()* Camera_createLUTwhiteBalance() *Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 57

17.10Best programming practices

In the following a step-by-step procedure will be given how to communicate toa SVCam GigE camera by a software application. A working application that
implements all hints can be found in the sources of the SVGigE_Example.VC8
program which comes as a part of the SVGigE SDK.
The project file of the SVGige_Example.VC8 program was generated by the
Visual Studio 2005 development environment which can be used to compile theproject in order to get to a running application:
NOTE: An application which was compiled with Visual Studio 2005 needs aruntime environment in order to run on a WinXP computer. Dependent on thesoftware components that have already been installed on the target computer it
might be necessary to install the Microsoft VC runtime package (vcredist_x86.exe)
in addition to the runtime DLLs that are shipped with Visual Studio 2005. A
discussion of the involved problems can be found here:
http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=164132&SiteId=1

17.10.1 Connecting to the camera container
Whenever an application is going to operate SVCam GigE cameras it has tobecome a client of the camera container first which is located inside the
SVGigE.dll module.
CameraContainerClient_handle CameraClient;
CameraClient = CameraContainer_create(SVGigETL_TypeWinsock);

When establishing a connection to the camera container the application will
demand for the type of transport layer to be used for the network connection to
the camera, either a FilterDriver (recommended) or a Winsock (for first testing
purposes) based transport layer. The FilterDriver based transport layer
guaranties the highest possible performance
Once the application is done with cameras the connection to the container will
be closed what will allow the SVGigE DLL to release all resources which were
occupied for that client.
CameraContainer_delete(CameraClient);

Between becoming a camera client and shutting down the connection to thecamera container an application will be allowed to operate all SVCam GigE
cameras that are available in the attached network segment. The CameraClient
handle is used for identifying the application against the camera container
module inside the SVGigE.dll.

17.10.2 Connecting to a camera
Based on a valid connection to the camera container an application can query
for available cameras and can open connections to one or multiple cameras.
Camera_handle Camera;if( SVGigE_SUCCESS != CameraContainer_discovery(CameraClient) )return;int NumCameras = CameraContainer_getNumberOfCameras(CameraClient);
if( 0 == NumCameras )return;Camera = CameraContainer_getCamera(CameraClient, Index);// Index < NumCameras

The Camera handle relates a specific camera to an application. The application
will have to open a connection to the camera before being able to issuecommands to the camera and to initiate an image stream.
Camera_openConnection(Camera);

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 58

Once an application is done with a camera it needs to close the connection andthus allowing the camera container to release all resources that have been kept
occupied in meantime for the active application-camera relation.
Camera_closeConnection(Camera);

After a camera connection has been closed it can be re-opened again at any
time as long as the program is a valid client to the camera container.
Opening a camera requires the existence of a valid IP address in the camera.
The easiest way for making sure connectivity is to force valid network settings:
unsigned int IPAddress;
unsigned int SubnetMask;
SVGigERet = Camera_forceValidNetworkSettings(Camera, &IPAddress, &SubnetMask);

That function will do nothing in case the camera has already got a valid IP
address. If this is not the case the function will first force a free IP address incurrent subnet into the camera. Subsequently that IP address may be assigned
as a fixed IP address to the camera if this is wanted:
Camera_setIPAddress(hCamera,IPAddress,NetMask);

When the available cameras in the attached network segment have changed itwill be necessary to run the discovery command again in order to synchronize theinformation in the camera container with the actually available set of camerasin the network. Afterwards one has to take care since a previous index of a
specific camera might have changed in meantime.
Alternatively to selecting a camera by index a search string can be provided toa findCamera function:
Camera = CameraContainer_findCamera(CameraClient, CameraItem);In this case a string CameraItem will be provide to a camera container function
which tries to find a match between all discovered cameras where the given
string is contained in at least one of the MAC address, IP address, serial number
and user defined name items.

17.10.3 Identifying a camera
Every GigE camera maintains a set of information strings which allow for
identifying a camera in the network.
CString CameraName = Camera_getMacAddress(Camera);
CString CameraName = Camera_getIPAddress(Camera);
CString ModelName= Camera_getModelName(Camera);
CString Manufacturer = Camera_getManufacturerName(Camera);
CString SerialNumber = Camera_getSerialNumber(Camera);
CString DeviceVersion = Camera_getDeviceVersion(Camera);
CString CameraName = Camera_getUserDefinedName(Camera);

An application could query those strings and could display one or a combinationof those information strings to a user for allowing a selection of a specificcamera. However, applications that know beforehand which camera to use for agiven purpose can use the findCamera function that was described before.

17.10.4 Opening a streaming channel
The main goal for operating cameras is to get an image stream back to theapplication. Once a connection to the desired camera has been opened a stream
can be initiated and a callback function for receiving that stream can beregistered.
if( SVGigE_SUCCESS !=StreamingChannel_create (&StreamingChannel, // a streaming channel handle will be returned
CameraClient,// a valid camera container client handle
Camera,// a valid camera handle
BufferCount,// buffer count&ImageCallback,// callback function pointer where images are delivered tothis) )// the this pointer serves as a context that will be returned
return;// each time the callback function is called

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 59

The application will receive a handle for the streaming channel on success. That
handle will be used later for shutting down the streaming channel once theapplication has finished working with the channel.
StreamingChannel_delete(StreamingChannel);

Between opening and closing the streaming channel an application specificcallback function will be called for every image that the camera has captured. It
is up to the application to process the image further in that callback function.

17.10.5 Receiving images in a callback function
It is important that the application defines the callback function as __stdcall inorder to make sure that the arguments are passed through correctly.
SVGigE_RETURN __stdcall ImageCallback(Image_handle Image, void* Context);

The Context argument will have the same value as it was provided by theapplication when creating the streaming channel. It can be used for example forestablishing a reference to the object that is expected to receive that image
stream in one of its member functions.
In the Image parameter the application will find a handle to the just captured
camera image. That handle will be used to query all needed information about
the image from the SVGigE DLL. The image handle is valid only inside thecurrent call to the callback function. Any use of an image handle at a time will
always result in receiving an error code back from the function that was tried.
Thus the usual way for further image processing is to query all interesting
information inside the callback function and to copy that information into a
structure that remains accessible to the application after returning from thecallback function.
IMAGE_INFO *ImageInfo = new IMAGE_INFO;
ImageInfo->ImageData = Image_getDataPointer(Image);
ImageInfo->SizeX= Image_getSizeX(Image);
ImageInfo->SizeY= Image_getSizeY(Image);
ImageInfo->PixelType = Image_getPixelType(Image);
ImageInfo->ImageID = Image_getImageID(Image);

The newly allocated structure can be posted for example by a Windows
message to a function that is responsible for displaying the image or for further
image processing.

17.10.6 Processing image data
Once an image has been forwarded by a callback function to a specificprocessing function the image data will be worked on. Usually the camera has
already started capturing a subsequent image at the time when a previous
image is processed. This requires working with at least two image buffers inorder to avoid overwriting data that is being processed by a subsequent image
acquisition process.
The higher the delay between image acquisition and image processing becomesthe more buffer might be needed for avoiding any conflicts. The number ofneeded buffers has to be estimated based on the specific runtime conditions.
The resulting number will be passed to the GigE driver as an argument whencreating a streaming channel. The driver will allocate that number of buffers
where each buffer will have enough space for holding one complete image.
An image processing function will operate for example based on the following
parameters:
ImageInfo->ImageData
ImageInfo->SizeX
ImageInfo->SizeY

The ImageData pointer will be a reference to a buffer that was allocated by thedriver from persistent kernel memory and which address is mapped to user
space. The application is responsible for not violating the boundary that is givenby the product of the SizeX and SizeY parameters.
Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 60

In case of color images that are coded as bayer pattern the SVGigE API offers afunction for converting those images to a RGB format. The appropriate
conversion needs to be done inside the callback function.

17.10.7 Decoding 12-bit images
When a camera is switched to 12-bit mode the received image usually needs
decoding in order to further process that image e.g. for displaying purposes (8bit needed) respectively storage purposes (most often 16-bit needed). A
conversion will be based on the layout of 12-bit data where 2 pixels are folded
into 3 bytes in the following way:

The SDK provides for the following functions that perform conversion from 12bit to 8-bit and 16-bit as well as from 16-bit to 8-bit:
Image_getImage12bitAs8bit(Camera, Buffer8bit, BufferLength);
Image_getImage12bitAs16bit(Camera, Buffer16bit, BufferLength);
Image_getImage16bitAs8bit(Camera, Buffer8bit, BufferLength);17.10.8 Adjusting tap balance automatically
Whenever a dual-tap camera is opened by calling
Camera_openConnection(Camera);•••a balance check between the right and the left tap will be performed on the firstimage that is regularly captured by the application. In case of a need to run a
tap balance, new gain factors are determined for achieving an optimal tapbalance. It may take multiple images until a final balance is reached. Once abalance is adjusted, the tap balance is finished and the gain factors are notchanged anymore. Those gain factors will apply until the camera is closed.
An application can take more control over the auto tap balance process if this isneeded. The following options are offered for “auto tap balance” mode:
Off
Once
Continuous
An application can switch auto tap balance OFF before opening a streaming
channel in order to prevent from running any adjustments. Further anapplication can switch auto tap balance to ONCE at any time in order to run a
one-time adjustment of tap balance. Only in case of big changes of gain andexposure during a camera usage it might be recommended to switch auto tapbalance to CONTINUOUS. In that case every captured image is checked for tapbalance and individual gain factors for right and left balance are adjusted
appropriately whenever this is needed. There is no visible runtime penalty whenswitching auto tap balance to CONTINUOUS since only a small stripe left andright the middle of the sensor are taken into account for evaluating a deviationfrom tap balance.
The following two functions allow for switching the auto tap balance mode to
explained values and for retrieving current state:
Camera_setAutoTapBalanceMode(Camera, AutoTapBalanceMode);
Camera_getAutoTapBalanceMode(Camera, *AutoTapBalanceMode);

A reset to factory defaults or to arbitrary values inside a range of +/- 1.5 dB
can be performed by the following function. The second function retrieves
current setting:
Camera_setTapBalance (Camera, TapBalance);
Camera_getTapBalance (Camera, *TapBalance);

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 61

17.10.9 Distributing image streams by multicast
The image stream of a GigE camera can be distributed to multiple PCs by using
the multicast capabilities of current network hardware, in particular multicastenabled switches. The following picture explains the basic principle:

A camera streams image data in a certain IP range (232.x.x.x) which has been
determined for dynamic local host multicast allocation by the IANA organisation(see http://www.iana.org/assignments/multicast-addresses for more details).
A multicast-enabled switch is supposed to distribute the image stream to one,
two or more applications. The advantage of having a switch distributing image
streams is the optimal bandwidth usage between camera and switch as well as
between switch and particular applications. There is no bandwidth wasted in thedescribed scenario.
A multicast session consists of one controlling application and one or morelistening applications. Only the controlling application has write-access to thecamera. All other applications can only listen to the image stream that is
initiated and controlled by the controlling application.
The connection between the controlling application and the camera isestablished as usual based on IP addresses. However, a switch has to be
specifically instructed for forwarding an image stream also to one or morelistening application. This is done by network packets which are sent out by
applications regularly all 60 seconds and which detection in a switch is known
as “IGMP snooping”.
NOTE: A switch has to support “IGMP snooping” in order to establish a
successful multicast session. Most often that feature is switched off innormal mode and has to be enabled by the web interface of a switch. Pleaserefer to instructions of a switch that is supposed to work in multicast mode.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 62

Programming interface
When opening a camera, an application is supposed to check whether thecamera streams already in multicast mode using the function:
Camera_getMulticastMode()

The multicast mode will be one of the following items:•

MULTICAST_MODE_NONE•

MULTICAST_MODE_LISTENER•MULTICAST_MODE_CONTROLLER

If the camera is already streaming in multicast mode then the application canconnect to the camera but as listening application (MULTICAST_MODE_LISTENER).
Otherwise, if a camera is still idle (MULTICAST_MODE_NONE), an application canrequest for a multicast session by switching a camera’s mode to “multicast”(MULTICAST_MODE_CONTROLLER) before opening the streaming channel. The
appropriate function is:
Camera_setMulticastMode()

Afterwards the application might check the automatically generated IP for themulticast group in the “232.x.x.x” range using the following function:
Camera_getMulticastGroup()

Packet size consideration
A controlling application will usually open a streaming channel at the highest
available packet size, e.g. 16112 bytes. If another application connects to that
already running streaming channel then a packet size problem may arise if thelistening application has not at least the packet size available that the image
stream is currently working with.
Therefore a controlling application is supposed to limit the packet size of theimage data stream to a value which allows all intended listening applications toconnect to that image stream.
If a listening application encounters a packet size problem, it will usually receive
the start and stop packages of each image since those are of small size. This
causes a progress of image statistics like image counter, however, there will be
no image data (image payload) available. The packet size has to be reduced inthis case by the controlling application in order to allow all listening applications
for receiving all image payload data properly.
An application might choose to display a message to the user in the above
described case like “Image payload missing. Multicast packet size too big? “ as it wasdone in the “SVGigE_Example.VC8” application in the SDK.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 63

17.10.10

Receiving messages asynchronously

An application can receive messages like e.g. “start of transfer” asynchronously
in three different ways:
1. by registering an event callback
2. by using a blocking call when asking for new messages
3. by polling the event FIFO at arbitrary time
Before receiving any messages by event, an application will have to create a
new event and then register one or multiple message types against that event.
Afterwards, one of the above methods can be used for receiving events.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 64

18 Appendix D
18.1 Installation Instruction for Filter Driver installation
In order to use the SVS GigE driver it has to be installed first. The
setup will copy the driver to disk but will not install it. On a
standard Windows XP/2000 system this has to be done by the following steps:
Hint: Usually the driver will be copied by the setup procedure to thefollowing location:
C:\Program Files\SVS-VISTEK GmbH\SVS GigE SDK 1.2.1\SVS GigE FilterDriver
Step-by-step
Step 1: Open the Network Connections dialog

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 65

Step 2: Open the Properties dialog for LAN connections and click on “Install…”

Step 3: In the “Select Network Component Type” dialog select the Service
option and click on “Add…”Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 66

Step 4: In the “Select Network Service” dialog click on “Have Disk…”

Step 5: *In the “Install From Disk” dialog the folder where the driver
files are located needs to be navigated to or entered directly into thefiles field.*

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 67

Step 6: After clicking on OK the “Select Network Service” dialog will display amessage that the driver is not digitally signed. Click on OK.

Step 7: Because the driver not being digitally signed, a dialog will appear witha warning. Answer with “Continue Anyway” as often as needed.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 68

Step 8: After confirming the prior dialogs the driver is installed and should
show up as a new item in the “LAN Connections Properties” dialog.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 69

Step 9: The dialog can be closed and the “GigE Vision Driver SVS-VISTEKGmbH” is ready for use.
The main dialog in SVCapture will show an extension “FilterDriver” whichindicates that the driver will be used next time when opening a camera. If thisextension is not shown it can be activated in the “File | Enable filter driver”
menu item.

Step 10: Follow point 5 “Displaying Live Images” in this documentation forstarting an image view. If the driver was successfully installed and works
properly the externsion “FilterDriver” will remain in the main dialog’s caption.
Otherwise it will disappear and the SVCapture program falls back to operating
the GigE Vision camera over WinSock.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 70

19 Appendix E
19.1 PC and OS Requirements
It is recommended to use a PC with a Pentium P4 processor at 2.4 GHz or
higher. The camera is working also on lower frequencies but it might not deliver
the full frame rate in those cases. The operation system must be XP. We don’t
support WIN 98/ NT/2000 or older Operation systems. A Linux driver is – withsome limitations available. For VXworks a source code for driver development
can be offered on request. Interfacinging must be developed by the experienceduser.

19.2 Firewall considerations
The GigE Vision standard defines a communication based on UDP packets
between a GigE Vision compliant camera and a host PC. Often PC firewalls areadjusted to be restrictive and not to allow for sending UPD packets from theoutside of the PC to a port that has been opened by an application
Sometimes the firewall settings have been adjusted during installation of theoperating system or afterwards such that the user will be asked if the UDP data
stream should be enabled once a camera starts sending UDP packets to the PC.
When clicking OK in response to that question the application will be added to alist of exceptions. A firewall will let those applications communicate with
network devices like a GigE Vision camera over the network. In case theWindows installation has been adjusted such that the user will not be asked
when an outside device starts sending network packets to an application thenthat application has to be enabled manually in order to achieve the same as
before.An appropriate dialog can be opened for example when right-clicking on
the network icon in the tray and selecting “Change Windows.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 71

After clicking on the “Add Program…” button the GigE Vision application can besearched for in a file explorer and it will be added to the list of Exceptions in theabove dialog. Henceforth the communication to the GigE Vision compliant
device will be enabled.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 72

20 Appendix F
20.1 Firmware-Update with “GigE Update Tool.exe“ program
Note: In order to work with the latest driver and SVCapture it might benecessary to UPDATE the firmware inside the camera. This can be done in thefield. It is usually not necessary to send the camera in.
Warnings:•

Camera must have power•

Camera must be access able from PC via network•

Camera SHOULD NOT be used during programming procedure•

Camera SHOULD NOT be disconnected during programming procedure or bedisconnected from network•

Programming software SHOULD NOT be stopped during procedure.

•

It might take up to some minutes until it is completed.

Step1: Locate „svgigeup.exe“ using Windows Explorer

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 73

Step 2 Execute svgigeup.exe

Step 3 Select Camera (e.g. 1 and press Enter)

Step 4: Wait and follow instructions

YOU ARE DONE
After programming it is recommended to start the camera again. This means
you have to disconnect power and – after some seconds – power up again.

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 74

21 Appendix G
Basic circuits for Hardware Interfacing

As example : Use Hardwaretrigger connection on “IN1”
For Strobe use “OUT1”

TTL input circuit/ output ( i.e strobe )Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 75

22 Appendix H•

Safety Instructions•

In order to avoid personal injuries, or property damages against him/her or
people around him/her by using this product correctly.

•

Prior to use, read this section carefully to fully understand its instructions forcorrect use.

22.1 Definition of markings
The meaning of each mark used in this instruction manual is given below
DANGER

This mark warns the user that improper use, indicated with this mark,may cause death or severe personal injuries against the user or people
around him/her.
CAUTION This mark warns the user that improper use, indicated with this mark,may cause personal injuries (*1) or material damages (*2) against theuser or people around him/her.
Notes*1: Personal injuries meanwounds, burns, electric shocks,
and others for which the person
injured need neither to behospitalized nor to be cared for thelong term*2: Material damages mean any
direct or consequential damages
related to property or material loss
This mark indicates what the user SHOULD NOT DO. The details ofthings, which the user should not do, are described next to thismark.
This mark indicates what the user MUST DO. The details of things,
which the user must do, are described next to this mark.
This mark indicates that the user must be alert against a possible
DANGER. The details of the DANGER, which the user must be awareof are described next to this mark.
This mark indicates that the user is given a CAUTION against
possible hazards. The details of the CAUTION, which the user must
be aware of, are described next to this mark.
Handling Precautions

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 76

DANGERIf any overheating sign is observed, discontinue the use
immediately.
In the event that smoke, smell, or any other overheating sign isobserved, turn the power switch of the system OFF immediately
and remove the power cable(s) from the system connectors, likecomputer, camera, lightning. Do NOT try to continue to use thesystem. To do so in spite of clear signs of malfunction invites afire, an electric shock hazard, or a serious damage to the systemcomponents. In such case, contact for repair service us or our
dealer/distributor, from which you purchased the system.
If any malfunctioning sign is observed, discontinue the use
immediately.
Do NOT try to use the system when it is malfunctioning. (Ex. No
images on the monitor) In the event of malfunction, turn the
power switch of the system OFF immediately and remove thesystem power cables from the system components connectors. In
such case, contact for repair service us or our dealer/distributor
from which you purchased the system.
If any foreign object gets into the system components,
discontinue the use immediately.
In the event that liquids, small particles, or any other foreign
objects get into the system components, do NOT try to continue
to use the system. To do so invites a fire or an electric shock
hazard. In that case, turn the power switch of the systemcomponents OFF immediately and remove the system power
cables from the system components connectors. After that,
contact us or our dealer/distributor from which you purchased
the camera for repair service/technical advice.
Do NOT disassemble the system components.
Do NOT attempt to pull apart; repair, or modify the systemcomponents on your own. To do so leads to a fire or an electric
shock accident. Contact us or the dealer/distributor from which
you purchased the camera for repair/modifacation.
Do NOT supply any power than specified.
The system components are designed to work only under
specified voltage. Do NOT attempt to drive the systemcomponents with the power other than specified. Operating thesystem components under power other than specified invites afire or a electric shock hazard.
Do NOT use the system components in a high-humidity
environment.
Do NOT place the system components near a humidifier, or inother high-humidity environment. To do so may cause a fire oran electric shock accident.

CAUTION

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 77

If the system components are operated in the electromagnetic
field, there may be cases where noises (vertical, horizontal, or
oblique stripes) may appear to a video output or causes othermalfunctions. In that case, take preventive measures on theelectromagnetic-wave generating source so that the systemcomponents do not receive the interference by theelectromagnetic- wave. Take extra precautions againstelectromagnetic-wave-interference if the system components areused with a servomotor, inverter, or other electromagnetic-wavegenerating equipment.
Avoid giving a strong shock against the system components. If
your system components are used in the system where theconnector are subjected to strong repetitive shocks, theconnector are possible to break down. If you intend to use yoursystem components in such a situation, make sure to use an
optional-connector-fixing-hardware to connect the connector-plug
to the system components body.
When the system components are not in use, put a lens or alens-cap onto the cam head so that the image pickup plane of
CCD is protected from dust, foreign object, or other flaw-causing
object. If the glass plane (image pickup plane) gets dirty, clean itwith a cotton swab. When it needs to be cleaned with a cleaner,
be sure NOT to use any organic solvent other than ethyl alcohol.
Do not clean the other system components. In such a case call us
or the dealer/distributor from which you purchased the systemcomponents for cleaning or cleaning instructions.
As a countermeasure against condensation, when the systemcomponents are moved from a warm place to a cold place, takeappropriate precautions to prevent condensation from forming on
the system components.
Do not pull strongly the any cable nor swing it. The stress frompulling or swinging may cause damage in the coating of thecable, or breaks in the inside wires.
Avoid short-circuiting its signal output. Otherwise, the systemcomponents might be damaged.
If too much amount of light, (= the incoming light amount of 100
times or greater in comparison with standard light) enters CCD
image pickup plane, video output might not be obtained. In sucha case, take measures to reduce the amount of incoming light.
Do NOT expose the camera to intensive light (sunlight, etc.) toprevent its inner CCD from getting damaged.
When mounting a lens, take extra caution so that the lens is nottilled, nor does flaw exist at the lens-mount-screw part. Also checkto confirm that neither dirt nor other foreign object is put inside.
Improper mounting might cause the parts to become locked.

DANGERDo NOT use any optional unit other than manufacturer-supplied
one. We disclaim any responsibility for damages or losses
incurred by user due to the use of unauthorized / unofficial option
units supplied by a third party

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 78

22.2 Restricted for Use
In case malfunction of this equipment (e.g. video output cut-off) can be
expected to lead to significant accident, avoid using this equipment for such
system integration use.

22.3 Cases for Indeminity (Limited Warranty)
We shall be exempted from taking responsibility and held harmless for damages
or losses incurred by user in the following cases. In case damages or losses arecaused by fire, earthquake, or other acts of Gods, the act by third party, misuseby the user deliberately or erroneously, use under extreme operating
conditions.
• In case indirect, additional, consequential damages (loss of expectedinterest, suspension of business activities) are incurred as results ofmalfunction of non-function of the equipment, we shall be exempted fromassuming responsibility for such damages.
• In case damages or losses are caused by incorrect use, which is not in linewith the instructions in this instruction manual.
• In case damages or losses are caused by malfunction resulting from bandconnection with other equipment.
• In case damages or losses are caused by repair or modification done by theuser.
IMPORTANT SAFETY INSTRUCTIONS
1. This device is designed and guaranteed to work under the temperature range of - 10 through 45 degree C. Avoid using the equipment beyond that limits.
2. Do NOT expose the camera’s image-pickup-plane to sunlight or other intenselight directly. Its inner CCD (charge-coupled device) might be damaged.
3. Do NOT exposure all system components to sunlight or other intensive light (UV,IR).
4. In the event that any abnormal condition is observed, turn the power switch OFF
immediately. Do NOT try to continue to use the system components. To do so inspite of clear signs of malfunction invites a fire, an electric shock hazard, or any
other serious damage to the system components. In such case, contact us or our
dealer/distributor that you purchased the system components from for repair
service.
5. To clean the body of this equipment, make sure to turn all power switches OFF
first. To remove stubborn stains, use a soft cloth soaked in diluted acid freedetergent. After that, clean with a dry cloth.
6. In case the image-pickup-plane should be settled with fine dust, dirt, or
scratched, ask our distributor for technical advice

Users Manual – eco424, eco 415, eco204, eco415, eco267, eco247
Last Update 21.07.2009

p. 79