Piranha4 Camera User’s Manual Monochrome 2K and 4K
sensors | cameras | frame grabbers | processors | software | vision solutions
03-032-20176-06 www.teledynedalsa.com 2 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
N oti ce
© 2018 Tel ed y ne DA L SA All information provided in this manual is believed to be accurate and reliable. No responsibility is assumed by Tel ed yne DA L SA f or i ts use. Tel ed yne DA L SA r eser v es the r i ght t o m ake changes t o thi s information without notice. Reproduction of this manual in whole or in part, by any means, is prohibited without prior permission having been obtai ned f r om Tel ed yne DA L SA .
M icrosoft and Windows are registered trademarks of M icrosoft Corporation in the United States and other countries. Window s, Windows 7, Windows 8 are trademarks of M icrosoft Corporation.
All other trademarks or intellectual pr oper ty ment i oned her ei n bel ong t o thei r r especti v e ow ner s.
Docu ment Date: 15 August 2018 Docu ment N umber : 03-032-20176-06
About Teledyne DALSA Teledyne DALSA is an international high performance semiconductor and Electronics Company that d esi gns, d ev el ops, manuf actur es, and mar k ets d i gi t al i magi ng pr od uct s and sol uti ons, i n ad d i ti on to providing wafer foundry services.
Teledyne DALSA Digital Imaging offers the widest range of machine vision components in the world. From industry-l ead i ng i m age sensor s thr ough pow er f ul and sop hi st i cated camer as, f r ame gr abber s, v i si on pr ocessor s and sof t w ar e t o easy -to-use v i si on appl i ances and cust om v i si on m od ul es.
Contact Teledyne DALSA Tel ed yne DA L SA i s head quar ter ed i n W ater l oo, Ont ar i o, Canad a. W e hav e sal es of f i ces i n t he U SA , Eur ope and A si a, pl us a w or l d w i d e net w or k of r epr esentati v es and agent s to ser v e you ef f i ci ent l y. Contact information for sales and support inquiries, plus links to maps and directions to our offices, can be f ound her e:
Sales Offices: http:/ / w w w .tel ed yned al sa.com/ cor p/ cont act / of f i ces/ Technical Support: http:/ / www.teledynedalsa.com/ imaging/ support/
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 3
Contents
1. System Precautions and Cleaning ______6 Precautions ...... 6 Electrostatic Discharge and the CMOS Sensor ...... 6 2. The Piranha4 Camera ______7 Camera Highlights ...... 7 Camera Performance Specifications ...... 8 Flash Memory Size ...... 9 Environmental Considerations ...... 9 Certifications and Compliance ...... 10 Supported Industry Standards ...... 10 Responsivity ...... 10 Mechanicals ...... 12 Camera Mounting and Heat Sink Considerations...... 14 3. Quick, Simple Steps to Acquire an Image ______15 4. Software and Hardware Setup ______16 Recommended System Requirements ...... 16 Setup Steps: Overview ...... 16 1. Install and Configure Frame Grabber and Software ...... 16 2. Connect Camera Link and Power Cables ...... 16 3. Establish Communicating with the Camera ...... 16 4. Operate the Camera ...... 16 Step 1. Install and Configure the Frame Grabber and Software ...... 17 Install Frame Grabber ...... 17 Install Sapera LT and CamExpert GUI ...... 17 Step 2. Connect Data, Trigger, and Power Cables...... 18 Data Connector: Camera Link ...... 19 Camera Link Bit Definitions ...... 21 Camera Link Drive Capability ...... 22 Input Signals, Camera Link ...... 22 Output Signals, Camera Link Clocking Signals ...... 23 Power Connector ...... 23 LEDs ...... 24 Step 3. Establish Communication with the Camera ...... 24 Power on the camera ...... 24 Connect to the frame grabber ...... 24 Connect to the camera ...... 25 Check LED Status ...... 25 Software Interface ...... 25 Using Sapera CamExpert with Piranha4 Cameras ...... 26 CamExpert Panes ...... 27 4. Camera Operation ______29 Factory Settings ...... 29 Area Mode ...... 29
Teledyne DALSA 03-032-20176-06 4 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Check Camera and Sensor Information ...... 31 Verify Temperature and Voltage ...... 31 Saving and Restoring Camera Settings ...... 32 Camera Link Configuration ...... 34 TDI and Single Line Modes ...... 34 Sensitivity Modes and Pixel Readout ...... 35 Trigger Modes ...... 36 Exposure Controls ...... 36 Exposure Modes in Detail ...... 37 Set Line Rate ...... 39 Set Exposure Time ...... 42 Control Gain and Black Level ...... 42 Set Image Size ...... 43 Set Baud Rate ...... 43 Pixel Format ...... 44 Camera Direction Control ...... 44 Camera Direction ...... 45 Pixel Readout Direction (Mirroring Mode) ...... 45 Resetting the Camera ...... 46 Calibrating the Camera ...... 46 Appendix A: GenICam Commands ______50 Camera Information Category ...... 50 Camera Information Feature Descriptions ...... 51 Camera Configuration Selection Dialog ...... 54 Camera Power-up Configuration ...... 54 User Set Configuration Management ...... 54 Camera Control Category ...... 55 Camera Control Feature Descriptions ...... 56 Multi-Exposure Mode ...... 58 Digital I/O Control Feature Descriptions ...... 62 Flat Field Category ...... 63 Flat Field Control Feature Description ...... 64 Region of Interest (ROI) ...... 65 Image Format Control Category ...... 66 Image Format Control Feature Description ...... 67 Binning ...... 68 Area of Interest (AOI) Setup ...... 69 Instructions on Using the Camera Scan Direction to Control Camera Parameters...... 72 Transport Layer Control Category ...... 75 Transport Layer Feature Descriptions ...... 76 Acquisition and Transfer Control Category ...... 76 Acquisition and Transfer Control Feature Descriptions ...... 77 Serial Port Control Category ...... 78 Serial Port Control Feature Descriptions ...... 78 File Access Control Category ...... 79 File Access Control Feature Descriptions ...... 80 File Access via the CamExpert Tool ...... 81
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 5
Download a List of Camera Parameters ...... 82 Appendix B: ASCII Commands ______84 Port Configuration ...... 85 Disabling the Esc Key for Direct Access to ASCII Commands ...... 86 Commands ...... 86 Appendix C: Error and Warning Messages ______98 Appendix D: Quick Setup and Image Acquisition ______100 Appendix E: The Sensor Window ______103 Cleaning and Protecting Against Dust, Oil, and Scratches ...... 103 Cleaning the Sensor Window...... 104 Appendix F: Camera, Frame Grabber Communication ______105 Setting Up Communication between the Camera and the Frame Grabber 105 EMC Declaration of Conformity ______108 Revision History ______109 Index ______110
Teledyne DALSA 03-032-20176-06 6 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
1. System Precautions and Cleaning
Precautions Read t hese pr ecauti ons and thi s manu al car ef ul l y bef or e usi ng t he camer a.
Conf i r m that the camer a’s pack agi ng i s und am aged bef or e openi ng i t. I f the p ack agi ng i s d amaged pl ease cont act t he r el ated l ogi sti cs per sonnel .
Do not open the housing of the camera. The warranty is void ed i f the housi ng i s opened .
K eep the camer a’s f r ont pl ate temper at ur e i n a r ange of 0 °C to 65 °C during operation.
Do not oper ate t he camer a i n the v i ci ni t y of str ong el ectr om agneti c f i el d s. I n ad d i t i on, av oi d el ectr ost ati c charging, violent vibration, and excess moi stur e.
To cl ean the d ev i ce, avoid electrostatic char ging by usi ng a dry, clean absorbent cotton cloth d ampened w ith a small quantity of pure alcohol. Do not use methylated alcohol. To clean the surface of the camer a hou si ng, use a sof t, d r y cl ot h. To r em ov e sev er e stai ns use a sof t cl ot h d ampened w i th a smal l quanti t y of neutr al d eter gent and t hen w i pe d r y. Do not use v ol at i l e sol v ents such as benzene and thi nner s, as they can d amage the surface fi ni sh. Further cleaning instructions are below.
Though this camera supports hot plugging, it is recommended that you power down and d i sconnect pow er to t he camer a bef or e you add or replace system components. Electrostatic Discharge and the CMOS Sensor Image sensor s and the camera bodies housing ar e suscepti bl e to d am age f r om el ectr ost ati c d i schar ge (ESD). Electrostatic charge introduced to the sensor window surface can induce charge buildup on the und er si d e of t he w i nd ow . The char ge nor m al l y d i ssi p ates w i thi n 24 hour s and the sensor r etur ns t o normal operation.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 7
2. The Piranha4 Camera
Camera Highlights Tel ed yne DA L SA expand s i ts Pi r anha4™ dual line CMOS camera family with 2K and 4K resolution mod el s. The new Pi r anha4 mod el s of f er hi gher speed s and mor e r esponsi v e pi xel s i n a choi ce of si zes and resolutions. Programmable features include multiple region-of-interest, high dynamic range operation, and r apid bi -directional switching, and are designed to meet today’s demanding imaging applicati ons.
Key Features • High speed: up to 100 kHz in TDI mode and up to 200 kHz i n A r ea mod e • Combination of various pixel sizes and resolutions • Bi-directional • Compact camer a body
Programmability • M ul ti pl e Regi ons of I nter est f or calibr ati on and d ata reduction • 8, 10, and 12 bit output • Flat field and lens shading correction • 8 pr ogr amm abl e coef f i ci ent sets • GenICam or ASCII compliant interfacing
Applications • Automated optical inspection • Transportati on safety and security sy stem s • H i gh per f or m ance sor ti ng system s • Materials grading and inspection systems • W eb i nspect i on • General purpose machine vision
Teledyne DALSA 03-032-20176-06 8 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Models The camer a i s av ail able i n the following configurations:
Table 1: Camera Models Comparison Piranha4 Dual Line Model Comparison
Part Number Resolution Maximum Line Rates Pixel Size TDI Mode (Area Mode)
P4-CM-02K 05D-00-R 2048 x 2 pixel s 50 kH z (100 kHz) 10.56 µm x 10.56 µm
P4-CM-02K 10D-00-R 2048 x 2 pixel s 100 kH z (200 kH z) 10.56 µm x 10.56 µm
P4-CM-04K 05D-00-R 4096 x 2 pixel s 50 kH z (100 kHz) 10.56 µm x 10.56 µm
P4-CM-04K 10D-00-R 4096 x 2 pixel s 100 kHz (200 kHz) 10.56 µm x 10.56 µm
Table 2: Software Software Product Number / Version Number Camer a firmw are Embed d ed w i thi n camer a GenI Cam ™ su ppor t (XM L camer a d escr i pti on f i l e) Embed d ed w i thi n camer a Sapera LT, including CamExpert GUI application and V er si on 7.20 or l ater GenI Cam f or Camer a L i nk i m agi ng d r i v er Camera Performance Specifications Table 3: Camera Performance Specifications Specifications Performance Imager For mat H i gh speed CM OS d ual l i ne scan Resolution 2048 x 2 pixels and 4096 x 2 Pixel Size 10.56 µm x 10.56 µm Pixel Fill Factor 100 % Line Rate Up to 100 kHz in TDI mod e (200 kHz ar ea mode) Exposure Time 4 µs to 3 ms Bit Depth 8, 10, and 12 bi t, sel ectabl e Connectors and Mechanicals Control & Data Inter face Base, M ed i um, Full, and Deca Camer a Li nk configurations (2 x SD R-26) Power Connector H i r ose 6-pin mal e ci rcul ar Power Supply + 12 V to + 24 V DC ± 5% Power Dissipation < 11 W (4K), < 8.3 W (2K) Si z e 62 mm (W) x 62 mm (H) x 48 mm (D) M ass < 340 g Oper ati ng Temp 0 °C to 65 °C, front plate temperature Optical Interface Lens Mount M 42 x 1 (2k) and M 58 x 0.75 (4k), F-mount adapter avai l abl e Sensor to Camer a Fr ont Di stance 12 mm Sensor A l i gnment (al i gned to si d es of camer a)
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 9
Θ y (parallelism) 0.08° or 100 µm x ± 100 µm y ± 100 µm z ± 250 µm Θ z ± 0.2° Compliance Regulatory Compliance CE, FCC, and RoH S; GenI Cam
Operating Ranges Performance Notes Single Line Dual Line Dynami c Range 61.5 dB 60 dB Random Noise 3.42 DN* rms 4.16 DN rms FFC enabl ed Broadband Responsivity 430 DN/(nJ/cm2) 677 DN/(nJ/cm2) Gai n 1x to 10x N omi nal r ange 1x to 10x N omi nal r ange DC Offset 7 DN 14 DN FFC enabl ed PRN U < 1% @ 50% Sat < 1% @ 50% Sat FPN < 8 DN < 8 DN SEE 9.52 n J / cm 2 6.05 n J / cm 2 N EE 7.95 p J / cm 2 6.14 p J / cm 2 Antiblooming > 100 x Satur ati on > 100 x Satur ati on Integral non-linearity 1.5 % DN 2.5 % DN *DN = digital number Test Cond i ti ons: • Values measured using 12-bit, 1x gain. • 10 kHz line rate • Light source: broadband, quartz halogen, 3250 K w i th 700 nm I R cut-off filter. • Front plate temperature: 45º C Flash Memory Size
Camera Flash Memory Size P4-CM-02K 05D-00-R 16 M Byte P4-CM-02K 10D-00-R 16 M Byte P4-CM-04K 05D-00-R 16 M Byte P4-CM-04K 10D-00-R 16 M Byte Environmental Considerations
Environmental Specifications Performance Storage temperature range -20 °C to +80 °C Humidity (storage and operation) 15% to 85% rel ative, non-condensing M TBF (mean t i me bet w een f ai l ur es) > 100,000 hour s, typical fiel d operati on
Teledyne DALSA 03-032-20176-06 10 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Certifications and Compliance Compliance EN 55011, FCC Par t 15, CI SPR 11, and ICES-003 Cl ass A Radi ated Emi ssi ons Requi r ements EN 55024 and EN 61326-1 Immunity to Disturbance RoH S per EU Di r ecti v e 2011/ 65/ EC and WEEE per EU Di recti ve 2002/ 96/ EC and Chi na Electr oni c Industr y Standar d SJ/ T11364-2006 GenICam XML Description File, Super set of the GenI Cam™ Stand ar d Featur es N ami ng Conv enti on speci f i cati on V1.5, Camera Link Serial Communication: GenICam™ Generic Control Protocol (GenCP V1.0) Supported Industry Standards GenICam™ Piranha4 cameras are GenI Cam compli ant. They impl ement a superset of the GenICam™ Stand ard Features N ami ng Conventi on specification V1.5.
Thi s d escr i p ti on t akes t he f or m of an XM L d ev i ce d escr i pti on f i l e r especti ng the synt ax d ef i ned by the GenA pi mod u l e of the GenI Cam ™ specification. The camer a uses the GenICam™ Generic Control Protocol (GenCP V 1.0) to communicate over the Camera Link serial port.
For m or e i nf or m ati on see w w w .geni cam.or g. Responsivity The r esponsi v i ty gr aph d escr i bes the sensor r esp onse t o d i f f er ent w av el engths of l i ght (excl ud i ng l ens and light source char acteristics).
Figure 1: Spectral Responsivity vs. Wavelength (Dual Line)
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 11
Figure 2: QE % vs. Wavelength
Figure 3: Relationship between FPN and Temperature
Teledyne DALSA 03-032-20176-06 12 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Mechanicals
[INSERT PDF HERE]
Figure 4: 2K (Top) and 4K (Bottom) Camera Mechanicals
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 13
Figure 5: Nikon M58 to F-Mount Adapter
Figure 6: Piranha4 Heat Sink Accessories Kit Optional Lens Mount and Heat Sink Accessories Part No. Description
AC-LN-00002 M 58 to F-mount ad apter , heav y duty, 12mm BFD, for 4K model AC-LC-00001 M 42x1 to C-mount adapter , 12mm BFD, for 2K model AC-LA-00115 M 42x1 to F-mount adapter , heavy duty, 12mm BFD, for 2K model AC-MS-00108 H eat si nk for 2k and 4k models
Teledyne DALSA 03-032-20176-06 14 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Camera Mounting and Heat Sink Considerations Up to two optional heat sinks can be installed on the Pi ranha4 camer a. A s i l l u str at ed , they ar e i deally positioned to allow close spacing of the cameras. These heat sinks are desi gned to provide adequate convection cooling when not obstructed by enclosures or mounting assemblies.
Tel ed yne DALSA recognises that each cust omer ’ s appli cati on can be unique. In consideration, the P4 camer a heat si nks hav e been d esi gned in such a w ay that they can be repositioned on the different faces of the camer a or r emov ed entirely, depending on the mounting configuration and its heat sinking potential.
Reposi ti oni ng or r emov al of the heat si nks m ust be per f or med w i t h car e i n or d er t o av oi d temper atur e i ssues. The camer a has the abi l i ty t o measur e i t s i nter nal tem per atur e. U se t hi s f eatur e to r ecor d the i nter nal temper at ur e of the camer a w hen it is mounted in your system and operating under t he w or st case cond i ti ons. The camera will stop outputting data if i ts i nter nal temper atur e r eaches 80 °C. Ref er to the V er i f y Temper atur e and V ol t age section for more information.
Figure 7: Heat Sink Installation (4K model)
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 15
3. Quick, Simple Steps to Acquire an Image
For user s w ho are famil iar w ith Camera Li nk camer as, have a basic understanding of their i maging r equi r ements, and w ho ar e pr i m ar i l y i nter ested i n ev al uati ng t he Pi r anha4 camer a, an ov er v i ew of the steps r equ i r ed to get t hi s camer a oper ati onal and acqui r i ng i mages qui ck ly can be found in Appendix D: Quick Setup and Image Acquisition.
Teledyne DALSA 03-032-20176-06 16 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
4. Software and Hardware Setup
Recommended System Requirements To achi ev e best system per f or m ance, the f ol l ow i ng m i ni mu m r equ i r ements ar e r ecom mend ed : • H i gh band w i d t h f r ame gr abber , e.g. Xcel er a-CL PX8 Full Camera Li nk frame gr abber (Part # OR- X8CO-XPF00): w w w .tel ed y ned al sa.com / i maging/ products/ fg/ OR-X8C0-XPF00/ . • Operating systems: Wi ndow s XP / Vi sta / 7, 32 / 64-bit. Setup Steps: Overview Take t he f ol l ow i ng step s i n or d er to setup and run your camer a system. They ar e d escr i bed br i ef l y bel ow and in more detail in the secti ons that follow. 1. Install and Configure Frame Grabber and Software
We r ecom mend the Xcel er a-CL PX8 Full frame grabber or equiv alent, d escr i bed i n d etai l on t he tel ed yned al sa.com si te her e. Follow the manufacturer’s installation instructions.
A GenI Cam ™ compl i ant XM L d ev i ce d escr i pti on f i l e i s embed d ed w i t hi n t he cam er a firmware allowing GenICam™ compl iant appl i cati on t o k now the camer a’ s cap abi l i ti es i mmed i atel y af ter connecti on. Install ing SaperaLT gives you access to the CamExpert GUI, a GenICam™ compli ant appl ication. 2. Connect Camera Link and Power Cables • Connect the Camer a L i nk cabl es f r om the camer a to t he computer . • Connect a p ow er cabl e f r om the camer a to a power supply that can provide a constant voltage betw een +12 VDC and +24 VDC ± 5%. 3. Establish Communicating with the Camera Start the GUI and establish communication with the camer a.
ASCII Commands A s an al ter nat i v e to t he CamExper t (or equ i v al ent) GU I , you can commu ni cate w i th t hi s camer a u si ng A SCI I -based commands. Open up an ASCII interface and press the ESC key, then the communication mod e w i l l be sw i tched i nt o the A SCI I command mode other than the GenICam mode. A compl ete l i st of the command s and a description of how to access them can be found in Appendix B: ASCII Commands. 4. Operate the Camera
At this point you will be ready to start operating the camer a in order to acquire i mages, set camer a functions, and save settings.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 17
Step 1. Install and Configure the Frame Grabber and Software Install Frame Grabber Install a Full configuration Camer a Link frame grabber according to the manufacturer’s description.
W e r ecom mend the Xcel er a-CL PX8 f r ame gr abber or equi v al ent, d escr i bed i n d et ai l on t he tel ed yned al sa.com si te her e. Install Sapera LT and CamExpert GUI
Communicate with the camera using a Camera Link-compl i ant i nter f ace. W e r ecommend you use CamExper t. CamExper t i s t he camer a i nter f aci ng t ool suppor ted by t he Saper a l i br ar y and comes bundled with SaperaLT. U si ng CamExper t i s the si mpl est and qui ck est w ay t o send comm and s to and r ecei v e i nf or m ati on f r om t he camer a.
Camera Link Control Communications The P4 f ami ly of camer as are GenICam™ compli ant. Sapera uses the GenICam™ Generic Control Protocol (GenCP V 1.0) to communicate w ith the camera over the Camer a Link serial port. When communications are first established Sapera will when connecting for the first time downl oad the GenICam™ XML Description file. This file details how to access and control the camera.
Teledyne DALSA 03-032-20176-06 18 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Step 2. Connect Data, Trigger, and Power Cables N ote: the u se of cabl es types and lengths other than those speci f i ed m ay r esul t i n i ncr eased emi ssi on or d ecr eased i m mu ni ty and p er f or mance of the camer a.
Power A +12V to +24V DC Hirose 6-pin Control & Data B B Camera Link 26-pin SDR26 connectors B B Status C Diagnostic LED A C
Figure 8: Input and Output, Trigger, and Power Connectors
WARNING! Grounding Instructions Static electricity can damage electronic components. It’s critical that you dischar ge any static ! el ectr i cal char ge by touchi ng a gr ound ed sur f ace, such as t he met al computer chassi s, bef or e handli ng the camer a hardw are.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 19
Data Connector: Camera Link The camer a u ses tw o Camera Link SDR26 cables transmitting the Camer a L i nk Base, M ed i um, or Full configuration. The figure below shows the SDR26 Camera Link Connector and the tables that fol low list the Camer a L i nk Base, M ed i um, and Full configurations.
For d etai l ed i nf or m ati on on Camer a L i nk pl ease r ef er to the Camer a L i nk Road M ap av ai l abl e f r om t he K now l ed ge Center on the Tel ed yne DA L SA W eb si te: (http:/ / w w w .tel ed y ned al sa.com/ mv / know l ed ge/ ap pnotes.aspx).
Figure 9. Camera Link Connector
Data 2 Control / Data 1 Camera Right Angle Channel Link Camera Right Angle Channel Link Connector Frame Grabber Signal Connector Frame Grabber Signal Connector Connector 1 1 inner shield 1 1 inner shield 14 14 inner shield 14 14 inner shield 2 25 Y0- 2 25 X0- 15 12 Y0+ 15 12 X0+ 3 24 Y1- 3 24 X1- 16 11 Y1+ 16 11 X1+ 4 23 Y2- 4 23 X2- 17 10 Y2+ 17 10 X2+ 5 22 Yclk- 5 22 Xclk- 18 9 Yclk+ 18 9 Xclk+ 6 21 Y3- 6 21 X3- 19 8 Y3+ 19 8 X3+ 7 20 100 ohm 7 20 SerTC+ 20 7 terminated 20 7 SerTC- 8 19 Z0- 8 19 SerTFG- 21 6 Z0+ 21 6 SerTFG+ 9 18 Z1- 9 18 CC1- 22 5 Z1+ 22 5 CC1+ 10 17 Z2- 10 17 CC2+ 23 4 Z2+ 23 4 CC2- 11 16 Zclk- 11 16 CC3- 24 3 Zclk+ 24 3 CC3+ 12 15 Z3- 12 15 CC4+ 25 2 Z3+ 25 2 CC4- 13 13 inner shield 13 13 inner shield 26 26 inner shield 26 26 inner shield *Exterior Overshield is connected to the shells of the connectors on both ends. Unused pairs should be terminated in 100 ohms at both ends of the cable. Inner shield is connected to signal ground inside camera
Teledyne DALSA 03-032-20176-06 20 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full Configuration 8 bits Camera Link Full Configuration Connector 1: Channel link X Connector 2: Channel link Y Connector 3: Channel link Z Camera/Frame Camera/Frame Camera/Frame Grabber Pin Bit Name Grabber Pin Bit Name Grabber Pin Bit Name Tx0/Rx0 D0(0) Tx0/Rx0 D3(0) Tx0/Rx0 D6(0) Tx1/Rx1 D0(1) Tx1/Rx1 D3(1) Tx1/Rx1 D6(1) Tx2/Rx2 D0(2) Tx2/Rx2 D3(2) Tx2/Rx2 D6(2) Tx3/Rx3 D0(3) Tx3/Rx3 D3(3) Tx3/Rx3 D6(3) Tx4/Rx4 D0(4) Tx4/Rx4 D3(4) Tx4/Rx4 D6(4) Tx5/Rx5 D0(7) Tx5/Rx5 D3(7) Tx5/Rx5 D6(7) Tx6/Rx6 D0(5) Tx6/Rx6 D3(5) Tx6/Rx6 D6(5) Tx7/Rx7 D1(0) Tx7/Rx7 D4(0) Tx7/Rx7 D7(0) Tx8/Rx8 D1(1) Tx8/Rx8 D4(1) Tx8/Rx8 D7(1) Tx9/Rx9 D1(2) Tx9/Rx9 D4(2) Tx9/Rx9 D7(2) Tx10/Rx10 D1(6) Tx10/Rx10 D4(6) Tx10/Rx10 D7(6) Tx11/Rx11 D1(7) Tx11/Rx11 D4(7) Tx11/Rx11 D7(7) Tx12/Rx12 D1(3) Tx12/Rx12 D4(3) Tx12/Rx12 D7(3) Tx13/Rx13 D1(4) Tx13/Rx13 D4(4) Tx13/Rx13 D7(4) Tx14/Rx14 D1(5) Tx14/Rx14 D4(5) Tx14/Rx14 D7(5) Tx15/Rx15 D2(0) Tx15/Rx15 D5(0) Tx15/Rx15 Not Used Tx16/Rx16 D2(6) Tx16/Rx16 D5(6) Tx16/Rx16 Not Used Tx17/Rx17 D2(7) Tx17/Rx17 D5(7) Tx17/Rx17 Not Used Tx18/Rx18 D2(1) Tx18/Rx18 D5(1) Tx18/Rx18 Not Used Tx19/Rx19 D2(2) Tx19/Rx19 D5(2) Tx19/Rx19 Not Used Tx20/Rx20 D2(3) Tx20/Rx20 D5(3) Tx20/Rx20 Not Used Tx21/Rx21 D2(4) Tx21/Rx21 D5(4) Tx21/Rx21 Not Used Tx22/Rx22 D2(5) Tx22/Rx22 D5(5) Tx22/Rx22 Not Used Tx23/Rx23 Not Used Tx23/Rx23 Not Used Tx23/Rx23 Not Used Tx24/Rx24 LVAL Tx24/Rx24 LVAL Tx24/Rx24 LVAL Tx25/Rx25 FVAL Tx25/Rx25 FVAL Tx25/Rx25 FVAL Tx26/Rx26 Not Used Tx26/Rx26 Not Used Tx26/Rx26 Not Used Tx27/Rx27 D0(6) Tx27/Rx27 D3(6) Tx27/Rx27 D6(6)
Tap 1 bits are D0(x)...Tap 8 bits are D7(x)
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 21
Camera Link Bit Definitions BASE T0 Configuration Pixel Format Port A Port B Port C Bits 0 thru 7 Bits 0 thru 7 Bits 0 thru 7 Mono 8 Tap 1 LSB..Bi t 7 Tap 2 LSB..Bi t7 xxxxxxx Pixels (1, 3, 5, ... 4093, 4095) Pixels (2, 4, 6, ... 4094, 4096) Mono 12 Tap 1 LSB.. Bi t 7 Tap 1 Bi ts 8,9,10,11 Tap 2 LSB..Bi t 7 Pixels (1, 3, 5, ... 84093, 4095) Pixels (1, 3, 5, ... 4093,4095) Pixels (2,4,6, ... 4094, 4096) Tap 2 Bi ts 8,9,10,11 Pixels (2,4,6, ... 4094, 4096)
Medium T0 Configurati on Pixel Port A Port B Port C Port D Port E Port F Format Bits 0 thru 7 Bits 0 thru 7 Bits 0 thru 7 Bits 0 thru 7 Bits 0 thru 7 Bits 0 thru 7 Mono 8 Tap 1 Tap 2 Tap 3 Tap 4 xxxxxxxx Xxxxxxxx LSB..Bit 7 LSB..Bit 7 LSB..Bit 7 LSB...Bit 7 Pi xel s (1, 5, 9, Pi xel s (2, 6, Pi xel s (3, 7, Pi xel s (4, 8, ... 4089, 4093) 10, ... 4090, 11, ... 4091, 12, ... 4092, 4094) 4095) 4096) M ono 10 / Tap 1 Tap 1 Tap 2 Tap 4 Tap 3 Tap 3 Mono 12 LSB.. Bit 7 Bi ts 8,9,10,11 LSB..Bit 7 LSB…Bit 7 LSB…Bit 7 Bi t 8,9,10,11 Pi xel s (1, 5, 9, Pi xel s (1, 5, 9, Pi xel s (2, 6, Pi xel s (4, 8, Pi xel s (3, 7, Pi xel s (3, 7, ... 4091, 4095) ... 4091, 4095) 10, ... 4092, 12, ... 4090, 11, ... 4089, 11, ... 4089, 4096) 4094) 4093) 4093) Tap 2 Bi ts 8,9,10,11 Tap 4 Pi xel s (2, 6, Bi ts 8,9,10,11 10, ... 4092, Pi xel s (4, 8, 4096) 12, ... 4090, 4094)
Full T0 Configuration Pixel Format Port A Port B Port C Port D Port E Port F Port G Port H LSB…Bit LSB…Bit LSB…Bit LSB…Bit LSB…Bit LSB…Bit LSB…Bit LSB…Bit 7 8 8 8 8 8 8 8 Mono 8 Tap 1 Tap 2 Tap 3 Tap 4 Tap 5 Tap 6 Tap 7 Tap 8 L SB… L SB… L SB… L SB… L SB… L SB… LSB…Bit L SB… Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 7 Bit 7 Pixels (1, Pixels (2, Pixels (3, Pixels (4, Pixels (5, Pixels (6, Pixels (7, Pixels (8, 9, 17, ... 10, 18, ... 11, 19, ... 12, 20, ... 13, 21, ... 14, 22, ... 15, 23, ... 16, 24, ... 4081, 4082, 4083, 4084, 4085, 4086, 4087, 4088, 4089) 4090) 4091) 4092) 4093) 4094) 4095) 4096)
Teledyne DALSA 03-032-20176-06 22 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Deca T0 Configurati on Pixel Port A Port B Port C Port D Port E Port F Port G Port H Port I Port K Format LSB… LSB… LSB… LSB… LSB… LSB… LSB… LSB… LSB…Bit LSB…Bit Bit 7 Bit 8 Bit 8 Bit 8 Bit 8 Bit 8 Bit 8 Bit 8 8 8 Mono 8 Tap 1 Tap 2 Tap 3 Tap 4 Tap 5 Tap 6 Tap 7 Tap 8 Tap 9 Tap 10 L SB… L SB… L SB… L SB… L SB… L SB… L SB… L SB… L SB… L SB… Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 Bit 7 Pixels Pixels Pixels Pixels Pixels Pixels Pixels Pixels Pixels (9, Pixels (1, 11, (2, 12, (3, 13, (4, 14, (5, 15, (6, 16, (7, 17, (8, 18, 19, 29, ... (10, 20, 21, ... 22, ... 23, ... 24, ... 25, ... 26, ... 27, ... 28, ... 4089) 30, ... 4081, 4082, 4083, 4084, 4085, 4086, 4087) 4088) 4090) 4091) 4092) 4093) 4094) 4095) 4096) Table 4: Camera Link Bit Definitions
Signal Configuration CC1 EXSYNC* CC2 Sp ar e CC3 Direction CC4 Sp ar e * Keep this signal in low status w hen i d l e. The exposur e ti me must not be gr eater than the camer a’s al l ow ance— 3,000 µs. Table 5: Camera Control Configuration
For addi tional Camera Li nk documentati on refer to the Tel ed yne DA L SA W eb si t e’ s K now l ed ge Center applicati on notes. Camera Link Drive Capability The camera link cable drive capability on P4-4K/ 2K camer as has been i mpr ov ed t o r each u p to 15 meter s. Thi s pr ov i d es l onger cabl e l engths w i thout the need f or ad d i ti onal components l i k e, r epeater s etc. This capability has been tested using a number of frame grabbers (l i sted i n t he tabl e bel ow ) and w as tested usi ng st and ar d Cam er a Link cables. The cabl e l ength d r i v e achi ev ed on t he v ar i ou s f r ame gr abber s i s as f ol l ow s:
Cable Length Frame Grabber (Manufacturer/Part Number) 10 m Tel ed y neDALSA Xcel er a-CL PX4 / OR-X4C0-XPF00 Tel ed y neDALSA Xcel er a-CL+ PX8 Ful l / OR-X8C0-XPF00 M atr ox Rad i ent eCL – RA D2GSF150400 15 m Tel ed y neDALSA Xcel er a-CL+ PX8 Ful l / OR-X8C0-XPF00 Table 6: Cable Length and Frame Grabber Pairings
Input Signals, Camera Link
The camera accepts control inputs through the Camera Link SD R26F connector . The camer a shi ps i n internal sync, and i nter nal ly progr ammed integration.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 23
EXSYNC (Line Readout Trigger) L i ne r ate can be set i nter nal l y usi ng t he GenICam features. The external control signal EXSYNC is optional and enabled through the u ser i nter f ace. Thi s camer a uses t he fal ling edge of EXSYN C to trigger pi xel r ead out.
The EXSYN C si gnal tel l s t he camer a w hen to i ntegr ate and r ead out t he i m age. I t can be ei t her an i nter nal l y gener ated si gnal by the camer a, or i t can be suppl i ed exter nal l y v i a t he ser i al i nter f ace. Depend i ng up on t he mod e of oper at i on the hi gh t i me of the EXSYN C si gnal can r epr esent the i ntegr ati on per i od .
N ote: The EXSYN C si gnal i s measur ed at CC1 and w i l l gi v e a “ tr ue” measur ement (i .e. w i thi n t he measur ement r esol uti on of 25 ns) ev en t hou gh t he cam er a w i l l onl y tr i gger at a m axi mu m of 100 kHz.
Output Signals, Camera Link Clocking Signals
These si gnals i ndicate w hen data is v alid, all ow i ng you to clock the d ata from the camer a to your acqui si ti on sy stem. These si gnal s ar e par t of t he Camer a L i nk conf i gur ati on and y ou shoul d r ef er to t he Camer a Link Implementati on Road M ap, av ai lable at our K now l ed ge Center , for the standard location of these si gnal s.
Clocking Signal Indicates LVAL (high) Outputting valid line DVAL N ot used STROBE (r i si ng ed ge) Valid d ata FVA L Set to 0
Power Connector
WARNING: It is extremely important that you apply the appropriate voltages to your camer a. I ncor r ect v ol t ages may d amage the camer a. I nput v ol tage r equi r ement: +12 V DC to +24 VDC, ! 2 A mps. Bef or e connect i ng pow er to t he camer a, test al l pow er su ppl i es.
1 6
2 5
3 4
Figure 10: 6-pin Hirose Circular Male Power Plug—Power Connector
Table 7. Power Plug Pinout Pin Description Pin Description 1 +12 V to +24 V DC 4 GND 2 +12 V to +24 V DC 5 GND 3 +12 V to +24 V DC 6 GND
Teledyne DALSA 03-032-20176-06 24 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
The camer a r equi r es a si ngl e v ol tage i np ut +12 V DC to +24 VDC ± 5%. The camer a meets al l per f or m ance specifications using standard switching power supplies, although well-r egul ated l i near su ppl i es pr ov i d e optimum performance.
WARNING: When setting up the camera’s power supplies follow these guidelines: • Apply the appropriate voltages. • Pr otect t he camer a w i th a 2 amp slow -blow fuse betw een the pow er suppl y and the camer a. ! • Do not use t he shi el d on a mul t i -conductor cable for ground. • K eep l ead s as shor t as p ossi bl e i n or d er to r ed uce v ol t age d r op. • U se hi gh-quali ty supp l i es i n or d er to m i ni mi ze noi se.
Note: If your power supply does not meet these requirements, then the camera performance specifications are not guaranteed. LEDs The camer a i s equi pped w i t h an L ED on the back to d i spl ay t he oper ati onal st atu s of the camer a. The tabl e bel ow sum mar i zes the oper ati ng st ates of the camer a and t he cor r espond i ng L ED st ates. When more than one condition is active, the LED indicates the condition with the highest priority. Color of Status LED Meaning Off No power or har dw ar e mal functi on Blinking Powering up or calibrating Gr een Read y Red Error. Check the built-i n sel f test (Bi ST ) r egi ster f or the speci f i c er r or Step 3. Establish Communication with the Camera Power on the camera Turn on the camer a’ s power supply. You may have to wait while the camer a r ead i es itself for operation. The camer a must boot f ul l y bef or e i t w i l l be r ecogni zed by the GU I —the L ED shi nes gr een once the camer a is ready. Connect to the frame grabber 1. Star t Saper a CamExper t (or equi v al ent Camer a L i nk compl i ant i nter f ace) by d oubl e cl i cki ng the desktop icon created during the software installation. 2. CamExper t w i l l sear ch f or i nst al l ed Saper a d ev i ces. I n the Dev i ces l i st ar ea on t he l ef t si d e, the connected frame grabber will be shown. 3. Sel ect the frame grabber d ev i ce by cl i cki ng on t he nam e.
N ote: The f i r st t i me y ou set up the camer a y ou w i l l need to establ i sh a com mu ni cati on l i nk betw een t he camer a and frame grabber.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 25
Connect to the camera 1. Start a new Saper a CamExper t applicati on (or equivalent Camera Link compliant interface) by double clicking the desktop icon cr eated d ur i ng t he sof tw ar e i nst al l at i on. 2. I n the Dev i ces l i st ar ea on t he l ef t si d e, sel ect the COM por t bel ow the Camer a Link label.
Figure 11. CamExpert GUI showing connected camera Check LED Status If the camera is operating correctly at this point, the diagnostic LED will shine gr een. Software Interface
A l l the camer a f eatur es can be contr ol l ed thr ough the CamExper t i nter f ace. For exampl e, und er t he Camer a Contr ol menu i n t he camera window you can control the l i ne r ate and exposur e ti mes.
Teledyne DALSA 03-032-20176-06 26 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
At this point your host and camera system should be setup and you can verify the camera’s operation by r etr i ev i ng a test p atter n and setti ng t he camer a’s tr i gger and exposur e ti me. Using Sapera CamExpert with Piranha4 Cameras CamExper t i s the camer a i nter f aci ng tool supp or ted by the Saper a l i br ar y. W hen u sed w i th a Pir anha4 camer a, CamExpert allow s a user to test all camer a operating modes. Additionally CamExpert saves the camer a user settings configuration to the camera or saves multiple configurations as individual camera par ameter f i l es on t he host sy stem (*.ccf). CamExper t can al so be used to u pgr ad e the camer a’ s sof t w ar e.
An important component of CamExpert is its live acquisition display window which allows immediate v er i f i cati on of ti mi ng or contr ol p ar ameter s w i t hou t t he need to r u n a sep ar ate acqui si ti on pr ogr am.
For context sensi ti v e hel p, cl i ck on the button then click on a camera configuration parameter. A short description of the configuration parameter will be shown in a popup. Click on the button to open t he hel p f i l e f or m or e d escr i pti v e i nf or m ati on on CamExper t.
The centr al secti on of Cam Exper t pr ov i d es access to t he camer a f eat ur es and par ameter s. N ote: The availability of the f eatur es i s d epend ent on the CamExper t user setti ng.
A note on the CamExpert exampl es shown here: The examples shown for illustrative purposes and may not entirely refl ect the features and parameters available from the camera model used in your application.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 27
CamExpert Panes
Figure 12. CamExpert’s Camera Control Window
The CamExper t app l i cati on uses panes to simplify choosing and configuring camera files or acquisition par ameter s f or t he i nstal l ed d ev i ce. • D evice Sel ector pane: V i ew and sel ect f r om any i nst al l ed Saper a acqui si ti on d ev i ce. Once a d ev i ce i s sel ected CamExpert will only present acquisition parameters applicable to that device. Optionally sel ect a camer a f i l e i ncl ud ed w i th t he Saper a i nstal l ati on or sav ed by t he user . • Parameters pane: Allows viewing or changing all acquisition parameters supported by the acqui si ti on d ev i ce. CamExper t d i spl ays p ar ameter s onl y i f those p ar ameter s ar e suppor ted by t he installed device. This avoids confusion by eliminating parameter choices when they do not apply to the har d w ar e i n use. • D isplay pane: Pr ov i d es a l i v e or si ngl e f r ame acqui si ti on d i sp l ay. Fr ame buf f er par ameter s ar e show n in an information bar above the image window. • Control Buttons: The D i spl ay p ane i ncl ud es CamExper t contr ol butt ons. These ar e:
Teledyne DALSA 03-032-20176-06 28 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Acquisition control button: Click once to start live gr ab, cl ick agai n to stop.
Single frame grab: Cl i ck to acqui r e one f r ame f r om d ev i ce.
Trigger button: With the I/ O control parameters set to Trigger Enabled, click to send a single trigger command. CamExpert display controls: (these do not modify the fr ame buf f er d ata) Stretch image to fit, set image display to original size, or zoom the i mage to virtually any si ze and r ati o. H istogram / Profile tool: Select to view a histogram or line/ column profile during live acquisition or in a still image.
• Output M essage pane: D i spl ay s messages f r om CamExper t or the d ev i ce d r i v er . At this point you ar e ready to start oper ati ng the camer a in order to acquire i mages, set camer a f uncti ons, and sav e sett i ngs.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 29
4. Camera Operation
Factory Settings The camer a ships and powers up for the first time with the following factory setti ngs: • Camera Link Full, 8 bit pixels • I nter nal tr i gger , l i ne r ate 10 kHz • I nter nal exposur e contr ol , exposur e ti me 50 µs • 2 st age TDI • 1x horizontal and vertical binning • Offset 0, Gai n 1x Area Mode Using area mode i n the P4 mono camer a al low s data r ates t o be tw i ce as f ast com par ed to TD I Stage = 1 or T D I St ag es = 2.
Simil ar to TDI Stage = 2 mode, both the t op and bott om l i nes of the sensor ar e exposed at t he same ti me. The d i f f er ence bei ng that i nstead of sum mi ng the l i nes, each l i ne i s r ead out sep ar atel y. The f i gur e bel ow illustrates how this is done. On the first Exsync signal, both l i nes ar e exposed and then the sensor is read out. One l i ne i s pr ocessed and st or ed i n camer a mem or y while t he other l i ne i s p r ocessed and sent out the Camer a Link output. The next Exsy nc si gnal d oes not r each t he sensor , but i nstead t he stor ed d ata i s transferred out the Camer a Link port.
Exsync
Programmed Exposure Time
Top and Bottom Lines Read out of Sensor
Bottom Line Stored In Memory
CL Output
Bottom Line Top Line Transmitted out Transmitted out Camera Link Camera Link Figure 13. Area Mode data transfer timing
It i s i mp or t ant t hat the exp osur e ti me i n ar ea mod e be appr opr i ate f or t he set l i ne r ate. The exposur e ti me should not be longer than the i nv er se of the l i ne r ate or el se the i m age w i l l smear . The set scan directi on i s also important. If the direction is wrong the image will look choppy, as can be seen in the following f i gur e.
Teledyne DALSA 03-032-20176-06 30 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Figure 14. Image with incorrect scan direction
Figure 15. Image with proper scan direction
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 31
Check Camera and Sensor Information Camer a and sensor i nformati on can be retrieved vi a a contr olli ng applicati on—f or exampl e, t he CamExper t GU I show n in the following examples. Par ameter s such as camer a model, firmw are version, sensor char acter i sti cs, etc. ar e r ead to uni quel y i d ent i f y the connected d ev i ce.
The camer a i nf or m at i on par ameter s ar e gr ouped toget her as member s of the Cam er a I nf or mation set.
Figure 16. CamExpert’s Camera Information Window Verify Temperature and Voltage To d eter mi ne the v ol tage and temper atur e at t he camer a, use the Ref resh Voltage and Refresh Temperature f eatur es found in the Camera Information set.
The temper atur e r etur ned i s the i nter nal temper atur e i n d egr ees Cel sius. For proper operation t hi s v al ue shoul d not exceed 80 °C. I f the camer a exceed s t he d esi gnated temper atur e i t w i l l stop imaging and the LED will turn red. Once y ou hav e d i agnosed and r emed i ed the i ssue u se the reset camera function.
Teledyne DALSA 03-032-20176-06 32 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Note: The v ol tage d i spl ayed i s the camer a’s i nput v ol t age. The v ol t age measur ement f eatur e of the camer a provides results within 1% of the act ual v ol t age. The m easur ement can be used t o set the ap pl i ed v ol tage to the camer a. Saving and Restoring Camera Settings The par ameter s used to sel ect, l oad and sav e user set s ar e gr ouped t oget her und er the Camer a Information set of features. Ther e ar e 8 u ser sets av ai l abl e and one f act or y set.
Camera Information
Parameter Choices
User Set Def aul t Sel ector Sel ect the camer a par ameter s to load when the camer a i s r eset or pow er ed up as the Factor y set, or as User Set 1 to 8.
Selecting the set from the list automatically saves it as the default set. User Set Sel ector Sel ect the Factory or User set to Save or Load. -Fact o r y Set -User Set 1 to 8. User Set L oad Load the set speci f i ed by User Set Sel ector to the camer a and mak e it the acti v e / cur r ent set. U ser Set Sav e Sav e the cur r ent set as sel ected user set.
Description of the Camera Settings The camer a oper ates i n one of four settings:
1. Current operation with active settings. 2. User setti ng. 3. Factory setting (read-only). 4. Default setting.
The settings acti v e d ur i ng t he cur r ent oper ati on can be sav ed (ther eby becomi ng t he user setti ng) usi ng the U ser Set Save par ameter. A pr ev i ousl y sav ed user setti ng (U ser Set 1 to 8) or the factory settings can be r estor ed usi ng the U ser Set Sel ector and U ser Set L oad p ar ameter s.
Ei ther the Fact or y or one of the U ser setti ngs can be sav ed as the Def aul t Setti ng by sel ecti ng the set i n t he U ser Set Def aul t Sel ector . The chosen set aut om ati cal l y sav es as t he d ef aul t set ti ng and i s t he set l oad ed w hen t he camer a i s r eset or powered up.
The r el at i onshi p betw een t hese four settings is illustrated in Fi gur e 17. Rel ati onshi p betw een t he Camer a Settings:
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 33
Figure 17. Relationship between the Camera Settings
Active Settings for Current Operation The acti v e setti ng f or the cu r r ent oper ati on i s the set of configurations that ar e act i v e while t he camer a i s currently running, including all unsaved changes y ou hav e mad e t o the sett i ngs bef or e sav i ng t hem.
These act i v e setti ngs ar e st or ed i n the camer a’ s volatile mem or y and will be lost and cannot be r est or ed if the camer a r eset s, i s pow er ed down, or loses power.
To sav e these set ti ngs f or r euse the next t i me y ou pow er up or r eset the camer a, or to protect against l osi ng t hem i n the case of p ow er l oss, you must save the current settings u si ng the User Set Save par ameter . Once sav ed , t he cur r ent setti ngs become t he sel ected User Set.
User Setting The user setti ng i s the saved set of camer a configurations that you can customize, resav e, and r estor e. By d ef aul t the u ser setti ngs ar e shi pped w i th t he same sett i ngs as t he f act or y set.
The command User Set Save sav es t he cur r ent set ti ngs to non-volatile memory as a U ser Set. The camer a automaticall y restores the l ast sav ed user set ti ngs w hen it pow er s up.
To r estor e t he l ast sav ed user setti ngs, sel ect the User Set par ameter y ou w ant to r estor e and then sel ect the User Set Load p ar amet er .
Factory Settings The factory setting is the camer a set ti ngs that w er e shi pped w i th t he camer a and which loaded during the camer a’ s f i r st pow er -up. To load or restore the original factory settings, at any time, sel ect the Factory Setting par ameter and then sel ect the User Set Load par ameter .
Teledyne DALSA 03-032-20176-06 34 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Note: By default, the user settings are set to the factory settings.
Default Setting Ei ther the Fact or y or one of the U ser setti ngs can be used as the Def aul t Sett i ng by sel ecti ng the set i n the U ser Set Def aul t Sel ector . The chosen set aut om ati cal l y becomes t he d ef aul t setti ng and i s the set l oad ed w hen t he camer a i s r eset of pow er ed up. Camera Link Configuration Name Taps SPF* Cables Base 2 8, 10, 12 1
M ed i um 4 8, 10, 12 2
Full 8 8 2
Deca (4K onl y) 10 8 2 *Set Pi xel For m at (nu mber of bi ts per pi xel ) TDI and Single Line Modes You hav e t he opt i on to set t he camer a m od es as ei t her si ngl e line (w her e onl y t he bottom sensor i s used , which r esul t s in lower sensitivity) or as TDI (w her e t he pair of sensor l i nes i s su m med , w hi ch r esul ts in higher sensitivity).
TDI Mode vs. Vertical Binning 2 TDI m od e d el ay s one l i ne bef or e sum mi ng so t hat each r ow i m ages the same ar ea. I n the case of v er ti cal binning equal to 2, the r ow s image ad jacent areas and are summed w ithout separ ati on del ay. Thi s action, combined with horizontal binning equal to 2, results in a big pixel that has half the resolution but four ti mes t he r esponse comp ar ed to TDI st ages = 1.
TDI Stage 2 vs. Vertical Binning Vertical Bi nning and TDI Stage 2 are very si mil ar i n operation i n that for both modes both lines of the sensor ar e used and both l i nes ar e sum med toget her . The d i f f er ence is that in vertical binning both lines ar e su mmed d i r ectl y , w hi l e i n TDI St ages 2 one l i ne i s d el ayed by one EXSYNC bef or e bei ng su m med with the other line. The r esul t i s a 20 µm tall pixel for vertical binning while TDI Stage 2 maintains the 10 µm pixel height.
Ther e i s no l i ne r ate d i f f er ence betw een t hese tw o m od es.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 35
Sensitivity Modes and Pixel Readout The camer a has t he opt i on t o oper ate i n ei t her TDI mod e or single line mode. When in TDI mod e, t he camer a uses both line scan sensors and as a result the responsi v i t y i ncr eases (57%). When in single line mod e, the camer a uses t he bottom sensor only. The i nt er nal gai n is 1.27x greater for single line m od e v s. TDI mode.
Figure 18: TDI Mode Examples In TDI mod e, the camer a uses a 10.56 µm x 10.56 µm pi xel and captur es t he same i mage tw i ce, r esu l ti ng in a brighter image.
Figure 19: Single Line Mode Examples In si ngl e l i ne m od e, the camer a u ses a 10.56 µm x 10.56 µm p i xel and capt ur es the i mage usi ng one sensor (Sensor 1).
Teledyne DALSA 03-032-20176-06 36 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Trigger Modes The camer a’s i m age exp osu r es ar e i ni ti ated by a trigger ev ent. The tr i gger ev ent i s ei ther a pr ogr am mabl e internal signal u sed i n f r ee r unni ng mod e, an exter nal i nput u sed f or sy nchr oni zi ng exposur es to exter nal triggers, or a programmed function call message by the controlling computer. These triggering modes are d escr i bed bel ow . • I nternal trigger (trigger disabled): The camer a f r ee-running mode has a programmable internal timer for l i ne r ate and a programmable exposure period. • External trigger (trigger enabled): Exposur es ar e contr ol l ed by an exter nal tr i gger si gnal . The exter nal tr i gger si gnal is the Camera Link control line CC1. Exposure Controls The Exposure Control modes define how and when the camera will capture an image—the integration period. The integration period is the amount of time the camera’s sensor is exposed to incoming light before the captured image is transmitted to the controlling computer. • Exposure control is 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 camer a can gr ab i mages in one of three w ays. You d eter mi ne the t hr ee i m agi ng mod es usi ng a combination of t he Exposur e M od e par ameter s (i ncl ud i ng I / O par ameter s), Exposur e Ti me and L i ne Rate par ameters.
Description Line Rate Exposure Time Trigger Source (Sync) Internal line r ate and exposur e ti me Inter nal , pr ogr ammabl e Inter nal pr ogr ammabl e Internal Exter nal line r ate and exposur e ti me Controlled by EXSYNC Exter nal (EXSYNC) Exter nal pulse EXSYNC pulse controlling the line Controlled by EXSYNC Inter nal pr ogr ammabl e Exter nal r ate. Pr ogr ammed exposur e ti me. pulse Figure 20. Exposure controls
The par ameter s used to sel ect the i m agi ng mod es—tr i gger sour ces (sy nc), exposu r e ti me, and l i ne r ate— ar e gr ouped t oget her as t he Camer a Controls.
Camera Controls
Parameter Description Line Rate (in Hz) Camer a line rate i n H z. Onl y av ail able w hen the start line trigger parameter is disabled (Trigger Mode off). Exposure M ode Set the oper at i on m od e f or the camer a’ s exposur e. Trigger Width or Ti med . Tr i gger W i d t h i s onl y av ai l abl e w hen Tr i gger M od e i s enabl ed . Trigger Width U ses the w i d th of t he cur r ent l i ne trigger signal pulse to control the exposure duration.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 37
Timed The exposur e d ur ati on t i m e i s set usi ng t he Exposur e Ti me f eatur e and t he exposur e st ar ts w i t h the Line Start event. Exposure Time Sets the exposur e ti me (i n mi cr osecond s). Exposure M od e f eatur e mu st be set to Ti med Exposure Modes in Detail
1. Internally Programmable Line rate and Internally Programmable Exposure Time (Default) L i ne r ate is the dominant factor when adjusting the l i ne r ate or exposur e ti me. W hen setti ng the l i ne r ate, exposur e ti me w i l l d ecr ease, i f necessar y, t o accommodate the new l i ne r ate. When adjusting the exposur e ti me the r ange i s l i mi ted by t he l i ne r ate.
Note: The camer a w i l l not set line per i od s shor ter than the r ead out per i od .
GenI Cam parameters to set: I / O Controls > Trigger M ode > Off
2. External Line Rate and External Exposure Time (Trigger Width) In this mode, EXSYNC sets both t he l i ne per i od and the exposur e ti me. The r i si ng ed ge of EXSYNC mar k s the begi nni ng of t he exposur e and t he f al l i ng ed ge i ni t i ates r ead ou t. N ote:
GenI Cam parameters to set: • I / O Controls > Trigger M ode > On • Camera Control > Exposure M ode > Trigger Width
Warning! W hen r unni ng exter nal l i ne r ate and exter nal exposur e ti me, the l i ne r ate must not exceed 1 / (exposur e ti me + 1 µs). U nd er these cond i ti ons t he exposur e ti me w i l l become i nd eter mi nate and result in image artefacts. This is not the case when running internal exposure control.
3. External Line Rate, Programmable Exposure Time In this mode, the l i ne r ate i s set exter nal l y w i th t he f al l i ng ed ge of EXSYN C gener ati ng t he r i si ng ed ge of a pr ogr amm abl e exposur e t i me.
GenI Cam parameters to set: • I / O Controls > Trigger M ode > On • Camera Control > Exposure M ode > Timed
Teledyne DALSA 03-032-20176-06 38 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
1. External Trigger Off, Internal Exposure Control Free running, not synchronized to an external signal Programmable Line Time
Programmable Exposure1 >1us Programmable Exposure1 Programmable Exposure1
Sensor Sensor Sensor Readout2 Readout2 Readout2
10.2us LVAL
2. External Trigger On, Internal Exposure Control CC1 Falling edge triggers start of internal exposure3
CC1
Line Time Programmable Exposure1 >1us Programmable Exposure1 Programmable Exposure1
Sensor Sensor Sensor Readout2 Readout2 Readout2
10.2us LVAL
3. External Trigger On, External Exposure Control CC1 Falling edge triggers start of exposure CC1 high duration sets the exposure time
X1 X2 X3 CC1
Line Time >1us Exposure = X1 Exposure = X2 Exposure = X3
Sensor Sensor Sensor Readout2 Readout2 Readout2
10.2us LVAL
Notes: 1. Exposure time > 4 micro-seconds 2. Sensor Readout time = 9.5 micro-seconds 3. One additional falling edge during exposure is latched
Figure 21. Exposure Modes
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 39
Set Line Rate To set the camer a’s l i ne r ate use the l i ne r ate p ar ameter , par t of the Camer a Control s set. Thi s f eatur e can onl y be used w hen the cam er a i s i n I nter nal mod e—that is, when the start line trigger is disabled (Trigger Mode Off).
N ote: A li ne r ate < 1 / (Exposur e ti me + 1 µs) will return an error (“Invalid Parameter”) if this condition is not met. You must ad ju st these tw o par ameter s i n t he cor r ect sequence to maintain this condition.
I f the exter nal l i ne r ate exceed s the m axi mum l i ne r ate al l ow ed f or a mod e, t he camer a w i l l conti nue t o output data at i ts maxi mum line r ate. Though no i m age ar tef act s associ ated w i t h ov er -speed will occur, you may notice that u nd er ov er -speed cond i ti ons t he i mage w i l l appear compr essed and the app ar ent d i stance tr av el l ed w i l l be r ed uced .
Camera Control
Parameter Description L i ne Rate (in Hz) Camer a l i ne r ate i n a r ange from 1 H z up to 100 kHz.
Thi s f eatur e i s only available when the camera is in Internal Mode— line tr i gger i s d i sabl ed (Tr i gger M od e of f ).
Line Rates
Camera Link Configuration Maximum Line Rate Base, 8-bit 41 kHz (4K), 82 kHz (2K)
M ed i um, 8-bit 81 kHz(4K), 100 kHz (2K)
Full (TDI) , 8-bit 100 kHz (4K and 2K)
Full (Area) , 8-bit 160 kHz (4K), 200 kHz (2K)
Deca (A r ea) , 8-bit 200 kHz (4K)
Teledyne DALSA 03-032-20176-06 40 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Line Rates Vs. AOI Table 8: 85 MHz Camera Link Clock Rate. Maximum Line Rates of 100 kHz TDI and 200 kHz Area. Number CL Line Rate Formula (Hz) of AOI Configuration
Base
M ed i um
1
Full
Deca
Base
M ed i um
2 Full
Deca
Base
M ed i um
3
Full
Deca
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 41
Number CL Line Rate Formula (Hz) of AOI Configuration
Base
M ed i um 4
Full
Deca
Table 9: 66 MHz Camera Link Clock Rate. Maximum Line Rates of 100 kHz TDI and 200 kHz Area. Base
M ed i um
1
Full
Deca
Base
M ed i um
2
Full
Deca
Teledyne DALSA 03-032-20176-06 42 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Base
M ed i um
3
Full
Deca
Base
M ed i um
4
Full
Deca
Set Exposure Time To set the camer a’s exp osur e ti me, use the Exposure Ti me par ameter —a member of the Camera Controls set. This feature is only available when the Exposure M ode p ar ameter i s set to Timed. The al l ow abl e exposur e r ange i s f r om 4 µs to 3,000 µs, dependent on the value of the internal line rate.
GenI Cam parameters: Camera Controls > Exposure Time (Timed Exposure M ode) > 4 µs to 3,000 µs. Control Gain and Black Level The camer as provide gai n and bl ack l ev el ad just ments in the digital domai n for the CMOS sensor . The gai n and black l ev el contr ol s can make small compensati ons to the acqui si ti on in si tuati ons w her e lighting v ar i es and the lens iris cannot be easil y ad justed. The user can ev aluate gain and bl ack lev el by usi ng CamExper t.
The par ameter s that contr ol gai n and bl ack l ev el ar e gr ouped together i n the Camera Control s set.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 43
Camera Controls Bl ack L ev el Apply a digital addition after an FPN correcti on: ± 1/ 8 of avail able range. For examp l e in 12-bit mode t he av ai l abl e r ange i s -512 to +511. Gain Set the gain as an amplification factor applied to the video signal acr oss al l pixels: 1x to 10x. Set Image Size To set the hei ght of the i m age, and t her ef or e the nu mber of l i nes t o scan, use t he par ameter s gr ouped und er the I m age For mat Contr ol set.
Image Format Control Control the size of the transmitted image
Width Width of the image. Read onl y.
H ei ght Hei ght of the i mage i n l i nes. Read onl y.
Pixel Format M ono 8, M ono 10, or M ono 12 bit depth to Camera Link.
Test I m age Sel ector Sel ect an i nter nal test i m age: Off Ramp A5 Each Tap Fixed A ll 1365 All 1 Set Baud Rate The baud r ate sets t he speed (i n bi ts per second —bps) of the seri al communicati on port and is av ail able as part of the Serial Port Control parameters.
Serial Port Control Action Parameter Options Contr ol the baud r ate used by the Baud Rate 9600 (factor y default) camer a’s ser ial port 19200 57600 115200 230400* 460800* 921600*
N ote: Dur i ng connecti on CamExper t automaticall y sets the camera to maximum allowable baud.
*A Px8 or equiv alent frame grabber i s required in order to achi ev e these baud r ates.
Teledyne DALSA 03-032-20176-06 44 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
N umber of bi t s per char act er used i n the Data Si ze 8 serial port Parity of the serial port Par i ty None
N umber of st op bi t s per char acter u sed Number of Stop 1 i n the ser i al p or t Bits Pixel Format U se the Pi xel For m at f eat ur e, found in the I mage Format Control set, t o sel ect the f or mat of the pi xel to use during image acquisition as ei ther M ono 8, M ono 10, or M ono 12 bit depth.
Image Format Control Parameter Description Pixel Format M ono 8* M ono 10 M ono 12
*Only available format for Full and Deca Camer a Link configurations. Camera Direction Control Found in the Camera Control > Direction Control set of f eatur es. N ote: Thi s f eatu r e i s only av ail able when in TDI mode.
N ote: the Sensor Shift f eat ur es ar e not av ai l abl e w hen the camer a i s i n l ow or t al l pi xel sensi ti v i ty m od es.
Camera Control > Direction Control Parameter Description Scan Direction Sou r ce When in TDI stages 2 or A rea mode, thi s com mand l et s y ou sel ect the I nternal or external direction control. U se thi s f eatur e to accomm od ate object d i r ecti on change on a w eb and to m ount t he camer a "upsi d e d ow n." Scan Direction Read t he current direction.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 45
Camera Direction When in TDI mode or A r ea mod e you can sel ect ei ther f or w ar d or r ev er se camer a d i r ecti on. Sel ectabl e d i r ecti on accom mod ates object d i r ecti on change on a w eb and al l ow s you to mount the camer a “ upsi d e down” .
N ote that t he exampl e her e assumes t he use of a l ens (w hi ch i nv er t s the i m age).
Figure 22: Object Movement and Camera Direction Example using a Lens Pixel Readout Direction (Mirroring Mode) Set the tap readout from left to right or from right to left. This feature is especially useful if you want to mou nt t he camer a “ upsi d e d ow n.”
Image Format Control Parameter Description Line Mirroring Off: All pixels are read out from left to right. On: All pixels are read out from right to left.
Teledyne DALSA 03-032-20176-06 46 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Resetting the Camera The f eatur e Camera Reset, part of the Transport Layer set, resets the camer a. The camer a r esets w i th t he d ef aul t sett i ngs, including a baud r ate of 9600.
Transport Layer Parameter Description Camer a Reset Resets t he camer a and pu ts in the default settings, including a 9600 baud r ate. Calibrating the Camera Important Note: t o ensur e best r esul t s, the cond i ti ons und er w hi ch y ou cal i br ate t he camer a (e.g. temperature and illumination) should be as close to the actual operating conditions as possible.
Figure 23: Flat Field Calibration in CamExpert
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 47
Calibration The goal of calibr ati on i s f or the camer a to pr od uce a u ni f or m outp ut i m age at a d esi r ed l ev el w hile imaging a uniform white object under conditions equ al to the optical setup for the user ’ s application.
• Conf i gur e the camer a to t he exsy nc and exposur e ti m i ng they r equi r e, pl us ad just the l i ght l ev el for normal operation. • Set the system gain to a value that best suits the application. • The l ens shoul d be at t he r equi r ed m agni f i cati on and aper tur e and be f ocu sed . • A s the w hi te r ef er ence i s l ocated at t he object pl ane, any markings or contaminants on i t s sur f ace (e.g. dust, scratches, smudges) will end up in the calibration profile of the camera. To avoid this, use a clean white plastic or ceramic material rather than trying to rely on a paper r ef er ence. (I d eal l y, the w hi te object w i l l be m ov i ng d u r i ng t he cal i br at i on pr ocess, as the av er agi ng pr ocess of the camer a w i l l d i mi ni sh the ef f ects of any small variation in the white r ef er ence.) • Ad just t he system gai n unt i l the peak i ntensi t y i s at the d esi r ed DN l ev el and then calibrate the FPN . U se a lens cap to ensure that no li ght r eaches t he sensor . • Once compl ete, r em ov e the l ens cap and per f or m a PRN U calibr ati on using the d esi r ed target value (in DN). You w ant al l the pi xel s t o match. This target value should be higher than the peak values you saw while first setting up the camera. • A f ter sev er al second s the PRNU calibration will end and the cor r ecti on coef f i ci ents w i l l be enabl ed . The sy stem gai n remai ns as f i r st set. The coefficients and gain parameters, timing and control configuration can be stored in any one of eight user sets and autom ati cal l y r etr i ev ed at pow er -up or by user sel ecti on.
CamExper t has a defaul t ti meout of 20 seconds per command, which is too short for the FFC calibration to run fully. You can change the default timeout by setting a command line argument in the short-cut: • Right click on the short-cut in the start menu and select properties. • Add –ti meout 60 to i ncr ease the command ti meout to 60 second s (See bel ow ). N ote that you must include a character space between the closing quotation mark in the target and the hy phen bef or e the ti meout v al ue. • Repeat f or d esk top shor t-cut
Figure 24: Setting the camera’s timeout value
Teledyne DALSA 03-032-20176-06 48 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
1. Flat Field Thi s Flat Field set contai ns a number of features that ar e used to correct image distortion due to lens vignetting and uneven illumination.
N ote: 1. Flat field coefficients consist of an offset and gain for each pixel. 2. These ar e t he f i r st user cor r ecti ons app l i ed to t he i m age. 3. The f l at f i el d coef f i ci ents ar e sav ed and l oad ed w i t h the user set. Flat Field Parameter Description flatfieldCorrectionMode 1. Off – Fl at f i el d cor r ecti on coef f i ci ents ar e not app l i ed . 2. On – Fl at f i el d cor r ecti on coef f i ci ents ar e appl i ed . 3. Initialize – Sending this value will reset all current coefficients (of f sets to 0 and gai ns t o 1x). flatfieldCorrectionAlgorithm 1. Basi c – Direct calculation of coef f i ci ents based on cur r ent av er age l i ne v al ues and tar get. 2. L ow Pass – A low pass filter is first applied to the current av er age l i ne v al ues bef or e cal cul at i ng t he coef f i ci ents. U se thi s algorithm if the calibration target is not uniform white or it s not p ossi bl e to d ef ocu s the i m age. Becau se of the l ow pass f i l ter this algorithm is not able to correct pixel-to-pixel variations and so it is preferable to use the “Basic” algorithm if possible. flatfieldCalibrationTarget 1. After calibration all pixels will be scaled to output this level 2. Range d epend s on p i xel f or mat: • 8 bit: 0 to 255 DN • 10 bit: 0 to 1023 DN • 12 bit: 0 to 4095 DN flatfieldCalibrationSampleSize 1. N umber of li nes to aver age w hen calibr ati ng 2. 2048 or 4096 flatfieldCalibrationROIOffsetX 1. Toget her with “flatfieldCalibrationROIWidth” specifies the r ange of pi xel s t o be cal i br ated . Pi xel coef f i ci ent s out si d e thi s r ange ar e not changed . I t i s possi bl e to cal i br ate d i f f er ent regions sequentially. flatfieldCalibrationROIWidth
flatfieldCalibrationFPN 1. Save aver age li ne (of “ fl atfi eldCalibr ati onSampleSize” row s). Thi s i s the f i r st u ser cor r ecti on appl i ed – it is subtracted from each l i ne. 2. Thi s f eatur e m ay not be of use to m any user s as t he camer a al r ead y subtr acts tr ue “ d ar k cur r ent ” , but i t m ay be u sef ul for some t o pr ov i d e a per pi xel of f set cor r ecti on. 3. Range 0 to 511 DN , 12 bit 4. Defaul t val ue is 0 DN for each pixel flatfieldCalibrationPRNU 1. Use “flatfieldCorrectionAlgorithm” to calculate the per pixel gain to achieve the specified target output. 2. Range 0 to 15.9998x 3. Defaul t 1x
2. Contrast Enhancement
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 49
U se the Of f set and Gai n f eatur es to maxi mi ze the u se of the output d ynam i c r ange (especi al l y w hen pi xel format is less than 12 bits). Typical use is to subtract minimum pixel value expected and then gain up maximum pixel value to approach full scale.
Offset 1. Si ngl e v al ue ad d ed to each pi xel 2. Range -512 to 511 DN , scaled dow n accordi ng to pixel f ormat 3. Posi ti v e v al ues may be used to measur e d ar k noi se
Gain 1. Floating point digital multiplier applied to each pixel 2. Range 1x to 10x
Teledyne DALSA 03-032-20176-06 50 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Appendix A: GenICam Commands
This appendix lists the av ai l abl e GenI Cam camer a f eat ur es. A ccess these f eatur es usi ng the CamExper t i nter f ace.
Features listed in the description table but tagged as Invisible ar e typically reserved f or Tel ed yne DA L SA Support or third party software usage, and not typically r equi r ed by end user applications.
A note on the CamExpert exampl es shown here: The examples shown for illustrative purposes and may not entirely refl ect the features and parameters available from the camera model used in your application.
Camera Information Category Camer a inf ormati on can be retrieved via a contr olli ng applicati on. Par ameter s such as camer a model, f i r mw ar e v er si on, etc. ar e r ead to u ni quel y i d enti f y t he connected P4 d ev i ce. These f eatur es ar e typi cal l y r ead -only. The Camera Information Category groups information specific to the individual camera. In this category the nu mber of f eatur es show n i s i d enti cal w het her the v i ew i s Begi nner , Exper t, or Gur u. Features listed in the description table but tagged as Invisible ar e usual l y f or Tel ed yne DA L SA or thi r d party softw are usage—not typi cal l y need ed by end user appl i cati ons.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 51
Camera Information Feature Descriptions The f ol l ow i ng t abl e d escr i bes these p ar ameter s al ong w i th t hei r v i ew attr i butes and i n w hi ch v er si on of the d ev i ce the f eat ur e w as i ntr od uced . A d d i ti onal l y the Dev i ce V er si on col um n w i l l i nd i cate w hi ch par ameter i s a member of t he DA L SA Featur es Naming Convention (using the tag D FN C), v er ses the GenICam Stand ard Features Naming Convention (SFNC not shown).
The Dev i ce V er si on nu mber r epr esents the camer a sof t w ar e f uncti onal gr oup, not a f i r m w ar e r ev i si on number .
Display Name Feature Description Device Version & View M od el N ame Dev i ceM od el N ame Di spl ay s the d ev i ce mod el name. (RO) 1.00 Begi nner V end or N ame Dev i ceV end or N ame Di spl ay s the d ev i ce v end or name. (RO) 1.00 Begi nner Dev i ce V er si on Dev i ceV er si on Displays the device version. This tag will 1.00 also highlight if the firmware is a beta or Begi nner custom d esi gn. (RO) M anuf acturer Inf o Dev i ceM anuf acturerInfo Thi s f eatur e pr ov i d es extend ed 1.00 manuf actur er i nf or m ati on about the d ev i ce. Begi nner (RO)
Teledyne DALSA 03-032-20176-06 52 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Display Name Feature Description Device Version & View Firmware Version Dev i ceFi r mw ar eV er si on Displ ays the currently l oaded firmw are 1.00 v er si on nu mber . Fi r m w ar e f i l es hav e a Begi nner uni que nu mber and hav e t he .cbf file extensi on. (RO) Ser i al N u mber Dev i ceI D Di spl ay s the d ev i ce’ s f act or y set camer a 1.00 ser i al nu mber . (RO) Begi nner Dev i ce U ser I D Dev i ceU ser I D Featur e t o st or e user -progr ammable 1.00 i d enti f i er of up t o 15 char acter s. The d ef aul t Begi nner factory setti ng i s t he camer a ser i al nu mber . (RW) Pow er -up U ser SetDef aul tSel ect or Sel ects the camer a conf i gur ati on set t o l oad 1.00 Configuration and make acti v e on camer a pow er -up or Begi nner Sel ector r eset. The camer a conf i gur ati on sets ar e stor ed i n camer a non-v ol ati l e mem or y. (RW) Factory Setting D efault Load factory default feature settings U ser Set1 U ser Set1 Sel ect the user d ef i ned conf i gur ati on U ser Set 1 as t he Pow er -up Configuration. U ser Set2 U ser Set2 Sel ect the user d ef i ned configuration U ser Set 2 as t he Pow er -up Configuration U ser Set3 U ser Set3 Sel ect the user d ef i ned conf i gur ati on U ser Set 3 as t he Pow er -up Configuration U ser Set4 U ser Set4 Sel ect the user d ef i ned conf i gur ati on U ser Set 4 as t he Pow er -up Configuration. U ser Set5 U ser Set5 Sel ect the user d ef i ned conf i gur ati on U ser Set 5 as t he Pow er -up Configuration. U ser Set6 U ser Set6 Sel ect the user d ef i ned conf i gur ati on U ser Set 6 as t he Pow er -up Configuration. U ser Set7 U ser Set7 Sel ect the user d ef i ned conf i gur ati on U ser Set 7 as t he Pow er -up Configuration. U ser Set8 U ser Set8 Sel ect the user d ef i ned conf i gur ati on U ser Set 8 as t he Pow er -up Configuration. U ser Set Sel ector U ser SetSel ector Sel ects the camer a conf i gur ati on set t o l oad 1.00 f eatur e setti ngs f r om or sav e cur r ent f eatur e Begi nner settings to. The Factory set contains default camer a f eatur e set ti ngs. (RW ) Factory Setting D efault Select the default camera feature settings saved by the factory U ser Set 1 U ser Set1 Sel ect the U ser -defined Configuration sp ace UserSet1 to save to or load from features setti ngs pr ev i ousl y sav ed by the user . U ser Set 2 U ser Set2 Sel ect the U ser -d ef i ned Conf i gur ati on sp ace UserSet2 to save to or load from features setti ngs pr ev i ousl y sav ed by the user . U ser Set3 U ser Set3 Sel ect the U ser -d ef i ned Conf i gur ati on sp ace UserSet3 to save to or load from features setti ngs pr ev i ousl y sav ed by the user .
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 53
Display Name Feature Description Device Version & View U ser Set4 U ser Set4 Sel ect the U ser -d ef i ned Conf i gur ati on sp ace UserSet4 to save to or load from features setti ngs pr ev i ousl y sav ed by the user . U ser Set5 U ser Set5 Sel ect the U ser -d ef i ned Conf i gur ati on sp ace UserSet5 to save to or load from features setti ngs pr ev i ousl y sav ed by the user . U ser Set6 U ser Set6 Sel ect the U ser -d ef i ned Conf i gur ati on sp ace UserSet6 to save to or load from features setti ngs pr ev i ousl y sav ed by the user . U ser Set7 U ser Set7 Sel ect the U ser -d ef i ned Conf i gur ati on sp ace UserSet7 to save to or load from features setti ngs pr ev i ousl y sav ed by the user . U ser Set8 U ser Set8 Sel ect the U ser -defined Configuration space UserSet8 to save to or load from features setti ngs pr ev i ousl y sav ed by the user .
Pow er -on U ser Set U ser SetDef aul tSel ect or A l l ow s the u ser to sel ect betw een t he 1.00 factory set and 1 to 8 user sets to be l oad ed Begi nner at power up Cur r ent U ser Set U ser SetSel ector Poi nts t o w hi ch u ser set (1-8) or factory set 1.00 that is loaded or saved when the Begi nner U ser SetL oad or U ser SetSav e comm and i s used Load Configuration U ser SetL oad L oad s t he camer a conf i gur ati on set 1.00 speci f i ed by the U ser Set Sel ector f eatur e, t o Begi nner the camer a and makes i t act i v e. (W ) Save Confi gur ation U ser Set Sav e Saves the current camera configuration to 1.00 the user set speci f i ed by the U ser Set Begi nner Sel ector f eatur e. The user sets ar e l ocated on the camer a i n non-volatile memory. (W) Device Built-I n Sel f d ev i ceBI ST St at u s Deter mi ne the st at us of the d ev i ce usi ng the 1.00 Test Status ‘Built-I n Sel f Test’. Possi bl e r etur n v al ues DFN C ar e d ev i ce-specific. (RO) Begi nner LED Color dev i ceL EDCol or Contr ol Di spl ay s the status of the LED on the back 1.00 of the camer a. (RO) DFN C Begi nner Temper at ur e Dev i ceTemper atur e Di spl ay s the i nter nal oper ati ng temper atur e 1.00 of the camer a. (RO) DFN C Begi nner Ref r esh r ef r eshTemper atur e Pr ess to d i spl ay t he cur r ent internal 1.00 Temper at ur e oper at i ng temper atur e of the camer a. DFN C Begi nner Input Voltage d ev i ceInputVoltage Di spl ay s the i nput v ol t age t o the camer a at 1.00 the pow er connector (RO) DFN C Begi nner Ref r esh V ol t age r ef r eshV ol t age Press to display the current input voltage of 1.00 the camer a at the p ow er connect or DFN C Begi nner
Teledyne DALSA 03-032-20176-06 54 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Display Name Feature Description Device Version & View L i cense K ey securityUpgrade 1.00 DFN C Guru Camera Configuration Selection Dialog
CamExper t pr ov i d es a d i al og box w hi ch combi nes the f eatur es to sel ect the camer a pow er up st ate and f or the user to sav e or l oad a camer a state f r om Geni e mem or y. Camera Power-up Configuration The f i r st d r op l i st sel ect s the camer a conf i gur ati on st at e to load on power-up (see f eatur e U ser Set D ef au l t Sel ect or ). The user chooses f r om one f act or y d at a set or one of tw o possi bl e u ser sav ed states. User Set Configuration Management The second drop list allows the user to change the camera configuration anytime af ter a pow er -up (see f eatur e U ser Set Sel ect or ). To r eset the camer a t o the f act or y conf i gur ati on, sel ect Factory Setting and click L oad . To sav e a cur r ent camer a conf i gur at i on, sel ect U ser Set 1 to 8 and cl i ck Sav e. Sel ect a sav ed user set and click Load to r est or e a sav ed conf i gur ati on.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 55
Camera Control Category The P4 camera controls, as shown by CamExpert, gr ou ps sensor speci f i c p ar ameter s. Thi s gr oup i ncl ud es contr ol s f or l i ne r ate, exposur e time, scan directi on, and gai n. Par ameter s i n gr ay ar e r ead onl y, ei t her al w ay s or d ue to anot her par ameter bei ng d i sabl ed . Par ameter s i n bl ack ar e u ser set i n CamExper t or programmable via an i maging applicati on.
Teledyne DALSA 03-032-20176-06 56 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Camera Control Feature Descriptions The f ol l ow i ng t abl e d escr i bes these p ar ameter s al ong w i th t hei r v i ew attr i bute and mi ni mu m camer a firmware version required. Additionally the firmware column will indicate which parameter is a member of t he DA L SA Feat ur es Naming Convention (DFN C), v er ses the GenICam Standard Features Naming Convention (SFNC not shown). The Dev i ce V er si on nu mber r epr esent s the camer a sof tw ar e functional group, not a firmware revision number.
Display Name Feature Description Device Version & View I nter nal L i ne AcquisitionLineRate Speci f i es the camer a i nter nal l i ne r ate, i n H z 1.00 Rate w hen Tr i gger m od e set t o i nter nal . Begi nner N ote that any user enter ed v al ue i s automaticall y ad justed to a valid camer a value. M easur ed L i ne measur eL i neRate Speci f i es the l i ne r ate pr ov i d ed to the camer a by 1.00 Rate ei ther i nter nal or exter nal sour ce (RO) Begi nner Ref r esh r ef r eshM easur eL i neRate Pr ess to show t he cur r ent l i ne r ate pr ov i d ed to 1.00 measur ed l i ne the camer a by ei ther i nter nal or exter nal sour ces Begi nner rate Exposur e Ti me ExposureM ode Sets the oper ati on m od e f or the camer a’ s 1.00 Sou r ce exposur e (or shutter ). (RO) Begi nner Ti med Ti med The exposur e d ur ati on t i m e i s set usi ng t he Exposur e Ti me f eatur e and the exposur e star t s w i th a L i neSt ar t ev ent. Trigger Width TriggerWidth Uses the width of the trigger signal pulse to control the exposure duration. TDI Stages sensor TDI St ageSel ecti on Sel ects the nu mber of l i nes to be i m aged 1.00 Begi nner 1 1 Single Line DFN C 2 2 Tw o l i nes sum med together Multi Line multiLineExposureMode Sel ects M ul ti L i ne exp osur e mod e 1.00 Exposure Begi nner M ode DFN C
ON ON For independent exposure control of each line OFF OFF For TDI stage = 1, 2 or A r ea mod e Exposur e Ti me exposur eTi meSel ector U sed to sel ect w her e Exposur eTi me i s appl i ed 1.00 Sel ector to. Begi nner DFN C All All Both l i nes get equ al exposu r e ti me Top Line TopLine A l l ow s the t op l i ne to hav e exposur e ti me set Bottom Line BottomLine A l l ow s the bottom l i ne to hav e the exposur e time set. Exposure Time ExposureTime Sets the exposur e ti me (i n mi cr osecond s) w hen 1.00 the Exposur e M od e f eatur e i s set to Ti med . Begi nner M easur ed measur eExposur eTi me Speci f i es the exposur e ti me pr ov i d ed to t he 1.00 Exposure Time camer a by ei t her i nter nal or exter nal sour ce (RO) Begi nner Ref r eshed r ef r eshM easur eExp osur eTi me Pr ess to d i spl ay t he cur r ent exposur e ti me 1.00 measur ed pr ov i d ed to t he camer a. Begi nner exposur e ti me
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 57
Display Name Feature Description Device Version & View Di r ecti on sensorScanDirecti onSource 1.00 Sou r ce I nter nal Di r ecti on d eter m i ned by v al ue of Begi nner Sen sor Scan D i r ect i o n
Exter nal Di r ecti on contr ol d eter mi ned by v al ue on CC3 I nter nal sensor ScanDi r ecti on W hen ScanDi r ecti onSour ce set to I nter nal , 1.00 Di r ecti on d eter mi nes t he d i r ecti on of the scan Begi nner Forward Rev er se Gai n Sel ector Gai nSel ect or Selects to which line that gain will be applied 1.00 Begi nner Sy st em Gai n Sy st em Gai n Gain will be applied to top and bottom lines equally Top Line TopLine Gain will be applied to the top line only Bottom Line BottomLine Gain will be applied to the bottom line only Gain Gain Sets the selected gain as an amplification factor 1.00 appl i ed t o the i mage. Begi nner Offset Bl ackL ev el Controls the black level as an absolute physical 1.00 v al ue. Thi s r epr esents a DC of f set appl i ed t o the Begi nner video signal, in DN (digital number) units. Dev i ce Scan Dev i ceScanType Sel ects mod e of oper at i on of the camer a betw een 1.00 Type Line scan mode and Area scan mode Begi nner
L i n e Scan L i n eScan A rea Scan A reaScan
Teledyne DALSA 03-032-20176-06 58 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Multi-Exposure Mode The multi-exposur e mod e al l ow s f or the simultaneous exposure of each line of the sensor with tw o d i f f er ent exposur e ti mes or gai ns. The r esul t i s an increase in the d y nami c r ange of the i m age.
Turn on the Multi Line Exposure M ode
Select which line to control integration time
Note: to initiate multi-exposur e mod e, set TDI stage = 1 (stg 1) and ensure that the camer a is in line scan mode (d st 0). The exp osur e ti me sel ect or (ses) com m and i s used to sel ect w hi ch l i ne to apply the exposur e ti me.
Above: image with shorter exposure time.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 59
Above: image with longer exposure time. Otherwise, identical to the first image.
Above: top and bottom images fused.
Teledyne DALSA 03-032-20176-06 60 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Flat-Field Calibration of Image in Multi-Exposure Mode Performi ng a flat-field calibration while in multi-exposur e mod e results in the camera automatically setti ng bot h l i nes of the sensor to t he same i ntegr ati on ti me. Bot h l i nes w i l l be f l at-f i el d ed to the t ar get v al ue pr ov i d ed . A f ter the f l at-f i el d cal i br ati on has com pl eted the i ntegr at i on and gai n v al ues ar e r eset to the l i nes that t hey w er e set to pr i or t o the f l at-f i el d r equest.
I n the abov e exampl e t he f l at-f i el d tar get w as set t o 200 DN, based on the i mage on the l ef t-hand si d e. The integration time for the image on the right was automatically set t he same as the i mage on t he l ef t d ur i ng the f l at-f i el d pr ocess. A f ter the f l at-f i el d pr ocess had compl eted , the image on the right-hand side had i ts sel ected i ntegr ati on t i me restored to its pre-cal ibration value, which is why it appears d ar ker than t he l ef t si d e.
Flat-Field Region of Interest While in multi-exposur e m od e, setting up a fl at-f i el d r egi on of i nter est r esul t s the same r egi on of i nter est coordi nates to be applied to both lines.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 61
Multi-Exposure Output Format While in multi-exposur e m od e the w i d t h of t he outp ut w i l l d oubl e. A 2k camer a w ill output a 4k i mage w i th t he l ef t hal f of the i m age bei ng t he bott om l i ne and the right half being the top line.
Output AOI when in Multi-Exposure Mode The same ou tput A OI w i l l be appl i ed t o bot h the t op and bott om l i nes w hile in multi-exposur e m od e.
Line Rate While in multi-exposur e m od e the m axi mu m l i ne r ate av ai l abl e i s l i mi ted by the l ongest exposur e ti me.
Exposure Time Limitation The exposur e t i me of t he t w o l i nes must d i f f er by gr eater than 1 µs.
Teledyne DALSA 03-032-20176-06 62 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Digital I/O Control Feature Descriptions The P4 Digital I/ O control categor y, as or gani zed by CamExper t, groups t oget her the sensor speci f i c parameters. This group includes the contr ol s f or l i ne r ate, exposur e ti me, scan d i r ecti on, and gai n. Par ameters in gr ay are read -onl y, ei t her al w ays or d ue to anot her par ameter bei ng enabl ed or disabled. Par ameter s i n bl ack are user set in CamExpert or pr ogr ammable vi a an imaging application.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 63
The f ol l ow i ng t abl e d escr i bes the digital I / O control par ameter s al ong w i t h thei r v i ew attributes and t he minimum camera firmware version required. Additionally, the f i r mw ar e column indicates which par ameter i s a member of t he DA L SA Featur es N ami ng Conv enti on (D FN C), v er ses the GenI Cam Standard Features Naming Convention (SFNC not shown). The Dev i ce V er si on number r epr esent s the camer a softw are functi onal group, not a fir mw ar e r ev i si on nu mber .
Display Name Feature Description Device Version & View Trigger Sou r ce TriggerSou r ce Def i nes t he sour ce of exter nal tr i gger (RO) 1.00 DFN C Begi nner Trigger Sel ector TriggerSel ector Defines what the trigger initiates (RO) 1.00 DFN C Begi nner Trigger M ode TriggerM ode Deter mi nes t he sour ce of tr i gger to t he camer a, i nter nal or 1.00 exter nal (CC1) DFN C Begi nner Flat Field Category The P4 Fl at Fi el d contr ol s, as show n by CamExper t, gr oup par ameter s u sed to conf i gur e camer a pi xel format, and image cropping. Additionally a feature control to select and output an internal test image simplifies the process of setting up a camera without a l ens. Par ameter s i n gr ay ar e r ead onl y, ei t her al w ays or d ue to anot her par ameter bei ng d i sabl ed . Par ameter s in bl ack are user set in CamExpert or progr ammable vi a an imaging appl ication. Features listed in the description table but tagged as Invisible ar e usual l y f or Tel ed yne DA L SA or thi r d party softw are usage—not typi cal l y need ed by end user appl i cati ons.
Teledyne DALSA 03-032-20176-06 64 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Flat Field Control Feature Description The f ol l ow i ng t abl e d escr i bes these p ar ameter s al ong w i th t hei r v i ew attr i bute and mi ni mu m camera firmware version required. Additionally the firmware column will indicate which parameter is a member of t he DA L SA Feat ur es Naming Convention (DFN C), v er ses t he GenI Cam Stand ar d Features Naming Convention (SFNC not shown). The Dev i ce V er si on nu mber r epr esents the camer a sof t w ar e f uncti onal gr oup, not a f i r m w ar e r ev i si on number .
Display Name Feature Description Device Version & View M ode flatfieldCorrectionMode 1.00 Off Off FPN and flat field coefficients Begi nner disabled. On On FPN and flat field coefficients DFN C enabl ed . Initialize Initialize Reset all FPN to 0 and all flat field coefficients to 1. ScanDirectionControlled ScanDirectionControlled Di f f er ent user set l oad ed depending on direction.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 65
Display Name Feature Description Device Version & View Select flatfield f l atf i el d ScanD i r ecti onRev er seSet W hen f l atf i el d Cor r ecti onM od e i s 1.00 Correction Scan set to ScanDi r ect i onContr ol l ed Begi nner Di r ecti on Rev er se Set thi s f eatur e sel ects t he U ser SEt (1 DFN C to8) w hi ch w i l l be used f or the r ev er se scan d i r ect i on. Calibration Algorithm flatfieldCorrectionAlgorithm Sel ecti on bet w een t w o d i f f er ent 1.00 flat field algorithms. Begi nner Basi c Basi c Direct calcul ati on of coefficients DFN C based on aver age li ne values and target. Low Pass Low Pass A low pass filter is first applied to the av er age l i ne v al ues bef or e cal cul at i ng t he coef f i ci ents. U se this algorithm if the calibration target is not uniformly white or it i s not possi bl e t o d ef ocus t he i m age. Becau se of the l ow pass filter this algorithm is not able to cor r ect pi xel -to-pixel variations and so i t i s pr ef er abl e to u se the “Basic” algorithm. Calibr ati on Target flatfieldCalibrationTarget Set a v al ue bet w een 0 and 255 t o 1.00 which the flat field algorithm will Begi nner taget t he i m age t o. DFN C Calibration Sample Size flatfieldCalibrationSampleSize Sets the nu mber of l i nes to be 1.00 averaged during a flat field Begi nner Lines_2048 Lines_2048 calibr ati on DFN C Lines_4096 Lines_4096
ROI Offset X flatfieldCalibrationROIOffsetX Set the starting point of a region 1.00 of i nter est w her e a f l at f i el d Begi nner calibration will be performed DFN C ROI Width flatfieldCalibrationROIWidth Sets the w i d t h of the r egi on on 1.00 i nter est w her e a f l at f i el d Begi nner calibration will be performed DFN C Calibr ate FPN flatfieldCalibrationFPN Initi ates the FPN cal ibration 1.00 pr ocess Begi nner DFN C Calibr ate PRN U flatfieldCalibrationPRNU I ni ti ates t he PRN U or Fl atf i el d 1.00 pr ocess Begi nner DFN C Region of Interest (ROI) The ROI f eatur e i s r el ated t o f l at f i el d cal i br ati on. I t i s i mpor t ant to speci f y an ROI w hen t he object bei ng imaged has areas that have black, non illumi nated areas such as beyond the edge of a film that is front illuminated, or is saturated, again beyond the edge of a film but in this case bright field back illuminated. The ROI f eatur e al l ow s f r om one t o f our speci f i c r egi ons of the p i xel l i ne to be speci f i ed w her e f l at f i el d
Teledyne DALSA 03-032-20176-06 66 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera calibration will take place. Pixel data outside the ROI will not be used when performing flat field calibr ati on.
Image Format Control Category The P4 I mage For mat contr ols, as show n by CamExper t, gr oups p ar ameter s u sed t o conf i gur e camer a pixel format, image cropping, and the test pattern. Par ameter s i n gr ay ar e r ead onl y, ei t her al w ays or d ue to anot her par ameter bei ng d i sabl ed . Par ameter s in bl ack are user set in CamExpert or progr ammable vi a an imaging appl ication. Features listed in the description table but tagged as Invisible ar e usually for Teledyne DALSA or third party softw are usage—not typi cal l y need ed by end user appl i cati ons.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 67
Image Format Control Feature Description The f ol l ow i ng t abl e d escr i bes these p ar ameter s al ong w i th t hei r v i ew attr i bute and mi ni mu m camer a firmware version required. Additionally the firmware column will indicate which parameter is a member of t he DA L SA Feat ur es Naming Convention (DFN C), v er ses t he GenI Cam Stand ar d Features Naming Convention (SFNC not shown). The Dev i ce V er si on nu mber r epr esents the camera software functional group, not a firmware revision number .
Display Name Feature Description Device Version & View Test Pattern TestI m ageSel ect or Selects the type of test image that is sent 1.00 by the camer a. Choi ces ar e ei ther as Begi nner d ef i ned by SN FC and/ or as provided by DFN C the d ev i ce m anuf actur er . Off Off Sel ects sensor v i d eo t o be output f r om sensor
Ramp Ramp Sel ects a gr ey scal e Line Mirroring Rev er seX 1.00 Off Off Video output in normal order Begi nner On On V i d eo ou tput i n a r ev er se or d er DFN C
Pixel Format Pi xel Format Output image pixel coding format of the 1.00 sensor . Begi nner DFN C Width Width W i d th of the I m age pr ov i d ed by the 1.00 device (in pixels).(RO) Begi nner M ax Width WidthM ax The maximum image horizontal 1.00 d i mensi on of the i m age. (RO) Begi nner H ei ght H ei ght H ei ght of the I mage pr ov i d ed by the 1.00 device (in lines). (RO) Begi nner Input Pixel Size pixelSizeInput Size of the image input pixels, in bits per 1.00 pixel. (RO) DFN C Guru 8 Bits/ Pixel Bpp8 Sensor output d ata path is 8 bits per 10 Bi ts/ Pixel Bpp10 pixel. 12 Bi ts/ Pixel Bpp12 Sensor output d ata path is 10 bits per pixel. Sensor output d ata path is 12 bits per pixel. Multiple AOI Mode m ultipleAOIMode Turns on an output Area of Interest 1.00 Off Off A r ea of i nter est i s of f Begi nner A ctive A ctive A r ea of i nter est i s on DFN C
Multiple AOI Count multipleAOICount Set the number of output area of interest 1.00 1-4 Begi nner DFN C
Teledyne DALSA 03-032-20176-06 68 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Multiple AOI Sel ect or multipleAOISelector Sel ects the ar ea of i nter est t o be setup 1.00 Begi nner DFN C AOI Offset X multipleAOIOffsetX Set the star t of ar ea of i nter est (pi xel s) 1.00 Begi nner AOI Width multipleAOIWidth Set the width of area of interest (pixels) 1.00 Begi nner DFN C Binning Binning is the combining of two or more image sensor pixels to form a new combined pixel. A binned i m age usi ng t he same exposur e setti ngs as a non-binned image will show an i mpr ov ed si gnal -to-noi se r ati o, r ed uced scanni ng ti m es (d ue to l ow er spat i al r esol uti on) and sav e as a sm al l er i mage f i l e si ze compared w ith a non-bi nned i mage, at t he expense of l ow er i mage r esol u ti on.
In 2 x 2 binning, 4 physical pi xel s on the sensor ar e combi ned i nt o one i m age pi xel . Thi s oper ati ng mod e is ideal f or appl ications that require faster acquisiti on and processi ng ti mes and r equire greater signal collecti on.
For thi s camer a, t he d ef aul t bi nni ng v al ue i s 1 x 1,
The Binning V ertical and Binning Horizontal features in the I mage Format Control set r epr esent s the number of hor i zont al pi xel s that w i l l be combi ned (ad d ed ) together .
N ote: Compar ed t o r unni ng the camer a i n TDI stages = 2, running the camera in 2 x 2 binning mode will result in 4x responsivity, not 2x. Any i ncr ease i n output d ue to bi nni ng i s r el ati v e t o a si ngl e sensor l i ne (TDI stage = 1).
Image Format Control Display Name Feature Description Binning Vertical BinningVertical Thi s f eatur e r epr esents t he number of vertical photo- sensi ti v e cel l s t hat mu st be combi ned (ad d ed ) toget her : 2.
N ote: TDI stages mu st be set to 1 bef or e v er ti cal bi nni ng can be changed to 2x. Binning Horizontal BinningHorizontal Thi s f eatur e r epr esents the number of horizontal photo- sensi ti v e cel l s t hat mu st be combi ned (ad d ed ) toget her .
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 69
Figure 25: 2x2 Binning in Area Mode Area of Interest (AOI) Setup The A r ea of I nter est (AOI) f eatur e can be used to r ed uce the am ou nt of i mage-data output from the camer a. U se thi s f eatur e w hen ther e ar e ar eas i n t he i mage that contain unneeded information.
A n examp l e w her e y ou w oul d use thi s f eatur e i s i n an applicati on that is i nspecting several separ ated lanes of objects w i th one camer a and t he i m age bet w een the l anes can be i gnor ed .
The A OI f eatur e al l ow s f r om one t o f our speci f i c ar eas of the pi xel l i ne to be speci f i ed w her e i m age d ata w i l l be output. Si nce the A OI f eatur e r ed uces t he amount of d ata outpu t , this has the additional benefit of al l ow i ng t he camer as to op er ate at hi gher EXSYNC rates when using base or med i um camer a l i nk m od es.
For exampl e, i n t he 4k cam er a mod el , if the total number of pixels for the specified AOI`s is less than 1 K when using base Camera Li nk mode at 85 MHz, the maximum EX SY N C r ate can be 100 kHz; v er sus 41 kHz if all 4 K pixels were output.
N ote: The setup of A OI i s al w ays w i th r espect to t he sensor . Ther ef or e, i f you ar e usi ng the mi r r or i ng mod e w i th A OI , be aw ar e t hat p i xel one w i l l be on t he r i ght si d e of the d i sp l ayed i mage.
In order to set up an AOI for the camera: 1. The A OI m od e mu st f i r st be i n the of f posi ti on. 2. U se the A OI Cou nt t o sel ect the tot al number of A OI s d esi r ed to a max of 4. 3. To set up each A OI i nd i v i d ual l y use t he A OI Sel ector t o poi nt to t he A OI t o be set up. 4. AOI Offset X is used indicate the starting pixel of the AOI. 5. AOI Width is used to indicate the width of the AOI.
Teledyne DALSA 03-032-20176-06 70 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
1. Must be off to 2. Set up the number of set up the A OI . A OI d esi r ed to max of 4.
3. Sel ect ar ea to set up. 4. Sel ect begi nni ng of sel ected ar ea
5. Set up width of sel ected ar ea
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 71
In order to initiate operation of the AOI once setup: 1. The A OI m od e mu st be changed to A cti v e. 2. Be sur e to set the f r ame gr abber i mage w i d t h to t he su m of al l A OI w i d ths set up i n the camer a.
Once al l A OI ar e set up change to acti v e.
Teledyne DALSA 03-032-20176-06 72 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Instructions on Using the Camera Scan Direction to Control Camera Parameters The camera i s capable of ad justing camer a parameters on-the-fly based on the scan direction of the camer a. These p ar ameter s i ncl ud e gai n, f l at f i el d coef f i ci ents, w hi te bal ance and exposur e ti me.
1. The f i r st step i s to put t he camer a i n t he r ev er se d i r ecti on. Thi s can be d one u si ng a r ev er se signal through CC3 and the Direction Source set to external or by having the Direction Sour ce set to I nter nal and t he I nter nal Di r ecti on set t o r ev er se. 2. Set up all the desired parameters, including flat field corrections.
Fi r st, setup par ameter s f or the r ev er se d i r ecti on.
3. Sav e the camer a p ar ameter s to a U ser set other t han the d ef aul t user set.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 73
Sav e to a user set choi ce.
4. The next step is to put the camera in the forward direction. This can be done using a forward signal through CC3 and the Direction Source set to external or by having the Direction Sour ce set to I nter nal and t he I nter nal Di r ecti on set t o f or w ar d . 5. Set up al l t he d esi r ed par ameter s i ncl ud i ng d oi ng a f l at f i el d .
Setup parameters for forward direction.
6. Sav e the camer a set to U ser Set other than t he sav ed to f or the r ev er se d i r ecti on. The f or w ar d d i r ecti on user set and the d ef aul t user set mu st be the same.
Teledyne DALSA 03-032-20176-06 74 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Forward direction user set and default user set must be the same.
Sav e to a d i f f er ent user set than the one sel ected f or r ev er se d i r ecti on.
Set the Fl at Fi el d mod e to Scan direction Controlled.
I n the Fl at Fi el d ar ea change the mod e t o Scan Di r ecti on Contr ol l ed .
A Note on External Direction, Direction Source, and User Sets If using external direction control through CC3 ensure that the Direction Source is both set to external and sav ed i n t he user set. A l so ensur e that t he pol ar i t y on CC3 i s set appr opr i atel y f or the d esi r ed direction.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 75
Transport Layer Control Category Par ameter s i n gr ay ar e r ead onl y, ei t her al w ays or d ue to anot her par ameter bei ng d i sabl ed . Par ameter s in bl ack are user set in CamExpert or progr ammable vi a an imaging appl ication. Features listed in the description table but tagged as Invisible ar e usual l y f or Tel ed yne DA L SA or thi r d party softw are usage—not typi cal l y need ed by end user appl i cati ons.
Teledyne DALSA 03-032-20176-06 76 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Transport Layer Feature Descriptions The f ol l ow i ng t abl e d escr i bes these p ar ameter s al ong w i th t hei r v i ew attr i bute and mi ni mu m camer a firmware version required. Additionally the firmware column will indicate which parameter is a member of t he DA L SA Feat ur es Naming Convention (DFN C), v er ses the GenICam Standard Features Naming Convention (SFNC not shown).
Display Name Feature Description Device Version & View Rest ar t Camer a Dev i ceReset U sed to r estar t t he camer a, w ar m 1.00 r eset Begi nner DFN C XML Major Dev i ceM ani f est XM L M ajor V er si on Toget her w i t h 1.00 V er si on Dev i ceM ani f est XM L M i nor V er si on Begi nner speci f i es the GenI Cam ™ f eatur e DFN C description XML file version (RO) XML Minor Dev i ceM ani f est XM L M i nor V er si on Toget her w i t h 1.00 V er si on Dev i ceM ani f est XM L M ajor V er si on Begi nner speci f i es the GenI Cam ™ f eatur e DFN C description XML file version (RO) Last GenCP Status gen CPSt at u s If a feature read or w rite fai ls then 1.00 Sapera only Begi nner returns that it fails – read this DFN C f eatur e to get t he actu al r eason f or the f ai l ur e Retur ns the l ast er r or Readi ng this feature clear s i t Ref r esh GenCP r ef r eshGenCPStat us Press to return the current status of 1.00 Status the GenCP Begi nner Camer a Link ClConfiguration Camera Link Output configuration 1.00 Configuration Base Begi nner M ed i um Full Deca Camer a Link clDeviceCl ockFrequency Set the camer a l i nk cl ock r ate 1.00 Configuration CL85M H z Begi nner CL66M H z Tap Geometr y Dev i ceTapGeometr y (RO) 1.00 Begi nner
Acquisition and Transfer Control Category The P4 Acquisition and Transfer controls, as shown by CamExpert, groups parameters used to configure the optional acquisition modes of the d ev i ce. Par ameters in gr ay are read only, either al w ays or due to another parameter bei ng d i sabl ed . Par ameter s i n bl ack ar e user set i n CamExper t or pr ogr am m abl e v i a an imaging application.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 77
Features listed in the description table but tagged as Invisible ar e usual l y f or Tel ed yne DA L SA or thi r d party softw are usage—not typi cal l y need ed by end user appl i cati ons.
Acquisition and Transfer Control Feature Descriptions The f ol l ow i ng t abl e d escr i bes these p ar ameter s al ong w i th t hei r v i ew attr i bute and mi ni mu m camera firmware version required. Additionally the firmware column will indicate which parameter is a member of t he DA L SA Feat ur es Naming Convention (DFNC), v er sus t he GenICam Standard Features Naming Convention (SFNC not shown).
Display Name Feature Description Device Version & View Dev i ce Dev i ceRegi ster sStr eami ngStar t A nnounces t he st ar t of r egi ster s streami ng 1.00 Regi ster s w i thout i m med i ate checki ng f or Begi nner St r eam i n g St ar t consistency. DFN C Dev i ce Dev i ceRegi ster sStr eami ngEnd Announces end of registers streaming and 1.00 Regi ster s performs validation for registers Begi nner Streaming End consi stency bef or e act i v ati ng them. DFN C Check Str eam Dev i ceRegi ster sCheck Pr ess to check the v al i d i ty of the cur r ent 1.00 Validity r egi ster set. Begi nner DFN C Regi ster s V al i d DeviceRegistersValid States if the current register set is valid 1.00 and consistent. Begi nner DFN C
Teledyne DALSA 03-032-20176-06 78 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Serial Port Control Category The Ser i al Por t contr ol i n CamExper t al l ow s the user t o sel ect an av ai l abl e camer a ser i al p or t and r ev i ew i ts setti ngs. Thi s secti on al so d escr i bes t he Geni e TS Fr amew or k V i r tu al Ser i al Por t Dr i v er and the use of the Geni e TS ser i al p or t as an i nter f ace f r om an Ether net netw ork to a serial port control system for other d ev i ces. Features listed in the description table but tagged as Invisible ar e usual l y f or Tel ed yne DA L SA or thi r d party softw are usage—not typi cal l y need ed by end user appl i cati ons.
Serial Port Control Feature Descriptions The Dev i ce V er si on nu mber r epr esents the camer a sof t w ar e f uncti onal gr oup, not a f i r m w ar e r ev i si on number .
Display Name Feature Description View Baud Rate Dev i ceSer i al Por tBaud Rate Sets the baud r ate used by t he sel ected 1.00 d ev i ce’s ser i al por t. A v ai l abl e baud r ates ar e Begi nner d ev i ce-specific. DFN C Baud 9600 Baud 9600 Baud rate i s 9600 Baud 19200 Baud 19200 Baud rate i s 19200 Baud 57600 Baud 57600 Baud rate i s 57600 Baud 115200 Baud 115200 Baud rate is 115200 Baud 230400 Baud 230400 Baud rate is 230400 Baud 460800 Baud 460800 Baud rate is 460800 Baud 921600 Baud 921600 Baud rate is 921600
Serial Port Parity deviceSerialPortParity Sets the par i ty check i ng typ e on the sel ected 1.00 serial port.(RO) Begi nner
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 79
Display Name Feature Description View None None Parity checking is disabled DFN C Data Si ze deviceSerialPortDataSize Sets the bi ts per char acter (bpc) to use (RO). 1.00 Eight Bits bpc8 U se 8 bi ts per char acter Begi nner DFN C Stop Bits d ev i ceSer i al Por tN u mber Of Sets the nu mber of st op bi ts to use. 1.00 StopBits Begi nner Stopbits1 Stopbits1 U se 1 stop bi t DFN C
File Access Control Category The File Access control in CamExpert allows the user to quickly upload various data files to the connected P4. The suppor t ed d ata f i l es ar e f or P4 f i r m w ar e upd ates, Fl at Fi el d coef f i ci ents. L U T d at a tables, and a custom i mage for use as an i nternal test pattern. Features listed in the description table but tagged as Invisible ar e usual l y f or Tel ed yne DALSA or third party softw are usage—not typi cal l y need ed by end user appl i cati ons.
Teledyne DALSA 03-032-20176-06 80 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
File Access Control Feature Descriptions
Display Name Feature Description View Fi l e Sel ector Fi l eSel ector Sel ects the f i l e to access. The f i l e types w hi ch 1.00 ar e accessi bl e ar e d ev i ce-d epend ent. Begi nner FPGA Code Firmw are1 U pl oad new FPGA to the camera which will DFN C execute on t he next camer a r eboot cycl e. M icro Code Upload new micro codeto the camera which w i l l execute on t he next camer a r eboot cycl e. CCI Upload new CCI to the camera which will execute on t he next camer a r eboot cycl e. XML Upload new XML to the camera which will execute on t he next camer a r eboot cycl e. U ser Set U se U ser SetSel ector to speci f y w hi ch user set to access. Factory Fl atField U se U ser SetSel ector to speci f y w hi ch user coef f i ci ents flatfield to access. U ser FPN U se U ser SetSel ector to speci f y w hi ch user FPN to access. Camer aData Dow nl oad camer a i nformation and send for customer support. Fi l e Oper ati on Sel ector Fi l eOper ati onSel ect or Sel ects the tar get oper ati on f or the sel ected f i l e 1.00 i n the d ev i ce. Thi s oper ati on i s executed w hen Guru the Fi l e Oper at i on Execute f eatur e i s cal l ed . Open Open Sel ect the Open oper at i on - executed by Fi l eOper ati onExecu te. Cl ose Cl ose Sel ect the Cl ose oper at i on - executed by Fi l eOper ati onExecu te. Read Read Sel ect the Read oper ati on - executed by Fi l eOper ati onExecu te. Write Write Sel ect the W r i te oper ati on - executed by Fi l eOper ati onExecu te. Del ete Del ete Sel ect the Del ete oper ati on - executed by Fi l eOper ati onExecu te. Fi l e Oper ati on Execute Fi l eOper ati onExecu te Executes the oper ati on sel ected by Fi l e 1.00 Oper at i on Sel ector on the sel ected f i l e. Guru File Open Mode FileOpenMode Sel ects the access m od e used to open a f i l e on 1.00 the d ev i ce. Guru Read Read Sel ect REA D onl y open m od e Write Write Sel ect W RI TE onl y open m od e Fi l e A ccess Buf f er Fi l eA ccessBuf f er Def i nes t he i nter med i ate access buf f er that 1.00 al l ow s the exchange of d at a betw een the d ev i ce Guru file storage and the application. Fi l e A ccess Of f set Fi l eA ccessOf f set Contr ol s t he m appi ng of f set betw een t he 1.00 d ev i ce f i l e stor age and the f i l e access buf f er . Guru Fi l e A ccess L ength Fi l eA ccessL engt h Controls the mapping length between the 1.00 d ev i ce f i l e stor age and the f i l e access buf f er . Guru Fi l e Oper ati on St at u s Fi l eOper ati onSt atu s Di spl ay s the f i l e oper at i on executi on st atus. 1.00 (RO). Guru
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 81
Display Name Feature Description View Success Success The l ast f i l e oper ati on has compl eted successf ul l y . Fai lure Fai lure The l ast f i l e oper ati on has compl eted unsuccessfully for an unknown reason. File Unavailable FileUnavailable The l ast f i l e oper ati on has compl eted unsuccessf ul l y because the f i l e i s cur r entl y unavai lable. File Invalid FileInvalid The l ast f i l e oper ati on has compl eted unsuccessf ul l y because the sel ected f i l e i n not pr esent i n t hi s camer a mod el . Fi l e Oper ati on Resul t Fi l eOper ati onResu l t Di spl ay s the f i l e oper at i on r esul t. For Read or 1.00 W r i te oper ati ons, t he nu mber of successf ul l y Guru r ead / w r i tten bytes i s r et ur ned . (RO) File Size FileSize Repr esent s the si ze of the sel ected f i l e i n bytes. 1.00 Guru File Access via the CamExpert Tool 1. Click on the “ Setting…” button to show the file selection menu.
2. Fr om t he Type d r op menu, sel ect the f i l e type t hat w i l l be upl oad ed to the camer a. 3. Fr om t he Fi l e Sel ect or d r op menu, sel ect the camer a memor y l ocati on f or t he upl oad ed d ata. Thi s menu pr esents onl y the ap pl i cabl e d at a l ocati ons f or t he sel ected f i l e type.
Teledyne DALSA 03-032-20176-06 82 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
4. Click the Browse button to open a typical Windows Explorer window. 5. Sel ect the specific file from the system drive or from a network location. 6. Cl i ck the U pl oad button to execute the f i l e tr ansf er to t he camer a. 7. N ote that f i r mw ar e changes r equi r e a d ev i ce r eset com mand f r om t he Camer a I nf or m ati on Controls and, additi onall y, CamExpert shoul d be shut d ow n and r estar ted f ol l ow i ng a r eset. Download a List of Camera Parameters For diagnostic purposes you may w ant to dow nl oad a list of all the par ameter s and values associ ated w i th t he camer a. 1. Go to File A ccess Control 2. Click on Settings 3. In the “ Type” d r op d ow n box sel ect “ M i scel l aneous.” 4. I n the “ Fi l e sel ector ” d r op d ow n box sel ect “ Camer aD at a.”
5. Hit “ Download” 6. Sav e the text f i l e and send t he f i l e to Tel ed y ne DA L SA customer support.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 83
Teledyne DALSA 03-032-20176-06 84 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Appendix B: ASCII Commands
The following commands can be used t o contr ol t he Tel ed yne DA L SA Pi r anha4 camer as.
Accessing the Three Letter Commands (TLC) To access the TL C an A SCI I -based communicati ons interface applicati on, such as H yperTermi nal.
Additionally it is possible to use the functions of clserxxx.dll or clallserial.dll as d ef i ned i n the Camer a L i nk Speci f i cati on.
Figure 26: Serial DLL hierarchy as mentioned in the Camera Link Specification
1. Cycl e pow er to the camer a: by ei ther a) i ssui ng t he r eset camer a comm and (rc), or b) powering the camera OFF and then ON. 2. Load the ASCII interface using: • 9600 baud • 8 data bits • no parity • 1 st op bit • no flow control • local echo • (car r i age r etur n / l i nef eed ) 3. W ai t f or a st abl e stat us L ED col or (gr een or r ed ) bef or e pr oceed i ng. Note that all entries in H yper Terminal will be ignored until a stable LED color is obtained. 4. I n case of H yper Ter m i nal , pr ess the
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 85
Notes on Using Alternatives to HyperTerminal • I f you ar e u si ng i nter f aces other than H yper Ter mi nal , t he A SCI I char acter , ESC, i s d eci mal 27 and need s to be i ssued . Fr om the comm and l i ne i nser t ESC by usi ng A L T+2+7 of t he acti v ated N um - Pad. I n some cases t hi s need s to be f ol l ow ed by a car r i age r etur n or a l i nef eed to send thi s t o the camer a. • I n A SCI I the ESC char acter may l ook l i ke thi s: “←”. ASCII to GenCP To switch from the ASCII-com mand i nter f ace to t he GenCP i nter f ace, the camer a must be ei t her r eset (RC) or the pow er mu st be cycl ed . N ote that GenCP and A SCI I comm and s cannot be accessed si mu l t aneousl y .
Note that the HyperTerminal application is not available on the Windows 7 OS.
Alternatives to H yperTerminal The f ol l ow i ng al ter nat i v e A SCI I -interfaces have been tested and shown to work with this camera: PuTTY and Ter aTer m. N ot e that PuTTY d oes not hav e Xm od em capabi l i t y w hi l e Ter aTer m d oes. Xm od en i s r equi r ed t o upd ate cod e i n t he camer a.
The camer a r esp ond s t o a si mpl e A SCI I -based pr otocol . A car r i age r etur n
Example: to return the current detector settings gcp
A compl ete l i st of t he av ai l abl e d etector com mand s, t hei r f or mat and par ameter s can be d i sp l ayed by send i ng the hel p (h) command. Port Configuration
Baud: 9,600 Bi ts: 8 Par i ty: None Stop bits: 1 Flow Control: None
Echo typed char acters l ocal ly.
Rules • The i nter f ace i s not case sensi ti v e • One command and argument(s) per line • To enter a f l oati ng poi nt nu mber pr ef i x i t w i t h a “ F” – f or example “ ssg 0 f1.5” • Er r or cod es r etur ned ar e the same as t he GenI Cam™ i nter f ace – see Di agnost i cs | Er r or Cod es • Foll ow each command w i th the carr iage return char acter – 0x0D
Teledyne DALSA 03-032-20176-06 86 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Disabling the Esc Key for Direct Access to ASCII Commands
By d ef aul t t he Esc key i s enabl ed and an Esc key sequence has to be i ssued i n or d er to access the A SCI I com mand s. U si ng the DEK 1 com m and t he need to i ssue an Esc key i s d i sabl ed and access to t he A SCI I commands are av ail able i mmediately upon camer a boot up. N ote: access t o GEN CP i s no l onger av ai l abl e w i th t he Esc key d i sabl ed unl ess a DEK 0 comm and i s i ssued and the camer a r e-booted. Commands Full Name Calibrate User FPN M nemonic CCF Argument(s) # of l i nes to av er age • 2048 • 4096 Description Calibrate user FPN dark flat field coefficients
Full Name Camera Link Speed M nemonic CLS Argument(s) Fr equency 0. 85 M H z 1. 66 M H z Description Camer a L i nk cl ock f r equency
Full Name Camera Link M ode M nemonic CLM Argument(s) M ode 0. Base 1. M ed i um 2. Full 3. Deca (4K only) Description Camer a Link M ode
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 87
Full Name Calibrate Flatfield M nemonic CPA Argument(s) Algorithm 0. Basi c 1. Low-pass Fi l ter # of l i nes to av er age • 2048 • 4096 Tar get 0 to 4095 DN i n 12 bit mod e 0 to 1023 DN i n 10 bit mod e 0 to 255 DN in 8 bit mode Description Cal i br ate user PRN U f l at f i el d coef f i ci ents N otes • Per f or m f l at f i el d cal i br at i on usi ng t he av er age of <# l i nes>. • With filter algorithm this average line is then smoothed and outlier pixels are i nter pol ated . U se t hi s f eat u r e i f your w hi te r ef er ence i s not f eat ur el ess. • Adjust pixel gain such that output will be
Full Name Disable Esc Key M nemonic DEK Argument(s) Mode 0. Esc key i s enabl ed 1. Esc key is disabled Description Allow the use of the Esc key to be disabled so that upon boot-up the camera will directly enter the ASCII command mode. With the Esc key disabled the GENCP cannot be accessed. N otes To access the GenCP, y ou hav e to f i r st i ssue t he DEK 0 com mand i n or d er to enabl e the ESC key. Then r eboot the camer a.
Full Name D evice Scan Type M nemonic D ST Argument(s) M ode 0. L i n e Scan 1. A rea Scan Description U se thi s com mand to sw i tch betw een A r ea and Si ngl e L i ne m od es. N otes • ST G must equ al 1 to enter t he ar ea mod e DST = 1
Teledyne DALSA 03-032-20176-06 88 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full Name Flatfield M ode M nemonic FFM Argument(s) M ode 0. Disable use of user FPN and PRNU flat field correction coefficients 1. Enabl e u se of user FPN and PRN U f l at f i el d correction coefficients 2. Reset user FPN coef f i ci ents to zer o and user PRNU coefficients to one 3. Scan direction controlled user set loading Description Set flat field mode N otes
Full Name Set Flatfi eld Scan D irection Reverse Set M nemonic FRS Argument(s) U ser Set N umber 1 to 8 Description Set scan d i r ecti on contr ol l ed r ev er se set N otes
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 89
Full Name Display Camera Configuration M nemonic GCP Argument(s) Description Displ ay current v alue of camera configuration par ameters N otes USER>gcp Model P4_CM_02K10D_00_R Microcode 03-081-20296-96 CCI 03-110-20294-96 FPGA 03-056-20470-97 Serial # S1050616 BiST: Good
DefaultSet 0 Ext Trig Off Line Rate 10000 [Hz] Meas L.R. 10000 [Hz] Max L.R. 19607 [Hz] Exp. Mode Timed Multi Exp. Mode Off Exp. Time[0] 50000 [ns] Meas E.T.[0] 50000 [ns] Max E.T. 99000 [ns]
Test Pat. 0:Off Direction Internal, Forward TDI Stages 1 Vert. Bin 1 Hor. Bin 1 Flat Field Off Offset 0 System Gain 1.00 Mirror Off AOI Mode: Off Scan Type Line Scan CL Speed 85MHz CL Config Full Pixel Fmt 8 bits CPA ROI 1-2048
Full Name Get V alue M nemonic GET
Argument(s) <’par ameter >
Description The “ get ” com mand d i spl ays the cur r ent v al ue(s) of the f eatur e speci f i ed i n t he str i ng par ameter . N ote t hat the p ar ameter i s pr eced ed by a si ngl e quote “ ’ ” . U si ng thi s command will be easier for control softw are than parsing the output from the “ gcp” command. N otes
Teledyne DALSA 03-032-20176-06 90 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full Name H elp M nemonic H Argument(s) Description Di spl ay l i st of thr ee l etter com mand s (2K help screen shown) N otes USER>h P4 (03-081-20296-96): Command Line Interpreter Jul 16 2013, 07:49:58
ccf - Calibrate User FPN <2048|4096> cls - Camera Link Speed <0 - 85MHz, 1 - 66MHz> clm - Camera Link Mode <0:Base 1:Med 2:Full> cpa - Calibrate Flatfield <0:basic 1:filter><2048|4096>
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 91
Full Name Load Pixel Coefficients M nemonic LPC Argument(s) Set sel ector 0. Factor y set 1-8. U ser sets Description L oad user set N otes • L oad s FPN coef f i ci ents and PRN U coef f i ci ents f r om a user set ( onl y coef f i cei nts, no other camer a par ameter s)
Full Name Reset Camera M nemonic RC Argument(s) Description Resets t he camer a t o the sav ed user d ef aul t sett i ngs. These setti ngs ar e sav ed usi ng the usd command. N otes The mi cr o-controller reboots: • Load any file updates • Cl ear ov er temper at ur e cond i ti on • Per f or m st ar t up camer a tests (Bi ST) • Load FPGA code • Configure FPGA and sensor. • Load default user set • Baud rate set to 9600
Full Name Set Flatfi eld ROI M nemonic ROI Argument(s) First pixel 1 to 2048 (2K) 1 to 4096 (4K) L ast pi xel 1 to 2048 (2K) 1 to 4096 (4K) Description Flat field region of interest N otes • Specifies the pixels that CCF and CPA will calibrate o Pixel coefficients outside this region are not changed • L ast pi xel must be gr eater t han or equal to f i r st pi xel
Full Name Reset Flatfield Coefficients M nemonic RPC Argument(s) Description Reset al l user FPN v al ues t o zer o and al l u ser PRN U coef f i ci ents t o one N otes
Teledyne DALSA 03-032-20176-06 92 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full N ame Set AOI Count M nemonic SAC Argument(s) N umber of A OI ’s 1 to 4 Description Set A OI Counter N otes
Full Name Set AOI Sel ector M nemonic SAD Argument(s) Sel ector 1 to 4 Offset 1 to A OI Count – any pixel can be starti ng pixel Width N o l ess t han 40 pixels Description Def i ne an A OI N otes • Must not overlap with an already existing AOI
Full Name Set AOI M ode M nemonic SAM Argument(s) M ode 0. Off / Disable 1. Active / Enable Description Set A O I m od e N otes
Full Name Set Binning Horizontal M nemonic SBH Argument(s) Binning 1. Single pixel 2. Binning of 2 pixels Description Set horizontal binning N otes • Available in all modes: single line, TDI and Area
Full Name Set Baud Rate M nemonic SBR Argument(s) Baud rate 9600 57600 115200 230400* 460800* 921600* Description Set baud rate N otes • Send command and then change speed of HyperTerminal • A Px8 or equi v al ent f r ame gr abber i s r equi r ed i n or d er to achi ev e these baud r ates.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 93
Full Name Set Binning Vertical M nemonic SBV Argument(s) 1. Single pixel 2. Binning of 2 pixels Description Set vertical binning N otes • M ust be i n Si ngl e l i ne m od e (stg 1) • M ust be i n L i ne scan m od e (d st 0)
Full Name Direction M nemonic SCD Argument(s) Di r ecti on 0. Forward 1. Rev er se (not av ai l abl e i n si ngl e l i ne m od e) 2. Exter nal – controlled by CC3 signal (not available in single line mode) Description Set sensor scan d i r ecti on N otes
Full Name Set Exposure Sel ector M nemonic SES Argument(s) M ode 0. All 1. Bottom 2. Top Description Set exposur e sel ect or - when in multi exp osur e mod e (see SM E comm and ) the exp osur e ti me f or the t op and bot tom l i nes can be set i nd epend entl y N otes • When not in m ul ti p l e exposur e mod e “ A l l ” i s onl y sel ecti on
Full Name Exposure M ode M nemonic SEM Argument(s) M ode 0. I nter nal (“ Ti med ” ) 1. Exter nal (“PulseWidth”) Description Set exposur e ti me mod e N otes • I n i nter nal m od e the exposur e ti me i s contr ol l ed by t he SET comm and • I n exter nal m od e the sensor i s exposed w hi l e CC1 si gnal i s hi gh • Exter nal mod e i s onl y av ai l abl e w hen t he tr i gger mod e i s al so exter nal (STM 1) • SEM 1 ov er r i d es i nter nal l y gener ated i nd epend ent exp osur e ti mes • When CC1 signal falls line is read
Teledyne DALSA 03-032-20176-06 94 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full Name Exposure Time M nemonic SET Argument(s) Exposure time 1, 000 to 3, 000, 000 [ns] Description Set i nter nal exposur e ti me in nanosecond s – 25 ns r esol uti on N otes • L i ne ti me > ( Exposur e ti m e + 1,500 ns )
Full Name Set M ulti-Exposure (2K only) M nemonic SM E Argument(s) M ode 0. Off 1. Multi-Exposur e On Description Set multi-exposur e m od e al l ow i ng each l i ne t o hav e i nd epend ent exposur e ti mes and gai ns. N otes
Full Name M irroring M nemonic SM M Argument(s) M ode 0. Off 1. Image is flipped on the vertical axis Description Set mirroring mode N otes
Full Name Pixel Format M nemonic SPF Argument(s) Sel ector 0. 8 bits 1. 10 bits 2. 12 bits (only available with Base or Medium Camer a Link configur ati ons) Description Set pi xel f or mat N otes
Full Name Offset M nemonic SSB Argument(s) Offset 8 bit -32 to 31 10-bit -128 to 127 12-bit -512 to 511 Description Set contrast offset – si ngl e value added to all pixels after PRNU/ flat field coefficients (bef or e gai n). N otes • Range changes d epend i ng on pi xel f or m at (SPF)
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 95
Full Name I nternal Line Rate M nemonic SSF Argument(s) L i ne r ate 1 to 100, 000 [H z] (TDI mode) 1 to 200, 000[H z}] (A r ea mode) Description Set i nter nal l i ne r ate i n H z N otes • L i ne ti me > ( Exposur e ti m e + 1, 000 ns )
Full Name Gain M nemonic SSG Argument(s) Sel ector 0. Sy st em Gai n 1. Bottom Line 2. Top Line Gain 1.0 to 10.0 Description Set gain as a si ngle value multiplied by all pixels. N otes • When not in multiexposure mode System gain in only available • Floati ng point number: 1.0 to 10.0. • N ote that gai n v al ue mu st be pr eced ed by an “ f ” (e.g. ssg 0 f1.5)
Full Name Set TD I Stages M nemonic STG Argument(s) Sel ector TDI stage 1. Single line mode (lower sensitivity). 2. TDI mode (higher sensitivity) Description N otes • I n si ngl e l i ne m od e the cam er a mu st be i nter nal d i r ecti on contr ol • TDI mode: a pair of lines summed with suitable delay
Full Name External Trigger M nemonic STM Argument(s) M ode 0. I nter nal 1. Exter nal Description Set tr i gger mod e N otes • In internal mode line rate is controlled by SSF command • In external mode readout starts on fal ling edge of CC1 signal and i s av ail able only when STM = 1 (exter nal tr i gger on) • Exposur e ti me equ al s hi gh ti me of EXSYN C on si gnal on CC1
Teledyne DALSA 03-032-20176-06 96 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Full Name Test Pattern M nemonic SV M Argument(s) M ode 0) Sen sor V i d eo 1) Ramp 3) A5 4) Each_tap_fixed 5) All_1365 6) All_1 Description Select test pattern N otes • When a test pattern is selected all digital processing (e.g. flat field, gain) is disabled – i t i s r e-enabl ed w hen sensor v i d eo i s sel ect ed
Full Name D efault User Set M nemonic USD Argument(s) Set sel ector 0. Fact or y set 1-8. U ser sets Description Sel ect user set to l oad w hen camer a i s r eset N otes • The setti ngs i ncl ud e al l t hose l i sted by t he GCP com m and pl us the u ser FPN coef f i ci ents, and u ser PRN U coef f i ci ents
Full Name Load User Set M nemonic USL Argument(s) Set sel ector 0. Fact or y set 1-8. U ser sets Description L oad user set N otes • L oad s and makes cur r ent al l the setti ngs l i sted by t he GCP com m and pl u s the user FPN coef f i ci ents, and user PRN U coef f i ci ent s
Full Name Save User Set M nemonic USS Argument(s) Set sel ector 1 to 8 Description Sav e user set N otes • Sav es al l the cur r ent setti ngs l i sted by t he GCP com m and pl us t he user FPN coef f i ci ents, and u ser PRN U coef f i ci ents
Full Name Temperature M nemonic VT Argument(s) Description Di spl ay i nter nal temper atu r e i n d egr ees Cel si u s N otes • M easur ed with an accuracy of ± 1.5 ºC.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 97
Full Name V oltage M nemonic VV Argument(s) Description Display supply voltage N otes • M easur ed w i th an accuracy ± 0.1 V.
Teledyne DALSA 03-032-20176-06 98 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Appendix C: Error and Warning Messages
BiST: Built in Self Test The BiST error flags are binary flags with each bit being independent from each other. The message f r om the BiST should be “Good” meaning everything is functioning correctly but if a hardware failure does occur i n t he camer a one or mor e these f l ags cou l d be set. A ny of these er r or s w i l l result in the status light turning red.
Definition BiST Flag I2C error 1 Unable to configure fpga 10 Unable to configure fpga 100 EXT_SRA M Fai lure 1000 ECH O_BA CK Failure 1,0000 FL A SH _T I M EO U T 10,0000 FLA SH _ERROR 100,0000 N O_FPGA _Code 1000,0000 NO_COMMON_SETTINGS 1,0000,0000 NO_FACTORY_SETTINGS 10,0000,0000 N O _U SER_SET T I N GS 100,0000,0000 N O_FLA T_FIELD Correcti ons 1000,0000,0000 N O M ISC corrections 1,0000,0000,0000 NO_FPN Correction 10,0000,0000,0000 NO_FPN Correction 100,0000,0000,0000 NO_PRNU Correction 1000,0000,0000,0000 NO_FEED Through Correction 1,0000,0000,0000,0000 NO_LINEARITY Correction 10,0000,0000,0000,0000 SY N C_ERRO R 100,0000,0000,0000,0000 OVER_TEM PERA TURE 1000,0000,0000,0000,0000 SPI Fai l u r e 1,0000,0000,0000,0000,0000 N O _U SER_FPN 10,0000,0000,0000,0000,0000 PLL_LOCK_FAILED 100,0000,0000,0000,0000,0000 INVALID_CCI 1000,0000,0000,0000,0000,0000 No LUT 1,0000,0000,0000,0000,0000,0000 Incompatible FPGA code 10,0000,0000,0000,0000,0000,0000
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 99
Operational Error Codes Code Description 0X8002 I nv al i d Par ameter 0xC01C CPA _TOO_M A N Y_OUTLI ERS 0x401E USER_FPN _CLIPPI N G 0x401F FLA T_FIEL D_CLI PPIN G
Teledyne DALSA 03-032-20176-06 100 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Appendix D: Quick Setup and Image Acquisition
If you are famil iar w ith the operation of Camera Li nk camer as and have an understand ing of imagi ng fundamentals, the following steps will show you how to quickly set up this camera and begin acquiring i m ages.
1. On Power-Up The camera has been cal ibr ated and confi gured at the factor y to be read y for your evaluati on w hen first pow er ed up. The d ef au l t cond i ti ons ar e set as f ol l ow s: • System gai n i s set t o the l ow est v al ue of one.
• Flat field calibration is not active as this feature is dependent on your light source and lens.
• L i ne r ate and exposur e ti m e ar e set to f or i nter nal gener ati on by t he camer a.
• Camer a L i nk m od e i s set t o the stand ar d 8-bit full mode which allows operation of up to 100 kHz l i ne r ate. Set your Camera Link frame grabber up to receive the standard 8-bit full mode.
2. Communicating with the Camera • The camer a i s d esi gned to pow er up w i th a GenI Cam-compl i ant i nter f ace.
• CamExpert pr ovides an easy-to-use GU I t hat can be used to set up and ev al uate the camer a.
• The camer a al so comes w i t h Tel ed yne DA L SA ’s thr ee l etter com m and (TL C) i nter f ace opti on, w hi ch can be accessed usi ng a su i tabl e ter mi nal pr ogr am such as H yper Ter m i nal ™.
• I f you w ant t o use t he TL C i nter f ace, pr ess t he ‘Esc’ key w hi l e usi ng a terminal program only af ter the L ED i nd i cator on t he camer a tur ns gr een. N ot e that t he camer a d ef aul ts t o 9.6 K Baud w hen f i r st pow er ed up.
• On r ecei v i ng t he ‘Esc’ char acter , the camer a w i l l outp ut a l i st of the av ail able TL C com mand s. You can t hen pr oceed to enter TL C comm and s as r equ i r ed .
• Enter ‘h’ at any time to get the list of commands from the camera.
• Enter the ‘gcp’ com m and at any t i me t o get the cur r ent setup cond i ti ons of the cam er a.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 101
3. Setting Up Your Optical Configuration Typically, the first thing you w ant to d o i s t o ev al uate t he camer a’ s i m age qu al i t y und er oper ati ng conditions similar to those that you are likely to use in your application. In order to do this, take the f ol l ow i ng step s: • The illumination, lens magnification, and focus should be set up as per you application.
• Getting the magnification right is best accomplished by setting the object-to-sensor d i stance. U se the f or mu l a l ens focal l engt h x (2 + 1/ magni fi cat i on + magni fi cat i on) to calculate this distance. M agnification equal s the sensor pi xel si ze (10.56 µm) / (your object pi xel si ze i n u m).
• The appr oxi m ate p osi t i on of the sensor i s at the f i r st gr oov e on the si d e of the cam er a case f r om the f r ont f ace of the camer a.
4. Camera Timing & Control It is easiest and quickest to evaluate the camera using the internal timing setups for line rate and exposur e ti me. • The camera starts up in the default configuration of camera link full, TDI mode, forward direction, 10 kHz l i ne r ate and 50 µsec exposur e ti me.
• If this line rate is too slow for your application, you will get a compressed image in the scan direction. You can increase the line rate by using the ‘ssf’ command.
• You can set the exposur e ti me usi ng t he ‘set’ com mand . Ensur e that the exp osur e ti me per i od i s not gr eater than the per i od of the l i ne r ate m i nu s 1.0 µsec.
• The camer a w i l l i nd i cate an er r or i f you sel ect an exp osur e ti me that i s t oo l ong. The mi ni mum exposur e ti me i s 4 µsec.
• Set your camer a d i r ect i on u si ng t he ‘scd ’ com mand .
5. Acquiring an Image You can now begin imaging. Unless you have an application employing lots of light, the image is likely to be too dark. • U se the system gai n to ad ju st the camer a outp ut to achi ev e the d esi r ed r esponse. The system gai n r ange i s f r om 1x to 10x. U se the ‘ ssg’ comm and .
• Once y ou hav e a sui t abl e r esponse, you can now f ocus the l ens.
• The i m age may be d ar ker at the ed ges d ue to l ens v i gnetti ng, bu t thi s w i l l be i mpr ov ed once t he camer a is calibr ated.
• Cal i br ati on i s per f or med u si ng a w hi te r ef er ence w her e your object is normally located.
o Use a w hite materi al that has no texture, such as a non glossy pl astic.
o I f you mu st use w hi te p ap er , make sur e i t i s m ov i ng d ur i ng t he cal i br at i on pr ocess. I f you do not do this, your image will have vertical stripes.
• Calibrati on i s easi l y per f or med usi ng the ‘cp a’ com mand .
Teledyne DALSA 03-032-20176-06 102 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
• The cpa command has 3 parameters.
o The f i r st par ameter i s a sel ecti on bet w een:
. ‘0’ – Per pixel FFC calibration
. ‘1’ – A low pass FFC calibration
o W e r ecom mend that t he second op ti on i s u sed to cor r ect f or any image non uniformity d ue to the l ens and setup.
o The second par ameter i s the number of l i nes y ou w ant to av er age ov er . U se a v al u e of 4096 to achieve the best average.
o The thi r d p ar ameter i s t he 12-bi t tar get val ue you w ant to achieve after calibr ati on.
• The cpa com mand takes sev er al second s t o compl ete. The sl ow er the l i ne r ate, the l onger i t w i l l take.
• On compl et i on of the ‘cp a’ com mand , you shoul d see an i m age f r om t he camer a t hat i s f l at f i el d cor r ected w i t h the l ens at t he tar get l ev el you set.
You are now read y to ev aluate the i mage qual ity of the P4 camera under your operati ng conditi ons.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 103
Appendix E: The Sensor Window
Cleaning and Protecting Against Dust, Oil, and Scratches The sensor window is part of the optical path and should be handled like other optical components, with extr eme car e. Du st can obscur e pi xel s, pr od uci ng d ar k patches on the sensor r esp onse. Du st i s most visible when the illumination is collimated. The dark patches shift position as the angle of illumination changes. D ust i s normally not visible when the sensor is positioned at the exit port of an integrating spher e, w her e t he i l l u mi nat i on i s d i f f use. Dust can nor mal l y be r em ov ed by bl ow i ng the w i nd ow sur f ace using an ionized air gun. Oil is usually introduced during handling. Touching the surface of the window bar ehand ed w i l l l eav e oi l y r esi d ues. U si ng r ubber f i nger cots and r ubber gl ov es can pr ev ent cont am i nati on. H ow ev er , t he f r i cti on betw een r u bber and t he w i nd ow m ay pr od uce el ectr ost ati c char ge that may damage the sensor. To avoid ESD damage and to avoid introducing oily residues, avoid touching the sensor. Scratches diffract incident illumination. When exposed to uniform illumination, a sensor w ith a scr atched w i ndow w il l nor mally have brighter pixel s ad jacent to d arker pixels. The location of these pixels will change with the angle of illumination.
An important note on window blemishes: W hen f l at f i el d cor r ecti on i s per f or med , w i nd ow cl eanl i ness i s par amou nt. The f i gur e bel ow show s an example of w hat can happen if a blemish is present on the sensor window when flat field correction is performed. The blemish will cast a shadow on the wafer. FFC will compensate for this shadow by increasing the gai n. Essenti all y FFC w ill create a w hite spot to compensate for the dark spot (shad ow ). A s long as the angle of the incident light remains unchanged then FFC works well. However when the angle of incidence changes significantly (i.e. when a lens is added) then the shadow will shift and FFC will mak es thi ngs w or se by not cor r ecti ng the new shadow (dark spot) and overcorrecting where the shadow used to be (w hi te spot). W hi l e the d ar k spot can be p ot enti al l y cl eaned , the w hi te spot i s an FFC ar t i f act that can onl y be cor r ected by anot her FFC cal i br ati on.
Teledyne DALSA 03-032-20176-06 104 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Cleaning the Sensor Window Recommended Equipment • Glass cleaning station with microscope within clean room. • Ionized air gun. For example, 3M ionized air gun. • Ionized air flood system, foot operated. • Cotton sw ab. For example, Sw ab H uby340 CA -003. • Si n g l e d r op bottl e (FD-2-ESD ) . • Optic cleaning fluid. For example, the E2 Eclipse optic cleaning system.
Procedure • Use localized ionized air flow on to the glass during sensor cleaning. • Blow off mobile contamination using an ionized air gun. • Pl ace t he sensor u nd er the mi cr oscope at a magni f i cat i on of 5x to d eter m i ne t he location of any remaining contamination. • Clean the contamination on the sensor using one drop of E2 on a sw ab. • Wipe the swab from left to right (or right to left but only in one direction). Do this in an overlapping pattern, turning the swab after the first wipe and with each subsequent wipe. Avoid swiping back and forth with the same swab in or d er to ensur e that par t i cl es ar e r emov ed and not si m pl y tr ansf er r ed to a new location on the sensor window. This procedure requires you to use multiple sw abs. • Di scar d the sw ab af ter bot h si d es of the sw ab hav e been used once. • Repeat unti l ther e i s no v i si bl e cont aminati on present.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 105
Appendix F: Camera, Frame Grabber Communication
Setting Up Communication between the Camera and the Frame Grabber
Tel ed yne DA L SA Camer a L i nk camer as sup por t t he GenCP Camer a L i nk st and ar d s.
To conf i gur e Tel ed y ne DA L SA GenCP Camer a L i nk Camer as: 1. I nst al l t he Tel ed yne DA L SA f r ame gr abber i n the host computer ; r ef er to the har d w ar e install ation manual. 2. I nst al l Saper a L T and the Tel ed yne DA L SA f r ame gr abber d r i v er . 3. Connect the camer a to t he f r ame gr abber; refer to the camer a install ati on manual. 4. Pow er up t he camer a and w ai t unt i l the stat us L ED i s sol i d gr een. 5. Run t he Saper a Conf i gur ati on ut i l i t y and sel ect the f r ame gr abber ser i al p or t connected to the camer a. Set Tel edyne D ALSA camera detection to Automatic D etection and Baudrate to Auto D etect & M aximize. 6. I f the camer a w i l l be conf i gur ed usi ng thr ee-letter text commands via a terminal program, such as H yper Ter mi nal , t hen set COM port mapping (optional) to an av ail able COM port (e.g. COM 2).
Teledyne DALSA 03-032-20176-06 106 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
7. Start the CamExpert application. In the D evi ce t ab, sel ect CameraLink mode.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 107
8. M od i f y the camer a and f r ame gr abber p ar ameter sett i ngs as r equi r ed . A t pr esent, w hen u si ng GenCP camer as, t he camer a and f r ame gr abber p ar am eter s must be ad ju sted sep ar atel y. Test t he image acquisition by clicking the Grab button.
9. Sav e the f r ame gr abber conf i gur at i on to a new *.ccf f i l e.
Teledyne DALSA 03-032-20176-06 108 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
EMC Declaration of Conformity
W e, TELEDYN E DA LSA 605 M cM urray Road Waterloo, Ontario CANADA N 2V 2E9
Decl ar e und er sol e r esponsi bi l i ty that the camer as: Brand N ame: Pi r anha4
M od el s: P4-CM-02K05D-00-R, P4-CM-02K 10D-00-R, P4-CM-04K 05D-00-R, and P4-CM-04K 10D-00-R
W hi ch ar e components to be i ntegr ated i nt o l ar ger syst ems, w er e ev al uated accor d i ng t o the CE M ar k, FCC Part 15, VCCI, Israel, Korea, and I ndustr y Canad a ICES-003 Ev aluati on and sati sf y the r equi r ements of the follow ing stand ar d s:
EN 55022 (2010) EN 55011 (2009) EN 61326-1 (2006) EN 55024 (2010) CI SPR-22 ICES-003 CI SPR-11 FCC Part 15
Place of issue: W aterl oo, Ontar io, Canada
Date of I ssue: Febr u ar y 4, 2013
Hank Helmond Director of Quality, TELEDYN E DA LSA Corp.
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 109
Revision History
Rev Number Change Description Rev Date 00 Initial release. April 17, 2013 01 - Upd ated CamExper t scr eenshots. M ay 13, 2013 - Remov ed 7 µm pi xel opti on. - Revised AOI calculation table. -Dev i ce Scan Ty pe f eatur e ad d ed to Camer a Contr ol s d escr i pti on. -Rev i sed Full and Deca timing diagrams. 02 - 2k pow er di ssi pati on val ue added: < 8.25 W. Januar y 10, 2014 - Rev i sed r esponsi v i ty and QE gr aphs. - 2k l i ne r ates ad d ed to L i ne Rates tabl e. -Dev i ce User I D f eatur e d escr i bed . - T D I St ag es, Multi-Exposure Mode, and Exposur e Ti me sel ector f eatur es d escr i bed . -Disabling ESC key for direct access to ASCII commands option d escr i bed . 03 -Ref er ences to col or f eatur es r emov ed . Thi s camer a i s mono onl y . Ju n e 17, 2015 -Calibration description improved. - Optional Lens Mount and Heat Sink Accessories tabl e updated. -Heat sink installation illustration added. -Images illustrating multi-exposur e mod e r ev i sed . -Dead links removed from sensor window cleaning instructions. 04 Typo: maximum lines rates i n ar ea mod e for the P4-CM-04K05D and P4- Ju ne 30, 2016 CM-02K05D model s r evi sed from 200 kH z to 100 kH z. 05 Tol er ance f or the pow er suppl y speci f i cati on amend ed to ± 5%. October 4, 2017 06 - Rev i sed the d escr i pti on of the SVM test patter n command par ameter s to 15 A ugust 2018 the cor r ect 0, 1, 3 – 6. - Environmental specifications (storage, humidity, MTBF) added.
Teledyne DALSA 03-032-20176-06 110 Piranha4 2K and 4K Dual Line Monochrome CMOS Camera
Index
sensor shift, 45 web movement, 45 A direction control, 44 antiblooming, 9 ar ea mode, 29 E ASCII commands using, 85 EM C decl ar ati on, 109 error and warning messages, 99 B ESC k ey disabling, 87 baud r ate, 43 exposure binning, 69 control, 36 Bi ST , 99 external frame rate, bl ack l ev el programmable exposure time, control, 42 37 externally controlled, 37 C internally controlled, 37 exposur e mod es calibration, 46 descriptions of, 36 flat field, 48 exposur e ti me camer a contr ol si gnal s, 22 set, 42 camer a i nfor mati on, 31 EXSYNC, 23 camer a i nter faci ng tool , 26 Camer a Li nk bit definitions, 21 F configurations, 34 factory settings, 29 drive capability, 22 FPN and temper atur e, 11 input signals, 22 f r ame gr abber outputs, 23 camera communication, 106 Camer a Li nk connector , 19 CamExper t GUI, 27 G certifications, 9 cleaning gai n sensor window, 105 enhancing contrast, 49 clock signals, 23 Gai n commands control, 42 ASCII list, 87 grounding instructions, 18 GenICam, 50 GUI compl i ance, 9 CamExpert, 27 connectors, 18 overview, 25 Camera Link, 19 power, 23 contr ast H enhancing, 49 heatsink mounting, 14 D data bus, 23 I DC offset, 9 image acquisition, 36 direction quick, 101
03-032-20176-06 Teledyne DALSA Piranha4 2K and 4K Dual Line Monochrome CMOS Camera 111
input/ output, 18 r equi r ements PC, 16 r esponsi v i ty , 9 L graph, 10 revision history, 110 LED definitions, 24 l i ne r ates S setting, 39 saf ety , 6 Saper a, 26 M sensi ti v i ty mod es, 35 mechani cal sensor contr ol s, 56, 63, 67, 77 camera, 12 settings mod el s, 8 active, 33 default, 34 factory, 29, 33 O loading, 32 saving, 32 offset user, 33 enhancing contrast, 49 setup oper ati ng overview, 16 ranges, 9 quick, 101 shift direction, 45 si ze P image, 43 per f or mance speci f i cati ons, 8 softw ar e pi xel for mat, 44 required, 8 specifications pow er operating, 9 connector, 23 performance, 8 connectors, 23 guidelines, 24 pinout, 23 T precautions, 6 TDI Stages, 34 temper atur e Q verify, 31 QE % v s. w av el ength, 11 trigger modes, 36 quantum ef f i ci ency graph, 10 V vol tage R verify, 31 random noise, 9 rebooting, 46
Teledyne DALSA 03-032-20176-06