Dalsa Piranha4, P4-CM-02K05D-00-R, P4-CM-04K05D-00-R, P4-CM-04K10D-00-R, P4-CM-02K10D-00-R User Manual

Piranha4
Camera User’s Manual
Monochrome 2K and 4K
cameras
| frame grabbers | processors | software | vision solutions
03-032-20176-06
www.teledynedalsa.com
2 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
N otice © 2018 Teledyne DALSA
All info rm atio n provided in t his manual is believed to be a ccurate a n d reliable. No responsibility is assumed by Teledyne DA LSA for its use. Teledyne DA LSA reserves the right to make changes to this information without notice. Reproduction of t h is manual in whole or in p art, by any means, is p rohib ited without p r ior permission h aving been obtained from Teledyne DA LSA.
Microsoft and Windows a re registered trademarks of Microsoft Corporation in the United States a nd other countries. Windows, Windows 7 , Windows 8 are trademarks of Microsoft Corporation.
All othe r t rademarks or in tellectual property mentioned herein belong to their respective ow ners. Document Date: 15 August 2018
Document Number: 03-032-20176-06
About Teledyne DALSA
Tele dyne DALSA is an international high pe rforma nce se mic onduc tor a nd Electronics Company that designs, develops, manufactures, and markets digital imaging products and solutions, i n addition to providing wa fer foundry servic es.
Teledyn e DALSA Dig it al Imaging offe rs the widest rang e of machine vision components in the world. From in d ustry-leading image sensors through powerful and sophisticated cameras, frame grabbers, vision processors and softw are to easy-to-use vision appliances and custom vision modules.
Contac t Tele dyne DALSA
Teledyne DA LS A is headquartered in Waterloo, Ontario, Canada. We have sales offices in the USA, Europe and A sia, plus a w orldw ide network of representatives and agents to serve you efficiently. Co nta ct information for sales a nd support inquirie s, plus links to maps and dire ctions to our offic es, ca n be found here:
Sales Offices: http:/ / ww w.teledynedalsa.com/ corp/ contact/ offices/ Technic al Support: http:/ / www.teledynedalsa.com/ imaging/ support/
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 3
Contents
1. System Precautions and Cleaning _________________________________________________________________________ 6
Precautions ................................................................................................. 6
Electrostatic Discharge and the CMOS Sensor .......................................... 6
2. The Piranha4 Camera __________________________________________________________________________________ 7
Camera Highlights ................................................................................................... 7
Camera Performance Specifications ....................................................................... 8
Flash Memory Size .................................................................................................. 9
Environmental Considerations ................................................................................. 9
Certifications and Compliance ................................................................................. 10
Supported Industry Standards ................................................................................. 10
Responsivity ............................................................................................................. 10
Mechanicals ............................................................................................................. 12
Camera Mounting and Heat Sink Considerations....................................... 14
3. Quick, Simple Steps to Acquire an Image ___________________________________________________________________ 15
4. Software and Hardware Setup ____________________________________________________________________________ 16
Recommended System Requirements ....................................................... 16
Setup Steps: Overview ............................................................................................ 16
1. Install and Configure Frame Grabber and Software ............................... 16
2. Connect Camera Link and Power Cables ............................................... 16
3. Establish Communicating with the Camera ............................................ 16
4. Operate the Camera ............................................................................... 16
Step 1. Install and Configure the Frame Grabber and Software ............................. 17
Install Frame Grabber ................................................................................. 17
Install Sapera LT and CamExpert GUI ....................................................... 17
Step 2. Connect Data, Trigger, and Power Cables.................................................. 18
Data Connector: Camera Link .................................................................... 19
Camera Link Bit Definitions ......................................................................... 21
Camera Link Drive Capability ..................................................................... 22
Input Signals, Camera Link ......................................................................... 22
Output Signals, Camera Link Clocking Signals .......................................... 23
Power Connector ........................................................................................ 23
LEDs ........................................................................................................... 24
Step 3. Establish Communication with the Camera ................................................. 24
Power on the camera .................................................................................. 24
Connect to the frame grabber ..................................................................... 24
Connect to the camera ................................................................................ 25
Check LED Status ....................................................................................... 25
Software Interface ....................................................................................... 25
Using Sapera CamExpert with Piranha4 Cameras .................................................. 26
CamExpert Panes ....................................................................................... 27
4. Camera Operation _____________________________________________________________________________________ 29
Factory Settings ....................................................................................................... 29
Area Mode ................................................................................................................ 29
Teledyne DALSA 03-032-20176-06
4 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Check Camera and Sensor Information .................................................................. 31
Verify Temperature and Voltage .............................................................................. 31
Saving and Restoring Camera Settings ................................................................... 32
Camera Link Configuration ...................................................................................... 34
TDI and Single Line Modes ...................................................................................... 34
Sensitivity Modes and Pixel Readout ......................................................... 35
Trigger Modes .......................................................................................................... 36
Exposure Controls ................................................................................................... 36
Exposure Modes in Detail ........................................................................................ 37
Set Line Rate ........................................................................................................... 39
Set Exposure Time .................................................................................................. 42
Control Gain and Black Level .................................................................................. 42
Set Image Size ......................................................................................................... 43
Set Baud Rate .......................................................................................................... 43
Pixel Format ............................................................................................................. 44
Camera Direction Control ........................................................................................ 44
Camera Direction ........................................................................................ 45
Pixel Readout Direction (Mirroring Mode) ................................................................ 45
Resetting the Camera .............................................................................................. 46
Calibrating the Camera ............................................................................................ 46
Appendix A: GenICam Commands __________________________________________________________________________ 50
Camera Information Category .................................................................................. 50
Camera Information Feature Descriptions .................................................. 51
Camera Configuration Selection Dialog ...................................................... 54
Camera Power-up Config urat ion ................................................................ 54
User Set Configuration Management ......................................................... 54
Camera Control Category ........................................................................................ 55
Camera Control Feature Descriptions ........................................................ 56
Multi-Exposure Mode .................................................................................. 58
Digital I/O Control Feature Descriptions ..................................................... 62
Flat Field Category ................................................................................................... 63
Flat Field Control Feature Description ........................................................ 64
Region of Interest (ROI) .............................................................................. 65
Image Format Control Category .............................................................................. 66
Image Format Control Feature Description ................................................ 67
Binning ..................................................................................................................... 68
Area of Interest (AOI) Setup .................................................................................... 69
Instructions on Using the Camera Scan Direction to Control Camera
Parameters.................................................................................................. 72
Transport Layer Control Category ........................................................................... 75
Transport Layer Feature Descriptions ........................................................ 76
Acquisition and Transfer Control Category .............................................................. 76
Acquisition and Transfer Control Feature Descriptions .............................. 77
Serial Port Control Category .................................................................................... 78
Serial Port Control Feature Descriptions .................................................... 78
File Access Control Category .................................................................................. 79
File Access Control Feature Descriptions ................................................... 80
File Access via the CamExpert Tool ........................................................... 81
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 5
Download a List of Camera Parameters ..................................................... 82
Appendix B: ASCII Commands _____________________________________________________________________________ 84
Port Configuration ....................................................................................... 85
Disabling the Esc Key for Direct Access to ASCII Commands ................... 86
Commands .................................................................................................. 86
Appendix C: Error and Warning Messages ____________________________________________________________________ 98 Appendix D: Quick Setup and Image Acquisition _______________________________________________________________ 100 Appendix E: The Sensor Window ___________________________________________________________________________ 103
Cleaning and Protecting Against Dust, Oil, and Scratches ........................ 103
Cleaning the Sensor Window...................................................................... 104
Appendix F: Camera, Frame Grabber Communication ___________________________________________________________ 105
Setting Up Communication between the Camera and the Frame Grabber 105
EMC Declaration of Conformity _____________________________________________________________________________ 108 Revision History _________________________________________________________________________________________ 109 Index _________________________________________________________________________________________________ 110
Teledyne DALSA 03-032-20176-06
6 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera

1. System Precautions and Cleaning

Precautions

Read these precautions and this manual careful ly before using the camera. Confirm that the camera’s packaging is undamaged before opening it. If the packaging i s damaged please
contact the related logistics personnel. Do not open the housing of the c amera. The warranty is voided if the housing is opened. Keep the camera’s front plate 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 vib ration, 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 volati le solvents such as benzene and thinners, as they can damage the surface finish. Further cleaning in struc t ions are below.
Though this camera supports hot plugging, it is recommended that you powe r down and disconnect pow er to the camera before you add or replace system components.

Electrostatic Disc harge an d the CMOS Sensor

Image sensors and the came ra bodie s hous ing are susceptible to damage from electrostatic di scharge (ESD). Electrosta tic charge introduc ed to the se nsor window surface can induce charge buildup on the underside of the window . The charge normally dissipates within 24 hours and the sensor returns to normal operat ion.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 7

2. The Piranha4 Camera

Camera Highlights

Teledyne DA LS A expands its Piranha4™ dual line CMOS ca mera family with 2K and 4K resolution models. The new Piranha4 models offer higher speeds and more responsive pixels in a choice of sizes and res olutions . Program mable features in clude multiple region-of-interest, high dynamic range operation, and rapid bi-direct ional switching , and are de sign ed to mee t today’s de m and in g imaging applications.

Key Features

High spee d: up to 100 kHz in TDI mode and up to 200 kHz in A rea mode
C ombin ation of va r ious pixel sizes a nd re solutions
Bi-directional
Compact camera body

Programmability

Multiple Regions of Interest for calibration and data reduction
8, 10, and 1 2 bit o utput
Fla t f ield and lens shading correction
8 programmable coefficient sets
G enICam o r ASCII compliant interfacing

Applications

Automated optic al inspection
Transportation safety and security systems
High performance sorting systems
Ma t erials grading and in spect ion systems
Web inspection
Gene ral purp ose machin e vision
Teledyne DALSA 03-032-20176-06
8 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
P4-CM-02K05D-00-R
2048 x 2 pixels
50 kH z (100 kHz)
10.56 µm x 10.56 µm
P4-CM-04K05D-00-R
4096 x 2 pixels
50 kH z (100 kHz)
10.56 µm x 10.56 µm
Camera firmw are
Embedded within camera
GenICam™ support (XM L camera description file)
Embedded within camera
Sapera LT, including C amE x pert GUI applic ation and GenICam for Camera Link imaging driver
Version 7.20 or later
Resolution
2048 x 2 pixels and 4096 x 2
Line Rate
Up to 100 kHz in TDI mode (200 kHz area mode)
B it Depth
8, 10, and 12 bit, selectable
Control & Data Interface
Base, Medium, Full, and Deca Camera Link configurations (2 x SD R-26)
Power Supply
+ 12 V to + 24 V DC ± 5%
Mass
< 340 g
S ensor to Camera Front Distance
12 mm

Models

The camera is available in the following configurations:
Table 1: Camera Models Comparison
Piranha4 Dual Line Model Comparison
Part Number Resolution Maximum Line Rates
TDI Mode (Area Mode)
P4-CM-02K10D-00-R 2048 x 2 pixels 100 kHz (200 kH z) 10.56 µm x 10.56 µm
P4-CM-04K10D-00-R 4096 x 2 pixels 100 kHz (200 kHz) 10.56 µm x 10.56 µm
Table 2: Software
Software
Product Number / Version Number
Pixel Size

Camera Performance Specifications

Table 3: Camera Performance Specifications
Specifications Performance
Imager Format High speed CMOS dual line scan
Pixel Siz e 10.56 µm x 10.56 µm Pixel Fill Fact or 100 %
E x posure Time 4 µs to 3 ms
Connectors and Mechanicals
Power Connector Hirose 6-pin male circular
Power Dissipation < 11 W (4K), < 8.3 W (2K) Si ze 62 mm ( W) x 62 mm (H) x 48 mm (D)
Operating Temp 0 °C to 65 ° C, front plate te mperature
Optical Interface
Le ns Mount M42 x 1 (2k) and M58 x 0.75 (4k), F-mount adapter available
Sensor Alignment (aligned to sides of camera)
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 9
Broadband Re sponsivity
430 DN/(nJ/cm2)
677 DN/(nJ/cm2)
DC Offset
7 DN
14 DN
FFC enabl ed
SEE
9.52 n J / cm2
6.05 n J / cm2
Antiblooming
> 100 x Satur ation
> 100 x Satur ation
P4-CM-02K05D-00-R
16 MByte
P4-CM-02K10D-00-R
16 MByte
P4-CM-04K05D-00-R
16 MByte
Storag e te m p erat u re range
-20 °C to +80 °C
Humidity (storage and operation)
15% to 85% relative, non-condensing
MTBF (mean time betw een failures)
> 100,000 hours, typical field operation
Θ y (pa r allelism) x y z Θ z
0.08° or 100 µm ± 100 µm ± 100 µm ± 250 µm ± 0.2°
Compliance
Re gulatory Comp liance CE, FCC, and RoH S; GenICam
Operating Ranges Performance Notes
Single Line Dual Line
Dynamic Range 61.5 dB 60 dB
Random Noise 3.42 DN* rms 4.16 DN rms FFC enabled
Gain 1x to 10x N ominal range 1x to 10x Nominal range
PRNU < 1% @ 50% S at < 1% @ 50% Sat FPN < 8 DN < 8 DN
NEE 7.95 p J / cm2 6.14 p J / cm2
Integra l non-linearity 1.5 % DN 2.5 % DN
* D N = digital numbe r Test Conditions:
Values measured using 12-bit, 1x gain.
10 kHz lin e rate
Light source: broadband, quartz haloge n, 32 50 K with 700 nm IR cut-off filter.
Fron t plate tempera t ure: 45 º C

Flash Memory Size

Camera Flash Memory Size
P4-CM-04K10D-00-R 16 MByte

Environmental Considerations

Environmental Specifications Performance
Teledyne DALSA 03-032-20176-06
10 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
V1.5, Cam era L ink Seria l Com m u n icatio n: GenICa m ™ Generic Control Protocol (GenCP V1. 0)

Certifications and Compliance

Compliance
EN 55011, FCC Part 15, CIS PR 11, and ICES-003 Class A Radiated Emissions Requirements EN 55024 and EN 61326-1 Immunity to Disturbanc e
RoHS per EU Directive 2011/ 65/ EC and WEEE per EU Directive 2002/ 96/ EC and China Electronic Industry S tandard SJ/ T11364-2006
G enIC am XML Desc rip t ion File, Superset of the GenICam™ Standard Features Nami ng Convention specification

Supported Industry Standards

GenICam™

Piranha4 cameras are GenICam compliant. They implement a superset of the GenICam™ S tandard 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 G enICam™ G eneric Co ntrol Protocol (GenCP V1.0) to communicate over the Camera Link serial port.
For more information see ww w.genicam.org.

Responsivity

