BLACKFLY GigE Vision FLIR TECHNICAL REFERENCE. Version 14.0 Revised 1/26/2017

Transcription

1 TECHNICAL REFERENCE FLIR BLACKFLY GigE Vision Version 14.0 Revised 1/26/2017 Copyright Solutions Inc. All rights reserved.

2 FCC Compliance This device complies with Part 15 of the FCC rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesirable operation. Korean EMC Certification The KCC symbol indicates that this product complies with Korea s Electrical Communication Basic Law regarding EMC testing for electromagnetic interference (EMI) and susceptibility (EMS). Hardware Warranty The warranty for the Blackfly PGE camera is 3 years. For detailed information on how to repair or replace your camera, please see the terms and conditions on our website. WEEE The symbol indicates that this product may not be treated as household waste. Please ensure this product is properly disposed as inappropriate waste handling of this product may cause potential hazards to the environment and human health. For more detailed information about recycling of this product, please contact us. Trademarks Names and marks appearing on the products herein are either registered trademarks or trademarks of FLIR Systems, Inc. and/or its subsidiaries. Licensing To view the licenses of open source packages used in this product please see What open source packages does firmware use? Blackfly PGE Technical Reference

3 Table of Contents About This Manual i 1 Blackfly PGE Specifications BFLY-PGE-03S2 Specifications BFLY-PGE-03S3 Specifications BFLY-PGE-05S2 Specifications BFLY-PGE-09S2 Specifications BFLY-PGE-12A2 Specifications BFLY-PGE-13E4 Specifications BFLY-PGE-13H2 Specifications BFLY-PGE-13S2 Specifications BFLY-PGE-14S2 Specifications BFLY-PGE-20E4 Specifications BFLY-PGE-23S2 Specifications BFLY-PGE-23S6 Specifications BFLY-PGE-31S4 Specifications BFLY-PGE-50A2 Specifications BFLY-PGE-50H5 Specifications BFLY-PGE-50S5 Specifications Analog-to-Digital Converter (ADC) 17 2 Blackfly PGE Installation Before You Install Will your system configuration support the camera? Do you have all the parts you need? Do you have a downloads account? Installing Your Interface Card and Software Installing Your Camera Configuring Camera Setup Configuring Camera Drivers Configuring the IP Address Allocating Bandwidth Packet Size Packet Delay Determining Bandwidth Requirements 26 Blackfly PGE Technical Reference

4 2.4.4 Configuring Other Network Settings Stream Channel Destination Address Heartbeat 28 3 Tools to Control the Blackfly PGE Using FlyCapture FlyCap Program Custom Applications Built with the FlyCapture API Using GenICam Applications Using GigE Vision Bootstrap Registers Using Control and Status Registers 31 4 Blackfly PGE Physical Interface Blackfly PGE Physical Description Blackfly PGE Dimensions Mounting with the Case or Mounting Bracket Lens Mounting Back Flange Distance Handling Precautions and Camera Care Case Temperature and Heat Dissipation Dust Protection Infrared Cut-Off Filters Camera Interface and Connectors Ethernet Connector Interface Cables Interface Card General Purpose Input/Output (GPIO) 41 5 General Blackfly PGE Operation Powering the Camera User Sets (Memory Channels) GenICam User Set Control On-Camera Frame Buffer Non-Volatile Flash Memory Camera Firmware Determining Firmware Version Upgrading Camera Firmware 45 6 Input/Output Control 46 Blackfly PGE Technical Reference

5 6.1 General Purpose Input/Output (GPIO) GenICam Digital Input/Output Control Strobe Signal Delay Programmable Strobe Output Debouncer GPIO Electrical Characteristics Output Timing Characteristics Input Timing Characteristics 54 7 Image Acquisition Asynchronous Triggering GenICam Acquisition Control Standard External Trigger (Mode 0) Bulb Shutter Trigger (Mode 1) Low Smear Trigger (Mode 13) Overlapped Exposure Readout Trigger (Mode 14) Multi-Shot Trigger (Mode 15) External Trigger Timing Maximum Frame Rate in External Trigger Mode Camera Behavior Between Triggers Changing Video Modes While Triggering Asynchronous Software Triggering 66 8 Blackfly PGE Attributes Pixel Formats Raw Mono RGB YUV Video Modes Overview Blackfly PGE Video Mode Descriptions GenICam Image Format Control Frame Rates Blackfly PGE Frame Rates in Mode Readout Method (Shutter Type) Global Shutter Rolling Shutter 80 Blackfly PGE Technical Reference

6 8.5.3 Rolling Shutter with Global Reset Overview of Imaging Parameters GenICam Analog Control Brightness Exposure Time Gain Auto Exposure Sharpness Gamma and Lookup Table High Dynamic Range (HDR) Imaging Image Flip/Mirror Embedded Image Information White Balance Bayer Color Processing Hue Saturation 94 9 Troubleshooting Downloads and Support Finding Information Contacting Technical Support Camera Diagnostics Status Indicator LED Test Pattern Blemish Pixel Artifacts Pixel Defect Correction Vertical Smear Artifact Smear Reduction Rolling Shutter Artifacts 100 A FlyCapture API Code Samples 101 A.1 Setting a GPIO Pin to Strobe Using the FlyCapture API 101 A.2 Setting a Standard Video Mode, Format and Frame Rate Using the FlyCapture API 101 A.3 Asynchronous Hardware Triggering Using the FlyCapture API 101 A.4 Setting Brightness Using the FlyCapture API 102 A.5 Setting Shutter Using the FlyCapture API 102 A.6 Setting Gain Using the FlyCapture API 103 Blackfly PGE Technical Reference

7 A.7 Setting Auto Exposure Using the FlyCapture API 103 A.8 Setting Sharpness Using the FlyCapture API 104 A.9 Setting Gamma Using the FlyCapture API 104 A.10 Setting White Balance Using the FlyCapture API 105 A.11 Accessing Raw Bayer Data using FlyCapture 106 A.12 Setting Hue Using the FlyCapture API 106 A.13 Setting Saturation Using the FlyCapture API 106 B FlyCapture SDK Examples 108 B.1 AsyncTriggerEx 108 B.2 BusEventsEx 108 B.3 CustomImageEx 108 B.4 ExtendedShutterEx 109 B.5 FlyCap2CameraControl 109 B.6 FlyCap2_GTKmm 109 B.7 FlyCap2MFC 110 B.8 FlyCapture2GUI 110 B.9 FlyCapture2SimpleGUI_WPF 110 B.10 FlyCapture2Test 110 B.11 GigEGrabEx 111 B.12 GrabCallbackEx 111 B.13 HighDynamicRangeEx 111 B.14 ImageEventEx 111 B.15 MultipleCameraEx 113 B.16 MultipleCameraWriteToDiskEx 113 B.17 MultiSyncEx 113 B.18 SaveImageToAviEx 114 B.19 SaveImageToFlashEx 114 B.20 SerialPortEx 114 C GenICam Features 116 C.1 Device Control 116 C.2 Analog Control 117 C.3 Image Format Control 118 C.4 Acquisition Control 119 C.5 Digital Input Output Control 121 C.6 Transport Layer Control 122 Blackfly PGE Technical Reference

8 C.7 User Set Control 126 C.8 Chunk Data Control 126 C.9 LUT Control 127 D GigE Vision Bootstrap Registers 128 E Control and Status Registers 130 E.1 IMAGE_RETRANSMIT: 634h 130 E.2 DATA_FLASH_CTRL: 1240h 131 E.3 DATA_FLASH_DATA: 1244h 131 E.4 GPIO_XTRA: 1104h 131 E.5 OUTPUT_VOLTAGE_ENABLE: 19D0h 132 E.6 AE_ROI: 1A70 1A74h 132 E.7 FRAME_INFO: 12F8h 133 E.8 INITIALIZE: 000h 134 E.9 TEMPERATURE: 82Ch 134 E.10 VMODE_ERROR_STATUS: 628h 134 E.11 CAMERA_LOG: 1D00 1DFFh 134 E.12 LED_CTRL: 1A14h 135 E.13 PIXEL_DEFECT_CTRL: 1A60h 135 Blackfly PGE Technical Reference

9 About This Manual About This Manual This manual provides the user with a detailed specification of the Blackfly PGE camera system. The user should be aware that the camera system is complex and dynamic if any errors or omissions are found during experimentation, please contact us. This document is subject to change without notice. Note: All model-specific information presented in this manual reflects functionality available in the model's firmware version. For more information see Camera Firmware. Where to Find Information Chapter Blackfly PGE Specifications Blackfly PGE Installation Tools to Control the Blackfly PGE Blackfly PGE Physical Interface General Blackfly PGE Operation Input/Output Control Image Acquisition Blackfly PGE Attributes Troubleshooting Appendix: FlyCapture API Code Samples Appendix: FlyCapture SDK Examples Appendix: GenICam Features Appendix: GigE Vision Bootstrap Registers Appendix: Control and Status Registers What You Will Find General camera specifications and specific model specifications, and camera properties. Instructions for installing the Blackfly PGE, as well as introduction to Blackfly PGE configuration. Information on the tools available for controlling the Blackfly PGE. Information on the mechanical properties of the Blackfly PGE. Information on powering the Blackfly PGE, monitoring status, user configuration sets, memory controls, and firmware. Information on input/output modes and controls. Information on asynchronous triggering and supported trigger modes. Information on supported imaging parameters and their controls. Information on how to get support, diagnostics for the Blackfly PGE, and common sensor artifacts. Examples of FlyCapture API code. Sample programs provided with the FlyCapture SDK. Information on GenICam Feature controls. Information on GigE Vision Bootstrap Registers. Information on IIDC Control and Status Registers for functions not handled via GenICam. Blackfly PGE Technical Reference i

10 About This Manual Document Conventions This manual uses the following to provide you with additional information: Note: A note that contains information that is distinct from the main body of text. For example, drawing attention to a difference between models; or a reminder of a limitation. Warning! A note that contains a warning to proceed with caution and care, or to indicate that the information is meant for an advanced user. For example, indicating that an action may void the camera's warranty or cause damage to the camera or other equipment. Code is presented in a grey box with Courier font. If further information can be found in our Knowledge Base, a list of articles is provided. Related Knowledge Base Articles Title Article Title of the Article Link to the article on the website If there are further resources available, a link is provided either to an external website, or to the SDK. Related Resources Title Title of the resource Link to the resource Link Contacting Us For any questions, concerns or comments please contact us via the following methods: Knowledge Base General questions Technical support (existing customers only) Find answers to commonly asked questions in our Knowledge Base Downloads Download the latest documents and software Contact Information Contact Us on our website Blackfly PGE Technical Reference ii

11 About This Manual Revision History Revision Date Notes 1.0 December 13, 2012 Initial Version with support for model BFLY-PGE-13E4 2.0 March 14, 2013 Support for models BFLY-PGE-05S2 and BFLY-PGE-09S2 Added GPIO circuit diagrams 3.0 April 29, 2013 Support for models BFLY-PGE-14S2 and BFLY-PGE-23S2 3.1 May 7, 2013 Updated GPIO pin drawing 4.0 July 3, 2013 Support for model BFLY-PGE-13S2 5.0 November 13, 2013 Support for model BFLY-PGE-50A2 6.0 November 18, 2013 Support for model BFLY-PGE-20E4 7.0 December 17, 2013 Support for model BFLY-PGE-12A2 8.0 February 5, 2014 Support for model BFLY-PGE-03S2 8.1 June 6, 2014 Fixed firmware update section error 9.0 August 13, 2014 Support for model BFLY-PGE-03S November 24, 2014 Support for model BFLY-PGE-23S January 30, 2015 Support for BFLY-PGE-50H October 6, February 12, 2016 Support for BFLY-PGE-13H2 Added Strobe Signal Delay Added information on switching readout method Added User Defined Value feature Added Remove Parameter Limits feature Minor bug fixes 13.1 February 15, 2015 Updated revision history January 26, 2017 Revised framerates for BFLY-PGE-50A2 Support for BFLY-PGE-31S4, BFLY-PGE-50S5 Clarification of global reset and trigger mode Support for all pixels/any pixels strobe mode for global reset New template Minor bug fixes Blackfly PGE Technical Reference iii

12 1 Blackfly PGE Specifications 1 Blackfly PGE Specifications 1.1 BFLY-PGE-03S2 Specifications BFLY-PGE-03S2M-CS BFLY-PGE-03S2C-CS Firmware Resolution 648 x x 488 Frame Rate 84 FPS 84 FPS Megapixels 0.3 MP 0.3 MP Chroma Mono Color Sensor Sony ICX424, CCD, 1/3" Sony ICX424, CCD, 1/3" Readout Method Global shutter Global shutter Pixel Size 7.4 µm 7.4 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range db to db db to db Exposure Range 0.03 ms to 32 seconds 0.03 ms to 32 seconds Trigger Modes Standard, bulb, low smear, overlapped, multi-shot Standard, bulb, low smear, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 1

13 1 Blackfly PGE Specifications 1.2 BFLY-PGE-03S3 Specifications BFLY-PGE-03S3M-CS BFLY-PGE-03S3C-CS Firmware Resolution 648 x x 648 Frame Rate 90 FPS 90 FPS Megapixels 0.3 MP 0.3 MP Chroma Mono Color Sensor Sony ICX414, CCD, 1/2" Sony ICX414, CCD, 1/2" Readout Method Global shutter Global shutter Pixel Size 9.9 µm 9.9 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range db to db db to db Exposure Range ms to 32 seconds ms to 32 seconds Trigger Modes Standard, bulb, low smear, overlapped, multi-shot Standard, bulb, low smear, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 2

14 1 Blackfly PGE Specifications 1.3 BFLY-PGE-05S2 Specifications BFLY-PGE-05S2M-CS BFLY-PGE-05S2C-CS Firmware Resolution 808 x x 608 Frame Rate 50 FPS 50 FPS Megapixels 0.5 MP 0.5 MP Chroma Mono Color Sensor Sony ICX693, CCD, 1/3" Sony ICX693, CCD, 1/3" Readout Method Global shutter Global shutter Pixel Size 6.0 µm 6.0 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range 0 db to db 0 db to db Exposure Range ms to 32 seconds ms to 32 seconds Trigger Modes Standard, bulb, low smear, overlapped, multi-shot Standard, bulb, low smear, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 3

15 1 Blackfly PGE Specifications 1.4 BFLY-PGE-09S2 Specifications BFLY-PGE-09S2M-CS BFLY-PGE-09S2C-CS Firmware Resolution 1288 x x 728 Frame Rate 30 FPS 30 FPS Megapixels 0.9 MP 0.9 MP Chroma Mono Color Sensor Sony ICX692, CCD, 1/3" Sony ICX692, CCD, 1/3" Readout Method Global shutter Global shutter Pixel Size 4.08 µm 4.08 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range -4.5 db to 24 db -4.5 db to 24 db Exposure Range ms to 32 seconds ms to 32 seconds Trigger Modes Standard, bulb, low smear, overlapped, multi-shot Standard, bulb, low smear, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 4

16 1 Blackfly PGE Specifications 1.5 BFLY-PGE-12A2 Specifications BFLY-PGE-12A2M-CS BFLY-PGE-12A2C-CS Firmware Resolution 1280 x x 960 Frame Rate 52 FPS 52 FPS Megapixels 1.2 MP 1.2 MP Chroma Mono Color Sensor Aptina AR0134, CMOS, 1/3" Aptina AR0134, CMOS, 1/3" Readout Method Global shutter Global shutter Pixel Size 3.75 µm 3.75 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range db to 13 db db to 13 db Exposure Range ms to seconds ms to seconds Trigger Modes Standard, multi-shot Standard, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 5

17 1 Blackfly PGE Specifications 1.6 BFLY-PGE-13E4 Specifications BFLY-PGE-13E4M-CS BFLY-PGE-13E4C-CS Firmware Resolution 1280 x x 1024 Frame Rate 60 FPS 60 FPS Megapixels 1.3 MP 1.3 MP Chroma Mono Color Sensor e2v EV76C560, CMOS, 1/1.8" e2v EV76C560, CMOS, 1/1.8" Readout Method Global shutter Global shutter Pixel Size 5.3 µm 5.3 µm Lens Mount CS-mount CS-mount ADC 10-bit 10-bit Gain Range 0 db to 24 db 0 db to 24 db Exposure Range ms to 1 second ms to 1 second Trigger Modes Standard, multi-shot Standard, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 6

