Download P4-CC-04K07T Manual
Transcript
Piranha4 Color P4-CC-04K07T-00-R Camera User’s Manual 03-032-20180-00 www.teledynedalsa.com 2 Piranha4 4K Camera Color User's Manual © 2013 Teled yne DALSA, Inc. All inform ation provid ed in this m anual is believed to be accurate and reliable. No responsibility is assum ed by Teled yne DALSA for its use. Teled yne DALSA reserves the right to make changes to this inform ation w ithout notice. Reprod uction of this manual in whole or in part, by any m eans, is prohibited w ithout prior perm ission having been obtained from Teled yne DALSA. About Teledyne Technologies and Teledyne DALSA, Inc. Teled yne Technologies is a lead ing provid er of sophisticated electr onic subsystem s, instrum entation and com m unication prod ucts, engineered system s, aerospace engines, and energy and pow er generation system s. Teled yne Technologies‘ operations are prim ari ly located in the United States, the United Kingdom and Mexico. For mo re inform ation, visit Teled yne Technologies‘ w ebsite at w w w.teled yne.com. Teled yne DALSA, a Teled yne Technologies com pany, is an international lead er in high performance d igital im aging and sem icond uctors w ith approxim ately 1,000 em ployees world w id e, headquartered in Waterloo, Ontario, Canad a. Established in 1980, the com pany d esigns, develops, manufactures and markets d igital im aging prod ucts and solutions, in add ition to provid ing MEMS prod ucts and services. For more inform ation, visit Teled yne DALSA‘s w ebsite at ww w .teled ynedalsa.com . Support For further inform ation not includ ed in this manual, or for inform ation on Teled yne DALSA‘s extensive line of im age sensing prod ucts, please contact: North America Europe Asia Pacific 700 Technology Park Drive Billerica, MA USA, 01821 Tel: 978-670-2000 Fax: 978-670-2010 Em ail: Sales.Am ericas@teled ynedalsa.com Felix-Wankel-Str. 1 82152 Krailling Germ any Tel: +49 89 89 54 57 3-80 Fax: +49 89 89 54 57 3-46 Em ail: Sales.Europe@teled yned alsa.com Ikebukuro East 13F 3-4-3 H igashi Ikebukuro, Toshima-ku, Tokyo, Japan Tel: +81 3 5960 6353 Fax: +81 3 5960 6354 Em ail: Sales.Asia@teled ynedalsa.com 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 3 Contents System Precautions ............................................................................................................................................................ 6 Precautions ..................................................................................................................................................... 6 Electrostatic Discharge and the CMOS Sensor ................................................................................................. 6 1. The Piranha4 Color Camera _______________________________________________________________________ 7 Camera Highlights ............................................................................................................................................................. 7 Camera Performance Specifications .................................................................................................................................. 8 Certifications ...................................................................................................................................................................... 9 Supported Industry Standards ........................................................................................................................................... 9 Sensor Responsivity and Design ........................................................................................................................................ 10 Responsivity .................................................................................................................................................... 10 Spatial Correction and Trilinear Sensor Design ............................................................................................. 12 Camera Direction ............................................................................................................................................ 15 Mechanicals........................................................................................................................................................................ 16 Camera Mounting and Heat Sink Considerations ........................................................................................... 17 Filters .............................................................................................................................................................. 18 2. Quick, Simple Steps to Acquire an Image ______________________________________________________________ 19 3. Software and Hardware Setup______________________________________________________________________ 20 Recommended System Requirements ............................................................................................................. 20 Setup Steps: Overview ....................................................................................................................................................... 20 1. Install and Configure Frame Grabber and Software .................................................................................. 20 2. Connect Camera Link and Power Cables .................................................................................................... 20 3. Establish communicating with the camera .................................................................................................. 20 4. Operate the Camera ................................................................................................................................... 20 Step 1. Install and configure the frame grabber and software ........................................................................................ 21 Install Frame Grabber .................................................................................................................................... 21 Install Sapera LT and CamExpert GUI ............................................................................................................ 21 Step 2. Connect Data, Trigger, and Power Cables ............................................................................................................. 22 Data Connector: Camera Link ........................................................................................................................ 23 Camera Link Bit Definitions............................................................................................................................ 23 Camera Timing .................................................................................................................................................................. 24 Camera Link cable quality and length ............................................................................................................ 30 Input Signals, Camera Link ............................................................................................................................ 30 Output Signals, Camera Link Clocking Signals............................................................................................... 31 Power Connector ............................................................................................................................................. 31 LEDs ................................................................................................................................................................ 32 Step 3. Establish Communication with the Camera ........................................................................................................... 32 Power on the camera ...................................................................................................................................... 32 Connect to the frame grabber ......................................................................................................................... 32 Connect to the camera .................................................................................................................................... 32 Check LED Status ............................................................................................................................................ 33 Software Interface ........................................................................................................................................... 33 Using Sapera CamExpert with Piranha4 Cameras ............................................................................................................ 34 Teledyne DALSA 03-032-20180-00 4 Piranha4 4K Camera Color User's Manual CamExpert Panes ............................................................................................................................................ 35 Review a Test Image ....................................................................................................................................... 37 4. Camera Operation______________________________________________________________________________ 38 Factory Settings ................................................................................................................................................................. 38 Check Camera and Sensor Information ............................................................................................................................. 38 Verify Temperature and Voltage ....................................................................................................................................... 39 Saving and Restoring Camera Settings ............................................................................................................................. 39 Camera Link Configuration ............................................................................................................................................... 42 Trigger Modes .................................................................................................................................................................... 42 Exposure Controls .............................................................................................................................................................. 42 Exposure Modes in Detail .................................................................................................................................................. 44 Set Line Rate ..................................................................................................................................................................... 46 Set Exposure Time ............................................................................................................................................................. 50 Control Gain and Black Level ............................................................................................................................................ 50 Set Image Size ................................................................................................................................................................... 50 Set Baud Rate .................................................................................................................................................................... 51 Pixel Format ...................................................................................................................................................................... 51 Camera Direction Control .................................................................................................................................................. 52 Pixel Readout Direction (Mirroring Mode) ........................................................................................................................ 52 Resetting the Camera ........................................................................................................................................................ 52 Calibrating the Camera ..................................................................................................................................................... 53 Appendix A: GenICam Commands _____________________________________________________________________ 57 Camera Information Category ........................................................................................................................................... 57 Camera Information Feature Descriptions...................................................................................................... 58 Camera Configuration Selection Dialog ......................................................................................................... 61 Camera Power-up Configuration .................................................................................................................... 61 User Set Configuration Management ............................................................................................................. 61 Camera Control Category .................................................................................................................................................. 62 Camera Control Feature Descriptions ............................................................................................................. 63 Digital I/O Control Feature Descriptions ........................................................................................................ 67 Independent Exposure Control .......................................................................................................................................... 65 Flat Field Category ............................................................................................................................................................ 68 Flat Field Control Feature Description ............................................................................................................ 68 Region of Interest (ROI) .................................................................................................................................. 70 Image Format Control Category ........................................................................................................................................ 70 Image Format Control Feature Description .................................................................................................... 71 Area of Interest (AOI) Setup .............................................................................................................................................. 72 Instructions on using the camera scan direction to control camera parameters ................................................................ 75 Transport Layer Control Category ..................................................................................................................................... 78 Transport Layer Feature Descriptions ............................................................................................................. 79 Acquisition and Transfer Control Category ........................................................................................................................ 80 Acquisition and Transfer Control Feature Descriptions................................................................................... 80 Serial Port Control Category .............................................................................................................................................. 81 Serial Port Control Feature Descriptions ........................................................................................................ 81 File Access Control Category .............................................................................................................................................. 82 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 5 File Access Control Feature Descriptions ......................................................................................................... 83 File Access via the CamExpert Tool ................................................................................................................. 84 Download a List of Camera Parameters ......................................................................................................... 85 Appendix B: ASCII Commands _______________________________________________________________________ 87 Port Configuration .......................................................................................................................................... 88 Commands ...................................................................................................................................................... 89 Appendix C: Quick Setup and Image Acquisition ___________________________________________________________ 101 Appendix D: The Sensor Window _____________________________________________________________________ 104 Cleaning and Protecting Against Dust, Oil, and Scratches .............................................................................. 104 Cleaning the Sensor Window .......................................................................................................................... 105 Appendix E. Color Deca and Full Mode Acquisition _________________________________________________________ 106 Overview ............................................................................................................................................................................ 106 Supported Sapera LT ...................................................................................................................................... 106 Programming Deca Mode.................................................................................................................................................. 106 A simple workaround accomplishes this ......................................................................................................... 107 Sample Code ................................................................................................................................................... 108 Programming Full Mode ................................................................................................................................................... 108 A simple workaround accomplishes this ......................................................................................................... 109 Sample Code ................................................................................................................................................... 110 Appendix F: Camera, Frame Grabber Communication _______________________________________________________ 111 Setting Up Communication between the Camera and the Frame Grabber .................................................... 111 EMC Declaration _________________________________________________________________________________ 113 Revision History _________________________________________________________________________________ 114 Index ________________________________________________________________________________________ 115 Teledyne DALSA 03-032-20180-00 6 Piranha4 4K Camera Color User's Manual System Precautions Precautions Read these p recau tions and this m anu al carefu lly before u sing the cam era. Confirm that the cam era‘s p ackaging is u nd am aged before op ening it. If the p ackaging is d am aged p lease contact the relevant logistics p ersonnel. Do not op en the hou sing of the cam era. The w arranty is void ed if the hou sing is op ened . Keep the cam era hou sing tem p eratu re in a range of 0 °C to 65 °C d u ring op eration. Do not op erate the cam era in the vicinity of strong electrom agnetic field s. In ad d ition, avoid electrostati c charging, violent vibration, and excess m oistu re. To clean the d evice, avoid electrostatic charging by u sing a d ry, clean absorbent cotton cloth d am p ened w ith a sm all qu antity of p u re alcohol. Do not u se m ethylated alcohol. To clean the su rface of the cam era hou sing, u se a soft, d ry cloth. To rem ove severe stains u se a soft cloth d am p ened w ith a sm all qu antity of neu tral d etergent and then w ip e d ry. Do not u se volatile solvents su ch as benzene and thinners, as they can d am age the su rface finish. Fu rther cleaning instru ctions are below . Thou gh this cam era su p p orts hot p lu gging, it is recom m end ed that you p ow er d ow n and d isconnect p ow er to the cam era before you ad d or rep lace system com p onents. Electrostatic Discharge and the CMOS Sensor Im age sensors and the cam era bod ies hou sing are su scep tible to d am age from electrostatic d ischarge (ESD). Electrostatic charge introd u ced to the sensor w ind ow su rface can ind u ce charge bu ild u p on the u nd ersid e of the w ind ow that cannot be read ily d issip ated by the d ry nitrogen gas in the sensor p ackage cavity. The charge norm ally d issip ates w ithin 24 hou rs and the sensor retu rns to norm al op eration. Ad d itional inform ation on cleaning the sensor w ind ow and p rotecting it against d u st, oi l, blem ishes, and scratches can be fou nd here, Ap p end ix D: The Sensor Wind ow . 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 7 1. The Piranha4 Color Camera Camera Highlights Based on Teled yne DALSA's u niqu e CMOS color line scan sensor architectu re, the new Piranha4 4k Trilinear color cam era p rovid es ou tstand ing signal-to-noise p erform ance for high sp eed im aging. The P44k has 4k resolu tion w ith a 10 µm x 10 µm p ixel size for op tim ized op tical d esign. The cam era d elivers a m axim u m line rate of 70 kH z. Precise sensor alignm ent sim p lifies m u ltip le cam era calibration at the system level. GenICam ™ or ASCII com m and -com p liant interfaces m ake the cam era easier to setu p , control, and integrate. Program m able featu res inclu d e exp osu re control, flat field correction, and gain settings. The Piranha4 4k cam era is id eal for p rinting insp ection, p rinted circu it board , solar cell, film , and large form at w eb insp ection. Key Features CMOS color trilinear line scan 4k p ixel resolu tion Line rates u p to 70 kH z Exp osu re control 100x antibloom ing RGB ou tp u ts Cam era Link interface GenICam or ASCII com m and -com p liant interfaces Programmability Save u p to eight sets of correction coefficients Ad ju stable gain and offset White balance and color correction Lens and shad ing correction w ith d efocu sing cap ability Test p attern and d iagnostics Mu lti-AOI ou tp u t allow s faster line rates Applications Printing insp ection H igh p erform ance d ocu m ent scanning Electronics Film insp ection H igh throu ghp u t ap p lications Teledyne DALSA 03-032-20180-00 8 Piranha4 4K Camera Color User's Manual Models The cam era is available in the follow ing configu rations: Table 1: Camera Models Overview Model Number P4-CC-04K07T-00-R Description 4k resolution, 70 kH z line rate, Cam era Link interface. Table 2: Software Software Cam era firm w are GenICam ™ su p p ort (XML cam era d escrip tion file) Sap era LT, inclu d ing Cam Exp ert GUI ap p lication and GenICam for Cam era Link im aging d river Product Number / Version Number Em bed d ed w ithin cam era Em bed d ed w ithin cam era Version 7.2 or later Camera Performance Specifications Table 3: Camera Performance Specifications Specifications Im ager Form at Resolution Pixel Size Full Well Capacity Line Rate Exposure Tim e Bit Depth Performance CMOS trilinear color line scan 4096 x 3 pixel lines* 10.56 µm x 10.56 µm 20 ke- @ m inim um gain of 1x 0 kH z m inim um to 70 kH z m axim um (Deca RGB8) 7 µs m inim um to 3,000 µs m axim um 8, 10, and 12 bits Connectors and Mechanicals Control & Data Interface Pow er Connector Pow er Supply Maxim um Current Draw Pow er Dissipation Size Mass Operating Tem p 2 SDR26 Cam era Link connectors used to transm it Base, Medium , Full, or Deca configurations H irose 6-pin circular + 12 V to + 24 V DC 12 W/ (Applied voltage at cam era connector) 12 W 62 m m (W) x 62 m m (H ) x 48 m m (D) < 340 g (w ithout heat sinks) 0 °C to 65 °C, front plate tem p erature Optical Interface Lens Mount Sensor to Cam era Front Distance Sensor Alignm ent (aligned to sid es of cam era) Flatness 50 µm 0.08° or 81 µm y (parallelism ) ± 100 µm x ± 100 µm y ± 250 µm z ± 0.2° z 03-032-20180-00 M58 x 0.75 F-m ount ad apter available 12 m m Teledyne DALSA Piranha4 4K Color Camera User's Manual 9 *N ote: The P4-CC-04K07T-00-R cam era has been d esigned to ou tp u t 4096 p ixels of RGB d ata. H ow ever, d u e to a lim itation of the sensor, the ou tp u t is lim ited to 4080 p ixels for the cam era ‘s initial release. Th is restriction w ill be resolved in a fu tu re release. Details of w hen the fu ll 4096 p ixel cam eras w ill be available can be obtained from you r Teled yne DALSA Key Accou nt Manager. Compliance Regulatory Com pliance CE and RoH S, GenICam Operating Ranges Performance Red Green Dynam ic Range 61.8 d B 61.8 d B Rand om N oise 3.25 DN ** rm s 3.25 DN rm s Responsivity Blue 61.8 d B 3.25 DN rm s Refer to graph Gain 1x to 10x N om inal Range (not includ ing ind ivid ual RGB gains for w hite balance) DC Offset < 11 DN < 11 DN < 11 DN PRN U < 2% @50% Sat < 2% @50% Sat < 2% @50% Sat FPN < 6.3 DN < 6.3 DN < 6.3 DN SEE 7.8 nJ / cm 2 9.6 nJ / cm 2 9.5 nJ / cm 2 N EE 6.3 pJ / cm 2 7.8 pJ / cm 2 7.7 pJ / cm 2 Antibloom ing > 100 x Saturation Integral non-linearity < 2% DN **DN = d igital nu m ber Test Conditions: Valu es m easu red u sing 12-bit, 1x gain. 10 kH z line rate Light sou rce: w hite LED N o w hite balancing Front p late tem p eratu re: 45º C Certifications Compliance EN 55011, FCC Part 15, CISPR 11, and ICES-003 Class A Rad iated Em issions Requirem ents* EN 55024, and EN 61326-1 Im m unity to Disturbance* RoH S per EU Directive 2002/ 95/ EC and WEEE per EU Directive 2002/ 96/ EC and China Electronic Ind ustry Stand ard SJ/ T11364-2006* GenICam XML Description File, Superset of the GenICam ™ Stand ard Features N am ing Convention specification V1.5, Cam era Link Serial Com m unication: GenICam ™ Generic Control Protocol (GenCP V1.0) * Pend ing test resu lts. Supported Industry Standards GenICam™ Piranha4 cam eras are GenICam com p liant. They im p lem ent a su p erset of the GenICam ™ Stand ard Featu res N am ing Convention sp ecification V1.5. This d escrip tion takes the form of an XML d evice d escrip tion file resp ecting the syntax d efined by the GenAp i m od u le of the GenICam ™ sp ecification. The cam era u ses the GenICam ™ Generic Control Protocol (GenCP V1.0) to com m u nicate over the Cam era Link serial p ort. For m ore inform ation see w w w .genicam .org. Teledyne DALSA 03-032-20180-00 10 Piranha4 4K Camera Color User's Manual Sensor Responsivity and Design Responsivity The resp onsivity grap h illu strates the sensor‘s resp onse to d ifferent w avelengths of light (exclu d ing lens and light sou rce characteristics). Note: The resp onsivity of a color cam era w ill m easu re ap p roxim ately 1/ 6 that of a sim ilar m onochrom e cam era m od el as a resu lt of the effect the color filter has on the sensor and also d u e to the color cam era not incorp orating TDI Mod e. th Spectral Responsivity (DN/nJ/cm^2) 600 P4 4k Trilinear Color Spectral Responsivity No White Balance, 12 bit, gain 1x 500 400 300 200 100 0 400 450 500 550 600 650 700 750 800 850 900 Wavelength (nm) Figure 1: Spectral Responsivity Filters CMOS cam eras are resp onsive to infrared (IR) w avelengths of light. Infrared light can be p roblem atic w ith halogen light sou rces bu t is not a issu e w ith w hite LED sou rces. When infrared light is p resent w ith this cam era color fid elity is red u ced . To p revent infrared from d istorting the im ages you scan, u se an IR cu t off filter su ch as a BG-38 on the lens. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 11 0.18 P4 White LED Calibration Source Relative Intensity vs Wavelength 0.16 0.14 Relative Intensity 0.12 0.1 [ADD GRAPH ] 0.08 0.06 0.04 0.02 0 400 450 500 550 600 650 700 750 Wavelength (nm) Figure 2: Calibration Source Relative Intensity vs. Wavelength Teledyne DALSA 03-032-20180-00 12 Piranha4 4K Camera Color User's Manual Spatial Correction and Trilinear Sensor Design The P4-CC-04K07T-00-R cam era u ses a trilinear sensor w here three sep arate 4K lines of p ixels are u sed — one for red , the center for blu e and the last for green. 10.56um Red 21.12um 10.56um Blue 21.12um 10.56um Green Figure 3: Trilinear Sensor Line Spacing Diagram The three lines of p ixels are sep arated by single line sp acing each and this line sp acing is equ al to 2x the sensor p ixel size. When the im age p asses the three lines of p ixels, the red , blu e and green com p onents for the sam e im age location are cap tu red at a d ifferent tim e as d ictated by the line sp acing. The cam era au tom atically corrects for the line sp acing to ensu re that the red , blu e and green com p onents of the im age p ixel are all aligned w hen ou tp u t. H ow ever, this is only correct w hen the object p ixel size is squ are; i.e., the d istance m oved by the object for one EXSYN C p eriod is equ al to the w id th of the object p ixel. In som e ap p lications it m ay not be p ossible to achieve a ‗squ are‘ object p ixel as fine ad ju stm ent of the lens m agnification and / or the d istance m oved for each EXSYN C p eriod is not p ossible. This scenario m ay be esp ecially ap p arent w hen trying to integrate the cam era into an existing system . When it is not p ossible to generate a squ are object p ixel, color artefacts w ill occu r in the scan d irection and is p articu larly noticeable at sharp ed ge transitions. The size of the ed ge artefact is p rop ortional to how far the p ixel is from squ are. To correct for this, the cam era has a featu re, Line Sp atial Correction (or three letter com m and ssa), w hich allow s fine ad ju stm ent of the com p ensation m echanism the cam era u ses to correct for the line sp acing. The d efau lt setting for this featu re is 3, w hich is set for squ are object p ixels. The setting can be ad ju sted from 0 to 5 to com p ensate for rectangu lar p ixels—w hether they are too long or to short. The follow ing exam p les of im age artefacts show black to w hite im age transitions and the associated corrected im age after ap p lying a sp ecific ssa setting. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 13 Example 1. Target speed adjusted for square pixels Line Sp atial Correction = 3 (ssa = 3). This is the d efau lt cond ition. Example 2. Target running slower than example 1. same EXSYNC (trigger) frequency Line Sp atial Correction = 3 (ssa = 3) Line Sp atial Correction = 4.3 (ssa = 4.3) Example 3. Target running faster than example 1. same EXSYNC (trigger) frequency Line Sp atial Correction = 3 (ssa = 3) Teledyne DALSA Line Sp atial Correction = 1.73 (ssa = 1.73) 03-032-20180-00 14 Piranha4 4K Camera Color User's Manual Example 4. Target running slower than EXSYNC Line Sp atial Correction = 3 (ssa = 3) Line Sp atial Correction = 1 (ssa = 1) Example 5. Target running faster than EXSYNC Line Sp atial Correction = 3 (ssa = 3) 03-032-20180-00 Line Sp atial Correction = 5 (ssa = 5) Teledyne DALSA Piranha4 4K Color Camera User's Manual 15 Camera Direction Selectable cam era d irection accom m od ates an object d irection change on a w eb and allow s you to m ou nt the cam era ―u p sid e d ow n‖. Note: The exam p le here assu m es the u se of a lens (w hich inverts the im ag e). Figure 4: Object Movement and Camera Direction Example, with a Lens Teledyne DALSA 03-032-20180-00 16 Piranha4 4K Camera Color User's Manual 4 3 2 REV Mechanicals 01 0.1 A 0.05 M4x0.7 - 6H 6 (4X) 62 0.05 DESCR ADDED VIEW OF CAMERA ASSEMBLY WITH (SHEET 2); DRAWING 03-129-20033-04 USED (54) 12 0.25 OPTICAL DISTANCE (42) (54) 62 0.05 (9) B 31 0.10 (19.1) ±0.2° IMAGE AREA CENTER OF IMAGE AREA 31 0.10 B (7) A C (9) [ADD MECH AN ICAL FROM PDF 03-129-20071-01] M4x0.7 - 6H 6 (2X) THIS SIDE (2X) FAR SIDE (11.4) (20.34) M58x0.75 - 6H FIRST PIXEL REFERENCE HOLE M4x0.7 - 6H 6 (2X) THIS SIDE (2X) FAR SIDE (47.87) (7) (42) 4 3 2 NOTES: 1. UNITS: MILLIMETERS. 2. IMAGE AREA IS ALIGNED TO DATUMS A B & C . Figure 6: Camera Mechanical (shown with optional heat sink below) A UNLESS OTHERWISE SPECIFIED 1. UNITS: MM 2. DRAWING PER ASME Y14.5M-1994 3. TOLERANCES: LINEAR ±0.15 ANGLES ±0.5 SURFACE FINISH 3.2 AUTHOR DATE I. PLEIC JUL 23/2012 APPROVED BY [ADD H EATSIN K MECH AN ICAL FROM PDF 03-129-20071-01] B APPLICATION/PROJECT HARMONY (90) PROPRIETARY 4 THIS DOCUMENT AND THE INFORMATION IT CONTAINS ARE PROPRIETARY TO TELEDYNE DALSA INC.. THIS DOCUMENT MUST NOT BE DUPLICATED, OR ITS CONTENT USED OR DISCLOSED (IN WHOLE OR IN PART) WITHOUT PERMISSION FROM TELEDYNE DALSA INC. 3 2 OPTIONAL EXTERNAL HEAT SINK (2X) NOTES: 1. UNITS: MILLIMETERS. 2. IMAGE AREA IS ALIGNED TO DATUMS A B & C . A 03-032-20180-00 Teledyne DALSA UNLESS OTHERWISE SPECIFIED 1. UNITS: MM 2. DRAWING PER ASME Y14.5M-1994 3. TOLERANCES: AUTHOR I. PLEIC APPROVED BY DATE JUL 23/2012 THIRD ANGLE Piranha4 4K Color Camera User's Manual 17 Figure 6: Nikon M58 to F-Mount Adapter Figure 7: Piranha4 Heat Sink Accessories Kit Optional Lens Mount and Heat Sink Accessories Part No. Description AC-LN -00002-A0-R M58 to F-m ount ad apter (12m m BFD), heavy d uty AC-MS-00108-00-R H eat sink for P4-4k/ 2k cam eras Teledyne DALSA 03-032-20180-00 18 Piranha4 4K Camera Color User's Manual Camera Mounting and Heat Sink Considerations Up to tow op tional heat sinks can be installed on the Piranha4 cam era. As illu strated , they are id eally p ositioned to allow close sp acing of the cam era s. These heat sinks are d esigned to p rovid e ad equ ate convection cooling w hen not obstru cted by enclosu res or m ou nting assem blies. Teled yne DALSA recognises that each cu stom er‘s ap p lication can be u niqu e. In consid eration, the P4 cam era heat sinks have been d esigned in su ch a w ay that they can be rep ositioned on the d ifferent faces of the cam era or rem oved entirely, d ep end ing on the m ou nting configu ration and its heat sinking p otential. Rep ositioning or rem oval of the heat sinks m u st be p erform ed w ith care in ord er to avoid tem p eratu re issu es. The cam era has the ability to m easu re its internal tem p eratu re. Use this featu re to record the internal tem p eratu re of the cam era w hen it is m ou nted in you r system and op erating u nd er the w orst case cond itions. The cam era w ill stop ou tp u tting d ata if its internal tem p eratu re reaches 80 °C. Filters CMOS cam eras are resp onsive to infrared (IR) w avelengths of light. Infrared light can be p roblem atic w ith halogen light sou rces bu t is not a n issu e w ith w hite LED sou rces. When infrared light is p resent w ith this cam era color fid elity is red u ced . To p revent infrared from d istorting the im ages you scan, u se an IR cu t off filter su ch as a BG-38 on the lens. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 19 2. Quick, Simple Steps to Acquire an Image For u sers w ho are fam iliar w ith Cam era Link cam eras, have a basic u nd erstand ing of their im aging requ irem ents, and w ho are p rim arily interested in evalu ating the Piranha4 cam era, an overview of the step s requ ired to get this cam era op erational and acqu iring im ages qu ickly can be fou nd in Ap p end ix C: Qu ick Setu p and Im age Acqu isition . Teledyne DALSA 03-032-20180-00 20 Piranha4 4K Camera Color User's Manual 3. Software and Hardware Setup Recommended System Requirements To achieve best system p erform ance, the follow ing m inim u m requ irem ents are recom m end ed : H igh band w id th fram e grabber, e.g. Xcelera-CL PX8 Fu ll Cam era Link fram e grabber (Part # ORX8CO-XPF00): w w w .teled yned alsa.com / im aging/ p rod u cts/ fg/ OR-X8C0-XPF00/ . Op erating system s: Wind ow s XP / Vista / 7, 32 / 64-bit. Setup Steps: Overview Take the follow ing step s in ord er to setu p and ru n you r cam era system . They are d escribed briefly below and in m ore d etail in the sections that follow . 1. Install and Configure Frame Grabber and Software We recom m end the Xcelera-CL PX8 Fu ll fram e grabber or equ ivalent, d escribed in d etail on the teled yned alsa.com site here. If you r host com p u ter d oes not have a PX8 fu ll Cam era Link fram e grabber then you w ill need to install one. Follow the m anu factu rer‘s installation instru ctions. A GenCP (Generic Control Protocol) com p liant XML d evice d escrip tion file is em bed d ed w ithin the cam era firm w are allow ing GenCP-com p liant ap p lication s to know the cam era‘s cap abilities im m ed iately after connection. Installing Sap eraLT gives you access to the Cam Exp ert GUI, a tool that su p p orts GenCPcom p liant d evices. 2. Connect Camera Link and Power Cables Connect the Cam era Link cables from the cam era to the com p u t er. Connect a p ow er cable from the cam era to a +12 VDC to +24 VDC p ow er su p p ly. 3. Establish communicating with the camera Start the GUI and establish com m u nication w ith the cam era. ASCII Commands As an alternative to the Cam Exp ert (or equ ivalent) GUI, you can com m u nicate w ith this cam era u sing ASCII-based com m and s. A com p lete list of the com m and s can be fou nd here, Ap p end ix B: ASCII Com m and s. 4. Operate the Camera At this p oint you w ill be read y to start op erating the cam era in ord er to acqu ire im ages, set cam era fu nctions, and save settings. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 21 Step 1. Install and configure the frame grabber and software Install Frame Grabber Install a Full configu ration Cam era Link fram e grabber accord ing to the m anu factu rer‘s d escrip tion. We recom m end the Xcelera-CL PX8 fram e grabber or equ ivalent, d escribed in d etail on the teled yned alsa.com site here. Install Sapera LT and CamExpert GUI Com m u nicate w ith the cam era u sing a Cam era Link -com p liant interface. We recom m end you u se Cam Exp ert. Cam Exp ert is the cam era interfacing tool su p p orted by the Sap era library and com es bu nd led w ith Sap eraLT. Using Cam Exp ert is the sim p lest and qu ickest w ay to send com m and s to and receive inform ation from the cam era. Camera Link Environment These cam eras im p lem ent the Cam era link sp ecification, w hich d efines the d evice cap abilities. The Cam era link XML d evice d escrip tion file is em bed d ed w ithin the cam era firm w are allow ing Cam era link-com p liant ap p lications to recognize the cam eras‘ cap abilities im m e d iately after connection. Teledyne DALSA 03-032-20180-00 22 Piranha4 4K Camera Color User's Manual Step 2. Connect Data, Trigger, and Power Cables Note: the u se of cables typ es and lengths other than those sp ecified m ay resu lt in increased em ission or d ecreased im m u nity and p erform ance of the cam era. Power A +12V to +24V DC Hirose 6-pin B B A Control & Data B Camera Link 26-pin SDR26 connectors B Status C Diagnostic LED C Figure 8: Input and Output, trigger, and Power Connectors ! 03-032-20180-00 WARN IN G! Grounding Instructions Static electricity can d am age electronic com p onents. It‘s critical that you d ischarge any static electrical charge by tou ching a grou nd ed su rface, su ch as the m etal com p u ter chassis, b efore hand ling the cam era hard w are. Teledyne DALSA Piranha4 4K Color Camera User's Manual 23 Data Connector: Camera Link The cam era u ses tw o Cam era Link SDR26 cables transm itting the Cam era Link Base, Med iu m , Full, or Deca configu ration. The figu re below show s the SDR26 Cam era Link Connector and the tables that follow list the Cam era Link configu ration s. For d etailed inform ation on Cam era Link p lease refer to the Cam era Link Road Map available from the Know led ge Center on the Teled yne DALSA Web site. Figure 9. SDR26 Camera Link Connector Data 2 Camera Connector 1 14 2 15 3 16 4 17 5 18 6 19 7 20 8 21 9 22 10 23 11 24 12 25 13 26 Right Angle Frame Grabber Connector 1 14 25 12 24 11 23 10 22 9 21 8 20 7 19 6 18 5 17 4 16 3 15 2 13 26 Channel Link Signal inner shield inner shield Y0Y0+ Y1Y1+ Y2Y2+ YclkYclk+ Y3Y3+ 100 ohm term inated Z0Z0+ Z1Z1+ Z2Z2+ ZclkZclk+ Z3Z3+ inner shield inner shield Control / Data 1 Camera Right Angle Connector Frame Grabber Connector Channel Link Signal 1 14 2 15 3 16 4 17 5 18 6 19 7 20 8 21 9 22 10 23 11 24 12 25 13 26 inner shield inner shield X0X0+ X1X1+ X2X2+ XclkXclk+ X3X3+ SerTC+ SerTCSerTFGSerTFG+ CC1CC1+ CC2+ CC2CC3CC3+ CC4+ CC4inner shield inner shield 1 14 25 12 24 11 23 10 22 9 21 8 20 7 19 6 18 5 17 4 16 3 15 2 13 26 Note: *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 Camera Link Bit Definitions Signal CC1 CC2 Teledyne DALSA Configuration EXSYN C Spare 03-032-20180-00 24 Piranha4 4K Camera Color User's Manual CC3 CC4 Direction Spare Table 4: Camera Control Configuration For ad d itional Cam era Link d ocu m entation refer to the Teled yne DALSA Web site‘s Know led ge Center ap p lication notes. Camera Timing N ote: Inform ation on setting u p the cam era‘s AOI can be fou nd here, Area of Interest (AOI) Setu p . RGB 8 bit CL Base, max line rate 20 kHz without AOI and 85 MHz CL Clock Line Valid CL Clock CL Port A Red 1 D0..D7 Red 2 D0..D7 Red 3 D0..D7 Red 4 D0..D7 Red 4095 D0..D7 Red 4096 D0..D7 CL Port B Green 1 D0..D7 Green 2 D0..D7 Green 3 D0..D7 Green 4 D0..D7 Green 4095 D0..D7 Green 4096 D0..D7 CL Port C Blue 1 D0..D7 Blue 2 D0..D7 Blue 3 D0..D7 Blue 4 D0..D7 Blue 4095 D0..D7 Blue 4096 D0..D7 This tim ing can be u sed for ap p lications that requ ire line rates only u p to 20 kH z and therefore can u se Cam era Link Base m od e w ith only one cable. The RGB ou tp u t form at is com p atible w ith the Cam era Link sp ecification for Base RGB. Line rates u p to 70 kH z can be achieved by u sing the Area of Interest (AOI) featu re; w here the sm aller the AOI, the greater the p otential line rate. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 25 RGB 8 bit CL Medium, max line rate 40 kHz without AOI and 85 MHz CL clock Line Valid CL Clock CL Port A Red 1 D0..D7 Red 3 D0..D7 Red 5 D0..D7 Red 7 D0..D7 Red 4093 D0..D7 Red 4095 D0..D7 CL Port B Green 1 D0..D7 Green 3 D0..D7 Green 5 D0..D7 Green 7 D0..D7 Green 4093 D0..D7 Green 4095 D0..D7 CL Port C Blue 1 D0..D7 Blue 3 D0..D7 Blue 5 D0..D7 Blue 7 D0..D7 Blue 4093 D0..D7 Blue 4095 D0..D7 CL Port D Red 2 D0..D7 Red 4 D0..D7 Red 6 D0..D7 Red 8 D0..D7 Red 4094 D0..D7 Red 4096 D0..D7 CL Port E Green 2 D0..D7 Green 4 D0..D7 Green 6 D0..D7 Green 8 D0..D7 Green 4094 D0..D7 Green 4096 D0..D7 CL Port F Blue 2 D0..D7 Blue 4 D0..D7 Blue 6 D0..D7 Blue 8 D0..D7 Blue 4094 D0..D7 Blue 4096 D0..D7 This tim ing can be u sed for ap p lications that requ ire line rates u p to 40 kH z and therefore m u st u se Cam era Link Med iu m m od e and tw o cables. The RGB ou tp u t form at is com p atible w ith the Cam era Link sp ecification for Med iu m RGB. Line rates u p to 70 kH z can be achieved by u sing the Area of Interest (AOI) featu re; w here the sm aller the AOI, the greater the p otential line rate. Teledyne DALSA 03-032-20180-00 26 Piranha4 4K Camera Color User's Manual RGB 8 bit CL Full, max line rate 55 kHz without AOI and 85 MHz CL clock Note: The inserted d u m m y p ixels at the end Line Valid CL Clock CL Port A Red 1 D0..D7 Blue 3 D0..D7 Green 6 D0..D7 Red 9 D0..D7 Green 4092 D0..D7 Red 4095 D0..D7 CL Port B Green 1 D0..D7 Red 4 D0..D7 Blue 6 D0..D7 Green 9 D0..D7 Blue 4092 D0..D7 Green 4095 D0..D7 CL Port C Blue 1 D0..D7 Green 4 D0..D7 Red 7 D0..D7 Blue 9 D0..D7 Red 4093 D0..D7 Blue 4095 D0..D7 CL Port D Red 2 D0..D7 Blue 4 D0..D7 Green 7 D0..D7 Red 10 D0..D7 Green 4093 D0..D7 Red 4096 D0..D7 CL Port E Green 2 D0..D7 Red 5 D0..D7 Blue 7 D0..D7 Green 10 D0..D7 Blue 4093 D0..D7 Green 4096 D0..D7 CL Port F Blue 2 D0..D7 Green 5 D0..D7 Red 8 D0..D7 Blue 10 D0..D7 Red 4094 D0..D7 Blue 4096 D0..D7 CL Port G Red 3 D0..D7 Blue 5 D0..D7 Green 8 D0..D7 Red 11 D0..D7 Green 4094 D0..D7 CL Port H Green 3 D0..D7 Red 6 D0..D7 Blue 8 D0..D7 Green 11 D0..D7 Blue 4094 D0..D7 This tim ing can be u sed for ap p lications that requ ire line rates u p to 55 kH z and therefore m u st u se Cam era Link Deca m od e and tw o cables. The RGB ou tp u t form at is not d efined in the Cam era Link sp ecification Full. The RGB form at is su ch that w hen u sing a Cam era Link fram e grabber com p atible w ith the Fu ll form at configu red for the m ono stand ard , the R, G and then B p ixels w ill be w ritten sequ entially into the fram e grabber bu ffer. This p rocess sim p lifies the extraction of the RGB d ata from the fram e grabber bu ffer by the host ap p lication. Line rates u p to 70 kH z can be achieved by u sing the Area of Interest (AOI) featu re; w here the sm aller the AOI, the greater the p otential line rate. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 27 RGB 8 bit CL Deca, max line rate 69 kHz without AOI and 85 MHz CL clock Note: The inserted d u m m y p ixels at the end Line Valid CL Clock CL Port A Red 1 D0..D7 Green 4 D0..D7 Blue 7 D0..D7 Red 11 D0..D7 Blue 4091 D0..D7 Red 4095 D0..D7 CL Port B Green 1 D0..D7 Blue 4 D0..D7 Red 8 D0..D7 Green 11 D0..D7 Red 4092 D0..D7 Green 4095 D0..D7 CL Port C Blue 1 D0..D7 Red 5 D0..D7 Green 8 D0..D7 Blue 11 D0..D7 Green 4092 D0..D7 Blue 4095 D0..D7 CL Port D Red 2 D0..D7 Green 5 D0..D7 Blue 8 D0..D7 Red 12 D0..D7 Blue 4092 D0..D7 Red 4096 D0..D7 CL Port E Green 2 D0..D7 Blue 5 D0..D7 Red 9 D0..D7 Green 12 D0..D7 Red 4093 D0..D7 Green 4096 D0..D7 CL Port F Blue 2 D0..D7 Red 6 D0..D7 Green 9 D0..D7 Blue 12 D0..D7 Green 4093 D0..D7 Blue 4096 D0..D7 CL Port G Red 3 D0..D7 Green 6 D0..D7 Blue 9 D0..D7 Red 13 D0..D7 Blue 4093 D0..D7 CL Port H Green 3 D0..D7 Blue 6 D0..D7 Red 10 D0..D7 Green 13 D0..D7 Red 4094 D0..D7 CL Port I Blue 3 D0..D7 Red 7 D0..D7 Green 10 D0..D7 Blue 13 D0..D7 Green 4094 D0..D7 CL Port K Red 4 D0..D7 Green 7 D0..D7 Blue 10 D0..D7 Red 14 D0..D7 Blue 4094 D0..D7 This tim ing can be u sed for ap p lications that requ ire line rates u p to 69 kH z and therefore m u st u se Cam era Link Deca m od e and tw o cables. The RGB ou tp u t form at is not d efined in the Cam era Link sp ecification Deca. The RGB form at is su ch that w hen u sing a Cam era Link fram e grabber com p atible w ith the Deca form at configu red for the m ono stand ard , the R, G and then B p ixels w ill be w ritten sequ entially into the fram e grabber bu ffer. This p rocess sim p lifies the extraction of the RGB d ata from the fram e grabber bu ffer by the host ap p lication. Line rates u p to 70 kH z can be achieved by u sing the Area of Interest (AOI) featu re; w here the sm aller the AOI, the greater the p otential line rate. Teledyne DALSA 03-032-20180-00 28 Piranha4 4K Camera Color User's Manual RGB 10 bit CL Medium, max line rate 20 kHz without AOI and 85 MHz CL clock Line Valid CL Clock CL Port A Red 1 D0..D7 Red 2 D0..D7 Red 3 D0..D7 Red 4 D0..D7 Red 4095 D0..D7 Red 4096 D0..D7 CL Port B Red 1 D8..D9 Blue 1 D8..D9 Red 2 D8..D9 Blue 2 D8..D9 Red 3 D8..D9 Blue 3 D8..D9 Red 4 D8..D9 Blue 4 D8..D9 Red 4095 D8..D9 Blue 4095 D8..D9 Red 4096 D8..D9 Blue 4096 D8..D9 CL Port C Blue 1 D0..D7 Blue 2 D0..D7 Blue 3 D0..D7 Blue 4 D0..D7 Blue 4095 D0..D7 Blue 4096 D0..D7 CL Port E Green 1 D0..D7 Green 2 D0..D7 Green 3 D0..D7 Green 4 D0..D7 Green 4095 D0..D7 Green 4096 D0..D7 CL Port F Green 1 D8..D9 Green 2 D8..D9 Green 3 D8..D9 Green 4 D8..D9 Green 4095 D8..D9 Green 4096 D8..D9 CL Port D Port B Bit Assignments D0 D1 D2 D3 D4 D5 D6 D7 Port F Bit Assignments Red 8 Red 9 N/ A N/ A Blue 8 Blue 9 N/ A N/ A D0 D1 D2 D3 D4 D5 D6 D7 Green 8 Green 9 N/ A N/ A N/ A N/ A N/ A N/ A This tim ing can be u sed for ap p lications that requ ire line rates u p to 20 kH z and therefore m u st u se Cam era Link Med iu m m od e and tw o cables. The RGB ou tp u t form at is com p atible w ith the Cam era Link sp ecification for Med iu m RGB. Line rates u p to 70 kH z can be achieved by u sing the Area of Interest (AOI) featu re; w here the sm aller the AOI, the greater the p otential line rate. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 29 RGB 12 bit CL Medium, max line rate 20 kHz without AOI and 85 MHz CL clock Line Valid CL Clock CL Port A Red 1 D0..D7 Red 2 D0..D7 Red 3 D0..D7 Red 4 D0..D7 Red 4095 D0..D7 Red 4096 D0..D7 CL Port B Red 1 D8..D11 Blue 1 D8..D11 Red 2 D8..D11 Blue 2 D8..D11 Red 3 D8..D11 Blue 3 D8..D11 Red 4 D8..D11 Blue 4 D8..D11 Red 4095 D8..D11 Blue 4095 D8..D11 Red 4096 D8..D11 Blue 4096 D8..D11 CL Port C Blue 1 D0..D7 Blue 2 D0..D7 Blue 3 D0..D7 Blue 4 D0..D7 Blue 4095 D0..D7 Blue 4096 D0..D7 CL Port E Green 1 D0..D7 Green 2 D0..D7 Green 3 D0..D7 Green 4 D0..D7 Green 4095 D0..D7 Green 4096 D0..D7 CL Port F Green 1 D8..D11 Green 2 D8..D11 Green 3 D8..D11 Green 4 D8..D11 Green 4095 D8..D11 Green 4096 D8..D11 CL Port D Port B Bit Assignments D0 D1 D2 D3 D4 D5 D6 D7 Red 8 Red 9 Red 10 Red 11 Blu e 8 Blu e 9 Blu e 10 Blu e 11 D0 D1 D2 D3 D4 D5 D6 D7 Port F Bit Assignments Green 8 Green 9 Green 10 Green 11 N/ A N/ A N/ A N/ A This tim ing can be u sed for ap p lications that requ ire line rates u p to 20 kH z and therefore m u st u se Cam era Link Med iu m m od e and tw o cables. The RGB ou tp u t form at is com p atible w ith the Cam era Link sp ecification for Med iu m RGB. Line rates u p to 70 kH z can be achieved by u sing the Area of Interest (AOI) featu re; w here the sm aller the AOI, the greater the p otential line rate. Teledyne DALSA 03-032-20180-00 30 Piranha4 4K Camera Color User's Manual Custom AOI Rules 1) 2) 3) 4) 5) 6) The sensor has p ixels nu m bered 0 to 4096*. Three valu es (red , blu e, green) are ou tp u t p er p ixel in RGB m od e. Whether m irroring is on or off, 0 is the leftm ost p ixel. Whether m irroring is on or off, AOI 1 is read ou t first. In norm al m od e, AOI 1 is closest to the sensor‘s left ed ge. In m irror m od e, AOI 1 is closest to the sensor‘s right ed ge. *4080 active p ixels, the last 16 p ixels are inactive. Base and Medium Modes 1) The total nu m ber of p ixels w ithin each AOI m u st be a m u ltip le of 8 and m u st be greater than or equ al to 40. 2) In norm al m od e, the first p ixel of each AOI (AOI left ed ge) m u st have the location 8i, w here i = 0, 1, 2 .., 511 (i.e. 8, 960 are allow ed , 12 is not allow ed ). 3) In m irror m od e, the first p ixel of each AOI (AOI right ed ge) m u st have the location 8i + 7, w here i = 0,1,2 .., 511 (i.e. 7, 15, 4095 are allow ed , 8 is not allow ed ). Deca RGB Mode 1) The total nu m ber of p ixels w ithin each AOI m u st be a m u ltip le of 40. 2) In norm al m od e, the first p ixel of each AOI (AOI left ed ge) m u st have the location 8i, w here i = 0, 1, 2 .., 511 (i.e. 8, 960 are allow ed , 12 is not allow ed ). 3) In m irror m od e, the first p ixel of each AOI (AOI right ed ge) m u st have the location 8i + 7, w here i = 0,1,2 .., 511 (i.e. 7, 15, 4095 are allow ed , 8 is not allow ed ). Camera Link cable quality and length The m axim u m allow able Cam era Link cable length d ep end s on the qu ality of the cable u sed and the Cam era Link strobe frequ ency. Cable qu ality d egrad es over tim e as the cable is flexed . In ad d ition, as the Cam era Link strobe frequ ency is increased the m axim u m allow able cable length w ill d ecrease. We d o not gu arantee good im aging p erform ance w ith low qu ality cables of any length. In general, w e recom m end the u se of high qu ality cables for any cable length. The follow ing table lists som e resu lts achieved u sing the P4 cam era and a selection of cables and fram e grabbers. Distance Tested Cable Manufacture Frame grabber 10 m 15 m 30 m Com p onent Exp ress Com p onent Exp ress H ew tech PX4 and PX8 PX8 PX8 Input Signals, Camera Link The cam era accep ts control inp u ts throu gh the Cam era Link SDR26F connector. The cam era ship s in internal sync, and internally p rogram m ed integration . EXSYNC (Exposure Start) 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 31 Line rate can be set internally u sing the GenICam featu res. The external control signal EXSYN C is op tional and enabled throu gh the u ser interface. This cam era u ses the falling ed ge of EXSYN C to start the exp osu re p eriod . The EXSYN C signal tells the cam era w hen to integrate the im age, follow ed by the read ou t. It can be either an internally generated signal by the cam era, or it can be su p p lied externally via the serial interface. Dep end ing u p on the m od e of op eration the high tim e of the EXSYN C signal can rep resent the integra tion p eriod . Note: The EXSYN C signal is m easu red at CC1 and w ill give a ―tru e‖ m easu rem ent (i.e. w ithin the m easu rem ent resolu tion of 25 ns) even thou gh the cam era w ill only trigger at a m axim u m of 70 KH z. Output Signals, Camera Link Clocking Signals These signals ind icate w hen d ata is valid , allow ing you to clock the d ata from the cam era to you r acqu isition system . These signals are p art of the Cam era Link configu ration and you shou ld refer to the Cam era Link Im p lem entation Road Map , available at ou r Know led ge Center, for the stand ard location of these signals. Clocking Signal Indicates LVAL (high) DVAL STROBE (rising ed ge) FVAL Ou tp u tting valid line N ot u sed Valid d ata Set to 0 Power Connector ! WARN IN G: It is extrem ely im p ortant that you ap p ly the ap p rop riate voltages to you r cam era. Incorrect voltages m ay d am age the cam era. Inp u t voltage requ irem ent: +12 VDC to +24 VDC, 2 Am p s. Before connecting p ow er to the cam era, test all p ow er su p p lies. Figure 10: 6-pin Hirose Circular Male Power Plug—Power Connector Pin 1 2 3 Table 5. Power Plug Pinout Description Pin Description +12 V to +24 V DC +12 V to +24 V DC +12 V to +24 V DC 4 5 6 GN D GN D GN D The cam era requ ires a single voltage inp u t +12 VDC to +24 VDC. The cam era m eets all p erform ance sp ecifications u sing stand ard sw itching p ow er su p p lies, althou gh w ell-regu lated linear su p p lies p rovid e op tim u m p erform ance. Teledyne DALSA 03-032-20180-00 32 Piranha4 4K Camera Color User's Manual WARNING: When setting up the camera’s power supplies follow these guidelines: ! Ap p ly the ap p rop riate voltages. Protect the cam era w ith a 2 am p slow -blow fu se betw een the p ow er su p p ly and the cam era. Do not u se the shield on a m u lti-cond u ctor cable for grou nd . Keep lead s as short as p ossible in ord er to red u ce voltage d rop . Use high-qu ality su p p lies in ord er to m inim ize noise. Note: If you r p ow er su p p ly d oes not m eet these requ irem ents, then the cam era p erform ance sp ecifications are not gu aranteed . LEDs The cam era is equ ip p ed w ith an LED on the back to d isp lay the op erational statu s of the cam era. The table below su m m arizes the op erating states of the cam era and the corresp ond ing LED states. When m ore than one cond ition is active, the LED ind icates the cond ition w ith the highest p riority. Color of Status LED Meaning Off Blinking Green Green Red N o pow er or hardw are m alfunction Pow ering up or calibrating Read y Error. Check BiST register for the specific error Step 3. Establish Communication with the Camera Power on the camera Tu rn on the cam era‘s p ow er su p p ly. You m ay have to w ait w hile the cam era read ies itself for op eration. The cam era m u st boot fu lly before it w ill be recognized by the GUI—the LED shines green once the cam era is read y. Connect to the frame grabber 1. 2. 3. Start Sap era Cam Exp ert (or equ ivalent Cam era Link com p liant interfa ce) by d ou ble clicking the d esktop icon created d u ring the softw are installation. Cam Exp ert w ill search for installed Sap er a d evices. In the Devices list area on the left sid e, the connected fram e grabber w ill be show n. Select the fram e grabber d evice by clicking on the nam e. N ote: The first tim e you set u p the cam era you w ill need to establish a com m u nication link betw een th e cam era and fram e grabber. Instru ctions are available here in Ap p end ix F: Cam era, Fram e Grabber Com m u nication. Connect to the camera 1. 2. Start a new Sap era Cam Exp ert ap p lication (or equ ivalent Cam era Link com p liant interfa ce) by d ou ble clicking the d esktop icon created d u ring the softw are installation. In the Devices list area on the left sid e, select the COM p ort below the Cam era Link label. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 33 Check LED Status If the cam era is op erating correctly at this p oint, the d iagnostic LED w ill shine green. Software Interface All the cam era featu res can be controlled throu gh the Cam Exp ert interface. For exam p le, u nd er the Sensor Control m enu in the cam era w ind ow you can control the line rate and exp osu re tim es. Teledyne DALSA 03-032-20180-00 34 Piranha4 4K Camera Color User's Manual At this p oint you r host and cam era system shou ld be setu p and you can verify th e cam era‘s op eration by retrieving a test p attern and setting the cam era‘s trigger and exp osu re tim e. Using Sapera CamExpert with Piranha4 Cameras Cam Exp ert is the cam era interfacing tool su p p orted by the Sap era library. When u sed w ith a Piranha4 cam era, Cam Exp ert allow s a u ser to test all cam era op erating m od es. Ad d itionally Cam Exp ert saves the cam era u ser settings configu ration to the cam era or saves m u ltip le configu rations as ind ivid u al cam era p aram eter files on the host system (*.ccf). Cam Exp ert can also be u sed to u p grad e the cam era‘s softw are. An im p ortant com p onent of Cam Exp ert is its live acqu isition d isp lay w ind ow w hich allow s im m ed iate verification of tim ing or control p aram eter s w ithou t the need to ru n a sep arate acqu isition p rogram . For context sensitive help , click on the bu tton then click on a cam era configu ration p aram eter. A short d escrip tion of the configu ration p aram eter w ill be show n in a p op u p . Click on the op en the help file for m ore d escrip tive inform ation on Cam Exp ert. bu tton to The central section of Cam Exp ert p rovid es access to the cam era featu res and p aram eters. Note: The availability of the featu res is d ep end ent on the Cam Exp ert u ser setting. A note on the CamExpert examples show n here: The examples show n for illustrative purposes and may not entirely reflect the features and parameters available from the camera model used in your application. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 35 CamExpert Panes Figure 11. CamExpert’s Camera Control Window Teledyne DALSA 03-032-20180-00 36 Piranha4 4K Camera Color User's Manual Figure 12. CamExpert GUI showing connected camera The Cam Exp ert ap p lication u ses p anes to sim p lify choosing and configu ring cam era files or acqu isition p aram eters for the installed d evice. D evice Selector pane: View and select from any installed Sap era acqu isition d evice. Once a d evice is selected Cam Exp ert w ill only p resent acqu isition p aram eters ap p licable to that d evice. Op tionally select a cam era file inclu d ed w ith the Sap era installation or saved by the u ser. Parameters pane: Allow s view ing or changing all acqu isition p aram eters su p p orted by the acqu isition d evice. Cam Exp ert d isp lays p aram eters only if those p aram eters are su p p or ted by the installed d evice. This avoid s confu sion by elim inating p aram eter choices w hen they d o not ap p ly to the hard w are in u se. D isplay pane: Provid es a live or single fram e acqu isition d isp lay. Fram e bu ffer p aram eters are show n in an inform ation bar above the im age w ind ow . Control Buttons: The Disp lay p ane inclu d es Cam Exp ert control bu ttons. These are: Acquisition control button: Click once to start live grab, click again to stop. Single frame grab: Click to acquire one fram e from d evice. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 37 Softw are trigger button: With the I/ O control param eters set to Trigger Enabled / Softw are Trigger type, click to send a single softw are trigger com m and . CamExpert display controls: (these d o not m od ify the fram e buffer d ata) Stretch im age to fit, set im age d isplay to original size, or zoom the im age to virtually any size and ratio. Histogram / Profile tool: Select to view a histogram or line/ colum n profile d uring live acquisition or in a still im age. Output Message pane: Disp lays m essages from Cam Exp ert or the d evice d river. Review a Test Image The cam era is now read y to retrieve a test p attern. Select Image Format Control > Test Pattern and choose one of the follow ing available test im ages. 0. Off: Sensor Vid eo 1. Grey Ram p 2. Ram p Pixels: {1, 2, 3…} Red Valu e: {0, 1, 2…} Green Valu e: {102, 103, 104…} Blu e Valu e: {204, 205, 206…} Valu es roll over at 255. At this p oint you are read y to start op erating the cam era in ord er to acqu ire im ages, set cam era fu nctions, and save settings. Teledyne DALSA 03-032-20180-00 38 Piranha4 4K Camera Color User's Manual 4. Camera Operation Factory Settings The cam era ship s and p ow ers u p for the first tim e w ith the follow ing factory settings: Cam era Link Med iu m , 8 bit p ixels, 85 MH z Internal trigger, line rate 10 kH z Internal exp osu re control, exp osu re tim e 30.5 µs Flat field d isabled User coefficients set to 1x Offset 0, System Gain 1x White balanced gains all set to 1x Color correction, not ap p lied Corrected u sing an 80 m m lens and a m agnification of 0.8 Check Camera and Sensor Information Cam era and sensor inform ation can be retrieved via a controlling ap p lication —for exam p le, the Cam Exp ert GUI show n in the follow ing exam p les. Param eters su ch as cam era m od el, firm w are version, sensor characteristics, etc. are read to u niqu ely id entify the connected d evice. The cam era inform ation p aram eters are grou p ed together as m em bers of the Cam era Inform ation set. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 39 Figure 13. CamExpert’s Camera Information Window Verify Temperature and Voltage To d eterm ine the voltage and tem p eratu re at the cam era, u se the Refresh Voltage and Refresh Temperature featu res fou nd in the Camera Information set. The tem p eratu re retu rned is the internal tem p eratu re in d egrees Celsiu s. For p rop er op eration, this valu e shou ld not exceed 80 °C. If the cam era exceed s the d esignated tem p eratu re it w ill stop im aging and the LED w ill tu rn red . Once you have d iagnosed and rem ed ied the issu e u se the reset camera fu nction. The voltage d isp layed is the cam era‘s inp u t voltage. Note: The voltage m easu rem ent featu re of the cam era p rovid es resu lts typ ically w ithin 1%. This m easu rem ent can be u sed to set the ap p lied voltage to the cam era. Saving and Restoring Camera Settings The p aram eters u sed to select, load and save u ser sets are grou p ed together u nd er the Cam era Inform ation set of featu res. There are 8 u ser sets available and one factor y set. Teledyne DALSA 03-032-20180-00 40 Piranha4 4K Camera Color User's Manual Camera Information Parameter User Set Default Selector User Set Selector User Set Load User Set Save Choices Select the cam era p aram eters to load w hen the cam era is reset or pow ered up as the Factory set, or as User Set 1 to 8. Selecting the set from the list autom atically saves it as the d efault set. Select the Factory or User set to Save or Load . -Factory Set -User Set 1 to 8. Load the set specified by User Set Selector to the cam era and m ake it the active / current set. Save the current set as selected user set. Description of the Camera Settings The cam era op erates in one of three settings: 1. 2. 3. 4. Cu rrent session. User setting. Factory setting (read -only). Defau lt setting. The cu rrent settings can be saved (thereby becom ing the u ser setting) u sing the User Set Save p aram eter. A p reviou sly saved u ser setting (User Set 1 to 8) or the factory settings can be restored u sing the User Set Selector and User Set Load p aram eters. Either the Factory or one of the User settings can be saved as the Defau lt Setting by selecting the set in the User Set Defau lt Selector. The chosen set au tom atically saves as the d efau lt setting and is the set load ed w hen the cam era is reset or p ow ered u p . The relationship betw een these three settings is illu strated in Figu re 14. Relationship betw een the Cam era Settings: 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 41 Figure 14. Relationship between the Camera Settings Active Settings for Current Session The active setting for the cu rrent session is the set of configu ration s that are op erating w hile the cam era is cu rrently ru nning, inclu d ing all u nsaved changes you have m ad e to the settings before saving them . These active settings are stored in the cam era‘s volatile m em ory and w ill be lost and can not be restored if the cam era resets or if the cam era is p ow ered d ow n or loses p ow er. To save these settings for reu se the next tim e you p ow er u p or reset the cam era, or to p rotect against losing them in the case of p ow er loss, you m u st save the cu rrent settings u sing the User Set Save p aram eter. Once saved , the cu rrent settings becom e the selected User Set. User Setting The u ser setting is the saved set of cam era configu rations that you can cu stom ize, resave, and restore. By d efau lt the u ser settings are ship p ed w ith the sam e settings as the factory set. The com m and User Set Save saves the cu rrent settings to non-volatile m em ory as a User Set. The cam era au tom atically restores the last saved u ser settings w hen it p ow ers u p . To restore the last saved u ser settings, select the User Set p aram eter you w ant to restore and then select the User Set Load p aram eter. Teledyne DALSA 03-032-20180-00 42 Piranha4 4K Camera Color User's Manual Factory Settings The factory setting is the cam era settings that w ere ship p ed w ith the cam era and w hich load ed d u ring the cam era‘s first p ow er-u p . To load or restore the original factory settings, at any tim e, select the Factory Setting p aram eter and then select the User Set Load p aram eter. Note: By d efau lt, the u ser settings are set to the factory settings. Default Setting Either the Factory or one of the User settings can be u sed as the Defau lt Setting by selecting the set in the User Set Defau lt Selector. The chosen set au tom atically becom es the d efau lt setting and is the set load ed w hen the cam era is reset of p ow ered u p . Camera Link Configuration Name Taps SPF* Cables Base 3 8, 10, 12 1 Med ium 6 8, 10, 12 2 Full 8 8 2 Deca 10 8 2 *Set Pixel Form at (nu m ber of bits p er p ixel) Trigger Modes The cam era‘s im age exp osu res are initiated by a trigger event. The trigger event is either a p rogram m able internal signal u sed in free ru nning m od e, an external inp u t u sed for synchronizing exp osu res to external triggers, or a p rogram m ed fu nction call m essage by the controlling com p u ter. These triggering m od es are d escribed below . Internal trigger (trigger disabled): The cam era free-ru nning m od e has a p rogram m able internal tim er for line rate and a p rogram m able exp osu re p eriod . External trigger (trigger enabled): Exp osu res are controlled by an external trigger signal. The external trigger signal is the Cam era Link control line CC1. Exposure Controls Exposure Control modes define the method and timing of how to control the sensor integration period. The integration period is the amount of time the sensor is exposed to incoming light before the video frame data is transmitted to the controlling computer. Exposure control is defined as the start of exposure and exposure duration. The start of exposure can be an internal timer signal (free-running mode) or an external trigger signal. The exposure duration can be programmable (such as the case of an internal timer) or controlled by the external trigger pulse width. The cam era can grab im ages in one of three w ays. You d eterm ine the three im aging m od es u sing a com bination of the Exp osu re Mod e p aram eters (inclu d ing I/ O p aram eters), Exp osu re Tim e and Line Rate p aram eters. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 43 Description Line Rate Internal line rate and exposure tim e External line rate and exposure tim e Internal, program m able Controlled by EXSYN C pulse Controlled by EXSYN C pulse EXSYN C pulse controlling the line rate. Program m ed exposure tim e Exposure Time Trigger Source (Sync) Internal program m able External (EXSYN C) Internal External Internal program m able External Figure 15. Exposure controls The p aram eters u sed to select the im aging m od es—trigger sou rces (sync), exp osu re tim e, and line rate— are grou p ed together as the Cam era Controls. Camera Controls Parameter Line Rate (in H z) Exp osu re Mod e Exp osu re Tim e Teledyne DALSA Description Cam era line rate in H z. Only available w hen the start line trigger p aram eter is d isabled (Trigger Mod e off). Set the op eration m od e for the cam era‘s exp osu re. Trigger Wid th or Tim ed . Trigger Wid th is only available w hen Trigger Mod e is enabled . Trigger Width Uses the w id th of the cu rrent line trigger signal p u lse to control the exp osu re d u ration. Timed The exp osu re d u ration tim e is set u sing the Exp osu re Tim e featu re and the exp osu re starts w ith the Line Start event. Exposure Time Selector Internally generated . Allow s for an ind ep end ent exp osu re tim e to be ap p lied to each ind ivid u al color. Sets the exp osu re tim e (in m icrosecond s). Exp osu re Mod e featu re m u st be set to Tim ed 03-032-20180-00 44 Piranha4 4K Camera Color User's Manual Exposure Modes in Detail 1. Internally Programmable Line rate and Internally Programmable Exposure Time (Default) Line rate is the d om inant factor w hen ad ju sting the line rate or exp osu re tim e. When setting the line rate, exp osu re tim e w ill d ecrease, if necessary, to accom m od ate the new line rate. When ad ju sting the exp osu re tim e the range is lim ited by the line rate. Note: The cam era w ill not set line p eriod s shorter than the read ou t p eriod . GenICam parameters to set: I / O Controls > Trigger Mode > Off 2. External Line Rate and External Exposure Time (Trigger Width) In this m od e, EXSYN C sets both the line p eriod and the exp osu re tim e. The rising ed ge of EXSYN C m arks the beginning of the exp osu re and the falling ed ge initiates read ou t. N ote: GenICam parameters to set: I / O Controls > Trigger Mode > On Sensor Control > Exposure Mode > Trigger Width Warning! When ru nning external line rate and external exp osu re tim e, the line rate m u st not exceed 1 / (exp osu re tim e + 1,500 ns). Und er these cond itions the exp osu re tim e w ill becom e ind eterm inate and resu lt in im age artefacts. This is not the case w hen ru nning internal exp osu re control . 3. External Line Rate, Programmable Exposure Time In this m od e, the line rate is set externally w ith the falling ed ge of EXSYN C generating the rising ed ge of a p rogram m able exp osu re tim e. GenICam parameters to set: I / O Controls > Trigger Mode > On Sensor Control > Exposure Mode > Timed 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 45 1. External Trigger Off, Internal Exposure Control Free running, not synchronized to an external signal Programmable Line Time Programmable Exposure1 >1.5us Programmable Exposure1 Sensor Readout2 Programmable Exposure1 Sensor Readout2 Sensor Readout2 LVAL 27.5us 2. External Trigger On, Internal Exposure Control CC1 Falling edge triggers start of internal exposure3 CC1 Line Time Programmable Exposure1 >1.5us Programmable Exposure1 Sensor Readout2 Programmable Exposure1 Sensor Readout2 Sensor Readout2 LVAL 27.5us 3. External Trigger On, External Exposure Control CC1 Falling edge triggers start of exposure CC1 high duration sets the exposure time X1 X2 CC1 X3 Line Time Exposure = X1 >1.5us Exposure = X2 Sensor Readout2 Exposure = X3 Sensor Readout2 27.5us Sensor Readout2 LVAL Notes: 1. Exposure time > 7 micro-seconds 2. Sensor Readout time = 14 micro-seconds 3. One additional falling edge during exposure is latched Figure 16. Exposure Modes Teledyne DALSA 03-032-20180-00 46 Piranha4 4K Camera Color User's Manual Set Line Rate To set the cam era‘s line rate u se the line rate p aram eter, p art of the Sensor Controls set. This featu re can only be u sed w hen the cam era is in Internal m od e—that is, w hen the start line trigger is d isabled (Trigger Mod e Off). Note: Line rate > (Exp osu re tim e + 1,500 ns) w ill retu rn an error (―Invalid Param eter‖) if this cond ition is not m et. You m u st ad ju st these tw o p aram eters in the correct sequ ence to m aintain this cond ition. If the external line rate exceed s 70 kH z the cam era w ill continu e to ou tp u t d ata at its m axim u m line rate of 70 kH z. Thou gh no im age artefacts associated w ith over -sp eed w ill occu r, you m ay notice that u nd er over-sp eed cond itions the im age w ill ap p ear com p ressed and the ap p arent d istance travelled w ill be red u ced . Camera Control Parameter Line Rate (in H z) Description Cam era line rate in a range from 0 H z to 70 KH z. This featu re is only available w hen the cam era is in Internal Mod e— line trigger is d isabled (Trigger Mod e off). Line Rates Camera Link Configuration Maximum Line Rate Base 20 kH z, Base RGB8 Med iu m 41 kH z Full 55 kH z Deca 69 kH z (Deca RGB8) Note: 70 kHz line rate can be achieved using AOI mode for all Camera Link Mode. For more information, see Area of Interest (AOI) Setup. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual Table 6: Line Rates vs AOI CL Clock Number Rate of AOI 85 MH z 85 MH z 85 MH z Teledyne DALSA 1 2 3 47 CL Configuration Line Rate Formula (Hz) Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z Fu ll RGB8 Max: 70KH z Deca RGB8 Max: 70KH z Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z Fu ll RGB8 Max: 70KH z Deca RGB8 Max: 70KH z Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z 03-032-20180-00 48 Piranha4 4K Camera Color User's Manual 85 MH z CL Clock Rate 66 MH z 03-032-20180-00 4 Number of AOI 1 Fu ll RGB8 Max: 70KH z Deca RGB8 Max: 70KH z Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z Fu ll RGB8 Max: 70KH z Deca RGB8 Max: 70KH z CL Configuration Line Rate Formula (Hz) Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z Fu ll RGB8 Max:70KH z Deca RGB8 Max: 70KH z Teledyne DALSA Piranha4 4K Color Camera User's Manual 66 MH z 66 MH z 66 MH z Teledyne DALSA 2 3 4 49 Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z Fu ll RGB8 Max: 70KH z Deca RGB8 Max: 70KH z Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z Fu ll RGB8 Max: 70KH z Deca RGB8 Max: 70KH z Base RGB8 Max: 70KH z Med iu m RGB8 Max: 70KH z Fu ll RGB8 Max: 70KH z 03-032-20180-00 50 Piranha4 4K Camera Color User's Manual Deca RGB8 Max: 70KH z Set Exposure Time To set the cam era‘s exp osu re tim e, u se the Exposure Time p aram eter—a m em ber of the Sensor Controls set. This featu re is only available w hen the Exposure Mode p aram eter is set to Timed. The allow able exp osu re range is from 7 µs to 3,000 µs, d ep end ent on the valu e of the internal line rate. GenICam parameters: Sensor Controls > Exposure Time (Timed Exposure Mode) > 8 µs to 3,000 µs. Control Gain and Black Level The cameras p rovid e gain and black level ad ju stments in the d igital d om ain for the CMOS sensor. The gain and black level controls can m ake small com p ensations to the acqu isition in situ ations w here lighting varies and the lens iris cannot be easily ad ju sted . The u ser can evalu ate gain and black level by u sing CamExp ert. The p aram eters that control gain and black level are grou p ed together in the Sensor Controls set. Sensor Controls Black Level Gain Ap p ly a d igital ad d ition after an FPN correction: ± 1/ 8 of the available range of -32 to +31 in 8-bit m od e, -128 to +127 in 10-bit m od e, and -512 to +511 in 12-bit m od e. Set the gain as an am p lification factor ap p lied to the vid eo signal across all p ixels: 1x to 10x. Set Image Size To set the height of the im age, and therefore the nu m ber of lines to scan, u se the p aram eters grou p ed u nd er the Im age Form at Control set. Image Format Control Control the size of the transm itted im age Wid th Wid th of the im age. H eight H eight of the im age in lines. Pixel Form at 8 bit d ep th to Cam era Link. Test Im age Selector Select an internal test im age: Off Color Ram p Grey Ram p 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 51 Set Baud Rate The bau d rate sets the sp eed (in bits p er second —bp s) of the serial com m u nication p ort and is available as p art of the Serial Port Control p aram eters. Serial Port Control Action Parameter Control the bau d rate u sed by the cam era‘s serial p ort Bau d Rate Options 9600 (factory d efau lt) 19200 57600 115200 230400* 460800* 921600* Note: Du ring connection Cam Exp ert au tom atically sets the cam era to m axim u m allow able bau d . N u m ber of bits p er character u sed in the serial p ort Parity of the serial p ort Data Size *You r system requ ires a Px8 fram e grabber to achieve these bau d rates. 8 Parity N one N u m ber of stop bits p er character u sed in the serial p ort N u m ber of Stop Bits 1 Pixel Format Use the Pixel Form at featu re, fou nd in the Image Format Control set, to select the form at of the p ixel to u se d u ring im age acqu isition . Image Format Control Parameter Pixel Form at Teledyne DALSA Description RGB8, RGB10, RGB12 03-032-20180-00 52 Piranha4 4K Camera Color User's Manual Camera Direction Control Fou nd in the I / O Control > D irection Control set of featu res. Direction Control Parameter Sensor Scan Direction Scan Direction Description This com m and lets you select the Internal or external direction control. Use this featu re to accom m od ate object d irection change on a w eb and to m ou nt the cam era "u p sid e d ow n." Read the cu rrent d irection. Pixel Readout Direction (Mirroring Mode) Set the tap read ou t from left to right or from right to left. This featu re is esp ecially u sefu l if you w ant to m ou nt the cam era ―u p sid e d ow n.‖ Image Format Control Parameter ReverseX Description Off: All p ixels are read ou t from left to right. On: All p ixels are read ou t from right to left. Resetting the Camera The featu re Camera Reset, p art of the Transport Layer set, resets the cam era. The cam era resets w ith the d efau lt settings, inclu d ing a bau d rate of 9600. Camera Information Parameter Cam era Reset 03-032-20180-00 Description Resets the cam era and p u ts in the d efau lt settings, inclu d ing a 9600 bau d rate. Teledyne DALSA Piranha4 4K Color Camera User's Manual 53 Calibrating the Camera Important Note: to ensu re best resu lts, the cond itions u nd er w hich you calibrate the cam era (e.g. tem p eratu re and illu m ination) shou ld be as close to the actu al op erating cond itions as p ossible. Figure 17: Flat Field Calibration in CamExpert Overview The follow ing d iagram and accom p anying d escrip tion exp lain the cam eras signal p rocessing chain. Each elem ent show n, w ith the excep tion of color interp olation, is u ser p rogram m able. Digital Processing (color) - Video Calibrate FPN flatfieldCalibrationFPN (ccf) x xR xG xB Calibrate PRNU flatfieldCorrectionMode flatfieldCalibrationPRNU flatfieldCorrectionAlgorithm (cpa,ffm) White Balancing BalanceWhiteAuto (bwa, ssg(0,1,2)) XXXX XXXX XXXX Color Correction colorCorrectionMode (ctv) + x Offset Gain BlackLevel (ssb) Gain (ssg 3) Output Video Figure 18: Camera Calibration Process. D igital Processing 1. Fixed p attern noise (FPN ) calibration is u sed to su btract any resid u al d ark level that m ay occu r in the ap p lication. 2. Photo resp onse non u niform ity (PRN U) calibration is u sed to cor rect for variations in the illu m ination intensity and / or lens vignetting. When p erform ed , this calibration w ill cau se the Teledyne DALSA 03-032-20180-00 54 Piranha4 4K Camera Color User's Manual 3. 4. 5. 6. 7. cam era to have a flat resp onse to a w hite target in the field of view . The ou tp u t target valu e for PRN U calibration can be set by th e u ser. The w hite balancing gains are u sed set the red , green and blu e resp onse to equ al valu es w ith a w hite target in the field of view . The w hite balance gains can be ind ivid u ally set by the u ser, bu t w ill be overrid d en by the cam era w hen the cam era p erform s PRN U calibration or w hite balancing com m and s. Color correction is available for those u sers that need to com p ensate for the sp ectral transm ission characteristics of the sensors color filters and the cu stom ers light sou rce. This can be achieved by im aging the Gretag Macbeth® ColorChecker® illu m inated by the ap p lication‘s light sou rce and p rocessing the im age u sing a color correction d em onstration tool p rovid ed as p art of Teled yne DALSA‘s Sap era Processing softw are. This tool w ill generate the d esired color correction file that can be d ow nload ed to the cam era. Note: Prior to im aging the Gretag Macbeth ColorChecker, the cam era shou ld have been calibrated w ith a w hite reference in p lace of the Gretag Macbeth ColorChecker and color correction m u st be tu rned off. The calibration p rocess w ill ensu re the cam era ou tp u t is u niform and w hite balanced . The introd u ction of offsets has lim ited valu e in color ap p lications as it w ill cau se color d istortion. H ow ever, the cam era has the ability to ad d either a p ositive o r negative offset as requ ired by a sp ecific ap p lication. This offset can be u sefu l w hen trying to m easu re d ark noise w here black level clip p ing w ill cau se an error in the resu lt. A single overall system gain is ap p lied equ ally to all three colors. It w ill therefore not cau se color d istortion w hen changed . A factory setting for w hite LED color correction can be ap p lied , if need ed . Calibration The goal of calibration is to p rod u ce a u niform , w hite balanced and , if requ ired , color corrected im age at the d esired level ou t of the cam era w hen it is im aging a u niform w hite object, u sing the op tical setu p of the u ser‘s ap p lication. The u ser shou ld configu re the cam era to u se the EXSYN C and exp osu re tim ing they d esire p lu s ad ju st the light level for norm al op eration. The lens shou ld be at the d esired m agnification, ap ertu re and be in focu s. As the w hite reference located at the object p lane w ill be in focu s, any featu res on its su rface (e.g. d u st, scratches) w ill end u p in the calibration p rofile of the cam era. To avoid this, u se a clean w hite p lastic or ceram ic m aterial, not p ap er. Id eally, the w hite object shou ld m ove d u ring the calibration p rocess a s the averaging p rocess of the cam era w ill d im inish the effects on any sm all variation in the w hite reference. The u ser m ay w ish to start the calibration p rocess by evalu ating the characteristics of their setu p w ith no calibration enabled . This can be read ily achieved by d isabling FPN , PRN U & color correction coefficients, setting w hite balance red , green and blu e gains to one, and the system gain to one. Begin by ad ju sting the system gain u ntil the p eak intensity of the three colors is at the d esired D N level. You m ay w ant to u se the w hite balance gains to ad ju st the p eak of each color to be a sim ilar DN valu e, bu t this is not necessary. Before p roceed ing any fu rther, it is d esirable to com p lete an FPN calibration. This is best p erform ed u sing a lens cap to ensu re no light gets into the cam era. Once com p lete, a PRN U calibration can be p erform ed u sing a target valu e you w ant all the p ixels to achieve. This target valu e can be higher or low er than the p eak valu es you observed w hile initially setting u p the cam era. Once PRN U calibration is com p lete, it w ill take several second s, all three colors shou ld be at the target valu e, w hite balance gains w ill have been ad ju sted to su it the cam eras op tim u m setu p for a balanced w hite ou tp u t, and the correction coefficient w ill be enabled . The system gain w ill rem ain as originally set. The coefficient and gain p aram eters, tim ing and control configu ration etc can be stored in any one of eight 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 55 u ser sets and au tom atically retrieved at p ow er u p or by u ser selection. If a col or correction m atrix is d esired , the u ser can d ow nload and save a color correction file d erived from the p rocess d escribed above. Note: For the color correction to be effective, the cam era shou ld have a w hite balanced ou tp u t w hen color correction is off. Cam Expert has a d efault tim eout of 20 second s per com m and , w hich is too short for the FFC calibration to run fully. You can change the d efault tim eout by setting a com m and line argum ent in the short-cut: Right click on the short-cut in the start m enu an d select properties. Ad d –tim eout 60 to increase the com m and tim eout to 60 second s (See below ). N ote that you m ust includ e a character space betw een the closing quotation m ark in the target and the hyphen before the tim eout value. Repeat for d esktop short-cut Figure 19: Setting the camera’s timeout value 1. Flat Field This Flat Field set contains a nu m ber of featu res that are u sed to correct im age d istortion d u e to lens vignetting and u neven illu m ination . . Note: 1. Flat field coefficients consist of an offset and gain for each p ixel. 2. These are the first u ser corrections ap p lied to the im age. 3. The flat field coefficients are saved and load ed w ith the u ser set . Flat Field Parameter Description flatfield CorrectionMod e 1. 2. 3. flatfield CorrectionAlgorithm 1. 2. Teledyne DALSA Off – Flat field correction coefficients are not ap p lied . On – Flat field correction coefficients are ap p lied . Initialize – Send ing this valu e w ill reset all cu rrent coefficients (offsets to 0 and gains to 1x). Basic – Direct calcu lation of coefficients based on cu rrent average line valu es and target. Low Pass – A low p ass filter is first ap p lied to the cu rrent average line valu es before calcu lating the coefficients. Use this algorithm if the calibration target is not u niform w hite or it s not p ossible to d efocu s the im age. Becau se of the low p ass filter this algorithm is not able to correct p ixel-to-p ixel variations and so it is p referable to u se the ―Basic‖ algorithm if p ossible. 03-032-20180-00 56 Piranha4 4K Camera Color User's Manual flatfield CalibrationTarget 1. flatfield CalibrationSam p leSize flatfield Calibration ROIOffsetX 1. 2. 1. After calibration all p ixels w ill be scaled to ou tp u t this level Range: 8 bit, 0 to 255 DN N u m ber of lines to average w hen calibrating 2048 or 4096* *4080 active p ixels, the last 16 p ixels are inactive. Together w ith ―flatfield Calibration ROIWid th‖ sp ecifies the range of p ixels to be calibrated . Pixel coefficients ou tsid e this range are not changed . It is p ossible to calibrate d ifferent regions sequ entially. flatfield Calibration ROIWid th flatfield CalibrationFPN 1. 2. flatfield CalibrationPRN U 3. 4. 1. 2. 3. Save average line (of ―flatfield CalibrationSam p leSize‖ row s). This is the first u ser correction ap p lied – it is su btracted from each line. This featu re m ay not be of u se to m any u sers as the cam era alread y su btracts tru e ―d ark cu rrent‖, bu t it m ay be u sefu l for som e to p rovid e a p er p ixel offset correction. Range 0 to 31 DN , 8 bit Defau lt valu e is 0 DN for each p ixel Use ―flatfield CorrectionAlgorithm ‖ to calcu late the p er p ixel gain to achieve the sp ecified target ou tp u t. Max 15.9998x Defau lt 1x 2. Contrast Enhancement The offset and gain featu res can be u sed to m axim ize the u se of the ou tp u t d ynam ic range. Typ ical u se is to su btract the m inim u m p ixel valu e exp ected and then gain u p to the m axim u m p ixel valu e to ap p roach fu ll scale. This p rocess m ay be u sefu l for ap p lications that p rocess the RGB colors ind ivid u ally. Offset 1. Single valu e ad d ed to each p ixel 2. Range -32 to +31 DN 3. Positive valu es m ay be u sed to m easu re d ark noise Gain 1. Floating p oint d igital m u ltip lier ap p lied to each p ixel 2. Range 1x to 10x N ote: An application note describing a color transformation matrix calibration (document #03032-20181) is available. Please contact Teledyne D ALSA Support for more information. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 57 Appendix A: GenICam Commands This ap p end ix lists the available GenICam cam era featu res. Access these featu res u sing the Cam Exp ert interface. Featu res listed in the d escrip tion table bu t tagged as Invisible are typ ically reserved for Teled yne DALSA Su p p ort or third p arty softw are u sage, and not typ ically requ ired by end u ser ap p lications. A note on the CamExpert examples show n here: The examples show n for illustrative purposes and may not entirely reflect the features and parameters available from the camera model used in your application. Camera Information Category Cam era inform ation can be retrieved via a controlling ap p lication. Param eters su ch as cam era m od el, firm w are version, etc. are read to u niqu ely id entify the connected P4 d evice. These featu res are typ ically read -only. The Cam era Inform ation Category grou p s inform ation sp ecific to the ind ivid u al cam era. In this category the nu m ber of featu res show n is id entical w hether the view is Beginner, Exp ert, or Gu ru . Featu res listed in the d escrip tion table bu t tagged as Invisible are u su ally for Teled yne DALSA or third p arty softw are u sage—not typ ically need ed by end u ser ap p lications. Teledyne DALSA 03-032-20180-00 58 Piranha4 4K Camera Color User's Manual Camera Information Feature Descriptions The follow ing table d escribes these p aram eters along w ith their view attribu te s and in w hich version of the d evice the featu re w as introd u ced . Ad d itionally the Device Version colu m n w ill ind icate w hich p aram eter is a m em ber of the DALSA Featu res N am ing Convention (u sing the tag D FN C), verses the GenICam Stand ard Featu res N am ing Convention (SFN C not show n). The Device Version nu m ber rep resen ts the cam era softw are fu nctional grou p , not a firm w are revision nu m ber. Display Name Feature Description Vend or N am e DeviceVend orN am e Disp lays the d evice vend or nam e. (RO) Mod el N am e DeviceMod elN am e Disp lays the d evice m od el nam e. (RO) Device Version DeviceVersion Manu factu rer Info DeviceManu factu rerInfo Firm w are Version DeviceFirm w areVersion Disp lays the d evice version. This tag w ill also highlight if the firm w are is a beta or cu stom d esign. (RO) This featu re p rovid es extend ed m anu factu rer inform ation abou t the d evice. (RO) Disp lays the cu rrently load ed firm w are version nu m ber. Firm w are files have a u niqu e nu m ber and have the .cbf file extension. (RO) 03-032-20180-00 Device Version & View 1.00 Beginner 1.00 Beginner 1.00 Beginner 1.00 Beginner 1.00 Beginner Teledyne DALSA Piranha4 4K Color Camera User's Manual Serial N u m ber DeviceID Pow er-u p Configu ration Selector UserSetDefau ltSelector Factory Setting UserSet1 D efault UserSet1 UserSet2 UserSet2 UserSet3 UserSet3 UserSet4 UserSet4 UserSet5 UserSet5 UserSet6 UserSet6 UserSet7 UserSet7 UserSet8 UserSet8 User Set Selector UserSetSelector Factory Setting D efault UserSet 1 UserSet1 UserSet 2 UserSet2 UserSet3 UserSet3 UserSet4 UserSet4 UserSet5 UserSet5 UserSet6 UserSet6 UserSet7 UserSet7 Teledyne DALSA 59 Disp lays the d evice‘s factory set cam era serial nu m ber. (RO) Selects the cam era configu ration set to load and m ake active on cam era p ow er-u p or reset. The cam era configu ration sets are stored in cam era non -volatile m em ory. (RW) Load factory default feature settings Select the u ser d efined configu ration UserSet 1 as the Pow er-u p Configu ration. Select the u ser d efined configu ration UserSet 2 as the Pow er-u p Configu ration Select the u ser d efined configu ration UserSet 3 as the Pow er-u p Configu ration Select the u ser d efined configu ration UserSet 4 as the Pow er-u p Configu ration. Select the u ser d efined configu ration UserSet 5 as the Pow er-u p Configu ration. Select the u ser d efined configu ration UserSet 6 as the Pow er-u p Configu ration. Select the u ser d efined configu ration UserSet 7 as the Pow er-u p Configu ration. Select the u ser d efined configu ration UserSet 8 as the Pow er-u p Configu ration. 1.00 Beginner 1.00 Beginner Selects the cam era configu ration set to load featu re settings from or save cu rrent featu re settings to. The Factory set contains d efau lt cam era featu re settings. (RW) Select the default camera feature settings saved by the factory Select the User-d efined Configu ration sp ace UserSet1 to save to or load from featu res settings p reviou sly saved by the u ser. Select the User-d efined Configu ration sp ace UserSet2 to save to or load from featu res settings p reviou sly saved by the u ser. Select the User-d efined Configu ration sp ace UserSet3 to save to or load from featu res settings p reviou sly saved by the u ser. Select the User-d efined Configu ration sp ace UserSet4 to save to or load from featu res settings p reviou sly saved by the u ser. Select the User-d efined Configu ration sp ace UserSet5 to save to or load from featu res settings p reviou sly saved by the u ser. Select the User-d efined Configu ration sp ace UserSet6 to save to or load from featu res settings p reviou sly saved by the u ser. Select the User-d efined Configu ration sp ace UserSet7 to save to or load from featu res settings p reviou sly saved by the u ser. 1.00 Beginner 03-032-20180-00 60 Piranha4 4K Camera Color User's Manual UserSet8 UserSet8 Select the User-d efined Configu ration sp ace UserSet8 to save to or load from featu res settings p reviou sly saved by the u ser. Pow er-on User Set UserSetDefau ltSelector Cu rrent User Set UserSetSelector Load Configu ration UserSetLoad Save Configu ration UserSetSave Device Bu ilt-In Self Test Statu s d eviceBISTStatu s LED Color d eviceLEDColorControl Allow s the u ser to select betw een the factory set and 1 to 8 u sersets to be load ed at p ow er u p Points to w hich u ser set (1-8) or factory set that is load ed or saved w hen the UserSetLoad or UserSetSave com m and is u sed Load s the cam era configu ration set sp ecified by the User Set Selector featu re, to the cam era and m akes it active. (W) Saves the cu rrent cam era configu ration to the u ser set sp ecified by the User Set Selector featu re. The u ser sets are located on the cam era in non-volatile m em ory. (W) Determ ine the statu s of the d evice u sing the ‗Bu ilt-In Self Test‘. Possible retu rn valu es are d evice-sp ecific. (RO) Disp lays the statu s of the LED on the back of the cam era. (RO) Tem p eratu re DeviceTem p eratu re Disp lays the internal op erating tem p eratu re of the cam era. (RO) Refresh Tem p eratu re refreshTem p eratu re Press to d isp lay the cu rrent internal op erating tem p eratu re of the cam era. Inp u t Voltage d eviceInp u tVoltage Disp lays the inp u t voltage to the cam era at the p ow er connector (RO) Refresh Voltage refreshVoltage Press to d isp lay the cu rrent inp u t voltage of the cam era at the p ow er connector License Key secu rityUp grad e 03-032-20180-00 1.00 Beginner 1.00 Beginner 1.00 Beginner 1.00 Beginner 1.00 DFN C Beginner 1.00 DFN C Beginner 1.00 DFN C Beginner 1.00 DFN C Beginner 1.00 DFN C Beginner 1.00 DFN C Beginner 1.00 DFN C Gu ru Teledyne DALSA Piranha4 4K Color Camera User's Manual 61 Camera Configuration Selection Dialog Cam Exp ert p rovid es a d ialog box w hich com bines the featu res to select the cam era p ow er u p state and for the u ser to save or load a cam era state from Genie m em ory. Camera Power-up Configuration The first d rop list selects the cam era configu ration state to load on p ow er-u p (see featu re UserSetDefaultSelector). The u ser chooses from one factory d ata set or one of tw o p ossible u ser saved states. User Set Configuration Management The second d rop list allow s the u ser to change the cam era configu ration anytim e after a p ow er-u p (see featu re UserSetSelector). To reset the cam era to the factory configu ration, select Factory Setting and click Load . To save a cu rrent cam era configu ration, select User Set 1 to 8 and click Save. Select a saved u ser set and click Load to restore a saved configu ration. Teledyne DALSA 03-032-20180-00 62 Piranha4 4K Camera Color User's Manual Camera Control Category The P4 cam era controls, as show n by Cam Exp ert, grou p s sensor sp ecific p aram eters. This grou p inclu d es controls for line rate, exp osu re tim e, scan d irection, and gain. Param eters in gray are read only, either alw ays or d u e to another p aram eter being d isabled . Param eters in black are u ser set in Cam Exp ert or p rogram m able via an im aging ap p lication. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 63 Camera Control Feature Descriptions The follow ing table d escribes these p aram eters along w ith their view attribu te and m inim u m cam era firm w are version requ ired . Ad d itionally the firm w are colu m n w ill ind icate w hich p aram eter is a m em ber of the DALSA Featu res N am ing Convention (DFN C), verses the GenICam Stand ard Featu res N am ing Convention (SFN C not show n). The Device Version nu m ber rep resents the cam era softw are fu nctional grou p , not a firm w are r evision nu m ber. Display Name Sensor Color Typ e Feature Description sensorColorTyp e Defines the cam era sensor color typ e. (RO) CFA_RGB Sensor color typ e is RGB Inp u t Pixel Size 8 Bits/ Pixel 10 Bits/ Pixel 12 Bits/ Pixel Internal Line Rate p ixelSizeInp u t Measu red Line Rate Refresh m easu red line rate Exp osu re Tim e Sou rce Tim ed m easu reLineRate Size of the im age inp u t p ixels, in bits p er p ixel. (RO) Sensor ou tp u t d ata p ath is 8 bits p er p ixel. Sensor ou tp u t d ata p ath is 10 bits p er p ixel. Sensor ou tp u t d ata p ath is 12 bits p er p ixel. Sp ecifies the cam era internal line rate, in H z w hen Trigger m od e set to internal. N ote that any u ser entered valu e is au tom atically ad ju sted to a valid cam era valu e. Sp ecifies the line rate p rovid ed to the cam era by either internal or external sou rce (RO) Press to show the cu rrent line rate p rovid ed to the cam era by either internal or external sou rces Trigger Wid th TriggerWid th Exp osu re Tim e Selector exp osu reTim eSelector Exp osu re Tim e Bp p 8 Bp p 10 Bp p 12 Acqu isitionLineRate refreshMeasu reLineRate Exp osu reMod e Tim ed All Red Green Blu e Exp osu reTim e Measu red Exp osu re Tim e m easu reExp osu reTim e Refreshed m easu red exp osu re tim e refreshMeasu reExp osu reTim e Teledyne DALSA Device Version & View 1.00 DFN C Beginner 1.00 DFN C Gu ru 1.00 Beginner 1.00 Beginner 1.00 Beginner Sets the op eration m od e for the cam era‘s 1.00 exp osu re (or shu tter). (RO) Beginner The exp osu re d u ration tim e is set u sing the Exp osu re Tim e featu re and the exp osu re starts w ith a LineStart event. Uses the w id th of the trigger signal p u lse to control the exp osu re d u ration. Selects w hich color that the exp osu re tim e valu e 1.00 is to ap p ly to. Beginner Exp osu re tim e setting ap p lies to all colors. Exp osu re tim e setting ap p lies to red . Exp osu re tim e setting ap p lies to green. Exp osu re tim e setting ap p lies to blu e. Sets the exp osu re tim e (in m icrosecond s) 1.00 w hen the Exp osu re Mod e featu re is set to Beginner Tim ed . Sp ecifies the exp osu re tim e p rovid ed to 1.00 the cam era by either internal or external Beginner sou rce (RO) Press to d isp lay the cu rrent exp osu re tim e 1.00 p rovid ed to the cam era. Beginner 03-032-20180-00 64 Piranha4 4K Camera Color User's Manual Direction Sou rce sensorScanDirectionSou rce Internal 1.00 Beginner Direction d eterm ined by valu e of SensorScanDirection External Internal Direction Gain Selector sensorScanDirection Forw ard Reverse GainSelector System Gain Direction control d eterm ined by valu e on CC3 When ScanDirectionSou rce set to Internal, d eterm ines the d irection of the scan Selects w hich gain is controlled w hen ad ju sting gain featu res. Ap p ly a d igital gain ad ju stm ent to the entire im age 1.00 Beginner 1.00 Beginner Red Green Blu e Gain Gain Offset BlackLevel Color Transform atio Selector colorTransform ationSelector WhiteLEDFactorySet N oCorrectionFactorySet MatrixUserSet1 MatrixUserSet2 03-032-20180-00 Ap p ly a d igital gain ad ju stm ent to the red channel only Ap p ly a d igital gain ad ju stm ent to the red channel only Ap p ly a d igital gain ad ju stm ent to the red channel only Sets the selected gain as an am p lification factor ap p lied to the im age. Controls the black level as an absolu te p hysical valu e. This rep resents a DC offset ap p lied to the vid eo signal, in DN (d igital nu m ber) u nits. Allow s the u ser to select betw een tw o factory p rogram m ed m atrixes or tw o u ser load ed sets 1.00 Beginner 1.00 Beginner 1.00 Beginner Color Correction Matrix for a w hite LED N o correction User p rogram m able/ load ed correction m atrix User p rogram m able/ load ed correction m atrix Teledyne DALSA Piranha4 4K Color Camera User's Manual Color Transform ation Valu e Selector Color Transform ation Valu e Line Sp atial Correction ColorTransform ationValueSelector Gain00 Gain01 Gain02 Gain10 Gain11 Gain12 Gain20 Gain21 Gain22 Offset1 Offset2 Offset3 ColorTransform ationValu e sensorLineSp atialCorrection 65 Allow s the u ser to m anu ally ad ju st correction valu e in the m atrix Red Green Blue Red Gain00 Gain10 Gain30 Green Gain01 Gain11 Gain31 Blue Gain02 Gain12 Gain32 1.00 Beginner Offset Offset1 Offset2 Offset3 Valu e entered as p ointed to by ColorTransform ationValu eSelector, -32 < valu e < 32 Set the nu m ber of row s betw een im aging lines 1.00 Beginner 1.00 Beginner Independent Exposure Control The Trinity cam eras featu re ind ep end ent exp osu re control. This featu re allow s the u ser to set a d ifferent exp osu re tim es for each color. The screenshot above show s the blu e color selected . Green and red are selected from the sam e d rop -d ow n box. Teledyne DALSA 03-032-20180-00 66 Piranha4 4K Camera Color User's Manual Ad ju st the ind ep end ent exp osu re control u sing either the GUI or the 3-letter com m and s: CamExpert GUI In the Camera Control Set Parameter Value Exp osu re Tim e Color Selector All, Red , Green, Blu e Exp osu re Tim e Three-Letter Commands In the Camera Control Set Parameter Value scl (Select Exp osu re Tim e Color Selector) Select 0-ALL, 1-Red , 2-Green, or 3-Blu e. set (Set Exp osu re Tim e) Execu tes the com m and . N ote that the red and green exp osu re tim es m u st be set at least 1 µsec shorter than the blue exposure time. The above restriction shou ld not to be an issu e for m ost ap p lications, as com m ercial light sou rces generally ou tp u t less p ow er at the blu e end of the sp ectru m . If the Exp osu re Tim e Color Selector is set to A ll, this criteria is au tom atically m et. Further note that the ord er in w hich the exp osu re tim e color selector valu es are entered is im p ortant . When entering the exp osu re tim es u sing either the GenIcam interface or the three -letter com m and interface, checks are p erform ed on the entered exp osu re tim es. If a blu e integration tim e is entered that is shorter than the green or red integration tim e, then an error cond ition w ill be ind icated and the valu e w ill not be accep ted by the cam era. The sam e is tru e if a red or green integration tim e is entered that is not sm aller by 1 µsec than the blu e integration tim e. Be aw are that the above checking is p erform ed on the valu e being entered against the valu es the cam era cu rrently has set and therefore that the ord er that the valu es are entered is im p ortant. For exam p le, if the revised blu e valu e is less than the cu rrent blu e valu e, enter the green and red valu es first. If t he new blu e valu e is greater than the cu rrent blu e valu e, enter the blu e valu e first. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 67 Digital I/O Control Feature Descriptions Display Name Feature Description Trigger Sou rce Trigger Sou rce Defines the sou rce of external trigger (RO) Trigger Selector Trigger Selector Defines w hat the trigger initiates (RO) Trigger Mod e Trigger Mod e Determ ines the sou rce of trigger to the cam era, internal or external (CC1) Teledyne DALSA Device Version & View 1.00 DFN C Beginner 1.00 DFN C Beginner 1.00 DFN C Beginner 03-032-20180-00 68 Piranha4 4K Camera Color User's Manual Flat Field Category The P4 Flat Field controls, as show n by Cam Exp ert, grou p p aram eters u sed to configu re cam era p ixel form at, and im age crop p ing. Ad d itionally a featu re control to select and ou tp u t an internal test im age sim p lifies the p rocess of setting u p a cam era w ithou t a lens. Param eters in gray are read only, either alw ays or d u e to another p aram eter being d isabled . Param eters in black are u ser set in Cam Exp ert or p rogram m able via an im aging ap p lication. Featu res listed in the d escrip tion table bu t tagged as Invisible are u su ally for Teled yne DALSA or third p arty softw are u sage—not typ ically need ed by end u ser ap p lications. Flat Field Control Feature Description The follow ing table d escribes these p aram eters along w ith their view attribu te and m inim u m cam era firm w are version requ ired . Ad d itionally the firm w are colu m n w ill ind icate w hich p aram eter is a m em ber of the DALSA Featu res N am ing Convention (DFN C), verses the GenICam Stand ard Featu res N am ing Convention (SFN C not show n). The Device Version nu m ber rep resents the cam era softw are fu nctional grou p , not a firm w are revision nu m ber. Display Name Mod e Off 03-032-20180-00 Feature flatfield CorrectionMod e Off Description FPN and flat field coefficients d isabled . Device Version & View 1.00 Beginner Teledyne DALSA Piranha4 4K Color Camera User's Manual 69 On On Initialize Initialize ScanDirectionControlled ScanDirectionControlled Select flatfield Correction Scan Direction Reverse Set flatfield ScanDirectionReverseSet Calibration Algorithm flatfield CorrectionAlgorithm Basic Basic Low Pass Low Pass Calibration Target flatfield CalibrationTarget Calibration Sam p le Size Lines_2048 Lines_4096 flatfield CalibrationSam p leSize ROI Offset X Lines_2048 Lines_4096 flatfield CalibrationROIOffsetX ROI Wid th flatfield CalibrationROIWid th Calibrate FPN flatfield CalibrationFPN Calibrate PRN U flatfield CalibrationPRN U Teledyne DALSA FPN and flat field coefficients enabled . Reset all FPN to 0 and all flat field coefficients to 1. Different u ser set load ed d ep end ing on d irection . DFN C When flatfield CorrectionMod e is set to ScanDirectionControlled this featu re selects the UserSEt (1 to8) w hich w ill be u sed for the reverse scan d irection. Selection betw een tw o d ifferent flat field algorithm s. Direct calcu lation of coefficients based on average line valu es and target. First each color is flat field ed to its p eak valu e and then the color gains are u sed to achieve the target. A low p ass filter is first ap p lied to the average line valu es before calcu lating the coefficients. Use this algorithm if the calibration target is not u niform ly w hite or it is not p ossible to d efocu s the im age. Becau se of the low p ass filter this algorithm is not able to correct p ixel-to-p ixel variations and so it is p referable to u se the ―Basic‖ algorithm . 1.00 Beginner DFN C Set a valu e betw een 0 and 255 to w hich the flat field algorithm w ill taget the im age to. Sets the nu m ber of lines to be averaged d u ring a flat field calibration 1.00 Beginner DFN C 1.00 Beginner DFN C Set the starting p oint of a region of interest w here a flat field calibration w ill be p erform ed Sets the w id th of the region on interest w here a flat field calibration w ill be p erform ed Initiates the FPN calibration p rocess 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner DFN C Initiates the PRN U or Flatfield p rocess 1.00 Beginner DFN C 03-032-20180-00 70 Piranha4 4K Camera Color User's Manual Balance White Au to BalanceWhiteAu to Initiates the p rocess of balancing the colors to p rod u ce a w hite balance 1.00 Beginner DFN C Region of Interest (ROI) The ROI featu re is related to flat field calibration. It is im p ortant to sp ecify an ROI w hen the object being im aged has areas that have black, non illu m inated areas su ch as beyond the ed ge of a film that is front illu m inated , or is satu rated , again beyond the ed ge of a film bu t in this case bright field back illu m inated . The ROI featu re allow s from one to fou r sp ecific regions of the p ixel line to be sp ecified w here flat field calibration w ill take p lace. Pixel d ata ou tsid e the ROI w ill not be u sed w hen p erform ing flat field calibration. Image Format Control Category The P4 Im age Form at controls, as show n by Cam Exp ert, grou p s p aram eters u sed to configu re cam era p ixel form at, im age crop p ing, and the test p attern. Param eters in gray are read only, either alw ays or d u e to another p aram eter being d isabled . Param eters in black are u ser set in Cam Exp ert or p rogram m able via an im aging ap p lication. Featu res listed in the d escrip tion table bu t tagged as Invisible are u su ally for Teled yne DALSA or third p arty softw are u sage—not typ ically need ed by end u ser ap p lications. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 71 Image Format Control Feature Description The follow ing table d escribes these p aram eters along w ith their view attribu te and m inim u m cam era firm w are version requ ired . Ad d itionally the firm w are colu m n w ill ind icate w hich p aram eter is a m em ber of the DALSA Featu res N am ing Convention (DFN C), verses the GenICam Stand ard Featu res N am ing Convention (SFN C not show n). The Device Version nu m ber rep resents the cam era softw are fu nctional grou p , not a firm w are revision nu m ber. Display Name Feature Description Test Pattern TestIm ageSelector Off Off Ram p Color_Ram p Line Mirroring Off On Ram p Color_Ram p ReverseX Off On Selects a grey scale Selects a color ram p Vid eo ou tp u t in norm al ord er Vid eo ou tp u t in a reverse ord er 1.00 Beginner DFN C Pixel Form at Pixel Form at RGB8 RGB8 Ou tp u t im age p ixel cod ing form at of the sensor. RGB 8bit 1.00 Beginner DFN C Pixel Color Filter PixelColorFilter Ind icates the typ e of color filter ap p lied to the im age. (RO) Pixel Cod ing PixelCod ing (RO) Wid th Wid th Max Wid th Wid thMax H eight H eight Mu ltip le AOI Mod e Off Active m u ltip leAOIMod e Off Active Wid th of the Im age p rovid ed by the d evice (in p ixels).(RO) The m axim u m im age horizontal d im ension of the im age. (RO) H eight of the Im age p rovid ed by the d evice (in lines). (RO) Tu rns on an ou tp u t Area of Interest Area of interest is off Area of interest is on 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner 1.00 Beginner 1.00 Beginner 1.00 Beginner DFN C Mu ltip le AOI Cou nt m u ltip leAOICou nt Set the nu m ber of ou tp u t area of interest 1-4 Mu ltip le AOI Selector m u ltip leAOISelector Selects the area of interest to be setu p Teledyne DALSA Selects the typ e of test im age that is sent by the cam era. Choices are either as d efined by SN FC and / or as p rovid ed by the d evice m anu factu rer. Selects sensor vid eo to be ou tp u t from sensor Device Version & View 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner DFN C 03-032-20180-00 72 Piranha4 4K Camera Color User's Manual AOI Offset X m u ltip leAOIOffsetX Set the start of area of interest (p ixels) AOI Wid th m u ltip leAOIWid th Set the w id th of area of interest (p ixels) 1.00 Beginner 1.00 Beginner DFN C Area of Interest (AOI) Setup The Area of Interest (AOI) featu re can be u sed to red u ce the am ou nt of im age-d ata ou tp u t from the cam era. Use this featu re w hen there are areas in the im age that contain u nneed ed inform ation. An exam p le w here you w ou ld u se this featu re is in an ap p lication that is insp ecting several sep arated lanes of objects w ith one cam era and the im age betw een the lanes can be ignored . The AOI featu re allow s from one to fou r sp ecific areas of the p ixel line to be sp ecified w here im age d ata w ill be ou tp u t. Since the AOI featu re red u ces the am ou nt of d ata ou tp u t, this has the ad d itional benefit of allow ing the cam eras to op erate at higher EXSYN C rates w hen u sing base, m ed iu m , or fu ll cam era link m od es. For exam p le, if the total nu m ber of p ixels for the sp ecified AOI`s is less than 1 K w hen u sing base Cam era Link m od e at 85 MH z, the m axim u m EXSYN C rate can be 70 KH z; versu s 20 KH z if all 4 K p ixels w ere ou tp u t. N ote: The setu p of AOI is alw ays w ith resp ect to the sensor. Therefore, if you are u sing the m irroring m od e w ith AOI, be aw are that p ixel one w ill be on the right sid e of the d isp layed im age. In order to set up an AOI for the camera: 1. 2. 3. 4. 5. The AOI m od e m u st first be in the off p osition. Use the AOI Cou nt to select the total nu m ber of AOIs d esired to a m ax of 4. To set u p each AOI ind ivid u al u se the AOI Selector to p oint to the AOI to be set u p . AOI Offset X is u sed ind icate the starting p ixel of the AOI. AOI Wid th is u sed to ind icate the w id th of the that AOI. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 73 1. Must be off to set up the AOI. 2. Set up the num ber of AOI d esired to m ax of 4. 3. Select area to set up. 4. Select beginning of selected area 5. Set up w id th of selected area Teledyne DALSA 03-032-20180-00 74 Piranha4 4K Camera Color User's Manual In order to initiate operation of the AOI once setup: 1. 2. The AOI m od e m u st be changed to Active. Be su re to set the fram e grabber im age w id th to the su m of all AOI w id ths set u p in the cam era. Once all AOI are set up change to active. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 75 Instructions on using the camera scan direction to control camera parameters The cam era is cap able of ad ju sting cam era p aram eters on-the-fly based on the scan d irection of the cam era. These p aram eters inclu d e gain, flat field coefficients, w hite balance and exp osu re tim e. 1. 2. The first step is to p u t the cam era in the reverse d irection. This can be d one u sing a reverse signal throu gh CC3 and the Direction Sou rce set to external or by having the Direction Sou rce set to Internal and the Internal Direction set to reverse. Set u p all the d esired p aram eters, inclu d ing flat field corrections. First, setup param eters for reverse d irection. 3. Save the cam era p aram eters to a User set other than the d efau lt u ser set. Teledyne DALSA 03-032-20180-00 76 Piranha4 4K Camera Color User's Manual Save to a user set choice. 4. 5. The next step is to p u t the cam era in the forw ard d irection. This can be d one u sing a forw ard signal throu gh CC3 and the Direction Sou rce set to external or by having the Direction Sou rce set to Internal and the Internal Direction set to forw ard . Set u p all the d esired p aram eters inclu d ing d oing a flat field . Setup param eters for forw ard d irection. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 6. 77 Save the cam era set to User Set other than the saved to for the reverse d irection. The forw ard d irection u ser set and the d efau lt u ser set m u st be the sam e. Forw ard d irection user set and d efault user set m ust be the sam e. Save to a d ifferent user set than the one selected for reverse d irection . Set the Flat Field m od e to Scan d irection Controlled . 7. In the Flat Field area change the m od e to Scan Direction Controlled . Teledyne DALSA 03-032-20180-00 78 Piranha4 4K Camera Color User's Manual A Note on External Direction, Direction Source, and User Sets If u sing external d irection control throu gh CC3 ensu re that the Direction Sou rce is both set to external and saved in the u ser set. Also ensu re that the p olarity on CC3 is set ap p rop riately for the d esired d irection. Transport Layer Control Category Param eters in gray are read only, either alw ays or d u e to another p aram eter being d isabled . Param eters in black are u ser set in Cam Exp ert or p rogram m able via an im aging ap p lication. Featu res listed in the d escrip tion table bu t tagged as Invisible are u su ally for Teled yne DALSA or third p arty softw are u sage—not typ ically need ed by end u ser ap p lications. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 79 Transport Layer Feature Descriptions The follow ing table d escribes these p aram eters along w ith their view attribu te and m inim u m cam era firm w are version requ ired . Ad d itionally the firm w are colu m n w ill ind icate w hich p aram eter is a m em ber of the DALSA Featu res N am ing Convention (DFN C), verses the GenICam Stand ard Featu res N am ing Convention (SFN C not show n). Display Name Feature Description Restart Cam era DeviceReset Used to restart the cam era, w arm reset XML Major Version DeviceManifestXMLMajorVersion XML Minor Version DeviceManifestXMLMinorVersion Last GenCP Statu s genCPStatu s Refresh GenCP Statu s Cam era Link Configu ration refreshGenCPStatu s Together w ith DeviceManifestXMLMinorVersion sp ecifies the GenICam ™ featu re d escrip tion XML file version (RO) Together w ith DeviceManifestXMLMajorVersion sp ecifies the GenICam ™ featu re d escrip tion XML file version (RO) If a featu re read or w rite fails then Sap era only retu rns that it fails – read this featu re to get the actu al reason for the failu re Retu rns the last error Read ing this featu re clears it Press to retu rn the cu rrent statu s of the GenCP Cam era Link Ou tp u t configu ration Cam era Link Configu ration Tap Geom etry Teledyne DALSA ClConfigu ration Base Med iu m Fu ll Deca clDeviceClockFrequ ency CL85MH z CL66MH z DeviceTap Geom etry Device Version & View 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner 1.00 Beginner Set the cam era link clock rate 1.00 Beginner (RO) 1.00 Beginner 03-032-20180-00 80 Piranha4 4K Camera Color User's Manual Acquisition and Transfer Control Category The P4 Acqu isition and Transfer controls, as show n by Cam Exp ert, grou p s p aram eters u sed to configu re the op tional acqu isition m od es of the d evice. Param eters in gray are read only, either alw ays or d u e to another p aram eter being d isabled . Param eters in black are u ser set in Cam Exp ert or p rogram m able via an im aging ap p lication. Featu res listed in the d escrip tion table bu t tagged as Invisible are u su ally for Teled yne DALSA or third p arty softw are u sage—not typ ically need ed by end u ser ap p lications. Acquisition and Transfer Control Feature Descriptions The follow ing table d escribes these p aram eters along w ith their view attribu te and m inim u m cam era firm w are version requ ired . Ad d itionally the firm w are colu m n w ill ind icate w hich p aram eter is a m em ber of the DALSA Featu res N am ing Convention (DFN C), verses the GenICam Stand ard Featu res N am ing Convention (SFN C not show n). Display Name Feature Description Device Registers Stream ing Start Device Registers Stream ing End DeviceRegistersStream ingStart Annou nces the start of registers stream ing w ithou t im m ed iate checking for consistency. Annou nces end of registers stream ing and p erform s valid ation for registers consistency before activating them . 03-032-20180-00 DeviceRegistersStream ingEnd Device Version & View 1.00 Beginner DFN C 1.00 Beginner DFN C Teledyne DALSA Piranha4 4K Color Camera User's Manual 81 Check Stream Valid ity DeviceRegistersCheck Press to check the valid ity of the cu rrent register set. Registers Valid DeviceRegistersValid States if the cu rrent register set is valid and consistent. 1.00 Beginner DFN C 1.00 Beginner DFN C Serial Port Control Category The Serial Port control in Cam Exp ert allow s the u ser to select an available cam era serial p ort and review its settings. This section also d escribes the Genie TS Fram ew ork Virtu al Serial Port Driver and the u se of the Genie TS serial p ort as an interface from an Ethernet netw ork to a serial p ort control system for other d evices. Featu res listed in the d escrip tion table bu t tagged as Invisible are u su ally for Teled yne DALSA or third p arty softw are u sage—not typ ically need ed by en d u ser ap p lications. Serial Port Control Feature Descriptions The Device Version nu m ber rep resents the cam era softw are fu nctional grou p , not a firm w are revision nu m ber. Display Name Bau d Rate Teledyne DALSA Feature DeviceSerialPortBau d Rate Description Sets the bau d rate u sed by the selected d evice‘s serial p ort. Available bau d rates are d evice-sp ecific. View 1.00 Beginner DFN C 03-032-20180-00 82 Piranha4 4K Camera Color User's Manual Bau d Bau d Bau d Bau d Bau d Bau d Bau d 9600 19200 57600 115200 230400 460800 921600 Bau d Bau d Bau d Bau d Bau d Bau d Bau d 9600 19200 57600 115200 230400 460800 921600 Serial Port Parity d eviceSerialPortParity N one Data Size Eight Bits N one d eviceSerialPortDataSize bp c8 Stop Bits d eviceSerialPortN u m berOf Stop Bits Stop bits1 Stop bits1 Bau d Bau d Bau d Bau d Bau d Bau d Bau d rate is 9600 rate is 19200 rate is 57600 rate is 115200 rate is 230400 rate is 460800 rate is 921600 Sets the p arity checking typ e on the selected serial p ort.(RO) Parity checking is d isabled Sets the bits p er character (bp c) to u se (RO). Use 8 bits p er character Sets the nu m ber of stop bits to u se. Use 1 stop bit 1.00 Beginner DFN C 1.00 Beginner DFN C 1.00 Beginner DFN C File Access Control Category The File Access control in Cam Exp ert allow s the u ser to qu ickly u p load variou s d ata files to the connected P4. The su p p orted d ata files are for P4 firm w are u p d ates, Flat Field coefficients. LUT d ata tables, and a cu stom im age for u se as an internal test p attern. Featu res listed in the d escrip tion table bu t tagged as Invisible are u su ally for Teled yn e DALSA or third p arty softw are u sage—not typ ically need ed by end u ser ap p lications. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 83 File Access Control Feature Descriptions Display Name File Selector Feature FileSelector FPGA Cod e Firm w are1 Micro Cod e CCI XML User Set Factory FlatField coefficients User FPN ColorCorrectionMatrix Cam eraData File Op eration Selector FileOp erationSelector Op en Op en Close Close Read Read Write Write Delete Delete File Op eration Execu te FileOp erationExecu te File Op en Mod e FileOp enMod e Read Write File Access Bu ffer Read Write FileAccessBu ffer File Access Offset FileAccessOffset File Access Length FileAccessLength Teledyne DALSA Description Selects the file to access. The file typ es w hich are accessible are d evice-d ep end ent. Up load new FPGA to the cam era w hich w ill execu te on the next cam era reboot cycle. Up load new m icro cod eto the cam era w hich w ill execu te on the next cam era reboot cycle. Up load new CCI to the cam era w hich w ill execu te on the next cam era reboot cycle. Up load new XML to the cam era w hich w ill execu te on the next cam era reboot cycle. Use UserSetSelector to sp ecify w hich u ser set to access. Use UserSetSelector to sp ecify w hich u ser flatfield to access. Use UserSetSelector to sp ecify w hich u ser FPN to access. Up load new color correction m atrix to the cam era. Dow nload cam era inform ation and send for cu stom er su p p ort. Selects the target op eration for the selected file in the d evice. This op eration is execu ted w hen the File Op eration Execu te featu re is called . Select the Op en op eration - execu ted by FileOp erationExecu te. Select the Close op eration - execu ted by FileOp erationExecu te. Select the Read op eration - execu ted by FileOp erationExecu te. Select the Write op eration - execu ted by FileOp erationExecu te. Select the Delete op eration - execu ted by FileOp erationExecu te. Execu tes the op eration selected by File Op eration Selector on the selected file. Selects the access m od e u sed to op en a file on the d evice. Select READ only op en m od e Select WRITE only op en m od e Defines the interm ed iate access bu ffer that allow s the exchange of d ata betw een the d evice file storage and the ap p lication. Controls the m ap p ing offset betw een the d evice file storage and the file access bu ffer. Controls the m ap p ing length betw een the d evice file storage and the file access bu ffer. View 1.00 Beginner DFN C 1.00 Gu ru 1.00 Gu ru 1.00 Gu ru 1.00 Gu ru 1.00 Gu ru 1.00 Gu ru 03-032-20180-00 84 Piranha4 4K Camera Color User's Manual File Op eration Statu s FileOp erationStatu s Su ccess Su ccess Failu re Failu re File Unavailable FileUnavailable File Invalid FileInvalid File Op eration Resu lt FileOp erationResu lt File Size FileSize Disp lays the file op eration execu tion statu s. (RO). The last file op eration has com p leted su ccessfu lly. The last file op eration has com p leted u nsu ccessfu lly for an u nknow n reason. The last file op eration has com p leted u nsu ccessfu lly becau se the file is cu rrently u navailable. The last file op eration has com p leted u nsu ccessfu lly becau se the selected file in not p resent in this cam era m od el. Disp lays the file op eration resu lt. For Read or Write op erations, the nu m ber of su ccessfu lly read / w ritten bytes is retu rned . (RO) Rep resents the size of the selected file in bytes. 1.00 Gu ru 1.00 Gu ru 1.00 Gu ru File Access via the CamExpert Tool 1. Click on the ―Setting…‖ bu tton to show the file selection m enu . 2. From the Typ e d rop m enu , select the file typ e that w ill be u p load ed to the cam era. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 3. 4. 5. 6. 7. 85 From the File Selector d rop m enu , select the cam era m em ory location for the u p load ed d ata. This m enu p resents only the ap p licable d ata locations for the selected file typ e. Click the Brow se bu tton to op en a typ ical Wind ow s Exp lorer w ind ow . Select the sp ecific file from the system d rive or from a netw ork location. Click the Up load bu tton to execu te the file transfer to the cam era. N ote that firm w are changes requ ire a d evice reset com m and from the Cam era Inform ation Controls and , ad d itionally, Cam Exp ert shou ld be shu td ow n and restarted follow ing a reset. Download a List of Camera Parameters For d iagnostic p u rp oses you m ay w ant to d ow nload a list of all the p aram eters and valu es associated w ith the cam era. 1. Go to File Access Control 2. Click on Settings 3. In the ―Typ e‖ d rop d ow n box select ―Miscellaneou s.‖ 4. In the ―File selector‖ d rop d ow n box select ―Cam eraData .‖ 5. 6. H it ―Dow nload ‖ Save the text file and send the file to Teled yne DALSA cu stom er su p p ort. Teledyne DALSA 03-032-20180-00 86 03-032-20180-00 Piranha4 4K Camera Color User's Manual Teledyne DALSA Piranha4 4K Color Camera User's Manual 87 Appendix B: ASCII Commands The follow ing com m and s can be u sed to control the Teled yne DALSA Piranha4 cam eras. Accessing the Three Letter Commands (TLC) To access the TLC an ASCII-based com m u nications interface ap p lication, su ch as H yp er Term inal. Ad d itionally it is p ossible to u se the fu nctions of clserxxx.dll or clallserial.dll as d efined in the Cam era Link Sp ecification. Figure 20: Serial DLL hierarchy as mentioned in the Camera Link Specification 1. 2. 3. 4. 5. Cycle p ow er to the cam era: by either a) issu ing the reset cam era com m and (rc), or b) p ow ering the cam era OFF and then ON . Load the ASCII interface u sing: 9600 bau d 8 d ata bits no p arity 1 stop bit no flow control local echo (carriage retu rn / linefeed ) Wait for a stable statu s LED color (green or red ) befor e p roceed ing. N ote that all entries in H yp erTerm inal w ill be ignored u ntil a stable LED color is obtained . In case of H yp erTerm inal, p ress the <ESC> key. Once <ESC> has been entered the help screen ap p ear s. Teledyne DALSA 03-032-20180-00 88 Piranha4 4K Camera Color User's Manual Notes on Using Alternatives to HyperTerminal If you are u sing interfaces other than H yp erTerm inal, th e ASCII character, ESC, is d ecim al 27 and need s to be issu ed . From the com m and line insert ESC by u sing ALT+2+7 of the activated N u m Pad . In som e cases this need s to be follow ed by a carriage retu rn o r a linefeed to send this to the cam era. In ASCII the ESC character m ay look like this: “←”. ASCII to GenCP To sw itch from the ASCII-com m and interface to the GenCP interface, the cam era m u st be either reset (RC) or the p ow er m u st be cycled . N ote that GenCP and ASCII com m and s cannot be accessed sim u ltaneou sly. N ote that the HyperTerminal application is not available on the Window s 7 OS. Alternatives to HyperTerminal The follow ing alternative ASCII-interfaces have been tested and show n to w ork w ith this cam era: Pu TTY and TeraTerm . N ote that Pu TTY d oes not have Xm od em cap ability w hile TeraTerm d oes. Xm od en is requ ired to u p d ate cod e in the cam era. TeraTerm http :/ / logm ett.com / ind ex.p hp ?/ d ow nload / tera-term -473-freew are.htm l Pu TTY http :/ / p u tty.en.softonic.com / The cam era resp ond s to a sim p le ASCII-based p rotocol. A carriage retu rn <CR> end s each com m and . Example: to return the current detector settings gcp <CR> A com p lete list of the available d etector com m and s, their fo rm at and p aram eters can be d isp layed by send ing the help (h) com m and . Port Configuration Bau d : Bits: Parity: Stop bits: Flow Control: 9,600 8 N one 1 N one Echo typ ed characters locally. Rules The interface is not case sensitive One com m and and argu m ent(s) p er line To enter a floating p oint nu m ber p refix it w ith a ―F‖ – for exam p le ―ssg 0 f1.5‖ Error cod es retu rned are the sam e as the GenICam ™ interface – see Diagnostics | Error Cod es Follow each com m and w ith the carriage retu rn character – 0x0D 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 89 Commands Full N ame Balance White Auto Mnemonic BWA Argument(s) D escription N otes Perform au tom atic w hite balance Gain each color su ch that the average of each is at the sam e level as the average of the m ost resp onsive. Full N ame Calibrate User FPN Mnemonic CCF Argument(s) # of lines to average D escription 2048 4096* Calibrate u ser FPN d ark flat field coefficients *4080 active p ixels, the last 16 p ixels are inactive. Full N ame Camera Link Speed Mnemonic CLS Argument(s) Frequ ency D escription Cam era Link clock frequ ency Full N ame Camera Link Mode Mnemonic CLM Argument(s) Mod e D escription Cam era Link Mod e Full N ame Color Matrix Selector Mnemonic CMS Argument(s) Device # of lines to average D escription Teledyne DALSA 0. 1. 85 MH z 66 MH z 0. 1. 2. 3. Base Med iu m Full Deca 0. Factory 1. User 0 or 1, w hen factory selected above then 0. White LED 1. N o correction (u nity m atrix) Color m atrix selector 03-032-20180-00 90 Piranha4 4K Camera Color User's Manual Full N ame Calibrate Flatfield Mnemonic CPA Argument(s) Algorithm D escription N otes 0. Basic 1. Low -p ass filter # of lines to average 2048 4096* Target 0 to 255 Calibrate u ser PRN U flat field coefficients Coefficients are saved and load ed w ith u ser set (e.g. USS / USL) Basic algorithm flattens each color and then u ses color gains to achieve target Whereas low -p ass filter algorithm d oes not ad ju st color gains *4080 active p ixels, the last 16 p ixels are inactive Full N ame Color Transformation Value Mnemonic CTV Argument(s) Selector Floating Point Valu e D escription N otes 03-032-20180-00 0. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. crr gain crg gain crb gain cgr gain cgg gain cgb gain cbr gain cbg gain cbb gain k r offset k g offset k b offset Gains: -32 to 32 Offsets: 0 to 255 Color Transform ation Matrix Valu e m u st be im m ed iately p reced ed w ith a ―F‖ (e.g. ctv 0 f1.5) Teledyne DALSA Piranha4 4K Color Camera User's Manual 91 Full N ame Mnemonic FCS Argument(s) File selector D escription N otes 1. 2. 3. 4. 5. 6. 7. 0. User Set 1. User PRN U 3. FPGA 4. Microcod e 5. CCI 6. XML 15. User FPN 16. Color correction m atrix Up load file to cam era u sing Xm od em p rotocol (H yp erTerm inal) User set, PRN U, FPN , and color correction m atrix are saved in the cu rrently active set Location to save color correction m atrix is sp ecified w ith CMS com m and Enter ―FCS <#>‖ com m and from H yp erTerm inal Click on ―Transfer‖ Brow se and find file Select ―Xm od em ‖ p rotocol Click ―Send ‖ When it ind icates that it is d one click ―Close‖ Up load all files and then reset cam era Full N ame Flatfield Mode Mnemonic FFM Argument(s) Mod e 0. 1. 2. 3. Disable u se of u ser FPN and PRN U flat field correction coefficients Enable u se of u ser FPN and PRN U flat field correction coefficients Reset u ser FPN coefficients to zero and u ser PRN U coefficients to one Scan d irection controlled u ser set load ing D escription N otes Set flat field m od e Full N ame Set Flatfield Scan D irection Reverse Set Mnemonic FRS Argument(s) D escription N otes User Set N u m ber 1 to 8 Set scan d irection controlled reverse set Teledyne DALSA 03-032-20180-00 92 Piranha4 4K Camera Color User's Manual Full N ame D isplay Camera Configuration Mnemonic GCP Argument(s) D escription N otes Disp lay cu rrent valu e of cam era configu ration p aram eters USER>gcp Model Microcode CCI FPGA Serial # BiST: P4_CC_04K07T_00_R 03-081-20282-85 03-110-20277-85 03-056-20444-00 11046283 Good DefaultSet Ext Trig Line Rate Meas L.R. Max L.R. Exp. Mode Exp. Red Time Exp. Gr. Time Exp. Bl. Time Meas E.T. Max E.T. 0 Off 10000 10000 19047 Timed 50000 50000 51000 50993 98500 [Hz] [Hz] [Hz] [ns] [ns] [ns] [ns] [ns] Test Pat. 0:Off Direction Internal, Line Delay 3.00 Flat Field On Color Plane Selector: Offset 0 Gain 1.00 Red Gain 1.00 Green Gain 1.00 Blue Gain 1.00 Color Matrix Selector: Color Correction Matrix: Mirror AOI Mode: CL Speed CL Config Pixel Fmt CPA ROI USER> Forward All Factory 2 1.000000, 0.000000, 0.000000, 0 0.000000, 1.000000, 0.000000, 0 0.000000, 0.000000, 1.000000, 0 Off Off 85MHz Medium RGB8 1-4080 Full N ame Get Value Mnemonic GET Argument(s) <‘p aram eter> D escription The ―get‖ com m and d isp lays the cu rrent valu e(s) of the featu re sp ecified in the string p aram eter. N ote that the p aram eter is p reced ed by a single qu ote ―‘‖. Using this com m and w ill be easier for control softw are than p arsing the ou tp u t from the ―gcp ‖ com m and . 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual N otes User>get „ssf 10000 Short bwa ccf cls clm cms cpa ctv ffm frs gcp h rc roi rpc sac sad sam sbr scd sem set smm spf ssa ssb ssf ssg stm svm usd usl uss vt vv Teledyne DALSA 93 Full Name Balance white auto Calibrate User FPN Camera Link Speed Camera Link Mode Color matrix Displayed Value and Description No value returned No value returned 0: 85MHz or 1: 66 MHz 0: Base 1: Med 2: Full 3: Deca 0: Factory1, 1: Factory2, 2: User1, 3: User2 Calibrate Flatfield No value returned Color Transformation Value 12 lines, floating point values Gain 00 Gain 01 Gain 02 Gain 10 Gain 11 Gain 12 Gain 20 Gain 21 Gain 22 Offset 1 Offset 2 Offset 3 Flat Field Mode 0: Off, 1: On, 3: Scan direction controlled Flat Field Reverse Set Set number 0-8 Camera Configuration No value returned Help No value returned Reset Camera No value returned Region of Interest Start pixel and end pixel numbers Reset Pixel Coefficients No value returned Set AOI Count Number of AOI‟s 1-4 Last AOI Set AOI 1 Offset AOI 1 Width AOI 2 Offset AOI 2 Width ... Set AOI Mode 0: Disabled, 1: Enabled Set Baud Rate No value returned Scan Direction 0: Internal, 1: External (CC3) control 0: Forward, 1: Reverse Exposure Mode 0: Internal, 1: External Exposure Time ns Mirroring Mode 0: Enabled, 1:Disabled Pixel Format 0: RGB8, 1: RGB10, 2: RGB12 Set Spatial Alignment 0 to 5 Offset -512 to 511 12-bit DN Internal Line Rate Hz Gain (four lines) 0: System, 1: Red, 2: Green, 3: Blue, floating point numbers Trigger Mode 0: Internal, 1: External Test Pattern 0: sensor video, 1: mono ramp, 2: color ramp Default User Set Set number 0-8 Load User Set Last set loaded 0-8 Save User Set Last set saved 0-8 Temperature No value returned Input Voltage No value returned 03-032-20180-00 94 Piranha4 4K Camera Color User's Manual Full N ame Help Mnemonic H Argument(s) D escription N otes Disp lay list of three letter com m and s USER>h P4 (03-081-20282-85): Command Line Interpreter Mar 15 2013, 09:41:09 bwa - Balance white auto ccf - Calibrate User FPN <2048|4096> cls - Camera Link Speed <0 - 85MHz, 1 - 66MHz> clm - Camera Link Mode <0:Base 1:Med 2:Full 3:Deca> cms - Color matrix selector <device 0-Factory, 1-User> <Selector 1-2> cpa - Calibrate Flatfield <0:basic 1:filter><2048|4096><DN target> ctv - Color transformation value <0-Gain00/1-Gain01/2-Gain02/3Gain10/..../8-Gain22/9-Offset1/10-Offset2/11-Offset3> f<value> ffm - Flat Field Mode <0:Off 1:On 2:Initiliaze 3:Scan direction controlled> frs - Set Flatfield Scan Direction Reverse Set <set 1-8> gcp - Display Camera Configuration get - Get value '<string> h - Help lpc - Load Pixel Coefficients <set 0-8> rc - Reset Camera roi - Set Flatfield ROI <1st pixel> <last pixel> rpc - Reset Flatfield Coefficients sac - Set AOI Count <value 1-4> sad - Set AOI Selector, Offset and Width <selector 1-AOI Count> <1st pixel> <width >= 40> sam - Set AOI Mode <1-enable, 0-disable> sbr - Set Baud Rate <9600|57600|115200> scd - Direction <0:Fwd, 1:Rev 2:Ext> scl - Select Exposure Time Color Selector <0-All,1-Red,2-Green,3-Blue> sem - Exposure Mode <0:Int 1:Ext> set - Exposure Time <ns> Blue Exposure Time must be greater than Red and Green by 1ms smm - Mirroring <0:Off 1:On> spf - Pixel Format <0:RGB8 1:RGB10 2:RGB12> ssa - Set Line Delay f<0-5> ssb - Offset <DN> ssf - Internal Line Rate <Hz> ssg - Gain <1-Red/2-Green/3-Blue> f<gain> stm - External Trigger <0:Off 1:On> svm - Test Pattern <0-2> usd - Default User Set <0-8> usl - Load User Set <0-8> uss - Save User Set <1-8> vt - Temperature vv - Input Voltage USER> 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 95 Full N ame Load Pixel Coefficients Mnemonic LPC Argument(s) Set selector D escription N otes Load u ser set Load s FPN coefficients and PRN U coefficients from a u ser set ( only coefficeints, no other cam era p aram eters) Full N ame Reset Camera Mnemonic RC Argument(s) D escription 0. Factory set 1-8. User sets Resets the cam era to the saved u ser d efau lt settings. These settings are saved u sing the u sd com m and . N otes Full N ame Set Flatfield ROI Mnemonic ROI Argument(s) First p ixel 1 to 4096* Last p ixel 1 to 4096* Flat field region of interest Sp ecifies the p ixels that CCF and CPA w ill calibrate o Pixel coefficients ou tsid e this region are not changed Last p ixel m u st be greater than or equ al to first p ixel *4080 active p ixels, the last 16 p ixels are inactive D escription N otes Full N ame Reset Flatfield Coefficients Mnemonic RPC Argument(s) D escription N otes Reset all u ser FPN valu es to zero and all u ser PRN U coefficients to one Full N ame Set AOI Count Mnemonic SAC Argument(s) D escription N otes N u m ber of AOI‘s Set AOI Cou nter Teledyne DALSA 1 to 4 03-032-20180-00 96 Piranha4 4K Camera Color User's Manual Full N ame Set AOI Selector Mnemonic SAD Argument(s) Selector 1 to 4 Offset 1 to 4096*, m u ltip le of eight Wid th 40 to 4096* Define an AOI Mu st not overlap w ith an alread y existing AOI *4080 active p ixels, the last 16 p ixels are inactive D escription N otes Full N ame Set AOI Mode Mnemonic SAM Argument(s) Mod e D escription N otes Set AOI m od e Full N ame Set Baud Rate Mnemonic SBR Argument(s) Bau d rate D escription N otes Set bau d rate Send com m and and then change sp eed of H yp erTerm inal Full N ame D irection Mnemonic SCD Argument(s) Direction D escription N otes Set sensor scan d irection Full N ame Select Exposure Time Color Selector Mnemonic SCL Argument(s) Color Selector D escription N otes 03-032-20180-00 0. 1. ―Off‖ ―Active‖ 9600 57600 115200 0. 1. 2. Forw ard Reverse External – controlled by CC3 signal 0. All 1. Red 2. Green 3. Blu e Select the color to ap p ly an exp osu re tim e valu e to. Teledyne DALSA Piranha4 4K Color Camera User's Manual 97 Full N ame Exposure Mode Mnemonic SEM Argument(s) Mod e D escription N otes Set exp osu re tim e m od e In internal m od e the exp osu re tim e is controlled by the SET com m and In external m od e the sensor is exp osed w hile CC1 signal is high External m od e is only available w hen the trigger m od e is also external (STM 1) SEM 1 overrid es internally generated ind ep end ent exp osu re tim es Full N ame Exposure Time Mnemonic SET Argument(s) D escription N otes Exp osu re tim e 8 000 to 3000000 [ns] Set internal exp osu re tim e Line tim e > ( Exp osu re tim e + 1,500 ns ) Full N ame Mirroring Mnemonic SMM Argument(s) Mod e D escription N otes Set m irroring m od e Full N ame Pixel Format Mnemonic SPF Argument(s) Selector D escription N otes Set p ixel form at Teledyne DALSA 0. 1. Internal External 0. 1. Off Im age is flip p ed on the vertical axis 0. 1. 2. RGB8 RGB10 RGB12 03-032-20180-00 98 Piranha4 4K Camera Color User's Manual Full N ame Set Line D elay Mnemonic SSA Argument(s) D escription N otes # of lines 0 to 5 Sets the nu m ber of lines of d elay betw een colors th at are read ou t from the sensor (d efau lt 3). If you r line rate m atches the sp eed of the object, then the valu e of the line d elay w ill be 3. Ad ju st the ssa valu e u ntil you rem ove the red and blu e halos above and below a black on w hite horizontal line in ord er to set the line d elay. Valu es entered m u st be betw een 0 and 5. Decim al p laces are valid for su b-p ixel correction. Full N ame Offset Mnemonic SSB Argument(s) Offset D escription N otes Set offset Range changes d ep end ing on p ixel form at (SPF) Full N ame Internal Line Rate Mnemonic SSF Argument(s) D escription N otes Line rate 1 to 70,000 [H z] Set internal line rate Line tim e > ( Exp osu re tim e + 1,500 ns ) Full N ame Gain Mnemonic SSG Argument(s) Selector D escription N otes Gain Set gain Mu ltip lier m u st be im m ed iately p reced ed w ith a ―F‖ (e.g. ssg 0 f1.5) 03-032-20180-00 8 bit 10-bit 12-bit 0. 1. 2. 3. 1 to 10 -32 to 31 -128 to 127 -512 to 511 System Red Green Blu e Teledyne DALSA Piranha4 4K Color Camera User's Manual 99 Full N ame External Trigger Mnemonic STM Argument(s) Mod e D escription N otes Set trigger m od e In internal m od e line rate is controlled by SSF com m and In external m od e read ou t starts on falling ed ge of CC1 signal Full N ame Test Pattern Mnemonic SVM Argument(s) Mod e D escription N otes Select test p attern When a test p attern is selected all d igital p rocessing (e.g. flat field , gain) is d isabled – it is re-enabled w hen sensor vid eo is selected Full N ame D efault User Set Mnemonic USD Argument(s) Set selector D escription N otes 0. 1. 0. 1. 2. Internal External Off – sensor vid eo Ram p Color Ram p 0. Factory set 1-8. User sets Select u ser set to load w hen cam era is reset The settings inclu d e all those listed by the GCP com m and p lu s the u ser FPN coefficients, u ser PRN U coefficients, and color correction m atrix Full N ame Load User Set Mnemonic USL Argument(s) Set selector D escription N otes Load u ser set Load s and m akes cu rrent all the settings listed by the GCP com m and p lu s the u ser FPN coefficients, u ser PRN U coefficients, and color correction m atrix Full N ame Save User Set Mnemonic USS Argument(s) D escription N otes Set selector 1 to 8 Save u ser set Saves all the cu rrent settings listed by the GCP com m and p lu s the u ser FPN coefficients, u ser PRN U coefficients, and color correction m atrix Teledyne DALSA 0. Factory set 1-8. User sets 03-032-20180-00 100 Piranha4 4K Camera Color User's Manual Full N ame Temperature Mnemonic VT Argument(s) D escription N otes Disp lay internal tem p eratu re in d egrees Celsiu s Full N ame Voltage Mnemonic VV Argument(s) D escription N otes Disp lay su p p ly voltage 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 101 Appendix C: Quick Setup and Image Acquisition If you are fam iliar w ith the op eration of Cam era Link cam eras and have an u nd erstand ing of im aging fu nd am entals, the follow ing step s w ill show you how to qu ickly set u p this cam era and begin acqu iring im ages. 1. On Power Up The color cam era has been calibrated and configu red at the factory to be read y for you r evalu ation w hen first p ow ered u p . The d efau lt cond itions are set as follow s: System gain is set to the low est valu e of one. Flat field calibration is not active as this featu re is d ep end ent on you r light sou rce and lens. Line rate and exp osu re tim e are set to for internal generation by the cam era. White balance is set for w hite LEDs. Cam era Link m od e is set to the stand ard RGB m ed iu m m od e w hich allow s op eration of u p to 40 KH z line rate. The cam era w ill ru n at u p to a 69 KH z line rate u sing Cam era Link Deca m od e, bu t it m ay be easier to start you r evalu ation u sing the m ed iu m m od e. Set you r Cam era Link fram e grabber u p to receive the stand ard RGB m ed iu m m od e. 2. Communicating with the Camera The color cam era is d esigned to p ow er u p w ith a GenICam -com p liant interface. Cam Exp ert p rovid es an easy-to-u se GUI that can be u sed to set u p and evalu ate the cam era. The cam era also com es w ith Teled yne DALSA‘s three letter com m and (TLC) interface op tion, w hich can be accessed u sing a su itable term inal p rogram su ch as H yp erTerm inal ™. If you w ant to u se the TLC interface, p ress the ‗Esc‘ key w hile u sing a term inal p rogram and after the LED ind icator on the cam era tu rns green. N ote that the cam era d efau lts to 9.6 KBau d w hen first p ow ered u p . On receiving the ‗Esc‘ character, the cam era w ill ou tp u t a list of the available TLC com m and s. You can then p roceed to enter TLC com m and s as requ ired . Enter ‗h‘ at any tim e to get the list of com m and s from the cam era. Enter the ‗gcp ‘ com m and at any tim e to get the cu rrent setu p cond itions of the cam era. Teledyne DALSA 03-032-20180-00 102 Piranha4 4K Camera Color User's Manual 3. Setting Up Your Optical Configuration Typ ically, the first thing you w ant to d o is to evalu ate the cam era‘s im age qu ality u nd er op erating cond itions sim ilar to those that you are likely to u se in you r ap p lication . In ord er to d o this, take the follow ing step s: The illu m ination, lens m agnification , and focu s shou ld be set u p as p er you ap p lication. Getting the m agnification right is best accom p lished by setting the object-to-sensor d istance. Use the form u la lens focal length x (2 + 1/magnification + magnification) to calcu late this d istance. Magnification equ als the sensor p ixel size (10.56 µm ) / (you r object p ixel size in u m ). The ap p roxim ate location of the sensor p osition is at the first gr oove in the sid e of the case, back from the front face. 4. Camera Timing & Control It is easiest and qu ickest to evalu ate the cam era u sing the internal tim ing setu p s for line rate and exp osu re tim e. Since w e recom m end starting w ith Cam era Link m ed iu m m od e, set a su itable line rate less than 40 KH z, u sing the ‗ssf‘ com m and . If this line rate is too slow for you r ap p lication, you w ill get a com p ressed im age in the scan d irection. This shou ld not be a p roblem for a basic evalu ation. You can set the exp osu re tim e u sing the ‗set‘ com m and . Ensu re that the exp osu re tim e p eriod is not greater than the p eriod of the line rate m inu s 1.5 µsec. The cam era w ill ind icate an error if you select an exp osu re tim e that is too long . The m inim u m exp osu re tim e is 7 µsec. Set you r cam era d irection u sing the ‗scd ‘ com m and . Refer to the Cam era Direction d iagram in this m anu al for a d efinition of ‗forw ard ‘ and ‗reverse‘. 5. Acquiring an Image You can now begin im aging. Unless you have an ap p lication em p loying lots of light, the im age is likely to be too d ark. Use the system gain to ad ju st the cam era ou tp u t to achieve the d esired resp onse. The system gain range is from 1x to 10x. Once you have a su itable resp onse, you can now focu s the lens. If you are u sing w hite LEDs, you r im age w ill have reasonable color rep rod u ction . The im age m ay be d arker at the ed ges d u e to lens vignetting, bu t this w ill be im p roved once the cam era is calibrated . Calibration is p erform ed u sing a w hite reference w here you r object is norm ally located . o 03-032-20180-00 Use a w hite m aterial that has no textu re, su ch as a non glossy p lastic. Teledyne DALSA Piranha4 4K Color Camera User's Manual o 103 If you m u st u se w hite p ap er, m ake su re it is m oving d u ring the calibration p rocess. If you d o not d o this, you r im age w ill have vertical strip es. Calibration is easily p erform ed u sing the TLC ‗cp a‘ com m and . The cp a com m and has tw o p aram eters. o The first is the nu m ber of lines you w ant to average over. Use a valu e of 4096* to achieve the best average. (*4080 active p ixels, the last 16 p ixels are inactive.) o The second is the eight bit target valu e you w ant for all three colors after calibration. The cp a com m and takes several second s to com p lete. The slow er the line rate, the longer it w ill take. On com p letion of the ‗cp a‘ com m and , you shou ld see an im age from the cam era that is w hite balanced w ith all three colors at the target level you set. You are now read y to evalu ate the im age qu ality of the P4 color cam era u nd er you r op erating cond itions. 6. Improving Your Color Image The color resp onse of the P4 color cam era is qu ite good even w hen u sing w hite LED‘s and even w ithou t color correction. The cam era has a factor y set w hite LED color correction m atrix that can be selected to im p rove color resp onse for those u sing w hite LED‘s. If you are u sing a d ifferent light sou rce, a su itable color correction m atrix can be d ow nload ed to the cam era. A softw are tool to generate t his is available w ith the Sap era Essentials p rocessing ap p lications, w hich can be d ow nload ed from the Teled yne DALSA w eb site (60 d ay free trial). You w ill requ ire a Gretag Macbeth ColorChecker w ith 4 x 6 color elem ents that you can scan p ast the cam era to com p lete the generation of the m atrix. Contact Teled yne DALSA‘s technical su p p ort for fu rther d etails here, Su p p ort. Teledyne DALSA 03-032-20180-00 104 Piranha4 4K Camera Color User's Manual Appendix D: The Sensor Window Cleaning and Protecting Against Dust, Oil, and Scratches The sensor w ind ow is p art of the op tical p ath and shou ld be hand led like other op tical com p onents, w ith extrem e care. Du st can obscu re p ixels, p rod u cing d ark p atches on the sensor resp onse. Du st is m ost visible w hen the illu m ination is collim ated . The d ark p atches shift p osition as the angle of illu m ination changes. Du st is norm ally not visible w hen the sensor is p ositioned at the exit p ort of an integrating sp here, w here the illu m ination is d iffu se. Du st can norm ally be rem oved by blow ing the w ind ow su rface u sing an ionized air gu n. Oil is u su ally introd u ced d u ring hand ling. Tou ching the su rface of the w ind ow barehand ed w ill leave oily resid u es. Using ru bber fingercots an d ru bber gloves can p revent contam ination. H ow ever, the friction betw een ru bber and the w ind ow m ay p rod u ce electrostatic charge that m ay d am age the sensor. To avoid ESD d am age and to avoid introd u cing oily resid u es, avoid tou ching the sensor. Scratches d iffract incid ent illu m ination. When exp osed to u niform illu m ination, a sensor w ith a scratched w ind ow w ill norm ally have brighter p ixels ad jacent to d arker p ixels. The location of these p ixels w ill change w ith the angle of illu m ination. An important note on w indow blemishes: When flat field correction is p erform ed , w ind ow cleanliness is p aram ou nt. The figu re below show s an exam p le of w hat can hap p en if a blem ish is p resent on the sensor w ind ow w hen flat field correction is p erform ed . The blem ish w ill cast a shad ow on the w afer. FFC w ill com p ensate for this shad ow by increasing the gain. Essentially FFC w ill create a w hite sp ot to com p ensate for the d ark sp ot (shad ow ). As long as the angle of the incid ent light rem ains u nchanged then FFC w orks w ell. H ow ever w hen the angle of incid ence changes significantly (i.e. w hen a lens is ad d ed ) then the shad ow w ill shift and FFC w ill m akes things w orse by not correcting the new shad ow (d ark sp ot) and overcorrecting w here the shad ow u sed to be (w hite sp ot). While the d ark sp ot can be p otentially cleaned , the w hite sp ot is an FFC artifact that can only be corrected by another FFC calibration. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 105 Cleaning the Sensor Window Recommended Equipment Glass cleaning station w ith m icroscop e w ithin clean room . 3M ionized air gu n 980 (http :/ / solu tions.3m canad a.ca/ w p s/ p ortal/ 3M/ en_CA/ WW2/ Cou ntry/ ) Ionized air flood system , foot op erated . Sw ab (H UBY-340CA-003) (http :/ / w w w .cleancross.net/ m od u les/ xfsection/ article.p hp ?articleid =24) Single d rop bottle (FD-2-ESD) E2 (Eclip se op tic cleaning system (w w w .p hotosol.com ) Use localized ionized air flow on to the glass d u ring sensor cleaning. Blow off m obile contam ination u sing an ionized air gu n. Place the sensor u nd er the m icroscop e at a m agnification of 5x to d eterm ine the location of any rem aining contam ination. Clean the contam ination on the sensor u sing one d rop of E2 on a sw ab. Wip e the sw ab from left to right (or right to left bu t only in one d irection). Do this in an overlap p ing p attern, tu rning the sw ab after the first w ip e and w ith each su bsequ ent w ip e. Avoid sw ip ing back and forth w ith the sam e sw ab in ord er to ensu re that p articles are rem oved and not sim p ly transferred to a new location on the sensor w ind ow . This p roced u re requ ires you to u se m u ltip le sw abs. Discard the sw ab after both sid es of the sw ab have been u sed once. Rep eat u ntil there is no visible contam ination p resent. Procedure Teledyne DALSA 03-032-20180-00 106 Piranha4 4K Camera Color User's Manual Appendix E. Color Deca and Full Mode Acquisition Overview This section d escribes how to acqu ire im ages w ith the Piranha4 color cam era u nd er RGB 9.1 Deca m od e to achieve a 69 KH z line rate, and u nd er RGB 6.2 Fu ll m od e to achieve a 55 KH z line rate. Supported Sapera LT Sap era 7.10 or later is requ ired . Programming Deca Mode The RGB 9.1 Deca m od e u tilizes Cam era Link 10-tap , 8-bit m od e to achieve RGB form atting. Below is the Cam era Link p ort assignm ent of Deca m od e. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 107 Line Valid CL Clock CL Port A Red 1 D0..D7 Green 4 D0..D7 Blue 7 D0..D7 Red 11 D0..D7 Blue 4091 D0..D7 Red 4095 D0..D7 CL Port B Green 1 D0..D7 Blue 4 D0..D7 Red 8 D0..D7 Green 11 D0..D7 Red 4092 D0..D7 Green 4095 D0..D7 CL Port C Blue 1 D0..D7 Red 5 D0..D7 Green 8 D0..D7 Blue 11 D0..D7 Green 4092 D0..D7 Blue 4095 D0..D7 CL Port D Red 2 D0..D7 Green 5 D0..D7 Blue 8 D0..D7 Red 12 D0..D7 Blue 4092 D0..D7 Red 4096 D0..D7 CL Port E Green 2 D0..D7 Blue 5 D0..D7 Red 9 D0..D7 Green 12 D0..D7 Red 4093 D0..D7 Green 4096 D0..D7 CL Port F Blue 2 D0..D7 Red 6 D0..D7 Green 9 D0..D7 Blue 12 D0..D7 Green 4093 D0..D7 Blue 4096 D0..D7 CL Port G Red 3 D0..D7 Green 6 D0..D7 Blue 9 D0..D7 Red 13 D0..D7 Blue 4093 D0..D7 CL Port H Green 3 D0..D7 Blue 6 D0..D7 Red 10 D0..D7 Green 13 D0..D7 Red 4094 D0..D7 CL Port I Blue 3 D0..D7 Red 7 D0..D7 Green 10 D0..D7 Blue 13 D0..D7 Green 4094 D0..D7 CL Port K Red 4 D0..D7 Green 7 D0..D7 Blue 10 D0..D7 Red 14 D0..D7 Blue 4094 D0..D7 This tap arrangem ent allow s all fram e grabbers w ith 10-tap , 8-bit to grab im ages w ithou t requ iring ad d itional m od ifications. H ow ever, in ord er to correctly form at the im age for p rocessing and d isp lay p u rp oses, fram e grabbers need to su p p ort RGB 9.1 m od e natively. Until then, here are som e w orkarou nd s u sing Sap era LT. N otice, to su p p ort this p ixel form at in m em ory, the bu ffer m u st be set to RGB 24-bit p acked . All Sap era d em o and exam p le p rogram s extract the create acqu isition bu ffer typ e from the associated cam era configu ration files. Until there is native su p p ort for RGB 9.1 m od e, fram e grabbers m u st be configu red as m onochrom e, the CCF files p ixel form at can‘t be u sed by the p rogram s to p rocess the im age correctly. A simple workaround accomplishes this 1) Acqu ire as if the P4 cam era w as a 8-bit m ono, 24,576 (4096 x 3) p ixels linescan cam era 2) Treat acqu ired bu ffer as Sap Form atRGBR888 (24bit/ p ixel). Sap era LT p ro vid es a featu re to share bu ffer com p onents betw een tw o Sap Bu ffer objects. Bu ffer typ e m ay be d ifferent betw een the tw o Sap Bu ffer objects. This can be a trick to convert bu ffer form at w ithou t bu ffer cop y. Acqu iring the above d ata as you w ou ld an 8-bit m ono cam era in 10-tap m od e creates the acqu isition bu ffer show n below . Teledyne DALSA 03-032-20180-00 108 Piranha4 4K Camera Color User's Manual Adr+0 Red1 Adr+1 Green1 Adr+2 Blue1 Adr+3 Red2 Adr+4 Green2 Adr+5 Blue2 Adr+6 Red3 Adr+7 Green3 Adr+8 Blue3 Adr+9 Red4 First CLK Adr+10 Green4 Adr+11 Blue4 Second CLK On the other hand , the Sap Form atRGBR888 form at is show n below . Red1 Pixe1 (3byte) Green1 Blue1 Red2 Pixel2 Green2 Blue2 Red3 Pixel3 Green3 Blue3 Red4 Pixel4 Green4 Blue4 As you d em onstrated above, the tw o bu ffers‘ content and their ord er are exactly sam e. Thu s, acqu iring the bu ffer as if the cam era w ere a m ono 8-bit 10-tap resu lts in the sam e bu ffer contents as the Sap Form atRGBR888. Sample Code / / Assu m ing acqu isition bu ffer is d eclared as below . #d efine N UMBUFFERS 10 Sap Bu ffer *m _Bu ffers; m _Bu ffers = new Sap Bu fferWithTrash(N UMBUFFERS, m _Acq); / / Call Create() for acqu isition bu ffer m _Bu ffers->Create(); / / Declare Sap Bu ffer object w hich shares bu ffer com p onents w ith the acqu isition bu ffer Sap Bu ffer *m _View Bu ffers; int w id th, height, i; void * p Data[N UMBUFFERS]; for (i=0; i<N UMBUFFERS; i++) { m _Bu ffers->GetAd d ress(i, &p Data[i]); } w id th = m _Bu ffers->GetWid th(); height = m _Bu ffers->GetH eight(); m _View Bu ffers = new Sap Bu ffer(N UMBUFFERS, p Data, w id th / 3, height,Sap Form atRGB888); m _View Bu ffers->Create(); If you d eclare above m _View Bu ffer as the sou rce bu ffer of Sap View object, you can d isp lay RGB im age w ithou t any ad d itional p rocessing. Programming Full Mode The RGB 6.2 Fu ll m od e u tilizes Cam era Link 8-tap , 8-bit m od e to achieve RGB form atting. Below is the Cam era Link p ort assignm ent of Fu ll m od e. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 109 Line Valid CL Clock CL Port A Red 1 D0..D7 Blue 3 D0..D7 Green 6 D0..D7 Red 9 D0..D7 Green 4092 D0..D7 Red 4095 D0..D7 CL Port B Green 1 D0..D7 Red 4 D0..D7 Blue 6 D0..D7 Green 9 D0..D7 Blue 4092 D0..D7 Green 4095 D0..D7 CL Port C Blue 1 D0..D7 Green 4 D0..D7 Red 7 D0..D7 Blue 9 D0..D7 Red 4093 D0..D7 Blue 4095 D0..D7 CL Port D Red 2 D0..D7 Blue 4 D0..D7 Green 7 D0..D7 Red 10 D0..D7 Green 4093 D0..D7 Red 4096 D0..D7 CL Port E Green 2 D0..D7 Red 5 D0..D7 Blue 7 D0..D7 Green 10 D0..D7 Blue 4093 D0..D7 Green 4096 D0..D7 CL Port F Blue 2 D0..D7 Green 5 D0..D7 Red 8 D0..D7 Blue 10 D0..D7 Red 4094 D0..D7 Blue 4096 D0..D7 CL Port G Red 3 D0..D7 Blue 5 D0..D7 Green 8 D0..D7 Red 11 D0..D7 Green 4094 D0..D7 CL Port H Green 3 D0..D7 Red 6 D0..D7 Blue 8 D0..D7 Green 11 D0..D7 Blue 4094 D0..D7 This tap arrangem ent allow s all fram e grabbers w ith 8-tap , 8-bit to grab im ages w ithou t requ iring ad d itional m od ifications. H ow ever, in ord er to correctly form at the im age for p rocessing and d isp lay p u rp oses, fram e grabbers need to su p p ort RGB 6.2 m od e natively. Until then, here are som e w orkarou nd s u sing Sap era LT. N otice, to su p p ort this p ixel form at in m em ory, the bu ffer m u st be set to RGB 24-bit p acked . All Sap era d em o and exam p le p rogram s extract the create acqu isition bu ffer typ e from the associated cam era configu ration files. Until there is native su p p ort for RGB 6.2 m od e, fram e grabbers m u st be configu red as m onochrom e, the CCF files p ixel form at can‘t be u sed by the p rogram s to p rocess the im age correctly. A simple workaround accomplishes this 1) Acqu ire as if the P4 cam era w as a 8-bit m ono, 24,576 (4096 x 3) p ixels linescan cam era 2) Treat acqu ired bu ffer as Sap Form atRGBR888 (24bit/ p ixel). Sap era LT p rovid es a featu re to share bu ffer com p onents betw een tw o Sap Bu ffer objects. Bu ffer typ e m ay be d ifferent betw een the tw o Sap Bu ffer objects. This can be a trick to convert bu ffer form at w ithou t bu ffer cop y. Acqu iring the above d ata as you w ou ld an 8-bit m ono cam era in 8-tap m od e creates the acqu isition bu ffer show n below . Teledyne DALSA 03-032-20180-00 110 Piranha4 4K Camera Color User's Manual Adr+0 Red1 Adr+1 Green1 Adr+2 Blue1 Adr+3 Red2 Adr+4 Green2 Adr+5 Blue2 Adr+6 Red3 First CLK Adr+7 Green3 Adr+8 Blue3 Adr+9 Red4 Adr+10 Green4 Adr+11 Blue4 Second CLK On the other hand , the Sap Form atRGBR888 form at is show n below . Pixe1 (3byte) Pixel2 Pixel3 Pixel4 Red1 Green1 Blue1 Red2 Green2 Blue2 Red3 Green3 Blue3 Red4 Green4 Blue4 As you d em onstrated above, the tw o bu ffers‘ content and their ord er are exactly sam e. Thu s, acqu iring the bu ffer as if the cam era w ere a m ono 8-bit 8-tap resu lts in the sam e bu ffer contents as the Sap Form atRGBR888. Sample Code / / Assu m ing acqu isition bu ffer is d eclared as below . #d efine N UMBUFFERS 8 Sap Bu ffer *m _Bu ffers; m _Bu ffers = new Sap Bu fferWithTrash(N UMBUFFERS, m _Acq); / / Call Create() for acqu isition bu ffer m _Bu ffers->Create(); / / Declare Sap Bu ffer object w hich shares bu ffer com p onents w ith the acqu isition bu ffer Sap Bu ffer *m _View Bu ffers; int w id th, height, i; void * p Data[N UMBUFFERS]; for (i=0; i<N UMBUFFERS; i++) { m _Bu ffers->GetAd d ress(i, &p Data[i]); } w id th = m _Bu ffers->GetWid th(); height = m _Bu ffers->GetH eight(); m _View Bu ffers = new Sap Bu ffer(N UMBUFFERS, p Data, w id th / 3, height,Sap Form atRGB888); m _View Bu ffers->Create(); If you d eclare above m _View Bu ffer as the sou rce bu ffer of Sap View object, you can d isp lay RGB i m age w ithou t any ad d itional p rocessing. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 111 Appendix F: Camera, Frame Grabber Communication Setting Up Communication between the Camera and the Frame Grabber Teled yne DALSA Cam era Link cam eras su p p ort the GenCP Cam era Link stand ard s. To configu re Teled yn e DALSA GenCP Cam era Link Cam eras: 1. Install the Teled yne DALSA fram e grabber in the host com p u ter; refer to the hard w are installation m anu al. 2. Install Sap era LT and the Teled yne DALSA fram e grabber d river. 3. Connect the cam era to the fram e grabber; refer to the cam era installation m anu al. 4. Pow er u p the cam era and w ait u ntil the statu s LED is solid green. 5. Ru n the Sap era Configu ration u tility and select the fram e grabber serial p ort connected to the cam era. Set Teledyne D ALSA camera detection to Automatic D etection and Baudrate to Auto D etect & Maximize. 6. If the cam era w ill be configu red u sing three-letter text com m and s via a term inal p rogram , su ch as H yp erTerm inal, then set COM port mapping (optional) to an available COM p ort (e.g. COM2). Teledyne DALSA 03-032-20180-00 112 Piranha4 4K Camera Color User's Manual 7. Start the Cam Exp ert ap p lication. In the D evice tab, select CameraLink Medium Color RGB #1. 8. Mod ify the cam era and fram e grabber p aram eter settings as requ ired . At p resent, w hen u sing GenCP cam eras, the cam era and fram e grabber p aram eters m u st be ad ju sted sep arately. Test the im age acqu isition by clicking the Grab bu tton. 9. Save the fram e grabber configu ration to a new *.ccf file. 03-032-20180-00 Teledyne DALSA Piranha4 4K Color Camera User's Manual 113 EMC Declaration The CE Mark Evalu ation of the Teled yne DALSA P4-CC-04K07T-00-R Cam eras, w hich are m anu factu red by Teled yne DALSA Inc., m eets the follow ing requ irem ents: Standard Test Description EN 55011, FCC Part 15, CISPR 11, and ICES-003 Rad iated em issions requ irem ents. EN 61326-1 and EN 55024 Im m u nity to d istu rbances. Changes or m od ifications not exp ressly ap p roved by Teled yne DALSA cou ld void the u ser's au thority to op erate the equ ip m ent. N ame and Signature of authorized person Teledyne DALSA 03-032-20180-00 114 Piranha4 4K Camera Color User's Manual Revision History Revision 00 03-032-20180-00 Change Description Release of the initial m anual revision. Date 17 April 2013 Teledyne DALSA Piranha4 4K Color Camera User's Manual 115 Index set, 50 EXSYN C, 31 B baud rate, 51 black level control, 50 C calibration, 53 flat field, 55 process chain, 53 cam era control signals, 24 cam era inform ation, 38 cam era interfacing tool, 34 Cam era Link cables, 30 input signals, 30 outputs, 31 Cam era Link connector, 23 Cam Expert, 35 certifications, 9 cleaning sensor window, 105 clock signals, 31 com pliance, 9 connectors, 22 Camera Link, 23 power, 31 D d ata bus, 31 d irection sensor shift, 15 web movement, 15 d irection control, 52 F factory settings, 38 filters, 10, 18 G Gain control, 50 ground ing instructions, 22 GUI CamExpert, 35 overview, 33 H heat sinks, 18 I im age acquisition, 42 input/ outp ut, 22 interface mechanical, 8 L LED definitions, 32 M m echanical camera, 16 specifications, 8 m od els, 8 E EMC Declaration of Conform ity, 113 exposure control, 42 external frame rate, programmable exposure time, 44 externally controlled, 44 internally controlled, 44 exposure m od es descriptions of, 42 exposure tim e Teledyne DALSA P perform ance specifications, 8 pixel form at, 51 pow er connector, 31 connectors, 31 guidelines, 32 pinout, 31 precautions, 6 03-032-20180-00 116 Piranha4 4K Camera Color User's Manual Q saving, 39 user, 41 setup overview, 20 shift d irection, 15 size image, 50 softw are required, 8 specifications mechanical, 8 performance, 8 quantum efficiency graph, 10 R rebooting, 52 requirem ents PC, 20 responsivity graph, 10 revision history, 114 S safety, 6 Sapera, 34 sensor controls, 62, 70, 80 settings current, 41 default, 42 factory, 38, 42 loading, 39 03-032-20180-00 T tem perature verify, 39 test patterns, 37 trigger m od es, 42 V voltage verify, 39 Teledyne DALSA