Teledyne Piranha4 User Manual

Teledyne Piranha4 User Manual

2k high speed polarization line scan
Hide thumbs Also See for Piranha4:
Table of Contents

Advertisement

Quick Links

Piranha4 Polarization

Camera User's Manual

2k High Speed Polarization Line Scan
sensors | cameras | frame grabbers | processors | software | vision solutions
P/N: 03-032-20245-01
www.teledynedalsa.com

Advertisement

Table of Contents
loading

Summary of Contents for Teledyne Piranha4

  • Page 1: Camera User's Manual

    Piranha4 Polarization Camera User’s Manual 2k High Speed Polarization Line Scan sensors | cameras | frame grabbers | processors | software | vision solutions P/N: 03-032-20245-01 www.teledynedalsa.com...
  • Page 2 All information provided in this manual is believed to be accurate and reliable. No responsibility is assumed by Teledyne DALSA for its use. Teledyne 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 Teledyne DALSA.
  • Page 3: Table Of Contents

    Contents Camera User’s Manual ___________________________________________________________________________________ 1 System Precautions ..........................6 Precautions .......................... 6 Electrostatic Discharge and the CMOS Sensor ..............6 The Piranha4 Polarization _________________________________________________________________________________ 7 Description ............................7 Key Features ........................7 Programmability ........................7 Applications ......................... 7 Part Numbers and Software Requirements ..................8 Camera Performance Specifications ....................
  • Page 4 Connect to the frame grabber ....................37 Connect to the camera ......................37 Check LED Status ....................... 37 Software Interface ........................ 37 Using Sapera CamExpert with Piranha4 Cameras ................38 CamExpert Panes ........................ 38 Review a Test Image ......................40 4. Camera Operation _____________________________________________________________________________________ 41 Factory Settings ...........................
  • Page 5 Setting Up Communication between the Camera and the Frame Grabber ......98 Appendix F: Error and Warning Messages ____________________________________________________________________ 101 BiST: Built in Self Test ......................101 Operational Error Codes ...................... 102 EMC Declaration of Conformity _____________________________________________________________________________ 103 Revision History _________________________________________________________________________________________ 104 Index _________________________________________________________________________________________________ 105 The Piranha4 Polarization •...
  • Page 6: System Precautions

    The charge normally dissipates within 24 hours and the sensor returns to normal operation. Additional information on cleaning the sensor window and protecting it against dust, oil, blemishes, and scratches can be found here, Appendix D: The Sensor Window. 6 • The Piranha4 Polarization...
  • Page 7: The Piranha4 Polarization

    The Piranha4 Polarization Description The Piranha4 Polarization™ camera is a breakthrough in the machine vision industry. This high-speed polarization camera provides three native polarization states plus an unfiltered channel. The Piranha4 polarization camera enhances detection capability in machine vision and is ideal for detecting surface roughness, film thickness, stresses, alloy composition, and 3D profiles.
  • Page 8: Part Numbers And Software Requirements

    Part Numbers and Software Requirements This manual covers the Piranha4 camera models summarized below. New models are added to this manual as they are released by Teledyne DALSA. Lens Mount Camera Resolution Pixel size Max. Line Rate Product Number (threaded)
  • Page 9: Environmental Specifications

    RoHS per EU Directive 2002/95/EC and WEEE per EU Directive 2002/96/EC and China Electronic Industry Standard SJ/T11364-2006 GenICam XML Description File, Superset of the GenICam™ Standard Features Naming Convention specification V1.5, Camera Link Serial Communication: GenICam™ Generic Control Protocol (GenCP V1.0) The Piranha4 Polarization •...
  • Page 10: Supported Industry Standards

    Supported Industry Standards GenICam Piranha4 cameras are GenICam™ compliant. The cameras implement a superset of the GenICam Standard Features Naming Convention specification V1.5. This description takes the form of an XML device description file complying with the syntax defined by the GenApi module of the GenICam specification.
  • Page 11 The Piranha4 Polarization •...
  • Page 12: Spatial Correction And Quadlinear Sensor Design

    The default setting for this feature is 2, which is set for square object pixels. The setting can be adjusted from 0 to 5 to compensate for rectangular pixels—whether they are too long or to short. 12 • The Piranha4 Polarization...
  • Page 13 1) Filter Characteristics: The following are birefringence test targets captured using the Piranha4 2k polarization camera. Birefringence patters are only detectable using polarization light. The three polarization channels clearly reveal the birefringence patterns, while the unfiltered channel cannot detect them.
  • Page 14 Figure 3. Polarization and Unfiltered Images of a Plastic Ruler 3) Suggested Illumination White LED, visible single wavelength LED (e.g. green), and NIR LED light sources with wavelength <1000 nm can be used depending on application requirements. 14 • The Piranha4 Polarization...
  • Page 15: Parallax Correction

    Figure 5: CamExpert Parallax Correction Controls Figure 6. Figure 7 Corrected Image The figure above is the same image corrected using the parallax correction. In this example the value of 3 was used to correct the image. The Piranha4 Polarization •...
  • Page 16: Camera Direction Example

    The selectable camera direction accommodates an object direction change on a web and lets you to mount the camera “upside down”. Note: the example here assumes the use of a lens (which inverts the image). Figure 8: Object Movement and Camera Direction Example, with a Lens 16 • The Piranha4 Polarization...
  • Page 17: Mechanicals

    FIRST PIXEL M42x1 - 6H REFERENCE HOLES M4x0.7 - 6H (2X) THIS SIDE (2X) FAR SIDE (42) NOTES: 1. UNITS: MILLIMETERS. 2. IMAGE AREA IS ALIGNED TO DATUMS A B & C . Figure 9: Camera Mechanical The Piranha4 Polarization •...
  • Page 18: Camera Mounting And Heat Sink Considerations

    These heat sinks are designed to provide adequate convection cooling when not obstructed by enclosures or mounting assemblies. Teledyne DALSA recognises that each customer’s application can be unique. In consideration, camera’s heat sinks have been designed in such a way that they can be repositioned on the different faces of the camera or removed entirely, depending on the mounting configuration and its heat sinking potential.
  • Page 19: Quick, Simple Steps To Acquire An Image

    Quick, Simple Steps to Acquire an Image For users who are familiar with Camera Link cameras, have a basic understanding of their imaging requirements, and who are primarily interested in evaluating the camera, an overview of the steps required to get this camera operational and acquiring images quickly can be found in Appendix C: Quick Setup and Image Acquisition.
  • Page 20: Step 3. Establish Communicating With The Camera

    Note: the use of cables types and lengths other than those specified may result in increased emission or decreased immunity and performance of the camera. Step 3. Establish communicating with the camera Start the GUI and establish communication with the camera. Refer to Step 2: Connect Camera Link and Power Cables for a description on communicating with the camera.
  • Page 21: Step 2. Connect Data, Trigger, And Power Cables

    Step 2. Connect Data, Trigger, and Power Cables Note: the use of cables types and lengths other than those specified may result in increased emission or decreased immunity and performance of the camera. Figure 11: Input and Output, trigger, and Power Connectors WARNING! Grounding Instructions Static electricity can damage electronic components.
  • Page 22: Data Connector: Camera Link

    Connector and the tables that follow list the Camera Link configurations. For detailed information on Camera Link please refer to the Camera Link Road Map available from the Knowledge Center on the Teledyne DALSA Web site. Figure 12. SDR26 Camera Link Connector Data 2 Control / Data 1...
  • Page 23: Camera Link Bit Definitions

    Signal Configuration EXSYNC Spare Direction Spare Table 2: Camera Control Configuration For additional Camera Link documentation refer to the Teledyne DALSA Web site’s Knowledge Center application notes. Camera Link Timing Diagrams Polarization Angle to Color Mapping Camera Micro-Polarizer Filter Polarization State Output 90º...
  • Page 24 RGB 8 bit, CL Base, maximum line rate 40 kHz, no AOI and 85 MHz CL clock Line Valid CL Clock Red 2 Red 3 Red 4095 Red 4096 Red 1 Red 4 CL Port A D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 Green 2...
  • Page 25 RGB 8 bit, Dual Base, plus 8 bit monochrome, maximum line rate 40 kHz, no AOI and 85 MHz CL clock Line Valid CL Clock Red 1 Red 2 Red 3 Red 4 Red 2047 Red 2048 CL Port A D0..D7 D0..D7 D0..D7...
  • Page 26 Load the camera file (T_P4-CP-02k07Q_004590m_2KX4Channel.ccf) to the CamExpert (File > Open). This allows you to view the camera’s four-channel image in one window of the CamExpert. To get the CCF file contact your local support team. 26 • Software and Hardware Setup...
  • Page 27 RGB 8 bit, CL Medium, maximum line rate 70 kHz, no AOI and 85 MHz CL clock Line Valid CL Clock Red 1 Red 3 Red 5 Red 7 Red 4093 Red 4095 CL Port A D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 Green 3...
  • Page 28 RGB 8 bit, monochrome, plus 8 bit CL Medium, maximum line rate 62 kHz, no AOI and 85 MHz CL clock Line Valid CL Clock Mono/IR Mono/IR Red 1 Red 3 Red 2045 Red 2047 Mono/IR 1 Mono/IR 7 CL Port A 2037 2043 D0..D7...
  • Page 29 RGB 8 bit, CL Full, plus monochrome 8 bit CL Full Line Valid CL Clock Mono/IR Mono/IR Red 1 Red 9 Green 2046 Mono/IR 1 Mono/IR 9 Blue 3 Green 6 CL Port A 2033 2041 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7...
  • Page 30 RGB 10 bit, CL Medium, maximum line rate 40 kHz, no AOI and 85 MHz CL clock Port B Bit Assignments Port F Bit Assignments Red 8 Green 8 Red 9 Green 9 Blue 8 Blue 9 This timing can be used for applications that require line rates up to 20 kHz and therefore must use Camera Link Medium mode and two cables.
  • Page 31 RGB 12 bit CL Medium, maximum line rate 40 kHz, no AOI and 85 MHz CL clock Port B Bit Assignments Port F Bit Assignments Red 8 Green 8 Red 9 Green 9 Red 10 Green 10 Red 11 Green 11 Blue 8 Blue 9 Blue 10...
  • Page 32 RGB 12 bit, CL Deca, maximum line rate 70 kHz, no AOI and 85 MHz CL clock This timing can be used for applications that require line rates up to 69 kHz. These applications must use Camera Link Deca mode and two cables. The RGB output format is not defined in the Camera Link specification Deca.
  • Page 33 achieved by using the Area of Interest (AOI) feature; where the smaller the AOI, the greater the potential line rate. RGB plus monochrome 12 bit CL Deca, maximum line rate 70 kHz, no AOI and 85 MHz CL clock This timing can be used for applications that require line rates up to 70 kHz. These applications must use Camera Link Deca mode and two cables.
  • Page 34 Base and Medium Modes 1) The total number of pixels within each AOI must be a multiple of 8 and must be greater than or equal to 40. 2) In normal mode, the first pixel of each AOI (AOI left edge) must have the location 8i, where i = 0, 1, 2 .., 511 (i.e.
  • Page 35: Input Signals, Camera Link

    Camera Link cable quality and length The maximum allowable Camera Link cable length depends on the quality of the cable used and the Camera Link strobe frequency. Cable quality degrades over time as the cable is flexed. In addition, as the Camera Link strobe frequency is increased the maximum allowable cable length will decrease.
  • Page 36: Power Connector

    Power Connector WARNING: It is extremely important that you apply the appropriate voltages to your camera. Incorrect voltages may damage the camera. Input voltage requirement: +12 V to +24 V DC, 2 Amps. Before connecting power to the camera, test all power supplies. Figure 13: 6-pin Hirose Circular Male Power Plug—Power Connector Table 3.
  • Page 37: Step 3. Establish Camera Communication

    Step 3. Establish Camera Communication Power on the camera Turn on the camera’s power supply. You may have to wait while the camera readies itself for operation. The camera must boot fully before it will be recognized by the GUI—the LED shines green once the camera is ready.
  • Page 38: Using Sapera Camexpert With Piranha4 Cameras

    CamExpert is the camera interfacing tool supported by the Sapera library. When used with a Piranha4 camera, CamExpert allows a user to test all camera operating modes. Additionally CamExpert saves the camera user settings configuration to the camera or saves multiple configurations as individual camera parameter files on the host system (*.ccf).
  • Page 39 Figure 15. CamExpert GUI showing connected camera The CamExpert application uses panes 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.
  • Page 40: Review A Test Image

    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 display controls: (these do not modify the frame buffer data) Stretch image to fit, set image display to original size, or zoom the image to virtually any size and ratio.
  • Page 41: Camera Operation

    4. Camera Operation Factory Settings The camera ships and powers up for the first time with the following factory settings: • Camera Link Medium, 8 bit pixels, 85 MHz Internal trigger, line rate 10 kHz • • Internal exposure control, exposure time 30.5 µs Flat field disabled •...
  • Page 42: Verify Temperature And Voltage

    Verify Temperature and Voltage To determine the voltage and temperature at the camera, use the Refresh Voltage and Refresh Temperature features found in the Camera Information set. The temperature returned is the internal temperature in degrees Celsius. For proper operation, this value should not exceed 80 °C. If the camera exceeds the designated temperature it will stop imaging and the LED will turn red.
  • Page 43 The relationship between these three settings is illustrated in Figure 17. Relationship between the Camera Settings: Figure 17. Relationship between the Camera Settings Active Settings for Current Session The active setting for the current session is the set of configurations that are operating while the camera is currently running, including all unsaved changes you have made to the settings before saving them.
  • Page 44: Camera Link Configuration

    Factory Settings The factory setting is the camera settings that were shipped with the camera and which loaded during the camera’s first power-up. To load or restore the original factory settings, at any time, select the Factory Setting parameter and then select the User Set Load parameter.
  • Page 45 Description Line Rate Exposure Time Trigger Source (Sync) Internal line rate and exposure time Internal, programmable Internal programmable Internal External line rate and exposure time Controlled by EXSYNC External (EXSYNC) External pulse EXSYNC pulse controlling the line Controlled by EXSYNC Internal programmable External rate.
  • Page 46: Exposure Modes In Detail

    Exposure Modes in Detail 1. Internally Programmable Line Rate and Internally Programmable Exposure Time (Default) Line rate is the dominant factor when adjusting the line rate or exposure time. When setting the line rate exposure time will decrease, if necessary, to accommodate the new line rate. When adjusting the exposure time the range is limited by the line rate.
  • Page 47 1. External Trigger Off, Internal Exposure Control Free running, not synchronized to an external signal Programmable Line Time >1.5us Programmable Exposure Programmable Exposure Programmable Exposure Sensor Sensor Sensor Readout Readout Readout LVAL 27.5us 2. External Trigger On, Internal Exposure Control CC1 Falling edge triggers start of internal exposure Line Time >1.5us...
  • Page 48: Set Line Rate

    Exposure Time Guidelines The camera has no limitations on the combinations of the exposure times available for each polarization state except the maximum of 3 ms and the minimum of 7 μs exposure times. Operating the camera with the conditions stated below will give the user optimum image performance.
  • Page 49: Set Exposure Time

    trigger is disabled (Trigger Mode off). Line Rates Camera Link Configuration Maximum Line Rate Base 40 kHz Medium 41 kHz Full 55 kHz Deca 68.5 kHz (Deca RGB8) Note: 70 kHz line rate can be achieved using AOI mode for all Camera Link Mode. For more information, see Area of Interest (AOI) Setup.
  • Page 50: Set Baud Rate

    Width Width of the image. Height Height of the image in lines. Pixel Format 8 bit depth to Camera Link. Test Image Selector Select an internal test image: Color Ramp Grey Ramp Set Baud Rate The baud rate sets the speed (in bits per second—bps) of the serial communication port and is available as part of the Serial Port Control parameters.
  • Page 51: Camera Direction Control

    Camera Direction Control Found in the I / O Control > Direction Control set of features. Direction Control Parameter Description Sensor Scan Direction This command lets you select the Internal or external direction control. Use this feature to accommodate object direction change on a web and to mount the camera "upside down."...
  • Page 52: Calibrating The Camera

    Calibrating the Camera Important Note: to ensure best results, the conditions under which you calibrate the camera (e.g. temperature and illumination) should be as close to the actual operating conditions as possible. Figure 20: Flat Field Calibration in CamExpert Overview The following diagram and accompanying description explain the cameras signal processing chain.
  • Page 53 will cause the camera to have a flat response to a white target in the field of view. The output target value for PRNU calibration can be set by the user. 3. A single overall system gain is applied equally to all lines. It will therefore not cause color distortion when changed.
  • Page 54 1. Flat Field This Flat Field set contains a number of features that are used to correct image distortion due to lens vignetting and uneven illumination. Note: 1. Flat field coefficients consist of an offset and gain for each pixel. 2.
  • Page 55 2. Contrast Enhancement The offset and gain features can be used to maximize the use of the output dynamic range. Typical use is to subtract the minimum pixel value expected and then gain up to the maximum pixel value to approach full scale. Offset 1.
  • Page 56: Appendix A: Genicam Commands

    CamExpert interface. Features listed in the description table but tagged as Invisible are typically reserved for Teledyne DALSA Support or third party software usage, and not typically required by end user applications. A note on the CamExpert examples shown here: The examples shown for illustrative purposes and may not entirely reflect the features and parameters available from the camera model used in your application.
  • Page 57: Camera Information Feature Descriptions

    Camera Information Feature Descriptions The following table describes these parameters along with their view attributes and in which version of the device the feature was introduced. Additionally the Device Version column will indicate which parameter is a member of the DALSA Features Naming Convention (using the tag DFNC), versus the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 58 Power-up UserSetDefaultSelector Selects the camera configuration set to load and 1.00 Configuration Selector make active on camera power-up or reset. The Beginner camera configuration sets are stored in camera non-volatile memory. (RW) Factory Setting Default Load factory default feature settings UserSet1 UserSet1 Select the user defined configuration UserSet 1...
  • Page 59 Current User Set UserSetSelector Points to which user set (1-8) or factory set that 1.00 is loaded or saved when the UserSetLoad or Beginner UserSetSave command is used Load Configuration UserSetLoad Loads the camera configuration set specified by 1.00 the User Set Selector feature, to the camera Beginner and makes it active.
  • Page 60: Camera Information: Camera Configuration Selection Dialog

    Camera Information: Camera Configuration Selection Dialog The Power-up Configuration dialog box combines the camera’s power-up state (factory or user sets) with the user load / save options (factory or user sets). Camera Power-up Configuration The first drop list sets the camera configuration state to load during a camera power-up (see feature UserSetDefaultSelector).
  • Page 61 Appendix A: GenICam Commands •...
  • Page 62: Camera Control Feature Descriptions

    Camera Control Feature Descriptions The following table describes these parameters along with their view attribute and minimum camera firmware version required. Additionally the firmware column will indicate which parameter is a member of the DALSA Features Naming Convention (DFNC), versus the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 63 Internal sensorScanDirection When ScanDirectionSource set to Internal, 1.00 Direction determines the direction of the scan Beginner Forward Reverse Black Level BlackLevelSelector Selects which black level to adjust using the 1.00 Selector supplied black level features. Beginner All Channels Offset applied to all digital channels 0Degree(R) Offset applied to the 0Degree(R) digital channel 90Degree(G)
  • Page 64: Independent Exposure Control

    Independent Exposure Control The cameras feature independent exposure control. This feature allows the user to set a different exposure times for each color. The screenshot above shows the blue color selected. Green and red are selected from the same drop-down box. Adjust the independent exposure control using either the GUI or the 3-letter commands: CamExpert GUI In the Camera Control Set...
  • Page 65: Digital I/O Control Feature Descriptions

    Three-Letter Commands In the Camera Control Set Parameter Value scl (Select Exposure Time Color Selector) Select 0-ALL 1 - 0 Line (R) 2 - 90 Line (G) 3 - 135 Line (B) 4 – Mono (Unfiltered) set (Set Exposure Time) Executes the command.
  • Page 66: Flat Field Category

    Parameters in black are user set in CamExpert or programmable via an imaging application. Features listed in the description table but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
  • Page 67: Flat Field Control Feature Description

    Flat Field Control Feature Description The following table describes these parameters along with their view attribute and minimum camera firmware version required. Additionally the firmware column will indicate which parameter is a member of the DALSA Features Naming Convention (DFNC), versus the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 68: Region Of Interest (Roi)

    Calibration Sample Size flatfieldCalibrationSampleSize Sets the number of lines to be 1.00 averaged during a flat field Beginner Lines_2048 Lines_2048 calibration DFNC ROI Offset X flatfieldCalibrationROIOffsetX Set the starting point of a region of 1.00 interest where a flat field calibration Beginner will be performed DFNC...
  • Page 69: Image Format Control Category

    Parameters in black are user set in CamExpert or programmable via an imaging application. Features listed in the description table but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
  • Page 70: Image Format Control Feature Description

    Image Format Control Feature Description The following table describes these parameters along with their view attribute and minimum camera firmware version required. Additionally the firmware column will indicate which parameter is a member of the DALSA Features Naming Convention (DFNC), versus the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 71: Area Of Interest (Aoi) Setup

    Multiple AOI 1.00 multipleAOIMode Turns on an output Area of Interest Mode Area of interest is off Beginner Active Area of interest is on Active Multiple AOI Count multipleAOICount Set the number of output area of interest 1-4 1.00 Beginner DFNC Multiple AOI Selector multipleAOISelector...
  • Page 72 3. To set up each AOI individual use the AOI Selector to point to the AOI to be set up. 4. AOI Offset X is used indicate the starting pixel of the AOI. 5. AOI Width is used to indicate the width of the AOI. 72 •...
  • Page 73 In order to initiate operation of the AOI once setup: 1. The AOI mode must be changed to Active. 2. Be sure to set the frame grabber image width to the sum of all AOI widths set up in the camera. Appendix A: GenICam Commands •...
  • Page 74: Transport Layer Control Category

    Parameters in black are user set in CamExpert or programmable via an imaging application. Features listed in the description table but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
  • Page 75: Transport Layer Feature Descriptions

    Transport Layer Feature Descriptions The following table describes these parameters along with their view attribute and minimum camera firmware version required. Additionally the firmware column will indicate which parameter is a member of the DALSA Features Naming Convention (DFNC), versus the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 76: Acquisition And Transfer Control Category

    Parameters in black are user set in CamExpert or programmable via an imaging application. Features listed in the description table but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
  • Page 77: Serial Port Control Category

    The Serial Port control in CamExpert allows the user to select an available camera serial port and review its settings. Features listed in the description table but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
  • Page 78: File Access Control Category

    LUT data tables, and a custom image for use as an internal test pattern. Features listed in the description table but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
  • Page 79 Upload new CCI to the camera which will execute on the next camera reboot cycle. Upload new XML to the camera which will execute on the next camera reboot cycle. User Set Use UserSetSelector to specify which user set to access.
  • Page 80: File Access Via The Camexpert Tool

    File Access via the CamExpert Tool 1. Click on the “Setting…” button to show the file selection menu. 2. From the Type drop menu, select the file type that will be uploaded to the camera. 3. From the File Selector drop menu, select the camera memory location for the uploaded data.
  • Page 81: Download A List Of Camera Parameters

    3. In the “Type” drop down box select “Miscellaneous.” 4. In the “File selector” drop down box select “CameraData.” 5. Hit “Download” Save the text file and send the file to Teledyne DALSA customer support. Appendix A: GenICam Commands •...
  • Page 82: Appendix B: Ascii Commands

    Appendix B: ASCII Commands The following commands can be used to control the Teledyne DALSA Piranha4 cameras. Accessing the Three Letter Commands (TLC) To access the TLC an ASCII-based communications interface application, such as HyperTerminal. Additionally it is possible to use the functions of clserxxx.dll or clallserial.dll as defined in the Camera Link Specification.
  • Page 83: Ascii To Gencp

    Notes on Using Alternatives to HyperTerminal If you are using interfaces other than HyperTerminal, the ASCII character, ESC, is • decimal 27 and needs to be issued. From the command line insert ESC by using ALT+2+7 of the activated Num-Pad. In some cases this needs to be followed by a carriage return or a linefeed to send this to the camera.
  • Page 84: Commands

    Commands Full Name Calibrate User FPN Mnemonic Argument(s) # of lines to average 2048 or 4096 Calibrate user FPN dark flat field coefficients. Description Camera Link Speed Full Name Mnemonic Argument(s) Frequency 0: 85 MHz 1: 66 MHz Camera Link clock frequency Description Camera Link Mode Full Name...
  • Page 85 Click on “Transfer” Browse and find file Select “Xmodem” protocol Click “Send” When it indicates that it is done click “Close” Upload all files and then reset camera Full Name Flatfield Mode Mnemonic Argument(s) Mode Disable use of user FPN and PRNU flat field correction coefficients Enable use of user FPN and PRNU flat field correction coefficients...
  • Page 86 Meas E.T. 51000 [ns] Max E.T. 98500 [ns] Test Pat. 0:Off Direction Internal, Forward Line Delay 2.00 Hor Alig Mode Off Flat Field System Offset 0 0Deg-R Offset 0 90Deg-G Offset 0 135Deg-B Offset 0 Mono Offset System Gain 1.00 0Deg-R Gain 1.00 90Deg-G Gain 1.00...
  • Page 87 AOI 2 Offset AOI 2 Width Set AOI Mode 0: Disabled, 1: Enabled Set Baud Rate No value returned Scan Direction 0: Internal, 1: External (CC3) control 0: Forward, 1: Reverse Exposure Mode 0: Internal, 1: External Exposure Time Mirroring Mode 0: Enabled, 1:Disabled Pixel Format 0: RGB8, 1: RGB12...
  • Page 88 set - Set Exposure Time [ns]. See manual for restrictions on integration time sfs - Select FlatField Color Selector <0-All,2-0Degree(R),3-90Degree(G),4-135Degree(B),5- MONO> sha - Set horizontal alignment in float <0-0Degree(R), 1-90Degree(G)> f<value 0-3> shm - Set horizontal alignment mode < 0-Off, 1-Active> smm - Mirroring <0:Off 1:On>...
  • Page 89 Argument(s) Description Reset all user FPN values to zero and all user PRNU coefficients to one Notes Set AOI Count Full Name Mnemonic Number of AOI’s 1 to 4 Argument(s) Description Set AOI Counter Notes Full Name Set AOI Selector Mnemonic Argument(s) Selector...
  • Page 90 Notes Select Exposure Time Color Selector Full Name Mnemonic Color Selector 0: All Argument(s) 1: 0 Line (R) 2: 90 Line (G) 3: 135 Line (B) 4: Mono (unfiltered) Select the color to apply an exposure time value to. Description Notes Exposure Mode Full Name...
  • Page 91 The value entered will stretch the chosen polarization state to align the colors. Description Notes Set Horizontal Alignment Mode Full Name Mnemonic Argument(s) Selector 0: Off 1: On Enable the horizontal correction Description Notes Mirroring Full Name Mnemonic Mode 0: Off Argument(s) 1: On—image is flipped on the vertical axis Set mirroring mode...
  • Page 92 12-bit -512 to 511 Description Set offset Range changes depending on pixel format (SPF) Notes Internal Line Rate Full Name Mnemonic Line rate 1 to 70,000 [Hz] Argument(s) Description Set internal line rate Line time > ( Exposure time + 1,500 ns ) Notes Full Name Gain...
  • Page 93 The settings include all those listed by the GCP command plus the user FPN coefficients, user Notes PRNU coefficients, and color correction matrix Full Name Load User Set Mnemonic Argument(s) Set selector 0: factory set 1-8: user sets Description Load user set Loads and makes current all the settings listed by the GCP command plus the user FPN Notes coefficients, user PRNU coefficients, and color correction matrix...
  • Page 94: Appendix C: Quick Setup And Image Acquisition

    CamExpert provides an easy-to-use GUI that can be used to set up and evaluate the • camera. The camera also comes with Teledyne DALSA’s three letter command (TLC) interface • option, which can be accessed using a suitable terminal program such as HyperTerminal™.
  • Page 95 4. Camera Timing & Control It is easiest and quickest to evaluate the camera using the internal timing setups for line rate and exposure time. Since we recommend starting with Camera Link medium mode, set a suitable line • rate less than 40 KHz, using the ‘ssf’ command. If this line rate is too slow for your application, you will get a compressed image in •...
  • Page 96: Appendix D: The Sensor Window

    Appendix D: The Sensor Window Cleaning and Protecting Against Dust, Oil, and Scratches The sensor window is part of the optical path and should be handled like other optical components, with extreme care. Dust can obscure pixels, producing dark patches on the sensor response.
  • Page 97: Cleaning The Sensor Window

    Cleaning the Sensor Window Recommended Equipment Glass cleaning station with microscope within clean room. • 3M ionized air gun 980 • (http://solutions.3mcanada.ca/wps/portal/3M/en_CA/WW2/Country/) • Ionized air flood system, foot operated. Swab (HUBY-340CA-003) • (http://www.cleancross.net/modules/xfsection/article.php?articleid=24) Single drop bottle (FD-2-ESD) • E2 (Eclipse optic cleaning system (www.photosol.com) •...
  • Page 98: Appendix E: Camera, Frame Grabber Communication

    Teledyne DALSA Camera Link cameras support the GenCP Camera Link standards. To configure Teledyne DALSA GenCP Camera Link Cameras: 1. Install the Teledyne DALSA frame grabber in the host computer; refer to the hardware installation manual. 2. Install Sapera LT and the Teledyne DALSA frame grabber driver.
  • Page 99 7. Start the CamExpert application. In the Device tab, select CameraLink Full Mono Appendix E: Camera, Frame Grabber Communication •...
  • Page 100 8. Modify the camera and frame grabber parameter settings as required. At present, when using GenCP cameras, the camera and frame grabber parameters must be adjusted separately. Test the image acquisition by clicking the Grab button. 9. Save the frame grabber configuration to a new *.ccf file. 100 •...
  • Page 101: Appendix F: Error And Warning Messages

    Appendix F: Error and Warning Messages BiST: Built in Self Test The BiST error flags are binary flags with each bit being independent from each other. The message from the BiST should be “Good” meaning everything is functioning correctly but if a hardware failure does occur in the camera one or more these flags could be set.
  • Page 102: Operational Error Codes

    Operational Error Codes Code Description 0X8002 Invalid Parameter 0xC01C CPA_TOO_MANY_OUTLIERS 0x401E USER_FPN_CLIPPING 0x401F FLAT_FIELD_CLIPPING 102 • Appendix F: Error and Warning Messages...
  • Page 103: Emc Declaration Of Conformity

    EMC Declaration of Conformity EMC Declaration of Conformity •...
  • Page 104: Revision History

    Revision History Revision Change Description Date Initial release. November 22, 2016 - Responsivity graph revised, contrast ratio graph added. August 25, 2017 - flatfieldCalibrationColorSelector command description added 104 • Revision History...
  • Page 105: Index

    Index EXSYNC, 35 baud rate, 50 BiST, 101 factory settings, 41 black level control, 49 Gain control, 49 calibration, 52 grounding instructions, 21 flat field, 54 process chain, 52 CamExpert, 38 camera control signals, 23 overview, 37 camera information, 41 camera interfacing tool, 38 Camera Link cables, 35...
  • Page 106 loading, 42 precautions, 6 saving, 42 user, 43 setup overview, 19 quantum efficiency shift direction, 16 graph, 10 size image, 49 specifications mechanical, 8 rebooting, 51 performance, 8 requirements storage temperature, 9 PC, 19 responsivity graph, 10 revision history, 104 temperature verify, 42 test patterns, 40...

Table of Contents