18 1 Blackfly PGE Specifications 1.7 BFLY-PGE-13H2 Specifications BFLY-PGE-13H2M-CS BFLY-PGE-13H2C-CS Firmware Resolution 1288 x x 964 Frame Rate 30 FPS 30 FPS Megapixels 1.3 MP 1.3 MP Chroma Mono Color Sensor Sharp RJ33J4CA3DE, CCD, 1/3" Sharp RJ33J3CA3DE, CCD, 1/3" Readout Method Global shutter Global shutter Pixel Size 3.75 µm 3.75 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range db to 24 db db to 24 db Exposure Range ms to 32 seconds ms to 32 seconds Trigger Modes Standard, bulb, low smear, overlapped, multi-shot Standard, bulb, low smear, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum maximum 2.5 W maximum maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 g 29 mm x 29 mm x 30 mm/36 g Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 7

19 1 Blackfly PGE Specifications 1.8 BFLY-PGE-13S2 Specifications BFLY-PGE-13S2M-CS BFLY-PGE-13S2C-CS Firmware Resolution 1288 x x 964 Frame Rate 30 FPS 30 FPS Megapixels 1.3 MP 1.3 MP Chroma Mono Color Sensor Sony ICX445, CCD, 1/3" Sony ICX445, CCD, 1/3" Readout Method Global shutter Global shutter Pixel Size 3.75 µm 3.75 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range -11 db to db -11 db to db Exposure Range ms to seconds ms to seconds Trigger Modes Standard, bulb, low smear, overlapped, multi-shot Standard, bulb, low smear, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm /36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 8

20 1 Blackfly PGE Specifications 1.9 BFLY-PGE-14S2 Specifications BFLY-PGE-14S2C-CS Firmware Resolution 1296 x 1032 Frame Rate Megapixels Chroma Readout Method 60 FPS 1.3 MP Color Sensor Sony IMX104, CMOS, 1/3" Rolling shutter Pixel Size 3.75 µm Lens Mount ADC Gain Range Exposure Range Trigger Modes Partial Image Modes Image Processing HDR Sequencing Image Buffer User Sets Flash Memory Opto-isolated I/O Ports Auxiliary Output Interface Power Requirements Power Consumption Dimensions/Mass CS-mount 12-bit -1.5 db to 40.5 db ms to 32 seconds Standard, bulb, multi-shot Pixel binning, decimation, ROI Gamma, lookup table, hue, saturation, and sharpness Not supported 16 MB 2 user configuration sets for custom camera settings 512 KB non-volatile memory 1 input, 1 output 3.3 V, 120 ma maximum GigE PoE 12 V nominal (5-16 V) via GPIO interface 2.5 W maximum 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard GigE Vision v1.2 Compliance Temperature Humidity Warranty CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) 3 years Blackfly PGE Technical Reference 9

21 1 Blackfly PGE Specifications 1.10 BFLY-PGE-20E4 Specifications BFLY-PGE-20E4M-CS BFLY-PGE-20E4C-CS Firmware Resolution 1600 x x 1200 Frame Rate 50 FPS 50 FPS Megapixels 2.0 MP 2.0 MP Chroma Mono Color Sensor e2v EV76C570, CMOS, 1/1.8" e2v EV76C570, CMOS, 1/1.8" Readout Method Global shutter Global shutter Pixel Size 4.5 µm 4.5 µm Lens Mount CS-mount CS-mount ADC 10-bit 10-bit Gain Range 0 to 24 db 0 to 24 db Exposure Range ms to 1 second ms to 1 second Trigger Modes Standard, multi-shot Standard, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 10

22 1 Blackfly PGE Specifications 1.11 BFLY-PGE-23S2 Specifications BFLY-PGE-23S2C-CS Firmware Resolution 1920 x 1200 Frame Rate Megapixels Chroma Readout Method 27 FPS 2.3 MP Color Sensor Sony IMX136, CMOS, 1/2.8" Rolling shutter Pixel Size 2.8 µm Lens Mount ADC Gain Range Exposure Range Trigger Modes Partial Image Modes Image Processing HDR Sequencing Image Buffer User Sets Flash Memory Opto-isolated I/O Ports Auxiliary Output Interface Power Requirements Power Consumption Dimensions/Mass CS-mount 12-bit 0 db to 42 db, increment 0.1 db 0.03 ms to 32 seconds Standard, bulb, multi-shot Pixel binning, decimation, ROI Gamma, lookup table, hue, saturation, and sharpness Not supported 16 MB 2 user configuration sets for custom camera settings 512 KB non-volatile memory 1 input, 1 output 3.3 V, 120 ma maximum GigE PoE 12 V nominal (5-16 V) via GPIO interface 2.5 W maximum 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard GigE Vision v1.2 Compliance Temperature Humidity Warranty CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) 3 years Blackfly PGE Technical Reference 11

23 1 Blackfly PGE Specifications 1.12 BFLY-PGE-23S6 Specifications BFLY-PGE-23S6M-C BFLY-PGE-23S6C-C Firmware Resolution 1920 x x 1200 Frame Rate 41 FPS 41 FPS Megapixels 2.3 MP 2.3 MP Chroma Mono Color Sensor Sony IMX249, CMOS, 1/1.2" Sony IMX249, CMOS, 1/1.2" Readout Method Global shutter Global shutter Pixel Size 5.86 µm 5.86 µm Lens Mount C-mount C-mount ADC 10-bit / 12-bit in Mode 7 10-bit / 12-bit in Mode 7 Gain Range 0 db to db 0 db to db Exposure Range ms to 32 seconds ms to 32 seconds Trigger Modes Standard, bulb, overlapped, multi-shot Standard, bulb, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing 4 x exposure, 4 x gain 4 x exposure, 4 x gain Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 12

24 1 Blackfly PGE Specifications 1.13 BFLY-PGE-31S4 Specifications BFLY-PGE-31S4M-C BFLY-PGE-31S4C-C Firmware Resolution 2048 x x 1536 Frame Rate 35 FPS 35 FPS Megapixels 3.2 MP 3.2 MP Chroma Mono Color Sensor Sony IMX265, CMOS, 1/1.8" Sony IMX265, CMOS, 1/1.8" Readout Method Global shutter Global shutter Pixel Size 3.45 µm 3.45 µm Lens Mount C-mount C-mount ADC 12-bit / No mode 7 12-bit / No mode 7 Gain Range 0 db to db 0 db to db Exposure Range ms to 11.9 seconds ms to 11.9 seconds Trigger Modes Standard, bulb, overlapped, multi-shot Standard, bulb, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing 4 x exposure, 4 x gain 4 x exposure, 4 x gain Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 g 29 mm x 29 mm x 30 mm/36 g Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 13

25 1 Blackfly PGE Specifications 1.14 BFLY-PGE-50A2 Specifications BFLY-PGE-50A2M-CS BFLY-PGE-50A2C-CS Firmware Resolution 2592 x x 1944 Frame Rate 13 FPS 13 FPS Megapixels 5.0 MP 5.0 MP Chroma Mono Color Sensor Aptina MT9P031, CMOS, 1/2.5" Aptina MT9P006, CMOS, 1/2.5" Readout Method Rolling Shutter with Global Reset Rolling Shutter with Global Reset Pixel Size 2.2 µm 2.2 µm Lens Mount CS-mount CS-mount ADC 12-bit 12-bit Gain Range 0 db to 18 db 0 db to 18 db Exposure Range ms to 32 seconds ms to 32 seconds Trigger Modes Standard, bulb, multi-shot Standard, bulb, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 14

26 1 Blackfly PGE Specifications 1.15 BFLY-PGE-50H5 Specifications BFLY-PGE-50H5M-C BFLY-PGE-50H5C-C Firmware Resolution 2448 x x 2048 Frame Rate 7.5 FPS 7.5 FPS Megapixels 5.0 MP 5.0 MP Chroma Mono Color Sensor Sharp RJ32S4AA0DT, CCD, 2/3" Sharp RJ32S3AA0DT, CCD, 2/3" Readout Method Global shutter Global shutter Pixel Size 3.45 µm 3.45 µm Lens Mount C-mount C-mount ADC 12-bit 12-bit Gain Range db to db db to db Exposure Range ms to 31.9 seconds ms to 31.9 seconds Trigger Modes Standard, bulb, low smear, overlapped, multi-shot Standard, bulb, low smear, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing Not supported Not supported Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 grams 29 mm x 29 mm x 30 mm/36 grams Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 15

27 1 Blackfly PGE Specifications 1.16 BFLY-PGE-50S5 Specifications BFLY-PGE-50S5M-C BFLY-PGE-50S5C-C Firmware Resolution 2448 x x 2048 Frame Rate 22 FPS 22 FPS Megapixels 5.0 MP 5.0 MP Chroma Mono Color Sensor Sony IMX264, CMOS, 2/3" Sony IMX264, CMOS, 2/3" Readout Method Global shutter Global shutter Pixel Size 3.45 µm 3.45 µm Lens Mount C-mount C-mount ADC 12-bit 12-bit Gain Range 0 db to 48 db 0 db to 48 db Exposure Range ms to seconds ms to seconds Trigger Modes Standard, bulb, overlapped, multi-shot Standard, bulb, overlapped, multi-shot Partial Image Modes Pixel binning, decimation, ROI Pixel binning, decimation, ROI Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness HDR Sequencing 4 x exposure, 4 x gain 4 x exposure, 4 x gain Image Buffer 16 MB 16 MB User Sets 2 user configuration sets for custom camera settings 2 user configuration sets for custom camera settings Flash Memory 512 KB non-volatile memory 512 KB non-volatile memory Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output Auxiliary Output 3.3 V, 120 ma maximum 3.3 V, 120 ma maximum Interface GigE PoE GigE PoE Power Requirements 12 V nominal (5-16 V) via GPIO interface 12 V nominal (5-16 V) via GPIO interface Power Consumption 2.5 W maximum 2.5 W maximum Dimensions/Mass 29 mm x 29 mm x 30 mm/36 g 29 mm x 29 mm x 30 mm/36 g Machine Vision Standard Compliance Temperature Humidity GigE Vision v1.2 GigE Vision v1.2 CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) CE, FCC, KCC, RoHS. The ECCN for this product is: EAR099. Operating: 0 to 45 C Storage: -30 to 60 C Operating: 20% to 80% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years Blackfly PGE Technical Reference 16

28 1 Blackfly PGE Specifications 1.17 Analog-to-Digital Converter (ADC) All CCD camera sensors incorporate an ADC to digitize the images. All CMOS camera sensors incorporate an on-chip ADC to digitize the images. The Blackfly PGE's ADC is configured to a fixed bit output. If the pixel format selected has fewer bits per pixel than the ADC output, the least significant bits are dropped. If the pixel format selected has greater bits per pixel than the ADC output, the least significant bits are padded and can be discarded by the user. Image data is left-aligned across a 2-byte format. For example, for a 12-bit output, the least significant 4 bits are padded in order to fill 2 bytes. E.g. 0xFFF0. A 10-bit conversion produces 1,024 possible values between 0 and 65,472. A 12-bit conversion produces 4,096 possible values between 0 and 65,520. The following table illustrates the most important aspects of the ADC. Resolution Black Level Clamp Pixel Gain Amplifier Variable Gain Amplifier 12-bit, 50 MHz 0 LSB to LSB, 0.25 LSB steps -3 db to 6 db, 3 db steps 6 db to 42 db, 10-bit The bit depth of the output varies between sensors and can be seen in the table below. Model BFLY-PGE-03S2M-CS BFLY-PGE-03S2C-CS BFLY-PGE-03S3M-CS BFLY-PGE-03S3C-CS BFLY-PGE-05S2M-CS BFLY-PGE-05S2C-CS BFLY-PGE-09S2M-CS BFLY-PGE-09S2C-CS BFLY-PGE-12A2M-CS BFLY-PGE-12A2C-CS BFLY-PGE-13E4M-CS BFLY-PGE-13E4C-CS BFLY-PGE-13H2M-CS BFLY-PGE-13H2C-CS BFLY-PGE-13S2M-CS BFLY-PGE-13S2C-CS BFLY-PGE-14S2C-CS BFLY-PGE-20E4M-CS BFLY-PGE-20E4C-CS BFLY-PGE-23S2C-CS ADC 12-bit 12-bit 12-bit 12-bit 12-bit 12-bit 12-bit 12-bit 12-bit 12-bit 10-bit 10-bit 12-bit 12-bit 12-bit 12-bit 12-bit 10-bit 10-bit 12-bit Blackfly PGE Technical Reference 17

29 1 Blackfly PGE Specifications Model ADC BFLY-PGE-23S6M-C 10-bit (12-bit in Mode 7) BFLY-PGE-23S6C-C 10-bit (12-bit in Mode 7) BFLY-PGE-31S4M-C 12-bit BFLY-PGE-31S4C-C 12-bit BFLY-PGE-50A2M-CS 12-bit BFLY-PGE-50A2C-CS 12-bit BFLY-PGE-50H5M-C 12-bit BFLY-PGE-50H5C-C 12-bit BFLY-PGE-50S5M-C 12-bit BFLY-PGE-50S5C-C 12-bit Blackfly PGE Technical Reference 18

30 2 Blackfly PGE Installation 2 Blackfly PGE Installation 2.1 Before You Install Will your system configuration support the camera? Recommended System Configuration Operating CPU RAM Video Ports Software System Windows, Linux (32- and 64-bit) Intel Core 2 Duo, or equivalent 2 GB RAM 128 MB Ethernet Microsoft Visual Studio 2010 (to compile and run example code) Do you have all the parts you need? To install your camera you will need the following components: Ethernet cable (see Interface Cables) 6-pin GPIO cable (see General Purpose Input/Output (GPIO)) Powered Ethernet switch or Ethernet power injector (if using PoE) CS-mount (or C-mount with adaptor)c-mount Lens (see Lens Mounting ) Tripod adapter (optional) (see Mounting with the Case or Mounting Bracket) Interface card (see Interface Card) FLIR sells a number of the additional parts required for installation. To purchase, visit our Accessories page Do you have a downloads account? Our downloads page has many resources to help you operate your camera effectively, including: Software, including Drivers (required for installation) Firmware updates and release notes Dimensional drawings and CAD models Documentation To access the downloads resources you must have a downloads account. 1. Go to our website: 2. In the upper right corner, click Register. 3. Complete the form, then click Register. After you submit your registration, you will receive an with instructions on how to activate your account. Blackfly PGE Technical Reference 19

31 2 Blackfly PGE Installation 2.2 Installing Your Interface Card and Software 1. Install your Interface Card Ensure the card is installed per the manufacturer's instructions. Connect the internal IDE or SATA power connector on the card to the computer power supply. Alternatively, use your PC's built-in host controller, if equipped. Open the Windows Device Manager. Ensure the card is properly installed under Network Adapters. An exclamation point (!) next to the card indicates the driver has not yet been installed. 2. Install the FlyCapture Software Note: For existing users who already have FlyCapture installed, we recommend ensuring you have the latest version for optimal performance of your camera. If you do not need to install FlyCapture, use the DriverControlGUI to install and enable drivers for your card. a. Login to our downloads page. b. Select your Camera and Operating System from the drop-down lists and click the Search button. c. Click on the Software search results to expand the list. d. Click the appropriate link to begin the download and installation. After the download is complete, the FlyCapture setup wizard begins. If the wizard does not start automatically, double-click the.exe file to open it. Follow the steps in each setup dialog. 3. Enable the Drivers for the card During installation, you are prompted to select your interface driver. In the Interface Driver Selection dialog, select the I will use GigE cameras. This selection ensures the Image Filter driver is installed and enabled. The Image Filter Driver operates as a network service between GigE Vision cameras and the Microsoft built-in UDP stack to filter out GigE Vision stream protocol (GVSP) packets. Use of the filter driver is recommended, as it can reduce CPU load and improve image streaming performance. Alternatively, GigE Vision cameras can communicate directly with the Microsoft UDP stack. Blackfly PGE Technical Reference 20

32 2 Blackfly PGE Installation Note: GigE Vision cameras on Linux systems use native Ubuntu drivers. To uninstall or reconfigure the driver at any time after setup is complete, use the DriverControlGUI (see Configuring Camera Setup). 4. Configure IP Settings After installation is complete, the GigE Configurator opens. This tool allows you to configure the IP settings of the camera and network card. If the GigE Configurator does not open automatically, open the tool from Start Menu>FlyCapture SDK>Utilities>GigE Configurator. If prompted to enable GigE enumeration, select Yes. a. In the left pane, select the Local Area Connection corresponding to the network interface card (NIC) to which the camera is connected. b. In the right pane, review maximum transmission unit (MTU). If not 9000, enable jumbo frames on the NIC by clicking Open Network Connections. (While most NICs support 9000-byte jumbo frames, this feature may be disabled by default.) Blackfly PGE Technical Reference 21