The responsivity graph describes the sensor response to different w avelengths of light (excluding lens a nd light s o urc e characteristics).
Figure 1: Spectral Responsivity vs. Wavelength (Dual Line)
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 11
Figure 2: QE % vs. Wavelength
Figure 3: Relationship between FPN and Temperature
Teledyne DALSA 03-032-20176-06
12 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
NOTES:
1. UNITS: MILLIMETERS.
2. IMAGE AREA IS ALIGNED TO DATUMS A B & C .
(11.4)
(20.34)
(
1
9
.
1
)
(
9
)
(
9
)
(42)
(
7
)
(
4
7
.
8
7
)
M4x0.7 - 6H Z 6 (2X) THIS SIDE (2X) FAR SIDE
(54)
62B0.05
6
2
B
0
.
0
5
M4x0.7 - 6H Z 6 (4X)
(
5
4
)
FIRST PIXEL REFERENCE HOLES
M42x1 - 6H
(
4
2
)
(7)
M4x0.7 - 6H Z 6 (2X) THIS SIDE (2X) FAR SIDE
A
B
C
31
B0.10
3
1
B
0
.
1
0
CENTER OF IMAGE AREA
±0.2°
12B0.25 OPTICAL DISTANCE
H
0.1 A
E 0.05
IMAGE AREA
NOTES:
1. UNITS: MILLIMETERS.
2. IMAGE AREA IS ALIGNED TO DATUMS A B & C .
(54)
62B 0.05
6
2
B
0
.
0
5
M4x0.7 - 6H Z 6 (4X)
FIRST PIXEL REFERENCE HOLE
(
5
4
)
C
B
(42)
(
4
7
.
8
7
)
(
7
)
M4x0.7 - 6H Z 6 (2X) THIS SIDE (2X) FAR SIDE
(
4
2
)
(7)
M4x0.7 - 6H Z 6 (2X) THIS SIDE (2X) FAR SIDE
A
M58x0.75 - 6H
12B0.25 OPTICAL DISTANCE
IMAGE AREA
H
0.1 A
E
0.05
3
1
B
0
.
1
0
31B0.10
CENTER OF IMAGE AREA
±0.2°
(
9
)
(
9
)
(
1
9
.
1
)
(20.34)
(11.4)

Mechanicals

[INSERT PDF HERE]
03-032-20176-06 Teledyne DALSA
Figure 4: 2K (Top) and 4K (Bottom) Camera Mechanicals
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 13
AC-LN-00002
M58 to F-mount adapter, heavy duty, 12mm BFD, for 4K model
AC-LC-00001
M42x1 to C-mount adapter, 12mm BFD, for 2K model
AC-LA-00115
M42x1 to F-mount adapter, heavy duty, 12mm BFD, for 2K model
AC-MS-00108
Heat sink for 2k and 4k models
Figure 5: Nikon M58 to F-Mount Adapter
Figure 6: Piranha4 Heat Sink Accessories Kit
Optional Lens Mount and Heat Sink Accessories
Part No.
Description
Teledyne DALSA 03-032-20176-06
14 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
NOTES:
1. UNITS: MILLIMETERS.
2. IMAGE AREA IS ALIGNED TO DATUMS A B & C .
OPTIONAL EXTERNAL
HEAT SINK ACCESSORY (2X)
AC-MS-00108-00-R
(
9
8
)
HEAT SINK
GAP PAD
SCREW M4-0.7X8 TORQUE 25 IN*LB

Camera Mounting and Heat Sink Considerations

Up to two optional heat s inks can b e insta lled on the Piranha4 camera. A s illustrated, they are ideally pos it ioned to allo w close spa cing of the camera s. These heat sinks are designed to provide adequate convection cooling when not obstructed by enclosures or mounting assemblies.
Teledyne DAL SA recognises that each customer’s application can be unique. In c o nside ra tion, the P4 camera heat sinks have been designed in such a way that the y can be repositione d on the differe nt fa ces of the camera or removed entirely, depending on the mounting co nfiguration a nd its heat s inking potential.
Repositioning or removal of the heat sinks must be performed w ith care in order to av oid temperature issues. The camera has the ability to measure its internal temperature. Use this feature to record the internal temperature of the camera w hen it is mounte d in your s yste m and ope ra ting under the worst case conditions. The c amera will stop outputting data if its internal temperature reaches 80 °C. Refer to the Verify Temperature and Voltage section for more information.
Figure 7: Heat Sink Installation (4K model)
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 15

3. Quick, Simple Steps to Acquire an Image

For users who are familiar w ith Camera Link cameras, have a basic understanding of their imaging requirements, and who are primarily i nterested in evaluati ng the Piranha4 camera, an overview of the steps required to get this camera operational and acquiring images quickly can be found in Appendix D: Quick Se tup and Ima ge Ac quisition.
Teledyne DALSA 03-032-20176-06
16 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera

4. Software and Hardware Setup

Recommended System Requirements

