Hide thumbs Also See for Piranha4:
Table of Contents

Advertisement

Quick Links

Piranha4

Camera User's Manual

Monochrome 8k
sensors | cameras | frame grabbers | processors | software | vision solutions
P/N: 03-032-20133-05
www.teledynedalsa.com

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Dalsa Piranha4

  • Page 1: Camera User's Manual

    Piranha4 Camera User’s Manual Monochrome 8k sensors | cameras | frame grabbers | processors | software | vision solutions P/N: 03-032-20133-05 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

    Step 1. Install and configure the frame grabber, graphics card and GUI ..16 Step 2. Connect Data, Trigger, and Power Cables ......... 17 Step 3. Establish Communication with the Camera ........23 Using Sapera CamExpert with Piranha4 Cameras .......... 26 4. Camera Operation________________________________________________________________________ 29 Factory Settings....................29 Check Camera and Sensor Information ............
  • Page 4 Camera Information Category ................. 52 Camera Control Category ................58 Flat Field Category .................... 66 Image Format Control Category ..............68 Binning ........................ 71 Area of Interest (AOI) Setup ................71 Instructions on using the camera scan direction to control camera parameters......................
  • Page 5: System Precautions And Cleaning

    1. System Precautions and Cleaning Precautions Read these precautions and this manual carefully before using the camera. Confirm that the camera’s packaging is undamaged before opening it. If the packaging is damaged please contact the related logistics personnel. Do not open the housing of the camera. The warranty is voided if the housing is opened. Keep the camera housing temperature in a range of 0 °C to 50 °C during operation.
  • Page 6 that may damage the sensor. To avoid ESD damage and to avoid introducing oily residues, avoid touching the sensor. Scratches diffract incident illumination. When exposed to uniform illumination, a sensor with a scratched window will normally have brighter pixels adjacent to darker pixels. The location of these pixels will change with the angle of illumination.
  • Page 7 location on 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.
  • Page 8: The Piranha4 Camera

    Programmability includes exposure control, flat field correction, and gain settings. The Piranha4 8k camera is ideal for flat panel display, printed circuit board, solar cell, film, and large format web inspection.
  • Page 9: Camera Performance Specifications

    Models The camera is available in the following configurations: Table 1: Camera Models Overview Model Number Description P4-CM-8K070-00-R 8k resolution, 70 kHz line rate, 573 Mpix/s throughput, Camera Link interface. Table 2: Software Software Product Number / Version Number Camera firmware Embedded within camera GenICam™...
  • Page 10: Certifications And Compliance

    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) Supported Industry Standards GenICam™ Piranha4 cameras are GenICam compliant. They implement a superset of the GenICam™ Standard Features Naming Convention specification V1.5.
  • Page 11: Responsivity

    This description takes the form of an XML device description file respecting the syntax defined by the 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.
  • Page 12: Fpn Characteristics With Temperature

    Spectral Quantum Efficiency 70.0 60.0 50.0 40.0 30.0 20.0 10.0 Wavelength [ nm ] Figure 2: Spectral Quantum Efficiency FPN Characteristics with Temperature Figure 3: FPN Derating Chart...
  • Page 13: Mechanicals

    Mechanicals Figure 4: Camera Mechanical...
  • Page 14 Figure 5: Camera Mechanical with External Heat Sink Camera Mounting and Heat Sink Considerations The Piranha4 cameras ships with two heat sinks installed and ideally positioned to allow close spacing of the cameras. These heat sinks are designed to provide adequate convection cooling when not obstructed by enclosures or mounting assemblies.
  • Page 15: Software And Hardware Setup

    3. Software and Hardware Setup Recommended System Requirements To achieve best system performance, the following minimum requirements are recommended: • High bandwidth frame grabber recommended, e.g. Xcelera-CL PX4 Full Camera Link frame grabber (Part # OR-X4CO-XPF00). • Operating system: Windows XP 32-bit. Setup Steps: Overview Take the following steps in order to setup and run your camera system.
  • Page 16: Step 1. Install And Configure The Frame Grabber, Graphics Card And Gui

    Step 1. Install and configure the frame grabber, graphics card and GUI Install Frame Grabber Install a Full configuration Camera Link frame grabber according to the manufacturer’s description. We recommend the Xcelera-CL PX8 or PX4 frame grabber or equivalent, described in detail on the teledynedalsa.com site here.
  • Page 17: 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. Power +12V to +24V DC Hirose 6-pin Control &...
  • Page 18 Camera Link Base, Medium, and Full 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: https://www.teledynedalsa.com/en/support/documentation/app-notes/ Figure 7. MDR26 Camera Link Connector...
  • Page 19 CC4- inner shield inner shield inner shield inner shield *Exterior Overshield is connected to the shells of the connectors on both ends. Unused pairs should be terminated in 100 ohms at both ends of the cable. Inner shield is connected to signal ground inside camera Full Configuration 8 bits Camera Link Full Configuration Connector 1: Channel link X...
  • Page 20 Camera Link Bit Definitions BASE Configuration Pixel Format Port A Port B Port C Bits 0 thru 7 Bits 0 thru 7 Bits 0 thru 7 Mono 8 Tap 1 LSB..Bit 7 Tap 2 LSB..Bit7 xxxxxxx Pixels (1, 3, 5, ... 8189, Pixels (2, 4, 6, ...
  • Page 21 Camera Link strobe frequency is increased the maximum allowable cable length will decrease. The Piranha4 cameras are capable of driving cables 10 metres or less in length. We do not guarantee good imaging performance with low quality cables of any length. In general, we recommend the use of high quality cables for any cable length.
  • Page 22 Output Signals, Camera Link Clocking Signals These signals indicate when data is valid, allowing you to clock the data from the camera to your acquisition system. These signals are part of the Camera Link configuration and you should refer to the Camera Link Implementation Road Map, available at our Knowledge Center, for the standard location of...
  • Page 23: Step 3. Establish Communication With The Camera

    LEDs The camera is equipped with an LED on the back to display the operational status of the camera. The table below summarizes the operating states of the camera and the corresponding LED states. When more than one condition is active, the LED indicates the condition with the highest priority. Color of Status LED Meaning No power, or hardware malfunction.
  • Page 24 Figure 10. CamExpert GUI showing connected camera Check LED Status If the camera is operating correctly at this point, the diagnostic LED will shine green.
  • Page 25 Software Interface All the camera features can be controlled through the CamExpert interface. For example, under the Camera Control menu in the camera window you can control the line rate and exposure times. Note: the camera uses two CamExpert windows to send commands and display the results. One window controls the camera and the other is used for image acquisition and display.
  • Page 26: Using Sapera Camexpert With Piranha4 Cameras

    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 27 Figure 13. CamExpert’s Image Acquisition Window 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 28 Acquisition control button: Click once to start live grab, click again to stop. Single frame grab: Click to acquire one frame from device. Trigger button: With the I/O control parameters set to Trigger Enabled, click to send a single 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...
  • Page 29: Camera Operation

    4. Camera Operation Factory Settings The camera ships and powers up for the first time with the following factory settings: • Camera Link Full, 8 bit pixels • Internal trigger, line rate 10 kHz • Internal exposure control, exposure time 50 µs •...
  • Page 30: 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 75 °C.
  • Page 31 Either the Factory or one of the User settings can be saved as the Default Setting by selecting the set in the 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.
  • Page 32: 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. Note: By default, the user settings are set to the factory settings.
  • Page 33: Area Mode

    Area Mode Use the area mode in the P4 mono camera to achieve data rates twice as fast as those available using TDI Stage = 1 or TDI Stages = 2. Similar to the actions of TDI Stage = 2 mode, the top and the bottom lines of the sensor are exposed simultaneously.
  • Page 34 Figure 17. Image with proper scan direction...
  • Page 35: Tdi Stages

    TDI Stages You have the option to set the TDI stages as either a single line (1) or as the sum of a pair of lines (2). TDI Stages and Direction Control If the camera’s direction is set to reverse, then the TDI stage is locked to TDI stage 2. While operating in TDI stage 1 the direction control is not available and will be greyed out, the camera must be operating with internal direction control.
  • Page 36 Sensitivity Mode and Pixel Readout The camera has the option to operate in either high sensitivity (dual line) or low sensitivity (single line) modes. When in high sensitivity mode, the camera uses both line scan sensors and as a result the responsivity increases (40%).
  • Page 37: Trigger Modes

    Trigger Modes The camera’s image exposures are initiated by a trigger event. The trigger event is either a programmable internal signal used in free running mode, an external input used for synchronizing exposures to external triggers, or a programmed function call message by the controlling computer. These triggering modes are described below.
  • Page 38: Exposure Modes In Detail

    Trigger Width Uses the width of the current line trigger signal pulse to control the exposure duration. Timed The exposure duration time is set using the Exposure Time feature and the exposure starts with the Line Start event. Exposure Time Sets the exposure time (in microseconds).
  • Page 39 1. External Trigger Off, Internal Exposure Control Free running, not synchronized to an external signal Programmable Line Time >1us Programmable Exposure Programmable Exposure Programmable Exposure Sensor Sensor Sensor Readout Readout Readout LVAL 10.2us 2. External Trigger On, Internal Exposure Control CC1 Falling edge triggers start of internal exposure Line Time >1us...
  • Page 40: Set Line Rate

    7 us h min 1.5 us l min Figure 22. External Trigger Minimum High and Low Times Set Line Rate To help determine your line rate, a Line Rate Calculator is available on the teledynedalsa.com Web site here: https://www.teledynedalsa.com/en/support/calculators/ To set the camera’s line rate use the line rate parameter, part of the Camera Controls set. This feature can only be used when the camera is in Internal mode—that is, when the start line trigger is disabled (Trigger Mode Off).
  • Page 41 This feature is only available when the camera is in Internal Mode—line trigger is disabled (Trigger Mode off). Line Rates Camera Link Configuration Maximum Line Rate Base 20 kHz (Up to 41 kHz with the use of horizontal binning at 2x) Medium 41 kHz Full...
  • Page 42 Number Line Rate Formula (Hz) Clock of AOI Configura Rate tion Medium Max: 70KHz Full Max: 70KHz 85 MHz Base Max: 70KHz Medium Max: 70KHz Full Max: 70KHz Number Line Rate Formula (Hz) Clock of AOI Configurat Rate 42.5 Base Max: 70KHz Medium Max: 70KHz...
  • Page 43 Number Line Rate Formula (Hz) Clock of AOI Configurat Rate Medium Max: 70KHz Full Max: 70KHz 42.5 Base Max: 70KHz Medium Max: 70KHz Full Max: 70KHz 42.5 Base Max: 70KHz Medium Max: 70KHz Full Max: 70KHz...
  • Page 44: Set Exposure Time

    Set Exposure Time To set the camera’s exposure time, use the Exposure Time parameter—a member of the Camera Controls set. This feature is only available when the Exposure Mode parameter is set to Timed. The allowable exposure range is from 7 µs to 3,000 µs, dependent on the value of the internal line rate. GenICam parameters: Camera Controls >...
  • Page 45: Set Baud Rate

    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. Serial Port Control Action Parameter Options Control the baud rate used by the Baud Rate 9600 (factory default) camera’s serial port...
  • Page 46: Camera Direction Control

    Camera Direction Control Found in the Camera Control > Direction Control set of features. Note: This feature is only available when in high sensitivity mode only (TDI stage 2). Note: the Sensor Shift features are not available when the camera is in low or tall pixel sensitivity modes. Camera Control >...
  • Page 47 Sensor Shift Direction Example When in high sensitivity mode, you can select either forward or reverse sensor shift direction. Selectable direction accommodates object direction change on a web and allows you to mount the camera “upside down”. Note that the example here assumes the use of a lens (which inverts the image). Figure 23: Object Movement and Camera Direction Example Using a Lens...
  • Page 48: Pixel Readout Direction (Mirroring Mode)

    Pixel Readout Direction (Mirroring Mode) Set the tap readout from left to right or from right to left. This feature is especially useful if you want to mount the camera “upside down.” Image Format Control Parameter Description ReverseX Off: All pixels are read out from left to right. On: All pixels are read out from right to left.
  • Page 49: Resetting The Camera

    Figure 24: 2x2 Binning in Area Mode Resetting the Camera 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. Transport Layer Parameter Description Camera Reset Resets the camera and puts in the default settings, including a 9600 baud rate.
  • Page 50 Output Video Video Filter Threshold Calibrate Calibrate FPN Offset Gain PRNU flatfieldCalibrationFPN ImageEnhancementStrength Gain (sft) (ccf) flatfieldCorrectionMode BlackLevel (ssg) (ssb) flatfieldCalibrationPRNU flatfieldCorrectionAlgorithm (cpa,ffm) Figure 26: Camera Calibration Process. 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.
  • Page 51 flatfieldCalibrationFPN 1. Save average line (of “flatfieldCalibrationSampleSize” rows). This is the first user correction applied – it is subtracted from each line. 2. This feature may not be of use to many users as the camera already subtracts true “dark current”, but it may be useful for some to provide a per pixel offset correction.
  • Page 52: 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 53 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), verses the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 54 Display Name Feature Description Device Version & View Serial Number DeviceID Displays the device’s factory set camera 1.00 serial number. (RO) Beginner Device User ID DeviceUserID Feature to store user-programmable 1.00 identifier of up to 15 characters. The default Beginner factory setting is the camera serial number.
  • Page 55 Display Name Feature Description Device Version & View UserSet4 UserSet4 Select the User-defined Configuration space UserSet4 to save to or load from features settings previously saved by the user. UserSet5 UserSet5 Select the User-defined Configuration space UserSet5 to save to or load from features settings previously saved by the user.
  • Page 56 Display Name Feature Description Device Version & View Input Voltage deviceInputVoltage Displays the input voltage to the camera at 1.00 the 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...
  • Page 57 Camera Configuration Selection Dialog CamExpert provides a dialog box which combines the features to select the camera power up state and for the user to save or load a camera state from Genie memory. Camera Power-up Configuration The first drop list selects the camera configuration state to load on power-up (see feature UserSetDefaultSelector).
  • Page 58: Camera Control Category

    Camera Control Category The P4 camera controls, as shown by CamExpert, groups sensor specific parameters. This group includes controls for line rate, exposure time, scan direction, and gain. 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.
  • Page 59 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), verses the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 60 Display Name Feature Description Device Version & View Exposure Time exposureTimeSelector Used to select where ExposureTime is applied to. 1.00 Selector Beginner Both lines get equal exposure time DFNC TopLine Allows the top line to have exposure time set Top Line BottomLine Allows the bottom line to have the exposure time Bottom Line...
  • Page 61 Multi-Exposure Mode The multi-exposure mode allows for the simultaneous exposure of each line of the sensor with two different exposure times or gains. The result is an increase in the dynamic range of the image. Turn on the Multi Line Exposure Mode Select which line to...
  • Page 62 Above: image with longer exposure time. Otherwise, identical to the first image. Above: top and bottom images fused.
  • Page 63 Flat-Field Calibration of Image in Multi-Exposure Mode Performing a flat-field calibration in multi-exposure mode results in the camera automatically setting both lines of the sensor to the same integration time. Both lines will be flat-fielded to the target value provided. After the flat-field calibration has completed, the integration and gain values are reset to the lines that they were set to.
  • Page 64 Multi-Exposure Output Format While in multi-exposure mode the width of the output will double. An 8k camera will output a 16k image. The same line is outputted twice with each line a different exposure—the left half of the image being the bottom line and the right half being the top line. Output AOI when in Multi-Exposure Mode The same output AOI will be applied to both the top and bottom lines while in multi-exposure mode.
  • Page 65 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), verses the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 66: 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 67 Display Name Feature Description Device Version & View FPN and flat field coefficients DFNC enabled. Initialize Initialize Reset all FPN to 0 and all flat field coefficients to 1. ScanDirectionControlled ScanDirectionControlled Different user set loaded depending on direction. Select flatfield flatfieldScanDirectionReverseSet When flatfieldCorrectionMode is 1.00...
  • Page 68: 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 69 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), verses the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 70 Horizontal Binning BinningHorizontal Selects between 1x or 2x horizontally 1.00 binned image Beginner DFNC Line Mirroring ReverseX 1.00 Video output in normal order Beginner Video output in a reverse order DFNC Pixel Format PixelFormat Output image pixel coding format of the 1.00 sensor.
  • Page 71: Binning

    Binning Binning is the combining of two or more image sensor pixels to form a new combined pixel. A binned image using the same exposure settings as a non-binned image will show an improved signal-to-noise ratio, reduced scanning times (due to lower spatial resolution) and save as a smaller image file size compared with a non-binned image, at the expense of lower image resolution.
  • Page 72 An example where you would use this feature is in an application that is inspecting several separated lanes of objects with one camera and the image between the lanes can be ignored. The AOI feature allows from one to four specific areas of the pixel line to be specified where image data will be output.
  • 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. Once all AOI are set up change to active.
  • Page 74: Instructions On Using The Camera Scan Direction To Control Camera Parameters

    Instructions on using the camera scan direction to control camera parameters The camera is capable of adjusting camera parameters on-the-fly based on the scan direction of the camera. These parameters include gain, flat field coefficients, white balance and exposure time. 1.
  • Page 75 Save to a user set choice. 4. The next step is to put the camera in the forward direction. This can be done using a forward signal through CC3 and the Direction Source set to external or by having the Direction Source set to Internal and the Internal Direction set to forward.
  • Page 76 Forward direction user set and default user set must be the same. Save to a different user set than the one selected for reverse direction. Set the Flat Field mode to Scan direction Controlled. In the Flat Field area change the mode to Scan Direction Controlled. A Note on External Direction, Direction Source, and User Sets If using external direction control through CC3 ensure that the Direction Source is both set to external and saved in the user set.
  • Page 77: 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 78 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), verses the GenICam Standard Features Naming Convention (SFNC not shown).
  • Page 79: 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 80: Serial Port Control Category

    Genie TS serial port as an interface from an Ethernet network to a serial port control system for other devices. 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 81: File Access Control Category

    P4. The supported data files are for P4 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 82 File Access Control Feature Descriptions Display Name Feature Description View File Selector FileSelector Selects the file to access. The file types which 1.00 are accessible are device-dependent. Beginner FPGA Code Firmware1 Upload new FPGA to the camera which will DFNC execute on the next camera reboot cycle.
  • Page 83 Display Name Feature Description View File Access Length FileAccessLength Controls the mapping length between the 1.00 device file storage and the file access buffer. Guru File Operation Status FileOperationStatus Displays the file operation execution status. 1.00 (RO). Guru Success Success The last file operation has completed successfully.
  • Page 84 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. This menu presents only the applicable data locations for the selected file type. 4.
  • Page 85 5. Hit “Download” Save the text file and send the file to Teledyne DALSA customer support.
  • Page 87: 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 88 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.
  • Page 89 Port Configuration Baud: 9,600 Bits: Parity: None Stop bits: Flow Control: None Echo typed characters locally. Rules • The interface is not case sensitive • One command and argument(s) per line • To enter a floating point number prefix it with a “F” – for example “ssg 0 f1.5” •...
  • Page 90 Disabling Esc Key for Direct Access to ASCII Commands By default the Esc key is enabled and an Esc key sequence has to be issued in order to access the ASCII commands. Using the DEK 1 command the need to issue an Esc key is disabled and access to the ASCII commands are available immediately upon camera boot up.
  • Page 91 Full Name Calibrate Flatfield Mnemonic Argument(s) Algorithm 0. Basic 1. Low-pass Filter • # of lines to average 2048 • 4096 Target 0 to 4095 DN in 12 bit mode 0 to 1023 DN in 10 bit mode 0 to 255 DN in 8 bit mode Description Calibrate user PRNU flat field coefficients •...
  • Page 92 Full Name Flatfield Mode Mnemonic Argument(s) Mode 0. Disable use of user FPN and PRNU flat field correction coefficients 1. Enable use of user FPN and PRNU flat field correction coefficients 2. Reset user FPN coefficients to zero and user PRNU coefficients to one 3.
  • Page 93 USER>gcp Notes Model P4_CM_08K070_00_R Microcode 03-081-20313-00 03-110-20311-00 FPGA 03-056-20485-00 Serial # 12037438 UserID # DALSA BiST: Good DefaultSet 1 Ext Trig Off Line Rate 10000 [Hz] Meas L.R. 10000 [Hz] Max L.R. 19417 [Hz] Exp. Mode Timed Multi Exp. Mode Off Exp.
  • Page 94 Full Name Help Mnemonic Argument(s) Description Display list of three letter commands USER>h Notes P4 (03-081-20313-00): Command Line Interpreter Apr 14 2014, 09:14:03 ccf - Calibrate User FPN <2048|4096> clm - Camera Link Mode <0:Base 1:Med 2:Full 3:Deca> cls - Camera Link Speed <0 - 85MHz, 1 - 42.5MHz> cpa - Calibrate Flatfield <0:basic 1:filter><2048|4096><DN target>...
  • Page 95 Full Name Load Pixel Coefficients Mnemonic Argument(s) Set selector Factory set 1-8. User sets Description Load user set • Notes Loads FPN coefficients and PRNU coefficients from a user set ( only coefficeints, no other camera parameters) Full Name Reset Camera Mnemonic Argument(s) Description...
  • Page 96 Full Name Set AOI Count Mnemonic Argument(s) Number of AOI’s 1 to 4 Description Set AOI Counter Notes Full Name Set AOI Selector Mnemonic Argument(s) Selector 1 to 4 Offset 1 to AOI Count – any pixel can be starting pixel Width No less than 40 pixels Description...
  • Page 97 Full Name Set Binning Vertical Mnemonic Argument(s) 1. Single pixel 2. Binning of 2 pixels Description Set vertical binning • Notes Must be in Single line mode (stg 1) • Must be in Line scan mode (dst 0) Full Name Direction Mnemonic Argument(s)
  • Page 98 Full Name Exposure Time Mnemonic Argument(s) Exposure time 4, 000 to 3, 000, 000 [ns] Description Set internal exposure time in nanoseconds – 25 ns resolution • Notes Line time > ( Exposure time + 1,500 ns ) Full Name Set Multi-Exposure (2K only) Mnemonic Argument(s)
  • Page 99 Full Name Pixel Format Mnemonic Argument(s) Selector 0. 8 bits 1. 10 bits 2. 12 bits (only available with Base or Medium Camera Link configurations) Description Set pixel format Notes Full Name Offset Mnemonic Argument(s) Offset 8 bit -32 to 31 10-bit -128 to 127 12-bit...
  • Page 100 Full Name Set TDI Stages Mnemonic Argument(s) Selector TDI stage 1. Single line mode (lower sensitivity). 2. TDI mode (higher sensitivity) Description • Notes In single line mode the camera must be internal direction control • TDI mode: a pair of lines summed with suitable delay Full Name External Trigger Mnemonic...
  • Page 101 Full Name Load User Set Mnemonic Argument(s) Set selector Factory set 1-8. User sets Description Load user set • Notes Loads and makes current all the settings listed by the GCP command plus the user FPN coefficients, and user PRNU coefficients Full Name Save User Set Mnemonic...
  • Page 102: Appendix C: Error And Warning Messages

    Appendix C: 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 103 Operational Error Codes Code Description 0X8002 Invalid Parameter 0xC01C CPA_TOO_MANY_OUTLIERS 0x401E USER_FPN_CLIPPING 0x401F FLAT_FIELD_CLIPPING...
  • Page 104: Appendix D: Quick Setup And Image Acquisition

    Teledyne DALSA website, https://www.teledynedalsa.com/en/support/downloads- center/software-development-kits/, or contact your local customer support representative. • 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™, refer to Appendix •...
  • Page 105 • Enter ‘h’ at any time to get the list of commands from the camera. • Enter the ‘gcp’ command at any time to get the current setup conditions of the camera. 3. Setting Up Your Optical Configuration Typically, the first thing you want to do is to evaluate the camera’s image quality under operating conditions similar to those that you are likely to use in your application.
  • Page 106 Use a white material that has no texture, such as a non glossy plastic. If you must use white paper, make sure it is moving during the calibration process. If you do not do this, your image will have vertical stripes. Another way to prevent the vertical stripes is to slightly defocus the lens while the calibration is performing and then to refocus the lens once it has finished.
  • Page 107: 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 108: Revision History

    Revision History Revision Change Description Date Initial release. 16 March 2012 -Revised list of GenICam commands added. 27 June 2012 -Calibration process diagram added. -Revised responsivity graph added. -Control and Data Interface description in specifications table revised: 2 03 July 2013 Camera Link MDR26 connectors [used] for transmitting Base, Medium, or Full configurations.
  • Page 109: 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...

This manual is also suitable for:

P4-cm-8k070-00-r

Table of Contents