33 2 Blackfly PGE Installation 2.3 Installing Your Camera 1. Install the Tripod Mounting Bracket (optional) The ASA and ISO-compliant tripod mounting bracket attaches to the camera using the included metal screws. Warning! Cameras with metal cases should use black screws; cameras with plastic cases should use silver screws. Using improper screws may cause damage to the camera. 2. Attach a Lens Unscrew the dust cap from the CS- mount lens holder to install a lens. Note: the camera can be used with a removable 5 mm C- mount adapter. Unscrew the dust cap from the C-mount lens holder to install a lens. 3. Connect the interface Card and Cable to the Camera Plug the interface cable into the host controller card and the camera. The cable jack screws can be used for a secure connection. Note: If using PoE, connect a powered Ethernet switch or Ethernet power injector in between the card and the camera. 4. Plug in the GPIO connector 5. Configure IP Settings In the GigE Configurator: a. In the left pane, select your GigE Vision camera. (Note: there may be a delay of several seconds before the camera is detected by the GigE Configurator on startup.) n Under "Current IP Configuration," review the IP address. By default, a dynamic IP address is assigned to the camera according to the DHCP protocol. If DHCP addressing fails, a link- local Blackfly PGE Technical Reference 22

34 2 Blackfly PGE Installation address is assigned. If necessary, change the IP address of the camera to be on the same subnet as the NIC. If the subnets do not match, the camera is marked "BAD" on the left pane. Under "Packet Size Discover," click Discover Maximum Packet Size and note the value. b. Close the GigE Configurator. 6. Confirm Successful Installation and Configure Packet Size a. Run the FlyCap program: All Programs-> Point Grey FlyCapture2 SDK-> FlyCap b. In the camera selection dialog, select the GigE camera that was installed and click Configure Selected. c. In the Camera Control dialog, click Custom Video Modes. By default, Packet Size is set to 1400 bytes. We recommend increasing this value to the size noted in the GigE Configurator, as maximizing packet size reduces processing overhead. The FlyCap program can be used to test the camera's image acquisition capabilities through the Ethernet connection. Changes to your camera's installation configuration can be made using utilities available in the FlyCapture SDK (see Configuring Camera Setup). Blackfly PGE Technical Reference 23

35 2 Blackfly PGE Installation 2.4 Configuring Camera Setup After successful installation of your camera and interface card, you can make changes to the setup. Use the tools described below to change the IP Address or the driver for your interface card. For information on updating your camera's firmware post installation, see Camera Firmware Configuring Camera Drivers FLIR provides the Image Filter Driver for use with GigE Vision cameras. This driver operates as a network service between the camera and the Microsoft built-in UDP stack to filter out GigE vision stream protocol (GVSP) packets. The filter driver is installed and enabled by default as part of the FlyCapture SDK installation process. Use of the filter driver is recommended, as it can reduce CPU load and improve image streaming performance. Alternatively, GigE Vision cameras can operate without the filter driver by communicating directly with the Microsoft UDP stack. Note: GigE Vision cameras on Linux systems use native Ubuntu drivers. For more information about the image filter driver, see the FlyCapture SDK Help. To manage and update drivers use the DriverControlGUI utility provided in the SDK. To open the DriverControlGUI: Start Menu-->All Programs-->FlyCapture SDK-->Utilities-->DriverControlGUI Select the interface from the tabs in the top left. Then select your interface card to see the current setup. For more information about using the DriverControlGUI, see the online help provided in the tool Configuring the IP Address When a new camera is first powered and initialized, a dynamic IP address is assigned to the camera according to the DHCP protocol. If DHCP addressing fails, a link-local address is assigned. You can re-configure the IP address for using the GigE Vision Bootstrap Registers or the GenICam Features. Alternatively, the GigE Configurator is a tool included with the camera software and drivers package that allows you to set the internet protocol (IP) configuration for any GigE interface cards or GigE Vision cameras connected to your system. Using the GigE Configurator, you can: Set the IP address for the current connection. Program a persistent IP address for the camera. Configure the default IP addressing behavior of the camera on startup using a persistent IP, DHCP or LLA. Enable Jumbo Frames on the GigE NIC. Both your camera and host adapter must have an IP address on the same subnet. This can be assigned in three ways: Persistent Both the adapter and the camera have a fixed IP address that will not change. Generally the address is within a closed network range of X.X. The adapter and the camera must be on the same subnet. Blackfly PGE Technical Reference 24

36 2 Blackfly PGE Installation Dynamic (DHCP) Both the camera and the adapter are set to automatically obtain an IP address. This means that the IP address will dynamically change (within a range) every time the camera or computer is restarted. It may take up to one minute for the IP address to resolve and the camera to enumerate. Default (LLA) Both the camera and the adapter use a default IP address from the link-local address block x.x. The camera assigns its current IP address in the following sequence: 1. Persistent Uses the defined IP address. If not available, then; 2. DHCP Attempts to find a dynamic IP address. If not available, then; 3. LLA Uses the default IP address. The GigE Configurator can automatically force an IP address refresh. This detects the IP address of the Network Interface card and automatically sets the camera s IP address relative to the card. The FlyCap program can be used to test your camera settings and verify operation. From the camera selection window, you can also automatically force an IP address refresh. To open the GigE Configurator: Start Menu > All Programs > Point Grey FlyCapture2 SDK > Utilities > GigEConfigurator Figure 2.1: Point Grey GigE Configurator For more information, refer to the online Help file included with the tool Allocating Bandwidth The User Datagram Protocol (UDP) used by the GigE Vision standard provides no guaranteed transmission or fixed timing mechanism. Therefore, bandwidth must be managed by adjusting packet size and packet delay, based on desired resolution and frame rate Packet Size The stream channel packet size (SCPS) sets the size, in bytes, of the packet to be sent out by the camera. IP, UDP and GVSP headers are included in this size. The default packet size is 1400 bytes. Packet size influences the number of interrupts generated which affects CPU usage. The larger the packet size, the fewer the interrupts for the same amount of data. To minimize CPU usage, increase the packet size. The upper limit depends on your host adapter, your Ethernet switches (if used), and the camera. Blackfly PGE Technical Reference 25

37 2 Blackfly PGE Installation Note: From the GigE Configurator with your camera selected, click Discover Maximum Packet Size. This tests the network to see the maximum size that can be sent and received through all your network components. Set your camera s and host adapter's packet size to be less than or equal to this maximum. To adjust the packet size: From the GigE Configurator with your adapter selected, click Open Network Connections to open the Windows Adapter Properties. Adjust the packet size of your host adapter to ~9000 (the standard jumbo packet size). If your adapter does not support such a large packet (or MTU) size, then you will experience slightly higher CPU usage. Packet size for the camera can be adjusted using the FlyCap demo program, the GevSCPSPacketSize GenICam feature, or the GigE Vision Bootstrap Registers. The FlyCapture SDK also supports configuring the SCPS. For more information, consult the FlyCapture SDK Help. Changing the packet size may impact throughput depending on the packet delay setting Packet Delay The stream channel packet delay (SCPD) indicates the number of ticks (at the frequency of the Timestamp Tick Frequency) to insert between each packet. The default packet delay is 400. The Timestamp Tick Frequency is normally 125,000,000 ticks/second, but can be verified by the the GevTimestampTickFrequency GenICam feature, or the Timestamp Tick Frequency Bootstrap register (page 128). The packet delay acts like a gap between packets during transmission. This delay allows the host to process the current packet before the arrival of the next one. When you increase the packet delay value from zero, you reduce the effective bandwidth assigned to the camera and thereby also reduce the possibility of dropped frames. Note: Increasing the packet delay is recommended when running multiple cameras through an Ethernet switch. Increasing the packet delay may require the frame rate to be reduced to meet the available maximum bandwidth. Achieving a desired frame rate may require decreasing the packet delay. To adjust the packet delay: Packet delay for the camera can be adjusted using the FlyCap demo program, the GevSCPD GenICam Features, or the GigE Vision Bootstrap Registers. The FlyCapture SDK also supports configuring the SCPD. For more information, consult the FlyCapture SDK Help Determining Bandwidth Requirements The maximum bandwidth available is 125 MB. This includes image data, control data and image resends, which occur when frames are being dropped. Each image and each packet has a certain amount of overhead that will Blackfly PGE Technical Reference 26

38 2 Blackfly PGE Installation use some bandwidth. Therefore, when calculating your bandwidth requirements, you should not attempt to use the full maximum of 125 MB. Note: If the packet size and packet delay combination exceeds the available bandwidth, frames are dropped. To calculate your bandwidth requirements: Determine your required resolution, frame rate, and pixel format (bytes per pixel) (Height x Width x Frame Rate x Bytes per Pixel)/ = Bandwidth in MB For example, for an image that is VGA, 82 FPS, Mono8: 640 (H) x 480 (W) x 82 (FPS) x 1 (BPP) = ~25 MB Once you have calculated your required bandwidth, you can allocate an amount to each camera by adjusting the packet size and packet delay. Allocating a specific amount to each camera helps to avoid dropped packets due to a data burst. You would do this in a set up with multiple cameras, or in a situation where the system bandwidth might be limited or shared due to hardware architecture. Here are some packet size/packet delay combinations you can use with any image size, pixel format combination. Frame rate will be limited depending on total bandwidth. To allocate 25 MB ~20% of bandwidth Packet Size = 9000 Packet Delay = 5900 To allocate 55 MB ~45% of bandwidth Packet Size = 9000 Packet Delay = 1800 Packet Size = 1400 Packet Delay = 900 Packet Size = 1400 Packet Delay = 255 Bandwidth Requirements for Multiple Cameras Multiple cameras can be set up in two ways: 1) Each camera is connected directly to a single Ethernet port; or, 2) multiple cameras are connected to a single port through an Ethernet switch. If using the first method, each camera has the full bandwidth allocation available to it. If using the second method, the combination of all cameras on a switch cannot exceed the available bandwidth. Related Knowledge Base Articles Title Article Setting Up Multiple GigE Cameras Technical Application Note Configuring Other Network Settings The following GigE Vision bootstrap registers can be used for configuring the camera on the network. All registers are implemented according to the GigE Vision standard. A listing of all network- related bootstrap registers supported on the camera is provided in GigE Vision Bootstrap Registers. Blackfly PGE Technical Reference 27

39 2 Blackfly PGE Installation Stream Channel Destination Address The stream channel destination address (SCDA) register is used to specify the streaming destination IP address. The default SCDA is the IP address of the network or computer to which the camera is connected. It can be set within a range so that the camera sends data as a multicast. As long as switches in the path between the sender and receivers support and are configured for multicasting, multiple receivers can listen to the data stream from the camera. Multicast addresses are between and Note: For more information on multicast address assignments, see To control SCDA use: Heartbeat GenICam GevSCDA in the Transport Layer Control or GigE Vision Bootstrap Registers. The heartbeat is a mandatory GigE Vision feature to monitor the connection between an application and the camera. The application must continually reset the heartbeat timer, or the camera assumes an error has occurred and shut down the connection. In general, the FlyCapture API manages the heartbeat at a low level; however the following two features are controllable: Heartbeat Timeout and Heartbeat Disable. Heartbeat Timeout Heartbeat timeout is the time, in milliseconds, that the camera waits between resets from the application. Heartbeat timeout can be set between 500 ms and 10 seconds. The default setting is 3000 ms (3 seconds). If there is no communication between the camera and the application for longer than the timeout value, the connection is shut down. To control Heartbeat Timeout use: GenICam GevHeartbeatTimeout in the Transport Layer Control or the GigE Vision Bootstrap Registers. FlyCapture API The FlyCapture SDK supports configuring heartbeat timeout. For more information, consult the FlyCapture SDK Help. Heartbeat Disable The heartbeat is enabled by default. Heartbeat disable allows the heartbeat function in the camera to be disabled. To disable Heartbeat use: GenICam GevGVCPHeartbeatDisable in the Transport Layer Control or the GigE Vision Bootstrap Registers. FlyCapture API The FlyCapture SDK supports configuring heartbeat timeout. For more information, consult the FlyCapture SDK Help. Blackfly PGE Technical Reference 28

40 3 Tools to Control the Blackfly PGE 3 Tools to Control the Blackfly PGE The Blackfly PGE's features can be accessed using various controls, including: FlyCapture SDK including API examples and the FlyCap program GenICam Applications GigE Vision Bootstrap Registers Control and Status Registers Third-party Software Applications Examples of the controls are provided throughout this document. Additional information can be found in the appendices. 3.1 Using FlyCapture The user can monitor or control features of the camera through FlyCapture API examples provided in the FlyCapture SDK, or through the FlyCap Program FlyCap Program The FlyCap application is a generic, easy-to-use streaming image viewer included with the FlyCapture SDK that can be used to test many of the capabilities of your compatible camera. It allows you to view a live video stream from the camera, save individual images, adjust the various video formats, frame rates, properties and settings of the camera, and access camera registers directly. Consult the FlyCapture SDK Help for more information Custom Applications Built with the FlyCapture API The FlyCapture SDK includes a full Application Programming Interface that allows customers to create custom applications to control cameras. Included with the SDK are a number of source code examples to help programmers get started. FlyCapture API examples are provided for C, C++, C#, and VB.NET languages. There are also a number of precompiled examples. Code samples are provided in FlyCapture API Code Samples. Examples of basic programming tasks are described in FlyCapture SDK Examples 3.2 Using GenICam Applications GigE Vision is an interface standard that allows for fast image transfer over Ethernet networks. All cameras supporting GigE Vision interact the same way with software also supporting GigE Vision. The standard defines required elements for camera identification, control, and output. It uses GenICam, a programming interface for camera attribute control. GenICam allows camera vendors to define features and attributes in an XML file stored inside the camera. The file is parsed by the host application when the camera is initially discovered. One of the key benefits of GenICam is the ability for camera vendors to introduce new camera-specific features without needing to update the host application. Blackfly PGE Technical Reference 29

41 3 Tools to Control the Blackfly PGE Each camera attribute, such as exposure time, is controlled by a specific GenICam feature. The camera includes an XML device description file for interfacing with third-party GenICam-compliant APIs. This file can be accessed via First URL bootstrap register 200h (see GigE Vision Bootstrap Registers). A full listing of features that are included in the XML file is provided in GenICam Features. Not all operations can be controlled using the XML file; those not included are controlled via Control and Status Registers (CSRs). These registers conform to the IIDC v1.32 standard. A complete list of CSRs can be found in the FLIR Machine Vision Camera Register Reference available from the Downloads page. Throughout this document, GenICam features are referenced with their applicable operation; where no GenICam feature is available in the XML file, the CSR is referenced. For more information on the GigE Vision standard, visit visiononline.org. For more information on GenICam, visit emva.org. 3.3 Using GigE Vision Bootstrap Registers The camera is programmed with a number of GigE Vision- compliant bootstrap registers for storing camera metadata and controlling network management settings. For a listing of all GigE Vision bootstrap registers on the camera, see GigE Vision Bootstrap Registers. Blackfly PGE Technical Reference 30

42 3 Tools to Control the Blackfly PGE 3.4 Using Control and Status Registers The user can monitor or control each feature of the camera through the control and status registers (CSRs) programmed into the camera firmware. These registers conform to the IIDC v1.32 standard (except where noted). Format tables for each 32-bit register are presented to describe the purpose of each bit that comprises the register. Bit 0 is always the most significant bit of the register value. Register offsets and values are generally referred to in their hexadecimal forms, represented by either a 0x before the number or h after the number, e.g. the decimal number 255 can be represented as 0xFF or FFh. A complete list of CSRs can be found in the FLIR Machine Vision Camera Register Reference. The controllable fields of most registers are Mode and Value. Modes Each CSR has three bits for mode control, ON_OFF, One_Push and A_M_Mode (Auto/Manual mode). Each feature can have four states corresponding to the combination of mode control bits. Note: Not all features implement all modes. Table 3.1: CSR Mode Control Descriptions One_Push ON_OFF A_M_Mode State N/A 0 N/A N/A (Self clear) Values 1 0 Off state. Feature will be fixed value state and uncontrollable. Auto control state. Camera controls feature by itself continuously. Manual control state. User can control feature by writing value to the value field. One-Push action. Camera controls feature by itself only once and returns to the Manual control state with adjusted value. If the Presence_Inq bit of the register is one, the value field is valid and can be used for controlling the feature. The user can write control values to the value field only in the Manual control state. In the other states, the user can only read the value. The camera always has to show the real setting value at the value field if Presence_Inq is one. Blackfly PGE Technical Reference 31

