Download P4-CM-08K070 Manual

Piranha4
P4-CM-08K070-00-R
Monochrome Camera User’s Manual
27 June 2012
03-032-20133-01
www.teledynedalsa.com
2
Piranha4 8K Camera User's Manual
© 2012 Teled yne DALSA, Inc. All inform ation provid ed in this m anual is believed to be accurate and reliable. No responsibility is
assum ed by Teled yne DALSA for its use. Teled yne DALSA reserves the right to make changes to this inform ation w ithout notice.
Reprod uction of this manual in whole or in part, by any m eans, is prohibited w ithout prior perm ission having been obtained from
Teled yne DALSA.
About Teledyne Technologies and Teledyne DALSA, Inc.
Teled yne Technologies is a lead ing provid er of sophisticated electronic subsystem s, in strum entation and com m unication prod ucts,
engineered system s, aerospace engines, and energy and pow er generation system s. Teled yne Technologies’ operations are prim ari ly
located in the United States, the United Kingdom and Mexico. For more inform ation, vis it Teled yne Technologies’ w ebsite at
w w w.teled yne.com.
Teled yne DALSA, a Teled yne Technologies com pany, is an international lead er in high performance d igital im aging and
sem icond uctors w ith approxim ately 1,000 em ployees world w id e, headquartered in Waterloo, Ontario, Canad a. Established in 1980,
the com pany d esigns, develops, manufactures and markets d igital im aging prod ucts and solutions, in add ition to provid ing MEMS
prod ucts and services. For more inform ation, visit Teled yne DALSA’s w ebsite at ww w .teled ynedalsa.com .
Support
For further inform ation not includ ed in this manual, or for inform ation on Teled yne DALSA’s extensive line of im age sensing
prod ucts, please contact:
North America
Europe
Asia Pacific
605 McMurray Rd
Waterloo, ON N2V 2E9
Canad a
Tel: 519 886 6000
Fax: 519 886 8023
w w w.teled ynedalsa.com
sales.am ericas@teled ynedalsa.com
support@teled ynedalsa.com
Breslauer Str. 34
D-82194 Gröbenzell (Munich)
Germ any
Tel: +49 - 8142 – 46770
Fax: +49 - 8142 – 467746
w w w. teled yned alsa.com
sales.europe@teled ynedalsa.com
support@teled ynedalsa.com
Ikebukuro East 13F
3-4-3 H igashi-Ikebukuro
Toshim a-ku, Tokyo 170-0013
Japan
Tel: 81 3 5960 6353
Fax: 81 3 5960 6354 (fax)
w w w .teled ynedalsa.com
sales.asia@teled yned alsa.com
support@teled ynedalsa.com
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
3
Contents
1. System Precautions and Cleaning ___________________________________________________________________ 5
Precautions ..................................................................................................................................................... 5
Electrostatic Discharge and the CMOS Sensor ................................................................................................. 5
Protecting Against Dust, Oil, and Scratches .................................................................................................... 5
Cleaning the Sensor Window .......................................................................................................................... 6
2. The Piranha4 Camera ___________________________________________________________________________ 7
Camera Highlights ............................................................................................................................................................. 7
Camera Performance Specifications .................................................................................................................................. 8
Certifications and Compliance ........................................................................................................................................... 9
Supported Industry Standards ........................................................................................................................................... 9
Responsivity ....................................................................................................................................................................... 10
FPN Characteristics with Temperature .............................................................................................................................. 10
Mechanicals........................................................................................................................................................................ 11
Camera Mounting and Heat Sink Considerations ........................................................................................... 12
3. Software and Hardware Setup______________________________________________________________________ 13
Recommended System Requirements ............................................................................................................. 13
Setup Steps: Overview ....................................................................................................................................................... 13
1. Install and Configure Frame Grabber and GUI .......................................................................................... 13
2. Connect Camera Link and Power Cables .................................................................................................... 13
3. Establish communicating with the camera .................................................................................................. 13
4. Operate the Camera ................................................................................................................................... 13
Step 1. Install and configure the frame grabber, graphics card and GUI ......................................................................... 14
Install Frame Grabber .................................................................................................................................... 14
Install Sapera LT and CamExpert ................................................................................................................... 14
Step 2. Connect Data, Trigger, and Power Cables ............................................................................................................. 14
Data Connector: Camera Link ........................................................................................................................ 15
Camera Link Bit Definitions............................................................................................................................ 17
Camera Link cable quality and length............................................................................................................ 18
Input Signals, Camera Link ............................................................................................................................ 18
Output Signals, Camera Link Clocking Signals............................................................................................... 19
Power Connector ............................................................................................................................................. 19
LEDs ................................................................................................................................................................ 20
Step 3. Establish Communication with the Camera ........................................................................................................... 20
Power on the camera ...................................................................................................................................... 20
Connect to the frame grabber ......................................................................................................................... 20
Connect to the camera .................................................................................................................................... 20
Check LED Status ............................................................................................................................................ 21
Software Interface ........................................................................................................................................... 21
Using Sapera CamExpert with Piranha4 Cameras ............................................................................................................ 22
CamExpert Panes ............................................................................................................................................ 23
Review a Test Image ....................................................................................................................................... 25
4. Camera Operation______________________________________________________________________________ 26
Teledyne DALSA
03-032-20133-01
4
Piranha4 8K Camera User's Manual
Factory Settings ................................................................................................................................................................. 26
Check Camera and Sensor Information ............................................................................................................................. 26
Verify Temperature and Voltage ....................................................................................................................................... 27
Saving and Restoring Camera Settings ............................................................................................................................. 27
Camera Link Configuration ............................................................................................................................................... 29
TDI Stages.......................................................................................................................................................................... 29
Sensitivity Mode and Pixel Readout ............................................................................................................... 30
Trigger Modes .................................................................................................................................................................... 31
Exposure Controls .............................................................................................................................................................. 31
Exposure Modes in Detail .................................................................................................................................................. 32
Set Line Rate ..................................................................................................................................................................... 34
Set Exposure Time ............................................................................................................................................................. 34
Control Gain and Black Level ............................................................................................................................................ 35
Set Image Size ................................................................................................................................................................... 35
Set Baud Rate .................................................................................................................................................................... 35
Pixel Format ...................................................................................................................................................................... 36
Camera Direction Control .................................................................................................................................................. 36
Sensor Shift Direction Example ...................................................................................................................... 37
Pixel Readout Direction (Mirroring Mode) ........................................................................................................................ 37
Binning .............................................................................................................................................................................. 38
Resetting the Camera ........................................................................................................................................................ 38
Calibrating the Camera ..................................................................................................................................................... 39
Appendix A: GenICam Commands _____________________________________________________________________ 41
Appendix B: ASCII Commands _______________________________________________________________________ 55
EMC Declaration _________________________________________________________________________________ 65
Revision History _________________________________________________________________________________ 66
Index ________________________________________________________________________________________ 67
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
5
1. System Precautions and
Cleaning
Precautions
Read these p recau tions and this m anu al carefu lly before u sing the cam era.
Confirm that the cam era’s p ackaging is u nd am aged before op ening it. If the p ackaging is d am aged p lease
contact the related logistics p ersonnel.
Do not op en the hou sing of the cam era. The w arranty is void ed if the hou sing is op ened .
Keep the cam era hou sing tem p eratu re in a range of 0 °C to 50 °C d u ring op eration.
Do not op erate the cam era in the vicinity of strong electrom agnetic field s. In ad d ition, avoid electrostatic
charging, violent vibration, and excess m oistu re.
To clean the d evice, avoid electrostatic charging by u sing a d ry, clean absorbent cotton cloth d am p ened
w ith a sm all qu antity of p u re alcohol. Do not u se m ethylated alcohol. To clean the su rface of the cam era
hou sing, u se a soft, d ry cloth. To rem ove severe stains u se a soft cloth d am p ened w ith a sm all qu antity of
neu tral d etergent and then w ip e d ry. Do not u se volatile solvents su ch as benzene and th inners, as they
can d am age the su rface finish. Fu rther cleaning instru ctions are below .
Thou gh this cam era su p p orts hot p lu gging, it is recom m end ed that you p ow er d ow n and d isconnect
p ow er to the cam era before you ad d or rep lace system com p onents.
Electrostatic Discharge and the CMOS Sensor
Im age sensors and the cam era bod ies hou sing are su scep tible to d am age from electrostatic d ischarge
(ESD). Electrostatic charge introd u ced to the sensor w ind ow su rface can ind u ce charge bu ild u p on the
u nd ersid e of the w ind ow that cannot be read ily d issip ated by the d ry nitrogen gas in the sensor p ackage
cavity. The charge norm ally d issip ates w ithin 24 hou rs and the sensor retu rns to norm al op eration.
Protecting Against Dust, Oil, and Scratches
The sensor w ind ow is p art of the op tical p ath and shou ld be hand led like other op tical com p onents, w ith
extrem e care. Du st can obscu re p ixels, p rod u cing d ark p atches on the sensor resp onse. Du st is m ost
visible w hen the illu m ination is collim ated . The d ark p atches shift p osition as the angle of illu m ination
changes. Du st is norm ally not visible w hen the sensor is p ositioned at the exit p ort of an integrating
sp here, w here the illu m ination is d iffu se. Du st can norm ally be rem oved by blow ing the w ind ow su rface
u sing an ionized air gu n. Oil is u su ally introd u ced d u ring hand ling. Tou ching the su rface of the w ind ow
barehand ed w ill leave oily resid u es. Using ru bber fingercots and ru bber gloves can p revent
contam ination. H ow ever, the friction betw een ru bber and the w ind ow m ay p rod u ce electro static charge
that m ay d am age the sensor. To avoid ESD d am age and to avoid introd u cing oily resid u es, avoid
tou ching the sensor. Scratches d iffract incid ent illu m ination. When exp osed to u niform illu m ination, a
sensor w ith a scratched w ind ow w ill norm ally have brighter p ixels ad jacent to d arker p ixels. The location
of these p ixels w ill change w ith the angle of illu m ination.
Teledyne DALSA
03-032-20133-01
6
Piranha4 8K Camera User's Manual
An important note on w indow blemishes:
When flat field correction is p erform ed , w ind ow cleanliness is p aram ou nt. The figu re below show s an
exam p le of w hat can hap p en if a blem ish is p resent on the sensor w ind ow w hen flat field correction is
p erform ed . The blem ish w ill cast a shad ow on the w afer. FFC w ill com p ensate for this shad ow by
increasing the gain. Essentially FFC w ill create a w hite sp ot to com p ensate for the d ark sp ot (shad ow ). As
long as the angle of the incid ent light rem ains u nchanged then FFC w orks w ell. H ow ever w hen the angle
of incid ence changes significantly (i.e. w hen a lens is ad d ed ) then the shad ow w ill shift and FFC w il l
m akes things w orse by not correcting the new shad ow (d ark sp ot) and overcorrecting w here the shad ow
u sed to be (w hite sp ot). While the d ark sp ot can be p otentially cleaned , the w hite sp ot is an FFC artifact
that can only be corrected by another FFC calib ration.
Cleaning the Sensor Window
Recommended Equipment


Glass cleaning station w ith m icroscop e w ithin clean room .
3M ionized air gu n 980
(http :/ / solu tions.3m canad a.ca/ w p s/ p ortal/ 3M/ en_CA/ WW2/ Cou ntry/ )


Ionized air flood system , foot op erated .
Sw ab (H UBY-340CA-003)
(http :/ / w w w .cleancross.net/ m od u les/ xfsection/ article.p hp ?articleid =24)


