FLIR GRASSHOPPER 3 Series Technical Reference

FLIR GRASSHOPPER 3 Series Technical Reference

Gige vision
Table of Contents

Advertisement

TECHNICAL REFERENCE
FLIR
Copyright © 2013-2017 FLIR Integrated Imaging Solutions Inc.
All rights reserved.
GRASSHOPPER®3
Version 3.1
Revised 2/10/2017
GigE   Vision

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GRASSHOPPER 3 Series and is the answer not in the manual?

Questions and answers

Summary of Contents for FLIR GRASSHOPPER 3 Series

  • Page 1 TECHNICAL REFERENCE FLIR GRASSHOPPER®3 GigE   Vision Version 3.1 Revised 2/10/2017 Copyright © 2013-2017 FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 2 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...
  • Page 3: Table Of Contents

    3.2 Using GenICam Applications 3.3 Using GigE Vision Bootstrap Registers 3.4 Using Control and Status Registers 4 Grasshopper3 PGE Physical Interface 4.1 Grasshopper3 PGE Physical Description 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 4 6.2.5 GPIO Mode 4: Pulse Width Modulation (PWM) 6.3 GenICam Digital Input/Output Control 6.4 Programmable Strobe Output 6.5 Pulse Width Modulation (PWM) 6.6 Serial Communication 6.7 Debouncer 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 5 8.4.3 GS3-PGE-50S5 Frame Rates by Video Mode 8.4.3.1 GS3-PGE-50S5M 8.4.3.2 GS3-PGE-50S5C 8.4.4 GS3-PGE-60S6 Frame Rates by Video Mode 8.4.4.1 GS3-PGE-60S6M 8.4.4.2 GS3-PGE-60S6C 8.4.5 GS3-PGE-91S6 Frame Rates by Video Mode 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 6 A.1 Setting a GPIO Pin to Strobe Using the FlyCapture API A.2 Setting a Standard Video Mode, Format and Frame Rate Using the FlyCapture API A.3 Asynchronous Hardware Triggering Using the FlyCapture API 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 7 B.15 MultipleCameraEx B.16 MultipleCameraWriteToDiskEx B.17 MultiSyncEx B.18 SaveImageToAviEx B.19 SaveImageToFlashEx B.20 SerialPortEx C GenICam Features C.1 Device Control C.2 Analog Control C.3 Image Format Control 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 8 E.1 IMAGE_RETRANSMIT: 634h E.2 GPIO_XTRA: 1104h E.3 FRAME_INFO: 12F8h E.4 INITIALIZE: 000h E.5 TEMPERATURE: 82Ch E.6 VMODE_ERROR_STATUS: 628h E.7 CAMERA_LOG: 1D00 – 1DFFh E.8 LED_CTRL: 1A14h 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 9: About This Manual

    Information on GigE Vision Bootstrap Registers. Bootstrap Registers Appendix: Control and Information on IIDC Control and Status Registers for functions not handled via Status Registers FlyCapture API. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 10 Find answers to commonly asked questions in our Knowledge Base Knowledge Base Downloads Download the latest documents and software Contact Information Contact Us on our website 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 11 Support for GS3-PGE-50S5 and GS3-PGE-91S6 New template January 27, 2017 Minor bug fixes Corrected GS3-PGE-23S6 frame rate and video modes for firmware February 10, 2017 1.11.3.0 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 12: Grasshopper3 Pge Specifications

    Operating: 20% to 80% (no condensation) Operating: 20% to 80% (no condensation) Humidity Storage: 20% to 95% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 13: Gs3-Pge-50S5 Specifications

    Operating: 20% to 80% (no condensation) Operating: 20% to 80% (no condensation) Humidity Storage: 20% to 95% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 14: Gs3-Pge-60S6 Specifications

    Operating: 20% to 80% (no condensation) Operating: 20% to 80% (no condensation) Humidity Storage: 20% to 95% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 15: Gs3-Pge-91S6 Specifications

    Operating: 20% to 80% (no condensation) Operating: 20% to 80% (no condensation) Humidity Storage: 20% to 95% (no condensation) Storage: 20% to 95% (no condensation) Warranty 3 years 3 years 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 16: Analog-To-Digital Converter (Adc)

    The bit depth of the output varies between sensors and can be seen in the table below. Model GS3-PGE-23S6M-C 10-bit GS3-PGE-23S6C-C 10-bit GS3-PGE-50S5M-C 14-bit GS3-PGE-50S5C-C 14-bit GS3-PGE-60S6M-C 14-bit GS3-PGE-60S6C-C 14-bit GS3-PGE-91S6M-C 14-bit GS3-PGE-91S6C-C 14-bit 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 17: Grasshopper3 Pge Installation

    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. 2.1.3 Do you have a downloads account? downloads...
  • Page 18: Installing Your Interface Card And Software

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 19 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.) 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 20: Installing Your Camera

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 21 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). 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 22: Configuring Camera Setup

    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.
  • Page 23: Allocating Bandwidth

    To minimize CPU usage, increase the packet size. The upper limit depends on your host adapter, your Ethernet switches (if used), and the camera. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 24: Packet Delay

    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 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 25: Configuring Other Network Settings

    GigE Vision standard. A listing of all network- related bootstrap registers supported on the camera is provided in GigE Vision Bootstrap Registers. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 26: Stream Channel Destination Address

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 27: Tools To Control The Grasshopper3 Pge

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 28: Using Gige Vision Bootstrap Registers

    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.
  • Page 29 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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 30: Grasshopper3 Pge Physical Interface

    4. Gigabit Ethernet connector (Ethernet Connector) 5. Status LED (Status Indicator LED) 6. GPIO (Input/Output Control) 7. M3 x 0.5 mounting holes 8. Camera label 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 31: Grasshopper3 Pge Dimensions

    Model Barrel Length "A" GS3-PGE-23S6 7.480 GS3-PGE-50S5 8.000 GS3-PGE-60S6 8.400 GS3-PGE-91S6 8.400 Note: To obtain 3D models, go to our Downloads site or contact Support. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 32: Mounting With The Case Or Mounting Bracket

    Knowledge Base Article 10694 The lens mount is compatible with C-mount lenses. Correct focus cannot be achieved using a CS-mount lens on a C-mount camera. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 33: Back Flange Distance

    The resulting C-mount BFD is 17.99 mm. For more information about the IRC filter, see Infrared Cut-Off Filters. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 34: Handling Precautions And Camera Care

    This is expected behavior and will not damage the camera electronics. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 35: Dust Protection

    Related Knowledge Base Articles Title Article Removing the IR filter from a color camera Knowledge Base Article 10080 Selecting a lens for your camera Technical Application Note 10694 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 36: Infrared Cut-Off Filters

    4 Grasshopper3 PGE Physical Interface 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.
  • Page 37: Camera Interface And Connectors

    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. To purchase a recommended cable from FLIR, visit our Accessories page.
  • Page 38 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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 39: General Grasshopper3 Pge Operation

    Input/Output Control. The camera selects whichever power source is supplying a higher voltage. FLIR sells a 12 V wall-mount power supply equipped with a HR25 8-pin GPIO wiring harness for connecting to the camera. For more information, see our Accessories page.
  • Page 40: User Sets (Memory Channels)

    Default DefaultUserSet Default User Set Selects the default user set as the default start up set User Set 1 User Set 2 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 41: On-Camera Frame Buffer

    The camera has 2 MB non-volatile memory for users to store data. FlyCapture SDK example program—SaveImageToFlashEx Related Knowledge Base Articles Title Article Storing data in on-camera flash memory Knowledge Base Article 10370 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 42: Camera Firmware

    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 10310 Determining the firmware version used by my camera Knowledge Base Article 10312...
  • Page 43: Input/Output Control

    Power can be provided through the GPIO interface. The camera selects whichever power source is supplying a higher voltage. For more information on camera power, see Powering the Camera. For details on GPIO circuits, see GPIO Electrical Characteristics. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 44: Gpio Modes

    When a GPIO pin is set to GPIO Mode 4, the pin outputs a specified number of pulses with programmable high and low duration. See Pulse Width Modulation (PWM). 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 45: Genicam Digital Input/Output Control

    (same as Line 1 for global exposure on the first line (All pixels). reset mode) 3.3VEnable 3.3 V Enable Enable or disable 3.3 V output 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 46: Programmable Strobe Output

    Buffering a GPIO pin strobe output signal using an optocoupler to drive external Knowledge Base Article 10585 devices GPIO strobe signal continues after isochronous image transfer stops Knowledge Base Article 10078 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 47: Pulse Width Modulation (Pwm)

    PWM pin from GPIO Mode 4 to GPIO Mode 1. To control PWM: GenICam—Digital Input Output Control CSRs—GPIO_CTRL_PIN: 1110h-1140h GPIO_XTRA_PIN: 1114h-1144h 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 48: Serial Communication

    The receive buffer size is 8 KB. Block reads and writes are both supported. Neither their length nor their address have to be 32- bit aligned or divisible by 4. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 49: Debouncer

    Note: Each GPIO has its own input delay time. The debouncer time adds additional delay to the signal on the pin. Figure 6.1: Debouncer Filtering Invalid Signals To set the debouncer: GenICam—Digital Input Output Control 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 50: Gpio Electrical Characteristics

    Table 6.3: Absolute Maximum Ratings Description Minimum Maximum Non-opto-isolated Voltage -24 V 42 V Opto-isolated Input Voltage -70 V 40 V Opto-isolated Output Voltage -24 V 24 V 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 51 30 V 4.7 kΩ 1.3 V 15.0 V 6.1 mA Values are for reference only Figure 6.2: Opto-isolated input circuit Figure 6.3: Opto-isolated output circuit 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 52 6 Input/Output Control Note: identical for IO3 pin 4 Figure 6.4: Input/output circuit 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 53: Image Acquisition

    AcquisitionFrameCount acquire in Multi Frame Count acquisition mode Controls the acquisition Acquisition Frame Rate AcquisitionFrameRate rate (in Hertz) at which the (Hz) frames are captured 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 54 Lower limit of the auto pgrAutoExposureCompensationLowerLimit Compensation Lower exposure compensation Limit value(EV) parameter Auto Exposure Upper limit of the auto pgrAutoExposureCompensationUpperLimit Compensation Upper exposure compensation Limit value(EV) parameter 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 55: Standard External Trigger (Mode 0)

    Polarity Low/High Trigger Delay Source [8-10] GPIO Pin Exposure Mode Timed Value [11] Low/High Exposure Time Integration Time Mode [12-15] Trigger_Mode_0 Exposure Auto Parameter [20-31] None 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 56: Bulb Shutter Trigger (Mode 1)

    Low/High Trigger Delay Source [8-10] GPIO Pin Exposure Mode Trigger Width Value [11] Low/High Exposure Time Integration Time Mode [12-15] Trigger_Mode_1 Exposure Auto Parameter [20-31] None 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 57: Skip Frames Trigger (Mode 3)

    Value [11] Low/High Mode [12-15] Trigger_Mode_3 N 1 out of N images is Parameter [20-31] transmitted. Cycle time N times greater than current frame rate 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 58: Low Smear Trigger (Mode 13)

    Figure 7.4: Trigger Mode 13 (“Low Smear Trigger Mode”) Registers—TRIGGER_MODE: 830h Presence Polarity Low/High Source [8-10] GPIO Pin Value [11] Low/High Mode [12-15] Trigger_Mode_13 Parameter [20-31] None 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 59: Overlapped Exposure Readout Trigger (Mode 14)

    Figure 7.5: Trigger Mode 14 (“Overlapped Exposure/Readout Mode”) Registers—TRIGGER_MODE: 830h Presence Polarity Low/High Source [8-10] GPIO Pin Value [11] Low/High Mode [12-15] Trigger_Mode_14 Parameter [20-31] None 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 60: Multi-Shot Trigger (Mode 15)

    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 10087 Figure 7.6: Trigger Mode 15, when N is greater than 0. (“Multi-Shot Trigger Mode”) Registers—TRIGGER_MODE: 830h...
  • Page 61: External Trigger Timing

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 62: Changing Video Modes While Triggering

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 63: Asynchronous Software Triggering

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 64: Grasshopper3 Pge Attributes

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 65 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...
  • Page 66: Video Modes Overview

    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.
  • Page 67: Grasshopper3 Pge Video Mode Descriptions

    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. Compared to Mode 1, 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 68 CCD models implement single tap readout and extended shutter mode. The GS3-PGE-23S6 model supports a 12-bit ADC in mode 7 (all other video modes for this model support a 10-bit ADC). 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 69: Genicam Image Format Control

    Number of vertical pixels to combine together Dynamic Range Indicates the minimum pixel value transferred from the PixelDynamicRangeMin camera Dynamic Range Indicates the maximum pixel value transferred from PixelDynamicRangeMax the camera 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 70 Disabling On Board Color Processing bypasses the On Board Color True OnBoardColorProcessing FPGA/color core, which disables image processing, but Processing False allows for faster frame rates. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 71: Frame Rates

    (Bandwidth / (W x H x BPP)) / Number of Cameras Frame Rate (105980000 / (1920 x 1200 x 1)) / 1 Frame Rate 46 FPS 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 72: Gs3-Pge-23S6 Frame Rates By Video Mode

    160 x Pixel Format 1200 1080 1200 8-bit (Mono8, Raw8) 1179 12-bit (Mono12, Raw12, 1179 YUV411) 16-bit (Mono16, Raw16, 1179 YUV422) 24-bit (YUV444, RGB8) 1179 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 73 640 x 320 x 160 x Pixel Format 1200 1080 1200 8-bit (Mono8, Raw8) 12-bit (Mono12, Raw12, YUV411) 16-bit (Mono16, Raw16, YUV422) 24-bit (YUV444, RGB8) 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 74: Gs3-Pge-50S5 Frame Rates By Video Mode

    1024 x 768 800 x 600 640 x 480 320 x 240 All Formats Mode 5 Pixel Format 612 x 512 320 x 240 All Formats 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 75: Gs3-Pge-60S6 Frame Rates By Video Mode

    1368 x 364 1368 x 2 All Formats Mode 5 Pixel Format 684 x 548 684 x 364 684 x 182 684 x 2 All Formats 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 76 Mode 7 Pixel Format 2736 x 2192 2736 x 1460 2736 x 730 2736 x 2 Mono8, Raw8, Mono12, Raw12, YUV411, Mono16, Raw16, YUV422 YUV444, RGB8 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 77: Gs3-Pge-91S6 Frame Rates By Video Mode

    11.5 Mode 4 Pixel Format 1688 x 1352 1280 x 960 1024 x 768 800 x 600 640 x 480 320 x 240 All Formats 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 78 Mode 7 Pixel 3376 x 2448 x 1920 x 1280 x 1024 x 800 x 640 x 320 x Format 2704 2448 1080 All Formats 10.5 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 79: Readout Method (Shutter Type)

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 80: Overview Of Imaging Parameters

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 81: Genicam Analog Control

    Saturation Saturation of the image in percent (percent) True Saturation Enabled Enables/disables saturation False Controls the mode for automatic saturation Saturation Auto Once adjustment Continuous 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 82: Brightness

    Grasshopper3 cameras the maximum range is in Mode 7. For the GS3-PGE-23S6 models, maximum exposure can be achieved when packet size is set to minimum. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 83: Gain

    -6.158 dB to 24 dB, increment 0.985 dB 1.9.3.0 GS3-PGE-91S6M-C -9.431 dB to 24 dB, increment 0.035 dB 1.5.3.0 GS3-PGE-91S6C-C -9.431 dB to 24 dB, increment 0.035 dB 1.5.3.0 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 84: Auto Exposure

    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.  2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 85: Sharpness

    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: 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 86: 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 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 87: Image Flip/Mirror

    4 pixels worth of data. The following frame-specific information can be provided: Timestamp Gain Exposure Brightness White Balance Frame counter Strobe Pattern counter GPIO pin state ROI position 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 88: White Balance

    "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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 89 Note: The term Continuous is the same as Auto and the term Once is the same as One Push. To adjust white balance: GenICam—Analog Control FlyCapture API—Setting White Balance Using the FlyCapture API 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 90: Bayer Color Processing

    The format, or order, in which this raw color data is streamed out, however, depends on the specific camera model and firmware version. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 91: Hue

    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 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 92: Troubleshooting

    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. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 93: Camera Diagnostics

    Red/Green flashing quickly Firmware update in progress Red flashing slowly General error - contact technical support For information on the LED register, see LED_CTRL: 1A14h on page 118. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 94: Test Pattern

    Note: If you enable raw Bayer output when operating in a monochrome data format it produces an image shift effect in the test pattern. Figure 9.1: Test Pattern Sample Image GenICam—Image Format Control 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 95: Channel Balancing

    Figure 9.2: Example of dual channel image with no balancing To address this issue, FLIR "balances" every multiple tap unit as part of the quality control process. This balancing process attempts to minimize the difference in gains that result from the different A/D converters.
  • Page 96: Blemish Pixel Artifacts

    Pixel Defect Correction FLIR tests for blemish pixels on each camera. The mechanism to correct blemish pixels is hard-coded into the camera firmware, and can be turned off and on by the user. Pixel correction is on by default. The correction algorithm involves applying the average color or grayscale values of neighboring pixels to the blemish pixel.
  • Page 97: Vertical Smear Artifact

    Related Knowledge Base Articles Title Article Vertical bleeding or smearing from a saturated portion of an image Knowledge Base Article 10317 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 98: A Flycapture Api Code Samples

    Configures GPIO0 as the trigger input source. Enables triggered acquisition. Specifies the trigger signal polarity as an active high (rising edge) signal. Assuming a Camera object cam: 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 99: Setting Brightness Using The Flycapture Api

    The following FlyCapture code snippet adjusts the shutter speed to 20 ms using the C++ interface. The snippet assumes a Camera object cam. //Declare a Property struct. Property prop; //Define the property to adjust. prop.type = SHUTTER; //Ensure the property is on. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 100: Setting Gain Using The Flycapture Api

    The following FlyCapture code snippet adjusts auto exposure to - 3.5 EV using the C++ interface. The snippet assumes a Camera object cam. //Declare a Property struct. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 101: Setting Sharpness Using The Flycapture Api

    Setting Gamma Using the FlyCapture API The following FlyCapture code snippet adjusts gamma to 1.5 using the C++ interface. The snippet assumes a Camera object cam. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 102: Setting White Balance Using The Flycapture Api

    //Set the white balance red channel to 500. prop.valueA = 500; //Set the white balance blue channel to 850. prop.valueB = 850; //Set the property. error = cam.SetProperty( &prop ); 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 103: Accessing Raw Bayer Data Using Flycapture

    The following FlyCapture code snippet adjusts saturation to 200% using the C++ interface. The snippet assumes a Camera object cam. //Declare a property struct. Property prop; 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 104 //Ensure the property is set up to use absolute value control. prop.absControl = true; //Set the absolute value of saturation to 200%. prop.absValue = 200; //Set the property. error = cam.SetProperty( &prop ); 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 105: B Flycapture Sdk Examples

    VB.NET CustomImageEx The CustomImageEx example program demonstrates how to configure a FLIR machine vision camera to output custom sized images - the FlyCapture equivalent of the IIDC specifications 'Format 7'. Custom image modes are often useful for achieving faster frame rates, reducing the resolution of an image, and allowing more cameras to run on a single bus by reducing bandwidth requirements.
  • Page 106: Extendedshutterex

    The ExtendedShutterEx example program demonstrates how to enable and calculate extended integration times for your camera. The way this is done can differ between cameras. Many applications require extended shutter (integration) times up to several seconds long. Most FLIR machine vision cameras implement extended shutter functionality in one of two ways: 1.
  • Page 107: Flycap2Mfc

    The FlyCap2MFC example is the equivalent of the FlyCap2 example program, except it uses the Microsoft Foundation Class Library to implement the graphical user interface. Like FlyCap2, it is the main FLIR machine vision camera application used to work with single lens cameras. It allows a user to select a camera to start, and then starts streaming the images to screen.
  • Page 108: Gigegrabex

    HDR register. Once the images are saved to disk, the program cleans up and exits. B.14 ImageEventEx Note: This example works with FireWire cameras only. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 109 = ceiling(( rows * cols * bytesPerPixel)/bytesPerPacket) If the camera has already been started with the chosen bytes per packet, this value can be queried from the format 7 registers. See the entry for PACKET_PER_FRAME_INQ (0x048) in the FLIR Machine Vision Camera Register Reference.
  • Page 110: Multiplecameraex

    Note: This example does not perform image grabbing. You have to write your own image acquisition program or use existing FlyCapture2 examples such as MultipleCameraEx to perform synchronized image grab. 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 111: Saveimagetoaviex

    Users can use the 'Write Register Value' button to set the serial port register values, and use 'Read Register Value' to get the serial port register values.  2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 112: C Genicam Features

    Latches the current TimestampLatch Timestamp Latch camera time into the Write Only timestamp register Indicates the timestamp TimestampIncrement Timestamp Increment increment in ns/tick 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 113: Analog Control

    Controls the ratio of the selected color component BalanceRatio Balance Ratio to a reference color component Balance White Controls the mode for automatic white balancing BalanceWhiteAuto Once Auto between color channels Continuous 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 114: Image Format Control

    ReverseX Reverse X is applied after the flip False On Board Color Enable FPGA processing (i.e., Gamma/Lookup table). True Process Enabled This limits frame rate. False 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 115: Acquisition Control

    Starts the acquisition of the AcquisitionStart Acquisition Start Write Only device Stops the acquisition of the AcquisitionStop Acquisition Stop device at the end of the Write Only current frame 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 116 Exposure mode is Timed Continuous Sets the automatic Exposure pgrExposureCompensationAuto exposure compensation Compensation Auto value mode The measured or target Exposure pgrExposureCompensation image plane illuminance in Compensation 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 117: Digital Input Output Control

    (same as Line 1 for global exposure on the first line (All pixels). reset mode) 3.3VEnable 3.3 V Enable Enable or disable 3.3 V output 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 118: Transport Layer Control

    False network interface Indicates if Persistent IP GEV Current configuration scheme is True GevCurrentIPConfigurationPersistentIP IPConfiguration activated on the given False Persistent IP network interface 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 119 IP configuration scheme. Indicates the speed of transmission negotiated by GevLinkSpeed GEV Link Speed the given network interface in Mbps 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 120 Indicates the number of GEV Stream Channel GevStreamChannelCount stream channels Count supported by this device Indicates the current GevHeartbeatTimeout GEV Heartbeat Timeout heartbeat timeout in milliseconds 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 121 Indicates the destination GevSCDA GEV SCDA IP address for this stream channel Indicates the source UDP GevSCSP GEV SCSP port address for this stream channel 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 122: User Set Control

    Selects which chunk data to enable or control Width Height Exposure Time Gain Black Level Enables the inclusion of the selected Chunk data in ChunkEnable Chunk Enable the payload of the image 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 123: Lut Control

    Device- LUTValue LUT Value LUTSelector specific Accesses all the LUT coefficients in a single access without Device- LUTValueAll Lut Value All using individual LUTIndex specific 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 124: D Gige Vision Bootstrap Registers

    Stream Channels Capability Read 0934h GVCP Capability Read 0938h Heartbeat Timeout Read/Write 093Ch (high part) Timestamp Tick Frequency Read 0940h (low part) 0944h Timestamp Control Write 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 125 0 <= x < 512 Stream Channel Packet Delay Read/Write 0D18h + 40h * x Stream Channel Destination with 0 <= x < 512 Read/Write Address 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 126: E Control And Status Registers

    Camera Log—CAMERA_LOG: 1D00 – 1DFFh Control—LED_CTRL: 1A14h A complete list of CSRs can be found in the FLIR Machine Vision Camera Register Reference. IMAGE_RETRANSMIT: 634h This register provides an interface to the camera’s frame buffer functionality. Transmitting buffered data is available when continuous shot is disabled. Either One shot or Multi shot can be used to transmit buffered data when Transfer_Data_Select = 1.
  • Page 127: Gpio_Xtra: 1104H

    GPIO_State_Inq Strobe_Pat_Inq Frame_Count_Inq WB_CSR_Inq [10] Presence of image-specific information display 0: Not Available, 1: Available Exp_CSR_Inq [11] Bright_CSR_Inq [12] Shutter_CSR_Inq [13] Gain_CSR_Inq [14] Time_Inq [15] 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 128: Initialize: 000H

    Presence of this feature Presence_Inq 0: Not Available, 1: Available [1-19] Reserved Value. Value [20-31] In Kelvin (0°C = 273.15K) in increments of one-tenth (0.1) of a Kelvin 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 129: Vmode_Error_Status: 628H

    Field Description Presence of this feature Presence_Inq 0: Not Available, 1: Available [1-22] Reserved Enable or disable the LED LED_Ctrl [23-31] 0x00: Off, 0x74: On 2/10/2017 ©2013-2017 ® Grasshopper 3 PGE Technical Reference FLIR Integrated Imaging Solutions Inc. All rights reserved.

Table of Contents

Save PDF