43 4 Blackfly PGE Physical Interface 4 Blackfly PGE Physical Interface 4.1 Blackfly PGE Physical Description 1. Lens holder (CS-mount) See Lens Mounting 2. Glass/IR filter system See Dust Protection and Infrared Cut- Off Filters 3. M2x2.5 mounting holes See Mounting with the Case or Mounting Bracket 4. General purpose I/O connector See General Purpose Input/Output (GPIO) 5. Status LED See Status Indicator LED 6. GigE connector See Ethernet Connector 7. M2x2.5 mounting holes 8. M3x2.5 mounting holes See Mounting with the Case or Mounting Bracket 9. Camera label Contains camera information such as model name, serial number and required compliance. Blackfly PGE Technical Reference 32

44 4 Blackfly PGE Physical Interface 4.2 Blackfly PGE Dimensions Figure 4.1: Blackfly PGE Dimensional Drawing Model Barrel Length "A" BFLY-PGE-03S BFLY-PGE-03S BFLY-PGE-05S BFLY-PGE-09S BFLY-PGE-12A BFLY-PGE-13E BFLY-PGE-13H BFLY-PGE-13S BFLY-PGE-14S BFLY-PGE-20E BFLY-PGE-23S BFLY-PGE-23S BFLY-PGE-31S BFLY-PGE-50A BFLY-PGE-50H Blackfly PGE Technical Reference 33

45 4 Blackfly PGE Physical Interface Model Barrel Length "A" BFLY-PGE-50S Note: To obtain 3D models, go to our Downloads site or contact Support. Blackfly PGE Technical Reference 34

46 4 Blackfly PGE Physical Interface 4.3 Mounting with the Case or Mounting Bracket Using the Case The case is equipped with the following mounting holes: Two (2) M2 x 2mm mounting holes on the top of the case Three (3) M3 x 2.5mm mounting holes on the bottom of the case Four (4) M2 x 2mm mounting holes on the bottom of the case that can be used to attach the camera directly to a custom mount or to the tripod mounting bracket Using the Mounting Bracket The tripod mounting bracket is equipped with four (4) M2 mounting holes. Tripod Adapter Dimensions 4.4 Lens Mounting Lenses are not included with individual cameras. Figure 4.2: Tripod Adapter Dimensional Diagram Related Knowledge Base Articles Title Article Selecting a lens for your camera Knowledge Base Article The lens mount is compatible with CS-mount lenses. The BFLY-PGE-23S6 and BFLY-PGE-50H5 lens mount is compatible with C-mount lenses. Correct focus cannot be achieved using a CS-mount lens on a C-mount camera. Blackfly PGE Technical Reference 35

47 4 Blackfly PGE Physical Interface Figure 4.3: Example C-mount Cross Section Back Flange Distance The Back Flange Distance (BFD) is offset due to the presence of both a 1 mm infrared cutoff (IRC) filter and a 0.5 mm sensor package window. These two pieces of glass fit between the lens and the sensor image plane. The IRC filter is installed on color cameras. In monochrome cameras, it is a transparent piece of glass. The sensor package window is installed by the sensor manufacturer. Both components cause refraction, which requires some offset in flange back distance to correct. The resulting C-mount BFD is mm. The resulting CS-mount BFD is mm. For more information about the IRC filter, see Infrared Cut-Off Filters. Blackfly PGE Technical Reference 36

48 4 Blackfly PGE Physical Interface 4.5 Handling Precautions and Camera Care Warning! Do not open the camera housing. Doing so voids the Hardware Warranty described at the beginning of this manual. Your camera is a precisely manufactured device and should be handled with care. Here are some tips on how to care for the device. Avoid electrostatic charging. When handling the camera unit, avoid touching the lenses. Fingerprints affect the quality of the image produced by the device. To clean the lenses, use a standard camera lens cleaning kit or a clean dry cotton cloth. Do not apply excessive force. Extended exposure to bright sunlight, rain, dusty environments, etc. may cause problems with the electronics and the optics of the system. Avoid excessive shaking, dropping or any kind of mishandling of the device. Related Knowledge Base Articles Title Article Cleaning the imaging surface of your camera Knowledge Base Article Case Temperature and Heat Dissipation You must provide sufficient heat dissipation to control the internal operating temperature of the camera. The camera is equipped with an on-board temperature sensor. It allows you to obtain the temperature of the camera board-level components. The sensor measures the ambient temperature within the case. Table 4.1: Temperature Sensor Specifications Accuracy Range Resolution ±2.0 C from -25 C to +100 C ±3.0 C from -55 C to +120 C -55 C to +125 C C Note: As a result of packing the camera electronics into a small space, the outer case of the camera can become very warm to the touch when running in some modes. This is expected behavior and will not damage the camera electronics. Blackfly PGE Technical Reference 37

49 4 Blackfly PGE Physical Interface To reduce heat, use a cooling fan to set up a positive air flow around the camera, taking into consideration the following precautions: Mount the camera on a heat sink, such as a camera mounting bracket, made out of a heat-conductive material like aluminum. Make sure the flow of heat from the camera case to the bracket is not blocked by a non-conductive material like plastic. Make sure the camera has enough open space around it to facilitate the free flow of air. To access temperature information use: GenICam Device Control CSRs TEMPERATURE: 82Ch 4.6 Dust Protection The camera housing is designed to prevent dust from falling directly onto the sensor's protective glass surface. This is achieved by placing a piece of clear glass (monochrome camera models) or an IR cut-off filter (color models) that sits above the surface of the sensor's glass. A removable plastic retainer keeps this glass/filter system in place. By increasing the distance between the imaging surface and the location of the potential dust particles, the likelihood of interference from the dust (assuming non-collimated light) and the possibility of damage to the sensor during cleaning is reduced. Warning! Cameras are sealed when they are shipped. To avoid contamination, seals should not be broken until cameras are ready for assembly at customer's site. Use caution when removing the protective glass or filter. Damage to any component of the optical path voids the Hardware Warranty. Removing the protective glass or filter alters the optical path of the camera, and may result in problems obtaining proper focus with your lens. Related Knowledge Base Articles Title Article Removing the IR filter from a color camera Knowledge Base Article Selecting a lens for your camera Technical Application Note Blackfly PGE Technical Reference 38

50 4 Blackfly PGE Physical Interface 4.7 Infrared Cut-Off Filters FLIR machine vision color camera models are equipped with an additional infrared (IR) cut-off filter. This filter can reduce sensitivity in the near infrared spectrum and help prevent smearing. The properties of this filter are illustrated in the results below. Figure 4.4: IR filter transmittance graph Transmission T=50% T>80% T>85% Wavelength 680 nm ±10 nm 400 nm nm 420 nm nm T average 1% 750 nm nm T<3% 750 nm nm In monochrome models, the IR filter is replaced with a transparent piece of glass. The following are the properties of the IR filter/protective glass: 1" and 1/1.2" Sensors All Other Sensors Type Anti-reflective Anti-reflective Material Schott B270 Schott B270 Dimensions 15.5 ±0.08 x 18 ±0.08 mm 14 ±0.08 x 14 ±0.08 mm Thickness 1 ±0.07 mm 1 ±0.07 mm For more information, see Dust Protection. Related Knowledge Base Articles Title Article Removing the IR filter from a color camera Knowledge Base Article Blackfly PGE Technical Reference 39

51 4 Blackfly PGE Physical Interface 4.8 Camera Interface and Connectors Ethernet Connector The 8-pin RJ-45 Ethernet jack is equipped with two (2) M2 screwholes for secure connection. Pin assignments conform to the Ethernet standard. Power over Ethernet (PoE) To use PoE, an Ethernet power injector or a powered Ethernet switch must be connected to the camera. The PoE conforms to the IEEE 802.3af-2003 standard Interface Cables Note: A 5-meter cable (or longer) is not recommended for laptops or on board controllers. Category 5e or 6 cables up to 100 meters in length should be used for connecting the camera to the network interface card on the host system. FLIR sells a 5-meter Category 5e cable for this purpose. Note: For optimal ESD protection, we recommend using a shielded Ethernet cable or connecting the camera housing to chassis ground (earth). To purchase a recommended cable from FLIR, visit our Accessories page Interface Card The camera must connect to an interface card. This is sometimes called a host adapter, a bus controller, or a network interface card (NIC). A 1000 BASE-T NIC is recommended for streaming images on the Ethernet network between the camera and host system.) Note: For optimal video streaming and camera control performance, we recommend an Intel Pro chipset on a PCIe interface. To purchase a compatible card from FLIR, visit our Accessories page. Blackfly PGE Technical Reference 40

52 4 Blackfly PGE Physical Interface General Purpose Input/Output (GPIO) The camera is equipped with a 6-pin GPIO connector on the back of the case. The connector is a Hirose HR10A- 7R-6PB, the mating connector is a Hirose HR10A-7P-6S(73). Diagram Color Pin Function Description Green 1 V EXT +12 V DC Camera Power Black 2 I0 Opto-isolated input (GPIO 0) Red 3 NC / +3.3 V +3.3 V output. Current 120 ma (nominal). Firmware enabled (See OUTPUT_VOLTAGE_ ENABLE: 19D0h) White 4 O1 Opto-isolated output (GPIO 1) Blue 5 OPTO_ GND Ground for opto-isolated I/O, not connected to camera ground Brown 6 GND DC camera power ground For more information on camera power, see Powering the Camera. For more information on configuring input/output with GPIO, see Input/Output Control. For details on GPIO circuits, see GPIO Electrical Characteristics. Blackfly PGE Technical Reference 41

53 5 General Blackfly PGE Operation 5 General Blackfly PGE Operation 5.1 Powering the Camera The power consumption specification is: Power over Ethernet (PoE); or 12 V nominal (5-16 V) via GPIO interface, maximum 2.5 W (2 W BFLY-PGE-13E4). Power can be provided over the Ethernet interface (PoE). To use PoE, you must also have a powered Ethernet card, a powered Ethernet switch, or an Ethernet power injector. Power can also be provided through the GPIO interface on the back of the case. For more information, see Input/Output Control. If both interfaces are connected, the camera always uses external power over the GPIO connector. If external power is not connected, the camera uses PoE. The camera reboots when switching between power sources. The camera does not transmit images for the first 100 ms after power-up. The auto-exposure and auto-white balance algorithms do not run while the camera is powered down. It may therefore take several (n) images to get a satisfactory image, where n is undefined. When the camera is power cycled (power disengaged then re-engaged), the camera reverts to its default factory settings, or if applicable, the last saved memory channel. For more information, see User Sets (Memory Channels). Blackfly PGE Technical Reference 42

54 5 General Blackfly PGE Operation 5.2 User Sets (Memory Channels) The camera can save and restore settings and imaging parameters via on- board user configuration sets, also known as memory channels. This is useful for saving default power- up settings, such as gain, shutter, video format and frame rate, and others that are different from the factory defaults. User Set 0 (or Memory channel 0) stores the factory default settings that can always be restored. Two additional user sets are provided for custom default settings. The camera initializes itself at power- up, or when explicitly reinitialized, using the contents of the last saved user set. Attempting to save user settings to the (read- only) factory default user set causes the camera to switch back to using the factory defaults during initialization. The following camera settings are saved in user sets. Acquisition Frame Rate and Current Frame Rate Image Data Format, Position, and Size Image mirror, if applicable Current Video Mode and Current Video Format Camera power Frame information Trigger Mode and Trigger Delay Imaging Parameters such as: Brightness, Auto Exposure, Shutter, Gain, White Balance, Sharpness, Hue, Saturation, and Gamma Input/output controls such as: GPIO pin modes, GPIO strobe modes Color Coding ID/Pixel Coding Packet Size, Packet Delay, GVCP Configuration, and Heartbeat To access user sets: GenICam User Set Control GenICam User Set Control Name CurrentUserSet UserSetSelector UserSetLoad UserSetSave Display Name Current User Set User Set Selector User Set Load User Set Save Description Indicates the user set that is currently in use. At initialization time, the camera loads the most recently saved user set Selects the user set to load or save Loads the user set specified by the User Set Selector to the device and makes it active Saves the user set specified by the User Set Selector to the non-volatile memory of the device DefaultUserSet Default User Set Selects the default user set as the default start up set Value 0 (default) 1 2 Default User Set 1 User Set 2 Write Only Write Only Default User Set 1 User Set 2 Blackfly PGE Technical Reference 43

55 5 General Blackfly PGE Operation 5.3 On-Camera Frame Buffer The camera has a 16 MB that can be used for temporary image storage. This may be useful in cases such as: Retransmission of an image is required due to data loss or corruption. Multiple camera systems where there is insufficient bandwidth to capture images in the desired configuration. All images pass through the frame buffer mechanism. This introduces relatively little delay in the system because the camera does not wait for a full image to arrive in the buffer before starting transmission but rather lags only a few lines behind. The frame buffer is volatile memory that is erased after power cycling. To store images on the camera after power cycling, use Non- Volatile Flash Memory. Accessing flash memory is significantly slower than accessing the frame buffer, and storage is limited. To control frame buffer: CSRs IMAGE_RETRANSMIT: 634h 5.4 Non-Volatile Flash Memory The camera has 512 KB non-volatile memory for users to store data. To control flash memory: FlyCapture SDK example program SaveImageToFlashEx Related Knowledge Base Articles Title Article Storing data in on-camera flash memory Knowledge Base Article Blackfly PGE Technical Reference 44

56 5 General Blackfly PGE Operation 5.5 Camera Firmware Firmware is programming that is inserted into the programmable read- only memory (programmable ROM) of most cameras. Firmware is created and tested like software. When ready, it can be distributed like other software and installed in the programmable read-only memory by the user. The latest firmware versions often include significant bug fixes and feature enhancements. To determine the changes made in a specific firmware version, consult the Release Notes. Firmware is identified by a version number, a build date, and a description. Related Knowledge Base Articles Title Article FLIR machine vision software and firmware version numbering scheme Knowledge Base Article Determining the firmware version used by my camera Knowledge Base Article Should I upgrade my camera firmware or software? Knowledge Base Article Determining Firmware Version To determine the firmware version number of your camera: In FlyCapture, open the Camera Control dialog and click on Camera Information. If you're implementing your own code, use flycapturegetcameraregister(). Query the GenICam Device Control feature DeviceFirmwareVersion Upgrading Camera Firmware Camera firmware can be upgraded or downgraded to later or earlier versions using the UpdatorGUI program that is bundled with the FlyCapture SDK available from our downloads site. Before upgrading firmware: Install the SDK, available from our downloads site. Ensure that FlyCapture2.dll is installed in the same directory as UpdatorGUI3. Download the firmware file from our downloads site. Warning! Do not disconnect the camera during the firmware update process. To upgrade the firmware using FlyCapture: 1. Start Menu-->All Programs-->Point Grey FlyCapture2 SDK-->Utilities-->UpdatorGUI 2. Select the camera from the list at the top. 3. Click Open to select the firmware file. 4. Click Update. 5. Click Yes to continue. Blackfly PGE Technical Reference 45

57 6 Input/Output Control 6 Input/Output Control 6.1 General Purpose Input/Output (GPIO) The camera is equipped with a 6-pin GPIO connector on the back of the case. The connector is a Hirose HR10A- 7R-6PB, the mating connector is a Hirose HR10A-7P-6S(73). Table 6.1: GPIO pin assignments (as shown looking at rear of camera) Diagram Color Pin Function Description Green 1 V EXT +12 V DC Camera Power Black 2 I0 Opto-isolated input (GPIO 0) Red 3 NC / +3.3 V +3.3 V output. Current 120 ma (nominal). Firmware enabled (See OUTPUT_VOLTAGE_ ENABLE: 19D0h) White 4 O1 Opto-isolated output (GPIO 1) Blue 5 OPTO_ GND Ground for opto-isolated I/O, not connected to camera ground Brown 6 GND DC camera power ground For more information on camera power, see Powering the Camera. For details on GPIO circuits, see GPIO Electrical Characteristics. Blackfly PGE Technical Reference 46

58 6 Input/Output Control 6.2 GenICam Digital Input/Output Control LineSelector LineMode LineSource LineInverter Name Display Name Description Value + Line Selector Line Mode Line Source Line Inverter Selects the physical line (or GPIO pin) of the external device connector to configure. Controls whether the physical line is used to Input or Output a signal. Choices are dependent on which line is selected. Selects which input or output signal to output on the selected line. Line Mode must be Output. Controls the invertion of the signal of the selected input or output line StrobeEnabled Strobe Enabled Enables/disables strobe UserOutputValue User Output Value Sets the value of the user output selector LineDebounceTime LineStatus LineStatusAll StrobeDuration ExposureActiveMode Line Debounce Time Line Status Line Status All Strobe Duration Exposure Active Mode Sets the value of the selected line debouncer time in microseconds Returns the current status of the selected input or output line Returns the current status of all available line signals at time of polling in a single bitfield Outputs a specified number of pulses with programmable high and low duration If the camera supports rolling shutter with a global reset, the strobe can be set to active from the start of exposure of the first line to the end of exposure on the last line (Any pixel) or from the start of exposure on the last line to the end of exposure on the first line (All pixels). 3.3VEnable 3.3 V Enable Enable or disable 3.3 V output Line 0 Line 1 Line 2 Line 3 Input Trigger Strobe Output Exposure Active External Trigger Active True False True False True = High False = Low True = High False = Low 00: Line 1 Exposed 01: Any pixel exposed (only for global reset mode) 10: All pixels exposed (same as Line 1 for global reset mode) Blackfly PGE Technical Reference 47

