Teledyne Piranha4 User 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

2 Piranha4 RGB + NIR / Mono Camera User's Manual
This document does not contain information whose export/transfer/disclosure
is restricted by the Canadian Export Control regulation.
Notice
© 2015-2021 Teledyne Digital Imaging, Inc.
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.
Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States and
other countries. Windows, Windows 7, Windows 8 and Windows 10 are trademarks of Microsoft
Corporation.
All other trademarks or intellectual property mentioned herein belong to their respective owners.
Document date: October 1, 2021
Document number: 03-032-20217-02
About Teledyne DALSA
Teledyne DALSA, a business unit of Teledyne Digital Imaging Inc., is an international high-performance
semiconductor and electronics company that designs, develops, manufactures, and markets digital
imaging products and solutions, in addition to providing wafer foundry services.
Teledyne DALSA Digital Imaging offers the widest range of machine vision components in the world.
From industry-leading image sensors through powerful and sophisticated cameras, frame grabbers,
vision processors and software to easy-to-use vision appliances and custom vision modules.

Piranha4 RGB + NIR / Mono Camera User's Manual 3
Teledyne DALSA 03-032-20217-02
Contents
Camera User’s Manual _________________________________________________________________________________ 1
System Precautions ....................................................................................................................................6
Precautions..................................................................................................................................6
Electrostatic Discharge and the CMOS Sensor........................................................................6
1. The Piranha4 RGB + NIR / Monochrome Camera ___________________________________________________________ 7
Camera Highlights.......................................................................................................................................7
Camera Performance Specifications .........................................................................................................8
Certifications................................................................................................................................10
Flash Memory Size.....................................................................................................................10
Supported Industry Standards....................................................................................................................10
Sensor Responsivity and Design ...............................................................................................................11
Responsivity................................................................................................................................11
Spatial Correction and Quadlinear Sensor Design ..................................................................13
Parallax Correction .....................................................................................................................16
Camera Direction........................................................................................................................17
Mechanicals.................................................................................................................................................18
Camera Mounting and Heat Sink Considerations ....................................................................19
2. Quick, Simple Steps to Acquire an Image _________________________________________________________________ 20
3. Software and Hardware Setup __________________________________________________________________________ 21
Recommended System Requirements .....................................................................................21
Setup Steps: Overview................................................................................................................................21
1. Install and Configure Frame Grabber and Software ............................................................21
2. Connect Camera Link and Power Cables.............................................................................21
3. Establish communicating with the camera............................................................................21
4. Operate the Camera...............................................................................................................21
Step 1. Install and configure the frame grabber and software................................................................22
Install Frame Grabber.................................................................................................................22
Install Sapera LT and CamExpert GUI......................................................................................22
Step 2. Connect Data, Trigger, and Power Cables...................................................................................23
Data Connector: Camera Link ...................................................................................................24
Camera Link Bit Definitions........................................................................................................25
Camera Timing ............................................................................................................................................25
Camera Link cable quality and length.......................................................................................34
Input Signals, Camera Link........................................................................................................34
Output Signals, Camera Link Clocking Signals........................................................................35
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

4 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
CamExpert Panes.......................................................................................................................39
Review a Test Image..................................................................................................................41
4. Camera Operation___________________________________________________________________________________ 42
Factory Settings...........................................................................................................................................42
Check Camera and Sensor Information ....................................................................................................42
Verify Temperature and Voltage ................................................................................................................43
Saving and Restoring Camera Settings.....................................................................................................44
Camera Link Configuration.........................................................................................................................46
Trigger Modes..............................................................................................................................................46
Exposure Controls.......................................................................................................................................47
Exposure Modes in Detail...........................................................................................................................48
Color Exposure Time Guidelines...............................................................................................50
Set Line Rate ...............................................................................................................................................50
Set Exposure Time......................................................................................................................................51
Control Gain and Black Level.....................................................................................................................51
Set Image Size.............................................................................................................................................52
Set Baud Rate..............................................................................................................................................52
Pixel Format.................................................................................................................................................53
Camera Direction Control ...........................................................................................................................53
Pixel Readout Direction (Mirroring Mode) .................................................................................................53
Resetting the Camera .................................................................................................................................53
Calibrating the Camera...............................................................................................................................54
Appendix A: GenICam Commands ________________________________________________________________________ 59
Camera Information Category ....................................................................................................................59
Camera Information Feature Descriptions................................................................................60
Camera Configuration Selection Dialog....................................................................................63
Camera Power-up Configuration...............................................................................................63
User Set Configuration Management........................................................................................63
Camera Control Category...........................................................................................................................64
Camera Control Feature Descriptions.......................................................................................65
Independent Exposure Control...................................................................................................................68
Digital I/O Control Feature Descriptions....................................................................................70
Flat Field Category ......................................................................................................................................71
Flat Field Control Feature Description.......................................................................................72
Region of Interest (ROI) .............................................................................................................73
Image Format Control Category.................................................................................................................74
Image Format Control Feature Description ..............................................................................75
Area of Interest (AOI) Setup .......................................................................................................................76
Instructions on using the camera scan direction to control camera parameters ....................................79
Transport Layer Control Category..............................................................................................................82
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

