Teledyne DALSA Genie Mono Series Manual
Teledyne DALSA Genie Mono Series Manual
Teledyne DALSA Genie Mono Series Manual
P/N: CA-GENM-NM-MUM00
www.teledynedalsa.com
Notice
Microsoft and Windows are registered trademarks of Microsoft Corporation in the United
States and other countries. Windows, Windows Vista, Windows 7, Windows 8 and Windows
8.1 are trademarks of Microsoft Corporation.
All other trademarks or intellectual property mentioned herein belong to their respective
owners.
Teledyne DALSA Digital Imaging offers the widest range of machine vision components in
the world. From industry-leading image sensors through powerful and sophisticated
cameras, frame grabbers, vision processors and software to easy-to-use vision appliances
and custom vision modules.
Contents
GENIE MONOCHROME SERIES OVERVIEW ..................................................... 7
DESCRIPTION ................................................................................................ 7
Genie Application Advantages .................................................................. 8
PRODUCT PART NUMBERS .................................................................................. 8
CAMERA PERFORMANCE SPECIFICATIONS .............................................................. 10
Certifications ....................................................................................... 11
Vibration and Shock Certifications .......................................................... 11
SUPPORTED INDUSTRY STANDARDS .................................................................... 12
GENIE SENSOR OVERVIEW ............................................................................... 12
Genie M640-1/2 Specifications ............................................................... 13
Genie M640/M690-1/3 Specifications ...................................................... 14
Genie M1024 Specifications ................................................................... 15
Genie M1280 Specifications ................................................................... 16
Genie M1400-1/2 Specifications ............................................................. 17
Genie M1410-2/3 Specifications ............................................................. 18
Genie M1600 Specifications ................................................................... 19
APPLICATION DEVELOPMENT OVERVIEW ............................................................... 20
Sapera LT Library with optional Processing .............................................. 20
GigE Vision Compliant Environment ........................................................ 20
Description
The Genie monochrome camera family form a series of affordable, easy to use digital
cameras specifically engineered for industrial imaging applications. Genie cameras combine
standard gigabit Ethernet technology with the Teledyne DALSA Trigger-to-Image-Reliability
(T2IR) framework to dependably capture and transfer images from the camera to the host
PC.
All Genie cameras are supported by Teledyne DALSA Sapera™ LT software libraries featuring
CamExpert for simplified camera set-up and configuration. Sapera LT is field proven in
thousands of robust industrial applications. Hardware independent, Sapera LT delivers the
same reliable performance regardless of the image acquisition device being used. This
unique feature allows OEM’s to start using the Genie without re-writing applications
developed for Teledyne DALSA frame grabbers. In addition, Sapera LT includes powerful
diagnostics and setup utilities for application development, custom camera configurations
and system deployment.
Camera Controls
Synchronization Modes Free running and Triggered
Synchronous and Reset mode
Software trigger (through Ethernet)
Exposure Modes Programmable (1µs granularity, minimum (see sensor data) –
maximum 16s)
Pulse controlled
Trigger Input Opto-isolated, 2V to 12V typical, 2mA min.
Debounce range from 1 µs up to 255 µs
Strobe Output Output opto-isolated: Aligned to the start of exposure with a
programmable delay, duration and polarity
Features
LUT 8-bit / 10-bit
Flip Real-time horizontal flip
Flat Field Correction Real-time on camera
Binning Horizontal (2 pixel) and Vertical (2 line)
Timestamp 1µs internal timer or external signal to timestamp images and
events
Test image Internal pattern generator
User settings Select factory default or one user camera configuration
Optical Interface
Back Focal Distance—C-Mount 17.52 mm
Back Focal Distance—CS-Mount 12.52 mm
Mechanical Interface
Camera Size 29(H) x 44(W) x 67(L) in mm, ( see Mechanical Specifications )
Mass < 125g (no lens)
Power connector 12 pin male Hirose
Ethernet connector RJ45
Electrical Interface
Input Voltage CR-GENx-xxxxx models: +11 to +13 Volts DC at 0.6 Amp
minimum,
CR-GM0x-xxxxx models: +11 to +25.2 Volts DC at 0.6 Amp
minimum,
(over voltage–reverse voltage protected)
Power Dissipation < 4W
Operating Temperature 0 to 45°C (at front plate)
Relative Humidity 5% to 90% non-condensing (operating)
Output Data Configuration Gigabit Ethernet (IEEE 802.3)
Data and Control GigE Vision compliant at 1000 or 100 Mbps
Note: to install Sapera LT and the Genie device driver, logon to the workstation as an
administrator or with an account that has administrator privileges.
When Sapera application development is performed on the same computer that the Genie is
connected to, the Sapera Development Library (version 6.10 or later) must be installed.
Else, Sapera LT is not required to control the Genie camera.
• Insert the Teledyne DALSA Sapera CD-ROM. If AUTORUN is enabled on your computer,
the Teledyne DALSA installation menu is presented.
• If AUTORUN is not enabled, use Windows Explorer and browse to the root directory of
the CD-ROM. Execute launch.exe to start the Teledyne DALSA installation menu and
install the required Sapera components.
• The installation program will prompt you to reboot the computer.
• Continue with the Genie CD Package Installation described next.
Refer to Sapera LT User’s Manual concerning application development with Sapera.
Procedure
• When upgrading the Genie Framework from a previous version, there is no need to
uninstall the older version. The new installation will correctly update all framework files.
• Insert the Teledyne DALSA Genie CD-ROM. If AUTORUN is enabled on your computer,
the Genie installation menu is presented.
• If AUTORUN is not enabled, use Windows Explorer and browse to the root directory of
the CD-ROM. Execute launch.exe to start the installation menu and install the Genie
software components.
• Click to install the Genie Framework Software which includes the Network Imaging
driver, and the Sapera GigE server.
• The procedure will prompt for acceptance of the installation folder for the Genie files.
• If desired, click to install Sapera LT run-time which includes CamExpert. Follow the on
screen prompts and reboot when the installation is complete.
The normal GigE server The GigE server tray icon A red X will remain over
tray icon when the Genie shows a warning when a the GigE server tray icon
device is found. It will device is connected but when the Genie device is
take a few seconds for there is some type of IP not found. This indicates
the GigE Server to error. a major network issue.
refresh its state after the Or in the simplest
Genie has obtained an IP case, the Genie is not
address. connected.
If you place your mouse cursor on this icon, the GigE Server will display the number of GigE
Vision devices found by your PC. Right click the icon and select status to view information
about those devices. See "Running the Network Configuration Tool" on page 29 and
"Troubleshooting" on page 129for more information.
Connectors
The Genie has only two connectors:
• A single RJ45 Ethernet connector for control and video data transmitted to/from the
host computer Gigabit NIC. See "Ruggedized RJ45 Ethernet Cables" on page 123 for
secure cables.
• A single 12-pin Hirose male connector for camera power plus trigger, strobe and
general I/O signals. The suggested female cable mating connector is Hirose model
HR10A-10P-12S.
The Genie has one multicolor LED to provide a simple visible indication of camera state (see
figure below and section "Status LED Codes" on page 27). Additionally the RJ45 has two
LEDs for network status conditions.
The following figure of the Genie back end shows connector and LED locations. See
"Mechanical Specifications" on page 107 for details on the Genie connectors and camera
mounting dimensions.
Once the Genie has its RJ45 connected to a network, the Status LED will turn to steady blue
when the IP address is assigned. Only at this time will it be possible by the GigE Server or
any application to communicate with the camera.
Note: Even if the Genie has obtained an IP address, it might be on a different subnet than
the NIC it is attached to. Therefore, if the Genie LED is blue but an application such as
CamExpert can not see it, this indicates a network configuration problem. See the
troubleshooting section in this manual.
Right-click the GigE Server tray icon to open the following menu.
Click on Status to open a window listing all devices connected to the host system. Each
GigE device is listed by name along with important information such as the assigned IP
address and device MAC address. The screen shot below shows a connected Genie with no
networking problems.
In the event that the device is physically connected, but the Sapera GigE Server icon is
indicating that the connected device is not recognized, click Scan Network to restart the
discovery process. Note that the GigE server periodically scans the network automatically to
refresh its state. See "Troubleshooting" on page 129 for network problems.
Important: Any changes made with this tool will update the Genie flash memory. Do not
remove power from the Genie camera for a minimum 10 seconds. Then cycle the Genie
power to load the new flash settings.
Refer to the Teledyne DALSA Network Imaging package manual for more detailed
information on using this tool. As shown below, the Network Configuration tool can quickly
verify and modify the network configuration of the imaging system.
• The right hand column shows whether a firmware update is Required or Not Required.
• If an update is required, click on the Automatic button. The Update Firmware manager
dialog opens and the new firmware version is written to the Genie camera.
• The manual button allows the user to select from multiple Genie firmware configuration
files – if such files become available for future operational modes.
Important: If the Genie power is accidentally cut off during the firmware update (such as
a electrical source power failure or human error), the Genie is easily recovered. See
"Power Failure During a Firmware Update–Now What?" on page 133.
Parameter Description
Device Vendor For the Genie Monochrome series, this is always DALSA.
Device Model Name Displays the device model name (for example, Genie M640).
Device Version Displays the device version which includes the firmware release and build..
Firmware Version Displays the currently loaded firmware version manufacturer's code.
Device ID Displays the camera serial number.
MAC Address Displays the unique MAC (Media Access Control) address of the Genie
camera.
Parameter Description
Device User ID Specifies a user written ID, of up to 15 characters, for the Genie camera.
By default, this field is set to the serial number of the camera.
Power-up Click Setting to open the Power-up configuration dialog box which
Configuration allows you to specify camera power-up configuration. For more information,
see "Power-up Configuration" on page 37.
Warning: Non-typical or invalid Flat Field data, either from a faulty calibration setup or
uploaded by the user, may cause an error when trying to save the User Settings Power-up
Parameters. Such "flawed" Flat Field data is useable during camera operation but cannot
be sufficiently compressed to be saved as a user setting.
Parameter Description
Device Scan Type Displays the device scan type. Possible values are area scan or linescan.
This is always area scan for Genie.
Color Type Displays the color type of the sensor. Possible values are Color Sensor or
Monochrome Sensor.
Sensor Width (in Displays the sensor width (in pixels).
pixels)
Sensor Height (in Displays the sensor height (in pixels).
pixels)
Frame Rates
900.0
800.0
700.0 M640
600.0 M690
500.0 M1024
FPS
400.0 M1280
300.0 M1400
200.0 M1410
100.0 M1600
0.0
Window ROI
Vertical and Horizontal Cropping can be combined to grab only a region of interest (ROI).
Besides eliminating post acquisition image cropping done by software in the host computer,
a windowed ROI grab reduces the bandwidth required on the Gigabit Ethernet link since less
pixels are transmitted. See "CamExpert Image Buffer and ROI Parameters" on page 48 to
use CamExpert to configure image cropping.
Parameter Description
Pixel Format For the Genie Monochrome series, the image buffer format is Monochrome
8-bit or 10-bit.
Width (in Pixels) Displays the image buffer width (X axis), in pixels.
Height (in Pixels) Displays the image buffer height (Y axis), in pixels.
OffsetX (in Pixels) Specifies the offset in X, from the left of the image, when using an ROI. The
image buffer width is automatically adjusted to compensate for this offset.
OffsetY (in Lines) Specifies the offset in Y, from the top of the image, when using an ROI. The
image buffer height is automatically adjusted to compensate for this offset.
Image Flip Enables hardware based horizontal image flip.
Note: When operating in binning mode, the resolution is halved and the coordinate
system is scaled accordingly. For instance, an OffsetX of 20 pixels at nominal resolution is
equivalent to an OffsetX of 10 pixels with horizontal binning enabled.
1 2 3 4 639 640
Repeated for each
line of pixels
Horizontal Binning 1 2 320
Line
1 Line
Line 1
2 Repeated for each column of pixels
Line
3 Line
Line 2
4
Line
479 Line
Vertical Binning 240
Line
480
Trigger Modes
Genie image exposures are initiated by an event. The trigger event is either the camera's
programmable internal clock used in free running mode, an external input used for
synchronizing exposures to external triggers, or a programmed function call message by the
controlling computer. These triggering modes are described below.
• Free running (trigger disabled): The Genie free-running mode has a programmable
internal timer for frame rate and a programmable exposure period. Frame rate is 0.1 fps
to the maximum supported by the sensor. Exposures range maximum is also dependent
on the current frame rate. This always uses Synchronous mode where exposure is
aligned to the sensor horizontal line timing.
• External trigger: Exposures are controlled by an external trigger signal. External
signals are isolated by an opto-coupler input with a time programmable debounce
circuit. See "General Inputs" on page 59. The following section provides information on
external trigger timing.
• Software trigger: An exposure trigger is sent as a control command via the Ethernet
network connection. Software triggers can not be considered time accurate due to
network latency and sequential command jitter. But a software trigger is more
responsive than calling a single-frame acquisition (Snap command) since the latter must
validate the acquisition parameters and modify on-board buffer allocation if the buffer
size has changed since the last acquisition.
Note: Do not change the exposure time while grabbing, else an Invalid Trigger Event may
be generated.
This applies to any exposure mode or trigger source.
The Invalid Trigger Event is not catastrophic and only indicates the loss of a video frame.
Stopping acquisitions first will avoid this error.
Synchronous Mode
• Synchronous mode starts the exposure period aligned to the sensor horizontal line
timing and the programmable duration granularity is 1µs.
• In the case of the Genie M640, a horizontal line occurs every 31.77µs.
• Exposure duration is from the sensor minimum (see Genie Sensor Overview) up to 16
sec.
• In this mode, sensor exposure and sensor readout of the previous frame's exposure
occur simultaneously. This allows operating the sensor up to its maximum frame rate.
• Any trigger received before the end of the exposure is ignored. The application can elect
to receive messages about ignored triggers. See "Events" on page 76.
• Since the external trigger is asynchronous with the Genie horizontal line timing, the
frame exposure start is subject to 1 horizontal line jitter.
Parameter Description
Trigger Enables or disables the Genie camera trigger.
Trigger Source Specifies the trigger source. Possible values are Software, Input 1, or Input
2.
Note that this field is only available when the Trigger parameter is True.
Frames per Trigger Set the number of frames acquired per trigger – max. 64k
(driver 1.10 limited to 1 frame).
Timestamp Counter Select Timestamp increment source ( Internal 1µs Clock, Input 1, Input 2,
End of Readout )
Timestamp Reset Select event source for Timestamp Reset ( Off, Input 1, Input 2 ).
Source Important; The timestamp reset function is described below, using Input 1
as the selected example (applies to Input 2 also). For correct timestamp
counter operation, do not use the same "external signal input" for both the
reset and counter source.
Case 1 Input 1 polarity setting = Active Timestamp function is
High enabled
Input 1 signal = High
Case 2 Input 1 polarity setting = Active Timestamp is held in Reset
High – counter is always 0
Input 1 signal = Low
Case 3 Input 1 polarity setting = Active Timestamp function is
Low enabled
Input 1 signal = Low
Case 4 Input 1 polarity setting = Active Timestamp is held in Reset
Low – counter is always 0
Input 1 signal = High
Timestamp Reset Software Reset: Reset the Timestamp counter immediately (click mouse in
command field).
General Inputs
External Input Signal Opto-coupler & Debounce Circuit
• Genie provides two sets of opto-coupled inputs for either RS422 or TTL signals. These
can be used as external trigger sources.
• See "12-Pin Hirose Connector Signal Details" on page 112 for connector pinout and
electrical information. The cable shell and shield should electrically connect the Genie
chassis to computer chassis for maximum EMI protection.
• For external triggers, a rising edge signal is suggested to minimize the time it takes for
the opto-coupler to change state. (The opto-coupler response time is typically 10µs for
rising edge compared to 50μs for falling edge).
• Each input incorporates a signal debounce circuit (following the opto-couple) to eliminate
short noise transitions that could be wrongly interpreted as a valid pulse. The duration is
user-programmable from 1µs to 255µs with CamExpert.
• Note, the external trigger input propagation delay is dependent on the signal used to
activate the opto-coupled input. Typical delays are 3 µs for Active Open and 5 µs for
Active Close.
XML features for Trigger Modes, Time Stamp and General Inputs:
TriggerMode = {Off = 0, On = 1}
TriggerSelector = Select the type of trigger to control. FrameStart currently
supported.
TriggerSoftware = Generates a software trigger to start the acquisition in
any trigger mode
TriggerSource = External input or software signal as trigger source {Line2
= 1, Software = 2}
TriggerActivation = {LevelLow = 0, LevelHigh = 1, RisingEdge,
FallingEdge, AnyEdge}
TriggerDelayAbs = Absolute delay to apply in us after reception of the
trigger signal before starting exposure
TriggerDelayRaw = Absolute delay to apply in us after reception of the
trigger signal before starting exposure
GevTimestampTickFrequency = 64-bit value indicating the number of
timestamp clock ticks in one second.
GevTimestampControlLatch = Latches the current timestamp value of the
device.
GevTimestampControlReset = Resets the timestamp count of the device.
GevTimestampValue = Latched 64-bit value of the timestamp. Value must
first be latched using GevTimestampControlLatch.
CounterSelector = Select counter to configure. Currently only Timestamp is
supported.
CounterEventSource = Select counter source as {Internal Clock = 0, Input
1 = 1, Input 2 = 2, End of Readout = 3}
CounterLineSource = Source for the line to count.
CounterReset = Resets the selected Counter.
LineSelector = Index to general inputs on Hirose 12pin {Line1, Line2}
InputLinePolarity = {Active High = 0, Active Low = 1}
InputLineDebouncingPeriod = debounce period in µs (from 1 to 255 µs)
InputLineValue = Read input line state {low=0, high=1}
LineStatus = Current logical state of signal at time of polling {FALSE, TRUE}
Line Mode = Indicate if the line is an input or an output.
0 255
1 254
Pixel
Sensor & Data 2 253 Output
A/D
3 252 Circuit
Circuit
...
...
252 3
253 2
Programmed as
254 1
Invert Function
255 0
Important: Before calibration, the Genie should be powered on long enough to achieve its
nominal temperature. A metallic camera mount or a low ambient temperature may
increase the time required for the Genie to reach a stable internal temperature.
Important: In this example, the average pixel value for the frame is close to black. Also
note that most sensors will show a much higher maximum pixel value due to one or more
"hot pixels". The sensor specification accounts for a small number of hot or stuck pixels
(pixels that do not react to light over the full dynamic range specified for that sensor).
Once the bright gray acquisition setup is done, note the camera position and lens iris
position so as to be able to repeat it during the calibration procedure.
• Click on the Advanced Setting button to change the default number of frames
averaged for each calibration step. The default value is 10 frames.
• Setup the camera to capture a uniform black image. Black paper with no illumination
and the camera lens’ iris closed to minimum can provide such a black image. Or cover
the lens with a black lens cap.
• Click on Acquire Black Image. The flat field calibration tool will grab video frames,
analyze the pixel gray level spread, and present the statistics. The desired black
reference image should have pixel values less then 20. If the results are acceptable,
accept the image as the black reference.
• Setup the camera to acquire a uniform white image (but not saturated white). Even
illumination on white paper can be used, with a gray level of minimum of 128 (8-bit
mode). It is preferable to prepare for the white level calibration step before starting the
calibration procedure (see the previous section Set up Dark and Bright Acquisitions with
the Histogram Tool for information).
Horizontal Flip
Vertical
As shown in the following figure, a vertical flip function is simply accomplished by mounting
the Genie camera upside down and by programming the camera to do a horizontal flip.
Genie provides identical mounting holes on both its top and bottom side to ease
installations.
Mount Genie
Horizontal Flip
Upside Down
• Vertical ramp: similar to the horizontal ramp, successive lines are incremented by 1
gray level then repeated for the full frame.
• Moving diagonal ramp: combination of the 2 previous schemes, but first pixel in image
is incremented by 1 between successive frames. This is a good pattern to indicate
motion when doing a continuous grab.
• Purity: a purity pattern where all pixels have the same value. The gray value is
incremented by one on successive frames to maximum then repeated. This also provides
motion for live grabs.
Events
Genie supports a number of events that a control application can monitor. Events provide
real time notification on various stages of the acquisition sequence and of error conditions. A
Sapera application registers callbacks for those events that need monitoring.
Sapera Callbacks
Three types a callbacks can be registered for events when using the Genie:
• Transfer events concerning host system buffers.
• Use the Sapera Transfer Module
• In the Sapera C library: see CorXferRegisterCallback
• In the Sapera++ library: see SapXferCallbackInfo class
• Acquisition events concerning the acquisition device, specifically the Genie camera.
• Use the Sapera Acquisition Module
• In the Sapera C library: see CorAcqDeviceRegisterCallbackByName or
CorAcqDeviceRegisterCallbackByName
• In the Sapera++ library: see SapAcqDeviceCallbackInfo class
• Sapera events generated for GigE Vision devices (see
SapManager::RegisterServerCallback). Note that if Genie cameras are connected
through an Ethernet switch, these GigE Vision events can only be generated after the
Auto Discovery polling function of the GigE Vision driver.
• SapManager::EventServerNew — A new device such as a Genie, has been connected
while the Sapera application is running. Resources are allocated for the device.
• SapManager::EventServerNotAccessible — The device is not accessible (device is
disconnected). Sapera resources for the device do not have to be destroyed if it is
expected that the device will be reconnected.
• SapManager::EventServerAccessible — The device is accessible again (device
reconnected). Sapera resources for the device if not previously destroyed, will be
used again.
Important: Laptop computers may have issues even with a GigE NIC port, either built in
or as a PCMCIA device. This section describes optimizations for both desktop and laptop
computers, but laptops may require additional customization as described in the Teledyne
DALSA Network Imaging package manual.
Other networks parameters may be available through the 3rd party package
used.
Note 1: not displayed in CamExpert; not saved in a camera configuration file (CCF)
Note 2: Prepares the Genie for an optimal acquisition start with minimal delay. This feature
should be set true only after all other features are set else the effect of AcquisitionArm is
canceled.
Note 3: FlatFieldCalibrationEnable is set True before a calibration sequence is performed.
When calibration is enabled features such as Crop, Flip, LUT, etc. are reset to their default
state before the calibration sequence is started. The application would need to restore these
features after flat field calibration is complete.
Device
Feature Type
Interface ENUM
DeviceVendorName STRING
DeviceModelName STRING
DeviceVersion STRING
FirmwareVersion STRING
DeviceID STRING
MACAddress STRING
DeviceUserID STRING
IPAddress STRING
DeviceMaxThroughput INT32
TestImageSelector ENUM
Sensor
Feature Type
DeviceScanType ENUM
ColorType ENUM
SensorWidth INT32
SensorHeight INT32
FrameRate INT32
Gain INT32
BlackLevel INT32
PixelSize INT32
PixelFormat ENUM
NoiseReduction ENUM
Acquisition ROI
Feature Type
Width INT32
Height INT32
OffsetX INT32
OffsetY INT32
ImageFlip ENUM
Binning Control
Feature Type
BinningHorizontal ENUM
BinningVertical ENUM
LUT Control
Feature Type
LUTEnable BOOL
LUTFormat ENUM
LUTNumberEntries INT32
LUTData Sapera buffer
I/O Control
Feature Type
PolarityInput_1 ENUM
DebounceInput_1 INT32
InputPinStatusInput_1 INT32
PolarityInput_2 ENUM
DebounceInput_2 INT32
InputPinStatusInput_2 INT32
OutputSelectorOutput_1 ENUM
PulseDelayOutput_1 INT32
PulseDurationOutput_1 INT32
PolarityOutput_1 ENUM
OutputSelectorOutput_2 ENUM
PulseDelayOutput_2 INT32
PulseDurationOutput_2 INT32
PolarityOutput_2 ENUM
User Options
Feature Type
Power-upConfig ENUM
SaveCameraConfigurationSelecto ENUM
r
SaveCameraConfiguration BOOL
LoadCameraConfigurationSelector ENUM
LoadCameraConfiguration BOOL
Function Enabled
The event “Feature Info Changed” is sent. Other feature properties might have changed too.
Function Disabled
The event “Feature Info Changed” is sent. Other feature properties might have changed too.
Forced Value
The event “Feature Value Changed” is sent if the forced value is different from the previous value.
Exposure Mode
Programmable
Pulse Controlled Exposure Time
Software Trigger
Exposure Mode
Programmable Exposure Time
Exposure Alignment-Synchronous
Software Trigger
Output X Polarity
Vertical Binning
Vertical Binning
1 Line (Off) Buffer Height
2 Lines
Buffer Top
Buffer Top
Horizontal Binning
Horizontal Binning Flat Field Enable
1 Row (Off) Buffer Width
2 Rows
Buffer Left
LUTFormat
LUTNumberEntries
FlatFieldEnable
Inter-Packet Timeout
Image Timeout
Packet Size
Heartbeat Timeout
Inter-Packet Delay
Inter-Packet Timeout
Image Timeout
IP Configuration Mode
DHCP/LLA IP Address
Persistent IP
IP Address
#include "SapClassBasic.h"
#include "stdio.h"
main()
{
int serverCount = SapManager::GetServerCount();
SapAcqDevice *pAcqDevice = NULL;
char serverName[CORSERVER_MAX_STRLEN];
UINT32 userBufferSize;
if (serverCount == 0)
{
printf("No device found!\n");
return FALSE;
}
break;
}
}
if(!pAcqDevice)
{
printf("No Genie found!\n");
return FALSE;
}
if(!isUserBuffer)
{
printf("No UserBuffer feature!\n");
return FALSE;
}
SapFeature feature(serverName);
if (!feature.Create())
{
#else
userBufferSize = 4*1024;
#endif
delete pAcqDevice;
delete Buffers;
printf("Exit 0\n");
return 0;
connectivity".
This is normal (see Microsoft KB article #892896) and indicates that the network does
not have connectivity beyond routers.
• Windows and Genie are still running the DHCP process in the background. If a DHCP
server becomes available on the network, the NIC will get a DHCP assigned IP address
for the connected device but connections on the LLA IP address will be lost. The
Teledyne DALSA Network Configuration Tool can enable the Teledyne DALSA DHCP
server on the NIC used for the GigE Vision network.
• Important: If the host system has multiple NIC devices configured with LLA, then the
communication stack cannot accurately resolve which NIC to forward an IP packet on the
169.254 segment. Limit the number of NIC configured using LLA to one interface. It is
preferable that the Teledyne DALSA DHCP server is used instead of LLA mode (see next
section).
100 • Network Overview & Tools Genie Monochrome Series-GigE Vision Camera
Persistent IP
• This configuration is only suggested if the user fully controls the assignment of IP
addresses on the network.
• The GigE Vision camera is forced a static IP address. The NIC IP address must use the
same subnet otherwise the camera is not accessible.
• If the Genie camera is connected to a network with a different subnet, it cannot be
accessed.
• The Teledyne DALSA Network Configuration Tool is used to set a persistent IP address.
Refer to the Teledyne DALSA Network Imaging manual.
• An example of a Persistent IP address assignment on a class B network:
• NIC Subnet = 192.168.1.1
• Subnet Mask = 255.255.0.0
• Persistent IP = 192.168.1.2
• Default Gateway = 0.0.0.0
• Warning: an incorrect IP address assignment might make it impossible to connect to the
camera. In such a case the Teledyne DALSA Network Configuration tool includes a
function to recover a Genie camera with an unknown persistent IP and set the Genie to
the factory default setting, i.e. DHCP/LLA mode. The camera MAC address must be
known to use this function.
• For GigE Vision applications the FORCEIP command is used to force a new persistent IP
or to change the IP configuration protocol. The Genie MAC address must be known to
use the FORCEIP command.
• The following illustration shows a functional computer setup with three NIC ports, but no
DHCP server. Two NIC ports are used for private GigE Vision networks. The first uses the
default LLA mode for IP addresses, while the second NIC and the cameras connected to
it are configured with persistent IP addresses. An application on the computer can
control each camera, on each subnet, without conflict.
Genie Monochrome Series-GigE Vision Camera Network Overview & Tools • 101
102 • Network Overview & Tools Genie Monochrome Series-GigE Vision Camera
Sapera CamExpert Guide
For context sensitive help, click on the button then click on a camera configuration
parameter. A short description of the configuration parameter will be shown in a popup.
Click on the button to open the help file for more descriptive information on CamExpert.
The central section of CamExpert provides access to the Genie parameters. Five tabs group
Genie parameters depending on their type as described in the summary below. Each Genie
configuration parameter is described in detail following the summary.
The CamExpert application uses 5 windows to simplify choosing and configuring camera files
or acquisition parameters for the installed device.
• Device Selector pane: View and select from any installed Sapera acquisition device.
Once a device is selected CamExpert will only present acquisition parameters applicable
to that device. Optionally select a camera file included with the Sapera installation or
saved by the user.
• Parameters pane: Allows viewing or changing all acquisition parameters supported by
the acquisition device. CamExpert displays parameters only if those parameters are
supported by the installed device. This avoids confusion by eliminating parameter
choices when they do not apply to the hardware in use.
• Display pane: Provides a live or single frame acquisition display. Frame buffer
parameters are shown in an information bar above the image window.
• Control Buttons: The Display pane includes CamExpert control buttons. These are:
• Output Message pane: Displays messages from CamExpert or the device driver.
To select the type of LUT to use, click the LUT Mode Value field; a drop-down list box
displays the available modes. The Lookup Table dialog displays a graph of the input and
output values for the selected LUT. These are CamExpert common examples for LUT
operations. A Sapera application can program the Genie LUT for any required LUT operation.
See "Lookup Table (LUT)" on page 67 for Genie LUT support.
CamExpert available LUT examples are briefly described below. The LUT function graphic
simplifies understanding the operation especially when user settings modify the LUT
function.
• Normal (default): modifies all LUT entries using a linear mapping such that a gray
level input is equal to the output
• Arithmetic operation: modifies all LUT entries using an arithmetic operation
• Binary pattern: modifies some LUT entries based on a binary pattern
• Boolean operation: modifies all LUT entries using a Boolean operation
• Gamma correction: modifies all LUT entries using Gamma correction function
• Linear invert: modifies all LUT entries using a linear mapping with a negative slope
• Position shift: modifies LUT entries with a zero position offset
• Bit shift: modifies LUT entries with a binary bit shift
• Slope within range: modifies part of a LUT with a linear mapping
• Single Threshold: modifies all LUT entries using a threshold operation
• Double Threshold: modifies all LUT entries using a dual level threshold operation
Mechanical Specifications
The following sections show 3D views and the mechanical dimensions for Genie with C-
mount or CS-mount, and also for Genie with right-angled lens mounts. Additional notes
follow the figures.
±0.3°
External Inputs
• Opto-coupled (2V to 12V, 2mA minimum) with internal current limit.
• RS422 or TTL signal type (see figures below).
• 24 Volt signals supported with additional external current limiting (see figure below).
• Used as trigger or integration control.
• External signal polarity selected via configuration parameter.
• User programmable debounce time from 1 to 255µs.
• See "Input Controls via Sapera LT or GigE Vision Compliant Applications" on page 61.
.01µf
example
74HC244 IN-
Fairchild
Hirose 12 HMHA281R
connector
3.3V
Genie
4.7K
680
Trigger
IN+ IN
Debounce
Event Buffer
Signal driver .01µf
IN-
example Fairchild
SN75179B Hirose 12 HMHA281R
connector
3.3V
Genie
4.7K
680 1/2W 680
Event Trigger
IN+ IN
Signal Debounce
.01µf
IN-
Fairchild
Hirose 12 HMHA281R
connector
5V Genie
10K
680 75 Output Signal
Example 74LS14
NEC
PS2805-1
Hirose 12
connector
The Genie LAN connector is a standard Ethernet socket. Use CAT5e or CAT6 certified
Ethernet cables. CAT5e cable is rated for 100 MHz spectral bandwidth but CAT6 cable is
rated for a 200 MHz spectral bandwidth with less signal attenuation, therefore strongly
recommended for long connection lengths.
The interconnection Ethernet cable can be either Straight Through or Crossover cable type.
The Gigabit Ethernet standard for devices defines that they will auto-negotiate send and
receive channels, eliminating the need for users to use a specific Ethernet cable type.
Illumination
The amount and wavelengths of light required to capture useful images depend on the
particular application. Factors include the nature, speed, and spectral characteristics of
objects being imaged, exposure times, light source characteristics, environmental and
acquisition system specifics, and more. The Teledyne DALSA Web site,
www.teledynedalsa.com/imaging, provides an introduction to this potentially complicated
issue. Click on Knowledge Center and then select Application Notes and Technology Primers.
Review the sections of interest.
It is often more important to consider exposure than illumination. The total amount of
energy (which is related to the total number of photons reaching the sensor) is more
important than the rate at which it arrives. For example, 5µJ/cm2 can be achieved by
exposing 5mW/cm2 for 1ms just the same as exposing an intensity of 5W/cm2 for 1µs.
Light Sources
Keep these guidelines in mind when selecting and setting up light source:
• LED light sources are relatively inexpensive, provide a uniform field, and longer life span
compared to other light sources. However, they also require a camera with excellent
sensitivity.
• Halogen light sources generally provide very little blue relative to infrared light (IR).
• Fiber-optic light distribution systems generally transmit very little blue relative to IR.
• Some light sources age such that over their life span they produce less light. This aging
may not be uniform—a light source may produce progressively less light in some areas
of the spectrum but not others.
Filters
CCD cameras are extremely responsive to infrared (IR) wavelengths of light. To prevent
infrared from distorting the images you scan, use a “hot mirror” or IR cutoff filter that
transmits visible wavelengths but does not transmit wavelengths over 750nm. Examples are
the Schneider Optics™ B+W 489, which includes a mounting ring, the CORION™ LS-750,
which does not include a mounting ring, and the CORION™ HR-750 series hot mirror.
Lens Modeling
Any lens surrounded by air can be modeled for camera purposes using three primary points:
the first and second principal points and the second focal point. The primary points for a
lens should be available from the lens data sheet or from the lens manufacturer. Primed
quantities denote characteristics of the image side of the lens. That is, h is the object height
and h′ is the image height.
Example: An acquisition system has a 512 x 512 element, 10µm pixel pitch area scan
camera, a lens with an effective focal length of 45mm, and requires that 100µm in the
object space correspond to each pixel in the image sensor. Using the preceding equation,
the object distance must be 450mm (0.450m).
10 µm 45mm OD = 450mm(0.450m)
=
100 µm OD
Lens Mount
As shown in "Mechanical Specifications" on page 107 Genie comes in C-mount and the CS-
mount. The CS-mount is a standard with a shorter flange-focal length for space sensitive
applications. The C-mount Back Focal Distance is 17.52 mm while CS-mount Back Focal
Distance is 12.52 mm. The lens selected must be for the Genie mount used, else it may not
be able to focus on the target.
9.60
mm
.00
16
8.80
6.60
. 00
11
7.20
5.40
6.40 0 0
9.
4.80
00
8.
4.80
3.60
00
6.
(1/1.8 inch)
(2/3 inch)
(1/3 inch)
(1/2 inch)
(1 inch)
Comparison of Standard Sensor Sizes (dimensions in mm)
Important: Charge buildup will affect the camera’s flat-field correction calibration. To
avoid an erroneous calibration, ensure that you perform flat-field correction only after a
charge buildup has dissipated over 24 hours.
Environment
All cables made in CAT6 certified (tested for near end / far end crosstalk and
U.S.A. – all cables return loss).
RoHS compliant. IGE-3M (3meters)
IGE-10M (10meters)
IGE-25M (25meters)
IGE-50M (50meters)
IGE-100M (100meters)
100.00
90.00
80.00
70.00
60.00
Transmission (%) 50.00
40.00
30.00
20.00
10.00
0.00
350 450 550 650 750 850 950 1050
Wavelength (nm)
In this example using the Midwest Optical Systems C-mount NIR/UV filter, the image will be
projected about 1/3 of the filter thickness behind the sensor plane. In order to compensate
for this, the fixed focus C mount lens needs to be unscrewed (counterclockwise) 1/3 of filter
thickness or 1000 microns. This is approximately 1.25 turns. A spacer would be preferred
else the lens will need to be secured in the correct position. Alternatively use a variable
focus lens and secure its focus ring after adjustment.
t Where:
d≅
3 d is the change (increase) in back focal distance due to the filter
glass
higher index of refraction
t is the thickness of the filter glass
Host PC System
• Operating System: Windows XP, Windows Vista, Windows 7, Windows 8 and
Windows 8.1 (either 32-bit or 64-bit for all) are supported.
Network Adapters
• GigE network adapter (either add on card or on motherboard). The Intel PRO/1000
MT adapter is an example of a high performance NIC. Typically a system will need an
Ethernet GigE adapter to supplement the single NIC on the motherboard.
• PCI Express adapters will outperform PCI adapters.
• Network adapters that support Jumbo Frames will outperform adapters with fixed
packet size frames.
Laptop Information
• Older laptop computers with built in GigE network adapters may still not be able to
stream full frame rates from Genie. Thorough testing is required with any laptop
computer to determine the maximum frame rate possible (refer to the Teledyne
DALSA Network Imaging package manual).
Important: The maximum frame rate possible from a large number of Genie cameras
which are simultaneously triggered will depend on the Genie model, frame size, and
network details. Each imaging system should be tested for frame rate limits.
Overview
In rare cases an installation may fail or there are problems in controlling and using the
Genie camera. This section highlights issues or conditions which may cause installation
problems and additionally provides information on computers and network adapters which
have caused problems with Genie. Emphasis is on the user to perform diagnostics with the
tools provided and methods are described to correct the problem.
The GigE Server status provides visual information on possible Genie problems. The three
states are shown in the following table. Descriptions of possible conditions causing an
installation or operational problem follow. Note that even a Genie installation with no
networking issue may still require optimization to perform to specification.
Note: It will A red X will remain over The GigE server tray icon The GigE server tray icon
take a few the GigE server tray icon shows a warning when a when the Genie device is
seconds for when the Genie device is device is connected but found. The Genie has
the GigE not found. This indicates there is some type of IP obtained an IP address
Server to a network issue where error. and there are no
refresh its there is no network issues.
state after any communication with Optimization may still be
change. Genie. Or in the required to maximize
simplest case, the performance.
Genie is not connected.
Device IP Error
The GigE server tray icon shows a warning with IP errors. Review the following topics on
network IP problems to identify and correct the condition.
Please refer to the Teledyne DALSA Network Imaging Package manual for information on the
Teledyne DALSA Network Configuration tool and network optimization foe GigE Vision
cameras and devices.
Multiple Camera Issues
• When using multiple cameras with a computer with multiple NIC ports, confirm each
Genie has been assigned an IP address by checking the GigE server.
• To reduce network traffic in configured problem free systems, use the Network
Configuration tool to stop camera discovery broadcasts. Refer to the Teledyne DALSA
Network Imaging manual.
• When using multiple cameras connected to an VLAN Ethernet switch, confirm that all
cameras are on the same subnet setup on that switch. See the Teledyne DALSA
Network Imaging package manual for more information.
• If a Genie camera installed with other GigE Vision cameras can not connect properly
with the NIC or has acquisition timeout errors, there may be a conflict with the third
party camera's filter driver. In some cases third party filter drivers modify the NIC
properties such that the Teledyne DALSA Sapera Network Imaging Driver does not
install. Verify such a case by uninstalling the third party driver and installing the
Genie package again.
Firmware Updates
As a general rule any Genie installation must include the firmware update procedure (see
"Updating Genie Firmware" on page 30). Genie camera firmware that does not match a
newer version of installed Genie Framework software is likely to have unpredictable
behavior. Problems might be:
• Genie is not found by the device discovery process.
• Genie is found by the Sapera GigE Server but an application such as CamExpert does not
see the camera.
• A Genie that had a fault with a firmware update will boot with default safe firmware. In
this case the Genie behaves normally as a network device but can not function as a
camera. Opening the GigE Vision device status will show the Genie name field as
Firmware required.
Important: New Genie cameras installed in previously deployed systems are fully
backward compatible with the older vision application. New Genie cameras must not be
programmed with older firmware.
Canadian Sales
Teledyne DALSA — Head office Teledyne DALSA — Montreal office
605 McMurray Road 880 McCaffrey
Waterloo, Ontario, Canada, N2V 2E9 St. Laurent, Quebec, Canada, H4T 2C7
Tel: 519 886 6000 Tel: (514) 333-1301
Fax: 519 886 8023 Fax: (514) 333-1388
Asian Sales
Teledyne DALSA Asia Pacific Shanghai Industrial Investment Building
Ikebukuro East 13F Room G, 20F, 18 North Cao Xi Road,
3-4-3 Higashi Ikebukuro, Shanghai, China 200030
Toshima-ku, Tokyo, Japan Tel: +86-21-64279081
Tel: +81 3 5960 6353 Fax: +86-21-64699430
Fax: +81 3 5960 6354
Any support question or request can be submitted via our web site:
Before contacting Technical support, the following three status files should be generated and
included with the request for support.
• The host computer network status file (refer to the Teledyne DALSA Network Imaging
Package user's manual for information on generating this file).
• In the folder [installation drive]\Teledyne DALSA\Genie\bin a report.txt file is
automatically generated on firmware updates.
• From the Start menu, go to All Programs • Teledyne DALSA • Sapera LT • Tools
and run the Log Viewer program. From its File menu click on Save Messages to
generate a log text file.