59 6 Input/Output Control 6.3 Strobe Signal Delay For BFLY-PGE-12A2 model, in trigger mode, set the strobe to start at exposure start not trigger start as the sensor has a trigger delay of approximately 8 lines. In free running mode, there is an inherent minimum pulse width which differs for active-high and active-low strobe. For active-high (turning the diode off), if the pulse is less than 25 µs it is filtered. For active-low (turning the diode on) the pulse is shorter, approximately 10 µs. There is a fixed pulse width difference between the expected strobe width and the actual width. For active-high, the pulse width is approximately 25 µs shorter than expected. For active-low, the pulse width is approximately 25 µs longer than expected. Blackfly PGE Technical Reference 48

60 6 Input/Output Control 6.4 Programmable Strobe Output The camera is capable of outputting a strobe pulse off select GPIO pins that are configured as outputs. The start of the strobe can be offset from either the start of exposure (free-running mode) or time of incoming trigger (external trigger mode). By default, a pin that is configured as a strobe output will output a pulse each time the camera begins integration of an image. The duration of the strobe can also be controlled. Setting a strobe duration value of zero produces a strobe pulse with duration equal to the exposure (shutter) time. Multiple GPIO pins, configured as outputs, can strobe simultaneously. Connecting two strobe pins directly together is not supported. Instead, place a diode on each strobe pin. The camera can also be configured to output a variable strobe pulse pattern. The strobe pattern functionality allows users to define the frames for which the camera will output a strobe. For example, this is useful in situations where a strobe should only fire: Every Nth frame (e.g. odd frames from one camera and even frames from another); or N frames in a row out of T (e.g. the last 3 frames in a set of 6); or Specific frames within a defined period (e.g. frames 1, 5 and 7 in a set of 8) Related Knowledge Base Articles Title Buffering a GPIO pin strobe output signal using an optocoupler to drive external devices Article Knowledge Base Article GPIO strobe signal continues after isochronous image transfer stops Knowledge Base Article Blackfly PGE Technical Reference 49

61 6 Input/Output Control 6.5 Debouncer By default, our cameras reject a trigger signal that has a pulse width of less than 16 ticks of the pixel clock. With the debouncer you can define a debounce value. Once the debouncer is enabled and defined, the camera rejects a trigger signal with a pulse width less than the defined debounce value. We recommend you set the debounce value slightly higher than longest expected duration of an invalid signal to compensate for the quality of the input clock signal. The debouncer is available on GPIO input pins. For the debouncer to take effect, the associated GPIO pin must be in Input mode (GPIO Mode 0). The debouncer works in all trigger modes. Note: Each GPIO has its own input delay time. The debouncer time adds additional delay to the signal on the pin. To set the debouncer: GenICam Digital Input Output Control Figure 6.1: Debouncer Filtering Invalid Signals Blackfly PGE Technical Reference 50

62 6 Input/Output Control 6.6 GPIO Electrical Characteristics Both the opto-isolated input and output have over current protection. The output is open collector and thus requires a pull-up resistor to operate. The rise time and bias current will be determined by the resistor value chosen. If the camera is generating an output signal that approaches the rise time plus the fall time of the opto-isolated circuit, care must be taken to optimize the pull-up resistor chosen to minimize the rise time while still remaining within the current limits of the output circuit. The opto- isolated specifications listed below are applicable when power to the camera is provided through the interface and not through the GPIO. Warning! To avoid damage, connect the OPTO_GND pin first before applying voltage to the GPIO line. Warning! Prolonged use of the camera outside of the Operating Range described below may lead to unexpected behavior and should be avoided. Table 6.2: Operating Range Description Minimum Maximum Opto-isolated Input Voltage 0 V 30 V Opto-isolated Output Voltage 0 V 48 V Opto-isolated Output Current 25 ma 3.3 V Output Current 120 ma Table 6.3: Absolute Maximum Ratings Description Minimum Maximum Opto-isolated Input Voltage -70 V 40 V Opto-isolated Output Voltage -48 V 48 V External Voltage Table 6.4: External Voltage Resistor Combinations External Resistor OPTO_OUT Low Voltage OPTO_OUT High Voltage Current 3.3 V 1 kω 0.6 V 3.3 V 2.8 ma 5 V 1 kω 0.8 V 5.0 V 4.2 ma 12 V 2.4 kω 0.9 V 12.0 V 4.6 ma 24 V 4.7 kω 0.9 V 24.0 V 4.9 ma 30 V 4.7 kω 1.1 V 30.0 V 6.2 ma Values are for reference only Blackfly PGE Technical Reference 51

63 6 Input/Output Control Figure 6.2: Opto-isolated input circuit Figure 6.3: Opto-isolated output circuit Output Timing Characteristics Note: Timing specifications are preliminary and subject to change. Blackfly PGE Technical Reference 52

64 6 Input/Output Control Figure 6.4: Output Timing Characteristics Table 6.5: Opto-isolated Output Performance (measured at Vcc = 5 V, Rext = 1 kω) Parameter Symbol Opto-isolated Output Low Voltage V L 840 mv Output High Voltage V H 5 V Output Threshold High Voltage V THH V L + 90% (V H - V L ) Output Threshold Low Voltage V THL V L + 10% (V H - V L ) Cycle Rise Time t R 8.2 µs Cycle Fall Time t F 1.8 µs Opto Current 4.1 ma Opto Isolator Delay (High to Low) 2.7 µs Opto Isolator Delay (Low to High) 17.3 µs Table 6.6: Sample Opto-isolated Output Voltage/Current Measurements External Voltage External Resistor V L I OUT 3.3 V 1 kω 575 mv 2.7 ma 5 V 1 kω 840 mv 4.1 ma 12 V 2.4 kω 915 mv 4.6 ma 24 V 4.7 kω 975 mv 4.9 ma Blackfly PGE Technical Reference 53

65 6 Input/Output Control Input Timing Characteristics Note: Timing specifications are preliminary and subject to change. Figure 6.5: Opto-isolated Input Timing Characteristics (Vcc = 5 Vpk-pk) Parameter Symbol Opto-isolated Input Low Voltage V IL 1.4 V Input High Voltage V IH 2.6 V Propagation Delay Low to High t PDLH 6.4 µs Propagation Delay High to Low t PDHL 9.3 µs Minimum Positive Pulse Width t MPPW 13 µs Minimum Negative Pulse Width t MNPW 3 µs Blackfly PGE Technical Reference 54

66 7 Image Acquisition 7 Image Acquisition 7.1 Asynchronous Triggering The camera supports asynchronous triggering, which allows the start of exposure (shutter) to be initiated by an external electrical source (or hardware trigger) or from an internal software mechanism (software trigger). To access trigger modes: GenICam Acquisition Control FlyCapture API AsyncTriggerEx CSRs TRIGGER_MODE: 830h Model Supported Acquisition Modes Firmware (Mono / Color) BFLY-PGE-03S2 Standard, bulb, low smear, overlapped, multi-shot / BFLY-PGE-03S3 Standard, bulb, low smear, overlapped, multi-shot / BFLY-PGE-05S2 Standard, bulb, low smear, overlapped, multi-shot / BFLY-PGE-09S2 Standard, bulb, low smear, overlapped, multi-shot / BFLY-PGE-12A2 Standard, multi-shot / BFLY-PGE-13E4 Standard, multi-shot / BFLY-PGE-13H2 Standard, bulb, low smear, overlapped, multi-shot / BFLY-PGE-13S2 Standard, bulb, low smear, overlapped, multi-shot / BFLY-PGE-14S2 Standard, bulb, multi-shot / BFLY-PGE-20E4 Standard, multi-shot / BFLY-PGE-23S2 Standard, bulb, multi-shot / BFLY-PGE-23S6 Standard, bulb, overlapped, multi-shot / BFLY-PGE-31S4 Standard, bulb, overlapped, multi-shot / BFLY-PGE-50A2 Standard, bulb, multi-shot / BFLY-PGE-50H5 Standard, bulb, low smear, overlapped, multi-shot / BFLY-PGE-50S5 Standard, bulb, overlapped, multi-shot / For More Information... Standard External Trigger (Mode 0) Bulb Shutter Trigger (Mode 1) Low Smear Trigger (Mode 13) Overlapped Exposure Readout Trigger (Mode 14) Multi-Shot Trigger (Mode 15) Blackfly PGE Technical Reference 55

67 7 Image Acquisition GenICam Acquisition Control AcquisitionMode AcquisitionStart AcquisitionStop AcquisitionFrameCount AcquisitionFrameRate Name Display Name Description Value AcquisitionFrameRateControlEnabled FrameRateAuto TriggerSelector TriggerMode TriggerSource TriggerActivation TriggerDelay TriggerDelayEnabled ExposureMode Acquisition Mode Acquisition Start Acquisition Stop Acquisition Frame Count Acquisition Frame Rate (Hz) Acquisition Frame Rate Control Enabled Frame Rate Auto Trigger Selector Trigger Mode Trigger Source Trigger Activation TriggerDelay (us) Trigger Delay Enabled Exposure Mode (not all models support all modes) Sets the acquisition mode of the device Starts the acquisition of the device Stops the acquisition of the device at the end of the current frame Number of frames to acquire in Multi Frame acquisition mode Controls the acquisition rate (in Hertz) at which the frames are captured Enables manual control of the camera frame rate Controls the mode for automatic frame rate adjustment Selects the type of trigger to configure. Derived from Exposure Mode. Controls whether or not the selected trigger is active Specifies the internal signal or physical input line to use as the trigger source. The selected trigger must have its Trigger Mode set to On. Specifies the activation mode of the trigger Specifies the delay (in microseconds) to apply after the trigger reception before activating it Specifies whether or not the Trigger Delay is enabled Sets the operation mode of the exposure (shutter). Toggles the Trigger Selector. Timed = Exposure Start; Trigger Width = Exposure Active Continuous Single Frame Multi Frame Write Only Write Only True False Off Continuous Exposure Start/ Exposure Active Off On Software Line x where x is a GPIO trigger pin Falling Edge Rising Edge True False Timed Trigger Width Blackfly PGE Technical Reference 56

68 7 Image Acquisition ExposureTime ExposureAuto pgrexposurecompensationauto pgrexposurecompensation Name Display Name Description Value pgrautoexposurecompensationlowerlimit pgrautoexposurecompensationupperlimit ExposureTime (us) Exposure Auto Exposure Compensation Auto Exposure Compensation Auto Exposure Compensation Lower Limit Auto Exposure Compensation Upper Limit Exposure time in microseconds when Exposure Mode is Timed Sets the automatic exposure mode when Exposure mode is Timed Sets the automatic exposure compensation value mode The measured or target image plane illuminance in EV Lower limit of the auto exposure compensation value(ev) parameter Upper limit of the auto exposure compensation value(ev) parameter Off Once Continuous Blackfly PGE Technical Reference 57

69 7 Image Acquisition Standard External Trigger (Mode 0) Trigger Mode 0 is best described as the standard external trigger mode. When the camera is put into Trigger Mode 0, the camera starts integration of the incoming light from external trigger input falling/rising edge. The Exposure Time describes integration time. No parameter is required. The camera can be triggered in this mode by using the GPIO pins as external trigger or by using a software trigger. It is not possible to trigger the camera at full frame rate using Trigger Mode 0; however, Overlapped Exposure Readout Trigger (Mode 14) allows triggering at nearly full frame rate. Figure 7.1: Trigger Mode 0 ( Standard External Trigger Mode ) Note: For the BFLY-PGE-50A2 models operating in this trigger mode, if the number of acquired images is 1, exposure is controlled by the global reset feature of the sensor. This feature may reduce distortion artifacts typical of rolling shutter sensors. However, because exposure lengthens throughout the frame, there may be a gradual increase in brightness from top to bottom of an image.for more information, see Rolling Shutter Artifacts. GenICam Acquisition Control Acquisition Mode Continuous Trigger Selector Exposure Start Trigger Mode On Trigger Source Line x (GPIO pin) Trigger Activation Rising or Falling edge Trigger Delay 0 Exposure Mode Timed Exposure Time Integration Time Exposure Auto Off Registers TRIGGER_MODE: 830h Presence [0] 1 ON [6] 1 Polarity [7] Low/High Source [8-10] GPIO Pin Value [11] Low/High Mode [12-15] Trigger_Mode_0 Parameter [20-31] None Blackfly PGE Technical Reference 58

70 7 Image Acquisition Bulb Shutter Trigger (Mode 1) In Bulb Shutter mode, the camera starts integration of the incoming light from external trigger input. Integration time is equal to low state time of the external trigger input. Figure 7.2: Trigger Mode 1 ( Bulb Shutter Mode ) Note: For the BFLY-PGE-50A2 models operating in this trigger mode, if the number of acquired images is 1, exposure is controlled by the global reset feature of the sensor. This feature may reduce distortion artifacts typical of rolling shutter sensors. However, because exposure lengthens throughout the frame, there may be a gradual increase in brightness from top to bottom of an image.for more information, see Rolling Shutter Artifacts. GenICam Acquisition Control Acquisition Mode Trigger width Trigger Selector Exposure Active Trigger Mode On Trigger Source Line x (GPIO pin) Trigger Activation Rising or Falling edge Trigger Delay 0 Exposure Mode Trigger Width Exposure Time Integration Time Exposure Auto Off Registers TRIGGER_MODE: 830h Presence [0] 1 ON [6] 1 Polarity [7] Low/High Source [8-10] GPIO Pin Value [11] Low/High Mode [12-15] Trigger_Mode_1 Parameter [20-31] None Blackfly PGE Technical Reference 59

71 7 Image Acquisition Low Smear Trigger (Mode 13) Trigger Mode 13 is a reduced smear imaging mode. Smear reduction works by increasing the speed of the vertical clock near the end of the integration cycle. This step is also known as fast dump. Since the clock speed has been increased, this reduces the time each pixel data has to collect smear while it passes through the vertical shift register. This trigger mode behaves similarly to Standard External Trigger (Mode 0), except the trigger input first activates a fast dump off the CCD. The fast dump period is followed by exposure, which is controlled by the Shutter settings. The length of the fast dump period is determined by the trigger delay. For other methods to minimize smear, see Smear Reduction. Figure 7.3: Trigger Mode 13 ( Low Smear Trigger Mode ) Registers TRIGGER_MODE: 830h Presence [0] 1 ON [6] 1 Polarity [7] Low/High Source [8-10] GPIO Pin Value [11] Low/High Mode [12-15] Trigger_Mode_13 Parameter [20-31] None Blackfly PGE Technical Reference 60

72 7 Image Acquisition Overlapped Exposure Readout Trigger (Mode 14) Overlapped Exposure Readout mode is a vendor- unique trigger mode that is very similar to Standard External mode, but allows for triggering at faster frame rates. This mode works well for users who want to drive exposure start with an external event. However, users who need a precise exposure start should use Standard External Trigger (Mode 0). In the figure below, the trigger may be overlapped with the readout of the image, similar to continuous shot (freerunning) mode. If the trigger arrives after readout is complete, it starts as quickly as the imaging area can be cleared. If the trigger arrives before the end of shutter integration (that is, before the trigger is armed), it is dropped. If the trigger arrives while the image is still being read out of the sensor, the start of exposure is delayed until the next opportunity to clear the imaging area without injecting noise into the output image. The end of exposure cannot occur before the end of the previous image readout. Therefore, exposure start may be delayed to ensure this, which means priority is given to maintaining the proper exposure time instead of to the trigger start. Figure 7.4: Trigger Mode 14 ( Overlapped Exposure/Readout Mode ) Registers TRIGGER_MODE: 830h Presence [0] 1 ON [6] 1 Polarity [7] Low/High Source [8-10] GPIO Pin Value [11] Low/High Mode [12-15] Trigger_Mode_14 Parameter [20-31] None Blackfly PGE Technical Reference 61