Piranha4 RGB + NIR / Mono Camera User's Manual 5
Teledyne DALSA 03-032-20217-02
File Access via the CamExpert Tool .........................................................................................91
Download a List of Camera Parameters...................................................................................91
Appendix B: ASCII Commands ___________________________________________________________________________ 94
Port Configuration.......................................................................................................................96
Commands ..................................................................................................................................97
Appendix C: Quick Setup and Image Acquisition ______________________________________________________________ 110
Appendix D: The Sensor Window _________________________________________________________________________ 113
Cleaning and Protecting Against Dust, Oil, and Scratches .....................................................113
Cleaning the Sensor Window.....................................................................................................114
Appendix E: Camera, Frame Grabber Communication _________________________________________________________ 115
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

6 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
System Precautions
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 relevant 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 65 °C during operation.
Do not operate the camera in the vicinity of strong electromagnetic fields. In addition, avoid electrostatic
charging, violent vibration, and excess moisture.
To clean the device, avoid electrostatic charging by using a dry, clean absorbent cotton cloth dampened
with a small quantity of pure alcohol. Do not use methylated alcohol. To clean the surface of the camera
housing, use a soft, dry cloth. To remove severe stains use a soft cloth dampened with a small quantity of
neutral detergent and then wipe dry. Do not use volatile solvents such as benzene and thinners, as they
can damage the surface finish. Further cleaning instructions are below.
Though this camera supports hot plugging, it is recommended that you power down and disconnect
power to the camera before you add or replace system components.
Electrostatic Discharge and the CMOS Sensor
Image sensors and the camera bodies housing are susceptible to damage from electrostatic discharge
(ESD). Electrostatic charge introduced to the sensor window surface can induce charge buildup on the
underside of the window that cannot be readily dissipated by the dry nitrogen gas in the sensor package
cavity. 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.

Piranha4 RGB + NIR / Mono Camera User's Manual 7
Teledyne DALSA 03-032-20217-02
1. The Piranha4 RGB + NIR /
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. New features include multiple
regions of interest for data reduction and regional calibration, sub-pixel spatial correction,
white balance and color calibration tools.
Key Features
•High speed: up to 70 kHz line rates
•Three native colors (RGB) plus NIR / Mono per pixel
•Spectrally Independent RGB + NIR outputs
•Bi-directional
•Compact camera body
•Sub-pixel spatial correction
•Horizontal Parallax Correction
Programmability
•Multiple Regions of Interest for calibration and data reduction
•8, 10, or 12 bit output
•Flat field and lens shading
•correction
•8 programmable coefficient sets
•GenICam or ASCII compliant interfacing
Applications
•100% print inspection (pharmaceuticals, bank note)
•Electronics inspection
•Materials grading systems
•Web inspection
•High performance color sorting systems
•Food inspection
•General purpose machine vision

8 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
Models
The camera is available in the following configurations:
Table 1: Camera Models Overview
Model Number
Description
P4-CC-02K07Q-00-R
2k resolution, 70 kHz line rate, 14.08 µm x 14.08 µm pixel size, RGB + Mono
P4-CC-02K07N-01-R
2k resolution, 70 kHz line rate, 14.08 µm x 14.08 µm pixel size, RGB + NIR
Table 2: Software
Software
Product Number / Version Number
Camera firmware
Embedded within camera
GenICam™ support (XML camera description file)
Embedded within camera
Sapera LT, including CamExpert GUI application and
GenICam for Camera Link imaging driver
Version 7.2 or later
Camera Performance Specifications
Table 3: Camera Performance Specifications
Specifications
Performance
Imager Format
CMOS quadlinear: color (RGB) plus NIR / Mono CMOS line scan
Resolution
2048 x 4 pixels
Pixel Size
14.08 µm x 14.08 µm
Line Rate
0 kHz minimum to 70 kHz maximum
Exposure Time
7 µs minimum to 3,000 µs maximum
Bit Depth
8, 10, and 12 bits, selectable
Connectors and Mechanicals
Control & Data Interface
2 SDR-26 mini Camera Link connectors used to transmit Base, Medium, Full,
or Deca configurations
Power Connector
Hirose 6-pin circular
Power Supply
+ 12 V to + 24 V DC
Power Dissipation
8 W
Size
62 mm (W) x 62 mm (H) x 48 mm (D)
Mass
< 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)

