Teledyne Piranha4 Quadlinear User Manual
  1. Manuals
  2. Brands
  3. Teledyne Manuals
  4. Digital Camera
  5. Piranha4
  6. User manual

Teledyne Piranha4 Quadlinear User Manual

Hide thumbs Also See for Piranha4 Quadlinear:
Table of Contents

Advertisement

Quick Links

Download this manual
Piranha4 Quadlinear

Camera User's Manual

Multispectral RGB + NIR / Monochrome CMOS Line Scan
sensors | cameras | frame grabbers | processors | software | vision solutions
P/N: 03-032-20217-02
www.teledynedalsa.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Piranha4 Quadlinear and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Teledyne Piranha4 Quadlinear

Summary of Contents for Teledyne Piranha4 Quadlinear

  • Page 1: Camera User's Manual

    Piranha4 Quadlinear Camera User’s Manual Multispectral RGB + NIR / Monochrome CMOS Line Scan sensors | cameras | frame grabbers | processors | software | vision solutions P/N: 03-032-20217-02 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

    Power Connector ........................35 LEDs ............................36 Step 3. Establish Camera Communication ....................37 Power on the camera........................37 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 Teledyne DALSA 03-032-20217-02...
  • Page 4 Transport Layer Feature Descriptions ..................83 Acquisition and Transfer Control Category....................84 Acquisition and Transfer Control Feature Descriptions ............85 Serial Port Control Category ........................86 Serial Port Control Feature Descriptions ..................87 File Access Control Category ........................88 File Access Control Feature Descriptions .................89 03-032-20217-02 Teledyne DALSA...
  • Page 5 Setting Up Communication between the Camera and the Frame Grabber ......115 Appendix F: Error and Warning Messages___________________________________________________________________ 118 Declarations of Conformity_______________________________________________________________________________ 120 FCC Statement of Conformance ....................120 EU and UKCA Declaration of Conformity .................120 Revision History ______________________________________________________________________________________ 121 Contact Information ____________________________________________________________________________________ 122 Sales Information ............................122 Technical Support............................122 Teledyne DALSA 03-032-20217-02...

  • 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. 03-032-20217-02 Teledyne DALSA...

  • Page 7: The Piranha4 Rgb + Nir / Monochrome Camera

    Monochrome Camera Camera Highlights The new Piranha4 quadlinear multispectral RGB + NIR / Mono cameras provide industry leading speeds that meet future requirements of higher throughput in multispectral imaging applications. Based on Teledyne DALSA’s unique CMOS line scan technology, the Piranha4 multispectral camera delivers superb color plus near-infrared (NIR) fidelity, spectrally independent outputs, all in a compact footprint and with an easy to use interface.

  • Page 8: Camera Performance Specifications

    < 340 g (without heat sinks) Operating Temp 0 °C to 65 °C, front plate temperature Optical Interface Lens Mount M42 x 1 F-mount adapter available Sensor to Camera Front Distance 12 mm Sensor Alignment (aligned to sides of camera) 03-032-20217-02 Teledyne DALSA...
  • Page 9 < 4.7 DN < 5.7 DN 4.76 nJ / cm2 5.1nJ / cm2 6.07 nJ / cm2 8.3 nJ / cm2 4.2 pJ / cm2 3.9 pJ / cm2 3.8 pJ / cm2 2.1 pJ / cm2 Teledyne DALSA 03-032-20217-02...

  • Page 10: Certifications

    GenApi module of the GenICam™ specification. The camera uses the GenICam™ Generic Control Protocol (GenCP V1.0) to communicate over the Camera Link serial port. For more information see www.genicam.org. 03-032-20217-02 Teledyne DALSA...

  • Page 11: Sensor Responsivity And Design

    Responsivity The responsivity graph illustrates the sensor’s response to different wavelengths of light (excluding lens and light source characteristics). Piranha4 2K Quad NIR Spectral Responsivity (12Bit) Green Blue 1000 1100 Wavelength (ɳm) Figure 1: Spectral Responsivity (NIR) Teledyne DALSA 03-032-20217-02...
  • Page 12 P4 2K Quad Linear Color Spectral Responsivity No White Balance, 12 bit, gain 1x 1000 Green Blue Mono Wavelength (nm) Figure 2: Spectral Responsivity (Monochrome) QE vs Wavelength 2K Quad Green Blue Mono 1050 Wavelength (nm) Figure 3: QE vs. Wavelength 03-032-20217-02 Teledyne DALSA...

  • Page 13: 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. Teledyne DALSA 03-032-20217-02...
  • Page 14 Line Spatial Correction = 3 (ssa = 3). This is the default condition. Example 2. Target running slower than example 1, same EXSYNC (trigger) frequency Line Spatial Correction = 3 (ssa = 3) Line Spatial Correction = 4.3 (ssa = 4.3) 03-032-20217-02 Teledyne DALSA...
  • Page 15 Line Spatial Correction = 3 (ssa = 3) Line Spatial Correction = 1 (ssa = 1) Example 5. Target running faster than EXSYNC Line Spatial Correction = 3 (ssa = 3) Line Spatial Correction = 5 (ssa = 5) Teledyne DALSA 03-032-20217-02...

  • Page 16: Parallax Correction

    Figure 6: CamExpert Parallax Correction Controls 4096 pixels 2048 pixels Figure 7: Figure 8 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. 03-032-20217-02 Teledyne DALSA...

  • Page 17: Camera Direction

    Selectable camera direction accommodates an object direction change on a web and allows you to mount the camera “upside down”. Note: The example here assumes the use of a lens (which inverts the image). Figure 9: Object Movement and Camera Direction Example, with a Lens Teledyne DALSA 03-032-20217-02...

  • Page 18: Mechanicals

    Piranha4 RGB + NIR / Mono Camera User's Manual Mechanicals Figure 10: Camera Mechanical 03-032-20217-02 Teledyne DALSA...

  • Page 19: Camera Mounting And Heat Sink Considerations

    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 20: 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. 03-032-20217-02 Teledyne DALSA...

  • Page 21: Software And Hardware Setup

    ASCII-based commands. A complete list of the commands can be found here, Appendix B: ASCII Commands. 4. Operate the Camera At this point you will be ready to start operating the camera in order to acquire images, set camera functions, and save settings. Teledyne DALSA 03-032-20217-02...

  • Page 22: Step 1. Install And Configure The Frame Grabber And Software

    These cameras implement the Camera link specification, which defines the device capabilities. The Camera link XML device description file is embedded within the camera firmware allowing Camera link-compliant applications to recognize the cameras’ capabilities immediately after connection. 03-032-20217-02 Teledyne DALSA...

  • Page 23: Step 2. Connect Data, Trigger, And Power Cables

    Figure 12: Input and Output, trigger, and Power Connectors WARNING! Grounding Instructions Static electricity can damage electronic components. It’s critical that you discharge any static electrical charge by touching a grounded surface, such as the metal computer chassis, before handling the camera hardware. Teledyne DALSA 03-032-20217-02...

  • Page 24: Data Connector: Camera Link

    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 13. SDR26 Camera Link Connector Data 2 Control / Data...

  • Page 25: Camera Link Bit Definitions

    Spare Direction Spare Table 6: Camera Control Configuration For additional Camera Link documentation refer to the Teledyne DALSA Web site’s application notes. Camera Timing Note: Information on setting up the camera’s AOI can be found here, Area of Interest (AOI) Setup.
  • Page 26 Blue 2 Blue 8 CL Port F D 0 .. D 7 D 0 .. D 7 D 0 .. D 7 D 0 .. D 7 D 0 .. D 7 D 0 .. D 7 03-032-20217-02 Teledyne DALSA...
  • Page 27 RGB data from the frame grabber buffer by the host application. Line rates up to 70 kHz can be achieved by using the Area of Interest (AOI) feature; where the smaller the AOI, the greater the potential line rate. Teledyne DALSA 03-032-20217-02...
  • Page 28 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 Mono/IR Mono/IR Green 11 Blue 2048 Mono/IR 8 Mono/IR 16 Blue 8 Green 3 Red 6 2040 2048 CL Port H D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 D0..D7 03-032-20217-02 Teledyne DALSA...
  • Page 29 The RGB output format is compatible with the Camera Link specification for Medium RGB. Line rates up to 70 kHz can be achieved by using the Area of Interest (AOI) feature; where the smaller the AOI, the greater the potential line rate. Teledyne DALSA 03-032-20217-02...
  • Page 30 The RGB output format is compatible with the Camera Link specification for Medium RGB. Line rates up to 70 kHz can be achieved by using the Area of Interest (AOI) feature; where the smaller the AOI, the greater the potential line rate. 03-032-20217-02 Teledyne DALSA...
  • Page 31 Camera Link frame grabber compatible with the Deca format configured for the mono standard, the R, G and then B pixels will be written sequentially into the frame grabber buffer. This process simplifies the extraction of the RGB data from the frame grabber buffer by the host application. Teledyne DALSA 03-032-20217-02...
  • Page 32 RGB data from the frame grabber buffer by the host application. Line rates up to 70 kHz can be achieved by using the Area of Interest (AOI) feature; where the smaller the AOI, the greater the potential line rate. 03-032-20217-02 Teledyne DALSA...
  • Page 33 1, 2 .., 511 (i.e. 8, 960 are allowed, 12 is not allowed). 3) In mirror mode, the first pixel of each AOI (AOI right edge) must have the location 8i + 7, where i = 0,1,2 .., 511 (i.e. 7, 15, 4095 are allowed, 8 is not allowed). Teledyne DALSA 03-032-20217-02...

  • Page 34: Camera Link Cable Quality And Length

    Depending upon the mode of operation the high time of the EXSYNC signal can represent the integration period. Note: The EXSYNC signal is measured at CC1 and will give a “true” measurement (i.e. within the measurement resolution of 25 ns) even though the camera will only trigger at a maximum of 70 KHz. 03-032-20217-02 Teledyne DALSA...

  • Page 35: Output Signals, Camera Link Clocking Signals

    Keep leads as short as possible in order to reduce voltage drop. • Use high-quality supplies in order to minimize noise. Note: If your power supply does not meet these requirements, then the camera performance specifications are not guaranteed. Teledyne DALSA 03-032-20217-02...

  • Page 36: Leds

    LED indicates the condition with the highest priority. Color of Status LED Meaning No power or hardware malfunction Blinking Green Powering up or calibrating Green Ready Error. Check BiST register for the specific error 03-032-20217-02 Teledyne DALSA...

  • Page 37: Step 3. Establish Camera Communication

    If the camera is operating correctly at this point, the diagnostic LED will shine green. Software Interface All the camera features can be controlled through the CamExpert interface. For example, under the Sensor Control menu in the camera window you can control the line rate and exposure times. Teledyne DALSA 03-032-20217-02...

  • Page 38: Using Sapera Camexpert With Piranha4 Cameras

    Note: The availability of the features is dependent on the CamExpert user setting. 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. 03-032-20217-02 Teledyne DALSA...

  • Page 39: Camexpert Panes

    Piranha4 RGB + NIR / Mono Camera User's Manual CamExpert Panes Figure 16. CamExpert’s Camera Control Window Teledyne DALSA 03-032-20217-02...
  • Page 40 • 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. 03-032-20217-02 Teledyne DALSA...

  • Page 41: Review A Test Image

    Green Value: {102, 103, 104…} Blue Value: {204, 205, 206…} Values roll over at 255. At this point you are ready to start operating the camera in order to acquire images, set camera functions, and save settings. Teledyne DALSA 03-032-20217-02...

  • Page 42: Camera Operation

    CamExpert GUI shown in the following examples. Parameters such as camera model, firmware version, sensor characteristics, etc. are read to uniquely identify the connected device. The camera information parameters are grouped together as members of the Camera Information set. 03-032-20217-02 Teledyne DALSA...

  • Page 43: Verify Temperature And Voltage

    LED will turn red. Once you have diagnosed and remedied the issue use the reset camera function. The voltage displayed is the camera’s input voltage. Note: The voltage measurement feature of the camera provides results typically within 1%. This measurement can be used to set the applied voltage to the camera. Teledyne DALSA 03-032-20217-02...

  • Page 44: Saving And Restoring Camera Settings

    User Set Default Selector. The chosen set automatically saves as the default setting and is the set loaded when the camera is reset or powered up. The relationship between these three settings is illustrated in Figure 19. Relationship between the Camera Settings: 03-032-20217-02 Teledyne DALSA...
  • Page 45 The command User Set Save saves the current settings to non-volatile memory as a User Set. The camera automatically restores the last saved user settings when it powers up. To restore the last saved user settings, select the User Set parameter you want to restore and then select the User Set Load parameter. Teledyne DALSA 03-032-20217-02...

  • Page 46: Camera Link Configuration

    Internal trigger (trigger disabled): The camera free-running mode has a programmable internal timer for line rate and a programmable exposure period. • External trigger (trigger enabled): Exposures are controlled by an external trigger signal. The external trigger signal is the Camera Link control line CC1. 03-032-20217-02 Teledyne DALSA...

  • Page 47: Exposure Controls

    Line Start event. Exposure Time Selector Internally generated. Allows for an independent exposure time to be applied to each individual color. Exposure Time Sets the exposure time (in microseconds). Exposure Mode feature must be set to Timed Teledyne DALSA 03-032-20217-02...

  • Page 48: Exposure Modes In Detail

    Warning! When running external line rate and external exposure time, the line rate must not exceed 1 / (exposure time + 1, 000 ns). Under these conditions the exposure time will become indeterminate and result in image artefacts. This is not the case when running internal exposure control. 03-032-20217-02 Teledyne DALSA...
  • Page 49 Exposure = X Sensor Sensor Sensor Readout Readout Readout LVAL 27.5us Notes: 1. Exposure time > 7 micro-seconds 2. Sensor Readout time = 14 micro-seconds 3. One additional falling edge during exposure is latched Figure 21. Exposure Modes Teledyne DALSA 03-032-20217-02...

  • Page 50: Color Exposure Time Guidelines

    If the external line rate exceeds 70 kHz the camera will continue to output data at its maximum line rate of 70 kHz. Though no image artefacts associated with over-speed will occur, you may notice that under 03-032-20217-02 Teledyne DALSA...

  • Page 51: Set Exposure Time

    -32 to +31 in 8-bit mode, -128 to +127 in 10-bit mode, and -512 to +511 in 12-bit mode. Gain Set the gain as an amplification factor applied to the video signal across all pixels: 1x to 10x. Teledyne DALSA 03-032-20217-02...

  • Page 52: Set Image Size

    Number of bits per character used in the Data Size serial port Parity of the serial port Parity None Number of stop bits per character used Number of Stop in the serial port Bits 03-032-20217-02 Teledyne DALSA...

  • Page 53: Pixel Format

    The feature Camera Reset, part of the Transport Layer set, resets the camera. The camera resets with the default settings, including a baud rate of 9600. Camera Information Parameter Description Camera Reset Resets the camera and puts in the default settings, including a 9600 baud rate. Teledyne DALSA 03-032-20217-02...

  • Page 54: Calibrating The Camera

    / or lens vignetting. When performed, this calibration 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. 03-032-20217-02 Teledyne DALSA...
  • Page 55 Gretag Macbeth® ColorChecker® illuminated by the application’s light source and processing the image using a color correction demonstration tool provided as part of Teledyne DALSA’s Sapera Processing software. This tool will generate the desired color correction file that can be downloaded to the camera.
  • Page 56 1. Off – Flat field correction coefficients are not applied. 2. On – Flat field correction coefficients are applied. 3. Initialize – Sending this value will reset all current coefficients (offsets to 0 and gains to 1x). flatfieldCalibrationColorSelector 1. Red - Select Red color 03-032-20217-02 Teledyne DALSA...
  • Page 57 3. Range 0 to 31 DN, 8 bit 4. Default value is 0 DN for each pixel flatfieldCalibrationPRNU 1. Use “flatfieldCorrectionAlgorithm” to calculate the per pixel gain to achieve the specified target output. 2. Max 15.9998x 3. Default 1x Teledyne DALSA 03-032-20217-02...
  • Page 58 1. Floating point digital multiplier applied to each pixel 2. Range 1x to 10x Note: An application note describing a color transformation matrix calibration (document #03- 032-20181) is available. Please contact Teledyne DALSA Support for more information. 03-032-20217-02 Teledyne DALSA...

  • Page 59: Appendix A: Genicam Commands

    Beginner, Expert, or Guru. 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 60: Camera Information Feature Descriptions

    This feature provides extended manufacturer 1.00 information about the device. (RO) Beginner Firmware Version DeviceFirmwareVersion Displays the currently loaded firmware 1.00 version number. Firmware files have a unique Beginner number and have the .cbf file extension. (RO) 03-032-20217-02 Teledyne DALSA...
  • Page 61 Select the User-defined Configuration space UserSet5 to save to or load from features settings previously saved by the user. UserSet6 UserSet6 Select the User-defined Configuration space UserSet6 to save to or load from features settings previously saved by the user. Teledyne DALSA 03-032-20217-02...
  • Page 62 Displays the input voltage to the camera at the 1.00 power connector (RO) DFNC Beginner Refresh Voltage refreshVoltage Press to display the current input voltage of 1.00 the camera at the power connector DFNC Beginner License Key securityUpgrade 1.00 DFNC Guru 03-032-20217-02 Teledyne DALSA...

  • Page 63: Camera Configuration Selection Dialog

    UserSetSelector). To reset the camera to the factory configuration, select Factory Setting and click Load. To save a current camera configuration, select User Set 1 to 8 and click Save. Select a saved user set and click Load to restore a saved configuration. Teledyne DALSA 03-032-20217-02...

  • Page 64: Camera Control Category

    Parameters in gray are read only, either always or due to another parameter being disabled. Parameters in black are user set in CamExpert or programmable via an imaging application. 03-032-20217-02 Teledyne DALSA...

  • Page 65: Camera Control Feature Descriptions

    Sets the exposure time (in microseconds) 1.00 when the Exposure Mode feature is set to Beginner Timed. Measured measureExposureTime Specifies the exposure time provided to the 1.00 Exposure Time camera by either internal or external source Beginner (RO) Teledyne DALSA 03-032-20217-02...
  • Page 66 Allows the user to select between two 1.00 Transformatio factory programmed matrixes or two user Beginner Selector loaded sets WhiteLEDFactorySet Color Correction Matrix for a white LED NoCorrectionFactorySet No correction MatrixUserSet1 User programmable/loaded correction matrix MatrixUserSet2 User programmable/loaded correction matrix 03-032-20217-02 Teledyne DALSA...
  • Page 67 Used to select between the green or red 1.00 Distortion nLineSelector lines to be corrected Beginner Correction Line Selector Image imageDistortionParallax Value entered indicates the number pixels 1.00 Distorition CorrectionPixelStretch to be shifted to correct the color alignment Beginner Parallax Correction Pixel Stretch Teledyne DALSA 03-032-20217-02...

  • Page 68: Independent Exposure Control

    Exposure Time Color Selector All, Red, Green, Blue, Mono Exposure Time Three-Letter Commands In the Camera Control Set Parameter Value scl (Select Exposure Time Color Selector) Select 0-ALL, 1-Red, 2-Green, 3-Blue, 4-Mono set (Set Exposure Time) Executes the command. 03-032-20217-02 Teledyne DALSA...
  • Page 69 For example, if the revised blue value is less than the current blue value, enter the green and red values first. If the new blue value is greater than the current blue value, enter the blue value first. Teledyne DALSA 03-032-20217-02...

  • Page 70: Digital I/O Control Feature Descriptions

    Defines the source of external trigger (RO) 1.00 DFNC Beginner Trigger Trigger Selector Defines what the trigger initiates (RO) 1.00 Selector DFNC Beginner Trigger Mode Trigger Mode Determines the source of trigger to the camera, 1.00 internal or external (CC1) DFNC Beginner 03-032-20217-02 Teledyne DALSA...

  • Page 71: Flat Field Category

    Parameters in gray are read only, either always or due to another parameter being disabled. 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 72: Flat Field Control Feature Description

    Beginner Basic Basic Direct calculation of coefficients DFNC based on average line values and target. First each color is flat fielded to its peak value and then the color gains are used to achieve the target. 03-032-20217-02 Teledyne DALSA...

  • Page 73: Region Of Interest (Roi)

    The ROI feature allows from one to four specific regions of the pixel line to be specified where flat field calibration will take place. Pixel data outside the ROI will not be used when performing flat field calibration. Teledyne DALSA 03-032-20217-02...

  • Page 74: Image Format Control Category

    Parameters in gray are read only, either always or due to another parameter being disabled. 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: Image Format Control Feature Description

    RGB 12bit plus NIR 12 bit** BGR12+mono12** BGR12+NIR12** BGR 12bit plus NIR 12 bit** Pixel Color Filter PixelColorFilter Indicates the type of color filter applied to 1.00 the image. (RO) Beginner DFNC Pixel Coding PixelCoding (RO) 1.00 Beginner DFNC Teledyne DALSA 03-032-20217-02...

  • Page 76: Area Of Interest (Aoi) Setup

    Note: The setup of AOI is always with respect to the sensor. Therefore, if you are using the mirroring mode with AOI, be aware that pixel one will be on the right side of the displayed image. 03-032-20217-02 Teledyne DALSA...
  • Page 77 1. Must be off to 2. Set up the number of set up the AOI. AOI desired to max of 4. 3. Select area to set up. 4. Select beginning of selected area 5. Set up width of selected area 2048 Teledyne DALSA 03-032-20217-02...
  • Page 78 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. Once all AOI are set up change to active. 03-032-20217-02 Teledyne DALSA...

  • Page 79: Instructions On Using The Camera Scan Direction To Control Camera Parameters

    Internal and the Internal Direction set to reverse. 2. Set up all the desired parameters, including flat field corrections. First, setup parameters for reverse direction. 3. Save the camera parameters to a User set other than the default user set. Teledyne DALSA 03-032-20217-02...
  • Page 80 CC3 and the Direction Source set to external or by having the Direction Source set to Internal and the Internal Direction set to forward. 5. Set up all the desired parameters including doing a flat field. Setup parameters for forward direction. 03-032-20217-02 Teledyne DALSA...
  • Page 81 Save to a different user set than the one selected for reverse direction. Set the Flat Field mode to Scan direction Controlled. 7. In the Flat Field area change the mode to Scan Direction Controlled. Teledyne DALSA 03-032-20217-02...

  • Page 82: Transport Layer Control Category

    Parameters in gray are read only, either always or due to another parameter being disabled. 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 83: Transport Layer Feature Descriptions

    GenCP Beginner Camera Link ClConfiguration Camera Link Output configuration 1.00 Configuration Base Beginner Medium Full Deca Camera Link clDeviceClockFrequency Set the camera link clock rate 1.00 Configuration CL85MHz Beginner CL66MHz Tap Geometry DeviceTapGeometry (RO) 1.00 Beginner Teledyne DALSA 03-032-20217-02...

  • Page 84: 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 85: Acquisition And Transfer Control Feature Descriptions

    DFNC Check Stream DeviceRegistersCheck Press to check the validity of the current 1.00 Validity register set. Beginner DFNC Registers Valid DeviceRegistersValid States if the current register set is valid 1.00 and consistent. Beginner DFNC Teledyne DALSA 03-032-20217-02...

  • Page 86: 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 87: Serial Port Control Feature Descriptions

    Sets the bits per character (bpc) to use (RO). 1.00 Eight Bits bpc8 Use 8 bits per character Beginner DFNC Stop Bits deviceSerialPortNumberOf Sets the number of stop bits to use. 1.00 StopBits Beginner Stopbits1 Stopbits1 Use 1 stop bit DFNC Teledyne DALSA 03-032-20217-02...

  • Page 88: File Access Control Category

    The supported data files are for camera firmware updates, Flat Field coefficients. 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 89: File Access Control Feature Descriptions

    Select READ only open mode Write Write Select WRITE only open mode File Access Buffer FileAccessBuffer Defines the intermediate access buffer that 1.00 allows the exchange of data between the device Guru file storage and the application. Teledyne DALSA 03-032-20217-02...
  • Page 90 File Operation Result FileOperationResult Displays the file operation result. For Read or 1.00 Write operations, the number of successfully Guru read/written bytes is returned. (RO) File Size FileSize Represents the size of the selected file in bytes. 1.00 Guru 03-032-20217-02 Teledyne DALSA...

  • Page 91: File Access Via The Camexpert Tool

    For diagnostic purposes you may want to download a list of all the parameters and values associated with the camera. 1. Go to File Access Control 2. Click on Settings 3. In the “Type” drop down box select “Miscellaneous.” 4. In the “File selector” drop down box select “CameraData.” Teledyne DALSA 03-032-20217-02...
  • Page 92 Piranha4 RGB + NIR / Mono Camera User's Manual 5. Hit “Download” Save the text file and send the file to Teledyne DALSA customer support. 03-032-20217-02 Teledyne DALSA...
  • Page 93 Piranha4 RGB + NIR / Mono Camera User's Manual Teledyne DALSA 03-032-20217-02...

  • Page 94: Appendix B: Ascii Commands

    Piranha4 RGB + NIR / Mono Camera User's Manual 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.
  • Page 95 The camera responds to a simple ASCII-based protocol. A carriage return <CR> ends each command. Example: to return the current detector settings gcp <CR> A complete list of the available detector commands, their format and parameters can be displayed by sending the help (h) command. Teledyne DALSA 03-032-20217-02...

  • Page 96: Port Configuration

    To enter a floating point number prefix it with a “F” – for example “ssg 0 f1.5” • Error codes returned are the same as the GenICam™ interface – see Diagnostics | Error Codes • Follow each command with the carriage return character – 0x0D 03-032-20217-02 Teledyne DALSA...

  • Page 97: Commands

    Full Name Color Matrix Selector Mnemonic Argument(s) Device 0. Factory 1. User # of lines to average 0 or 1, when factory selected above then 2. White LED 3. No correction (unity matrix) Description Color matrix selector Teledyne DALSA 03-032-20217-02...
  • Page 98 10. k offset 11. k offset • Floating Point Value Gains: -16 to +16 • Offsets: 0 to 255 Description Color Transformation Matrix • Value must be immediately preceded with a “F” (e.g. ctv 0 f1.5) Notes 03-032-20217-02 Teledyne DALSA...
  • Page 99 3. Scan direction controlled user set loading Description Set flat field mode Notes Full Name Set Flatfield Scan Direction Reverse Set Mnemonic Argument(s) User Set Number 1 to 8 Description Set scan direction controlled reverse set Notes Teledyne DALSA 03-032-20217-02...
  • Page 100 AOI Mode: CL Speed 85MHz CL Config Dual Base Pixel Fmt RGB8 CPA ROI 1-2048 USER> Full Name Get Value Mnemonic Argument(s) <’parameter> The “get” command displays the current value(s) of the feature specified in the string Description 03-032-20217-02 Teledyne DALSA...
  • Page 101 0: sensor video, 1: mono ramp, 2: color ramp Default User Set Set number 0-8 Load User Set Last set loaded 0-8 Save User Set Last set saved 0-8 Temperature No value returned Input Voltage No value returned Teledyne DALSA 03-032-20217-02...
  • Page 102 - Gain <0-System/1-Red/2-Green/3-Blue/4-Mono> f<gain> - External Trigger <0:Off 1:On> - Set User ID '<string> - Test Pattern <0-2> - Default User Set <0-8> - Load User Set <0-8> - Save User Set <1-8> - Temperature - Input Voltage USER> 03-032-20217-02 Teledyne DALSA...
  • Page 103 Reset Flatfield Coefficients Mnemonic Argument(s) Description Reset all user FPN values to zero and all user PRNU coefficients to one Notes Full Name Set AOI Count Mnemonic Argument(s) Number of AOI’s 1 to 4 Description Set AOI Counter Notes Teledyne DALSA 03-032-20217-02...
  • Page 104 Description Set baud rate • Notes Send command and then change speed of HyperTerminal Full Name Direction Mnemonic Argument(s) Direction 0. Forward 1. Reverse 2. External – controlled by CC3 signal Description Set sensor scan direction Notes 03-032-20217-02 Teledyne DALSA...
  • Page 105 Line time > ( Exposure time + 1,500 ns ) Full Name Select Flatfield Color Selector (2K07N model only) Mnemonic Argument(s) Selector 0. All 1. RGB 2. Red 3. Green 4. Blue 5. NIR Description Select which color(s) to be flatfielded by the cpa command Teledyne DALSA 03-032-20217-02...
  • Page 106 Set Horizontal Alignment Mode Mnemonic Argument(s) Selector 0. Off 1. On Description Enable the horizontal correction Notes Full Name Mirroring Mnemonic Argument(s) Mode 0. Off 1. Image is flipped on the vertical axis Description Set mirroring mode Notes 03-032-20217-02 Teledyne DALSA...
  • Page 107 5. Decimal places are valid for sub-pixel correction. Full Name Offset Mnemonic Argument(s) Offset 8 bit -32 to 31 10-bit -128 to 127 12-bit -512 to 511 Description Set offset • Notes Range changes depending on pixel format (SPF) Teledyne DALSA 03-032-20217-02...
  • Page 108 0. Off – sensor video 1. Ramp 2. Color Ramp Description Select test pattern • Notes When a test pattern is selected all digital processing (e.g. flat field, gain) is disabled – it is re-enabled when sensor video is selected 03-032-20217-02 Teledyne DALSA...
  • Page 109 Saves all the current settings listed by the GCP command plus the user FPN coefficients, user PRNU coefficients, and color correction matrix Full Name Temperature Mnemonic Argument(s) Description Display internal temperature in degrees Celsius Notes Full Name Voltage Mnemonic Argument(s) Description Display supply voltage Notes Teledyne DALSA 03-032-20217-02...

  • Page 110: 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 111 • If you are using white LEDs, your image will have reasonable color reproduction. • The image may be darker at the edges due to lens vignetting, but this will be improved once the camera is calibrated. Teledyne DALSA 03-032-20217-02...
  • Page 112 A software tool to generate this is available with the Sapera Essentials processing applications, which can be downloaded from the Teledyne DALSA web site (60 day free trial). You will require a Gretag Macbeth ColorChecker with 4 x 6 color elements that you can scan past the camera to complete the generation of the matrix.

  • Page 113: Appendix D: The Sensor Window

    (dark spot) and overcorrecting where the shadow used to be (white spot). While the dark spot can be potentially cleaned, the white spot is an FFC artifact that can only be corrected by another FFC calibration. Teledyne DALSA 03-032-20217-02...

  • Page 114: Cleaning The Sensor Window

    This procedure requires you to use multiple swabs. • Discard the swab after both sides of the swab have been used once. • Repeat until there is no visible contamination present. 03-032-20217-02 Teledyne DALSA...

  • Page 115: 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 116 Piranha4 RGB + NIR / Mono Camera User's Manual 7. Start the CamExpert application. In the Device tab, select CameraLink Medium Color RGB #1. 03-032-20217-02 Teledyne DALSA...
  • Page 117 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. Teledyne DALSA 03-032-20217-02...

  • Page 118: Appendix F: Error And Warning Messages

    1,0000,0000,0000 NO_FPN Correction 10,0000,0000,0000 NO_FPN Correction 100,0000,0000,0000 NO_PRNU Correction 1000,0000,0000,0000 NO_FEED Through Correction 1,0000,0000,0000,0000 NO_LINEARITY Correction 10,0000,0000,0000,0000 SYNC_ERROR 100,0000,0000,0000,0000 OVER_TEMPERATURE 1000,0000,0000,0000,0000 SPI Failure 1,0000,0000,0000,0000,0000 NO_USER_FPN 10,0000,0000,0000,0000,0000 PLL_LOCK_FAILED 100,0000,0000,0000,0000,0000 INVALID_CCI 1000,0000,0000,0000,0000,0000 No LUT 1,0000,0000,0000,0000,0000,0000 Incompatible FPGA code 10,0000,0000,0000,0000,0000,0000 03-032-20217-02 Teledyne DALSA...
  • Page 119 Piranha4 RGB + NIR / Mono Camera User's Manual Operational Error Codes Code Description 0X8002 Invalid Parameter 0xC01C CPA_TOO_MANY_OUTLIERS 0x401E USER_FPN_CLIPPING 0x401F FLAT_FIELD_CLIPPING Teledyne DALSA 03-032-20217-02...

  • Page 120: Declarations Of Conformity

    This equipment is intended to be a component of a larger industrial system. EU and UKCA Declaration of Conformity Teledyne DALSA declares that this product complies with applicable standards and regulations. Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.

  • Page 121: Revision History

    Piranha4 RGB + NIR / Mono Camera User's Manual Revision History Revision Change Description Date Release of the initial manual revision. September 16, 2015 flatfieldCalibrationColorSelector command description added August 25, 2017 Updated Declarations of Conformity. 1 October 2021 Teledyne DALSA 03-032-20217-02...

  • Page 122: Contact Information

    Sales Information Visit our web site: www.teledynedalsa.com Email: info@teledynedalsa.com Canadian Sales Teledyne DALSA — Head office Teledyne DALSA — Montreal office 605 McMurray Road 880 Rue McCaffrey Waterloo, Ontario, Canada, N2V 2E9 Saint-Laurent, Quebec, Canada, H4T 2C7 Tel: 519 886 6000...

Table of Contents