73 7 Image Acquisition Multi-Shot Trigger (Mode 15) Multi-Shot mode is a vendor-unique trigger mode that allows the user to fire a single hardware or software trigger and have the camera acquire and stream a predetermined number of images. The number of images to be acquired is determined by the parameter specified with the trigger mode. This allows up to 255 images to be acquired from a single trigger. Setting the parameter to 0 results in a non-free running, nonoverlap mode. If Trigger Mode 14 is supported by the camera, setting the parameter to 0 results in a non-free running, overlap mode. Once the trigger is fired, the camera will acquire N images with an exposure time equal to the value defined by the shutter, and stream the images to the host system at the current frame rate. Once this is complete, the camera can be triggered again to repeat the sequence. Any changes to the trigger control cause the current sequence to stop. Note: During the capture of N images, provided that N>0, the camera is still in an asynchronous trigger mode (essentially Trigger Mode 14), rather than continuous (free-running) mode. The result of this is that the frame rate is turned OFF, and the camera put into extended shutter mode. Users should ensure that the maximum shutter time is limited to 1/frame_rate to get the N images captured at the current frame rate. Related Knowledge Base Articles Title Article Extended shutter mode operation for FLIR machine vision cameras Knowledge Base Article Figure 7.5: Trigger Mode 15, when N is greater than 0. ( Multi-Shot Trigger Mode ) Note: For the BFLY-PGE-50A2 models operating in this trigger mode, if the number of acquired images is 1, exposure is Blackfly PGE Technical Reference 62

74 7 Image Acquisition controlled by the global reset feature of the sensor. This feature may reduce distortion artifacts typical of rolling shutter sensors. However, because exposure lengthens throughout the frame, there may be a gradual increase in brightness from top to bottom of an image.for more information, see Rolling Shutter Artifacts. Note: For the BFLY-PGE-23S6 models operating in this trigger mode, High Dynamic Range (HDR) Imaging is not supported. Registers TRIGGER_MODE: 830h Presence [0] 1 ON [6] 1 Polarity [7] Low/High Source [8-10] GPIO Pin Value [11] Low/High Mode [12-15] Trigger_Mode_15 Parameter [20-31] N number of images to be acquired Blackfly PGE Technical Reference 63

75 7 Image Acquisition 7.2 External Trigger Timing The time from the external trigger firing to the start of shutter is shown below: Figure 7.6: External trigger timing characteristics 1. Trigger Pulse 2. Propagation Delay 3. Exposure Time 4. Sensor Readout 5. Data Transfer Depending on the firmware version, Sensor Readout (4) and Data Transfer (5) may occur concurrently. It is possible for users to measure this themselves by configuring one of the camera s GPIO pins to output a strobe pulse (see Programmable Strobe Output) and connecting an oscilliscope up to the input trigger pin and the output strobe pin. The camera will strobe each time an image acquisition is triggered; the start of the strobe pulse represents the start of exposure. 7.3 Maximum Frame Rate in External Trigger Mode Note: This section only applies to Rolling Shutter models. When image capture on a rolling shutter camera is triggered by an external source, achievable frame rate is half the rate achievable in free-running mode, regardless of the rate that is specified. This difference is caused by a change in the way rolling shutter cameras operate between free-running and trigger modes. In free-running mode, integration can occur as quickly as the camera's pixel clock allows, because by the time the bottom row of the image sensor has integrated, the top row is already read out, and is free to integrate the next image without delay. In trigger mode, however, rolling shutter cameras begin read- out only after the entire image is integrated. The camera is not ready to receive another trigger until read- out is complete. Essentially, one frame is required for reset, and one frame for read-out. As a result, the frame rate achieved in trigger mode is half the rate specified for free-running mode. 7.4 Camera Behavior Between Triggers When operating in external trigger mode, the camera clears charges from the sensor at the horizontal pixel clock rate determined by the current frame rate. For example, if the camera is set to 10 FPS, charges are cleared off the sensor at a horizontal pixel clock rate of 15 KHz. This action takes place following shutter integration, until the next trigger is received. At that point, the horizontal clearing operation is aborted, and a final clearing of the entire sensor is performed prior to shutter integration and transmission. Blackfly PGE Technical Reference 64

76 7 Image Acquisition 7.5 Changing Video Modes While Triggering You can change the video format and mode of the camera while operating in trigger mode. Whether the new mode that is requested takes effect in the next triggered image depends on the timing of the request and the trigger mode in effect. The diagram below illustrates the relationship between triggering and changing video modes. Figure 7.7: Relationship Between External Triggering and Video Mode Change Request When operating in Standard External Trigger (Mode 0) or in Bulb Shutter Trigger (Mode 1), video mode change requests made before point A on the diagram are honored in the next triggered image. The camera attempts to honor a request made after point A in the next triggered image, but this attempt may or may not succeed, in which case the request is honored one triggered image later. In Overlapped Exposure Readout Trigger (Mode 14), point B occurs before point A. The result is that, in most cases, there is a delay of one triggered image for a video mode request, made before the configuration period, to take effect. In Multi-Shot Trigger (Mode 15), change requests made after point A for any given image readout are honored only after a delay of one image. Blackfly PGE Technical Reference 65

77 7 Image Acquisition 7.6 Asynchronous Software Triggering Shutter integration can be initiated by a software trigger by setting the Trigger Source to Software in the GenICam features. The time from a software trigger initiation to the start of shutter is shown below: Figure 7.8: Software trigger timing 1. Software Trigger 2. Trigger Latency 3. Exposure Time 4. Sensor Readout 5. Data Transfer The time from when the software trigger is written on the camera to when the start of integration occurs can only be approximated. We then add the trigger latency (time from the trigger pulse to the start of integration) to this. Note: This timing is solely from the camera perspective. It is virtually impossible to predict timing from the user perspective due to latencies in the processing of commands on the host PC. Blackfly PGE Technical Reference 66

78 8 Blackfly PGE Attributes 8 Blackfly PGE Attributes 8.1 Pixel Formats Raw Mono RGB YUV Pixel formats are an encoding scheme by which color or monochrome images are produced from raw image data. Most pixel formats are numbered 8, 12, or 16 to represent the number of bits per pixel. The Blackfly PGE's Analog-to-Digital Converter, which digitizes the images, is configured to a fixed bit output (10- bit BFLY-PGE-13E4/BFLY-PGE-20E4; 10- and 12-bit BFLY-PGE-23S6; 12-bit all others). If the pixel format selected has fewer bits per pixel than the ADC output, the least significant bits are dropped. If the pixel format selected has greater bits per pixel than the ADC output, the least significant bits are padded and can be discarded by the user. Pixel Format Bits per Pixel Mono 8, Raw 8 8 Mono 12, Raw 12, YUV Mono 16, Raw 16, YUV RGB 8, YUV Raw is a pixel format where image data is Bayer RAW untouched by any on board processing. Selecting a Raw format bypasses the FPGA/color core, which may disable image processing, but allows for faster frame rates. In a GenICam application, this is achieved using Image Format Control and disabling On Board Color Processing. Mono is a pixel format where image data is monochrome. Color cameras using a mono format enable FPGA/color core image processing such as access to gamma/lut. Y8 and Y16 are also monochrome formats with 8 and 16 bits per pixel respectively. RGB is a color- encoding scheme that represents the intensities of red, green, and blue channels in each pixel. Each color channel uses 8 bits of data. With 3 color channels, a single RGB pixel is 24 bits. YUV is a color-encoding scheme that assigns both brightness (Y) and color (UV) values to each pixel. Each Y, U, and V value comprises 8 bits of data. Data transmission can be in 24, 16, or 12 bits per pixel. For 16 and 12 bits per pixel transmissions, the U and V values are shared between pixels to free bandwidth and possibly increase frame rate. YUV444 is considered a high resolution format which transmits 24 bits per pixel. Each Y, U, and V value has 8 bits. YUV422 is considered a medium resolution format which transmits 16 bits per pixel. Each Y value has 8 bits, but the U and V values are shared between 2 pixels. This reduces the bandwidth of an uncompressed video signal by one-third with little to no visual difference. Blackfly PGE Technical Reference 67

79 8 Blackfly PGE Attributes YUV411 is considered a low resolution format which transmits 12 bits per pixel. Each Y value has 8 bits, but the U and V values are shared between 4 pixels. The reduces bandwidth by one half compared to YUV444, but also reduces the color information being recorded. YUV can be either packed or planar. Packed is when the Y, U, and V components are stored in a single array (macropixel). Planar is when the Y, U, and V components are stored separately and then combined to form the image. FLIR machine vision cameras use packed YUV. Related Knowledge Base Articles Title Article Understanding YUV data formats Knowledge Base Article Blackfly PGE Technical Reference 68

80 8 Blackfly PGE Attributes 8.2 Video Modes Overview The camera implements a number of video modes, all of which allow the user to select a specific region of interest (ROI) of the image. Some modes also aggregate pixel values using a process known as "binning". Specifying an ROI may increase frame rate. Modes that perform binning may increase image intensity. On FLIR machine vision cameras, binning refers to the aggregation of pixels. Analog binning is aggregation that occurs before the analog to digital conversion. Digital binning is aggregation that occurs after the analog to digital conversion. Unless specified otherwise, color data is maintained in binning modes. In most cases, pixels are added once they are binned. Additive binning usually results in increased image intensity. Another method is to average the pixel values after aggregation. Binning plus averaging results in little or no change in the overall image intensity. Subsampling, or decimation, refers to the skipping of pixels. Binning and subsampling reduces the effective image resolution. For example, 2x2 binning reduces both the width and the height by a quarter. The figures below illustrate binning and subsampling. 2x vertical binning aggregates two adjacent vertical pixel values to form a single pixel value. 2x horizontal binning works in the same manner, except two adjacent horizontal pixel values are aggregated. 2x2 subsampling skips every second pixel horizontally and vertically. Full Pixels 2x Vertical Binning 2x Horizontal Binning 2x2 Subsampling Figure 8.1: Aggregation and Decimation of Pixels Moving the ROI position to a different location does not require the camera to be stopped and restarted, unless the change is illegal (e.g. moving the ROI outside the imaging area). Note: Pixel correction is not done in any of the binning modes Blackfly PGE Technical Reference 69

81 8 Blackfly PGE Attributes Blackfly PGE Video Mode Descriptions Mode Models Description Frame Rate Increase Brightness Increase 0 All All Pixel Scan N/A N/A 1 BFLY-PGE-03S2M-CS BFLY-PGE-03S3M-CS BFLY-PGE-05S2M-CS BFLY-PGE-09S2M-CS BFLY-PGE-13H2M-CS BFLY-PGE-23S2C-CS BFLY-PGE-13E4M-CS BFLY-PGE-13S2M-CS BFLY-PGE-13S2C-CS BFLY-PGE-20E4M-CS BFLY-PGE-20E4C-CS BFLY-PGE-50H5M-C BFLY-PGE-50H5C-C BFLY-PGE-12A2M-CS BFLY-PGE-12A2C-CS BFLY-PGE-50A2M-CS BFLY-PGE-50A2C-CS BFLY-PGE-03S2C-CS BFLY-PGE-03S3C-CS BFLY-PGE-05S2C-CS BFLY-PGE-09S2C-CS BFLY-PGE-13E4C-CS BFLY-PGE-13H2C-CS BFLY-PGE-31S4M-C BFLY-PGE-31S4C-C BFLY-PGE-50S5M-C BFLY-PGE-50S5C-C 2x2 Adjacent Binning Yes Yes 2x2 Adjacent Binning No Yes 2x2 Adjacent Binning No No 2x2 Adjacent Binning Yes No 2x2 Bayer Binning No Yes BFLY-PGE-23S6M-C 2x2 Bayer Binning Yes (Except 8-bit pixel format.) Yes Blackfly PGE Technical Reference 70

82 8 Blackfly PGE Attributes Mode Models Description Frame Rate Increase Brightness Increase 2 4 BFLY-PGE-12A2M-CS BFLY-PGE-12A2C-CS BFLY-PGE-13S2M-CS BFLY-PGE-13S2C-CS BFLY-PGE-14S2C-CS BFLY-PGE-20E4M-CS BFLY-PGE-20E4C-CS BFLY-PGE-23S2C-CS BFLY-PGE-31S4M-C BFLY-PGE-31S4C-C BFLY-PGE-50A2M-CS BFLY-PGE-50A2C-CS BFLY-PGE-50S5M-C BFLY-PGE-50S5C-C BFLY-PGE-03S2C-CS BFLY-PGE-03S3C-CS BFLY-PGE-05S2C-CS BFLY-PGE-09S2C-CS BFLY-PGE-13E4C-CS BFLY-PGE-50H5C-C 2x2 Decimation Yes No 2x2 Adjacent Binning Yes No 4 BFLY-PGE-13H2C-CS BFLY-PGE-23S6C-C 2x2 Adjacent Binning Yes (Except 8-bit pixel format.) Yes 5 7 BFLY-PGE-03S2M-CS BFLY-PGE-03S3M-CS BFLY-PGE-05S2M-CS BFLY-PGE-09S2M-CS BFLY-PGE-09S2M-CS BFLY-PGE-13H2M-CS BFLY-PGE-50A2M-CS BFLY-PGE-50A2C-CS BFLY-PGE-50H5M-C BFLY-PGE-03S2C-CS BFLY-PGE-03S3C-CS BFLY-PGE-05S2C-CS BFLY-PGE-09S2C-CS BFLY-PGE-13H2C-CS BFLY-PGE-50H5C-C BFLY-PGE-13E4M-CS BFLY-PGE-13E4C-CS BFLY-PGE-20E4M-CS BFLY-PGE-20E4C-CS BFLY-PGE-23S6M-C BFLY-PGE-23S6C-C 4x4 Adjacent Binning Yes Yes 4x4 Bayer Binning No Yes Rolling Shutter No No Optimal Imaging No No Blackfly PGE Technical Reference 71

83 8 Blackfly PGE Attributes Mode 0 Mode 0 is the standard imaging mode with full resolution readout, and global shutter. Mode 1 This is 2x2 binning. Implementation and impact on frame rate varies between models. Effective resolution is reduced by a quarter and image brightness is increased in most cases. Monochrome CCD models implement this binning mode vertically on the sensor and horizontally in the FPGA. There is an increase in image brightness and frame rate. Color CCD models implement this binning mode in the FPGA entirely. There is an increase in brightness but no impact on frame rate. CMOS models implement binning mode in the sensor as well. There is an increase in brightness and frame rate in some models. For BFLY-PGE-23S6M, the frame rate increases in 12- or 16-bit pixel formats only. Mode 2 Mode 2 is 2x2 FPGA sub sampling or decimation, effective resolution is quartered and frame rate doubles. This mode is only supported on CMOS sensor cameras, monochrome and color. Applications that require higher frame rate should use this mode. Mode 4 Mode 4 is 2x2 binning. The mode is only available in color CCD cameras, vertically binning is done on the sensor and horizontal binning in the FPGA. There is an increase in image brightness and frame rate (except for BFLY-PGR-23S6C 8- bit pixel format). Compared to Mode 1, this mode suffers from reduced image quality resulting from vertical sensor binning and inherent skipping of rows during readout. Applications that require higher frame rate should use this mode. Mode 5 Mode 5 is 4x4 binning. Implementation and impact on frame rate varies between models. Effective resolution is reduced by a factor of sixteen and image brightness is increased in all cases. Monochrome CCD models implement this binning mode vertically on the sensor and horizontally in the FPGA. There is an increase in image brightness and frame rate. Color CCD models implement this binning mode in the FPGA entirely. There is an increase in brightness but no impact on frame rate. The Raw pixel format is not available in mode 5. Mode 7 For BFLY-PGE-13E4, BFLY-PGE-20E4 Rolling Shutter is applied when using mode 7. For BFLY-PGE-23S6 Mode 7 allows only for specifying a region of interest, and does not perform any binning. This mode uses a 12-bit ADC. Blackfly PGE Technical Reference 72