Piranha4 RGB + NIR / Mono Camera User's Manual 9
Teledyne DALSA 03-032-20217-02
Flatness
y (parallelism)
x
y
z
z
50 µm
0.08° or 81 µm
± 100 µm
± 100 µm
± 250 µm
± 0.2°
Compliance
Regulatory Compliance
CE, FCC and RoHS, GenICam
Table 4: P4-CC-02K07Q-00-R Operating Specifications
Operating Ranges
Performance
Red
Green
Blue
Mono
Dynamic Range
61.8 dB
61.8 dB
61.8 dB
61.8 dB
Random Noise
3.36 DN** rms
3.36 DN rms
3.36 DN rms
3.36 DN rms
Responsivity
Refer to graph
Gain
1x to 10x Nominal Range (not including individual RGB gains for white balance)
DC Offset
< 11 DN
< 11 DN
< 11 DN
< 11 DN
PRNU
< 2% @50% Sat
< 2% @50% Sat
< 2% @50% Sat
< 2% @50% Sat
FPN
< 6.3 DN
< 6.3 DN
< 6.3 DN
< 6.3 DN
SEE
3.96 nJ / cm2
4.39nJ / cm2
6.80 nJ / cm2
3.64 nJ / cm2
NEE
3.2 pJ / cm2
3.6 pJ / cm2
5.6 pJ / cm2
3.0 pJ / cm2
Antiblooming
> 100 x Saturation
Integral non-
linearity
< 2% DN
**DN = digital number
Test Conditions:
•Values measured using 12-bit, 1x gain.
•10 kHz line rate
•Light source: white LED
•No white balancing
•Front plate temperature: 45º C
Table 5: P4-CC-02K07N-01-R Operating Specifications
Operating Ranges
Performance
Red
Green
Blue
NIR
Dynamic Range
61 dB
61 dB
61 dB
61 dB
Random Noise
3.52 DN** rms
3.00 DN rms
2.50 DN rms
3.52 DN rms
Responsivity
Refer to graph
Gain
1x to 10x Nominal Range (not including individual RGB gains for white balance)
DC Offset
< 11 DN
< 11 DN
< 11 DN
< 11 DN
PRNU
< 2% @50% Sat
< 2% @50% Sat
< 2% @50% Sat
< 2% @50% Sat
FPN
< 4.7 DN
< 4.7 DN
< 4.7 DN
< 5.7 DN
SEE
4.76 nJ / cm2
5.1nJ / cm2
6.07 nJ / cm2
8.3 nJ / cm2
NEE
4.2 pJ / cm2
3.9 pJ / cm2
3.8 pJ / cm2
2.1 pJ / cm2

10 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
Antiblooming
> 100 x Saturation
Integral non-
linearity
< 2% DN
**DN = digital number
Test Conditions:
•Values measured using 12-bit, 1x gain.
•10 kHz line rate
•Light source: white LED
•No white balancing
•Front plate temperature: 45º C
Certifications
Compliance
EN 55011, FCC Part 15, CISPR 11, and ICES-003 Class A Radiated Emissions Requirements
EN 55024, and EN 61326-1 Immunity to Disturbance*
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)
Flash Memory Size
Camera
Flash Memory Size
P4-CC-02K07Q-00-R
16 MByte
P4-CC-02K07N-01-R
16 MByte
Supported Industry Standards
GenICam™
Piranha4 cameras are GenICam compliant. They implement a superset of the GenICam™ Standard
Features Naming Convention specification V1.5. 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.

Piranha4 RGB + NIR / Mono Camera User's Manual 11
Teledyne DALSA 03-032-20217-02
Sensor Responsivity and Design
Responsivity
The responsivity graph illustrates the sensor’s response to different wavelengths of light (excluding lens
and light source characteristics).
Figure 1: Spectral Responsivity (NIR)
0
100
200
300
400
500
600
700
800
900
300 400 500 600 700 800 900 1000 1100
Responsivity (DN/ɳJ/cm2)
Wavelength (ɳm)
Piranha4 2K Quad NIR Spectral Responsivity
(12Bit)
Red
Green
Blue
NIR

12 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
0
200
400
600
800
1000
1200
350 450 550 650 750 850 950
Spectral Responsivity (DN/nJ/cm^2)
Wavelength (nm)
P4 2K Quad Linear Color Spectral Responsivity
No White Balance, 12 bit, gain 1x
Red
Green
Blue
Mono
Figure 2: Spectral Responsivity (Monochrome)
0%
10%
20%
30%
40%
50%
60%
70%
80%
350 450 550 650 750 850 950 1050
QE %
Wavelength (nm)
QE vs Wavelength 2K Quad
Red
Green
Blue
Mono
Figure 3: QE vs. Wavelength