Single d rop bottle (FD-2-ESD)
E2 (Eclip se op tic cleaning system (w w w .p hotosol.com )



Use localized ionized air flow on to the glass d u ring sensor cleaning.
Blow off m obile contam ination u sing an ionized air gu n.
Place the sensor u nd er the m icroscop e at a m agnification of 5x to d eterm ine the
location of any rem aining contam ination.


Clean the contam ination on the sensor u sing one d rop of E2 on a sw ab.
Wip e the sw ab from left to right (or right to left bu t only in one d irection). Do
this in an overlap p ing p attern, tu rning the sw ab after the first w ip e and w ith
each su bsequ ent w ip e. Avoid sw ip ing back and forth w ith the sam e sw ab in
ord er to ensu re that p articles are rem oved and not sim p ly transferred to a new
location on the sensor w ind ow . This p roced u re requ ires you to u se m u ltip le
sw abs.
Discard the sw ab after both sid es of the sw ab have been u sed once.
Rep eat u ntil there is no visible contam ination p resent.
Procedure


03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
7
2. The Piranha4 Camera
Camera Highlights
Based on Teled yne DALSA's u niqu e line scan CMOS sensor architectu re, the new Piranha4 8k d u al line
scan cam era p rovid es ou tstand ing signal-to-noise for high sp eed im aging.
The P4-8k has 8k resolu tion w ith a 7 µm x 7 µm p ixel size for op tim ized op tical d esign. The cam era
d elivers a m ax line rate of 70 kH z in a high resp onsivity su m m ing m od e.
Precise sensor alignm ent sim p lifies m u ltip le cam era calibration at the system level. The cam era d elivers a
throu ghp u t of 573 MPix/ s u sing the Cam era Link™ interface. An ad vanced GenICam ™ com p liant
interface m akes the cam era easier to setu p , control, and integrate. Program m ability inclu d es exp osu re
control, flat field correction, and gain settings.
The Piranha4 8k cam era is id eal for flat p anel d isp lay, p rinted circu it board , solar cell, film , and large
form at w eb insp ection.
Key Features





8192 x 2 p ixels, 7.04 µm x 7.04 µm p ixel p itch, 100% fill factor
573 MPix / s d ata rates
70 KH z line rates
276 DN / (nJ / cm ²) broad band @ 1x gain, 12 bit (d u al line)
62 d B d ynam ic range
Programmability





Ad ju stable d igital gain and offset
8, 10 or 12 bit selectable ou tp u t
Ad ju stable integration tim e and line rate
Test p atterns and cam era d iagnostics
Flat field calibration

Applications





Flat-p anel d isp lay insp ection
Printed circu it board insp ection
Parcel sorting
H igh p erform ance d ocu m ent scanning
H igh throu ghp u t ap p lications
Teledyne DALSA
03-032-20133-01
8
Piranha4 8K Camera User's Manual
Models
The cam era is available in the follow ing configu rations:
Table 1: Camera Models Overview
Model Number
P4-CM-8K070-00-R
Description
8k resolution, 70 kH z line rate, 573 Mpix/ s throughput, Cam era Link interface.
Table 2: Software
Software
Cam era firm w are
GenICam ™ su p p ort (XML cam era d escrip tion file)
Sap era LT, inclu d ing Cam Exp ert GUI ap p lication and
GenICam for Cam era Link im aging d river
Product Number / Version Number
Em bed d ed w ithin cam era
Em bed d ed w ithin cam era
Version 7.20 or later
Camera Performance Specifications
Table 3: Camera Performance Specifications
Specifications
Im ager Form at
Resolution
Pixel Size
Pixel Fill Factor
Throughput
Line Rate
Performance
CMOS d ual line scan
8192 x 2 pixels
7.04 µm x 7.04 µm
100 %
573 Mpix/ s
0 kH z m inim um to 70 kH z m axim um (Full), 41 kH z m axim u m (Med ium ), 20
kH z m axim um (Base)
11 µs m inim um to 3,000 µs m axim um
8 bits, 10 bits, or 12 bits selectable
Exposure Tim e
Bit Depth
Connectors and Mechanicals
Control & Data Interface
Pow er Connector
Pow er Supply
Pow er Dissipation
Size
Mass
Operating Tem p
2 x Base, Med ium , or Full Cam era Link configurations—MDR26
H irose 6-pin circular
+ 12 V to + 24 V DC (+11.4 V to +25.2 V m axim um lim its)
17 W
80 m m (W) x 130 m m (H ) x 57 m m (D)
< 700 g, includ ing heat sinks (< 530 g w ithout heat sinks)
0 °C to 50 °C, front plate tem p erature
Optical Interface
Lens Mount
Sensor to Cam era Front Distance
Sensor Alignm ent (aligned to sid es of cam era)
Flatness
50 µm
0.08° or 81 µm
 y (parallelism )
± 50 µm
x
± 50 µm
y
± 250 µm
z
± 0.2°
z
M72 x 0.75
12 m m
Compliance
Regulatory Com pliance
03-032-20133-01
CE and RoH S; GenICam
Teledyne DALSA
Piranha4 8K Camera User's Manual
Operating Ranges
Dynam ic Range
Rand om N oise
Broad band Responsivity
Gain
DC Offset
PRN U
FPN
SEE
N EE
Antibloom ing
Integral non-linearity
9
Performance
Single Line
Dual Line
62 d B
63.3 d B
3.42 DN * rm s
2.8 DN rm s
2
198 DN / (nJ/ cm 2)
276 DN / (nJ/ cm )
1x to 10x N om inal range
1x to 10x N om inal range
16 DN
16 DN
<1% @50% Sat
<1% @50% Sat
< 5 DN
< 5 DN
2
2
20.2 nJ / cm
14.49 nJ / cm
2
2
11.16 pJ / cm
12.39 pJ / cm
> 100 x Saturation
< 2% DN
Notes
FFC enabled
FFC enabled
*DN = d igital nu m ber
Test Cond itions:
 Valu es m easu red u sing 12-bit, 1x gain.
 10 kH z line rate
 Light sou rce: broad band , qu artz halogen, 3250 K w ith 700 nm IR cu toff filter.
 Front p late tem p eratu re: 45 C
Certifications and Compliance
Compliance
EN 55011, FCC Part 15, CISPR 11, and ICES-003 Class A Rad iated Em issions Requirem ents
EN 55024 and EN 61326-1 Im m unity to Disturbance
RoH S per EU Directive 2002/ 95/ EC and WEEE per EU Directive 2002/ 96/ EC and China Electronic Ind ustry
Stand ard SJ/ T11364-2006
GenICam XML Description File, Superset of the GenICam ™ Stand ard Features N am ing Convention specification
V1.5, Cam era Link Serial Com m u nication: GenICam ™ Generic Control Protocol (GenCP V1.0)
Supported Industry Standards
GenICam™
Piranha4 cam eras are GenICam com p liant. They im p lem ent a su p erset of the GenICam ™ Stand ard
Featu res N am ing Convention sp ecification V1.5.
This d escrip tion takes the form of an XML d evice d escrip tion file resp ecting the syntax d efined by the
GenAp i m od u le of the GenICam ™ sp ecification. The cam era u ses the GenICam ™ Generic Control
Protocol (GenCP V1.0) to com m u nicate over the Cam era Link seria l p ort.
For m ore inform ation see w w w .genicam .org.
Teledyne DALSA
03-032-20133-01
10
Piranha4 8K Camera User's Manual
Responsivity
The resp onsivity grap h d escribes the sensor resp onse to d ifferent w avelengths of light (exclu d ing lens
and light sou rce characteristics).
P4 8K Spectral Responsivity vs Wavelength (12bit @ 1x Gain, Dual Line)
350
300
Spectral Responsivity (DN/nJ/cm2)
250
200
150
100
50
0
350
450
550
650
750
850
950
Wavelength (nm)
Figure 1: Spectral Responsivity vs. Wavelength (Dual Line)
FPN Characteristics with Temperature
Figure 2: FPN Derating Chart
03-032-20133-01
Teledyne DALSA
A
B
C
(64)
B
40 0.05
(64)
80 0.05
M72x0.75 - 6H  5
M4x0.7 - 6H  7.5
(4X)
0.2°
CENTER OF
IMAGE AREA
40 0.05
Teledyne DALSA
A
(57)
(52)
(41.2)
(7)
(66.16)
M4x0.7 - 6H  7.5
(3X) THIS SIDE
(3X) FAR SIDE
12 ± 0.1
OPTICAL DISTANCE
 0.08 A
 0.05
3
(50.1)
(54)
80 0.05
(40)
2
CHANGED EXTERNAL HEAT SINK FO
WITH HEAT SINK VIEWS
UPDATED DIMENSIONS AND VIEWS
R
T
NO RE
OR APR
M. F
OLA
11
Figure 3: Camera Mechanical
03-032-20133-01
P4
APPLICATION/PROJECT
APPROVED BY
APPROVALS
AUTHOR
Mechanicals
1. UNITS: MM
2. DRAWING PER
ASME Y14.5M-1994
3. TOLERANCES:
LINEAR
±0.15
ANGLES ±0.5
SURFACE FINISH 3.2
UNLESS OTHERWISE SPECIFIED
NOTES:
1. UNITS: MILLIMETERS.
2. IMAGE AREA IS ALIGNED TO DATUMS A B & C .
(69)
02
01
REV
(28.4)
(28.6)
4
Piranha4 8K Camera User's Manual
12
Piranha4 8K Camera User's Manual
(130)
B
OPTIONAL EXTERNAL HEAT SINK (2X)
A
Figure 4: Camera Mechanical with External Heat Sink
LE
E
R
1.
UNITS: MMI
T
VP
E
NO2. DRAWING
R
ASME Y14.5
R
3. TOLERANC
O
F LINEAR
UNLESS OTHERWISE S
Camera Mounting and Heat Sink Considerations
The Piranha4 cam eras ship s w ith tw o heat sinks installed and id eally p ositioned to allow close sp acing of
the cam eras. These heat sinks are d esigned to p rovid e ad equ ate convection cooling w hen not obstru cted
by enclosu res or m ou nting assem blies.
Teled yne DALSA recognises that each cu stom er’s ap p lication can be u niqu e. In consid eration, the P4
cam era heat sinks have been d esigned in su ch a w ay that they can be rep ositioned on the d ifferent faces
of the cam era or rem oved entirely, d ep end ing on the m ou nting configu ration and its heat sinking
p otential. 4
3
Rep ositioning or rem oval of the heat sinks m u st be p erform ed w ith care in ord er to avoid tem p eratu re
issu es. The cam era has the ability to m easu re its internal tem p eratu re. Use this featu re to record the
internal tem p eratu re of the cam era w hen it is m ou nted in you r system and op erating u nd er the w orst
case cond itions. The cam era w ill stop ou tp u tting d ata if its internal tem p eratu re reaches 75 °C.
03-032-20133-01
Teledyne DALSA
ANGLES
SURFACE FIN
PROPRIE
THIS DOCUMENT AND THE IN
BE DUPLICATED, OR ITS CON
Piranha4 8K Camera User's Manual
13
3. Software and Hardware Setup
Recommended System Requirements
To achieve best system p erform ance, the follow ing m inim u m requ irem ents are recom m end ed :
 H igh band w id th fram e grabber recom m end ed , e.g. Xcelera-CL PX4 Fu ll Cam era Link fram e grabber
(Part # OR-X4CO-XPF00).
 Op erating system : Wind ow s XP 32-bit.
Setup Steps: Overview
Take the follow ing step s in ord er to setu p and ru n you r cam era system . They are d escribed briefly below
and in m ore d etail in the sections that follow .
1. Install and Configure Frame Grabber and GUI
If you r host com p u ter d oes not have a PX4 fu ll Cam era link fram e grabber then you need to install one.
We recom m end the Xcelera-CL PX4 Fu ll fram e grabber or equ ivalent, d escribed in d etail on the
teled yned alsa.com site here. Follow the m anu factu rer’s installation instru ctions.
A GenICam ™ com p liant XML d evice d escrip tion file is em bed d ed w ithin the cam era firm w are allow ing
GenICam ™ com p liant ap p lication to know the cam era’s cap abilities im m ed iately after connection.
Installing Sap eraLT gives you access to the Cam Exp ert GUI, a GenICam ™ com p liant ap p lication.
2. Connect Camera Link and Power Cables


Connect the Cam era Link cables from the cam era to the com p u ter.
Connect a p ow er cable from the cam era to a +12 VDC to +24 VDC p ow er su p p ly.
3. Establish communicating with the camera
Start the GUI and establish com m u nication w ith the cam era. Refer to p age 14 for a d escrip tion on
com m u nicating w ith the cam era.
ASCII Commands
As an alternative to the Cam Exp ert (or equ ivalent) GUI, you can com m u n icate w ith this cam era u sing
ASCII-based com m and s. A com p lete list of the com m and s and a d escrip tion of how to access them can be
fou nd in the ap p end ix: ASCII User Com m and Reference.
4. Operate the Camera
At this p oint you w ill be read y to start op erating the cam era in ord er to acqu ire im ages, set cam era
fu nctions, and save settings.
Teledyne DALSA
03-032-20133-01
14
Piranha4 8K Camera User's Manual
Step 1. Install and configure the frame grabber,
graphics card and GUI
Install Frame Grabber
Install a Full configu ration Cam era Link fram e grabber accord ing to the m anu factu rer’s d escrip tion.
We recom m end the Xcelera-CL PX4 fram e grabber or equ ivalent, d escribed in d etail on the
teled yned alsa.com site here.
Install Sapera LT and CamExpert
Com m u nicate w ith the cam era u sing a Cam era Link -com p liant interface. We recom m end you u se
Cam Exp ert. Cam Exp ert is the cam era interfacing tool su p p orted by the Sap era library and com es
bu nd led w ith Sap eraLT. Using Cam Exp ert is the sim p lest and qu ickest w ay to send com m and s to and
receive inform ation from the cam era.
Camera Link Control Communications
The P4 fam ily of cam eras are GenICam ™ com p liant. Sap era u ses the GenICam ™ Generic Control
Protocol (GenCP V1.0) to com m u nicate w ith the cam era over the Cam era Link serial p ort. When
com m u nications are first established Sap era w ill w hen connecting for the first tim e d ow nload the
GenICam ™ XML Descrip tion file. This file d etails how to access and control the cam era.
Step 2. Connect Data, Trigger, and Power Cables
N ote: the u se of cables typ es and lengths other than those sp ecified m ay resu lt in increased em ission or
d ecreased im m u nity and p erform ance of the cam era.
B
C
A
B
Power
A +12V to +24V DC Hirose 6-pin
Control & Data
B Camera Link 26-pin MDR26 connectors
B
Status
C Diagnostic LED
Figure 5: Input and Output, Trigger, and Power Connectors
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
!
15
WARN IN G! Grounding Instructions
Static electricity can d am age electronic com p onents. It’s critical that you d ischarge any static
electrical charge by tou ching a grou nd ed su rface, su ch as the m etal com p u ter chassis, before
hand ling the cam era hard w are.
Data Connector: Camera Link
The cam era u ses tw o Cam era Link MDR26 cables transm itting the Cam era Link Base, Med iu m , or Fu ll
configu ration. The figu re below show s the MDR26 Cam era Link Connector and the tables that follow list
the Cam era Link Base, Med iu m , and Fu ll configu ration s.
For d etailed inform ation on Cam era Link p lease refer to the Cam era Link Road Map available from th e
Know led ge Center on the Teled yne DALSA Web site:
(http :/ / w w w .teled yned alsa.com / m v/ know led ge/ ap p notes.asp x).
Figure 6. MDR26 Camera Link Connector
Data 2
Camera
Connector
1
14
2
15
3
16
4
17
5
18
6
19
7
20
8
21
9
22
10
23
11
Teledyne DALSA
Right Angle
Frame Grabber
Connector
1
14
25
12
24
11
23
10
22
9
21
8
20
7
19
6
18
5
17
4
16
Channel Link
Signal
inner shield
inner shield
Y0Y0+
Y1Y1+
Y2Y2+
YclkYclk+
Y3Y3+
100 ohm
terminated
Z0Z0+
Z1Z1+
Z2Z2+
Zclk-
Control / Data 1
Camera
Right Angle
Connector
Frame Grabber
Connector
1
1
14
14
2
25
15
12
3
24
16
11
4
23
17
10
5
22
18
9
6
21
19
8
7
20
20
7
8
19
21
6
9
18
22
5
10
17
23
4
11
16
Channel Link
Signal
inner shield
inner shield
X0X0+
X1X1+
X2X2+
XclkXclk+
X3X3+
SerTC+
SerTCSerTFGSerTFG+
CC1CC1+
CC2+
CC2CC303-032-20133-01
16
24
12
25
13
26
Piranha4 8K Camera User's Manual
3
15
2
13
26
Zclk+
Z3Z3+
inner shield
inner shield
24
12
25
13
26
3
15
2
13
26
CC3+
CC4+
CC4inner shield
inner shield
*Exterior Overshield is connected to the shells of the connectors on both ends. Unused pairs should be terminated in 100 ohms at
both ends of the cable. Inner shield is connected to signal ground inside camera
Full Configuration
Connector 1: Channel link X
Camera/Frame
Grabber Pin
Tx0/Rx0
Tx1/Rx1
Tx2/Rx2
Tx3/Rx3
Tx4/Rx4
Tx5/Rx5
Tx6/Rx6
Tx7/Rx7
Tx8/Rx8
Tx9/Rx9
Tx10/Rx10
Tx11/Rx11
Tx12/Rx12
Tx13/Rx13
Tx14/Rx14
Tx15/Rx15
Tx16/Rx16
Tx17/Rx17
Tx18/Rx18
Tx19/Rx19
Tx20/Rx20
Tx21/Rx21
Tx22/Rx22
Tx23/Rx23
Tx24/Rx24
Tx25/Rx25
Tx26/Rx26
Tx27/Rx27
Bit Name
D0(0)
D0(1)
D0(2)
D0(3)
D0(4)
D0(7)
D0(5)
D1(0)
D1(1)
D1(2)
D1(6)
D1(7)
D1(3)
D1(4)
D1(5)
D2(0)
D2(6)
D2(7)
D2(1)
D2(2)
D2(3)
D2(4)
D2(5)
Not Used
LVAL
FVAL
Not Used
D0(6)
8 bits Camera Link Full Configuration
Connector 2: Channel link Y
Connector 3: Channel link Z
Camera/Frame
Grabber Pin
Tx0/Rx0
Tx1/Rx1
Tx2/Rx2
Tx3/Rx3
Tx4/Rx4
Tx5/Rx5
Tx6/Rx6
Tx7/Rx7
Tx8/Rx8
Tx9/Rx9
Tx10/Rx10
Tx11/Rx11
Tx12/Rx12
Tx13/Rx13
Tx14/Rx14
Tx15/Rx15
Tx16/Rx16
Tx17/Rx17
Tx18/Rx18
Tx19/Rx19
Tx20/Rx20
Tx21/Rx21
Tx22/Rx22
Tx23/Rx23
Tx24/Rx24
Tx25/Rx25
Tx26/Rx26
Tx27/Rx27
Bit Name
D3(0)
D3(1)
D3(2)
D3(3)
D3(4)
D3(7)
D3(5)
D4(0)
D4(1)
D4(2)
D4(6)
D4(7)
D4(3)
D4(4)
D4(5)
D5(0)
D5(6)
D5(7)
D5(1)
D5(2)
D5(3)
D5(4)
D5(5)
Not Used
LVAL
FVAL
Not Used
D3(6)
Camera/Frame
Grabber Pin
Tx0/Rx0
Tx1/Rx1
Tx2/Rx2
Tx3/Rx3
Tx4/Rx4
Tx5/Rx5
Tx6/Rx6
Tx7/Rx7
Tx8/Rx8
Tx9/Rx9
Tx10/Rx10
Tx11/Rx11
Tx12/Rx12
Tx13/Rx13
Tx14/Rx14
Tx15/Rx15
Tx16/Rx16
Tx17/Rx17
Tx18/Rx18
Tx19/Rx19
Tx20/Rx20
Tx21/Rx21
Tx22/Rx22
Tx23/Rx23
Tx24/Rx24
Tx25/Rx25
Tx26/Rx26
Tx27/Rx27
Bit Name
D6(0)
D6(1)
D6(2)
D6(3)
D6(4)
D6(7)
D6(5)
D7(0)
D7(1)
D7(2)
D7(6)
D7(7)
D7(3)
D7(4)
D7(5)
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
LVAL
FVAL
Not Used
D6(6)
Tap 1 bits are D0(x)...Tap 8 bits are D7(x)
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
17
Camera Link Bit Definitions
BASE
Configuration
Pixel Format
T0
Port A
Bits 0 thru 7
Port B
Bits 0 thru 7
Port C
Bits 0 thru 7
Mono 8
Tap 1 LSB..Bit 7
Pixels (1, 3, 5, ... 8189, 8191)
Tap 2 LSB..Bit7
Pixels (2, 4, 6, ... 8190, 8192)
xxxxxxx
Mono 12
Tap 1 LSB.. Bit 7
Pixels (1, 3, 5, ... 8189, 8191)
Tap 1 Bits 8,9,10,11
Pixels (1, 3, 5, ... 8189,8191)
Tap 2 Bits 8,9,10,11
Pixels (2,4,6, ... 8190, 8192)
Tap 2 LSB..Bit 7
Pixels (2,4,6, ... 8190, 8192)
Medium
Configuration
Pixel Format
T0
Port A
Bits 0 thru 7
Port B
Bits 0 thru 7
Port C
Bits 0 thru 7
Port D
Bits 0 thru
7
Port E
Bits 0 thru 7
Port F
Bits 0 thru 7
Mono 8
Tap 1
LSB..Bit 7
Pixels (1, 5, 9, ...
8185, 8189)
Tap 2
LSB..Bit 7
Pixels (2, 6, 10,
... 8186, 8190)
Tap 3
LSB..Bit 7
Pixels (3, 7,
11, ... 8187,
8191)
Tap 4
LSB...Bit 7
Pixels (4,
8, 12, ...
8188,
8192)
xxxxxxxx
Xxxxxxxx
Mono 10 /
Mono 12
Tap 1
LSB.. Bit 7
Pixels (1, 5, 9, ...
8187, 8191)
Tap 1
Bits 8,9,10,11
Pixels (1, 5, 9, ...
8187, 8191)
Tap 2
LSB..Bit 7
Pixels (2, 6,
10, ... 8188,
8192)
Tap 4
LSB…Bit
7
Pixels (4,
8, 12, ...
8186,
8190)
Tap 3
LSB…Bit 7
Pixels (3, 7,
11, ... 8185,
8189)
Tap 3
Bit 8,9,10,11
Pixels (3, 7, 11,
... 8185, 8189)
Tap 2
Bits 8,9,10,11
Pixels (2, 6, 10,
... 8188, 8192)
Tap 4
Bits 8,9,10,11
Pixels (4, 8, 12,
... 8186, 8190)
Full
Configuration
Pixel Format
T0
Port A
LSB…Bit 7
Port B
LSB…Bit 8
Port C
LSB…Bit 8
Port D
LSB…Bit
8
Port E
LSB…Bit
8
Port F
LSB…Bit
8
Port G
LSB…Bit 8
Port H
LSB…Bit
8
Mono 8
Tap 1
LSB…
Bit 7
Pixels (1, 9,
17, ... 8177,
8185)
Tap 2
LSB…
Bit 7
Pixels (2,
10, 18, ...
8178,
8186)
Tap 3
LSB…
Bit 7
Pixels (3,
11, 19, ...
8179,
8187)
Tap 4
LSB…
Bit 7
Pixels (4,
12, 20, ...
8180,
8188)
Tap 5
LSB…
Bit 7
Pixels (5,
13, 21, ...
8181,
8189)
Tap 6
LSB…
Bit 7
Pixels (6,
14, 22, ...
8182,
8190)
Tap 7
LSB…Bit
7
Pixels (7,
15, 23, ...
8183,
8191)
Tap 8
LSB…
Bit 7
Pixels (8,
16, 24, ...
8184,
8192)
Table 4: Camera Link Bit Definitions
Teledyne DALSA
03-032-20133-01
18
Piranha4 8K Camera User's Manual
Signal
CC1
CC2
CC3
CC4
Configuration
EXSYN C
Spare
Direction
Spare
Table 5: Camera Control Configuration
For ad d itional Cam era Link d ocu m entation refer to the Teled yne DALSA Web site’s Know led ge Center
ap p lication notes.
Camera Link cable quality and length
The m axim u m allow able Cam era Link cable length d ep end s on the qu ality of the cable u sed and the
Cam era Link strobe frequ ency. Cable qu ality d egrad es over tim e as the cable is flexed . In ad d ition, as the
Cam era Link strobe frequ ency is increased the m axim u m allow able cable length w ill d ecrease.
The Piranha4 cam eras are cap able of d riving cables 10 m etres or less in length. We d o not gu arantee good
im aging p erform ance w ith low qu ality cables of any length. In general, w e recom m end the u se of high
qu ality cables for any cable length.
Input Signals, Camera Link
The cam era accep ts control inp u ts throu gh the Cam era Link MDR26F connector. The cam era ship s in
internal sync, and internally p rogram m ed integration .
EXSYNC (Line Readout Trigger)
Line rate can be set internally u sing the GenICam featu res. The external control signal EXSYN C is
op tional and enabled throu gh the u ser interface. This cam era u ses the falling ed ge of EXSYN C to trigger
p ixel read ou t.
The EXSYN C signal tells the cam era w hen to integrate and read ou t the im age. It can be either an
internally generated signal by the cam era, or it can be su p p lied externally via the serial interface.
Dep end ing u p on the m od e of op eration the high tim e of the EXSYN C signal can rep resent the integration
p eriod .
N ote: The EXSYN C signal is m easu red at CC1 and w ill give a ―tru e‖ m easu rem ent (i.e. w ithin the
m easu rem ent resolu tion of 25 ns) even thou gh the cam era w ill only trigger at a m axim u m of 70 KH z.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
19
Output Signals, Camera Link Clocking Signals
These signals ind icate w hen d ata is valid , allow ing you to clock the d ata from the cam era to you r
acqu isition system . These signals are p art of the Cam era Link configu ration and you shou ld refer to the
Cam era Link Im p lem entation Road Map , available at ou r Know led ge Center, for the stand ard location of
these signals.
Clocking Signal
Indicates
LVAL (high)
DVAL
STROBE (rising ed ge)
FVAL
Ou tp u tting valid line
N ot u sed
Valid d ata
Tied to LVAL
Power Connector
WARN IN G: It is extrem ely im p ortant that you ap p ly the ap p rop riate voltages to you r cam era.
Incorrect voltages m ay d am age the cam era. Inp u t voltage requ irem ent: +12 VDC to +24 VDC,
2 Am p s. Before connecting p ow er to the cam era, test all p ow er su p p lies.
!
Figure 7: 6-pin Hirose Circular Male Power Plug—Power Connector
Pin
1
2
3
Table 6. Power Plug Pinout
Description
Pin
Description
+12 V to +24 V DC
+12 V to +24 V DC
+12 V to +24 V DC
4
5
6
GN D
GN D
GN D
The cam era requ ires a single voltage inp u t +12 VDC to +24 VDC. The cam era m eets all p erform ance
sp ecifications u sing stand ard sw itching p ow er su p p lies, althou gh w ell-regu lated linear su p p lies p rovid e
op tim u m p erform ance.
WARNING: When setting up the camera’s power supplies follow these guidelines:
!





Ap p ly the ap p rop riate voltages.
Protect the cam era w ith a 2 am p slow -blow fu se betw een the p ow er su p p ly and the cam era.
Do not u se the shield on a m u lti-cond u ctor cable for grou nd .
Keep lead s as short as p ossible in ord er to red u ce voltage d rop .
Use high-qu ality su p p lies in ord er to m inim ize noise.
Note: If your power supply does not meet these requirements, then the camera performance specifications are not
guaranteed.
Teledyne DALSA
03-032-20133-01
20
Piranha4 8K Camera User's Manual
LEDs
The cam era is equ ip p ed w ith an LED on the back to d isp lay the op erational statu s of the cam era. The
table below su m m arizes the op erating states of the cam era and the corresp ond ing LED states. When m ore
than one cond ition is active, the LED ind icates the cond ition w ith the highest p riority.
Color of Status LED
Meaning
Off
Dark Blue
Light Blue
Green
Red
N o pow er, or hardw are m alfunction .
In boot-load er. Com pleting firm w are upgrad e.
Busy. For exam ple, pow ering up or perform ing a calibration.
Read y.
Error. Check BiST register for the specific error.
Step 3. Establish Communication with the
Camera
Power on the camera
Tu rn on the cam era’s p ow er su p p ly. You m ay have to w ait w hile the cam era read ies itself for op eration.
The cam era m u st boot fu lly before it w ill be recognized by the GUI—the LED shines green once the
cam era is read y.
Connect to the frame grabber
1. Start Sap era Cam Exp ert (or equ ivalent Cam era Link com p liant interfa ce) by d ou ble clicking the
d esktop icon created d u ring the softw are installation.
2. Cam Exp ert w ill search for installed Sap era d evices. In the Devices list area on the left sid e, the
connected fram e grabber w ill be show n.
3. Select the fram e grabber d evice by clicking on the nam e.
Connect to the camera
1. Start a new Sap era Cam Exp ert ap p lication (or equ ivalent Cam era Link com p liant interfa ce) by d ou ble
clicking the d esktop icon created d u ring the softw are installation.
2. In the Devices list area on the left sid e, select the COM p ort below the Cam erLink label.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
21
Figure 8. CamExpert GUI showing connected camera
Check LED Status
If the cam era is op erating correctly at this p oint, the d iagnostic LED w ill shine green.
Software Interface
All the cam era featu res can be controlled throu gh the Cam Exp ert interface. For exam p le, u nd er the
Cam era Control m enu in the cam era w ind ow you can control the line rate and exp osu re tim es.
N ote: the cam era u ses tw o Cam Exp ert w ind ow s to send com m and s and d isp lay the resu lts. One w in d ow
controls the cam era and the other is u sed for im age acqu isition and d isp lay.
Teledyne DALSA
03-032-20133-01
22
Piranha4 8K Camera User's Manual
Figure 9. Two CamExpert window shown. One connected to the frame grabber and one to the camera.
At this p oint you r host and cam era system shou ld be setu p and you can verify the cam era’s op eration by
retrieving a test p attern and setting the cam era’s trigger and exp osu re tim e.
N ote that w ithin the Cam Exp ert w ind ow that controls the cam era, the im age d isp lay and associ ated
bu ttons su ch as Grab and Snap are inactive and have no fu nction.
Using Sapera CamExpert with Piranha4
Cameras
Cam Exp ert is the cam era interfacing tool su p p orted by the Sap era library. When u sed w ith a Piranha4
cam era, Cam Exp ert allow s a u ser to test all cam era op erating m od es. Ad d itionally Cam Exp ert saves the
cam era u ser settings configu ration to the cam era or saves m u ltip le configu rations as ind ivid u al cam era
p aram eter files on the host system (*.ccf). Cam Exp ert can also be u sed to u p grad e the cam era’s softw are.
An im p ortant com p onent of Cam Exp ert is its live acqu isition d isp lay w ind ow w hich allow s im m ed iate
verification of tim ing or control p aram eters w ithou t the need to ru n a sep arate acqu isition p rogram .
For context sensitive help , click on the
bu tton then click on a cam era configu ration p aram eter. A
short d escrip tion of the configu ration p aram eter w ill be show n in a p op u p . Click on the
op en the help file for m ore d escrip tive inform ation on Cam Exp ert.
bu tton to
The central section of Cam Exp ert p rovid es access to the cam era featu res and p aram eters. N ote: The
availability of the featu res is d ep end ent on the Cam Exp ert u ser setting.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
23
CamExpert Panes
Figure 10. CamExpert’s Camera Control Window
Teledyne DALSA
03-032-20133-01
24
Piranha4 8K Camera User's Manual
Figure 11. CamExpert’s Image Acquisition Window
The Cam Exp ert ap p lication u ses p anes to sim p lify choosing and configu ring cam era files or acqu isition
p aram eters for the installed d evice.
 D evice Selector pane: View and select from any installed Sap era acqu isition d evice. Once a d evice is
selected Cam Exp ert w ill only p resent acqu isition p aram eters ap p licable to that d evice. Op tionally
select a cam era file inclu d ed w ith the Sap era installation or saved by the u ser.
 Parameters pane: Allow s view ing or changing all acqu isition p aram eters su p p orted by the
acqu isition d evice. Cam Exp ert d isp lays p aram eters only if those p aram eters are su p p orted by the
installed d evice. This avoid s confu sion by elim inating p aram eter choices w hen they d o not ap p ly to
the hard w are in u se.
 D isplay pane: Provid es a live or single fram e acqu isition d isp lay. Fram e bu ffer p aram eters are show n
in an inform ation bar above the im age w ind ow .
 Control Buttons: The Disp lay p ane inclu d es Cam Exp ert control bu ttons. These are:
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
25
Acquisition control button:
Click once to start live grab, click again to stop.
Single frame grab:
Click to acquire one fram e from d evice.
Trigger button:
With the I/ O control param eters set to Trigger Enabled , click to send a
single trigger com m an d .
CamExpert display controls:
(these d o not m od ify the fram e buffer d ata)
Stretch im age to fit, set im age d isplay to original size, or zoom the
im age to any size and ratio.
Histogram / Profile tool:
Select to view a histogram or line/ colum n profile d uring live
acquisition or in a still im age.

Output Message pane: Disp lays m essages from Cam Exp ert or the d evice d river.
Review a Test Image
The cam era is now read y to retrieve a test p attern. Select Image Format Control > Test Pattern and
choose one of the follow ing available test im ages.
1. Off: Sensor Vid eo
2. Ram p
4. A5: 4 p ixels rep eating*
5. Each Tap Fixed *
6. All_1365*
7. All_1*
*12-bit, single line. low sensitivity.
Teledyne DALSA
03-032-20133-01
26
Piranha4 8K Camera User's Manual
At this p oint you are read y to start op erating the cam era in ord er to acqu ire im ages, set cam era fu nctions,
and save settings.
4. Camera Operation
Factory Settings
The cam era ship s and p ow ers u p for the first tim e w ith the follow ing factory settings:

Cam era Link Fu ll, 8 bit p ixels

Internal trigger, line rate 10 kH z

Internal exp osu re control, exp osu re tim e 50 µs

2 stage TDI

1x horizontal and vertical binning

Flat field enabled , all p ixel coefficients set to 1x

Offset 0, Gain 1x
Check Camera and Sensor Information
Cam era and sensor inform ation can be retrieved via a controlling ap p lication —for exam p le, the
Cam Exp ert GUI show n in the follow ing exam p les. Param eters su ch as cam era m od el, firm w are version,
sensor characteristics, etc. are read to u niqu ely id entify the connected d evice.
The cam era inform ation p aram eters are grou p ed together as m em bers of the Cam era Inform ation set.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
27
Verify Temperature and Voltage
To d eterm ine the voltage and tem p eratu re at the cam era, u se the Refresh Voltage and Refresh
Temperature featu res fou nd in the Camera Information set.
The tem p eratu re retu rned is the internal tem p eratu re in d egrees Celsiu s. For p rop er op eration, this valu e
shou ld not exceed 75 °C. If the cam era exceed s the d esignated tem p eratu re it w ill stop im aging and the
LED w ill tu rn red . Once you have d iagnosed and rem ed ied the issu e u se the reset camera fu nction.
The voltage d isp layed is the cam era’s inp u t voltage. N ote that the voltage m easu rem ent featu re of the
cam era p rovid es only ap p roxim ate resu lts (typ ically w ithin 10% and d ep end ent on the voltage d rop in
the cable). The m easu rem ent shou ld not be u sed to set the ap p lied voltage to the cam era, bu t only u sed as
a test to isolate gross p roblem s w ith the su p p ly voltage.
Saving and Restoring Camera Settings
The p aram eters u sed to select, load and save u ser sets are grou p ed together u nd er the Cam era
Inform ation set of featu res. There are 8 u ser sets available and one factory set.
Camera Information
Parameter
User Set Default Selector
User Set Selector
User Set Load
User Set Save
Choices
Select the cam era p aram eters to load w hen the cam era is reset or
pow ered up as the Factory set, or as User Set 1 to 8.
Selecting the set from the list autom atically saves it as the d efault
set.
Select the Factory or User set to Save or Load .
-Factory Set
-User Set 1 to 8.
Load the set specified by User Set Selector to the cam era and m ake
it the active / current set.
Save the current set as selected user set.
Description of the Camera Settings
The cam era op erates in one of three settings:
1.
2.
3.
4.
Cu rrent session.
User setting.
Factory setting (read -only).
Defau lt setting.
The cu rrent settings can be saved (thereby becom ing the u ser setting) u sing the User Set Save p aram eter.
A p reviou sly saved u ser setting (User Set 1 to 8) or the factory settings can be restored u sing the User Set
Selector and User Set Load p aram eters.
Either the Factory or one of the User settings can be saved as the Defau lt Setting by selecting the set in the
User Set Defau lt Selector. The chosen set au tom atically saves as the d efau lt setting and is the set load ed
w hen the cam era is reset or p ow ered u p .
Teledyne DALSA
03-032-20133-01
28
Piranha4 8K Camera User's Manual
The relationship betw een these three settings is illu strated in Figu re 12. Relationship betw een the Cam era
Settings:
Figure 12. Relationship between the Camera Settings
Active Settings for Current Session
The active setting for the cu rrent session is the set of configu ration s that are op erating w hile the cam era is
cu rrently ru nning, inclu d ing all u nsaved changes you have m ad e to the settings before saving them .
These active settings are stored in the cam era’s volatile m em ory and w ill be lost and can not be restored if
the cam era resets or if the cam era is p ow ered d ow n or loses p ow er.
To save these settings for reu se the next tim e you p ow er u p or reset the cam era, or to p rotect against
losing them in the case of p ow er loss, you m u st save the cu rrent settings u sing the User Set Save
p aram eter. Once saved , the cu rrent settings becom e the selected User Set.
User Setting
The u ser setting is the saved set of cam era configu rations that you can cu stom ize, resave, and restore. By
d efau lt the u ser settings are ship p ed w ith the sam e settings as the factory set.
The com m and User Set Save saves the cu rrent settings to non-volatile m em ory as a User Set. The cam era
au tom atically restores the last saved u ser settings w hen it p ow ers u p .
To restore the last saved u ser settings, select the User Set p aram eter you w ant to restore and then select
the User Set Load p aram eter.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
29
Factory Settings
The factory setting is the cam era settings that w ere ship p ed w ith the cam era and w hich load ed d u ring the
cam era’s first p ow er-u p . To load or restore the original factory settings, at any tim e, select the Factory
Setting p aram eter and then select the User Set Load p aram eter.
N ote: By d efau lt, the u ser settings are set to the factory settings.
Default Setting
Either the Factory or one of the User settings can be u sed as the Defau lt Setting by selecting the set in the
User Set Defau lt Selector. The chosen set au tom atically becom es the d efau lt setting and is the set load ed
w hen the cam era is reset of p ow ered u p .
Camera Link Configuration
Name
Taps
SPF*
Cables
Base
2
8, 10, 12
1
Med ium
4
8, 10, 12
2
Full
8
8
2
*Set Pixel Form at (nu m ber of bits p er p ixel)
TDI Stages
You have the op tion to set the TDI stages as either a single line (1: low sensitivity m od e) or as the su m of
a p air of lines (2: high sensitivity m od e).
TDI Stages and Direction Control
If the cam era’s d irection is set to reverse, then the TDI stage is locked to TDI stage 2. While op erating in
TDI stage 1 the d irection control is not available and w ill be greyed ou t, the cam era m u st be op erating
w ith internal d irection control.
TDI Stage 2 Vs. Vertical Binning 2
TDI d elays the line su m one line-tim e so that each row im ages the sam e area. Whereas w ith vertical
binning 2, w hich can also be referred to as ―tall p ixel m od e,‖ the row s im age ad jacent areas and are
su m m ed w ithou t sep aration d elay. This action com bined w ith horizontal binning 2 resu lts in a big p ixel
that has half the resolu tion bu t is fou r tim es as resp onsive.
Teledyne DALSA
03-032-20133-01
30
Piranha4 8K Camera User's Manual
Sensitivity Mode and Pixel Readout
The cam era has the op tion to op erate in either high sensitivity (d u al line) or low sensitivity (single line)
m od es.
When in high sensitivity m od e, the cam era u ses both line scan sensors and as a resu lt the resp onsivity
increases (40%). When in low sensitivity m od e, the cam era u ses the bottom sensor only. The internal gain
is 1.4x greater for low sensitivity m od e vs. high sensitivity m od e .
7.04 µm 7.04 µm
Pixel Detail
7.04 µm
Sensor 2(7.04 µm x 7.04 µm)
Sensor 1 (7.04µm x 7.04µm)
Figure 13: High Sensitivity Mode
In high sensitivity m od e, the cam era u ses a 7.04 µm x 7.04 µm p ixel and cap tu res the sam e im age tw ice,
resu lting in a brighter im age.
Pixel Detail
7.04 µm
7.04 µm
Sensor 2(7.04µm x 7.04µm)
Sensor 1 (7.04µm x 7.04µm)
Figure 14: Low Sensitivity Mode
In low sensitivity m od e, the cam era u ses a 7.04 µm x 7.04 µm p ixel and cap tu res the im age u sing one
sensor (Sensor 1).
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
31
Trigger Modes
The cam era’s im age exp osu res are initiated by a trigger event. The trigger event is either a p rogram m able
internal signal u sed in free ru nning m od e, an external inp u t u sed for synchronizing exp osu res to external
triggers, or a p rogram m ed fu nction call m essage by the controlling com p u ter. These triggering m od es are
d escribed below .
 Internal trigger (trigger disabled): The cam era free-ru nning m od e has a p rogram m able internal
tim er for line rate and a p rogram m able exp osu re p eriod .
 External trigger (trigger enabled): Exp osu res are controlled by an external trigger signal. The
external trigger signal is the Cam era 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 defined 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 cam era can grab im ages in one of three w ays. You d eterm ine the three im aging m od es u sing a
com bination of the Exp osu re Mod e p aram eters (inclu d ing I/ O p aram eters), Exp osu re Tim e and Line Rate
p aram eters.
Description
Line Rate
Internal line rate and exposure tim e
External line rate and exposure tim e
EXSYN C pulse controlling the line
rate. Program m ed exposure tim e.
Exposure Time
Internal, program m able
Controlled by EXSYN C
pulse
Controlled by EXSYN C
pulse
Trigger Source
(Sync)
Internal program m able
External (EXSYN C)
Internal
External
Internal program m able
External
Figure 15. Exposure controls
The p aram eters u sed to select the im aging m od es—trigger sou rces (sync), exp osu re tim e, and line rate—
are grou p ed together as the Cam era Controls.
Camera Controls
Parameter
Line Rate (in H z)
Exp osu re Mod e
Teledyne DALSA
Description
Cam era line rate in H z. Only available w hen the start line trigger p aram eter
is d isabled (Trigger Mod e off).
Set the op eration m od e for the cam era’s exp osu re.
Trigger Wid th or Tim ed . Trigger Wid th is only available w hen Trigger
Mod e is enabled .
Trigger Width
Uses the w id th of the cu rrent line trigger signal p u lse to control the
exp osu re d u ration.
03-032-20133-01
32
Exp osu re Tim e
Piranha4 8K Camera User's Manual
Timed
The exp osu re d u ration tim e is set u sing the Exp osu re Tim e featu re and the
exp osu re starts w ith the Line Start event.
Sets the exp osu re tim e (in m icrosecond s). Exp osu re Mod e featu re m u st be
set to Tim ed
Exposure Modes in Detail
1. Internally Programmable Line rate and Internally Programmable Exposure Time (Default)
Line rate is the d om inant factor w hen ad ju sting the line rate or exp osu re tim e. When setting the line rate,
exp osu re tim e w ill d ecrease, if necessary, to accom m od ate the new line rate. When ad ju sting the
exp osu re tim e the range is lim ited by the line rate.
Note: The cam era w ill not set line p eriod s shorter than the read ou t p eriod .
GenICam parameters to set:
I / O Controls > Trigger Mode > Off
2. External Line Rate and External Exposure Time (Trigger Width)
In this m od e, EXSYN C sets both the line p eriod and the exp osu re tim e. The rising ed ge of EXSYN C m arks
the beginning of the exp osu re and the falling ed ge initiates read ou t. N ote:
maximum line rate =
1
(exposure time + low time*)
*Exposure time must be greater than 6 µs and low time greater than 1,500 ns
GenICam parameters to set:
 I / O Controls > Trigger Mode > On
 Camera Control > Exposure Mode > Trigger Width
Warning! When ru nning external line rate and external exp osu re tim e, the line rate m u st not exceed 1 /
(exp osu re tim e + 1,500 ns). Und er these cond itions the exp osu re tim e w ill becom e ind eterm inate and
resu lt in im age artefacts. This is not the case w hen ru nning internal exp osu re control .
3. External Line Rate, Programmable Exposure Time
In this m od e, the line rate is set externally w ith the falling ed ge of EXSYN C generating the rising ed ge of
a p rogram m able exp osu re tim e.
GenICam parameters to set:
 I / O Controls > Trigger Mode > On
 Camera Control > Exposure Mode > Timed
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
33
1. External Trigger Off, Internal Exposure Control
Free running, not synchronized to any external signal
Programmable Exposure Time 1
Readout 2
Programmable Line Time
2. External Trigger On, Internal Exposure Control
Falling edge triggers start of internal exposure 3
CC1
Programmable Exposure Time
Readout
Line Time
3. External Trigger On, External Exposure Control
Rising edge trigger start of exposure
Falling edge triggers end of exposure / start of readout
CC1
Exposure Time
Readout
Line Time
Notes:
1. Exposure time > 11 micro-seconds
2. Readout time = 14 micro-seconds
3. One addition falling edge during exposure is latched
Figure 16. Exposure Modes
Teledyne DALSA
03-032-20133-01
34
Piranha4 8K Camera User's Manual
Set Line Rate
To set the cam era’s line rate u se the line rate p aram eter, p art of the Cam era Controls set. This featu re can
only be u sed w hen the cam era is in Internal m od e—that is, w hen the start line trigger is d isabled (Trigger
Mod e Off).
maximum line rate =
1
(exposure time + low time*)
*Exposure time must be greater than 6 µs and low time greater than 1,500 ns
N ote: A line rate < 1 / (Exp osu re tim e + 1,500 ns) w ill retu rn an error (―Invalid Param eter‖) if this
cond ition is not m et. You m u st ad ju st these tw o p aram eters in the correct sequ ence to m aintain this
cond ition.
If the external line rate exceed s 70 kH z the cam era w ill continu e to ou tp u t d ata at its m axim u m line rate
of 70 kH z. Thou gh no im age artefacts associated w ith over -sp eed w ill occu r, you m ay notice that u nd er
over-sp eed cond itions the im age w ill ap p ear com p ressed and the ap p arent d istance travelled w ill be
red u ced .
Camera Control
Parameter
Line Rate (in H z)
Description
Cam era line rate in a range from 1 H z to 70 KH z.
This featu re is only available w hen the cam era is in Internal Mod e—
line trigger is d isabled (Trigger Mod e off).
Line Rates
Camera Link Configuration
Maximum Line Rate
Base
20 kH z (Up to 41 kH z w ith the u se of horizontal binning at 2x)
Med iu m
41 kH z
Full
70 kH z
Set Exposure Time
To set the cam era’s exp osu re tim e, u se the Exposure Time p aram eter—a m em ber of the Cam era Controls
set. This featu re is only available w hen the Exposure Mode p aram eter is set to Timed. The allow able
exp osu re range is from 11 µs to 3,000 µs, d ep end ent on the valu e of the internal line rate.
GenICam parameters:
Camera Controls > Exposure Time (Timed Exposure Mode) > 11 µs to 3,000 µs.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
35
Control Gain and Black Level
The cameras p rovid e gain and black level ad ju stments in the d igital d om ain for the CMOS sensor. The
gain and black level controls can m ake small com p ensations to the acqu isition in situ ations w here
lighting varies and the lens iris cannot be easily ad ju sted . The u ser can evalu ate gain and black level by
u sing CamExp ert.
The p aram eters that control gain and black level are grou p ed together in the Cam era Controls set.
Camera Controls
Black Level
Ap p ly a d igital ad d ition after an FPN correction: ± 1/ 8 of available range. For
exam p le in 12-bit m od e the available range is -512 to +511.
Set the gain as an am p lification factor ap p lied to the vid eo signal across all
p ixels: 1x to 10x.
Gain
Set Image Size
To set the height of the im age, and therefore the nu m ber of lines to scan, u se the p aram eters grou p ed
u nd er the Im age Form at Control set.
Image Format Control
Control the size of the transm itted im age
Wid th
Wid th of the im age. Read only.
H eight
H eight of the im age in lines. Read only.
Pixel Form at
Mono 8, Mono 10, or Mono 12 bit d ep th to Cam era Link.
Test Im age Selector
Select an internal test im age:
Off
Ram p
A5
Each Tap Fixed
All 1365
All 1
Set Baud Rate
The bau d rate sets the sp eed (in bits p er second —bp s) of the serial com m u nication p ort and is available as
p art of the Serial Port Control p aram eters.
Serial Port Control
Action
Control the bau d rate u sed by the
cam era’s serial p ort
Teledyne DALSA
Parameter
Bau d Rate
Options
9600 (factory d efau lt)
19200
57600
115200
230400*
03-032-20133-01
36
Piranha4 8K Camera User's Manual
460800*
921600*
N ote: Du ring connection Cam Exp ert
au tom atically sets the cam era to
m axim u m allow able bau d .
N u m ber of bits p er character u sed in the
serial p ort
Parity of the serial p ort
Data Size
*You r system requ ires a Px8 fram e
grabber to achieve these bau d rates.
8
Parity
N one
N u m ber of stop bits p er character u sed
in the serial p ort
N u m ber of Stop
Bits
1
Pixel Format
Use the Pixel Form at featu re, fou nd in the Image Format Control set, to select the form at of the p ixel to
u se d u ring im age acqu isition, as either Mono 8, Mono 10, or Mono 12 bit d ep th.
GigE Vision Input Controls
Image Format Control
Parameter
Pixel Form at
Description
Mono 8*
Mono 10
Mono 12
*Only available form at for Full Cam eraLink configu ration.
Camera Direction Control
Fou nd in the Camera Control > D irection Control set of featu res. N ote: This featu re is only available
w hen in high sensitivity m od e only (TDI stage 2).
N ote: the Sensor Shift featu res are not available w hen the cam era is in low or tall p ixel sensitivity m od es.
GigE Vision Input Controls
Camera Control > Direction Control
Parameter
Scan Direction Sou rce
Scan Direction
03-032-20133-01
Description
When in TDI stages 2, this com m and lets you select the
Internal or external direction control. Use this featu re to
accom m od ate object d irection change on a w eb and to
m ou nt the cam era "u p sid e d ow n ."
Read the cu rrent d irection.
Teledyne DALSA
Piranha4 8K Camera User's Manual
37
Sensor Shift Direction Example
When in high sensitivity m od e, you can select either forw ard or reverse sensor shift d irection. Selectable
d irection accom m od ates object d irection change on a w eb and allow s you to m ou nt the cam era ―u p sid e
d ow n‖.
N ote that the exam p le here assu m es the u se of a lens (w hich inverts the im age).
Figure 17: Object Movement and Camera Direction Example using an Lens
Pixel Readout Direction (Mirroring Mode)
Set the tap read ou t from left to right or from right to left. This featu re is esp ecially u sefu l if you w ant to
m ou nt the cam era ―u p sid e d ow n.‖
GigE Vision Input Controls
Image Format Control
Parameter
ReverseX
Teledyne DALSA
Description
Off: All p ixels are read ou t from left to right.
On: All p ixels are read ou t from right to left.
03-032-20133-01
38
Piranha4 8K Camera User's Manual
Binning
Binning is the com bining of tw o or m ore im age sensor p ixels to form a new com bined p ixel. A binned
im age u sing the sam e exp osu re settings as a non -binned im age w ill show an im p roved signal-to-noise
ratio, red u ced scanning tim es (d u e to low er sp atial resolu tion) and save as a sm aller im age file size
com p ared w ith a non-binned im age, at the exp ense of low er im age resolu tion.
In 2 x 2 binning, 4 p hysical p ixels on the sensor are com bined into one im age p ixel. This op erating m od e
is id eal for ap p lications that requ ire faster acqu isition and p rocessing tim es and requ ire greater signal
collection.
For this cam era, the d efau lt binning valu e is 1 x 1,
The Binning Vertical and Binning Horizontal featu res in the Image Format Control set rep resents the
nu m ber of horizontal p ixels that w ill be com bined (ad d ed ) together.
N ote: Com p ared to ru nning the cam era in high -sensitivity m od e, ru nning the cam era in 2 x 2 binning
m od e w ill resu lt in 4x resp onsivity, not 2x.
GigE Vision Input Controls
Image Format Control
Parameter
Binning Vertical
Binning H orizontal
Description
This featu re rep resents the nu m ber of vertical p hotosensitive cells that m u st be com bined (ad d ed ) together : 2.
N ote: TDI stages m u st be set to 1 before vertical binning
can be changed to 2x.
This featu re rep resents the nu m ber of horiz ontal p hotosensitive cells that m u st be com bined (ad d ed ) together.
Figure 18: 2x2 Binning in Area Mode
Resetting the Camera
The featu re Camera Reset, p art of the Transport Layer set, resets the cam era. The cam era resets w ith the
d efau lt settings, inclu d ing a bau d rate of 9600.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
39
GigE Vision Input Controls
Transport Layer
Parameter
Description
Cam era Reset
Resets the cam era and p u ts in the d efau lt settings, inclu d ing a 9600 bau d
rate.
Calibrating the Camera
Important N ote: to ensu re best resu lts, the cond itions u nd er w hich you calibrate the cam era (e.g.
tem p eratu re and illu m ination) shou ld be as close to the actu al op erating cond itions as p ossible. .
Figure 19: Flat Field Calibration in CamExpert
Digital Processing (monochrome)
x
-
Video
Calibrate FPN
flatfieldCalibrationFPN
(ccf)
+
Calibrate
PRNU
flatfieldCorrectionMode
flatfieldCalibrationPRNU
flatfieldCorrectionAlgorithm
(cpa,ffm)
Filter Threshold
ImageEnhancementStrength
(sft)
x
Offset
Gain
BlackLevel
(ssb)
Gain
(ssg)
Output
Lookup
Table
Output
Video
FileSelector
“Output_LUT”
Figure 20: Camera Calibration Process.
1. Flat Field
This Flat Field set contains a nu m ber of featu res that are u sed to correct im age d istortion d u e to lens
vignetting and u neven illu m ination . .
N ote:
1. Flat field coefficients consist of an offset and gain for each p ixel.
2. These are the first u ser corrections ap p lied to the im age.
3. The flat field coefficients are saved and load ed w ith the u ser set .
Parameter
flatfield CorrectionMod e
Teledyne DALSA
Description
1.
2.
3.
Off – Flat field correction coefficients are not ap p lied .
On – Flat field correction coefficients are ap p lied .
Initialize – Send ing this valu e w ill reset all cu rrent coefficients
(offsets to 0 and gains to 1x).
03-032-20133-01
40
flatfield CorrectionAlgorithm
Piranha4 8K Camera User's Manual
1.
2.
flatfield CalibrationTarget
1.
2.
flatfield CalibrationSam p leSize
1.
2.
1.
flatfield CalibrationROIOffsetX
Basic – Direct calcu lation of coefficients based on cu rrent
average line valu es and target.
Low Pass – A low p ass filter is first ap p lied to the cu rrent
average line valu es before calcu lating the coefficients. Use this
algorithm if the calibration target is not u niform w hite or it s
not p ossible to d efocu s the im age. Becau se of the low p ass filter
this algorithm is not able to correct p ixel-to-p ixel variations and
so it is p referable to u se the ―Basic‖ algorithm if p ossible.
After calibration all p ixels w ill be scaled to ou tp u t this level
Range d ep end s on p ixel form at:
 8 bit: 0 to 255 DN
 10 bit: 0 to 1023 DN
 12 bit: 0 to 4095 DN
N u m ber of lines to average w hen calibrating
2048 or 4096
Together w ith ―flatfield CalibrationROIWid th‖ sp ecifies the
range of p ixels to be calibrated . Pixel coefficients ou tsid e this
range are n ot changed . It is p ossible to calibrate d ifferent
regions sequ entially.
flatfield CalibrationROIWid th
flatfield CalibrationFPN
1.
2.
flatfield CalibrationPRN U
3.
4.
1.
2.
3.
Save average line (of ―flatfield CalibrationSam p leSize‖ row s).
This is the first u ser correction ap p lied – it is su btracted from
each line.
This featu re m ay not be of u se to m any u sers as the cam era
alread y su btracts tru e ―d ark cu rrent‖, bu t it m ay be u sefu l for
som e to p rovid e a p er p ixel offset correction.
Range 0 to 511 DN , 12 bit
Defau lt valu e is 0 DN for each p ixel
Use ―flatfield CorrectionAlgorithm ‖ to calcu late the p er p ixel
gain to achieve the sp ecified target ou tp u t.
Range 0 to 15.9998x
Defau lt 1x
2. Contrast Enhancement
Tw o featu res to m axim ize the u se of the ou tp u t d ynam ic range (esp ecially w hen p ixel form at is less than
12 bits). Typ ical u se is to su btract m inim u m p ixel valu e exp ected and then gain u p m axim u m p ixel valu e
to ap p roach fu ll scale.
Offset
1. Single valu e ad d ed to each p ixel
2. Range -512 to 511 DN , scaled d ow n accord ing to p ixel form at
3. Positive valu es m ay be u sed to m easu re d ark noise
Gain
1. Floating p oint d igital m u ltip lier ap p lied to each p ixel
2. Range 1x to 10x
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
41
Appendix A: GenICam
Commands
This ap p end ix lists the available GenICam cam era featu res. Access these featu res u sing the Cam Exp ert
interface.
D eviceInformation “Camera Information” Group
N ame
D eviceModelN ame
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Mod el‖
Stand ard
Beginner
Read -only
String
―P4_CM_08K070_00_R‖
N ame
D eviceVendorN ame
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Vend or‖
Stand ard
Beginner
Read -only
String
―Teled yne DALSA‖
N ame
D eviceID
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Serial N u m ber‖
Stand ard
Exp ert
Read -only
String
e.g. ―15005465‖
N ame
D eviceFirmw areVersion
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Microcod e Version ‖
Stand ard
Exp ert
Read -only
String
e.g. ―03-081-20235-03‖
Teledyne DALSA
03-032-20133-01
42
Piranha4 8K Camera User's Manual
N ame
D eviceVersion
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"CCI Version‖
Stand ard
Exp ert
Read -only
String
e.g. ―03-110-20242-03‖
N ame
D eviceManufacturerInfo
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"FPGA Version ‖
Stand ard
Exp ert
Read -only
String
e.g. ―03-056-20378-04‖
N ame
D eviceBISTStatus
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Pow er-on Statu s‖
Cu stom
Beginner
Read -only
String
―Good ‖
I2C
1
FPGA_NO_INIT
10
FPGA_NO_DONE
100
EXT_SRAM
1000
ECHO_BACK
1,0000
FLASH_TIMEOUT
10,0000
FLASH_ERROR
100,0000
NO_FPGA_CODE
1000,0000
NO_COMMON_SETTINGS
1,0000,0000
NO_FACTORY_SETTINGS
10,0000,0000
NO_USER_SETTINGS
100,0000,0000
NO_FLAT_FIELD
1000,0000,0000
NO_ADC_COEFFICIENTS
1,0000,0000,0000
NO_FPN_MIN
10,0000,0000,0000
NO_FPN_MAX
100,0000,0000,0000
NO_PRNU_HI
1000,0000,0000,0000
NO_FEED
1,0000,0000,0000,0000
NO_LINEARITY
10,0000,0000,0000,0000
SYNC_ERROR
100,0000,0000,0000,0000
OVER_TEMPERATURE
1000,0000,0000,0000,0000
SPI
1,0000,0000,0000,0000,0000
NO_USER_FPN
10,0000,0000,0000,0000,0000
PLL_LOCK_FAILED
100,0000,0000,0000,0000,0000
INVALID_CCI
1000,0000,0000,0000,0000,0000
NO_LUT
1,0000,0000,0000,0000,0000,0000
If the LED is green then this featu re w ill retu rn the string ―Good ‖. If the LED is red then
it w ill a string of flags that ind icate all the things that are w rong. More than one flag can
be set. Most are for Teled yne DALSA to trou ble shoot the cam era. The ones that the u ser
can d o som ething abou t are:
 N O_COMMON _SETTIN GS, N O_USER_SETTIN GS, N O_FLAT_FIELD, and
N O_USER_FPN all ind icate that the saved settings have been corru p ted
Descrip tion
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual

43
(p ossibly from the cam era losing p ow er w hile saving). The firm w a re w ill
initialize the cu rrent valu es to d efau lts. The u ser shou ld save these settings.
Reset cam era to clear error.
OVER_TEMPERATURE – Internal cam era tem p eratu re has exceed ed 75 C.
There w ill be N O OUTPUT. The u ser shou ld resolve w hy the cam era is
overheating (e.g. p oor heat sink, no air m ovem ent) and then reset the cam era.
N ame
D eviceLED ColorControl
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"LED Colou r‖
Cu stom
Exp ert
Read -only
String
―Green‖
―Light Blu e‖
―Red ‖
―Dark Blu e‖
N ame
D eviceTemperature
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
"Tem p eratu re‖
Stand ard
Beginner
Read -only
Float
Celsiu s
0 to 75 C
N ame
InputVoltage
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
"Inp u t Voltage‖
Stand ard
Beginner
Read -only
Float
Volts
12 to 24 volts
N ame
UserSetD efaultSelector
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Pow er-on User Set‖
Stand ard
Beginner
Read -Write
Enu m eration
"Factory"
"UserSet1" to ―UserSet8‖
This valu e sp ecifies w hich u ser set w ill be load ed at p ow er -on.
This valu e is au tom atically saved w hen w ritten.
Descrip tion
Teledyne DALSA
– Read y
– Bu sy, p ow ering u p or ru nning calibration com m and
– Error, check BiST
– In boot load er
03-032-20133-01
44
Piranha4 8K Camera User's Manual
N ame
UserSetSelector
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Cu rrent User Set‖
Stand ard
Beginner
Read -Write
Enu m eration
"Factory"
"UserSet1" to ―UserSet8‖
Param eter for UserSetLoad and UserSetSave that sp ecifies w hich u ser set to act on.
N ame
UserSetLoad
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Load User Set‖
Stand ard
Beginner
Write-only
Com m and
1
Com m and s cam era to load u ser set sp ecified by UserSetSelector and m ake it cu rrent.
N ame
UserSetSave
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Save User Set‖
Stand ard
Beginner
Write -only
Com m and
1
Com m and s cam era to save cu rrent settings to u ser set sp ecified by UserSetSelector.
This featu re is not available w hen UserSetSelector equ als "Factory".
N ame
SecurityUpgrade
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Descrip tion
"License Key‖
Cu stom
Gu ru
Read -Write
String
A license key string w ill be sent by Teled yne DALSA if a featu re u p grad e is p u rchased .
deviceSensorControl “Camera Control” Group
N ame
TriggerMode
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Trigger Mod e‖
Stand ard
Beginner
Read -Write
Enu m eration
―Off‖ - Internal p rogram m able line rate u sed , see Acqu isitionLineRate
―On‖ - Trigger p rovid ed on CC1
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
45
N ame
AcquisitionLineRate
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
Descrip tion
"Internal Line Rate‖
Stand ard
Beginner
Read - Write
Integer
H ertz
1 to 70,000
Maxim u m line rate is lim ited by exp osu re tim e, Cam era Link m od e, and horizontal
binning.
N ame
MeasureLineRate
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
―Measu red Line Rate‖
Cu stom
Beginner
Read -only
Integer
H ertz
Use to verify signal on CC1 w hen ―TriggerMod e‖ = ―On‖
N ame
ExposureMode
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
―Exp osu re Tim e Sou rce‖
Stand ard
Beginner
Read - Write
Enu m eration
―Tim ed ‖
- Exp osu re tim e is set w ith Exp osu reTim e
―TriggerWid th‖ - Exp osu re tim e equ als high tim e of CC1 signal.
―TriggerWid th‖ is only available w hen TriggerMod e equ als ―On‖
N ame
ExposureTime
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
Descrip tion
―Exp osu re Tim e‖
Stand ard
Beginner
Read -Write
Float
Micro-second s
11 to 300
Maxim u m exp osu re tim e is lim ited by the line rate.
N ame
MeasureExposureTime
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
"Measu red Exp osu re Tim e‖
Cu stom
Beginner
Read -only
Integer
N ano-second s
11,000 to 300,000
Teledyne DALSA
03-032-20133-01
46
Piranha4 8K Camera User's Manual
N ame
SensorTD IStagesSelection
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"TDI Stages‖
Stand ard
Beginner
Read -Write
Integer
1 or 2
N ame
ScanD irectionSource
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Direction Sou rce‖
Stand ard
Beginner
Read -Write
Enu m eration
―Internal‖
- Scan d irection controlled by SensorScanDirection
―External‖
- Scan d irection controlled by CC3
CC3 low selects forw ard , high selects reverse
N ame
SensorScanD irection
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Internal Direction‖
Stand ard
Beginner
Read -Write
Enu m eration
"Forw ard "
"Reverse"
The d irection control featu res are only available w hen SensorTDIStagesSelection equ als
tw o. This featu re controls w hich row is d elayed before su m m ing.
Descrip tion
N ame
BlackLevel
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
"Offset‖
Stand ard
Beginner
Read -Write
Integer
DN
-32 to 31
-128 to 127
-512 to 511
N ame
Gain
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Units
Valu es
"Gain‖
Stand ard
Beginner
Read -Write
Float
Mu ltip lier
1 to 10
03-032-20133-01
When PixelForm at equ als "Mono8"
When PixelForm at equ als "Mono10"
When PixelForm at equ als "Mono12"
Teledyne DALSA
Piranha4 8K Camera User's Manual
N ame
ClConfiguration
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Cam era Link Configu ration ‖
Stand ard
Beginner
Read -Write
Enu m eration
―Base‖
―Med iu m ‖
―Fu ll‖
47
ImageFormatControl “Image Format” Group
N ame
TestImageSelector
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Test Pattern ‖
Stand ard
Beginner
Read -Write
Enu m eration
―Off‖
―Ram p ‖
―A5‖
―Each_tap _fixed ‖
―All_1365‖
―All_1‖
All p rocessing (e.g. gain) is d isabled w hen a test p attern is selected
N ame
BinningVertical
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Vertical Binning‖
Stand ard
Beginner
Read -Write
Integer
1 or 2
SensorTDIStagesSelection m u st be equ al to one to set this featu re to tw o
N ame
BinningHorizontal
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"H orizontal Binning‖
Stand ard
Beginner
Read -Write
Integer
1 or 2
Teledyne DALSA
03-032-20133-01
48
Piranha4 8K Camera User's Manual
N ame
ReverseX
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Line Mirroring‖
Stand ard
Beginner
Read -Write
Enu m eration
―Off‖ ―On‖ - Pixel ord er is reversed
N ame
PixelFormat
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Pixel Form at‖
Stand ard
Beginner
Read -Write
Enu m eration
―Mono8‖
―Mono10‖
―Mono12‖
FileAccessControl “File Access Control” Group
All featu res from the GenICam Stand ard Featu res N am ing Convention have been im p lem ented .
N ame
FileSelector
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"File Selector‖
Stand ard
Exp ert
Read -Write
Enu m eration
―User_Set‖
"User_FPN "
"Flat_Field "
"Ou tp u t_LUT"
"FPGA_Cod e"
"Microcod e"
"CCI"
"XML"
03-032-20133-01
- Use UserSetSelector to sp ecify
- Use UserSetSelector to sp ecify
- Use UserSetSelector to sp ecify
- Use UserSetSelector to sp ecify
- Used for firm w are u p grad es
- Used for firm w are u p grad es
- Used for firm w are u p grad es
- Used for firm w are u p grad es
w hich
w hich
w hich
w hich
u ser
u ser
u ser
u ser
set to access
FPN to access
flat field to access
ou tp u t LUT to access
Teledyne DALSA
Piranha4 8K Camera User's Manual
49
serialPortControl ”Serial Port” Group
N ame
D eviceSerialPortBaudRate
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
―Bau d Rate‖
Stand ard
Exp ert
Read -Write
Enu m eration
―Bau d _9600‖ (factory d efau lt)
―Bau d _19200‖
―Bau d _57600‖
―Bau d _115200‖
―Bau d _230400‖*
―Bau d _460800‖*
―Bau d _921600‖*
N ote: Du ring connection Cam Exp ert au tom atically sets the cam era to m axim u m
allow able bau d .
*You r system requ ires a Px8 fram e grabber to achieve these bau d rates.
dataProcessing “Flat Field” Group
This grou p contains a nu m ber of featu res to correct im age d istortion d u e to lens vignetting and u neven
illu m ination:
1. Flat field coefficients consist of an offset and gain for each p ixel
2. These are the first u ser corrections ap p lied to the im age
3. The flat field coefficients are saved and load ed w ith the u ser set
N ame
flatfieldCorrectionMode
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
―Mod e‖
Cu stom
Beginner
Read -Write
Enu m eration
―Off‖
―On‖
―Initialize‖
N ame
flatfieldCorrectionAlgorithm
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Calibration Algorithm ‖
Cu stom
Exp ert
Read -Write
Enu m eration
―Basic‖
Direct calcu lation of coefficients based on average line valu es and target
―Low Pass‖
A low p ass filter is first ap p lied to the average line valu es before
calcu lating the coefficients. Use this algorithm if the calibration target is
not u niform ly w hite or it is not p ossible to d efocu s the im age. Becau se of
the low p ass filter this algorithm is not able to correct p ixel-to-p ixel
variations and so it is p referable to u se the ―Basic‖ algorithm if p ossible.
Teledyne DALSA
- FPN and flat field coefficients d isabled
- FPN and flat field coefficients enabled
- Reset all FPN to 0 and all flat field coefficients to 1
03-032-20133-01
50
Piranha4 8K Camera User's Manual
N ame
flatfieldCalibrationTarget
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Calibration Target‖
Cu stom
Beginner
Read -Write
Integer
0 to 255
When PixelForm at equ als "Mono8"
0 to 1023
When PixelForm at equ als "Mono10"
0 to 4095
When PixelForm at equ als "Mono12"
N ame
flatfieldCalibrationSampleSize
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Calibration Sam p le Size
Cu stom
Exp ert
Read -Write
Enu m eration
"Lines_2048"
"Lines_4096"
N ame
flatfieldCalibrationROIOffsetX
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"ROI Offset X‖
Cu stom
Exp ert
Read -Write
Integer
1 to 8192
Together w ith flatfield CalibrationROIWid th sp ecifies the p ixels that w ill be calibrate.
Pixel coefficients ou tsid e this region are not changed .
Range is lim ited by flatfield CalibrationROIWid th .
It is p ossible to calibrate d ifferent regions sequ entially.
N ame
flatfieldCalibrationROIWidth
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"ROI Wid th ‖
Cu stom
Exp ert
Read -Write
Integer
1 to 8192
Together w ith flatfield CalibrationROIOffsetX sp ecifies the p ixels that w ill be calibrate.
Pixel coefficients ou tsid e this region are not changed .
Range is lim ited by flatfield CalibrationROIOffsetX.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
51
N ame
flatfieldCalibrationFPN
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Calibrate FPN ‖
Cu stom
Exp ert
Write-only
Com m and
1
Save average line (of ―flatfield CalibrationSam p leSize‖ row s). This is the first u ser
correction ap p lied – it is su btracted from each line.
This featu re m ay not be of u se to m any u sers as the cam era alread y su btracts tru e ―d ark
cu rrent‖, bu t it m ay be u sefu l for som e to p rovid e a p er p ixel offset correction.
Range of FPN valu es is 0 to 511 DN , 12 bit
N ame
flatfieldCalibrationPRN U
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Calibrate PRN U‖
Cu stom
Beginner
Write-only
Com m and
1
Use ―flatfield CorrectionAlgorithm ‖ to calcu late the p er p ixel gain to achieve the
sp ecified target ou tp u t.
Range 0 to 15.9998x
N ame
ImageEnhancementStrength
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
Descrip tion
"Filter Threshold ‖
Cu stom
Gu ru
Read -Write
Integer
0 to 16, 0 d isables the filter
The im age enhancem ent filter seeks to im p rove the visu al ap p earance of an im age and
to rep resent the im age to a form better su ited for m achine analys is. The im age
enhancem ent filter is ap p lied betw een flat-field and offset. The filter algorithm is:
for each p ixel P i w here 1 < i < 8092 d o
if TDI stages = 1 and vertical binning = 1 then
if abs( P i – P i-1 ) + abs( P i+1 – P i) < Im ageEnhancem entStrength / 2 then
P i = 0.125 x P i-1 + 0.75 x P i + 0.125 x P i+1
end if
else
if abs( P i – P i-1 ) + abs( P i+1 – P i) < Im ageEnhancem entStrength then
P i = 0.25 x P i-1 + 0.5 x P i + 0.25 x P i+1
end if
end if
next p ixel
Teledyne DALSA
03-032-20133-01
52
Piranha4 8K Camera User's Manual
TransportLayerControl “Transport Layer” Group
N ame
D eviceReset
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Restart Cam era‖
Stand ard
Exp ert
Write-only
Com m and
1
N ame
D eviceManifestXMLMajorVersion
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Descrip tion
"XML Major Version ‖
Stand ard
Exp ert
Read -only
Integer
Together w ith DeviceManifestXMLMinorVersion sp ecifies the GenICam featu re
d escrip tion XML file version
N ame
D eviceManifestXMLMinorVersion
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Descrip tion
"XML Minor Version‖
Stand ard
Exp ert
Read -only
Integer
Together w ith DeviceManifestXMLMajorVersion sp ecifies the GenICam featu re
d escrip tion XML file version
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
N ame
GenCPStatus
Disp lay N am e
N am e Sp ace
Visibility
Access
Typ e
Valu es
"Last GenCP Statu s‖
Cu stom
Exp ert
Read -only
Integer
1. GenCP stand ard errors:
SUCCESS
NOT_IMPLEMENTED
INVALID_PARAMETER
INVALID_ADDRESS
WRITE_PROTECT
BAD_ALIGNMENT
ACCESS_DENIED
BUSY
LOCAL_PROBLEM
MISMATCH
INVALID_PROTOCOL
MSG_TIMEOUT
WRONG_CONFIG
INVALID_HEADER
GENERIC_ERROR
2. Teled yne DALSA P4 sp ecific errors:
I2C
FPGA_NO_CODE
FPGA_NO_INIT
FPGA_NO_DONE
NO_COMMON_SETTINGS
FLASH_TIMEOUT
FLASH_ERROR
SET_NOT_SAVED
NO_FACTORY_SETTINGS
NO_USER_SETTINGS
NO_FLAT_FIELD
EXT_SRAM
FPGA_ID
ECHO_BACK
FILE_TOO_BIG
NO_ADC_COEFFICIENTS
NO_FPN_LO
NO_FPN_HI
NO_PRNU
INVALID_FILE
FILE_NOT_OPEN
NO_XML
NO_FEED_THROUGH
NO_LINEARITY
SYNC_ERROR
OVER_TEMPERATURE
GET_LINE_TIMEOUT
CPA_TOO_MANY_OUTLIERS
NO_USER_FPN
USER_FPN_CLIPPING
FLAT_FIELD_CLIPPING
PLL_LOCK_FAILED
Teledyne DALSA
53
0x0000
0x8001
0x8002
0x8003
0x8004
0x8005
0x8006
0x8007
0x8008
0x8009
0x800A
0x800B
0x800F
0x8010
0x8FFF
0xC001
0xC002
0xC003
0xC004
0xC005
0xC006
0xC007
0xC008
0xC009
0xC00A
0xC00B
0xC00C
0xC00D
0xC00E
0xC00F
0xC010
0xC011
0xC012
0xC013
0xC014
0xC015
0xC016
0xC017
0xC018
0xC019
0xC01A
0xC01B
0xC01C
0xC01D
0x401E
0x401F
0xC020
03-032-20133-01
54
Descrip tion
Piranha4 8K Camera User's Manual
1.
2.
3.
4.
03-032-20133-01
INVALID_CCI
0xC021
NO_LUT
0xC022
If a featu re read or w rite fails then Sap era only retu rns that it fails – read this
featu re to get the actu al reason for the failu re
Retu rns the last error
Read ing this featu re clears it
Descrip tion of m ost com m on
a. SUCCESS
Com m and execu ted as exp ected
b. IN VALID_PARAMETER
Most likely ou t of range. Som etim es range changes d ep end ing on other
featu res. For exam p le, exp osu re tim e m u st fit w ith line rate.
c. IN VALID_ADDRESS
Register (featu re) not im p lem ented in cam era
d . IN VALID_FILE
Likely trying to u p load the w rong file – e.g. u p load ing XML file after
selecting m icrocod e
e. OVER_TEMPERATURE
Internal cam era exceed s 75 C. Cam era shu ts d ow n a nu m ber of the hot
com p onents and so there is no vid eo ou tp u t. M u st resolve w hy the
cam era has over heated (e.g. p oor heat sink or air flow ) and then reset
cam era to re-enable ou tp u t.
f. GET_LIN E_TIMEOUT
Attem p ting u ser FPN or flat field calibration in external trigger m od e
w ithou t p rovid ing an EXSYN C
g. CPA_TOO_MAN Y_OUTLIERS
Flat field calibration u sing low -p ass filter algorithm failed becau se
im age is not su fficiently u niform
h. USER_FPN _CLIPPIN G
Warning (com m and still execu ted ) – Du ring calibration som e of the
u ser FPN coefficients w ere clip p ed to the m axim u m 511 DN (12 bit) –
red o w ith less light, or shortened exp osu re tim e
i. FLAT_FIELD_CLIPPIN G
Warning (com m and still execu ted ) – Du ring calibration som e of the
u ser flat field coefficients w ere clip p ed to the m axim u m 16x – red o w ith
an initially flatter im age
Teledyne DALSA
Piranha4 8K Camera User's Manual
55
Appendix B: ASCII Commands
The follow ing com m and s can be u sed to control the Teled yne DALSA Piranha4 P4-CM-08K070-00-R
cam era.
To access the TLC an ASCII-based com m u nications tool, su ch as H yp erterm inal or equ ivalent, m u st be
u sed .
First, cycle p ow er to the cam era either by issu ing the reset cam era (rc) com m and or by p ow ering the
cam era OFF and then ON . N ext, load the ASCII interface. Finally, p ress the <ESC> key. (N ote that w hile
the cam era is initializing the <ESC> com m and is ignored .) A list of the available com m and s w ill d isp lay.
To sw itch from the ASCII-com m and interface to the GenCP interface, the cam era m u st be either reset or
go throu gh the p ow er cycle.
N ote that the HyperTerminal application is not available on the Window s 7 OS.
Alternatives to HyperTerminal
The follow ing alternative ASCII-interfaces have been tested and show n to w ork w ith this cam era:
Pu TTY and TeraTerm . N ote that Pu TTY d oes not have Xm od em cap ability w hile TeraTerm d oes.
Xm od en is requ ired to u p d ate cod e in the cam era.
TeraTerm http :/ / logm ett.com / ind ex.p hp ?/ d ow nload / tera -term -473-freew are.htm l
Pu TTY http :/ / p u tty.en.softonic.com /
The cam era resp ond s to a sim p le ASCII-based p rotocol. A carriage retu rn <CR> end s each com m and .
Example: to return the current detector settings
gcp <CR>
A com p lete list of the available d etector com m and s, their form at and p aram eters can be d isp layed by
send ing the help (h) com m and .
Teledyne DALSA
03-032-20133-01
56
Piranha4 8K Camera User's Manual
CCF – Calibrate User FPN
The valu e selected is the nu m ber of lines to average. For m ore inform ation, refer to the GenICam featu re
flatfieldCalibrationFPN .
ccf <2048 | 4096>
CLM – Camera Link Mode
CLM <mode>
Set Cam era Link m od e
CLM
Name
Taps
SPF*
Cables
1
Base
2
8, 10, 12
1
2
Medium
4
8, 10, 12
2
3
Full
8
8
2
* - Set Pixel Form at (nu m ber of bits p er p ixel)
CPA – Flat Field Calibration
CPA <algorithm> <# lines> <target>
<algorithm> 0: Basic or 1: Filter
<# lines> 2048 or 4096
<target>
Integer
0 to 4095 DN in 12 bit mode
0 to 1023 DN in 10 bit mode
0 to 255 DN in 8 bit mode





Perform flat field calibration u sing the average of <# lines>.
With filter algorithm this average line is then sm oothed and ou tlier p ixels are interp olated .
Use this featu re if you r w hite reference is not featu reless.
Ad ju st p ixel gain su ch that ou tp u t w ill be <target>.
The target is first d ivid ed by horizontal binning factor and gain and then the offset is su btracted .
Therefore the ou tp u t w ill go to the target.
 Becau se the PRN U can be less than 1, the target m ay be below the cu rrent m axim u m valu e.
 Flat field coefficients are save as p art of the u ser set - see USS com m and .
FCS – Upload Files
FCS <#>
Up load files to cam era u sing H yp erTerm inal Xm od em p rotocol.
1.
2.
3.
4.
5.
6.
User Set
Flat Field Coefficients
LUT
FPGA
Microcode
CCI
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
57
7. User XML
Sequ ence is:
1. Enter ―FCS <#>‖ com m and from H yp erTerm inal
2. Click on ―Transfer‖
3. Brow se and find file
4. Select ―Xm od em ‖ p rotocol
5. Click ―Send ‖
6. When it ind icates that it is d one click ―Close‖
 Files are not u sed u ntil the cam era is rebooted .
FFM – Flat Field Mode
FFM <mode>
0. Disable flat field correction coefficients
1. Enable flat field correction coefficients
GCP – Get Camera Parameters
GCP
Disp lays cu rrent cam era configu ration p aram eters. For exam p le:
USER>gcp
Model
Microcode
CCI
FPGA
Serial #
BiST:
P4_CM_08K070_00_R
03-081-20235-03
03-110-20242-03
03-056-20378-04
15005465
Good
DefaultSet
Ext Trig
Line Rate
Meas L.R.
Max L.R.
Exp. Mode
Exp. Time
Meas E.T.
Max E.T.
1
Off
10000
10000
19417
Timed
50000
49993
98500
Test Pat.
Direction
TDI Stages
Vert. Bin
Flat Field
Filter
Offset
Gain
Hor. Bin
Mirror
CL Config
0:Off
Internal, Forward
2
1
On
0
0
1.00
1
Off
Full
Teledyne DALSA
[Hz]
[Hz]
[Hz]
[ns]
[ns]
[ns]
03-032-20133-01
58
Piranha4 8K Camera User's Manual
Pixel Fmt
CPA ROI
USER>
8 bits
1-8192
H – Help
H
Disp lay ―help ‖, an alp habetical list of all com m and s.
Also show s the m icrocod e bu ild tim e stam p . For exam p le:
USER>h
P4 (03-081-20235-02): Command Line Interpreter Mar
ccf clm cpa ffm gcp h
rc
roi rpc sbh sbr sbv scd sem set sft smm spf ssb ssf ssg stg stm svm usd usl uss vt
vv
USER>
7 2012, 10:45:18
Calibrate User FPN <2048|4096>
Camera Link Mode <0:Base 1:Med 2:Full>
Calibrate Flatfield <0:basic 1:filter><2048|4096><DN target>
Flat Field Mode <0:Off 1:On>
Display Camera Configuration
Help
Reset Camera
Set Flatfield ROI <1st pixel> <last pixel>
Reset Flatfield Coefficients
Horizontal Binning <1|2>
Set Baud Rate <9600|57600|115200|230400|460800|921600>
Vertical Binning <1|2>
Direction <0:Fwd, 1:Rev 2:Ext>
Exposure Mode <0:Int 1:Ext>
Exposure Time <ns>
Set Filter Threshold <DN>
Mirroring <0:Off 1:On>
Pixel Format <0:8 1:10 2:12 bits>
Offset <DN>
Internal Line Rate <Hz>
Gain f<gain>
TDI Stages <1|2>
External Trigger <0:Off 1:On>
Test Pattern <0,1,3-6>
Default User Set <0-8>
Load User Set <0-8>
Save User Set <1-8>
Temperature <0>
Input Voltage
RC – Reset Camera
RC
The m icro-controller reboots:



Load any file u p d ates
Clear over tem p eratu re cond ition
Perform start u p cam era tests (BiST)
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual




59
Load FPGA cod e
Configu re FPGA and sensor.
Load d efau lt u ser set
Bau d rate set to 9600
ROI – Set Flatfield ROI
roi <1st pixel> <last pixel>
RPC – Reset Flatfield Coefficients
rpc
SBH – Set Binning Horizontal
SBH <#>
1.default
2.
SBR – Set Baud Rate
SBR <#>
 Set com m u nication sp eed w ith the host term inal.
 After typ ing this com m and and p ressing ―Enter‖, change the sp eed of the term inal p rogram to
m atch.
 Valid bau d rates for m ost fram e grabbers are: {9600, 57600, 115200, 230400*, 460800*, 921600*}
*PX8 fram e grabber requ ired .
 The factory d efau lt bau d rate is 9600.
SBV – Set Binning Vertical
SBV <#>
1.Single line output.
2.Tall pixel mode.
 TDI Stage Selection (stg 1)
 In low sensitivity m od e, the cam era m u st be in internal d irection control.
SCD – Set Direction
SCD <#>



Set the d irection that the im age m oves p ast the p air of sensor row s.
That is, the w ay that the FPGA d elays and then su m s the sensor row s.
Usefu l if the cam era is m ou nted u p sid e d ow n.
0. Forward
1. Reverse (Not available in low sensitivity mode)
2. External (Not available in low sensitivity mode)
SEM – Set Exposure Mode
SEM <mode>
Set exp osu re m od e:
Teledyne DALSA
03-032-20133-01
60
Piranha4 8K Camera User's Manual
0. Internal (“Timed”) exposure time
1. External (“PulseWidth”) exposure time
a. Available only when STM = 1 (external trigger on)
b. Exposure occurs when signal on CC1 is high
c. When CC1 signal falls line is read
SET – Set Exposure Time
SET <ns>
Set internal exp osu re tim e in nanosecond s – 25 ns resolu tion.
<ns>
Exposure time in nanoseconds
Integer: 11,000 to 3,000,000 ns
Sp ecial N ote: Line tim e > (Exp osu re tim e + 1,500 ns) w ill retu rn error 0xC002 (GenCP ―Invalid
Param eter‖) if this cond ition is not m et. You m u st ad ju st these tw o p aram eters in the correct sequ ence to
m aintain this cond ition.
SFT – Set Filter Threshold
sft <DN>
The im age enhancem ent filter seeks to im p rove the visu al ap p earance of an im ag e and to rep resent the
im age to a form better su ited for m achine analysis. It im p roves signal to noise ratio by ap p lying an
ad ap tive FIR filter in sp atial d om ain based on local contrast analysis.
<DN>
Range 0 to 16 for dual-line mode, default 5.
Range 0 to 8 for single-line mode, default 2.
N ote: The smaller the nu m ber, the low er the filters effect.
SMM – Set Mirror Mode
smm <#>
0. Off
1. On
SPF – Set Pixel Format
spf <#>
0. 8 bits
1. 10 bits
2. 12 bits (only available with Base or Medium Camera Link configurations)
SSB – Set Offset
SSB <offset>
Set contrast offset – single valu e ad d ed to all p ixels after PRN U/ flat field coefficients (before gain).
<offset>
Signed integer: -512 to 511 (dependent on gain and bit mode)
SSF – Set Line Rate
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
61
SSF <line rate>
Set internal line rate in H ertz.
<line rate> Internal line rate in Hertz.
Integer: 1 to 70,000 Hz
Sp ecial N ote: Line tim e > ( Exp osu re tim e + 1,500 ns ) w ill retu rn error 0xC002 (GenCP ―Invalid
Param eter‖) if this cond ition is not m et. You m u st ad ju st these tw o p aram eters in the correct sequ ence to
m aintain this cond ition.
SSG – Set Gain
SSG f<gain>
Set gain – single value multiplied by all pixels.
Final correction.
<gain> Floating point number: 1.0 to 10.0. Note that gain value must be
preceded by an “f”.
STG – Set TDI Stages
STG <number>
Set TDI stages:
1. Single line, low sensitivity mode. In low sensitivity mode the camera
must be internal direction control.
2. Pair of lines summed with suitable delay, high sensitivity mode.
N ote: STG 2 w ill su p ersed e SBV 2.
STM – Set Trigger Mode
SEM <mode>
Set exp osu re m od e:
1. Internal (“Timed”) exposure time
2. External (“PulseWidth”) exposure time
a. Available only when STM = 1 (external trigger on)
b. Exposure time equals high time of EXSYNC on signal on CC1
SVM – Select Test Pattern
SVM <pattern>
Select sensor vid eo or FPGA generated test p attern:
1. Sensor video
2. Ramp – (good for when STG or SBV is 2)
Teledyne DALSA
03-032-20133-01
62
Piranha4 8K Camera User's Manual
Pixels: { 1, 2, 3,… 4096, 4097, 4098, 4099,…8192 }
Values: { 0, 1, 2,… 4095,
0,
1,
2,…4095 }
3. Ramp - 24 to 4095, 0 to 4095, in low sensitivity mode
Pixels: { 1,
2, 3,…2024; 2025…4072; 4073, 4074, 4075,…6144; 6145…8192 }
Values: { 48, 50, 52,…4094;
4095;
0,
2,
4,…4094;
4095 }
4. Four pixels repeating
Pixels: {
1,
2,
3,
4,
5,
6,
7,
8,
9,… }
Values: { 2730, 2730, 2730, 2730, 4095, 4095, 4095, 4095, 2730,… }
5. Fixed value per tap
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
Pixels (1-2036):
Values:
Pixels (2037-4096):
Values:
Pixels (4097-6157):
Values:
Pixels (6158-8192):
Values:
63
{
1,
2,
3,
4,
5,
6,
7,
8,… }
{ 288, 320, 352, 384, 288, 320, 352, 384,… }
{2037, 2038, 2039, 2040, 2041, 2042, 2043, 2044,… }
{ 416, 448, 480, 512, 416, 448, 480, 512,… }
{4097, 4098, 4099, 4100, 4101, 4102, 4103, 4104,… }
{ 544, 576, 608, 640, 544, 576, 608, 640,… }
{6158, 6159, 6160, 6161, 6162, 6163, 6164, 6165,… }
{ 672, 704, 736, 768, 672, 704, 736, 768,… }
6. Fixed: 1365
Pixels: {
1,
2,
3,… }
Values: { 2730, 2730, 2730,… }
7. Fixed: 1
Pixels: { 1, 2, 3,… }
Values: { 1, 1, 1,… }
VT – Read Temperature
Teledyne DALSA
03-032-20133-01
64
Piranha4 8K Camera User's Manual
TMP <channel>
Read tem p eratu re and d isp lay in d egrees Celsiu s (one d ecim al p lace).
1. Internal camera temperature
USD – User Set Default
USD <set#>
Set User Set Defau lt, that is, the u ser set that w ill be load ed on p ow er u p . Valu e is w ritten to the u ser
flash.
<set#>
0 – Factory set, 1 to 8 – User sets
USL – User Set Load
USL <set#>
Load a p reviou sly saved User Set.
Inclu d es featu res on GCP screen and flat field coefficients.
<set#>
0 – Factory set, 1 to 8 – User sets
USS – User Set Save
USS <set#>
Save a User Set to d ata flash. Inclu d es featu res in GCP screen and flat field coefficients.
<set#>
1 to 8 – User sets, saved to the user flash
VV – Read Voltage
VV
Read and d isp lay inp u t voltage – shou ld betw een 12 and 24 volts for p rop er cam era op eration.
03-032-20133-01
Teledyne DALSA
Piranha4 8K Camera User's Manual
65
EMC Declaration
The CE Mark Evalu ation of the Teled yne DALSA P4-CM-08K070-00-R Cam eras, w hich are
m anu factu red by Teled yne DALSA Inc., m eets the follow ing requ irem ents:
Standard
Test Description
EN 55011, FCC Part 15, CISPR 11, and ICES-003
Rad iated em issions requ irem ents.
EN 61326-1 and EN 55024
Im m u nity to d istu rbances.
Changes or m od ifications not exp ressly ap p roved by Teled yne DALSA cou ld void the u ser's au thority to
op erate the equ ip m ent.
N ame and Signature of authorized person
H ank H elm ond
Qu ality Manager, Teled yne DALSA Corp .
Dated : Decem ber 22, 2011
Teledyne DALSA
03-032-20133-01
66
Piranha4 8K Camera User's Manual
Revision History
Revision Number
00
01
03-032-20133-01
Change Description
Initial release.
-Revised list of GenICam com m and s ad d ed .
-Calibration process d iagram ad d ed .
-Revised responsivity graph ad d ed .
Revision Date
16-Mar-12
27-June-12
Teledyne DALSA
Piranha4 8K Camera User's Manual
67
Index
exposure
control, 31
external frame rate,
programmable exposure time,
32
externally controlled, 32
internally controlled, 32
exposure m od es
descriptions of, 31
exposure tim e
set, 34
EXSYN C, 18
A
antibloom ing, 9
B
baud rate, 35
binning, 38
black level
control, 35
C
F
calibration, 39
flat field, 39
process chain, 39
cam era control signals, 18
cam era inform ation, 26
cam era interfacing tool, 22
Cam era Link
cables, 18
configurations, 29
input signals, 18
outputs, 19
Cam era Link connector, 15
Cam Expert, 23
certifications, 9
cleaning
sensor window, 6
clock signals, 19
com m and s
ASCII, 55
GenICam, 41
com pliance, 9
connectors, 14
Camera Link, 15
power, 19
factory settings, 26
G
Gain
control, 35
ground ing instructions, 15
GUI
CamExpert, 23
overview, 21
I
im age acquisition, 31
input/ outp ut, 14
interface
mechanical, 8
L
LED
definitions, 20
M
D
d ata bus, 19
DC offset, 9
d irection
sensor shift, 37
web movement, 37
d irection control, 36
m echanical
camera, 11
specifications, 8
m od els, 8
O
operating
ranges, 9
E
EMC Declaration of
Conform ity, 65
Teledyne DALSA
03-032-20133-01
68
Piranha4 8K Camera User's Manual
P
settings
current, 28
default, 29
factory, 26, 29
loading, 27
saving, 27
user, 28
setup
overview, 13
shift d irection, 37
size
image, 35
softw are
required, 8
specifications
mechanical, 8
operating, 9
performance, 8
perform ance specifications, 8
pixel form at, 36
pow er
connector, 19
connectors, 19
guidelines, 19
pinout, 19
precautions, 5
Q
quantum efficiency
graph, 10
R
rand om noise, 9
rebooting, 38
requirem ents
PC, 13
responsivity, 9
graph, 10
revision history, 66
S
TDI Stages, 29
tem perature
verify, 27
test patterns, 25
trigger m od es, 31
V
safety, 5
Sap era, 22
03-032-20133-01
T
voltage
verify, 27
Teledyne DALSA