To achieve best system performance, the following minimum requirements are recommended:
High bandwidth frame grabber, e.g. Xcelera-CL PX8 Full Camera Link frame grabber (Part # OR- X8CO-XPF00): ww w.teledynedal sa.com/ i maging/ products/ fg/ OR-X8C0-XPF00/
Operating systems: Windows XP / Vista / 7, 32 / 64-bit.

Setup Steps: Overview

Take the follow i ng steps in order to se tu p and run your camera system. They are described briefly below a nd in more detail in the sections that follow.

1. Install and Configure Frame Gr abb er and Software

We recommend the Xcelera-CL PX8 Full frame grabber or equivalent, described in detail on the teledynedalsa.com site here
A GenICam™ compliant XML device description file is embedded w ithin the camera firmware allowing GenICam™ compliant application to know the camera’s capabilities immediately after connection. Installing SaperaLT gives you access to the CamExpert GUI, a GenICam™ compliant application.
. Follow the manufacture r’s installation instructions.
.

2. Connect Camera Link and Power Cables

Connect the Camera Link cables from the camera to the computer.
Connect a power cable from the camera to a power supply that can provide a constant voltage
betw een +12 VDC and +24 VDC ± 5%.

3. Establish Commu nicating with the Camera

Start the G UI and esta b lish communication with the camera.
ASCII Commands
As an alternative to the CamExpert (or equivalent) GUI, you can communicate with this camera using A SCII -ba se d comma nds. Open up a n ASCII inte rface and pre ss the ESC key, then the communication mode w ill be sw itched into the ASCII command mode o ther than the GenICam mode. A complete list of the commands and a de sc ription of how to acc es s them can be found in Appendix B: ASCII Commands.

4. Operate the Camera

At this point yo u will be ready to start opera ting the camer a in order to acquire images, set camera functions , and save se ttings.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 17

Step 1. Install and Configure the Frame Grabber and Software

Install Frame Grabber

Install a Full configura tion Camera Link frame grab ber ac co rd in g to the manufac tu rer’s description . We recommend the Xcelera-CL PX8 frame grabber or equivalent, described in detail on the
teledynedalsa.com site here

Install Sapera LT and CamExpert GUI

Co mmunicate with the came ra us ing a Camera Link-compliant interface. We recommend you use CamExpert. CamExpert is the camera i nterfaci ng tool supported by the Sapera library and comes bu n dled with Sap eraLT. Using CamExpert is the simplest and quickest w ay to send commands to and receive information from the camer a.
Ca mera L ink Contro l Communications
The P4 family of cameras are GenICam™ compliant. Sapera uses the GenICam™ G ene ric Control Protocol (GenCP V1.0) to communicate with the camera over the Camera Link serial port. When comm unications a re first es t ab lished Sapera will when connecting for the first time download the G enIC am™ XML Descrip t ion file. This file deta ils how to a cces s and c ontrol the camera.
.
Teledyne DALSA 03-032-20176-06
18 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
!
B
B
C
Power
A
B
C

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.
+12V to +24V DC Hirose 6-pin
Control & Data
Camera Link 26-pin SDR26 connectors
Status
A
Figure 8: Input and Output, Trigger, and Power Connectors
WARNING! Grounding Instructio ns
Static e lectric ity can dama ge electronic compo n ents. It’s c ritical that you discharge any static electrical char ge by touching a grounded surface, such as the metal computer chassis, before handling the camera hardware.
Diagnostic LED
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 19
15
12
Y0+
15
12
X0+
3
24
Y1- 3 24
X1-
16
11
Y1+
16
11
X1+
4
23
Y2- 4 23
X2-
17
10
Y2+
17
10
X2+ 5 22
Yclk-
5
22
Xclk-
18 9 Yclk+
18 9 Xclk+
22 5 Z1+
22 5 CC1+
10
17
Z2-
10
17
CC2+
23 4 Z2+
23 4 CC2-
11
16
Zclk-
11
16
CC3-
24 3 Zclk+
24 3 CC3+
12
15
Z3-
12
15
CC4+
25 2 Z3+
25 2 CC4-

Data Connector: Camera Link

The camera uses two Camera Link SDR26 cables transmitting the Camera Link Base, Medium, or Full c o nfigura tion. The figure below shows the SDR26 Camera Link Connector and the tables that follow list the Camera Li nk Base, Medium, and Full configurations.
For detailed information on Camera Link please refer to the Camera Link Road M ap available from the Knowledge Center on the Teledyne DALSA Web site: (http:/ / ww w.teledynedalsa.com/ mv/ know ledge/ appnotes.aspx
Figure 9. Camera Link Connector
Data 2 Control / Data 1 Camera Connector
Right Angle Frame Grabber
Channel Link Signal
Camera Connector
Connector
1 1 inner shield 1 1 inner shield 14 14 inner shield 14 14 inner shield 2 25 Y0- 2 25 X0-
).
Right Angle Frame Grabber Connector
Channel Link Signal
6 21 Y3- 6 21 X3­19 8 Y3+ 19 8 X3+ 7 20 100 ohm 7 20 SerTC+ 20 7 terminated 20 7 SerTC­8 19 Z0- 8 19 SerTFG­21 6 Z0+ 21 6 SerTFG+ 9 18 Z1- 9 18 CC1-
13 13 inner shield 13 13 inner shield 26 26 inner shield 26 26 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
Teledyne DALSA 03-032-20176-06
20 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full Configuration
8 bits Camera Link Full Configuration
Connector 1: Channel link X Connector 2: Channel link Y Connector 3: Channel link Z
Camera/Frame Grabber Pin Bit Name
Tx0/Rx0 D0(0) Tx0/Rx0 D3(0) Tx0/Rx0 D6(0) Tx1/Rx1 D0(1) Tx1/Rx1 D3(1) Tx1/Rx1 D6(1) Tx2/Rx2 D0(2) Tx2/Rx2 D3(2) Tx2/Rx2 D6(2) Tx3/Rx3 D0(3) Tx3/Rx3 D3(3) Tx3/Rx3 D6(3) Tx4/Rx4 D0(4) Tx4/Rx4 D3(4) Tx4/Rx4 D6(4) Tx5/Rx5 D0(7) Tx5/Rx5 D3(7) Tx5/Rx5 D6(7) Tx6/Rx6 D0(5) Tx6/Rx6 D3(5) Tx6/Rx6 D6(5) Tx7/Rx7 D1(0) Tx7/Rx7 D4(0) Tx7/Rx7 D7(0) Tx8/Rx8 D1(1) Tx8/Rx8 D4(1) Tx8/Rx8 D7(1) Tx9/Rx9 D1(2) Tx9/Rx9 D4(2) Tx9/Rx9 D7(2) Tx10/Rx10 D1(6) Tx10/Rx10 D4(6) Tx10/Rx10 D7(6) Tx11/Rx11 D1(7) Tx11/Rx11 D4(7) Tx11/Rx11 D7(7) Tx12/Rx12 D1(3) Tx12/Rx12 D4(3) Tx12/Rx12 D7(3) Tx13/Rx13 D1(4) Tx13/Rx13 D4(4) Tx13/Rx13 D7(4) Tx14/Rx14 D1(5) Tx14/Rx14 D4(5) Tx14/Rx14 D7(5) Tx15/Rx15 D2(0) Tx15/Rx15 D5(0) Tx15/Rx15 Not Used Tx16/Rx16 D2(6) Tx16/Rx16 D5(6) Tx16/Rx16 Not Used Tx17/Rx17 D2(7) Tx17/Rx17 D5(7) Tx17/Rx17 Not Used Tx18/Rx18 D2(1) Tx18/Rx18 D5(1) Tx18/Rx18 Not Used Tx19/Rx19 D2(2) Tx19/Rx19 D5(2) Tx19/Rx19 Not Used Tx20/Rx20 D2(3) Tx20/Rx20 D5(3) Tx20/Rx20 Not Used Tx21/Rx21 D2(4) Tx21/Rx21 D5(4) Tx21/Rx21 Not Used Tx22/Rx22 D2(5) Tx22/Rx22 D5(5) Tx22/Rx22 Not Used Tx23/Rx23 Not Used Tx23/Rx23 Not Used Tx23/Rx23 Not Used Tx24/Rx24 LVAL Tx24/Rx24 LVAL Tx24/Rx24 LVAL Tx25/Rx25 FVAL Tx25/Rx25 FVAL Tx25/Rx25 FVAL Tx26/Rx26 Not Used Tx26/Rx26 Not Used Tx26/Rx26 Not Used Tx27/Rx27 D0(6) Tx27/Rx27 D3(6) Tx27/Rx27 D6(6)
Camera/Frame Grabber Pin Bit Name
Camera/Frame Grabber Pin Bit Name
Tap 1 bits are D0(x)...Tap 8 bits are D7(x)
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 21
Pixels (1, 3, 5 , .. . 4093, 4095)
Pixels (2, 4, 6 , .. . 4094, 4096)
Pixels (1,
Pixels (2,
Pixels (3,
Pixels (4,
Pixels (5,
Pixels (6,
Pixels (7,
Pixels (8,

Camera Link Bit Definiti ons

BASE
Configuration
Pixel Format Port A
Bits 0 thru 7
Mono 8 Tap 1 LS B..Bit 7
Tap 2 LSB..Bit7
T0
Port B
Bits 0 thru 7
Port C
Bits 0 thru 7
xxxxxxx
Mono 12 Tap 1 LSB.. Bit 7
Pixels (1, 3, 5 , .. . 84093, 4095)
Medium
Configurati
on
Pixel
Format
Mono 8 Tap 1
Mono 10 / Mono 12
Port A
Bits 0 thru 7
LSB..Bit 7 Pixels (1, 5, 9,
... 4089, 4093)
Tap 1 LSB.. Bit 7 Pixels (1, 5, 9,
... 4091, 4095)
Bits 0 thru 7
Tap 2 LSB..Bit 7
Pixels (2, 6, 10 , ... 4090,
4094) Tap 1
Bits 8,9,10,11 Pixels (1, 5, 9,
... 4091, 4095)
Tap 2 Bits 8,9,10,11
Pixels (2, 6, 10 , ... 4092,
4096)
Full
Configuration
Pixel Format Port A
LSB…Bit
Port B
LSB…Bit
7
Mono 8 Tap 1
LSB… Bit 7
Tap 2 LSB…
Bit 7
Port B
8
Bits 0 thru 7
Tap 3 LSB..Bit 7
Pixels (3, 7, 11 , ... 4091,
4095) Tap 2
LSB..Bit 7 Pixels (2, 6,
10 , ... 4092,
4096)
Port C
LSB…Bit
8
Tap 3 LSB…
Bit 7
Tap 1 Bits 8,9,10,11 Pixels (1, 3, 5 , .. . 4093,4095) Tap 2 Bits 8,9,10,11 Pixels (2,4,6 , ... 4094, 4096)
T0
Port C
Port D
Bits 0 thru 7
Tap 4 LSB...Bit 7
Pixels (4, 8, 12 , ... 4092,
4096) Tap 4
LSB…Bit 7 Pixels (4, 8,
12 , ... 4090,
4094)
T0
Port D
LSB…Bit
8
Tap 4 LSB…
Bit 7
Port E
LSB…Bit
8
Tap 5 LSB…
Bit 7
Tap 2 LSB..Bit 7 Pixels (2,4,6 , ... 4094, 4096)
Port E
Bits 0 thru 7
xxxxxxxx Xxxxxxxx
Tap 3 LSB…Bit 7 Pixels (3, 7,
11 , ... 4089,
4093)
Port F
LSB…Bit
LSB…Bit
8
Tap 6 LSB… Bit 7
Tap 7 LSB…Bit
7
Bits 0 thru 7
Tap 3 Bit 8,9,10,11 Pixels (3, 7,
11 , ... 4089,
4093)
Tap 4 Bits 8,9,10,11 Pixels (4, 8,
12 , ... 4090,
4094)
Port G
8
Port F
Port H
LSB…Bit
8
Tap 8 LSB… Bit 7
Teledyne DALSA 03-032-20176-06
9, 1 7 , .. . 4081,
4089)
10 , 1 8 , . .. 4082,
4090)
11 , 1 9 , . .. 4083,
4091)
12 , 2 0 , . .. 4084,
4092)
13 , 2 1 , . .. 4085,
4093)
14 , 2 2 , . .. 4086,
4094)
15 , 2 3 , . .. 4087,
4095)
16 , 2 4 , . .. 4088,
4096)
22 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
LSB…Bit
LSB…Bit
4096)
Pixels (9,
CC1
EXSYNC*
CC3
Direction
15 m
TeledyneDALSA Xcelera-CL+ PX8 Full / OR-X8C0-XPF00
Deca
Configurati
on
Pixel
Format
Mono 8 Tap 1
Port A
LSB…
Bit 7
LSB… Bit 7
Pixels (1, 11, 21 , ... 4081,
4091)
Signal
Port B
LSB…
Bit 8
Tap 2 LSB…
Bit 7 Pixels
(2, 12, 22 , ... 4082,
4092)
Port C
LSB…
Bit 8
Tap 3 LSB…
Bit 7 Pixels
(3, 13, 23 , ... 4083,
4093)
Port D
LSB…
Bit 8
Tap 4 LSB…
Bit 7
Table 4: Camera Link Bit Definitions
Pixels (4, 14, 24 , ... 4084,
4094)
T0
Port E
LSB…
Bit 8
Tap 5 LSB…
Bit 7 Pixels
(5, 15, 25, ... 4085,
4095)
Configuration
Port F
LSB…
Bit 8
Tap 6 LSB… Bit 7 Pixels
(6, 16, 26 , ... 4086,
Port G
LSB…
Bit 8
Tap 7 LSB…
Bit 7 Pixels
(7, 17, 27 , ...
4087)
Port H
LSB…
Bit 8
Tap 8 LSB… Bit 7 Pixels
(8, 18, 28 , ...
4088)
Port I
8
Tap 9 LSB… Bit 7
19 , 2 9 , . ..
4089)
Port K
8
Tap 10 LSB… Bit 7 Pixels
(10, 20, 30 , ...
4090)
CC2 Spar e
CC4 Spar e * K ee p t his sig nal in low status w hen idle. The exposure time must not be greater than the camera’s allowance—
3,000 µs.
Table 5: Camera Control Configuration
For additional Camera Link documentation refer to the Teledyne DA LS A Web site’s
application notes.
Knowledge Center

Camera Link Drive Capability

The cam era lin k cable drive capability on P4 -4K/ 2K cameras has been improved to reach up to 15 meters. This provides longer cable lengths without the need for additional components like, repeaters etc. This capability has been tested us ing a number of frame grabbers (listed in the table below) and was tested usi ng standard Camera Link cable s. The cable length drive achieved on the various frame grabbers is as follows:
Cable Length
10 m TeledyneDALSA Xcelera-CL PX4 / OR-X4C0-XPF00
TeledyneDALSA Xcelera-CL+ PX8 Full / OR-X8C0-XPF00 Matrox Radient eCL – RAD2GSF150400
Table 6: Cable Length and Frame Grabber Pairings
Frame Grabber (Manufacturer/Part Number)

Input Signals, Camera Link

The came ra acc epts control inputs through the C amera Link SDR26F connector. The camera ships in internal sync, and internally programmed integration.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 23
LVAL (high)
Ou t p u tt in g va lid line
DVAL
Not used
STROBE (rising edge)
Valid data
FVA L
Set to 0
1
6
5
4
3
2
2
+12 V to +24 V DC
5
GND
!
EXSYNC (Line Readout Trigger)
Line rate can be set internally using the GenICam fea tu res. The external con t rol sig nal EXSYNC is optional and ena b led through the user interface. This camera uses the falling edge of EXSYN C to trigger pixel readout.
The EXSYN C signal tells the camera when to i ntegr ate and readout the image. It can be either an internally generated signal by the camera, or it can be supplied externally via the serial interface. Depending upon the mode of operation the high time of the EXSYN C signal can represent the integration period.
Note: The EXSYN C signal is measured at CC1 and w ill give a “ true” measurement (i.e. w ithin the measurement resolution of 25 ns) even though the camera will only trigger at a maximum of 100 kHz.

Output Signals, Camera Link Clocking Signals

These signals indicate when data is valid, allow ing you to clock the data from the camera to your acquisition system. These signals are part of the Camera Link confi guration and you should refer to the Camera Link Implementation Road M ap, available at our Know ledge Center these signals.
Clocking Signal Indicates
, for the standard location of

Power Connector

WARNING: It is extreme ly important that you apply the appropria te voltages to your camera. Incorrect voltages may damage the camera. Input voltage requirement: +12 VDC to +24 VDC, 2 Amps. Before connecting power to the camera, test all pow er supplies.
Figure 10: 6-pin Hirose Circular Male Power Plug—Power Connector
Table 7. Power Plug Pinout
Pin Description Pin Description
1 +12 V to +24 V DC 4 GND
3 +12 V to +24 V DC 6 GND
Teledyne DALSA 03-032-20176-06
24 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
!
Green
Ready
The camera requires a singl e voltage input +12 VDC to +24 VDC ± 5%. The camera meets all performance specific atio ns u sing sta ndard switching p ower supplies, although well-regulated linear supplies provide optimum performa n ce.
WARNING: When setting up the camera’s power s upplies follow these guidelines:
Apply the appro priate vo ltages.
Protect the camera w ith a 2 amp slow-blow fuse between the pow er supply and the camera.
Do not use the shield on a multi-conductor ca ble for ground.
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.

LEDs

The camera i s equipped w ith an LED on the back to display the operational status of the camera. The table bel ow summarizes the operating states of the camera and the corresponding LED states. When more than o ne co ndition is active , the LE D indicates the condition with the highest priority.
Color of Status LED
Off No power or hardware malfunction Blinking Powering up or ca librating
Meaning
Red Error. Check the built -in self test (Bi ST ) register for the specific error

Step 3. Establish Communication with the Camera

Power on the camera

Turn on the camera’s po we r supply. Y ou may have to wait while th e camera readies itse lf for operation. The camera must boot ful ly before it w ill be recognized by the GUI—the LED shi nes green once the camera is ready.

Connect to the frame grabber

1. S tart Sapera CamExpert (or equivalent Camera Link compliant interface) by double clicking the
desktop icon create d durin g the softwa re insta llation .
2. CamExpert will search for installed Sapera devices. In the Devices list area on the left side, the
connected frame grabber will be shown.
3. S elect the frame grabber device by clicking on the name.
Note: The first time you set up the camera you w ill need to establish a communication link betw een the camera and frame grabber.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 25

Connect to the camera

1. Start a new S apera CamExpert application (or eq uiva lent Came ra Link compliant interface) by
do u ble clicking the deskto p icon created during the software installation.
2. In the Devices list area on the left side, select the COM port below the Camera Link label.
Figure 11. CamExpert GUI showing connected camera

Check LED Status

If the camera is operating correc tly at this point, the dia gnost ic LED will shine green.

Software Interface

All the camera features can be controlled through the CamExpert i nterface. For example, under the Camera Control menu in the camera window you can control the line rate and exposure times.
Teledyne DALSA 03-032-20176-06
26 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
A note on the CamExpert examples shown here: The examples shown for illustrative purposes and may
At this point your hos t and camera system s ho uld be se tup and you can verify the camera’s operation by retrieving a test pattern and setting the camera’s trigger and exposure time.

Using Sapera CamExpert with Piranha4 Cameras

CamExpert is the camer a interfacing tool supported by the Sapera library. When used with a Piranha4 camera, CamExpert allows a user to test all camera o perating mode s. Additionally CamExpert saves the camera user setting s c onfig uration to the camera or saves m u ltip le c onfig u rations a s individual c amera parameter files on the host system (*.ccf). CamExpert can also be used to upgrade the camera’s software.
An important component of CamExpert is its live a cquisition d isplay window which allows immediate verification of timing or control parameters w ithout the need to run a separate acquisiti on program.
For context sensitive help, click on the button then click on a camera configura tion para meter. A short description of the configura tion para meter will be shown in a popup. Click on the but ton to
open the help file for more descriptive information on CamExpert. The central section of CamExpert provides access to the camera features and parameters. Note: The
ava ilab ility of the features is dependent on the CamExpert user setting.
not entirely reflect the features and parameters available from the camera model used in your
application.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 27

CamExpert Panes

Figure 12. CamExpert’s Camera Control Window
The CamExpert application uses panes to simplify choosing and co n f iguring camera files or acquisitio n parameters for the installed device.
Device Selector pane: View and select from any installed Sapera acquisition device. Once a device is selected CamExpert will on ly prese nt a cqu isition param eters applicable to that d evice. Option ally select a camera file included w ith the Sapera installation or saved by the user.
Parameters pane: Allows vie wing or changing all acquisition p arameters s u p p orted by the acquisition device. CamExpert displays parameters only if those parameters are supported by the insta lled device. This a voids c onfusio n by eliminating param eter c h oic es when they do not apply to the hardw are in use.
Display pane: Provides a l i ve or single frame acquisition display. Frame buffer parameters are show n in an information bar ab o ve the imag e window.
Contr ol Butto ns: The Display pane includes CamExpert contr ol buttons. These are:
Teledyne DALSA 03-032-20176-06
28 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
With the I/ O control para meters set to Trigger E n abled, c lick to send a
Stretch im age to f it , se t image display to original size, or zoom t h e
Acquisition control button:
C lick once to start live grab, click again to stop.
Single frame grab: Click to acquire one frame from devi ce.
Trigger button: s ingle trigger co mmand.
CamExpert display controls: (these do not modify the frame buffer data)
image to virtually any size and ratio. Histogram / Profile tool:
Se lect to vie w a histo gra m or line/ column profile during live acquisition o r in a s t ill im age.
Output M ess age pane: Displays messages from CamExpert or the device driver.
At this point yo u are ready to start operating the camera in order to acquire images, set camera functions, and save settings.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 29
Exsync
Programmed
Exposure Time
Bottom Line Stored
In Memory
CL Output
Top and Bottom Lines
Read out of Sensor
Top Line
Transmitted out
Camera Link
Bottom Line
Transmitted out
Camera Link

4. Camera Operation

Factory Settings

The camera s hips and powers up for the first time with the following factory settings:
C amera Link Full, 8 bit pixels
Internal trigger, line rate 10 kHz
Internal exposure control, exposure time 50 µs
2 stage TDI
1x horizontal a nd ve r tical bin n ing
Offset 0, Gain 1x

Area Mode

Using area mode in the P4 mono camera allows data rates to be tw ice as fast compared to TDI Stage = 1 or TD I St ages = 2.
S imilar to TDI Stage = 2 mode, both the top and bottom lines of the sensor are exposed at the same time. The difference being that instead of summing the lines, each line is read out separately. The figure below illustrates how th is is done. On the first Exsync signal, both lines are exposed and the n the sens or is re ad out. One line is processed and stored in camera memory while the other line is processed and sent out the Camera Link output. The next Exsync signal does not reach the sensor, but instead the stored data is transferred out the Camera Link port.
Figure 13. Area Mode data transfer timing
It is important that the exposure time in area mode be appropriate for the set line rate. The exposure time s hould not be longer than the inverse of the line rate or else the image w ill smear. The set scan direction is also important. If the direc t ion is wron g the image will loo k choppy, as can b e s ee n in the following figure.
Teledyne DALSA 03-032-20176-06
30 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Figure 14. Image with incorrect scan direction
Figure 15. Image with proper scan direction
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 31

Check Camera and Sensor Information

Camera and sensor information can be retrieved via a controlling application—for example, the CamExpert GUI show n in the following examples. Parameters such as camera model, firmware version, sensor characteristics, etc. are read to uniquely identify the connected device.
The camera i nformation parameters are grouped together as members of the Camera Infor matio n set.
Figure 16. CamExpert’s Camera Information Window

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 temper ature in degrees Celsius. For proper operation this value should not exceed 80 °C. If the camera exceeds the designated temperature it will stop imaging a nd the LED will turn red. Once you have di agnosed and remedied the issue use the reset camera function.
Teledyne DALSA 03-032-20176-06
32 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Selecting the set from th e list automatic ally saves it as the defa ult
-User Set 1 to 8.
Note: The voltage displayed is the camera’s input voltage. The voltage measurement feature of the camera provides results within 1% of the actual voltage. The measurement can be used to set the applied voltage to the camer a.

Saving and Restoring Camera Settings

The parameters used to select, load and save user sets are grouped together under the Camera Information set of features. There are 8 user sets available and one factory set.
Camera Information
Parameter Choices
User Set Defaul t Selector Select the camera parameters to load whe n the camera is reset or
pow ered up as the Factory set, or as User Set 1 to 8.
set.
User Set Selector Select the Factory or User set to Save or Load.
-Fact or y Set
User Set Load Lo ad the set specifi ed by User Set Selector to the camera and make
it the active / current set.
User Set Sav e Save the current set as selected user set.

Description of the Camera Settings

The camera operates in one of four settings:
1. Current operation with active settings.
2. User setting.
3. Fac tory se tting (read-only).
4. Defa ult setting.
The settings active during the current operation can be saved (thereby becoming the user setting) using the User Se t Save parameter. A previously saved user setting (User S et 1 to 8) or the fa ctory settings can be restored using the User Set Selector and User Set Load parameters.
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 powe red up.
The relationship between these four setting s is illu stra t ed in Figure 17. Relationship betw een the Camera Settings:
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 33
Figure 17. Relationship between the Camera Settings

Active Settings for Current Operation

The active setti ng for the current operation is the set of config uratio n s that are active while the camera is currently running, includin g all unsaved changes you have made to the settings before saving them.
These active settings are stored in the camera’s volatile memory and will be lost and cannot be restored if the camera resets, is pow ered down, or los es power.
To save these settings for reuse the next time you pow er up or reset the camera, or to protect against losi ng them in the case of power loss, you must s ave the current s ettings using the User Set Save parameter. Once saved, the current settings become the selected User Set.

User Setting

The user setting is the saved set of camera configurations that you can customize, resave, and restore. By default the user settings are shipped w ith the same settings as the factory set.
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 w ant to restore and then select the User Set Load parameter.

Factory Settings

Th e factory setting is the camera settings that w ere shipped with the camera and which loade d during the camera’s first power-up. To load or resto re the o rig inal facto ry setting s, at any time, select the Factory Setting parameter and then select the User Set Load parameter.
Teledyne DALSA 03-032-20176-06
34 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full 8 8
2
Deca (4K only)
10 8 2
Note: By de fault, the user settin g s are se t to the fac tory se ttings.

Default Setting

Either the Factory or one of the User settings can be used as the Default S etting by selecting the set i n the User Set Default Selector. The chosen set automatically becomes the default setting and i s the set loaded when the camera is reset of powered up.

Camera Link Configuration

Name
Base 2 8, 10, 12 1
Medium 4 8, 10, 12 2
*Set Pixel Format (number of bits per pixel)
Taps
SPF*
Cables

TDI and Single Line Modes

You have the option to set the camera modes as either single line (where only the bottom sensor is used, which results in lower sensitivity) or as TDI (where the pair of sensor li nes is summed, w hich results in higher sensitivity).

TDI Mode vs. Vertical Binning 2

TDI mode delays one line before summing so that each row images the same area. In the case of vertical binning equal to 2, the row s image adjacent areas and are summed without separation delay. This action, c o mbined with horizontal binning eq ual to 2, re sults in a b ig pixel that ha s half the reso lution but four times the response compared to TDI stages = 1.

TDI Stage 2 vs. Vertical Binning

Vertical Binning and TDI Stage 2 are very similar in operation in that for both modes bo th lines of the sensor are used and both lines are summed together. The difference is that in vertical binning both lines are summed directly, while in TDI Stages 2 one l ine is delayed by one EXSYNC before being summed with the o ther line. The result is a 20 µm tall pix el for vertical binn in g while T DI Stage 2 m aintains the 1 0 µm pixel height.
There is no line rate difference betw een these tw o modes.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 35

Sensitivity Modes and Pixel Readout

The camera has the option to operate in either TDI mode or single lin e mode. When in TDI mode, the camera uses both line scan sens o rs and as a result the responsivity increases (57%). When in sing le line mode, the camera uses the bottom sensor only. The i nternal gain is 1.27x gre ater for single line mode vs. TDI mode.
Figure 18: TDI Mode Examples
In TDI mode, the camera uses a 10.56 µm x 10.56 µm pixel and captures the same image twice, resulting in a brighter image .
Figure 19: Single Line Mode Examples
In single line mode, the camera uses a 10.56 µm x 10.56 µm pixel and captures the image using one sensor (Sensor 1).
Teledyne DALSA 03-032-20176-06
36 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
rate. Programmed exposure time.
pulse
Line Rate (in Hz)
Camera line rate in H z. Only available when the start line trigger para m eter
Trigge r Width
exposure dura tio n .

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 synchroni zi ng exposures to external triggers, o r a programme d function call mes sage by the controlling computer. These triggering modes are described below.
Internal trigger (trigg er dis abled): The camera free-running mode has a programmab le interna l
timer for line rate and a programmable e xposure period.
External trigger (trigger enabled): Exposures are controlled by an external tri gger signal. The
external tr igger signal is the Camera Link control line CC1.

Exposure Controls

The Exposure Control modes define how and when the camera will capture an image—the integration period. The integration period is the amount of time the camera’s sensor is exposed to incoming light before the captured image is transmitted to the controlling computer.
Exposure control is d efined as the start of exposure and exposure duration.
The start of exposure can be an internal timer signal (free-running mode) or an external trigger
signal.
The exposure duration can be programmable (such as the case of an internal timer) or controlled by the external trigger pulse width.
The camera can grab images in one of three w ays. You determine the three imaging modes usi ng a combination of the Exposure M ode parameters (including I/ O parameters), Exposure Time and Line Rate parameters.
Description
Internal line rate and exposure time Internal, programmable Internal programmable Internal
External line rate and exposure time Controlled by EXSYNC
EXSYNC p u lse co ntrolling t he line
Line Rate
pulse Controlled by EXSYNC
Exposure Time
External (EXSYNC) External
Internal programmable External
Trigger Source
(Sync)
Figure 20. Exposure controls
The parameters used to select the imaging modes—trigger sources (sync), exposure time, and l ine rate— are grouped together as the Camera Controls.
Camera Controls
Parameter Description
is disa bled (Trigger Mode off).
Exposure Mode Set the operation mode for the camera’s exposure.
Trigge r Width or Timed. Trigger Width is only available when Trigger Mode is enabled.
Uses the w idth of the current line trig ge r sig n al pulse to control the
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 37
Timed
Exposure Time
Sets the exposure time (in microseconds). Exposure Mode feature must be
The exposure duration time is set using the Exposure Time feature and the exposure starts w ith the Line Start even t.
set to Timed

Exposure Modes in Detail

1. Internally Programmable Line rate and Internally Programmable Expos ur e Time (Default)

Line rate is the dominant factor when adjusting the line rate or exposure time. When setting the line rate, exposure time wi ll decrease, if necessary, to accommodate the new line rate. When adjusting the exposure time the range is limited by the line rate.
Note: The camera will not set line periods shorter than the readout period.
GenI Cam parameters to set: I / O Controls > Trigger M ode > Off

2. External Line Rate and External Exposure Time (Trigger Width)

In this mode, EXSYNC sets both the line period and the exposure time. The rising edge of EXSYNC marks the beginni ng of the exposure and the falling edge initiates readout. Note:
GenI Cam parameters to set:
I / O Controls > Trigger M ode > On
Camera Control > Exposure M ode > Trigger Width
Warning! When running external line rate and external exposure time, the line rate must not exceed 1 / (exposure ti me + 1 µs). Under these conditions the exposure time will become indeterminate and result in ima g e arte facts . This is not the case when running inte rnal e xposure control.

3. External Line Rate, Programm able E x pos ur e Time

In this mode, the line rate is set externally w ith the falling edge of EXSYN C generating the rising edge of a programmable exposure time.
GenI Cam parameters to set:
I / O Controls > Trigger M ode > On
Camera Control > Exposure M ode > Timed
Teledyne DALSA 03-032-20176-06
38 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
1. External Trigger Off, Internal Exposure Control Free running, not synchronized to an external signal
Programmable Line Time
Programmable Exposure
1
Sensor
Readout
2
Sensor
Readout
2
>1us
Programmable Exposure
1
Programmable Exposure
1
Sensor
Readout
2
LVAL
2. External Trigger On, Internal Exposure Control CC1 Falling edge triggers start of internal exposure
3
Line Time
Programmable Exposure
1
Sensor
Readout
2
10.2us
Sensor
Readout
2
>1us
Programmable Exposure
1
Programmable Exposure
1
Sensor
Readout
2
LVAL
CC1
3. External Trigger On, External Exposure Control CC1 Falling edge triggers start of exposure CC1 high duration sets the exposure time
Line Time
Exposure = X
1
Sensor
Readout
2
Sensor
Readout
2
>1us
Sensor
Readout
2
LVAL
CC1
Exposure = X
2
X
1
X
2
Exposure = X
3
X
3
Notes:
1. Exposure time > 4 micro-seconds
2. Sensor Readout time = 9.5 micro-seconds
3. One additional falling edge during exposure is latched
10.2us
10.2us
03-032-20176-06 Teledyne DALSA
Figure 21. Exposure Modes
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 39
Line Rate (in Hz)
Camera line rate in a range from 1 Hz up to 100 kHz.
Base, 8-bit
41 kHz (4K), 82 kHz (2K)
Medium, 8-bit
81 kHz(4K), 100 kHz (2K)
Full (TDI) , 8-bit
100 kHz (4K and 2K)
Full (Area) , 8-bit
160 kHz (4K), 200 kHz (2K)
Deca (A rea) , 8 -bit
200 kHz (4K)

Set Line Rate

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 dis abled (Trigg er Mode Off).
Note: A line rate < 1 / (Exposure time + 1 µs) will return an erro r (“Invalid Parameter”) if t his co ndition is not met. You must adjust these tw o parameters in the correct sequence to maintain this condition.
If the external line rate exceeds the maximum line rate allow ed for a mode, the camera will continue to output data at its maximum line rate. Though no image artefacts associated with over-speed will occu r, you may notice that under over-speed conditions the image will appear compressed and the apparent distance travelled will be reduced.
Camera Control
Parameter Description
This feature is only availa b le whe n the ca mera is in Interna l Mode— line trigger is disabled (Trigger M ode off).
Camera Link Configuration Maximum Line Rate
Line Rates
Teledyne DALSA 03-032-20176-06
40 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera

Line Rates Vs. AOI

Table 8: 85 MHz Camera Link Clock Rate. Maximum Line Rates of 100 kHz TDI and 200 kHz Area.
Number
of AOI
1
CL
Configuration
Base
Medium
Full
Deca
Line Rate Formula (Hz)
Base
Medium
2
Full
Deca
Base
Medium
3
Full
Deca
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 41
Number
of AOI
4
Table 9: 66 MHz Camera Link Clock Rate. Maximum Line Rates of 100 kHz TDI and 200 kHz Area.
CL
Configuration
Base
Medium
Full
Deca
Base
Line Rate Formula (Hz)
Medium
1
Full
Deca
Base
Medium
2
Full
Deca
Teledyne DALSA 03-032-20176-06
42 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Base
Medium
3
Full
Deca
Base
Medium
4
Full
Deca

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 o nly ava ilable when the Exposure M ode parameter is set to Timed. The allowable exposure range is from 4 µs to 3,000 µs, depende nt on the value o f the interna l line rate .
GenI Cam parameters: Camera Controls > Exposure Time (Timed Exposure M ode) > 4 µs to 3,000 µs.

Control Gain and Black Level

The cameras provide gain and black level adjustments in the dig ital domain for the CMOS sensor. The gain and black level controls can make small compensations to the acquisition in situations where lighting varies and the lens iris cannot be easily adjusted. The user can evaluate gain and black level by using CamExpert.
The parameters that control gai n and black level are grouped together in the Camera Controls set.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 43
Black Level
Apply a digital addition after an FPN correction: ± 1/ 8 of available range. For example in 12-bit mode the available range is -512 to +511.
Gain
Set t h e gain as a n am p lification fac t or app lied to the video signal across all
Control the size of the tra n smitted ima ge
Width
Width of the imag e. Read only.
Height
Height of the image in lines. Read only.
Pixel Format
Mono 8, Mono 10 , or Mono 12 bit depth to Camera Link.
Test Image Selector
Select an internal test image:
Control the baud rate used by the
Baud Rate
9600 (factory default)
Camera Controls
pixels: 1x to 10x.

Set Image Size

To set the height of the image, and therefore the number of lines to scan, use the parameters grouped under the Image Format Control set.
Image Format Control

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 th e Se rial Port Co n t ro l parameters .
camera’s serial port
Action
Off Ramp A5 Each Tap Fixed All 1365 All 1
Serial Port Control
Parameter
Options
19200 57600 115200 230400* 460800* 921600*
Note: During connection CamExpert automatically sets the camera to maximum allo wable b aud.
*A Px8 or equivalent frame grabbe r is required in ord er to achieve these baud rates.
Teledyne DALSA 03-032-20176-06
44 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Number of bits per character used in the
Data Size
8
Parity of the seria l port
Parity
None
Number of stop bits per character used
Number of Stop
1

Pixel Format

Mono 8* S can Direction Sour ce
When in TDI stages 2 or Area mode, this command lets you
Scan Direction
Read the current direct ion.
seria l port
in the serial port
Bits
Pixel Format
Use the Pixel Format feature, found in the Image Format Control set, to select the format of the pixel to use during ima ge acquisitio n as either M ono 8, Mono 10, or Mono 12 bit depth.
Image Format Control
Parameter
Mono 10 Mono 12
* Only availab le format for F u ll and Deca Camera Link configurations.
Description

Camera Direction Control

F o und in the Camera Control > Direction Control set of features. N ote: This feature is only available whe n in TDI mode.
Note: the Se nsor Shift features are not available w hen the camera is in low or tall pixel sensitivity modes.
Camera Control > Direction Control
Parameter
03-032-20176-06 Teledyne DALSA
Description
select the I nternal or external direction control. Use this feature to accommodate object direction change on a web and to mount the camera "upside dow n."
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 45
Line Mirroring
Of f: All pix els are rea d out fro m left to right.

Camera Direction

When in TDI mode or A rea mode you can select either forw ard or reverse camera direction. Selectable direction accommodates object direction change on a web and allow s you to mount the camera “ upside down”.
Note that the example here assumes the use of a lens (w hich inverts the image).
Figure 22: Object Movement and Camera Direction Example using a Lens

Pixel Readout Direction (Mirroring Mod e)

Set th e tap readout fro m left to right or from right to left. This fe ature is e spec ially useful if you wa n t to mount the camera “ upside dow n.”
Image Format Control
Parameter
On: All pixels are rea d out fro m right to le f t.
Teledyne DALSA 03-032-20176-06
Description
46 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Camera Reset
Resets the camera and puts in th e default settings, inc luding a 9600 baud

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
rate.
Description

Calibrating the Camera

Importa n t Note: to ensure best results, the conditi ons under w hich you calibrate the camera (e.g. temperature and illumination ) s hould be as close to the ac tu al operating condit ions a s possible.
Figure 23: Flat Field Calibration in CamExpert
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 47
must inc lude a character spac e betwe en the clo sing quotation mark in the target and the

Calibration

The goal of calibration is for the camera to produce a unifor m output image at a desired level w hile imaging a uniform white objec t under conditions equal to the optica l setup for the user’s application.
Configure the camera to the exsync and exposure timing they require, pl us adjust the light level for normal operation.
Set th e system gain to a va lue that bes t suits the applic ation.
The lens should be at the required magnification and aperture and be focused.
As the w hite reference is located at the object plane, any ma rkings or contaminants on its surface
(e.g. du st, sc ratches, smudges ) will end up in th e c alibr ation pro file of the camera . To avo id t h is, use a c lean white plastic or cera m ic material rather than t ry in g to rely o n a paper reference. (Ideally, the white object w ill be moving during the calibration process, as the averaging process of the camera will dimi nish the effects of a ny s m all variation in th e white reference.)
Adjust the system gain until the peak intensity is at the desired DN level and then calibrate the FPN. Use a lens cap to ensure that no light reaches the sensor.
Once complete, remove the lens cap and perform a PRNU calibration using the desired target value (in DN). You want all the pixels to match. This ta rget value should be higher than the pe ak values you saw while first setting up t he ca m era.
After several seconds the PRNU calibration will end a nd the correction coefficients w ill be enabled. The system gain remains as first set.
The coefficie nts and ga in para meters, timing and control configura tion c an be stored in any one of eight user sets and automatically retrieved at pow er-up or by user selection.
CamExpert has a default timeout of 20 seconds per command, which is too short for the F FC c alibration to run fully. Yo u can chang e the default time out by s etting a command line argument in the short-cut:
Right c lic k on the sho rt-cut in the start men u and s ele ct properties.
Add –timeout 60 to incr ease the command timeout to 60 seconds (See below). Note that you
hyphen before the timeout value.
Repeat for desktop short-cut
Figure 24: Setting the camera’s timeout value
Teledyne DALSA 03-032-20176-06
48 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
flatfieldCorrectionMode
1. Off – Flat field correcti on coefficients are not applied. Sen din g this value will rese t all current co efficients
(offsets to 0 and gains to 1x).
flatfieldCorrectionAlgorithm
1. Basic – D irect calc u latio n of coefficients based on current
algorithm if th e c alibr atio n ta r ge t is not u niform white o r it s
pix el varia tions and
flatfieldCalibrationTarget
1. After calibration all pix els will b e s caled to output t h is le vel
12 bit: 0 to 4095 DN
flatfieldCalibrationSampleSize
1. Number of lines to average w hen calibrating
2. 2048 or 4096
flatfieldCalibrationROIOffsetX
1. Together with “fla t fieldCalibrationROIWidth ” specifies t he
flatfieldCalibrationROIWidth
flatfieldCalibrationFPN
1. S ave average line (of “ flatfieldCalibrationSampleSize” row s).
Use “fla t fieldCorre ctionAlgorithm” to calc u late the per pixel

1. Flat Field

This Flat Field set contains a number of features that are used to correct image distortion due to lens vig n etting and une ven illumination.
Note:
1. F lat field coefficients consis t of a n of fset and gain for each pixel.
2. These are the first user corrections applied to the image.
3. The flat field coefficients are saved and loaded w ith the user set.
Flat Field
Parameter
Description
2. On – Flat field correction coefficients are applied.
3. Initialize –
average line values and target.
2. Low Pass – A low pass filter is first applied to the current average line values before calcul ating the coefficients. Use this
not possible to defocus the image. Because of the low pass fi lter this a lgorith m is not ab le to cor rect p ixe l-to­so it is preferable to use the “Bas ic” algo rithm if poss ible.
2. Range depends on pixel format:
8 bit: 0 to 255 DN
10 bit: 0 to 1023 DN
range of pixels to be calibrated. Pixel coefficients outside this range are not changed. It is possible to calibrate different regions sequentially.
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.
3. Range 0 to 511 DN, 12 bit
4. Default value is 0 DN for each pixel
flatfieldCalibrationPRNU 1.
gain to achieve th e specified target output.
2. Range 0 to 15.9998x
3. Default 1x

2. Contrast Enhancement

03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 49
Use the Offset and Gain features to maximize the use of the output dynamic range (especially when pixel fo rm at is less than 12 bits). Typical use is to subtract minimum p ixel value expecte d and then gain up maximum p ixel value to approach full scale.

Offset

1. Single value added to each pixel
2. Range -512 to 511 DN , scaled down according to pixel format
3. Positive values may be used to measure dark noise

Gain

1. F loating p oint dig it al multip lier a pp lied to ea ch pixe l
2. Range 1x to 10x
Teledyne DALSA 03-032-20176-06
50 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
A note on the CamExpert examples shown here: The examples shown for illustr ative purposes and may

Appendix A: GenICam Commands

This appendix lists the available GenICam camera features. A ccess these features using the CamExpert interface.
Features listed in the des cription t able but tagged as Invisible are ty pically rese rved for Teledyne DA LSA Support o r th ird party so ftware u sage, and not typic ally required by end user applications.
not entirely reflect the features and parameters available from the camera model used in your
application.

Camera Information Category

Camera information can be retrieved via a controlling application. Parameters such as camera model, firmware version, etc. are read to uniquely identify the connected P4 device. These features are typically read-only. The Ca m era In formation Ca t ego ry groups information specif ic to the individual ca m era . In th is catego ry the number of features show n is identical w hether the view is Beginner, Expert, or Guru. Features listed in the des cription t able but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 51
Model Name
DeviceM odelName
Displays the device model name. (RO)
1.00
Vendor Name
DeviceVendorN ame
Displays the device vendor name. (RO)
1.00
Device Version
DeviceVersion
Displays the device versio n . This tag will
1.00
Manufacturer Info
DeviceM anufacturerInfo
This feature provides extended (RO)
1.00

Camera Information Feature Descriptions

The follow ing table describes these parameters along with their view attributes and in w hich version of the device the feature was introduced. A dditionally the Device Version column will indicate which parameter is a member of the DALSA Features Naming Conve ntion (using the tag DFNC), verses the GenICam Standard Features Naming Convention (SFNC not s ho wn).
The Device Version number represents the camera softw are functional group, not a firmware revision number.
Display Name Feature Description Device
Beginner
Beginner
also highligh t if the f irmware is a beta o r custom design. (RO)
manufacturer information about the device.
Beginner
Beginner
Version
& View
Teledyne DALSA 03-032-20176-06
52 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Serial Number
DeviceID
Displays the device’s factory set camera
1.00
Device User ID
DeviceUserID
Feature to store user-programmable
(RW)
1.00
Power-up
UserSetDefaultSelector
Selects the camera configuration set to load
(RW)
1.00
UserSet1
UserSet1
Select the user defined configuration
UserSet2
UserSet2
Select the user defined configuration
UserSet3
UserSet3
Select the user defined configuration
UserSet4
UserSet4
Select the user defined configuration UserSet 4 as the Power-up Configuration.
UserSet6
UserSet6
Select the user defined configuration
UserSet7
UserSet7
Select the user defined configuration
UserSet8
UserSet8
Select the user defined configuration
User Set Selector
UserSetSelector
Selects the camera configuration set to load se ttings to. The Factory set con tains default
camera feature settings. (RW)
1.00
Fac tory Se tting
Default
Select the default came ra feature se ttings save d by the factory
UserSet 1
UserSet1
Select the User-de fine d Configura tion space settings previously saved by the user.
UserSet 2
UserSet2
Select the User-defined Configur ation space
UserSet3
UserSet3
Select the User-defined Configur ation space
Display Name Feature Description Device
Version
& View
Firmware Version DeviceFirmw areVersion Displays the currently loaded firmware
version number. Firmware files have a
1.00
Beginner unique number and have the .cbf file extension. (RO)
serial number. (RO)
identifier of up to 15 characters. The default factory setting is the camer a serial number.
Configuration Selector
and make active on camera pow er-up or reset. The camera configuration sets are stored in camera non-volatile memory.
Fac tory Se tting Default Loa d fa ctory default feature settings
UserSet 1 as the Power-up Configuration. UserSet 2 as the Power-up Configuration UserSet 3 as the Power-up Configuration
UserSet5 UserSet5 Select the user defined configuration
UserSet 5 as the Power-up Configuration. UserSet 6 as the Power-up Configuration.
Beginner
Beginner
Beginner
03-032-20176-06 Teledyne DALSA
UserSet 7 as the Power-up Configuration. UserSet 8 as the Power-up Configuration.
feature settings from or save current feature
UserS et1 to save to or load from features
UserS et2 to save to or load from features settings previously saved by the user.
UserS et3 to save to or load from features settings previously saved by the user.
Beginner
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 53
UserSet5
UserSet5
Select the User-defined Configur ation space
UserSet6
UserSet6
Select the User-defined Configur ation space settings previously saved by the user.
UserSet7
UserSet7
Select the User-defined Configur ation space
UserSet8
UserSet8
Select the User-de fine d Configura tion space Power-on User Set
UserSetDefaultSelector
Allows the user to select between the at power up
1.00
Current User Set
UserSetSelector
Points to which user set (1-8) or factory set
1.00 Load Configuration
UserSetLoad
Loads the camera configuration set
1.00
S ave Configuration
User SetSav e
S aves the current camera configuration to
1.00 Device Built-In Sel f
dev i ceBI STStat us
Determi ne the status of the device using the
1.00
LED Color
deviceLEDColorControl
Displays the s tatus of the LED on the ba ck
1.00 Beginner
Temperature
DeviceTemperature
Displays the internal operating temperature
1.00 Beginner
Refresh
refreshTemperature
Press to display the current internal
1.00
Input Voltage
deviceInputVoltage
Displays the input voltage to the camera at
1.00
Display Name Feature Description Device
Version
& View
UserSet4 UserSet4 Select the User-defined Configuration space
UserS et4 to save to or load from features settings previously saved by the user.
UserS et5 to save to or load from features settings previously saved by the user.
UserS et6 to save to or load from features
UserS et7 to save to or load from features settings previously saved by the user.
UserS et8 to save to or load from features settings previously saved by the user.
Test Status
Temperature
factory set and 1 to 8 user sets to be loaded
that is loade d or save d whe n the UserSetLoad or UserSetSave command is used
specified by the User Set Selector feature, to the camera and makes it active. (W)
the user set specified by the User S et Selector feature. The user sets are located on the camera in non-volatile memory. (W)
‘Built-In Self Test’. Possible return values are device-specific. (RO)
of the camera. (RO)
of the camera. (RO)
operating temperature of the camera.
Beginner
Beginner
Beginner
Beginner
DFNC
Beginner
DFNC
DFNC
DFNC
Beginner
Refresh Voltage refreshVoltage Pres s to display the c urrent input voltage of
Teledyne DALSA 03-032-20176-06
the pow er connector (RO)
the camera at the pow er connector
DFNC
Beginner
1.00
DFNC
Beginner
54 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Display Name Feature Description Device
Version
& View
License Key securityUpgrade 1.00
DFNC
Guru

Camera Configuration Selection Dialog

CamExpert provides a dial og box which combines the features to select the camera pow er up state and for the user to save or load a camera state from Genie memory.

Camera Power-up Configu ration

The first drop list selects the camera configuration state to load on power-up (see feature U ser Set D efau l t Sel ect or ). The user chooses from one factory data set or one of two possible user saved states.

User Set Configuration Management

The seco nd drop list a llows the user to c hange the came ra configura tion a nytime after a pow er-up (see feature U ser Set Sel ect or ). To reset the camera to the factory configuration, select F actory Setting an d click Load. To save a current camera configuration, select User Set 1 to 8 and click Save. Select a saved user set and click Lo ad to restore a saved configuration.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 55

Camera Control Category

The P4 came ra controls , as sho wn by CamExpe rt, 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.
Teledyne DALSA 03-032-20176-06
56 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Internal Line
AcquisitionLineRate
Specifies the camera internal line rate, in Hz
automatically adjusted to a valid camera value.
1.00 Measured Line
measureLineRate
Specifies the line rate provided to the camera by
1.00
Refresh
refreshM easureLi neRate
Press to show the current li ne rate provided to
1.00 Exposure Time
ExposureMode
Sets the operation mode for the camera’s
1.00 Timed
Timed
The exposure duration time is set using the TDI S tages
sensorTDIStageSelecti on
Selects the number of lines to be imaged
1.00
Exposure Time
exposureTimeSelector
Used to select w here ExposureTime is applied
1.00
Exposure Time
ExposureTime
Sets the exposure time (in microseconds) w hen
1.00
Refreshed exposure time
refreshM easureExposureTi me
Press to displ ay the current exposure time
1.00

Camera Control Feature Descriptions

The follow ing table describes these parameters along with their view attribute and minimum camera firmware version required. Additio n ally th e firmware column will indicate which parameter is a member of the DA LSA Features Naming Convention (DFN C), verses the GenICa m Sta nda rd Features Naming Convention (SFNC not s ho wn). The Device Version number represents the camera softw are functional group, not a firmware revis ion number.
Display Name Feature Description Device
Version
& View
Rate
Rate
measured line rate
Sou r ce
Trigge r Width
1 2 Multi Line Exposure Mode
ON OFF
TriggerWidth
1 2 multiLineExposureMode
ON OFF
when Trigger mode set to internal. Note that any user entered value is
either internal or external source (RO)
the camera by either i nternal or external sources
exposure (or shutter). (RO) Exposure Time feature and the exposure starts
with a LineStart event. Uses the width of th e trigge r signal pulse t o control the e xposure duration.
Single Line Two lines summed together Selects Multi Line exposure mode
F o r independent expos ure control of each line For TDI stage = 1, 2 or A rea mode
Beginner
Beginner
Beginner
Beginner
Beginner DFNC
1.00 Beginner DFNC
Selector All
Top Line Bottom Line
Measured Exposure Time
measured
03-032-20176-06 Teledyne DALSA
All TopLine BottomLine
measureExposureTime Specifies the exposure time provided to the
to. Both lines get equal exposure time
Allows the top li ne to have exposure time set Allows the bottom line to have the exposure time set.
the Exposure M ode feature is set to Timed.
camera by either internal or external source (RO)
provided to the camera.
Beginner DFNC
Beginner
1.00 Beginner
Beginner
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 57
Gain Selector
GainSelector
Selects to which lin e that gain will be a pp lied
1.00
Offset
BlackLevel
C ontrols t he b lack leve l as an ab solute physica l video signal, in DN (digital nu m ber) unit s.
1.00
Device Scan
Area S can
DeviceScanType
AreaScan
Selects mode of operation of the camera between
1.00
Display Name Feature Description Device
Version
& View
Direction Sou r ce
Internal Direction
sensorScanDirectionSource Internal
External sensorScanDirection
Forward Reverse
Direction determined by value of Sen sor ScanD i r ecti on
Direction control determined by value on CC3 When ScanDirectionSource set to Internal, determines the direction of the scan
1.00 Beginner
1.00 Beginner
Syst em Gain Top Line
Bottom Line Gain Gain Sets the selected gain as an amplification factor
Type Li ne Scan
Syst em Gai n TopLine
BottomLine
Li neScan
G ain will b e ap p lied to top and bottom lin es equally G ain will b e ap p lied to the t op line o n ly G ain will b e ap p lied to the bott om line only
applied to the image.
value. This represents a DC offset applied to the
Line sc an mode and Area scan mode
Beginner
1.00 Beginner
Beginner
Beginner
Teledyne DALSA 03-032-20176-06
58 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Turn on the Select which line to

Multi-Exposure Mode

The multi-exposure mode allows for the simultaneous exposure of ea c h line of the sensor with two different exposure ti mes or gains. The result is an increase in the dynamic range of the image.
Multi Line Exposure Mode
control integration time
Note: to initiate multi-exposure mode, set TDI stage = 1 (s tg 1) and ensure that the camera is in line scan mode (dst 0). The exposure time selector (ses) command is used to select which line to apply the exposure time.
Above: image with shorter exposure time.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 59
Above: image with longer exposure time. Otherwise, identical to the first image.
Above: top and bottom images fused.
Teledyne DALSA 03-032-20176-06
60 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Flat-Field Calibration of Image in M ulti-Exposure Mode
Performing a flat-field ca libra t ion while in multi-exposure mode results in th e c amera a u tomatic ally setting both lines of the sensor to the same i ntegrati on time. Both lines w ill 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 prior to the flat-field request.
In the above example the fl at-field target w as set to 200 DN, based on the image on the left-hand side. The integration time for the image on the right wa s automa tica lly set the same as the image on the left during the flat-field process. After the flat-field process had completed, the image on the right-hand side h ad its selected integration time restored to its pre-calibration value, which is why it appears darker than the left side.
Flat-Field Region of Interest
While in multi-exposure mode, setting up a flat-field r egion of interest results the same region of interest coordinates to be a p p lied to both line s.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 61
Multi-Exposure Output Format
While in multi-exposure mode the width of the output w ill double. A 2k camera will output a 4k image with the left half of the image being the bottom line and the right half be ing the top line.
Output AOI when in Multi-Exposure Mode
The same output A OI will be applied to both the top and bottom lines w hile in mult i-exposure mode.
Line Rate
While in multi-exposure mode the maximum line rate available is limited by the l ongest exposure time.
Exposure Time Limitation
The exposure time of the two lines must differ by greater than 1 µs.
Teledyne DALSA 03-032-20176-06
62 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera

Digital I/O Control Featu re D esc riptions

The P4 Digita l I / O cont rol category, as organized by CamExpert, groups together the sensor specific para meters. T h is group include s the controls for line rate, exposure time, scan direction, and gain. Parameters in gray are read-only, either alw ays or due to another parameter being enabled or disabled. Parameters in black are user set in CamExpert or programmable via an imaging application.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 63
Trigger Sour ce
TriggerSou rce
Defines the source of external trigger (RO)
1.00
Trigger Mode
TriggerMode
Determi nes the source of trigger to the camera, internal or
1.00
The follow ing table describes the digital I / O con t rol parameters along with their view attributes and the minim um camera f irmware ve rsion required. Additio nally, the firmware colu mn indic ates which parameter is a member of the DALSA Features N aming Convention (DFNC), verses the GenICam Standa rd Fea tures Naming Conve ntion (SFNC not shown). The Device Version number represents the camera software functional group, not a firmw are revision number.
Display Name Feature Description Device Version
& View
DFNC Beginner
Trigger Selector TriggerSelector Defines what the trigg er initiates (R O) 1.00
DFNC Beginner
external (CC1)
DFNC Beginner

Flat Field Category

The P4 Flat Field controls, as shown by CamExpert, group parameters used to configure camera pixel format, and ima ge cropping . Additionally a feature control to sele ct a nd out put an internal test image simplifies the proc es s of setting up a c amera without a lens. Parameters in gray are read only, either alw ays 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 des cription t able but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
Teledyne DALSA 03-032-20176-06
64 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Mode
flatfieldCorrectionMode
1.00
Off
Off
FPN and flat field c oefficient s disabled.
Beginner
Initialize
Initialize
Res et a ll FPN to 0 and all fla t field
ScanDirectionControlled
ScanDirectionControlled
Different user set loaded

Flat Field Control Feature Description

The follow ing table describes these parameters along with their view attribute and minimum camera firmware version required. Additio n ally th e firmware column will indicate which parameter is a member of the DA LSA Features Naming Convention (DFN C), verses the GenICam Standard Features Naming Convention (SFNC not s ho wn). The Device Version number represents the camera softw are functional group, not a firmware revision number.
Display Name Feature Description Device
On On FPN and flat field coefficients
enabled. coefficie n t s to 1. depending on direction.
Version
& View
DFNC
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 65
Basic
Basic
Direct calculation of coefficients
Low Pass
Low Pass
A low pass filter is first applied to
filter th is algorithm is not a ble to Calibration Target
flatfieldCalibrationTarget
Set a value between 0 and 255 to which the fla t field a lgorith m will taget the image to.
1.00 DFNC
C alib ration Sample Size
flatfieldCalibrationSampleSize
Sets the number of li nes to be
1.00 ROI Offse t X
flatfieldCalibrationROIOffsetX
Set the starting point of a region
1.00
ROI Width
flatfieldCalibrationROIWidth
Sets the w idth of the region on
1.00
Calibrate FPN
flatfieldCalibrationFPN
Initiates the FPN calibration
1.00
Calibrate PRNU
flatfieldCalibrationPRNU
Initiates the PRNU or Flatfield
1.00
Display Name Feature Description Device
Version
& View
Select flatfield Correction Scan Direction Reverse Set
C alib ration Alg orithm flatfieldCorrectionAlgorithm Selection betw een two different
flatfieldScanDirectionReverseSet When flatfieldCorrectionM ode is
set to ScanDirectionControlled this feature selects the UserSEt (1 to8) w hich w ill be used for the reverse scan direction.
flat field algorith ms. based on average line values and
target.
the average line values before calculating the coefficients. Use this a lgorith m if t h e calibration target is not unifo rmly white or it is not possible to defocus the image. Because of the low pass
1.00 Beginner DFNC
1.00 Beginner DFNC
Lines_2048 Lines_4096
Lines_2048 Lines_4096
correct pixel-to-pixel varia tions and so it is preferable to use the “Basic ” a lgorith m .
averaged during a fla t f ield calibration
of interest where a fl at field ca libra t ion will be perfo rmed
interest w here a flat field ca libra t ion will be perfo rmed
process
process
Beginner
Beginner DFNC
Beginner DFNC
Beginner DFNC
Beginner DFNC
Beginner DFNC

Region of Interest (ROI)

The ROI feature is related to flat field calibration. It is important to specify an ROI when the object being imaged has areas that have black, non illuminated areas such as beyond the edge of a film that is front illuminated, or is saturated, again b eyon d the edge of a film but in t his case brig h t f ield back illuminated. The ROI feature allow s from one to four specific regions of the pixel line to be specified w here flat field
Teledyne DALSA 03-032-20176-06
66 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
ca libra t ion will ta k e pla ce. Pix el da ta outside th e ROI will not be used when perfo rmin g flat field calibration.

Image Format Control Category

The P4 Image Format controls, as show n by CamExpert, groups parameters used to confi gure camera pixel forma t, image cropping , an d th e test patte rn. Parameters in gray are read only, either alw ays 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 des cription t able but tagged as Invisible are usually for Te ledyne DALSA or third party software usage—not typically needed by end user applications.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 67
Test P attern
TestImageSelector
Selects th e type of te st ima g e tha t is se n t
the device manufacturer.
1.00 Off Off Selects sensor video to be output from
Ramp
Ramp
Selects a grey scale
Line Mirroring
ReverseX
1.00 Off
Off
Video output in normal order Width
Width
Width of the Image provided by the device (in pixels). (RO)
1.00 Beginner
Max Width
WidthM ax
The maximum image horizontal
1.00
Height
Height
Height of the Image provided by the
1.00
Inp u t Pixel Siz e
pixelSizeInput
Size o f the im ag e input pix els, in bits per
1.00
8 Bits/ Pixel
Bpp8
S ensor output data path is 8 bits per
pixel.
Multiple AOI Mode
multipleAOIMode
Turns o n an output Area of Interest
1.00 Multiple AOI Co un t
multipleAOICount
Set th e number of output area of intere st
1.00

Image Format Control Feature D esc ription

The follow ing table describes these parameters along with their view attribute and minimum camera firmware version required. Additio n ally th e firmware column will indicate which parameter is a member of the DA LSA Features Naming Convention (DFN C), verses the GenICam Standard Features Naming Convention (SFNC not s ho wn). The Device Version number represents the camera software functional group, not a firmware revision number.
Display Name Feature Description Device
Version & View
On
Pixel Format PixelFormat Output image pixel coding fo rmat of the
On
by the camera. Choices are either as defined by SNFC and/ or as provided by
sensor
Video output in a reverse order
sensor.
dimension of the image. (RO)
device (in lines). (RO )
pix el. (RO)
Beginner DFNC
Beginner DFNC
1.00 Beginner DFNC
Beginner
Beginner
DFNC Guru
10 Bits/ Pixel 12 Bits/ Pixel
Off Active
Teledyne DALSA 03-032-20176-06
Bpp10 Bpp12
Off Active
pixel. S ensor output data path is 10 bits per pixel. S ensor output data path is 12 bits per
Area of interest is off Area of interest is on
1-4
Beginner DFNC
Beginner DFNC
68 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Multiple AOI Selector
multipleAOISelector
Selects the area of interest to be setup
1.00 DFNC
AOI Offse t X
multipleAOIOffsetX
Set the start of area of interest (pixels)
1.00
AOI Width
multipleAOIWidth
Set th e width of are a o f interest (pixels)
1.00
B inning Vertical
BinningVertical
This feature represents the number of vertical photo-

Binning

B inning is the co mbining of two or more image senso r pixels to form a new combined pixel. A binne d image using the same exposure settings as a non-bin ne d im ag e will show an improved signal-to-noise ratio, reduced scanning times (due to low er spatial resolution) and save as a smaller image file size compared with a non-binned image, at the expense of lower image resolution.
In 2 x 2 binning, 4 physical pixels on the sensor are combined into one image pixel. This oper ating mode is ideal for applications that require faster acquisition and processing times and require greater signal collection.
For this camera, the default binning value is 1 x 1, The Binning Vertical and B inning Horizontal features in the Image Format Control set represents the
number of horizontal pixels that will be combined (added) together. Note: Compared to running the camera in TDI stages = 2, running the camera in 2 x 2 binning mod e will
result in 4x res p onsivity, not 2x. Any increase in output due to binning is relative to a single sensor line (TDI stag e = 1 ).
Image Format Control
Beginner
Beginner
Beginner DFNC
Display Name Feature Description
B inning Horizontal BinningHorizontal This feature represents the number of horizontal photo-
03-032-20176-06 Teledyne DALSA
sensitive cells that must be combi ned (added) together: 2. Note: TDI stages must be set to 1 before vertical binning
can be changed to 2x.
sensitive cells that must be combi ned (added) together.
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 69
Figure 25: 2x2 Binning in Area Mode

Area of Interest (AOI) Setup

The A rea of Interest (AOI) feature can be used to reduce the amount of image-data output from th e camera. Use this feature when there are areas in the image that c o ntain unneede d information.
An example w here you w ould use this feature is in an application that is inspecting several separated lanes of objects w ith one camera and the image between the lanes can be ignored.
The A OI feature allow s from one to four specific areas of the pixel line to be specified where image data will be output. Since the AOI feature reduces the amount of data output, this has the additiona l benefit of allow ing the cameras to operate at higher EXSYNC ra tes when using base or medium camera link modes.
For example, in the 4k camera model, if the total num ber of pixels fo r t h e specified AOI`s is les s than 1 K whe n using base Camera Link mode at 85 MHz, th e ma ximum E XSYN C rate can be 100 kHz; versus 41 kHz if all 4 K pixels we re output.
Note: The setup of A OI is always w ith respect to the sensor. Therefore, if you are using the mirroring mode w ith AOI, be aware that pixel one will be on the right side of the displayed image.

In order to set up an AOI for the camera:

1. The AOI mode must first be in the off position.
2. Use the A OI Count to select the total number of A OIs desired to a max of 4.
3. To set up each A OI individually use the AOI Selector to point to the A OI to be set up.
4. AOI O ffse t X is use d indica te the start in g pixel of th e AOI.
5. AOI Width is used to indicate the width of the AOI.
Teledyne DALSA 03-032-20176-06
70 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
4. Select beginning of selected area
3. Select area to
2. Set up the number of
1. Must be off to
set up the AOI.
set up.
AOI desired to max of 4.
selected area
5. Se t up width of
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 71
Once al l AOI are set

In order to initiate operation of the AOI once setup:

1. The AOI mode must be changed to A ctive.
2. Be sure to set the frame grabber image width to the sum of all AOI w idths set up in the camera.
up change to active.
Teledyne DALSA 03-032-20176-06
72 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
First, setup parameters for the

Instructions on Using the Camera Scan Di rec ti on to Control Camera Parameters

The camera is capable of adjusting camera parameters on-the-fly base d on the scan dire ction of the camera. These parameters include gain, flat field coefficients, w hite balance and exposure time.
1. The first step is to put the camera in the reverse direction. This can be done using a reverse s ignal through CC3 and the Direction Source set to exte rnal or by ha ving the Dire ction Source set to Internal and the Internal Direction set to reverse.
2. Set up all the desired param eters , including fla t f ield correct ions.
reverse directi on.
3. S ave the camera parameters to a User set other than the default user set.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 73
Setup parameters for fo rwa rd
Save to a user set choice.
4. The next step is to put the camera in the forward dire ction. This ca n b e done using a forward signal through CC 3 and the Direction Sourc e s et to external or by having the Direction Source set to Internal and the Internal Direction set to forward.
5. S et up all the desired parameters including doing a flat field.
direction.
6. S ave the camera set to User S et other than the saved to for the reverse direction. The forward
Teledyne DALSA 03-032-20176-06
direction user set and the default user set must be the same.
74 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Save to a different user Forwa rd d irection u se r set and default user
Set the Flat Field mode to
set must be the same.
set than the one selected for reverse direction.
In the Flat Field area change the mode to Scan Direction Controlled.
Scan direc t ion C ontrolle d .
A Note on External Direction, Direct ion S our c e, and User Sets
If us ing external direction co ntrol through CC3 ensure th at the Directio n Source is both set to e x ternal and saved in the user set. A lso ensure that the pol arity on CC3 is set appropriately for the desired direction.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 75

Transport Layer Co ntrol Category

Parameters in gray are read only, either alw ays 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 des cription t able but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.
Teledyne DALSA 03-032-20176-06
76 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Restart Camera
DeviceReset
Used to restart the camera, warm
1.00
XML Major
DeviceM anifestXM LM ajorVersion
Together with
1.00
XML Mi nor
DeviceM anifestXM LM inorVersion
Together with
1.00
Last GenCP Status
gen CPSt at us
If a feature read or write fails then
Reading this feature clears it
1.00
Refresh GenCP
refreshGenCPStatus
Pres s to return the curre n t status of
1.00
Camera Link
ClConfiguration
Camera Link Output configuration
1.00 Camera Link
clDeviceClockFrequency
Set the camera link clock rate
1.00 Tap Geometry
DeviceTapGeometry
(RO)
1.00

Transport Layer Feature Descriptions

The follow ing table describes these parameters along with their view attribute and minimum camera firmware version required. Additio n ally th e firmware column will indicate which parameter is a member of the DA LSA Features Naming Convention (DFN C), verses the GenICa m Sta nda rd Features Naming Convention (SFNC not s ho wn).
Display Name Feature Description Device
Version & View
Version
Version
Status
Configuration
Base Medium Full Deca
reset
DeviceM anifestXM LM inorVersion specifies the GenICam™ feature desc r ipt ion X ML file version (RO)
DeviceM anifestXM LM ajorVersion specifies the GenICam™ feature desc r ipt ion X ML file version (RO)
S apera only returns that it fa ils – read this feature to get the actual reason for the failure Returns the last error
the GenCP
Beginner DFNC
Beginner DFNC
Beginner DFNC
Beginner DFNC
Beginner
Beginner
Configuration

Acquisition and Transfer Control Category

The P4 Acq uis ition and Transfe r controls, a s s ho wn by Ca mExpert, groups para meters used to configure the optional acquisition modes of the device. Parameters in gray are read only, either always or due to another parameter being disabled. Parameters in black are user set in CamExpert or progr ammable via an imagin g a p p lication .
03-032-20176-06 Teledyne DALSA
CL85M H z CL66M H z
Beginner
Beginner
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 77
Device
DeviceRegistersStreamingStart
Announces the start of registers streaming
1.00
Device Streaming End
DeviceRegistersStreamingEnd
Announces end of reg isters streaming a nd consistency before activating them.
1.00 DFNC
Check Stream
DeviceRegistersCheck
Press to check the validity of the current
1.00
Registers Valid
DeviceRegistersValid
States if the curre n t register se t is va lid
1.00
Features listed in the des cription t able but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.

Acquisition and Transfer C ontrol Feature Descrip tions

The follow ing table describes these parameters along with their view attribute and minimum camera firmware version required. Additio n ally th e firmware column will indicate which parameter is a member of the DA LSA Features Naming Convention (DFNC), versus the GenICam Standard Features Naming Convention (SFNC not s ho wn).
Display Name Feature Description Device
Version & View
Registers Str eami ng St ar t
Registers
Validity
without immediate checking for consistency.
perfo rm s valida t ion fo r registers
register set.
a nd consiste nt.
Beginner DFNC
Beginner
Beginner DFNC
Beginner DFNC
Teledyne DALSA 03-032-20176-06
78 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Baud Rate
DeviceSerial PortBaudRate
Sets the baud rate used by the selected
1.00
Baud 9600
Baud 9600
Baud rate is 9600

Serial Port Control Category

The Serial Port control in CamExpert allow s the user to select an available camera serial port and review its settings. This section also describes the Genie TS Framew ork Virtual Serial Port Driver and the use of the Genie TS serial port as an interface from an Ethernet network to a s erial port control s ystem for other devices. Features listed in the des cription t able but tagged as Invisible are usually for Teledyne DALSA or third party software usage—not typically needed by end user applications.

Serial Port Control Feature D esc riptions

The Device Version number represents the camera softw are functional group, not a firmware revision number.
Display Name Feature Description View
Baud 19200 Baud 57600 Baud 115200 Baud 230400 Baud 460800 Baud 921600
Serial Port Pa rity deviceSerialPortParity Sets the parity checking type on the selected
03-032-20176-06 Teledyne DALSA
Baud 19200 Baud 57600 Baud 115200 Baud 230400 Baud 460800 Baud 921600
device’s serial port. A vailable baud rates are device-specific.
Baud rate is 19200 Baud rate is 57600 Baud rate is 115200 Baud rate is 230400 Baud rate is 460800 Baud rate is 921600
seria l port. (R O)
Beginner DFNC
1.00 Beginner
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 79
None
None
Parity c he cking is disabled
DFNC
Eight Bits
bpc8
Use 8 bits per character
Stop Bits
deviceSerialPortN umberOf StopBits
Sets the number of stop bits to use.
1.00 Stopbits1
Stopbits1
Use 1 stop bit
Display Name Feature Description View
Data Size deviceSerialPortDataSize S ets the bits per character (bpc) to use (RO). 1.00
Beginner DFNC
Beginner DFNC

File Access Control Category

The File Acc ess con t rol in CamE xpert a llows the user to quic k ly u pload various data files to the connected 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 des cription t able but tagged as Invisible are usually for Teledyne DALSA o r th ird party software usage—not typically needed by end user applications.
Teledyne DALSA 03-032-20176-06
80 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
File Selector
FileSelector
Selects the file to access. The file types w hich
1.00
FPGA Code
Firmware1
Upload new FPGA to the c amera which will
DFNC
Micro Code
Upload new micro codeto the ca mera which
CCI
Uploa d new CC I to the camera which will
XML
Uploa d new XML to the ca mera which will
User Set
Use UserSetSelector to specify which user set to access.
Factory FlatField
Use UserSetSelector to specify which user
User FPN
Use UserSetSelector to specify which user FPN
CameraData
Download camera information and send for
File Operation S elector
FileOperationSelector
Selects the target operation for the selected file
1.00 Open
Open
Select the Open operation - executed by
Close
Close
Select the Close operation - executed by
Read
Read
Select the Read operation - executed by FileOperationExecute.
Delete
Delete
Select the Delete operation - executed by
File Operation Execute
FileOperationExecute
Executes the operation selected by File
1.00
File Open Mod e
FileOpenMode
Selects the access mode used to open a file on
1.00 Read
Write
Read Write
Select REA D only open mode Select WRITE only open mode
File Access Buffer
FileAccessBuffer
Defines the intermediate access buffer that
1.00 File Access Offset
FileAccessOffset
Controls the mapping offset betw een the
1.00
File Operation Stat us
FileOperationStatus
Displays the file operation execution status. (RO).
1.00 Guru

File Access Control Feature D escriptions

Display Name Feature Description View
coefficients
are accessible are device-dependent. execute on the next camera reboot cycle.
will execute on the next camera reboot cycle. execute on the next camera reboot cycle. execute on the next camera reboot cycle.
flatfield to acce ss . to access. customer support.
in the device. This operation is executed when the File Operation Execute feature is called.
FileOperationExecute. FileOperationExecute.
Beginner
Guru
Write Write Select the Write oper ation - executed by
File Access Length FileAccessLength Co ntrols the ma pping le ng th between the
03-032-20176-06 Teledyne DALSA
FileOperationExecute. FileOperationExecute.
Operation Selector on the selected file.
the device.
allow s the exchange of data betw een the device file sto rag e and the applicatio n.
device file storage and the file access buffer.
device file storage and the file access buffer.
Guru
Guru
Guru
Guru
1.00 Guru
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 81
Success
Success
The last file operation has completed
Failure
Failure
The last file operation has completed
File Unavailab le
FileUnavailable
The last file operation has completed
File Invalid
FileInvalid
The last file operation has completed
File Operation Resul t
FileOperationResult
Displays the file operation result. For Read or read/ w ritten bytes is returned. (RO)
1.00 File Size
FileSize
Represents the size of the selected file in bytes.
1.00
Display Name Feature Description View
successfully. uns uccessfully for an unknown reas o n. unsuccessfully because the file is currently
unavailable. unsuccessfully because the selected file in not
present in this camera model.
Write operations, the number of successfully

File Access via the CamExper t T ool

1. Click on the “Setting…” button to show the file se lection me nu.
Guru
Guru
2. From the Type drop menu, select the file type that w ill 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.
Teledyne DALSA 03-032-20176-06
82 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
4. C lick the Browse button to open a typ ical Windo ws Explo rer window.
5. S elect the specific file from the system drive or from a network loc ation.
6. Click the Upl oad button to execute the file transfer to the camera.
7. Note that firmware changes require a device reset command from the Camera Information Controls and, additionally, CamExpert should be shut dow n and restarted following a reset.

Download a List of Camera Para meters

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. C lick on Se t tings
3. In the “Type” drop down box select “ Miscellaneous.”
4. In the “ File selector ” drop dow n box select “ CameraData.”
5. Hit “Download”
6. S ave the text file and send the file to Teledyne DA L SA customer support.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 83
Teledyne DALSA 03-032-20176-06
84 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera

Appendix B: ASCII Commands

The following co mmands can be used to control the Teledyne DA LSA Piranha4 cameras.

Accessing the Three Letter Commands (TLC)

To access the TLC an ASCII-based communications interface application, such as HyperTerminal. Additio n ally it is pos sible to u se the functio ns of clserxxx.dll or clallserial.dll as defined in
the Camera Li nk S pecification.
Figure 26: Serial DLL hierarchy as mentioned in the Camera Link Specification
1. Cycle power to the camera: by either a) issui ng the reset camera command (rc), or b) powe ring the camera OFF and then ON.
2. Lo ad the ASCI I in terface using:
9600 baud
8 data bits
no parity
1 stop bit
no flow control
local echo
(carriage return / linefeed)
3. Wait for a stable status LED color (green or red) before proceeding. Note that all entries in HyperTe r min al will be ign ored until a stable LED colo r is obta ine d.
4. In case of HyperTerminal, press the <ESC> key.
5. Once <ESC> has been entered the help screen appears.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 85
Note th at the HyperTerminal application is not a vailable on the Windows 7 OS.

Notes on Using Alternatives to HyperT er m inal

If you are using interfaces other than H yperTerminal, the A SCII character, ESC, is decimal 27 and needs to be issued. From the command line insert ESC by using A LT+2+7 of the activated Num­Pad. In some cases this needs to be follow ed by a carriage return or a linefeed to send this to the camera.
In ASCII the ESC character may look like this: “←”.

ASCII to GenCP

To switch from the ASCII-command interface to the GenCP interface, the camera must be either reset (RC) or the pow er must be cycled. N ote that GenCP and A SCII commands cannot be accessed simultaneously.
Alternatives to HyperTerminal
The follow ing alternative A SCII-interfa ces ha ve been tested and sho wn to work with this camera: PuTTY and TeraTerm. N ote that PuTTY does not have Xmodem capability w hile TeraTerm does. Xmoden is required to update code in the camera.
The camera responds to a simple A SCI I -based protocol. A carriage return <CR> ends each command.
Example: to re tur n the current dete ctor settings
gcp <CR> A complete list of the available detector commands, their format and parameters can be displayed by
sending the help (h) command.

Port Configuration

Baud: 9,600 Bits: 8 Parity: None Stop bits: 1 Flow Control: None
Echo typed characters locally.

Rules

The interface is not case sensitive
One command and argument(s) pe r line
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 w ith the carriage return character – 0x0D
Teledyne DALSA 03-032-20176-06
86 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Argument(s)
# of lines to average
4096
Description
C alib rate use r FPN dark flat field c oeffic ients
Argument(s)
Frequency
0. 85 MHz
Description
Camera Link clock frequency
Argument(s)
Mode
0. Base
3. Deca (4K only)
Description
Camera Link Mode

Disabling the 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 A SCII 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. Note: access to GEN CP is no longer available with the Esc key disabled unless a DEK 0 command is issued and the camera re-booted.

Commands

Full Na me Calibrate User FPN Mnemonic CCF
2048
Full Na me Camera Link Speed Mnemonic CLS
Full Na me Camera Link M ode Mnemonic CLM
1. 66 MHz
1. Medium
2. Full
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 87
Argument(s)
Algorithm
0. Basic
1. Low-pass Filter
# of lines to average
Target
0 to 4095 DN in 12 bit mode
Description
Calibrate user PRN U flat field coefficients
Notes
With filt er algorithm this average line is then smoothed and outlier pixels a r e
Coefficients are saved and loaded with user set (e.g. USS / USL)
Argument(s)
Mode
0. Esc key is enabled
1. Esc key is disa bled
Description
Allow the use of the Esc key to be disabled so that upon boot-up the camera will directly enter
Argument(s)
Mode
0. Li ne Scan
Description
Use this command to sw itch betw een A rea and Single Line modes.
Notes
Full Na me Calibrate Flatfield Mnemonic CPA
2048
4096
0 to 1023 DN in 10 bit mode 0 to 255 DN in 8 bit mode
Perform flat field calibration using the average of <# lines>.
interpolated. Use this feature if your white reference is not featureless.
Adjust pixel gain such that o utput will be <target>.
The ta rget is first divide d by horizontal binning factor and gain and then the
offset is subtracted. Therefore the output w ill go to the target.
Because the PRN U can be l ess than 1, the target may be below the current maximum va lue.
Full Na me Disable Esc Key Mnemonic DEK
the ASCII command mode. With the Esc key disabled the GENCP cannot be accessed.
Notes
Full Na me D evice Scan Type Mnemonic DST
To access the GenCP, you have to first issue the DEK 0 command in order to enable the ESC key. Then reboot the camera.
STG must equal 1 to enter the area mode DST = 1
1. Area S can
Teledyne DALSA 03-032-20176-06
88 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Argument(s)
Mode
0. Disable use of u se r FPN and PRNU flat field
Description
Set flat field mode
Notes
Argument(s)
User Set N umber
1 to 8
Description
Set scan direction controlled reverse set
Notes
Full Na me Flatfield Mode Mnemonic FFM
correction coefficients
1. Enable use of user FPN and PRNU flat field correction coefficients
2. Reset user FPN coefficients to zero and user PR NU coefficients to on e
3. Sc an direction co n t rolled use r set loading
Full Na me Set Flatfield Scan Direction Reverse Set Mnemonic FRS
03-032-20176-06 Teledyne DALSA
Argument(s)
Description
Display current value of camera configuration parameters
Notes
USER>gcp
CPA ROI 1-2048
Mnemonic
GET
Argument(s)
<’par ameter>
Description
The “ get” command displays the current val ue(s) of the feature specified in the string
command.
Notes
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 89
Full Na me Display Ca mera Co nfigura tion Mnemonic GCP
Model P4_CM_02K10D_00_R Microcode 03-081-20296-96
CCI 03-110-20294-96 FPGA 03-056-20470-97 Serial # S1050616 BiST: Good
DefaultSet 0 Ext Trig Off Line Rate 10000 [Hz] Meas L.R. 10000 [Hz] Max L.R. 19607 [Hz] Exp. Mode Timed Multi Exp. Mode Off Exp. Time[0] 50000 [ns] Meas E.T.[0] 50000 [ns] Max E.T. 99000 [ns]
Test Pat. 0:Off Direction Internal, Forward TDI Stages 1 Vert. Bin 1 Hor. Bin 1 Flat Field Off Offset 0 System Gain 1.00 Mirror Off AOI Mode: Off Scan Type Line Scan CL Speed 85MHz CL Config Full Pixel Fmt 8 bits
Full Na me Get V alue
parameter. N ote that the parameter is preceded by a single quote “ ’” . Using this command will be easier for control software than parsing the output from the “gcp”
Teledyne DALSA 03-032-20176-06
Argument(s)
Description
Display list of three letter commands (2 K help scre en s ho wn)
Notes
USER>h
3:Scan direction
vv - Input Voltage
90 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full Na me H elp Mnemonic H
P4 (03-081-20296-96): Command Line Interpreter Jul 16 2013, 07:49:58
ccf - Calibrate User FPN <2048|4096> cls - Camera Link Speed <0 - 85MHz, 1 - 66MHz> clm - Camera Link Mode <0:Base 1:Med 2:Full> cpa - Calibrate Flatfield <0:basic 1:filter><2048|4096><DN target> dek - disESC esc key <0/1> dst - Device Scan Type <0 - Line Scan, 1 - Area Scan> ffm - Flat Field Mode <0:Off 1:On 2:Initialiaze controlled> frs - Set Flatfield Scan Direction Reverse Set <set 1-8> gcp - Display Camera Configuration get - Get value '<string> h - Help lpc - Load Pixel Coefficients <set 0-8> rc - Reset Camera roi - Set Flatfield ROI <1st pixel> <last pixel> rpc - Reset Flatfield Coefficients sac - Set AOI Count <value 1-4> sad - Set AOI Selector, Offset and Width <selector 1-AOI Count> <1st pixel> <width >= 40> sam - Set AOI Mode <1-enable, 0-disable> sbh - Horizontal Binning <1|2> sbr - Set Baud Rate <9600|57600|115200|230400|460800|921600> sbv - Vertical Binning <1|2> scd - Direction <0:Fwd, 1:Rev 2:Ext> sem - Exposure Mode <0:Int 1:Ext> ses - Set Exposure Selector <0:All, 1: Bottom, 2: Top> set - Exposure Time <ns> sme - Set Multi Exposure mode <0:Off 1:On> smm - Mirroring <0:Off 1:On> spf - Pixel Format <0:8 bits 1:10 bits 2:12 bits> ssb - Offset <DN> ssf - Internal Line Rate <Hz> ssg - Gain <0:System 1:Bottom Line 2:Top Line> f<gain> stg - TDI Stages <1|2> stm - External Trigger <0:Off 1:On> svm - Test Pattern <0, 1, 3-6> usd - Default User Set <0-8> usl - Load User Set <0-8> uss - Save User Set <1-8> vt - Temperature
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 91
Argument(s)
Set selector
0. Factory set
Description
Load user set
Notes Argument(s)
Description
Resets the camera to the saved user default settings. These settings are saved usi ng the usd command.
Notes
The micro-controller re boots:
Baud rate set to 9600
Argument(s)
First pixel
1 to 2048 (2K)
Last pixel
1 to 2048 (2K)
Notes
Last pixel must be greater than or equal to first pixel
Description
Reset all user FPN values to zero and all user PRNU coefficients to one
Notes
Full Na me Load P ixel Coefficie nts Mnemonic LPC
1-8. User sets
Loads FPN coefficients and PRN U coefficients from a user set ( only coefficeints, no other camer a parameters)
Full Na me Reset Camera Mnemonic RC
Load any file updates
Clear over temperature condition
Perform start up camera tests (BiS T)
Lo ad FP GA c ode
Co nfigure FPG A and senso r.
Lo ad default user se t
Full Na me Set Flatfield ROI Mnemonic ROI
Description
Full Na me Reset Flatfield Coefficients Mnemonic RPC
Argument(s)
1 to 4096 (4K)
1 to 4096 (4K)
Fla t f ield re gion of interest
Spec ifies the pix els t h at CCF and CPA will ca libra te
o Pixel coeffic ients ou tside this region are not c hanged
Teledyne DALSA 03-032-20176-06
92 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Argument(s)
Number of AOI’s
1 to 4
Description
Set A OI Counter
Notes
Argument(s)
Selector
1 to 4
Offset
1 to AOI Count – any pixel can be starting pixel
Width
No less than 40 pixels
Description
Define an A OI
Notes
Argument(s)
Mode
0. O ff / Disa ble
Description
Set A OI m od e
Notes
Argument(s)
Binning
1. Sing le pixel
Description
Set horizontal binning
Notes
Argument(s)
Baud rate
9600
921600*
Description
S et baud rate
Notes
Full Name Se t AOI Count Mnemonic SAC
Full Na me Set AOI Selector Mnemonic SAD
Must not overla p with an already exis ting AOI
Full Na me Set AOI M ode Mnemonic SAM
Full Na me Set Binning Horizonta l Mnemonic SBH
Ava ilab le in all modes: single line, TDI and Are a
Full Na me Set Baud Ra te Mnemonic SBR
1. Ac t ive / Enable
2. B inning of 2 pixe ls
57600 115200 230400* 460800*
Send command and the n change speed of Hype rTerminal
A Px8 or equivalent frame grabber is required in order to achieve these baud
rates.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 93
Argument(s)
1. Sing le pixel
2. B inning of 2 pixe ls
Description
Set vertical binning
Notes
Argument(s)
Direction
0. Forward
Description
Set sensor scan direction
Notes
Description
Set exposure selector- when in multi exposure mode (see SME command) the exposure
Notes
When no t in multiple exposure mode “ All” is only selection
Notes
Full Na me Set Binning Vertic al Mnemonic SBV
Must be in Single line mode (stg 1)
Must be in Line scan mode (dst 0)
Full Na me Direction Mnemonic SCD
1. Reverse (not available in single line mode)
2. External – controlled by CC3 signal (not ava ilab le in single line mod e)
Full Na me Set Exposure Selector Mnemonic SES
Argument(s)
Mode 0. All
time for the top and bottom lines can be set independently
Full Na me Exposure M ode Mnemonic SEM
Argument(s)
Description
Mode 0. Internal (“ Timed” )
Set exposure time mode
In internal mode the exposure time is controlled by the SET command
In external mode the sensor is exposed w hile CC1 signal is high
External mode i s only available w hen the trigger mode is also external (STM 1)
SEM 1 overrides internally generated independent exposure times
When C C1 signal falls line is read
1. Bottom
2. Top
1. External (“PulseWidth”)
Teledyne DALSA 03-032-20176-06
94 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Argument(s)
Exposure time
1, 000 to 3, 000, 000 [ns]
Description
Set internal exposure time in nanoseconds – 25 ns resolution
Notes
Argument(s)
Mode
0. Off
1. Multi-Exposure On
Description
Set multi-exposure mode allow ing each line to have independent exposure times and gains.
Notes
Argument(s)
Mode
0. Off
1. Image is flipped on t he vertic al axis
Description
Set mirroring mode
Notes
Description
Set pixel format
Notes
Argument(s)
Offset
8 bit
-32 to 31
Description
Set con trast offse t – single va lu e ad ded to all pix els after PR NU/ flat field c oeffic ients
Notes
Full Na me Exposure Time Mnemonic SET
Line time > ( Exposure ti me + 1,500 ns )
Full Na me Set Multi-Exposure (2K only) Mnemonic SM E
Full Na me M irroring Mnemonic SM M
Full Na me Pixel Format Mnemonic SPF
Argument(s)
Selector 0. 8 bits
Full Na me Offset Mnemonic SSB
(before gain).
Range changes depending on pixel for mat (SPF)
1. 10 bits
2. 12 bits (only availa ble with Base o r Medium Camera Link configurations)
10-bit 12-bit
-128 to 127
-512 to 511
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 95
Argument(s)
Line rate
1 to 100, 000 [H z] (TDI mode) 1 to 200, 000[Hz}] (Area mode)
Description
Set internal li ne rate i n Hz
Notes
Argument(s)
Selector
0. System Gai n
2. Top Line
Gain
1.0 to 10.0
Description
S et gain as a single value multiplied by all pixels.
Notes
Argument(s)
Selector
TD I stage
1. Sing le line mode (lower se n sitivity).
Description
Notes
Full Na me I nternal Line Rate Mnemonic SSF
Line time > ( Exposure ti me + 1, 000 ns )
Full Na me Gain Mnemonic SSG
1. Bottom Line
When no t in multiexposure mo de Sys tem gain in only a va ilable
Floating point number: 1.0 to 10.0.
Note that gain value must be preceded by an “ f” (e.g. ssg 0 f1.5)
Full Na me Set TD I Stages Mnemonic STG
Notes
In single line mode the camera must be internal direction control
TD I m ode: a pair o f lines summed with suitable dela y
Full Na me External Trigger Mnemonic STM
Argument(s)
Description
Mode 0. Internal
Set trigger mode
In internal mode lin e rate is controlled by SSF co m mand
In external mode readout starts on falling edge of CC1 signal and is available
only when STM = 1 (external trigger on)
Exposure time equals high time of EXSYNC on signal on CC1
2. TDI mode (highe r sensitivity)
1. External
Teledyne DALSA 03-032-20176-06
96 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Argument(s)
Mode
0) Sensor V i deo
Description
Select test pattern
Notes
When a test pattern is select ed a ll digita l p roce ss ing ( e.g. flat field, gain) is
Argument(s)
Set selector
0. Factory set
Description
Select user set to load when camera is reset
Notes
The settings include all those listed by the GCP command plus the user FPN coefficients, and user PRN U coefficients
Argument(s)
Set selector
0. Factory set
Description
Load user set
Argument(s)
Set selector
1 to 8
Description
Save user set
coefficients, and user PRN U coefficients
Argument(s)
Notes
Full Na me Test Pattern Mnemonic SVM
1) Ramp
3) A5
4) Each_tap_fixed
5) All_1365
6) All_1
disabled – it is re-enabled w hen sensor video i s selected
Full Na me D efault User Set Mnemonic USD
1-8. User sets
Full Na me Load User Set Mnemonic USL
Notes
Loads and makes current all the setti ngs listed by the GCP command plus the user FPN coefficients, and user PRN U coefficients
Full Na me Save User Set Mnemonic USS
Notes
Saves all the current settings listed by the GCP command plus the user FPN
Full Na me Temperature Mnemonic VT
1-8. User sets
Description
Display internal temperature in degrees Celsius
Measured with an accuracy of ± 1.5 ºC.
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 97
Argument(s)
Description
Displa y supply volta ge
Notes
Full Na me V oltage Mnemonic VV
Measured with an accuracy ± 0.1 V.
Teledyne DALSA 03-032-20176-06
98 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
I2C error
1
Unable to configure fpga
10
Unable to configure fpga
100
EXT_SRAM Failure
1000
ECH O_BACK Failure
1,0000
FLA SH _TIM EOUT
10,0000
FLASH_ERROR
100,0000
NO_COMMON_SETTINGS
1,0000,0000
NO_FACTORY_SETTINGS
10,0000,0000
N O_U SER_SETTI N GS
100,0000,0000
NO_FLA T_FIELD Corrections
1000,0000,0000
NO MISC corrections
1,0000,0000,0000
NO_F PN Corre ction
10,0000,0000,0000
NO_F PN Corre ction
100,0000,0000,0000
NO_P R NU Correction
1000,0000,0000,0000
NO_F E ED Through Correction
1,0000,0000,0000,0000
NO_LINEARITY Correct ion
10,0000,0000,0000,0000
SYN C_ERROR
100,0000,0000,0000,0000
OVER_TEM PERATURE
1000,0000,0000,0000,0000
SPI Fai l u r e
1,0000,0000,0000,0000,0000
N O_U SER_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

Appendix C: Error and Warning Messages

BiST: Built in Self Test The BiST erro r flags are binary fla g s with each bit being inde pende nt from each o ther. The message from the B iST shou ld be “G ood” meaning everything is functioning correctly bu t if a ha rd ware fa ilu re does occur in the camera one or more these flags could be set. Any of these errors will result in the sta t us light turning red.
Definition BiST Flag
NO_FPGA_Code 1000,0000
03-032-20176-06 Teledyne DALSA
Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 99
0X8002
Invalid Parameter
0xC01C
CPA _TOO_MA NY_OUTLIERS
0x401E
USER_FPN_CLIPPIN G
0x401F
FLA T_FIELD_CLIPPIN G

Operational Error Codes

Code Description
Teledyne DALSA 03-032-20176-06
100 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera

Appendix D: Quick Setup and Image Acquisition

If yo u are familiar with the operation of Camera Link cameras and have an understanding of imaging fundamentals, the following s te ps will show you how to quickly set up this camera a nd begin acquiring images.

1. On Power-Up

The camera has been calibrated and configured at the factory to be ready for your evaluation when first pow ered up. The default conditions are set as follow s:
System gain is set to the low est v alue of one.
Fla t f ield calib ration is not active a s this feature is depe ndent on your light s o urce a nd lens.
Line rate and exposure time are set to for internal generation by the camera.
Camera Link mode is set to the standard 8-bit full mode which allows operation of up to 100 kHz
line rate. Set your Camera Link frame g rab be r u p t o re ceive the standard 8 -bit fu ll m ode.

2. Communicating with the Camera

The camera i s designed to pow er up w ith a GenICam-compliant interface.
CamExpert provides an easy-to-use GUI that can be used to set up and eval uate the camera.
The camera also comes with Teledyne DALSA’s three letter command (TLC) interface option,
which can be accessed usi ng a suitable terminal program such as HyperTerminal™.
If you w ant to use the TLC interface, press the ‘Esc’ key w hile using a terminal program only after the LED indicator on the camera turns green. N ote that the camera defaults to 9.6 KBaud when first pow ered up.
On receiving the ‘Esc’ character, the camer a will output a list of the available TLC commands. You can then proceed to enter TLC commands as required.
Ente r ‘h’ at a ny time to get the lis t of commands from the camera.
Enter the ‘gcp’ command at any time to get the current setup conditions of the camera.
03-032-20176-06 Teledyne DALSA
Loading...