GigE Vision Area Scan Camera ™ CA-GENM-CUM00 www.imaging.com Genie Color Series Camera User’s Manual Genie Framework 1.
© 2008 DALSA All information provided in this manual is believed to be accurate and reliable. No responsibility is assumed by DALSA for its use. DALSA reserves the right to make changes to this information without notice. Reproduction of this manual in whole or in part, by any means, is prohibited without prior permission having been obtained from DALSA. Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States and other countries.
Contents GENIE COLOR SERIES OVERVIEW......................................................................................................5 DESCRIPTION ............................................................................................................................................5 Genie Application Advantages..........................................................................................................6 PRODUCT PART NUMBERS .............................................................
Access Via CamExpert....................................................................................................................31 Power-up Configuration .................................................................................................................32 Power-up Parameter List ........................................................................................................................ 33 Power-up Control via Sapera LT or GigE Vision Compliant Applications..................
Feature Type STRING.....................................................................................................................66 Feature Type ENUM.......................................................................................................................67 Feature Type INT32........................................................................................................................69 Feature Type BOOL............................................................................
Environment..................................................................................................................................101 RUGGEDIZED RJ45 ETHERNET CABLES ................................................................................................102 C/CS-MOUNT NIR AND UV FILTER .....................................................................................................103 Back Focal Variance when using a Filter .............................................................
Genie Color Series Overview Description The Genie color 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 DALSA Trigger-to-Image-Reliability framework to dependably capture and transfer images from the camera to the host PC.
Genie Application Advantages • • • • • • • • • • • • • • • Available in a number of resolutions Compact, rugged design GigE Vision 1.0 compliant Gigabit Ethernet (GigE) interconnection to a computer via standard CAT5e or CAT6 cables Connection to the host computer NIC through a GigE network switch Available in variety of resolutions Lookup table pre-processing Real-time shading correction (i.e.
Product Part Numbers This manual covers the color Genie models summarized below. See "Camera Performance Specifications" on page 8 for each Genie model. fps Product Number Camera Sensor Size Resolution Pixel size (µm) Genie C640-1/2 1/2 in 640 x 480 9.9 x 9.9 64 CR-GEN0-C640x Genie C640-1/3 1/3 in 640 x 480 7.4 x 7.4 64 CR-GEN3-C640x Genie C1024 1/3 in 1024 x 768 4.65 x 4.65 20 CR-GEN0-C102x Genie C1400-1/2 1/2 in 1360 x 1024 4.65 x 4.
Camera Performance Specifications Specifications for each available sensor are listed after the general Genie camera specifications. 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 4s) Pulse controlled Trigger Input Opto-isolated, 2V to 12V typical, 2mA min.
Certifications CE EN55022, class A, EN61000-4-2, EN61000-4-3, EN61000-4-4, EN61000-4-6, ENV50204, 1995 FCC Part 15, class A Radio Disturbance Characteristics Electrostatic discharge immunity test Radiated, radio-frequency, electromagnetic field immunity test Electrical fast transient/burst immunity test Immunity to conducted disturbances, induced by radio-frequency fields see "EC & FCC Declaration of Conformity" on page 106 RoHS Compliancy as per European directive 2002/95/EC (applies to camera part
Genie C640-1/2 Specifications Item / Feature Specification Imager Format Full frame interline CCD area scan with square pixel (1/2 inch diagonal) Sensor Sony ICX414AQ Resolution 640 x 480 pixels Minimum Frame Rate (free-running) 0.1 fps (one frame every 10 seconds) Maximum Frame Rate (free-running) 64 fps Minimum Exposure 22μs Maximum Exposure 4 seconds Internal Trigger to Start of Exposure 3.8μs Pixel Size 9.9µm x 9.
Genie C640-1/3 Specifications Item / Feature Specification Imager Format Full frame interline CCD area scan with square pixel (1/3 inch diagonal) Sensor Sony ICX424AQ Resolution 640 x 480 pixels Minimum Frame Rate (free-running) 0.1 fps (one frame every 10 seconds) Maximum Frame Rate (free-running) 64 fps Minimum Exposure 22μs Maximum Exposure 4 seconds Internal Trigger to Start of Exposure 3.8μs Pixel Size 7.4µm x 7.
Genie C1024-1/3 Specifications Item / Feature Specification Imager Format Full frame interline CCD area scan with square pixel (1/3 inch diagonal) Sensor Sony ICX204AK Resolution 1024 x 768 pixels Minimum Frame Rate (free-running) 0.1 fps (one frame every 10 seconds) Maximum Frame Rate (free-running) 20 fps Minimum Exposure 44μs Maximum Exposure 4 seconds Internal Trigger to Start of Exposure 7.65μs Pixel Size 4.65μm (H) × 4.
Genie C1400-1/2 Specifications Item / Feature Specification Imager Format Full frame interline CCD area scan with square pixel (1/2 inch diagonal) Sensor ICX267AK Resolution 1360 x 1024 pixels Minimum Frame Rate (free-running) 0.1 fps (one frame every 10 seconds) Maximum Frame Rate (free-running) 15 fps Minimum Exposure 32μs Maximum Exposure 4 seconds Internal Trigger to Start of Exposure 11.67μs Pixel Size 4.65µm (H) x 4.
Genie C1410-2/3 Specifications Item / Feature Specification Imager Format Full frame interline CCD area scan with square pixel (2/3 inch diagonal) Sensor ICX285AQ Resolution 1360 x 1024 pixels Minimum Frame Rate (free-running) 0.1 fps (one frame every 10 seconds) Maximum Frame Rate (free-running) 21.9 fps Minimum Exposure 32μs Maximum Exposure 4 seconds Internal Trigger to Start of Exposure 4.15μs Pixel Size 6.45µm (H) x 6.
Genie C1600-1/1.8 Specifications Item / Feature Specification Imager Format Full frame interline CCD area scan with square pixel (1/1.8 inch diagonal) Sensor ICX274AQ Resolution 1600 x 1200 pixels Minimum Frame Rate (free-running) 0.1 fps (one frame every 10 seconds) Maximum Frame Rate (free-running) 15 fps Minimum Exposure 100μs Maximum Exposure 4 seconds Internal Trigger to Start of Exposure TBA Pixel Size 4.40µm (H) x 4.
Application Development Overview Sapera LT Library with optional Processing Sapera LT is a powerful development library for image acquisition and control. Sapera LT provides a single API across current and future DALSA hardware. Sapera LT delivers a comprehensive feature set including program portability, versatile camera controls, flexible display functionality and management, plus easy to use application development wizards.
Installing the Genie Camera Warning! (Grounding Instructions) Static electricity can damage electronic components. Please discharge any static electrical charge by touching a grounded surface, such as the metal computer chassis, before performing any hardware installation. If you do not feel comfortable performing the installation, please consult a qualified technician.
Installation Overview & Preparations The Genie camera installation generally follows the sequence described below. Detailed installation instructions follow this overview. Network and Computer Overview • Genie needs to connect to a computer with a GigE network adapter, either built in on the computer motherboard or installed as a third party PCI adapter. • Laptop computers with built in GigE network adapters may still not be able to stream full frame rates from Genie, especially when on battery power.
Installation Overview • Inspect all cables and connectors prior to their use. Do not use faulty cables or connectors to avoid camera damage. • Before connecting power to the camera, test all power supplies. Power supplies must meet the requirements defined in section "Genie Signal Electrical Details" on page 94. Apply power to the camera. • Connect Genie to the computer GigE network adapter or to the Ethernet switch via a CAT5e or CAT6 Ethernet cable.
Genie CD Package Installation The Genie Framework software package and Sapera runtime provides all components required to control the Genie with the supplied CamExpert tool. Genie Framework software components include the Network Imaging driver, the Sapera GigE server, and CamExpert (if Sapera LT library is not installed). Note: If Sapera application development is required, first install Sapera (6.10 or later) as described in the previous section. Procedure • Insert the DALSA Genie CD-ROM.
Connect the Genie Camera Connect a power supply to the Genie camera and an Ethernet cable from the Genie to the host computer. Once communication with the host computer is started the automatic IP configuration sequence will assign an LLA IP address as described in section "Genie IP Configuration Sequence" on page 23, or a DHCP IP address if a DHCP server is present on your network.
Status LED Codes The camera is equipped with a LED to display the operational status of the camera. When more than one condition is active, the LED color indicates the condition with the highest priority (such as an acquisition in progress has more priority than a valid IP address assignment). The following table summarizes the LED states and corresponding camera status.
Typical LED States on Power Up The following LED sequence occurs when the Genie is powered up connected to a network with installed Genie Framework software. Red power connected Flashing Blue waiting for IP Blue IP assigned Green application connected Genie IP Configuration Sequence The Genie IP (Internet Protocol) Configuration sequence to assign an IP address is executed automatically on camera power-up or when connected to a network.
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 107). Optimizing the Network Adapter used with Genie Most Gigabit network interface controllers (NIC) allow user modifications to parameters such as Adapter Buffers and Jumbo Frames.
• Click the Configure button. GigE NIC Configuration • Click on the Advanced tab. Modify the values for Receive Descriptors and Jumbo Frames as follows. Receive Descriptors • Select the 'Receive Descriptors' property. • Change the value to the largest value supported by the installed NIC. In this example the value is 2048. GigE NIC Receive Buffers Jumbo Frames • Select the 'Jumbo Frames' property. • Change the value to the largest supported by the installed NIC.
GigE NIC Jumbo Frames Running the Network Configuration Tool Once the GigE Server discovers a device, start the Network Configuration tool to verify and modify the network configuration of the imaging system. See "Network Configuration Tool" on page 78. First verify the Genie camera appears as a child of the NIC card it is connected to. By default the Genie camera is identified by its serial number if no user-defined name has been assigned.
Updating Genie Firmware The Genie firmware may need to be updated to correspond with the currently used Genie software framework. After installing the new Genie software package and Genie camera, update the firmware by following this procedure. • Important: Make sure that no Sapera application (such as CamExpert) is controlling the Genie camera. • Start the DALSA Device Manager program from the windows start menu: Start•Programs•DALSA•Genie•Firmware Update.
• The firmware update is complete when the lower message output area says "Device reset complete". Close the Device Manager program. • Genie cameras manufactured in 2007 or later will display the following status LED sequence while initializing with the new firmware. • Status LED will flash red then go off. • Both LAN LEDs will flash repeatedly for a short time. • Status LED will flash red then go off again. • Both LAN LEDs will flash repeatedly for a short time again.
Quick Test with CamExpert When the Genie camera is directly connected to a Gigabit network adapter on a host computer or via a network switch, testing the installation with CamExpert is a straightforward procedure. • Start Sapera CamExpert by double clicking the desktop icon created during the Genie software installation. • CamExpert will search for installed Sapera devices.
About the User-Defined Camera Name The Genie can be programmed with a user-defined name to aid identifying multiple cameras connected to the network. For instance, on an inspection system with 4 cameras, the first camera might be labeled “top view”, the second “left view”, the third “right view” and the last one “bottom view”. The factory default user name is set to match the camera serial number for quick initial identification.
Operational Reference Camera and Sensor Information Camera and sensor information can be retrieved via a controlling application. Parameters such as camera model, firmware version, sensor characteristics, etc. are read to uniquely identify the connected Genie device. All these features, with the exception of the DeviceUserId, are read-only. Sapera LT or GigE Vision compliant calls are used to retrieve this information and correctly identify the camera along with its characteristics.
Read Only Parameters Parameter Description Device Vendor For the Genie color series, this is always DALSA. Device Model Name Displays the device model name (for example, Genie C1024). Device Version Displays the device version. Firmware Version Displays the currently loaded firmware version. Device ID Displays the camera serial number. MAC Address Displays the unique MAC (Media Access Control) address of the Genie camera.
Power-up Parameter List Parameter Description ROI Region of interest used to crop the image Pixel Format Defines the pixel format Frame Rate Defines the frame rate for free run mode. Exposure mode Defines the exposure mode (Programmable or Pulse Controlled) Exposure duration Defines the exposure duration for Programmable mode Exposure synchronization Synchronous or Reset synchronization mode Gain Defines the sensor analog Gain factor, initially set to 0.0 dB.
Camera Information via Sapera LT or GigE Vision Compliant Applications Genie Sapera parameters for Camera and Sensor Information: Sapera Interface = {GigE Vision} DeviceVendorName = “DALSA” DeviceModelName = “Genie C1024” as an example DeviceVersion = String representing the version of the camera FirmwareVersion = String representing the version of the camera firmware DeviceID = String representing the camera serial number MACAddress = String representing the camera MAC address DeviceUserID = String repre
Sensor Controls Genie provides a number of sensor controls to optimize image acquisitions for most imaging solutions. Following is an overview of the CamExpert controls displaying this information, followed by individual control function descriptions and tables indicating the feature name associated to Sapera LT and to GigE Vision compliant development environments. Sensor Parameters: Controls Via CamExpert The Sensor Parameters tab groups the parameters related to the camera sensor configuration.
User Set Parameters Parameter Description Frame Rate (in Hz) Specifies the internal trigger frame rate for free run mode, in Hz. Possible values range from 0.1 to 20.0 Hz for Genie C1024 in full scan mode. (Note: the Sapera SDK specifies the frame rate in milli-Hertz). Gain (in dB) Specifies the sensor analog Gain factor, in dB. Possible values range from –6.0 to 12.0 dB, in 0.1 dB increments. For more information, see "Gain and Black Level Control" on page 37.
• Click the Auto White Balance button to have CamExpert adjust the RGB gain to achieve a realistic color cast under the current lighting conditions. The auto white balance function should be executed again when lighting conditions or color temperature change. • The CamExpert auto white function can work on a smaller ROI. Within the CamExpert acquisition window, click and drag a ROI rectangle with the mouse left button.
Gain and Offset Control via Sapera LT or GigE Vision Compliant Applications Genie Sapera parameters for Gain and Black level: Sapera GainRed = Amplification in dB from 0 to 12.0 dB (0.1dB steps) GainGreen = Amplification in dB from 0 to 12.0 dB (0.1dB steps) GainBlue = Amplification in dB from 0 to 12.0 dB (0.1dB steps) Gain = Amplification in dB from -6.0 to 12.0 dB (0.
Partial Scan—Window ROI Partial Scan (vertical cropping The Partial Scan mode, also know as vertical cropping, reduces the number of video lines grabbed for a frame. By not scanning the full vertical area of the sensor, the maximum possible acquisition frame rate is proportionately increased (as an extreme example, the C1024 scanning a one line frame, exposed around 146 fps).
Partial Scan (horizontal cropping) Genie also can crop the acquisition horizontally by grabbing less pixels on each horizontal line. Additionally a horizontal offset value will start the grab from any pixel count, as shown in the following figure. Note that horizontal cropping does not increase the maximum frame rate due to the CCD readout architecture.
Window ROI Control via Sapera LT or GigE Vision Compliant Applications Genie Sapera parameters for Partial Scan and Window ROI: Sapera Width = Buffer width in pixels (must be an even value) Height = Buffer height in lines OffsetX = Horizontal Offset of the leftmost pixel relative to the sensor (must be an even value) OffsetY = Vertical offset in lines of the uppermost pixel relative to the sensor PixelFormat = {Bayer Raw8/RGB 32-bit/UYVY/YUY2} See "Accessing Features with Sapera++ LT" on page 66.
Parameter Description Pixel Format For the Genie Color series, the image buffer format is Bayer Raw8 or RGB 32-bit or UYVY or YUY2. 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.
Exposure Controls Exposure Control modes define the method and timing of how to control the sensor integration period. The integration period is the amount of time the sensor is exposed to incoming light before the video frame data is transmitted to the controlling computer. • Exposure control is defined as the start of exposure and exposure duration. • The start of exposure can be an internal timer signal (free-running mode), an external trigger signal, or a software function call trigger.
External Trigger Programmable Exposure • Also known as “Edge Pre-select” exposure. See the timing diagram below. • The external trigger edge initiates the exposure process. The active external trigger edge can be selected as either the low-high or high-low transition. • The delay from active trigger edge to start of exposure is programmable from 1μs to 4 seconds (1μs steps) . • Exposure duration is programmable from 100μs to 4 seconds (1μs steps).
External Trigger Level-controlled Exposure • Also known as “Pulse Width Control” exposure. See the timing diagram below. • The external trigger edge initiates the exposure process. The active external trigger edge can be selected as either the low-high or high-low transition. • No delay from active trigger edge to start of exposure. Note that the user must account for the input optocoupler electrical specifications (see "External Inputs" on page 94).
Exposure Controls via Sapera LT or GigE Vision Compliant Applications Genie Sapera parameters for Exposure Control: Sapera FrameRate = 0.1 Hz up to max. frame rate supported by sensor in current mode of operation. Only available with Trigger disabled. ExposureMode = {Programmable = 1, Pulse Controlled = 2} ExposureTime = Exposure duration in µs In CamExpert, these parameters are available under “Sensor” tab. See "Accessing Features with Sapera++ LT" on page 66.
Synchronization Timing Genie supports two types of sensor synchronization, used to align the exposure to sensor timing: • Synchronous Mode: Exposure is synchronous to the line timing of the sensor. Exposure granularity is 1µs and the readout can be concurrent to the exposure for the fastest possible frame rate. • Reset Mode: Timing is reset to initiate exposure of next frame. Exposure granularity is 1µs, but readout must be sequential to exposure, reducing the maximum achievable frame rate.
Reset Mode • Exposure starts immediately after a valid trigger. There is no jitter on the start of exposure. • Exposure time is programmable or controlled by the trigger pulse width. • Minimum exposure is 100 µs, maximum is 4 seconds, with control steps of 1µs. • Sensor readout must complete before the next exposure can start. That is, exposure and readout are sequential. Therefore, the maximum frame rate is lower than for Synchronous mode.
CamExpert I/O Controls Dialog CamExpert groups the Genie I/O Controls Parameters in one group. These parameters allow configuring the Genie inputs and outputs for type of signal and signal polarity. The screen capture below shows the CamExpert I/O parameters dialog and is followed by a descriptive overview. Detailed information on inputs and outputs follow this section. I/O Controls Dialog Parameter Description Trigger Enables or disables the Genie camera trigger.
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 93 for connector pinout and electrical information. The cable shell and shield should electrically connect the Genie chassis to computer chassis for maximum EMI protection.
Input Controls via Sapera LT or GigE Vision Compliant Applications Genie Sapera parameters for Trigger Modes and General Inputs: Sapera TriggerDelayToIntegration = Delay in µs from trigger to exposure TriggerEnable = {FALSE, TRUE} TriggerSource = {Input 1 = 0, Input 2 = 1, Software = 2} TriggerSoftware = {FALSE, TRUE} FramesPerTrigger = Frame count 1 to 64k PolarityInput_x = {Active High = 0, Active Low = 1} DebounceInput_x = debounce period in µs (from 1 to 255 µs) See "Accessing Features with Sapera++ L
General Outputs: Settings via CamExpert The Output Settings dialog box allows you to configure the event mode for both output 1 and output 2. Each output can be set independently to one of the available event modes. A typical usage of output is to control a strobe light in relation to the camera exposure. Select the output to configure by clicking on the Output 1 or Output 2 buttons located at the top of the dialog box. Use the Event mode drop-down list box to select the required event mode.
Strobe On Start of Exposure Event Mode The Strobe On Start of Exposure event mode is used when controlling a strobe light using the Genie output pin. The exposure delay parameter is specified using the Sensor Parameters tab Exposure Control setting. For Synchronous mode, the exposure start timing is aligned to the line period of the sensor. This can delay the start of exposure by an amount of up to 31.77µs for the Genie C640.
Pulse On Invalid Trigger Event Mode This event mode generates an output signal when an invalid input trigger is received. An invalid trigger is any trigger received while the camera is engaged in frame acquisition (exposure and readout) and cannot accept trigger inputs. This is shown by the trigger exclusion region in the following diagram. Pulse On Start of Readout Event Mode The Pulse On Start of Readout event mode generates an output signal when the camera begins a readout operation from the sensor.
Pulse On End of Readout Event Mode The Pulse On End of Readout event mode generates an output signal when the camera finishes a readout operation from the sensor. Pulse On End of Acquisition Event Mode The Pulse On End of Acquisition event mode generates an output signal when the acquisition process is terminated using software.
Pulse On Input 1 or Input 2 Event Modes The Pulse On Input 1 or Input 2 event modes generate an output signal when the specified input signal is asserted. Output Control via Sapera LT or GigE Vision Compliant Applications Genie Sapera parameters for Strobe and General Outputs. See "Accessing Features with Sapera++ LT" on page 66.
Genie Processing Features The Genie color series of cameras support a number of functions to enhance acquisitions or perform real time processing. Functions can be combined to solve specific imaging situations. The user can enable and evaluate each operation by using CamExpert. Lookup Table (LUT) The Genie camera includes a user programmable LUT as a component of its embedded processing features. The LUT is used for operations such as gamma adjustments, invert and threshold processes.
LUT Control via Sapera LT or GigE Vision Compliant Applications Genie Sapera parameters for LUT: Sapera LUTEnable = {FALSE, TRUE} LUTFormat = {RGB } LUTNumberEntries = Number of entries in the LUT (256 for an 8-bit LUT) LUTData = Array of data representing the LUT content Sapera++ classes used: SapLut Class implements LUT management. SapAcquisition::GetLut to get a valid SapLut object. SapAcquisition::ApplyLut to program the SapLut object.
Bayer Raw8 used during calibration (left) – RGB 32-bit, UYVY, or YUY2 for image acquisition (right) Start the Flat Field calibration tool via the CamExpert menu bar: Pre-processing • Flat Field Correction • Calibration. Flat Field Calibration Window The Flat Field calibration window provides a three step process to acquire two reference images and then save the flat field correction data for the Genie used.
• 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 128 minimum.
Internal Image Test Patterns The Genie camera includes a built in test pattern generator that can be used to confirm camera Ethernet connections or driver installations, without the need for a camera lens or proper lighting. The pattern generator inserts video just after the sensor A/D converter, therefore Genie processing such as the LUT act on the generator images or on sensor images. CamExpert is used to easily enable and select the Genie test patterns.
The Genie test patterns are: • Horizontal ramp: successive pixel's gray level is incremented by 1 to maximum pixel value then repeated until the end of line. The gray level is reset to 0 on the following line. • 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.
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 Two types a callbacks can be registered for events when using the Genie: • Transfer events concerning host system buffers.
Network Controls & GigE Vision Parameters This section describes how to optimize the network configuration for maximum Genie bandwidth. Optimization of these parameters is highly dependent on the number of cameras connected to a NIC, the data rate of each camera and the trigger modes used. Important: Laptop computers may have issues even with a GigE NIC port, either built in or as a PCMCIA device.
Parameter Description Network Configuration Mode Specifies the Network Configuration Mode as either Automatic, Manual, or Optimize. In general use Optimize mode. Some computers, especially laptops, may require manual optimization of network parameters. The following parameters can be modified when Manual mode is selected. Inter-Packet Delay (in sec) Specifies the inter-packet delay, in sec. The range of permitted values is 0.000000 to 0.065535.
Sapera Supported Features List The Genie features and its currently set values can be read by a Sapera application. The Sapera tool CamExpert is an example of an application that reads and writes Genie parameters to control its operation. The following tables group the Genie features by their feature type—STRING, ENUM, INT32, and BOOL.
Feature Type ENUM Feature Name Acces s W-mode Type Values Interface RO N.valid ENUM GigE Vision = 0 DeviceScanType RO N.valid ENUM Area scan = 0 Linescan = 1 ColorType (dependent on camera model) RO N.valid ENUM Monochrome Sensor = 0 CFA Bayer Sensor GR = 1 CFA Bayer Sensor RG = 2 (current) CFA Bayer Sensor GB = 3 CFA Bayer Sensor BG = 4 RGB Sensor = 5 ExposureMode RW N.acq ENUM Programmable = 1 Pulse Controlled = 2 ExposureAlignment RW N.
OutputSelectorOutput_2 RW Always ENUM Open = 0 Close = 1 Pulse On: End of Exposure = 3 Pulse On: Valid Trigger = 4 Pulse On: Invalid Trigger = 5 Pulse On: Start of Readout = 6 Pulse On: End of Readout = 7 Pulse On: End of Acquisition = 8 Pulse On: Input 1 = 9 Pulse On: Input 2 = 10 PolarityInput_1 RW Always ENUM Active High = 0 Active Low = 1 PolarityInput_2 RW Always ENUM Active High = 0 Active Low = 1 PolarityOutput_1 RW Always ENUM Active Close = 0 Active Open = 1 PolarityOutput_2 RW
Feature Type INT32 The feature list for type INT32 has an additional column 'Exponent' which defines the feature's native unit. This exponent value is used as a unit multiplier so that the feature value is expressed as an integer, not a decimal number. • As an example from the following table, the Genie frame rate is 60000 with an exponent of 3. Therefore the frame rate native unit is mHz. The current value shown – 60000 mHz, is actually 60.000 Hz.
FlatFieldOffsetMax RO N.conn INT32 EXP10: 0 (see note 1) FlatFieldWidth RO N.conn INT32 EXP10: 0 (see note 1) FlatFieldHeight RO N.conn INT32 EXP10: 0 (see note 1) Note 1: not displayed in CamExpert; not saved in a camera configuration file (CCF) Feature Type BOOL Feature Name Access W-mode Type Value LUTEnable RW N.conn BOOL True/False TriggerEnable RW N.acq BOOL True/False TriggerSoftware RW Always BOOL True/False FlatFieldEnable RW N.
Trigger Enable - TRUE Trigger Enable TRUE Trigger Source Software Input 1 Exposure Mode Programmable Input 2 Exposure Time Exposure Alignment Synchronous Reset Exposure Mode Programmable Pulse Controlled Exposure Alignment-Reset Trigger Delay to Integration Frame Rate Exposure Time Exposure Time Software Trigger Frame Per Trigger Trigger Enable - FALSE Trigger Enable FALSE Trigger Source Exposure Mode Programmable Exposure Time Trigger Delay to Integration Exposure Alignment-Synchronous Fra
Output Selector Output X Selector Output X Pulse Delay Open Close Strobe On: Start of Exposure Pulse On: End of Exposure Output X Pulse Duration Output X Polarity Pulse On: Valid Trigger Pulse On: Invalid Trigger Pulse On: Start of Readout Pulse On: End of Readout Pulse On: End of Acquisition Output X Pulse Delay Output X Pulse Duration Output X Polarity Pixel Format Pixel Format Raw Bayer RGB UYVY YUY2 SaperaBufferFormat PixelSize LUTEnable SaperaBufferFormat PixelSize LUTEnable Network Configuratio
ROI Management Buffer Top Buffer Height Frame Rate Buffer Top Buffer Height Buffer Width Buffer Left Buffer Left Buffer Width Genie Color Series-GigE Vision Camera Exposure Time Operational Reference • 73
74 • Operational Reference Genie Color Series-GigE Vision Camera
Network Overview & Tools Using Genie with Ethernet Switches Examples where a Gigabit Ethernet switch would be used are: • Multiple Genie cameras are controlled by one computer and a single NIC (running multiple instances of CamExpert as an example of the control program). • Multiple Genie cameras are individually controlled by multiple computers, all located on the same subnet. In these cases the Ethernet switch is a transparent device.
Link-Local Address (LLA) • LLA is also known as Auto-IP. It is used for unmanaged networks including direct connections from a GigE Vision device to a dedicated NIC. • A subnet configured with LLA cannot send packets across routers but only via Ethernet switches. • LLA is the recommended scheme when only one NIC is connected to GigE cameras. LLA is fully automatic requiring no user input. Ensure only one NIC is using LLA on your PC, otherwise IP conflicts will result.
Persistent IP • This protocol is only suggested if the user fully controls the assignment of IP addresses on the network and a GigE Vision camera is connected beyond routers. • 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 DALSA network configuration tool is used to set a persistent IP address.
Network Configuration Tool The Network Configuration tool provides information on all network adapters installed in the system and any connected GigE Vision devices. For the Genie, the tool allows a simple method to assign a User-Defined name and also to set a Persistent IP address instead of the default DHCP/LLA assigned IP address. Using this tool, Genie network configurations can be easily made without having to use any Windows Control Panel application.
Genie IP Configuration System Information and Configuration Select the system icon (the computer symbol) in the left pane to display current system information which may be required when documenting Genie installations. There are no user changeable fields in the System Information tab. In the right hand pane click on the System Configuration tab. Three user settings are provided which can be changed from their default settings for production systems after all configuration items are tested and debugged.
System Configuration Network Card Information and Configuration Select a network card icon in the left pane to see the NIC configuration parameters. The Network Configuration tool ensures that no two NIC devices installed in the computer are on the same subnet, since that would create a conflict. A warning message is displayed in such a case, indicating that a settings change is required for one of the NIC.
NIC IP and Network Imaging Driver Assignment For each NIC, it is possible to configure the IP configuration mode (either DHCP/LLA or Persistent IP) if required via the NIC Configuration tab. Warning: Changing the NIC IP address may put it on a different subnet than the Genie. Changing the NIC IP configuration first might cause the case where the camera becomes inaccessible from the NIC. The proper sequence is to first change the camera IP configuration then change the NIC IP.
To recover a Genie: • Start the Network Configuration program from the windows start menu: Start•Programs•DALSA•Network Interface•DALSA Network Configuration Tool. • From the menu bar click on Advanced and then on Recover Camera. • On the dialog enter the camera MAC address and click the Recover Camera button. Camera Recovery Dialog • If the camera requires a persistent IP address, select the bullet to assign a persistent IP immediately with recovery.
Creating a Status Report Before contacting DALSA technical support, the user should review the Troubleshooting section of this manual (see "Troubleshooting" on page 107). Most installation, configuration, and imaging issues are documented along with their solutions. To aid technical support, the tool can save a network configuration report. From the File menu select “Save current status”. You will be prompted for a filename for the report text file.
Status Window Description User Name User assigned identification Manufacturer Manufacturer for this device Model GigE Vision device model Serial Number Device serial number Firm Ver Device firmware revision number MAC address Device MAC address Camera IP Device current IP address NIC IP NIC IP associated with the GigE server Filter driver Network driver status MaxPktSize Largest packet size that should be used for image streaming.
Sapera CamExpert Guide Using CamExpert with Genie Color Cameras CamExpert is the camera interfacing tool supported by the Sapera library. When used with a Genie camera, CamExpert allows a user to test all Genie operating modes. Additionally CamExpert saves the Genie user settings configuration to the camera or saves multiple configurations as individual camera parameter files on the host system (*.ccf).
CamExpert Panes The CamExpert application uses 5 windows to simplify choosing and configuring camera files or acquisition parameters for the installed device. • Device 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. • Parameters pane: Allows viewing or changing all acquisition parameters supported by the acquisition device.
• Control Buttons: The Display pane includes CamExpert control buttons. These are: Acquisition control button: Click once to start live grab, click again to stop. Single frame grab: Click to acquire one frame from device. Software trigger button: With the I/O control parameters set to Trigger Enabled / Software Trigger type, click to send a single software trigger command.
CamExpert available LUT examples are briefly described below. The LUT function graphic simplifies understanding the operation especially when user settings modify the LUT function.
Technical Specifications 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.
Genie C-mount and CS-mount Mechanical Specifications 90 • Technical Specifications Genie Color Series-GigE Vision Camera
Genie 3D View with Right-angle C-mount and CS-mount Genie Color Series-GigE Vision Camera Technical Specifications • 91
Genie Right-angle C-mount and CS-mount Mechanical Specifications 92 • Technical Specifications Genie Color Series-GigE Vision Camera
Additional Notes on Genie Mechanical Genie supports a screw lock Ethernet cable (see "Ruggedized RJ45 Ethernet Cables" on page 102). For information on Genie lens requirements see "Optical Considerations" on page 98. Lens flange focal distance = 17.52 mm for C-mount. Lens flange focal distance = 12.52 mm for CS-mount. The camera top also has four mounting holes in identical locations. Connectors • A single RJ45 Ethernet connector for control and video data to the host Gigabit NIC.
12-Pin Hirose Connector Pinout Pin Direction Genie Signal (see details below) Notes 1 - Power GND 2 - +12V DC power supply 3 Out Output 1 - 4 Out Output 1 + 5 In Input 1 - RS422- or TTL GND 6 In Input 1 + RS422+ or TTL 7 Out Output 2 + / Strobe + 8 Out Output 2 - / Strobe - 9 - 10% tolerance Reserved 10 - Reserved 11 In Input 2 + RS422+ or TTL 12 In Input 2 - RS422- or TTL GND shell / shield via cable shield Genie chassis connects to supply earth ground improv
3.3V Genie V+ 4.7K Event Signal 680 Buffer driver Trigger Debounce IN+ IN .01µf example 74HC244 INFairchild HMHA281R Hirose 12 connector TTL External Signal Example 3.3V Genie 4.7K 680 Trigger Debounce IN+ Event Signal Buffer driver IN .01µf IN- example SN75179B Hirose 12 connector Fairchild HMHA281R RS-422 External Signal Example 3.3V Genie 4.7K Event Signal 680 1/2W 680 Trigger Debounce IN+ IN .
External Outputs • Programmable output mode such as strobe, event notification, etc. (see "Output Control via Sapera LT or GigE Vision Compliant Applications" on page 56). 5V Genie 10K 680 75 Output Signal Example 74LS14 NEC PS2805-1 Hirose 12 connector Output Driving a TTL User Circuit The opto-coupler is typically a NEC PS2805-1 with the following characteristics.
RJ45 LAN Ethernet Connector Details The RJ45 LAN connector has two LEDs for network status conditions. The LED color codes are as follows. Network Connection Network Activity Green 100Mbps Off no network activity Orange 1000Mbps Yellow typically blinking – active Network Connection Network Activity The Genie LAN connector is a standard Ethernet socket. Use CAT5e or CAT6 certified Ethernet cables.
Optical Considerations This section provides an overview to illumination, light sources, filters, lens modeling, and lens magnification. Each of these components contribute to the successful design of an imaging solution. Illumination The amount and wavelengths of light required to capture useful images depend on the particular application.
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. The focal point is the point at which the image of an infinitely distant object is brought to focus.
Sensor Handling Instructions This section reviews proper procedures for handling, cleaning, or storing the Genie camera. Specifically the Genie CCD sensor needs to be kept clean and away from static discharge to maintain design performance. Electrostatic Discharge and the CCD Sensor Cameras contain charge-coupled device (CCD) image sensors, which are metal oxide semiconductor (MOS) devices and are susceptible to damage from electrostatic discharge (ESD).
Cleaning the Sensor Window Even with careful handling, the sensor window may need cleaning. The following steps describe various cleaning techniques to clean minor dust particles to accidental finger touches. • Use compressed air to blow off loose particles. This step alone is usually sufficient to clean the sensor window. Avoid moving or shaking the compressed air container and use short bursts of air while moving the camera in the air stream.
Ruggedized RJ45 Ethernet Cables Components Express Inc. has available an industrial RJ45 CAT6 cable that on one end has a molded shroud assembly with top/bottom thumbscrews, while the other end has a standard RJ45. This cable is recommended when Genie is installed in a high vibration environment. Contact sales at DALSA for availability of Genie with female mounts for this secure Ethernet cable. All cables made in U.S.A. – all cables RoHS compliant.
C/CS-Mount NIR and UV Filter Midwest Optical Systems has available a C-mount NIR/UV filter. This filter screws into the Genie camera before mounting the lens. The figures below show the filter before mounting into the Genie, followed by the filter physical specifications and pass spectrum. Contact Midwest Optical Systems directly for technical information and pricing. Physical Specifications: Outside diameter: 25.4mm, 32 NS2A thread (c-mount thread) Clear Aperture: 19.5mm Thickness: 3.0 ±0.
Back Focal Variance when using a Filter Inserting a filter either in front of a lens or between a lens and sensor (as when using a C-mount filter), changes the focal point of the lens used. A variable focus lens simply needs to be adjusted, but in the case of a fixed focus lens, the changed focal point needs correction. The following simplified illustration describes this but omits any discussion of the Optics, Physics, and the math behind the behavior of light through different media.
Computer Requirements for Genie Cameras The following information is a guide to computer and networking equipment required to support the Genie camera at maximum performance. The Genie camera series complies with the current IPv4 Internet Protocol, therefore current Gigabit Ethernet (GigE) equipment should provide trouble free performance. Host PC System • • • • Pentium 4 system (or AMD equivalent) with 512 MB system memory. System motherboard without an embedded graphic card.
EC & FCC Declaration of Conformity 106 • Technical Specifications Genie Color Series-GigE Vision Camera
Troubleshooting 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.
Device Not Available A red X over the GigE server tray icon indicates that the Genie device is not found. This indicates either a major camera fault or condition such as disconnected power, or a network issue where there is no communication. • Review the section "Installation Overview & Preparations" on page 18 to verify required installation steps. • See "Network Configuration Tool" on page 78 to review networking details. Device IP Error The GigE server tray icon shows a warning with IP errors.
• There is no image but the frame rate is as expected. See "Camera is functional, frame rate is as expected, but image is black" on page 117. There is a problem with the acquisition • "Grab has Random Bad Data or Noise" on page 117 Other problems • • "Ethernet Switch Issues" on page 120 "Older Laptop Computer Networking Issues" on page 119 Verifying Network Parameters DALSA provides the Network Configuration tool to verify and configure network devices and the Genie network parameters.
Installation Issues and Functional Problems This section covers issues indicated by the GigE server tray icon shows a warning symbol. GigE Server Warning Example 1a: IP error with multiple NICs The screenshot below shows an IP conflict error due to two (or more) NICs that are all set to LLA mode. In this case both NICs are assigned the same IP subnet address preventing communication with any connected Genie. • When multiple NICs are used, only one can be set to LLA mode.
GigE Server Warning Example 1b: IP error with multiple NICs As a second example, the screenshot below shows an IP conflict error similar to the example above but the second NIC has no camera connected (or only an Ethernet switch). • The following illustration shows an example of this fault condition. The second NIC has no Genie connected ether directly or via a switch.
GigE Server Warning Example 2: Subnet Mask or IP error The screenshot below shows that the Genie device is not accessible. This IP error is an example of the Genie being assigned a persistent IP address with an incorrect subnet mask. • This example error was made using the DALSA Network Configuration tool, where the Genie was set to Persistent IP mode with an incorrect subnet mask.
• Information about the CorSnid driver is also available from Network Configuration tool. Device Available with Operational Issues This section considers issues with cabling, Ethernet switches, multiple cameras, and camera exposure. Firmware Updates As a general rule any Genie installation must include the firmware update procedure (see "Updating Genie Firmware" on page 27).
Power Failure During a Firmware Update–Now What? Don't panic! There is far greater chance that the host computer OS is damaged during a power failure than any permanent problems with the Genie. When electrical power returns and the host computer system has started, the Genie firmware reprogramming sequence is as follows. • Connect power to the Genie. The Genie processor knows that the operating firmware is corrupt. • The Genie status LED is slow flashing red.
Acquisition Error with a Timeout Message A streaming error is typical with a firewall not allowing the filter driver through. As an example, CamExpert will run (but start slowly due to initialization timeouts), the Genie is visible in the device pane, but no parameters are shown to control the camera. • If the host computer is using a firewall, either add the GigE Server in the firewall exception list or disable the firewall completely on the NIC used only with the Genie.
Turning Windows Firewall Off With a computer that is not behind a corporate firewall an alternative is to disable Windows firewall only for the network adapter dedicated for the Genie camera. Such a computer would have two or more network adapters where one NIC only connects to the Genie—never the Internet. The following figures show an example of the Windows firewall On but disabled for the network adapter used by Genie.
Acquisition Error without Timeout Messages Streaming video problems range from total loss of image data to occasional loss of random video data packets. The following section describes conditions identified by DALSA engineering while working with Genie in various computers and setups. No camera exposure when expected • • • Verify by using the camera in free-running mode. Do not use external trigger mode when testing a camera setup.
Following are various examples of this data transmission problem. The solutions vary but commonly involve reducing the maximum packet size claimed by the NIC used. Grab has Random Bad Data or Noise – Case 1 • This problem has been seen on some computers where the NIC used does not fully support passing the maximum jumbo frame possible from the Genie. • In the NIC configuration, keep the jumbo frame size set to the maximum allowed. See "Increasing Adapter Buffers and Jumbo Frames" on page 24.
Older Laptop Computer Networking Issues Laptop computers with built in GigE network adapters may still not be able to stream full frame rates from Genie. Laptops with gigabit Ethernet PCMCIA boards may not be able to stream video at all unless network parameters are modified. Thorough testing is required with any laptop computer. Streaming video problems may change depending on the computer chipset and NIC combinations.
Ethernet Switch Issues An Ethernet switch usually works transparently and presents no problems. Review the following list when troubleshooting switch issues. • Is the Ethernet switch powered on. • Are all ports used configured as active; not disabled. • Are all ports running at gigabit speeds–not low speed (i.e. not 10 or 100 Mbps). • Is the switch configured to use Jumbo Frames. • Verify the Ethernet cabling. Poor cables will cause connections to auto-configure at lower speeds.
DALSA Contact Information Genie Sales Information Visit our web site: http://www.imaging.com/ Email: mailto:info@dalsa.com International/Canada DALSA — Montreal office 7075 Place Robert-Joncas Suite #142 St. Laurent, Quebec, Canada H4M 2Z2 Tel: Fax: (514) 333-1301 (514) 333-1388 USA DALSA 700 Technology Park Drive Billerica, Ma.
Genie Technical Support Any support question or request can be submitted via our web site: Technical support form via our web page: Support requests for imaging product installations, Support requests for imaging applications http://www.imaging.com/support Product literature and driver updates http://www.imaging.com/download Before contacting Technical support, the following three status files should be generated and included with the request for support.
Glossary of Terms ARP Address Resolution Protocol provides a way to retrieve the MAC address associated to an IP address. Bandwidth Describes the measure of data transfer capacity. CAT5e Ethernet cable Category 5e was designed for transmission speeds of up to 1 gigabit per second (Gigabit Ethernet). CAT6 Ethernet cable Same as Category 5e, except that it is made to a higher standard. Supports transmission speeds greater than Gigabit Ethernet with less signal attenuation over a given length of cable.
GenICam specification Specification of the European Machine Vision Association (EMVA, www.emva.org). Defines the capabilities of any GigE Vision device. Grab Acquiring an image frame. Grayscale In image processing, the range of available brightness levels, displayed in shades of gray. In an 8-bit system, the gray scale contains values from 0 to 255. GVCP – GigE Vision Control Protocol One of the core protocols of the GigE Vision specification used to control camera.
SAT Saturation Output Amplitude. SAT is the average maximum output level for a specified light input. Scatter Gather Host system memory allocated for frame buffers is virtually contiguous but physically scattered throughout all available memory. SNR Signal to Noise Ratio. SNR measures the ratio between random noise and an arbitrary reference signal on the transmission path or within a device. Subnet The subnet is identified by performing the logical AND of the IP address with its subnet mask.
126 • Glossary of Terms Genie Color Series-GigE Vision Camera
Index 1 12-pin male Hirose connector, 93 8 8-bit LUT, 57 A Acquisition events, 63 administrator, 19 AUTORUN, 19, 20 B back focal length, 99 Ethernet link speed, 117 Ethernet switch, 75 Ethernet switch issues, 120 event modes, 52 event notification, 96 events, 63 exposure duration, 43 exposure period, 117 Exposure time granularity, 47 external trigger, 117 F fastest frame rates, 43 feature availability, 70 feature interdependence, 70 feature type, 66 fiber-optic light sources, 98 Firewall exception list
I I/O signal specification, 93 image buffer, 41 image cropping, 41 image exposures, 42 image processing, 7 incoming image packets, 24 industrial RJ-45, 102 infrared filters, 98 internal pattern, 117 inter-packet delay, 65 invalid trigger, 54 ionized air blower, 100 IP configuration, 21 IP configuration modes, 75 IP configuration protocol, 21, 23 J jumbo frames, 118 jumbo packets, 65 L laptop optimizations, 64 laptops, 65 launch.
T test pattern generator, 61 test patterns, 29 threshold processes, 57 Transfer events, 63 U unmanaged networks, 76 User Name, 30 user-defined name, 30 V vertical and horizontal cropping, 40 vertical cropping, 39 visible light, 9 VLAN Ethernet switch, 75 VLAN group, 75 W workstation, 19 X XML device file, 16 Genie Color Series-GigE Vision Camera Index • 129