84 8 Blackfly PGE Attributes 8.3 GenICam Image Format Control Name Display Name Description SensorWidth Sensor Width Effective width of the sensor in pixels SensorHeight Sensor Height Effective height of the sensor in pixels MaxWidth Max Width Maximum width of the image in pixels MaxHeight Max Height Maximum height of the image in pixels Width Width Width of the image provided by the device in pixels Height Height Height of the image provided by the device in pixels OffsetX Offset X Vertical offset from the origin to the AOI in pixels OffsetY Offset Y Horizontal offset from the origin to the AOI in pixels ReverseX PixelFormat Reverse X On Board Color Process Enabled Pixel Format Flip horizontally the image sent by the device. The AOI is applied after the flip Enable FPGA processing (i.e., Gamma/Lookup table). This limits frame rate. Format of the pixel data (not all cameras support all formats) PixelCoding Pixel Coding Coding of the pixels in the image True False True False Value Mono8, Mono12, Mono16, Raw8, Raw12, Raw16, RGB, YUV411, YUV422 Mono Raw YUV RGB PixelSize Pixel Size Size of a pixel in bits 8/12/16/24 PixelColorFilter Pixel Color Filter Type of color filter that is applied to the image TestImageSelector Test Image Selector Selects the type of test image that is sent by the camera VideoMode Video Mode Current video mode PixelBigEndian Pixel BigEndian Set the pixel endianess for pixel format Mono16 BinningHorizontal Binning Horizontal Number of horizontal pixels to combine together BinningVertical Binning Vertical Number of vertical pixels to combine together PixelDynamicRangeMin PixelDynamicRangeMax Dynamic Range Min Dynamic Range Max Indicates the minimum pixel value transferred from the camera Indicates the maximum pixel value transferred from the camera Off Test Image 1 Test Image 2 True False Blackfly PGE Technical Reference 73

85 8 Blackfly PGE Attributes Name Display Name Description Value OnBoardColorProcessing On Board Color Processing Disabling On Board Color Processing bypasses the FPGA/color core, which disables image processing, but allows for faster frame rates. True False Blackfly PGE Technical Reference 74

86 8 Blackfly PGE Attributes 8.4 Frame Rates In some cases, enabling Jumbo Frames on the NIC can help to achieve maximum frame rates. Jumbo Frames can be enabled using the GigE Configurator Blackfly PGE Frame Rates in Mode 0 BFLY-PGE-03S2M and BFLY-PGE-03S2C ( ) Pixel Format 648 x x x 122 All formats BFLY-PGE-03S3M and BFLY-PGE-03S3C ( ) Pixel Format 648 x x x 122 All formats (86 for 24-bit RGB/YUV444) BFLY-PGE-05S2M and BFLY-PGE-05S2C ( ) Pixel Format 808 x x x x x 2 8-bit (Mono, Raw) BFLY-PGE-09S2M and BFLY-PGE-09S2C ( ) Pixel Format 1288 x x x x x 42 8-bit (Mono, Raw) BFLY-PGE-12A2M and BFLY-PGE-12A2C ( ) Pixel Format 1280 x x x x bit (Mono, Raw) BFLY-PGE-13E4M ( ) Pixel Format 1280 x x x x x x 2 8-bit (Mono, Raw) BFLY-PGE-13E4C ( ) Pixel Format 1280 x x x x x x 2 8-bit (Mono, Raw) Blackfly PGE Technical Reference 75

87 8 Blackfly PGE Attributes BFLY-PGE-13H2M and BFLY-PGE-13H2C ( ) Pixel Format 1288 x x x x x 2 All formats (29.09 for 24-bit RGB/YUV444) BFLY-PGE-13S2M and BFLY-PGE-13S2C ( ) Pixel Format 1288 x x x x x 2 8-bit (Mono, Raw) BFLY-PGE-14S2C ( ) Pixel Format 1296 x x x x x x 2 8-bit (Raw) BFLY-PGE-20E4M and BFLY-PGE-20E4C ( ) Pixel Format 1600 x x x x x bit (Mono, Raw) BFLY-PGE-23S2C ( ) Pixel Format 1920 x x x x x x 2 8-bit (Raw) BFLY-PGE-23S6M and BFLY-PGE-23S6C ( ) Pixel Format 1920 x x x x x x 2 8-bit bit bit bit (Color only) BFLY-PGE-31S4M and BFLY-PGE-31S4C ( ) Pixel Format 2048 x x x x x x bit bit bit bit (Color only) Blackfly PGE Technical Reference 76

88 8 Blackfly PGE Attributes BFLY-PGE-50A2M and BFLY-PGE-50A2C ( ) Pixel Format 2592 x x x x x x x x x bit bit bit bit (Color only) BFLY-PGE-50H5M and BFLY-PGE-50H5C ( ) Pixel Format 2448 x x x x x x x 480 All formats 7.5 (7 for 24-bit RGB8; YUV444) BFLY-PGE-50S5M and BFLY-PGE-50S5C ( ) Pixel Format 2448 x x x x x x bit bit bit bit (Color only) Blackfly PGE Technical Reference 77

89 8 Blackfly PGE Attributes 8.5 Readout Method (Shutter Type) Model BFLY-PGE-03S2 BFLY-PGE-03S3 BFLY-PGE-05S2 BFLY-PGE-09S2 BFLY-PGE-12A2 BFLY-PGE-13E4 BFLY-PGE-13H2 BFLY-PGE-13S2 BFLY-PGE-14S2 BFLY-PGE-20E4 BFLY-PGE-23S2 BFLY-PGE-23S6 BFLY-PGE-31S4 BFLY-PGE-50A2 BFLY-PGE-50H5 BFLY-PGE-50S5 For more information... Readout Method Global shutter Global shutter Global shutter Global shutter Global shutter Global shutter Global shutter Global shutter Rolling shutter Global shutter Rolling shutter Global shutter Global shutter Rolling Shutter with Global Reset Global shutter Global shutter Global Shutter Rolling Shutter Rolling Shutter with Global Reset For models that support multiple sensor shutter modes, you can switch between modes. For BFLY-PGE-13E4, and BFLY-PGE-20E4 models, use Video Mode 7 to switch from Global Shutter to Rolling Shutter. For BFLY-PGE-100A2 models, use Video Mode 9 to switch from Rolling Shutter to Rolling Shutter Global Reset. For BFLY- PGE- 50A2 models, use GenICam or IIDC controls to switch from Rolling Shutter to Rolling Shutter Global Reset: GenICam - Image Format Control, Sensor Shutter Mode. CSR - Write 0xB to register 0x5520 to select Rolling Shutter. Write 0xB to register 0x5520 to select Rolling Shutter Global Reset. Blackfly PGE Technical Reference 78

90 8 Blackfly PGE Attributes Global Shutter For cameras with a global shutter sensor, for each frame all of the lines start and stop exposure at the same time. The exposure time for each line is the same. Following exposure, data readout begins. The readout time for each line is the same but the start and end times are staggered. Readout time for a line is equal to 1/Horizontal Line Frequency. Some advantages of global shutter are more uniform brightness and minimal motion blur. Blackfly PGE Technical Reference 79

91 8 Blackfly PGE Attributes Rolling Shutter For cameras with a rolling shutter sensor, each frame each line begins exposure at an offset equal to each line's readout time. The exposure time for each line is the same, but the start and end times are staggered. Data readout for each line begins immediately following the line's exposure. The readout time for each line is the same, but the start and end times are staggered. Readout time for a line is equal to 1/Horizontal Line Frequency. One advantage of a rolling shutter is increased sensitivity. However, because exposure starts at different times throughout the frame, there are known artifacts such as skew, wobble, and partial exposure. For more information, see Rolling Shutter Artifacts. Blackfly PGE Technical Reference 80

92 8 Blackfly PGE Attributes Rolling Shutter with Global Reset For cameras with a rolling shutter with global reset sensor, for each frame all of the lines start exposure at the same time but the end of exposure is delayed by the offset of the previous line's readout. The exposure time for each line gradually lengthens. Data readout for each line begins immediately following the line's exposure. The readout time for each line is the same, but the start and end times are staggered. Readout time for a line is equal to 1/Horizontal Line Frequency. An advantage of a rolling shutter with global reset is a reduction in image artifacts typical of rolling shutters such as skew and wobble. However, because exposure lengthens throughout the frame, there may be a gradual increase in brightness from top to bottom of an image. This gradient can be diminished or even eliminated by using a strobe flash. For more information, see Rolling Shutter Artifacts. If the camera supports a rolling shutter with a global reset, the strobe can be set to active from the start of exposure of the first line to the end of exposure on the last line (Any pixel) or from the start of exposure on the last line to the end of exposure on the first line (All pixels). Use the GPIO_XTRA: 1104h register to view or modify this setting. Blackfly PGE Technical Reference 81

93 8 Blackfly PGE Attributes 8.6 Overview of Imaging Parameters The camera supports control over the following imaging parameters: Imaging Parameter GenICam Feature FlyCapture API Sample Code Brightness Analog Control Setting Brightness Using the FlyCapture API Exposure Time Acquisition Control Setting Shutter Using the FlyCapture API Gain Analog Control Setting Gain Using the FlyCapture API Auto Exposure Acquisition Control Setting Auto Exposure Using the FlyCapture API Sharpness Analog Control Setting Sharpness Using the FlyCapture API Gamma and Lookup Table Image Flip/Mirror Embedded Image Information Bayer Color Processing (color models only) Hue (color models only) Saturation (color models only) Analog Control Image Format Control Chunk Data Control Image Format Control Analog Control Analog Control Setting Gamma Using the FlyCapture API Accessing Raw Bayer Data using FlyCapture Setting Hue Using the FlyCapture API Setting Saturation Using the FlyCapture API Most of these imaging parameters are defined by modes and values. There are three modes: GenICam Control Mode Description Off Continuous Once Feature is in manual mode and values can be set Feature is in automatic mode and values cannot be set Feature executes once automatically and then returns to manual mode Note: The term Continuous is the same as Auto and the term Once is the same as One Push. Users can define the values for manual operation of a feature. Blackfly PGE Technical Reference 82

94 8 Blackfly PGE Attributes 8.7 GenICam Analog Control Name Display Name Description Value Gain Gain (db) Gain applied to the image in db GainAuto Gain Auto Controls the mode for automatic gain adjustment BlackLevel BlackLevelEnabled BalanceRatioSelector BalanceRatio BalanceWhiteAuto Black Level (percent) Black Level Enabled Black Level Auto Balance Ratio Selector Balance Ratio Balance White Auto Analog black level (brightness) in percent Enables/disables black level adjustment Controls the mode for automatic black level adjustment Selects which balance ratio to control (for White Balance) Controls the ratio of the selected color component to a reference color component Controls the mode for automatic white balancing between color channels Gamma Gamma Controls the gamma correction of pixel intensity GammaEnabled Gamma Enabled Enables/disables gamma correction Sharpness Sharpness Sharpness of the image SharpnessEnabled Sharpness Enabled Enables/disables sharpness adjustment SharpnessAuto Sharpness Auto Controls the mode for automatic sharpness adjustment Hue Hue (degrees) Hue of the image in degrees HueEnabled Hue Enabled Enables/disables Hue Saturation Hue Level Auto Saturation (percent) Saturation Enabled Saturation Auto Controls the mode for automatic hue adjustment Saturation of the image in percent Enables/disables saturation Controls the mode for automatic saturation adjustment Off Once Continuous True False Off Once Continuous Red Blue Off Once Continuous True False True False Off Once Continuous True False Off Once Continuous True False Off Once Continuous Blackfly PGE Technical Reference 83

95 8 Blackfly PGE Attributes 8.8 Brightness Brightness, also known as offset or black level, controls the level of black in an image. The camera supports brightness control. To adjust brightness: GenICam Analog Control FlyCapture API Setting Brightness Using the FlyCapture API 8.9 Exposure Time The Blackfly PGE supports Continuous, Off, and Once control of the image sensor exposure time. Note: The terms integration, exposure and "shutter" are interchangeable. Exposure times are scaled by the divider of the basic frame rate. For example, dividing the frame rate by two (e.g. 15 FPS to 7.5 FPS) causes the maximum exposure time to double (e.g. 66 ms to 133 ms). The maximum exposure time can be extended beyond the normal range by disabling the frame rate. Once the frame rate is disabled, you should see the maximum value of the exposure time increase. The supported exposure time range is: Model Range Firmware BFLY-PGE-03S2M-CS 0.03 ms to 32 seconds BFLY-PGE-03S2C-CS 0.03 ms to 32 seconds BFLY-PGE-03S3M-CS ms to 32 seconds BFLY-PGE-03S3C-CS ms to 32 seconds BFLY-PGE-05S2M-CS ms to 32 seconds BFLY-PGE-05S2C-CS ms to 32 seconds BFLY-PGE-09S2M-CS ms to 32 seconds BFLY-PGE-09S2C-CS ms to 32 seconds BFLY-PGE-12A2M-CS ms to seconds BFLY-PGE-12A2C-CS ms to seconds BFLY-PGE-13E4M-CS ms to 1 second BFLY-PGE-13E4C-CS ms to 1 second BFLY-PGE-13H2M-CS ms to 32 seconds BFLY-PGE-13H2C-CS ms to 32 seconds BFLY-PGE-13S2M-CS ms to seconds BFLY-PGE-13S2C-CS ms to seconds BFLY-PGE-14S2C-CS ms to 32 seconds Blackfly PGE Technical Reference 84

96 8 Blackfly PGE Attributes Model Range Firmware BFLY-PGE-20E4M-CS ms to 1 second BFLY-PGE-20E4C-CS ms to 1 second BFLY-PGE-23S2C-CS 0.03 ms to 32 seconds BFLY-PGE-23S6M-C ms to 32 seconds BFLY-PGE-23S6C-C ms to 32 seconds BFLY-PGE-31S4M-C ms to 11.9 seconds BFLY-PGE-31S4C-C ms to 11.9 seconds BFLY-PGE-50A2M-CS ms to 32 seconds BFLY-PGE-50A2C-CS ms to 32 seconds BFLY-PGE-50H5M-C ms to 31.9 seconds BFLY-PGE-50H5C-C ms to 31.9 seconds BFLY-PGE-50S5M-C ms to seconds BFLY-PGE-50S5C-C ms to seconds Note: The exposure range may vary depending on the video mode. For more information, see Video Modes Overview. For Blackfly PGE cameras the maximum range is in Mode 0. The time between the end of exposure for consecutive frames is always constant. However, if the exposure time is continually changing (e.g. being controlled by Auto Exposure), the time between the beginning of consecutive integrations will change. If the exposure time is constant, the time between integrations will also be constant. The camera continually exposes and reads image data off of the sensor under the following conditions: 1. The camera is powered up; and 2. The camera is in free running, not asynchronous trigger, mode. When in trigger mode, the camera simply clears the sensor and does not read the data off the sensor. The camera continues to expose images even when data transfer is disabled and images are not being streamed to the computer. The camera continues exposing images in order to keep things such as the auto exposure algorithm (if enabled) running. This ensures that when a user starts requesting images, the first image received is properly exposed. When operating in free-running mode, changes to the exposure value take effect with the next captured image, or the one after next. Changes to exposure in asynchronous trigger mode generally take effect on the next trigger. To adjust exposure: GenICam Acquisition Control FlyCapture API Setting Shutter Using the FlyCapture API To enable extended exposure: FlyCapture SDK example program ExtendedShutterEx Blackfly PGE Technical Reference 85

97 8 Blackfly PGE Attributes 8.10 Gain Gain is the amount of amplification that is applied to a pixel by the A/D converter. An increase in gain can result in a brighter image but also an increase in noise. The Blackfly PGE supports Continuous and Once gain modes. The A/D converter provides a PxGA gain stage (white balance/preamp) and VGA gain stage. The main VGA gain stage is available to the user, and is variable between models per the table below. Model Range Firmware BFLY-PGE-03S2M-CS db to db BFLY-PGE-03S2C-CS db to db BFLY-PGE-03S3M-CS db to db BFLY-PGE-03S3C-CS db to db BFLY-PGE-05S2M-CS 0 db to db BFLY-PGE-05S2C-CS 0 db to db BFLY-PGE-09S2M-CS -4.5 db to 24 db BFLY-PGE-09S2C-CS -4.5 db to 24 db BFLY-PGE-12A2M-CS db to 13 db BFLY-PGE-12A2C-CS db to 13 db BFLY-PGE-13E4M-CS 0 db to 24 db BFLY-PGE-13E4C-CS 0 db to 24 db BFLY-PGE-13H2M-CS db to 24 db BFLY-PGE-13H2C-CS db to 24 db BFLY-PGE-13S2M-CS -11 db to db BFLY-PGE-13S2C-CS -11 db to db BFLY-PGE-14S2C-CS -1.5 db to 40.5 db BFLY-PGE-20E4M-CS 0 to 24 db BFLY-PGE-20E4C-CS 0 to 24 db BFLY-PGE-23S2C-CS 0 db to 42 db, increment 0.1 db BFLY-PGE-23S6M-C 0 db to db BFLY-PGE-23S6C-C 0 db to db BFLY-PGE-31S4M-C 0 db to db BFLY-PGE-31S4C-C 0 db to db BFLY-PGE-50A2M-CS 0 db to 18 db BFLY-PGE-50A2C-CS 0 db to 18 db BFLY-PGE-50H5M-C db to db BFLY-PGE-50H5C-C db to db BFLY-PGE-50S5M-C 0 db to 48 db BFLY-PGE-50S5C-C 0 db to 48 db Blackfly PGE Technical Reference 86