Piranha4 RGB + NIR / Mono Camera User's Manual 13
Teledyne DALSA 03-032-20217-02
Spatial Correction and Quadlinear Sensor Design
The P4-CC-02K07Q-00-R camera uses a quadlinear sensor where four separate 2K lines of pixels are
used—one for red, one for blue, one for green, and the last for monochrome / NIR.
Figure 4: 2K Quadlinear Sensor Line Spacing Diagram
In the case of the 2k cameras, only a single line of space separates the colored lines—with the exception of
the monochrome line, which has three lines of spacing.
When the image passes the three lines of pixels, the red, blue and green components for the same image
location are captured at a different time as dictated by the line spacing. The camera automatically corrects
for the line spacing to ensure that the red, blue and green components of the image pixel are all aligned
when output. However, this is only correct when the object pixel size is square; i.e., the distance moved
by the object for one EXSYNC period is equal to the width of the object pixel. In some applications it may
not be possible to achieve a ‘square’ object pixel as fine adjustment of the lens magnification and/or the
distance moved for each EXSYNC period is not possible. This scenario may be especially apparent when
trying to integrate the camera into an existing system.
When it is not possible to generate a square object pixel, color artefacts will occur in the scan direction
and is particularly noticeable at sharp edge transitions. The size of the edge artefact is proportional to
how far the pixel is from square. To correct for this, the camera has a feature, Line Spatial Correction (or
three letter command ssa), which allows fine adjustment of the compensation mechanism the camera uses
to correct for the line spacing.
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.
14.08um
14.08um
Red
Blue
Green
14.08um
14.08um
14.08um
Mono
14.08um
42.24um

14 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
The following examples of image artefacts show black to white image transitions and the associated
corrected image after applying a specific line spatial correction (ssa) setting.
Example 1. Target speed adjusted for square pixels
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)

Piranha4 RGB + NIR / Mono Camera User's Manual 15
Teledyne DALSA 03-032-20217-02
Example 3. Target running faster than example 1, same EXSYNC (trigger) frequency
Line Spatial Correction = 3 (ssa = 3) Line Spatial Correction = 1.73 (ssa = 1.73)
Example 4. Target running slower than EXSYNC
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)

16 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
Parallax Correction
When the camera it is not perpendicular to the object surface the P4 color camera will exhibit color. The
parallax distortion increases when imaging at steep angles relative to the cameras imaging plain. This is
an optical effect caused by the line spacing of the three individual colors. This spacing results in a
different magnification for each line at high angles. As shown in the figure below, there is color distortion
at the extremes ends of the image but at the centre of the image the color distortion does not show up.
4096 pixels
Figure 5: Image with Horizontal Color Alignment Issues
Using the P4 color cameras Parallax Correction feature, the optical magnification for each line is adjusted
such that colors can be lined up at the extreme ends of the image without affecting the center. Using the
feature Image Distortion Correction Mode (shm = 1) this feature can be turned on. Using the feature
Image Distortion Correction Line Selector the user can select red and green to correct the distortion. Note.
The red and green lines are adjusted to to align with the center blue line. Image Distortion Parallax
Correction Pixel Stretch (sha - Set horizontal alignment in float f<value 0-3>) is used to add the amount of
correction needed to the image. The value entered here must be between 0 and 3 (decimal values are
accepted.
Figure 6: CamExpert Parallax Correction Controls
4096 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.
2048 pixels
2048 pixels

Piranha4 RGB + NIR / Mono Camera User's Manual 17
Teledyne DALSA 03-032-20217-02
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

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

Piranha4 RGB + NIR / Mono Camera User's Manual 19
Teledyne DALSA 03-032-20217-02
Figure 11: Piranha4 Heat Sink Accessories Kit
Optional Lens Mount and Heat Sink Accessories
Description
Description
M42 to F-mount adapter
AC-LA-00115-A0-R
M42 to C-mount adapter
AC-LC-00001-00-R
Heat sink
AC-MS-00108-01-R
Camera Mounting and Heat Sink Considerations
Up to two optional heat sinks can be installed on the camera. As illustrated, they are 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.
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.
Repositioning or removal of the heat sinks must be performed with care in order to avoid temperature
issues. The camera has the ability to measure its internal temperature. Use this feature to record the
internal temperature of the camera when it is mounted in your system and operating under the worst
case conditions. The camera will stop outputting data if its internal temperature reaches 80 °C.

20 Piranha4 RGB + NIR / Mono Camera User's Manual
03-032-20217-02 Teledyne DALSA
2. 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.