98 8 Blackfly PGE Attributes Note: Increasing gain also increases image noise, which can affect image quality. To increase image intensity, try adjusting the lens aperture (iris) andexposure Time time first. To adjust gain: GenICam Analog Control To access negative Gain values From Remove Parameter Limits, select Gain and set Remove Limits to True. FlyCapture API Setting Gain Using the FlyCapture API 8.11 Auto Exposure Auto exposure allows the camera to automatically control exposure and/or gain in order to achieve a specific average image intensity. Additionally, users can specify the range of allowed values used by the auto-exposure algorithm by setting the auto exposure range, the auto shutter range, and the auto gain range. Auto Exposure allows the user to control the camera system s automatic exposure algorithm. It has three useful states: State Off Manual Exposure Control Auto Exposure Control Description Control of the exposure is achieved via setting both Exposure and Gain. This mode is achieved by setting Auto Exposure to Off, or by setting Exposure and Gain to Off. The camera automatically modifies Exposure and Gain to try to match the average image intensity to the Auto Exposure value. This mode is achieved by setting Auto Exposure to Off and either/both of Exposure and Gain to Continuous. The camera automatically modifies the value in order to produce an image that is visually pleasing. This mode is achieved by setting the all three of Auto Exposure, Exposure, and Gain to Continuous. In this mode, the value reflects the average image intensity. Auto Exposure can only control the exposure when Exposure and/or Gain are set to Continuous. If only one of the settings is in "auto" mode then the auto exposure controller attempts to control the image intensity using just that one setting. If both of these settings are in "auto" mode the auto exposure controller uses a exposure-before-gain heuristic to try and maximize the signal-to-noise ratio by favoring a longer exposure time over a larger gain value. The auto exposure algorithm is only applied to the active region of interest, and not the entire array of active pixels. There are four parameters that affect Auto Exposure: Auto Exposure Range Allows the user to specify the range of allowed exposure values to be used by the automatic exposure controller when in auto mode. Auto Shutter Range Allows the user to specify the range of exposure values to be used by the automatic exposure controller which is generally some subset of the entire exposure range. Auto Gain Range Allows the user to specify the range of gain values to be used by the automatic exposure controller which is generally some subset of the entire gain range. Blackfly PGE Technical Reference 87

99 8 Blackfly PGE Attributes Auto Exposure ROI Allows the user to specify a region of interest within the full image to be used for both auto exposure and white balance. The ROI position and size are relative to the transmitted image. If the request ROI is of zero width or height, the entire image is used. To control auto exposure: GenICam Acquisition Control FlyCapture API Setting Auto Exposure Using the FlyCapture API 8.12 Sharpness The Blackfly PGE supports sharpness adjustment, which refers to the filtering of an image to reduce blurring at image edges. Sharpness is implemented as an average upon a 3x3 block of pixels, and is only applied to the green component of the Bayer tiled pattern. For sharpness values greater than 1024, the pixel is sharpened; for values less than 1024 it is blurred. When sharpness is in auto mode and gain is low, then a small amount of sharpening is applied, which increases as gain decreases. If gain is high, a small amount of blur is applied, increasing as gain increases. When the camera is outputting raw Bayer data, Sharpness is disabled by default. Otherwise, the default setting is enabled. To adjust sharpness use: GenICam Analog Control FlyCapture API Setting Sharpness Using the FlyCapture API 8.13 Gamma and Lookup Table The camera supports gamma and lookup table (LUT) functionality. In a GenICam application, gamma and LUT are available when the Image Format Control has On Board Color Processing enabled. Sensor manufacturers strive to make the transfer characteristics of sensors inherently linear, which means that as the number of photons hitting the imaging sensor increases, the resulting image intensity increases are linear. Gamma can be used to apply a non-linear mapping of the images produced by the camera. Gamma is applied after analog-to-digital conversion and is available in all pixel formats except Raw. Gamma values between 0.5 and 1 result in decreased brightness effect, while values between 1 and 4 produce an increased brightness effect. By default, Gamma is enabled and has a value of To obtain a linear response, disable gamma. For 8-bit, gamma is applied as: OUT = 255*(IN/255)^1/gamma Note: When Gamma is turned on, Lookup Table is turned off. When Lookup Table is turned on, Gamma is turned off. Lookup Table allows the user to access and control a lookup table (LUT), with entries stored on-board the camera. The LUT is modified under the following circumstances: Blackfly PGE Technical Reference 88

100 8 Blackfly PGE Attributes Camera reinitialization Changing the current video mode or current video format Changing gamma The LUT can define 2 banks where each bank contains 1 channel. A channel defines a table with a length of 2 Input_ Depth entries where each entry is Output_Depth bits wide. Channel table entries are padded to 32-bits. Each bank may be read only, write only or both read and write capable as shown by the LUT_Bank_Rd_Inq and LUT_Bank_Wr_Inq fields. The active bank is set by writing to the Active_Bank field of the LUT_Ctrl register. The Bank_X_Offset_Inq register gives the offset to start address of the array of channel tables in each bank. Multiple channels can be used to process color video pixel data. Lookup Table Data Structure Each bank of channels is composed of entries padded to a complete 32-bits. Each bank is organized as show in the table below. Cn: Channel Number En : Entry Number C(0)E(0) C(0)E(2 Input_Depth -1) C(1)E(0) C(1)E(2 Input_Depth -1) C(Number_of_Channels-1)E(0) C(Number_of_Channels-1) E(2 Input_Depth -1) Related Knowledge Base Articles Title Article How is gamma calculated and applied? Knowledge Base Article To adjust Lookup Table (LUT): GenICam GenICam Features To adjust gamma: GenICam Analog Control FlyCapture API Setting Gamma Using the FlyCapture API 8.14 High Dynamic Range (HDR) Imaging Generally speaking, digital camera systems are not capable of accurately capturing many of the high dynamic range scenes that they are exposed to in real world settings. That is, they may not be able to capture features in Blackfly PGE Technical Reference 89

101 8 Blackfly PGE Attributes both the darkest and brightest areas of an image simultaneously - darker portions of the image are too dark or brighter portions of the image are too bright. High Dynamic Range (HDR) mode helps to overcome this problem by capturing images with varying exposure settings. HDR is best suited for stationary applications. The camera can be set into an HDR mode in which it cycles between 4 user-defined shutter and gain settings, applying one gain and shutter value pair per frame. This allows images representing a wide range of shutter and gain settings to be collected in a short time to be combined into a final HDR image later. The camera does not create the final HDR image; this must be done by the user. The HDR interface contains gain and shutter controls for 4 consecutive frames. When Enable high dynamic range is checked, the camera cycles between settings 1-4, one set of settings per consecutive frame. Note: HDR is supported on the BFLY-PGE-23S6 model only. HDR is not supported while using Multi-Shot Trigger (Mode 15). To enable HDR: FlyCapture SDK example program HighDynamicRangeEx 8.15 Image Flip/Mirror The camera supports horizontal image mirroring. The BFLY-PGE-23S6 also supports vertical image mirroring. To enable image mirroring use: GenICam Image Format Control 8.16 Embedded Image Information This setting controls the frame-specific information that is embedded into the first several pixels of the image. The first byte of embedded image data starts at pixel 0,0 (column 0, row 0) and continues in the first row of the image data: (1,0), (2,0), and so forth. Users using color cameras that perform Bayer color processing on the computer must extract the value from the non-color processed image in order for the data to be valid. Note: Embedded image values are those in effect at the end of shutter integration. Each piece of information takes up 32-bits (4 bytes) of the image. When the camera is using an 8- bit pixel format, this is 4 pixels worth of data. The following frame-specific information can be provided: Timestamp Gain Exposure Brightness White Balance Blackfly PGE Technical Reference 90

102 8 Blackfly PGE Attributes Frame counter Strobe Pattern counter GPIO pin state ROI position If you turned on all possible options the first 40 bytes of image data would contain camera information in the following format, when accessed using the FlyCapture 2 API: (assuming unsigned char* data = rawimage.getdata(); and an Image object rawimage): data[0] = first byte of Timestamp data data[4] = first byte of Gain data data[24] = first byte of Frame Counter data If only Exposure embedding were enabled, then the first 4 bytes of the image would contain Exposure information for that image. Similarly, if only Brightness embedding were enabled, the first 4 bytes would contain Brightness information. For monochrome cameras, white balance is still included, but no valid data is provided. To access embedded information: CSRs FRAME_INFO: 12F8h Interpreting Timestamp information The Timestamp format is as follows (some cameras replace the bottom 4 bits of the cycle offset with a 4-bit version of the Frame Counter): Cycle_count increments from 0 to 7999, which equals one second. Second_count increments from 0 to 127. All counters reset to 0 at the end of each cycle. Interpreting ROI information The first two bytes are the distance from the left frame border that the region of interest (ROI) is shifted. The next two bytes are the distance from the top frame border that the ROI is shifted White Balance White balance is applicable to color models only. Blackfly PGE Technical Reference 91

103 8 Blackfly PGE Attributes The Blackfly PGE supports white balance adjustment, which is a system of color correction to account for differing lighting conditions. Adjusting white balance by modifying the relative gain of R, G and B in an image enables white areas to look "whiter". Taking some subset of the target image and looking at the relative red to green and blue to green response, the objective is to scale the red and blue channels so that the response is 1:1:1. The user can adjust the red and blue values. Both values specify relative gain, with a value that is half the maximum value being a relative gain of zero. White Balance has two states: State Off On/Manual Description The same gain is applied to all pixels in the Bayer tiling. The Red value is applied to the red pixels of the Bayer tiling and the Blue value is applied to the blue pixels of the Bayer tiling. The following table illustrates the default gain settings for most cameras. Red Blue Black and White Color The camera can also implement Continuous and Once white balance. One use of Continuous and Once white balance is to obtain a similar color balance between cameras that are slightly different from each other. In theory, if different cameras are pointed at the same scene, using Continuous and Once results in a similar color balance between the cameras. Once only attempts to automatically adjust white balance for a set period of time before stopping. It uses a white detection algorithm that looks for whitish pixels in the raw Bayer image data. Once adjusts the white balance for a specific number of iterations; if it cannot locate any whitish pixels, it will gradually look at the whitest objects in the scene and try to work off them. It will continue this until has completed its finite set of iterations. Continuous is continually adjusting white balance. It differs from Once in that it works almost solely off the whitest objects in the scene. Note: The white balance of the camera before using Continuous and Once must already be relatively close; that is, if Red is set to 0 and Blue is at maximum (two extremes), Continuous and Once will not function as expected. However, if the camera is already close to being color balanced, then Continuous and Once will function properly. Note: The term Continuous is the same as Auto and the term Once is the same as One Push. Blackfly PGE Technical Reference 92

104 8 Blackfly PGE Attributes To adjust white balance: GenICam Analog Control FlyCapture API Setting White Balance Using the FlyCapture API 8.18 Bayer Color Processing Bayer color processing is applicable to color models only. A Bayer tile pattern color filter array captures the intensity red, green or blue in each pixel on the sensor. The image below is an example of a Bayer tile pattern. To determine the actual pattern on your camera, query the Pixel Color Filter GenICam feature. Figure 8.2: Example Bayer Tile Pattern In order to produce color (e.g. RGB, YUV) and greyscale (e.g. Y8, Y16) images, color models perform on-board processing of the Bayer tile pattern output produced by the sensor. Conversion from RGB to YUV uses the following formula: To convert the Bayer tile pattern to greyscale, the camera adds the value for each of the RGB components in the color processed pixel to produce a single greyscale (Y) value for that pixel, as follows: To control Bayer color processing: GenICam Image Format Control FlyCapture API Accessing Raw Bayer Data using FlyCapture Accessing Raw Bayer Data The actual physical arrangement of the red, green and blue "pixels" for a given camera is determined by the Blackfly PGE Technical Reference 93

105 8 Blackfly PGE Attributes arrangement of the color filter array on the imaging sensor itself. The format, or order, in which this raw color data is streamed out, however, depends on the specific camera model and firmware version. Related Knowledge Base Articles Title Article Different color processing algorithms Knowledge Base Article Writing color processing software and color interpolation algorithms Knowledge Base Article How is color processing performed on my camera's images? Knowledge Base Article Hue Hue is applicable to color models only. This provides a mechanism to control the Hue component of the images being produced by the Blackfly PGE, given a standard Hue, Saturation, Value (HSV) color space. To adjust hue use: GenICam Analog Control FlyCapture API Setting Hue Using the FlyCapture API 8.20 Saturation Saturation is applicable to color models only. This provides a mechanism to control the Saturation component of the images being produced by the Blackfly PGE, given a standard Hue, Saturation, Value (HSV) color space. Note: Saturation in this context does not refer to the saturation of a sensor charge. To adjust saturation use: GenICam Analog Control FlyCapture API Setting Saturation Using the FlyCapture API Blackfly PGE Technical Reference 94

106 9 Troubleshooting 9 Troubleshooting 9.1 Downloads and Support [[[Undefined variable Variables.Company]]] endeavors to provide the highest level of technical support possible to our customers. Most support resources can be accessed through the Support section of our website. The first step in accessing our technical support resources is to obtain a Customer Login Account. This requires a valid name and address. To apply for a Customer Login Account go to our Downloads page. Customers with a Customer Login Account can access the latest software and firmware for their cameras from our website. We encourage our customers to keep their software and firmware up-to-date by downloading and installing the latest versions Finding Information FlyCapture SDK The FlyCapture SDK provides API examples and the FlyCap camera evaluation application. Available from our Downloads page. API Documentation The installation of the FlyCapture SDK comes with API references for C++, C#, and C code. Available from Start Menu All Programs Point Grey FlyCapture2 SDK Documentation Product Documentation The camera's Getting Started Manual provides information on installing components and software needed to run the camera. The Technical Reference provides information on the camera s specifications, features and operations, as well as imaging and acquisition controls. They are available from the Downloads page. Knowledge Base A database of articles and application notes with answers to common questions as well as articles and tutorials about hardware and software systems. Available from our Knowledge Base. Learning Center Our Learning Center contains links to many resources including videos, case studies, popular topics, other application notes, and information on sensor technology Contacting Technical Support Before contacting Technical Support, have you: 1. Read the product documentation? 2. Searched the Knowledge Base? 3. Downloaded and installed the latest version of software and/or firmware? If you have done all the above and still can t find an answer to your question, contact our Technical Support team. Blackfly PGE Technical Reference 95

107 9 Troubleshooting 9.2 Camera Diagnostics Use the following parameters to monitor the error status of the camera and troubleshoot problems: Time from Initialize This reports the time, in seconds, since the camera was initialized during a hard power-up. This is different from powering up the camera, which will not reset this time. Link Up Time This reports the time, in seconds, since the last Ethernet reconnection occurred. This will be equal to the Time from Initialize if no reconnection has occurred since the last time the camera was initialized. Transmit Failure This contains a count of the number of failed frame transmissions that have occurred since the last reset. Camera Log This provides access to the camera s 256 byte internal message log, which is often useful for debugging camera problems. Contact technical support for interpretation of message logs. To access the camera diagnostics GenICam Device Control CSRs Control and Status Registers 9.3 Status Indicator LED The user can turn off the camera s status LED. LEDs are re-enabled the next time the camera is power cycled. Off LED Status Steady green, high intensity (~5 seconds) Green/Red, flashing (~2 seconds) Green flashing quickly, low intensity One green blink (~1-2 seconds) Two green blinks (~1-2 seconds) Three green blinks (~1-2 seconds) Three red blinks (~1-2 seconds) Steady green, high intensity Red/Green flashing quickly Red flashing slowly Not receiving power 1. Camera powers up Description 2. Camera programs the FPGA 3. Establishing IP connection. The camera attempts to establish an IP connection in the following order: i) A persistent IP address, if enabled and available; ii) a DHCP address, if enabled and available; iii) a link-local address (LLA). iv) Failure to establish connection 4. Camera is streaming images Firmware update in progress General error - contact technical support For information on the LED register, see LED_CTRL: 1A14h on page 135. Blackfly PGE Technical Reference 96

108 9 Troubleshooting 9.4 Test Pattern The camera is capable of outputting continuous static images for testing and development purposes. The test pattern image is inserted into the imaging pipeline immediately prior to the transfer to the on-board FIFO, and is therefore not subject to changes in imaging parameters. Note: If you enable raw Bayer output when operating in a monochrome data format it produces an image shift effect in the test pattern. To use test pattern: GenICam Image Format Control Figure 9.1: Test Pattern Sample Image Blackfly PGE Technical Reference 97