CM3 U3 Technical Reference
CM3 U3 Technical Reference
FLIR
CHAMELEON®3
USB3 Vision
Version 5.0
Revised 1/26/2017
Hardware Warranty
The warranty for the Chameleon3 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?
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference
Solutions Inc. All rights reserved.
Table of Contents
About This Manual i
1 Chameleon3 Specifications 1
1.1 CM3-U3-13S2 Specifications 1
1.2 CM3-U3-13Y3 Specifications 2
1.3 CM3-U3-28S4 Specifications 3
1.4 CM3-U3-31S4 Specifications 4
1.5 CM3-U3-50S5 Specifications 5
1.6 Analog-to-Digital Converter (ADC) 6
2 Chameleon3 Installation 7
2.1 Before You Install 7
2.1.1 Will your system configuration support the camera? 7
2.1.2 Do you have all the parts you need? 7
2.1.3 Do you have a downloads account? 7
2.2 Installing Your Interface Card and Software 8
2.3 Installing Your Camera 9
2.4 Configuring Camera Setup 10
2.4.1 Configuring Camera Drivers 10
2.4.2 Maximum Number of Cameras on a Single Bus 10
3 Tools to Control the Chameleon3 11
3.1 Using Spinnaker® 11
3.1.1 SpinView Program 11
3.1.2 Custom Applications Built with the Spinnaker API 11
3.2 Using FlyCapture® 11
3.2.1 FlyCap Program 11
3.2.2 Custom Applications Built with the FlyCapture API 12
3.3 Using GenICam Applications 12
3.4 Using Control and Status Registers 13
4 Chameleon3 Physical Interface 14
4.1 Chameleon3 Modular Options 14
4.2 Chameleon3 Physical Description 15
4.3 Chameleon3 Dimensions 16
4.4 Mounting with the Case or Mounting Bracket 18
4.5 Lens Mounting 18
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference
Solutions Inc. All rights reserved.
4.5.1 Back Flange Distance 18
4.6 Handling Precautions and Camera Care 19
4.6.1 Case Temperature and Heat Dissipation 19
4.7 Dust Protection 20
4.8 Infrared Cut-Off Filters 21
4.9 Camera Interface and Connectors 22
4.9.1 USB 3.1 Connector 22
4.9.2 Interface Cables 23
4.9.3 Interface Card 23
4.9.4 General Purpose Input/Output (GPIO) 23
5 General Chameleon3 Operation 24
5.1 Powering the Camera 24
5.2 User Sets (Memory Channels) 25
5.2.1 GenICam User Set Control 25
5.3 On-Camera Frame Buffer 26
5.4 Non-Volatile Flash Memory 26
5.5 Camera Firmware 27
5.5.1 Determining Firmware Version 27
5.5.2 Upgrading Camera Firmware 27
6 Input/Output Control 29
6.1 General Purpose Input/Output (GPIO) 29
6.2 GPIO Modes 30
6.2.1 GPIO Mode 0: Input 30
6.2.2 GPIO Mode 1: Output 30
6.2.3 GPIO Mode 2: Asynchronous (External) Trigger 30
6.2.4 GPIO Mode 3: Strobe 30
6.3 GenICam Digital Input/Output Control 31
6.4 Programmable Strobe Output 32
6.5 Serial Communication 33
6.6 Debouncer 34
6.7 GPIO Electrical Characteristics 35
7 Image Acquisition 37
7.1 Asynchronous Triggering 37
7.1.1 GenICam Acquisition Control 37
7.1.2 Standard External Trigger (Mode 0) 39
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference
Solutions Inc. All rights reserved.
7.1.3 Bulb Shutter Trigger (Mode 1) 40
7.1.4 Low Smear Trigger (Mode 13) 41
7.1.5 Overlapped Exposure Readout Trigger (Mode 14) 42
7.1.6 Multi-Shot Trigger (Mode 15) 43
7.2 External Trigger Timing 45
7.3 Camera Behavior Between Triggers 45
7.4 Changing Video Modes While Triggering 46
7.5 Asynchronous Software Triggering 47
8 Chameleon3 Attributes 48
8.1 Pixel Formats 48
8.1.1 Raw 48
8.1.2 Mono 48
8.1.3 RGB 48
8.1.4 YUV 48
8.2 Video Modes Overview 50
8.2.1 Chameleon3 Video Mode Descriptions 51
8.3 GenICam Image Format Control 53
8.4 Frame Rates 55
8.4.1 Calculating Maximum Possible Frame Rate 55
8.4.2 CM3-U3-13S2 Frame Rates by Video Mode 56
8.4.2.1 CM3-U3-13S2M 56
8.4.2.2 CM3-U3-13S2C 56
8.4.3 CM3-U3-13Y3 Frame Rates by Video Mode 57
8.4.3.1 CM3-U3-13Y3M 57
8.4.3.2 CM3-U3-13Y3C 57
8.4.4 CM3-U3-28S4 Frame Rates by Video Mode 58
8.4.4.1 CM3-U3-28S4M 58
8.4.4.2 CM3-U3-28S4C 58
8.4.5 CM3-U3-31S Frame Rates by Video Mode 59
8.4.5.1 CM3-U3-31S4M 59
8.4.5.2 CM3-U3-31S4C 59
8.4.6 CM3-U3-50S5 Frame Rates by Video Mode 60
8.4.6.1 CM3-U3-50S5M 60
8.4.6.2 CM3-U3-50S5C 60
8.5 Readout Method (Shutter Type) 61
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference
Solutions Inc. All rights reserved.
8.5.1 Global Shutter 62
8.6 Overview of Imaging Parameters 63
8.7 GenICam Analog Control 64
8.8 Brightness 65
8.9 Exposure Time 65
8.10 Gain 66
8.11 Auto Exposure 67
8.12 Sharpness 67
8.13 Gamma and Lookup Table 68
8.14 High Dynamic Range (HDR) Imaging 69
8.15 Image Flip/Mirror 70
8.16 Embedded Image Information 70
8.17 White Balance 71
8.18 Bayer Color Processing 73
8.19 Hue 74
8.20 Saturation 74
9 Troubleshooting 75
9.1 Downloads and Support 75
9.1.1 Finding Information 75
9.1.2 Contacting Technical Support 75
9.2 Camera Diagnostics 76
9.3 Status Indicator LED 76
9.4 Test Pattern 77
9.5 Link Recovery 78
9.6 Blemish Pixel Artifacts 79
9.6.1 Pixel Defect Correction 79
9.7 Vertical Smear Artifact 80
9.7.1 Smear Reduction 80
A FlyCapture API Code Samples 81
A.1 Setting a GPIO Pin to Strobe Using the FlyCapture API 81
A.2 Setting a Standard Video Mode, Format and Frame Rate Using the FlyCapture API 81
A.3 Asynchronous Hardware Triggering Using the FlyCapture API 81
A.4 Setting Brightness Using the FlyCapture API 82
A.5 Setting Shutter Using the FlyCapture API 82
A.6 Setting Gain Using the FlyCapture API 83
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference
Solutions Inc. All rights reserved.
A.7 Setting Auto Exposure Using the FlyCapture API 83
A.8 Setting Sharpness Using the FlyCapture API 84
A.9 Setting Gamma Using the FlyCapture API 84
A.10 Setting White Balance Using the FlyCapture API 85
A.11 Accessing Raw Bayer Data using FlyCapture 86
A.12 Setting Hue Using the FlyCapture API 86
A.13 Setting Saturation Using the FlyCapture API 86
B FlyCapture SDK Examples 88
B.1 AsyncTriggerEx 88
B.2 BusEventsEx 88
B.3 CustomImageEx 88
B.4 ExtendedShutterEx 89
B.5 FlyCap2CameraControl 89
B.6 FlyCap2_GTKmm 89
B.7 FlyCap2MFC 90
B.8 FlyCapture2GUI 90
B.9 FlyCapture2SimpleGUI_WPF 90
B.10 FlyCapture2Test 90
B.11 GigEGrabEx 91
B.12 GrabCallbackEx 91
B.13 HighDynamicRangeEx 91
B.14 ImageEventEx 91
B.15 MultipleCameraEx 93
B.16 MultipleCameraWriteToDiskEx 93
B.17 MultiSyncEx 93
B.18 SaveImageToAviEx 94
B.19 SaveImageToFlashEx 94
B.20 SerialPortEx 94
C GenICam Features 95
C.1 Device Control 95
C.2 Analog Control 97
C.3 Image Format Control 98
C.4 Acquisition Control 99
C.5 Digital Input Output Control 100
C.6 Transport Layer Control 101
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference
Solutions Inc. All rights reserved.
C.7 User Set Control 102
C.8 Chunk Data Control 102
C.9 LUT Control 103
D Control and Status Registers 104
D.1 IMAGE_RETRANSMIT: 634h 104
D.2 DATA_FLASH_CTRL: 1240h 105
D.3 DATA_FLASH_DATA: 1244h 105
D.4 GPIO_XTRA: 1104h 105
D.5 AE_ROI: 1A70 – 1A74h 106
D.6 FRAME_INFO: 12F8h 107
D.7 INITIALIZE: 000h 107
D.8 TEMPERATURE: 82Ch 108
D.9 VMODE_ERROR_STATUS: 628h 108
D.10 CAMERA_LOG: 1D00 – 1DFFh 108
D.11 LED_CTRL: 1A14h 108
D.12 PIXEL_DEFECT_CTRL: 1A60h 109
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference
Solutions Inc. All rights reserved.
About This Manual
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference i
Solutions Inc. All rights reserved.
About This Manual
Document Conventions
This manual uses the following to provide you with additional information:
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 Link
Title of the resource Link to the resource
Contacting Us
For any questions, concerns or comments please contact us via the following methods:
General questions
Email
Technical support (existing customers only)
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
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference ii
Solutions Inc. All rights reserved.
About This Manual
Revision History
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference iii
Solutions Inc. All rights reserved.
1 Chameleon3 Specifications
1 Chameleon3 Specifications
1.1 CM3-U3-13S2 Specifications
CM3-U3-13S2M CM3-U3-13S2C
Firmware 1.1.3.0 1.1.3.0
Resolution 1288 x 964 1288 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 23.991 dB -11 dB to 23.991 dB
Exposure Range 0.046 ms to 31.9 seconds 0.046 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, ROI Pixel binning, ROI
Image Processing Gamma, lookup table, and sharpness Gamma, lookup table, hue, saturation, and sharpness
HDR Sequencing 4 x exposure, 4 x gain (Firmware: 1.10.3.0) 4 x exposure, 4 x gain (Firmware: 1.10.3.0)
Image Buffer 16 MB 16 MB
User Sets 2 memory channels for custom camera settings 2 memory channels for custom camera settings
Flash Memory 1 MB non-volatile memory 1 MB non-volatile memory
Opto-isolated I/O Ports 1 input, 1 output 1 input, 1 output
Non-isolated I/O 2 bi-directional 2 bi-directional
Serial Port 1 (over non-isolated I/O) 1 (over non-isolated I/O)
Auxiliary Output 3.3 V, 150 mA maximum 3.3 V, 150 mA maximum
Interface USB 3.1 USB 3.1
Power Requirements 5 - 24 V via GPIO or 5 V via USB 3.1 interface 5 - 24 V via GPIO or 5 V via USB 3.1 interface
Power Consumption <3 W maximum <3 W maximum
44 mm x 35 mm x 19.5 mm (case enclosed); 40 mm x 44 mm x 35 mm x 19.5 mm (case enclosed); 40 mm x 31
Dimensions/Mass
31 mm (board level) /54.9 g (cased) / 27.9 g (board level) mm (board level) /54.9 g (cased) / 27.9 g (board level)
Machine Vision
USB3 Vision v1.0 USB3 Vision v1.0
Standard
CE, FCC, KCC, RoHS. The ECCN for this product is: CE, FCC, KCC, RoHS. The ECCN for this product is:
Compliance
EAR099. EAR099.
Operating: 0° to 45°C Operating: 0° to 45°C
Temperature
Storage: -30° to 60°C Storage: -30° to 60°C
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
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 1
Solutions Inc. All rights reserved.
1 Chameleon3 Specifications
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 2
Solutions Inc. All rights reserved.
1 Chameleon3 Specifications
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 3
Solutions Inc. All rights reserved.
1 Chameleon3 Specifications
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 4
Solutions Inc. All rights reserved.
1 Chameleon3 Specifications
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 5
Solutions Inc. All rights reserved.
1 Chameleon3 Specifications
The bit depth of the output varies between sensors and can be seen in the table below.
Model ADC
CM3-U3-13S2M 12-bit
CM3-U3-13S2C 12-bit
CM3-U3-13Y3M 10-bit
CM3-U3-13Y3C 10-bit
CM3-U3-28S4M 12-bit
CM3-U3-28S4C 12-bit
CM3-U3-31S4M 12-bit
CM3-U3-31S4C 12-bit
CM3-U3-50S5M 12-bit (No Mode 7 in Mode 7)
CM3-U3-50S5C 12-bit (No Mode 7 in Mode 7)
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 6
Solutions Inc. All rights reserved.
2 Chameleon3 Installation
2 Chameleon3 Installation
2.1 Before You Install
2.1.1 Will your system configuration support the camera?
Recommended System Configuration
Operating
CPU RAM Video Ports Software
System
Windows, Intel Core 2 PCIe 2.0 compatible host Microsoft Visual Studio 2010
2 GB 128
Linux (32- and Duo, or controller with USB 3.1 (to compile and run example
RAM MB
64-bit) equivalent connector code)
FLIR sells a number of the additional parts required for installation. To purchase, visit our Accessories page.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 7
Solutions Inc. All rights reserved.
2 Chameleon3 Installation
b. Select your Camera and Operating System from the drop-down lists and click the Search button.
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 USB cameras.
This selection ensures the pgrxhci (USBPro) and pgrusbcam drivers are installed.
To uninstall or reconfigure the driver at any time after setup is complete, use the DriverControlGUI (see Configuring
Camera Setup).
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 8
Solutions Inc. All rights reserved.
2 Chameleon3 Installation
Plug the interface cable into the host controller card and the camera. The cable jack
screws can be used for a secure connection.
4. Plug in the GPIO connector
b. Run the FlyCap program: All Programs->Point Grey FlyCapture2 SDK-> FlyCap
The FlyCap program can be used to test the camera's image acquisition capabilities.
Changes to your camera's installation configuration can be made using utilities available in the FlyCapture SDK
(see Configuring Camera Setup).
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 9
Solutions Inc. All rights reserved.
2 Chameleon3 Installation
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.
n Adequate bandwidth. The effective bandwidth available via the USB 3.1 bulk transfer method is 384 MB
per second. A PCIe 2.0 interface or greater is required to use the full bandwidth. PCIe 2.0 can transfer just
under 400 MB per second. However, bandwidth must be shared on the system, depending on the operating
configuration of the cameras (resolution, frame rate, and pixel format).
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 10
Solutions Inc. All rights reserved.
3 Tools to Control the Chameleon3
n GenICam Applications
Examples of the controls are provided throughout this document. Additional information can be found in the
appendices.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 11
Solutions Inc. All rights reserved.
3 Tools to Control the Chameleon3
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 12
Solutions Inc. All rights reserved.
3 Tools to Control the Chameleon3
Values
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 13
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 14
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 15
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 16
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 17
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 18
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
n If you have purchased a bare board camera you should take the following additional protective measures:
n Either handle bare handed or use non-chargeable gloves, clothes or material. Also, use conductive
shoes.
n Install a conductive mat on the floor or working table to prevent the generation of static electricity.
n When handling the camera unit, avoid touching the lenses. Fingerprints affect the quality of the image
produced by the device.
n To clean the lenses, use a standard camera lens cleaning kit or a clean dry cotton cloth. Do not apply
excessive force.
n Extended exposure to bright sunlight, rain, dusty environments, etc. may cause problems with the
electronics and the optics of the system.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 19
Solutions Inc. All rights reserved.
4 Chameleon3 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:
n Mount the camera on a heat sink, such as a camera mounting bracket, made out of a heat-conductive
material like aluminum.
n Make sure the flow of heat from the camera case to the bracket is not blocked by a non-conductive
material like plastic.
n Make sure the camera has enough open space around it to facilitate the free flow of air.
Warning!
n 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.
n Use caution when removing the protective glass or filter.
Damage to any component of the optical path voids the
Hardware Warranty.
n Removing the protective glass or filter alters the optical path of
the camera, and may result in problems obtaining proper focus
with your lens.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 20
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
Type Anti-reflective
Material Schott B270
Dimensions 14 ±0.08 x 14 ±0.08 mm
Thickness 1 ±0.07 mm
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 21
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
The USB 3.1 Micro- B receptacle accepts a USB 2.0 Micro- B plug and, therefore, the camera is backward
compatible with the USB 2.0 interface.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 22
Solutions Inc. All rights reserved.
4 Chameleon3 Physical Interface
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 23
Solutions Inc. All rights reserved.
5 General Chameleon3 Operation
Power can also be provided through the GPIO interface. For more information, see Input/Output Control. The
camera selects whichever power source is supplying a higher voltage.
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).
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 24
Solutions Inc. All rights reserved.
5 General Chameleon3 Operation
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 25
Solutions Inc. All rights reserved.
5 General Chameleon3 Operation
All images pass through the frame buffer mechanism. This introduces relatively little delay in the system.
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:
n CSRs—IMAGE_RETRANSMIT: 634h
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 26
Solutions Inc. All rights reserved.
5 General Chameleon3 Operation
2. From the Device list, right click the camera and select Update Device Firmware.
3. If you get a Device is Active warning, close the Display pane or click the Disconnect button and right click
the camera again.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 27
Solutions Inc. All rights reserved.
5 General Chameleon3 Operation
4. Click Update.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 28
Solutions Inc. All rights reserved.
6 Input/Output Control
6 Input/Output Control
6.1 General Purpose Input/Output (GPIO)
The camera has a 9-pin GPIO connector on the back of the case; refer to the diagram below for wire color-coding.
The header connector is JST part number BM09B-NSHSS-TBT and the wire plug connector is JST part number
NSHR-09V-S. The wire contacts are SSHL-003T-P0.2.
Table 6.1: GPIO pin assignments (as shown looking at rear of camera)
Diagram Color Pin Function Description
Red 1 VEXT Allows the camera to be powered externally 5 - 24 VDC
Black 2 GND Ground for Input/Output, VEXT , +3.3 V pins
White 3 +3.3 V Power external circuitry fused at 150 mA maximum
Green 4 GPIO3 / Line3 Input/Output/Tx
Purple 5 GPIO2 / Line2 Input/Output/Rx
Black 6 GND Ground for Input/Output, VEXT , +3.3 V pins
Brown 7 OPTO_GND Ground for opto-isolated IO pins
OPTO_OUT /
Orange 8 Opto-isolated output
Line1
OPTO_IN /
Yellow 9 Opto-isolated input
Line0
Power can be provided through the GPIO interface. The camera selects whichever power source is supplying a
higher voltage.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 29
Solutions Inc. All rights reserved.
6 Input/Output Control
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 30
Solutions Inc. All rights reserved.
6 Input/Output Control
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 31
Solutions Inc. All rights reserved.
6 Input/Output Control
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 32
Solutions Inc. All rights reserved.
6 Input/Output Control
SIO Buffers
Both the transmit and receive buffers are implemented as circular buffers that may exceed the 255 byte
maximum.
n The transmit buffer size is 512 B.
Block reads and writes are both supported. Neither their length nor their address have to be 32- bit aligned or
divisible by 4.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 33
Solutions Inc. All rights reserved.
6 Input/Output Control
6.6 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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 34
Solutions Inc. All rights reserved.
6 Input/Output Control
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 35
Solutions Inc. All rights reserved.
6 Input/Output Control
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 36
Solutions Inc. All rights reserved.
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 (software trigger).
To access trigger modes:
n GenICam—Acquisition Control
n FlyCapture API—AsyncTriggerEx
n CSRs—TRIGGER_MODE: 830h
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 37
Solutions Inc. All rights reserved.
7 Image Acquisition
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 38
Solutions Inc. All rights reserved.
7 Image Acquisition
GenICam—Acquisition Control
Acquisition Mode Continuous
Trigger Selector Exposure Start Registers—TRIGGER_MODE: 830h
Trigger Mode On Presence [0] 1
Trigger Source Line x (GPIO pin) ON [6] 1
Trigger Activation Rising or Falling edge Polarity [7] Low/High
Trigger Delay 0 Source [8-10] GPIO Pin
Exposure Mode Timed Value [11] Low/High
Exposure Time Integration Time Mode [12-15] Trigger_Mode_0
Exposure Auto Off Parameter [20-31] None
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 39
Solutions Inc. All rights reserved.
7 Image Acquisition
GenICam—Acquisition Control
Acquisition Mode Trigger width
Trigger Selector Exposure Active Registers—TRIGGER_MODE: 830h
Trigger Mode On Presence [0] 1
Trigger Source Line x (GPIO pin) ON [6] 1
Trigger Activation Rising or Falling edge Polarity [7] Low/High
Trigger Delay 0 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 Off Parameter [20-31] None
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 40
Solutions Inc. All rights reserved.
7 Image Acquisition
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
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 41
Solutions Inc. All rights reserved.
7 Image Acquisition
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
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 42
Solutions Inc. All rights reserved.
7 Image Acquisition
Figure 7.5: Trigger Mode 15, when N is greater than 0. (“Multi-Shot Trigger Mode”)
Registers—TRIGGER_MODE: 830h
Presence [0] 1
ON [6] 1
Polarity [7] Low/High
Source [8-10] GPIO Pin
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 43
Solutions Inc. All rights reserved.
7 Image Acquisition
Registers—TRIGGER_MODE: 830h
Value [11] Low/High
Mode [12-15] Trigger_Mode_15
N number of images to
Parameter [20-31]
be acquired
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 44
Solutions Inc. All rights reserved.
7 Image Acquisition
1. Trigger Pulse
2. Propagation
Delay
3. Exposure Time
4. Sensor Readout
5. Data Transfer
Figure 7.6: External trigger timing characteristics
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 45
Solutions Inc. All rights reserved.
7 Image Acquisition
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 46
Solutions Inc. All rights reserved.
7 Image Acquisition
1. Software Trigger
2. Trigger Latency
3. Exposure Time
4. Sensor Readout
5. Data Transfer
Figure 7.8: Software trigger timing
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 47
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
8 Chameleon3 Attributes
8.1 Pixel Formats
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 Chameleon3's Analog-to-Digital Converter, which digitizes the images, is configured to a fixed bit output (12-
bit (10-bit CM3-U3-13Y3)). 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.
8.1.1 Raw
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.
8.1.2 Mono
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.
8.1.3 RGB
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.
8.1.4 YUV
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 48
Solutions Inc. All rights reserved.
8 Chameleon3 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 10092
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 49
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 50
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
CM3-U3-31S4M
CM3-U3-31S4C
2 2x2 Decimation Yes No
CM3-U3-50S5M
CM3-U3-50S5C
CM3-U3-13S2C
2x2 Adjacent Binning Yes Yes
4 CM3-U3-28S4C
CM3-U3-13S2M
4x4 Adjacent Binning Yes Yes
CM3-U3-28S4M
CM3-U3-13S2C
5 CM3-U3-28S4C
CM3-U3-31S4M
4x4 Bayer Binning No Yes
CM3-U3-31S4C
CM3-U3-50S5M
CM3-U3-50S5C
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 half 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 and CM3-U3-32S4C implement this binning mode in the FPGA entirely. There is an increase in
brightness but no impact on frame rate.
Other CMOS models implement binning mode in the sensor. There is an increase in brightness and frame rate in
some models.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 51
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
Mode 2
Mode 2 is 2x2 FPGA sub sampling or decimation, effective resolution is half 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. For color CCD cameras, vertical 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, this mode suffers from
reduced image quality resulting from vertical sensor binning and inherent skipping of rows during readout.
For CM3-U3-13Y3, mode 4 is 2x2 decimation, effective resolution is quartered and frame rate increases.
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 four and image brightness is increased in all cases.
Monochrome models, CM3-U3-31S4C, and CM3-U3-50S5C 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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 52
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 53
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
Display
Name Description Value
Name
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 54
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
The theoretical frame rate (FPS) that can be achieved can be calculated as follows:
Frame Rate in FPS = (Bandwidth / (W x H x BPP)) / Number of Cameras
An example for CM3-U3-31S4:
Assuming a 2064 x 1544 image, with an 8-bit pixel format, using 175.3 MB/s bandwidth, the calculation would be:
Frame Rate
= (Bandwidth / (W x H x BPP)) / Number of Cameras
Frame Rate
= (175000000 / (2064 x 1544 x 1)) / 1
Frame Rate
= 55 FPS
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 55
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
8.4.2.1 CM3-U3-13S2M
Firmware: 1.2.3.0
Mode 0
1288 x 964 1024 x 768 800 x 600 640 x 480 320 x 240 160 x 120
30 35 42 50 80 112
Mode 1
644 x 482 320 x 240 160 x 120
50 79 110
Mode 5
320 x 240 160 x 120
86 114
8.4.2.2 CM3-U3-13S2C
Firmware: 1.2.3.0
Mode 0
1288 x 964 1024 x 768 800 x 600 640 x 480 320 x 240 160 x 120
30 35 42 50 80 112
Mode 1
644 x 482 320 x 240 160 x 120
30 50 80
Mode 4
644 x 482 320 x 240 160 x 120
50 79 110
Mode 5
320 x 240 160 x 120
30 50
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 56
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
Mode 1
All Resolutions
Raw8 470
Mono8/Mono12/Mono16 228
8.4.3.2 CM3-U3-13Y3C
Firmware: 1.8.3.0
Mode 0
1280 x 1024 1024 x 780 800 x 600 640 x 480 320 x 240 160 x 120
Raw8 149 197 250 310 590 597
Mono8/Mono12/YUV411 91 121 154 191 366 366
Raw12 99 132 250 310 590 597
Raw16 75 99 203 310 590 597
Mono16/YUV422 75 99 154 191 366 366
24-bit 50 67 136 191 366 366
Mode 4
640 x 480 320 x 240 160 x 120
Raw8 470 470 470
Mono8/Mono12/YUV411
228 228 228
Mono16/YUV22
Raw12 264 470 470
Raw16 294 470 470
24-bit 198 228 228
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 57
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
8.4.4.1 CM3-U3-28S4M
Firmware: 1.3.3.1
Mode 0
1928 x 1448 1280 x 960 800 x 600 640 x 480 320 x 240 160 x 120
13 18 25 29 43 57
Mode 1
964 x 764 640 x 480 160 x 120
24 31 59
Mode 5
480 x 362 160 x 120
40 59
8.4.4.2 CM3-U3-28S4C
Firmware: 1.3.3.1
Mode 0
1928 x 1448 1280 x 960 800 x 600 640 x 480 320 x 240 160 x 120
13 18 25 29 43 57
Mode 1
964 x 764 640 x 480 160 x 120
13 18 43
Mode 4
964 x 764 640 x 480 160 x 120
24 31 59
Mode 5
480 x 362 160 x 120
13 29
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 58
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
Mode 1
All Resolutions
Raw8/Raw16 108
Mono8/Mono12/Mono16 71
Mode 2
All Resolutions
All formats 92
8.4.5.2 CM3-U3-31S4C
Firmware: 1.10.3.0
Mode 0
2048 x 1536 1600 x 1200 1280 x 720 800 x 600 640 x 480 160 x 120
Raw8 55 70 114 136 167 532
Mono8
36 46 75 89 110 351
Mono12/YUV411
Raw16 31 52 106 136 167 532
Mono16/YUV422 31 46 75 89 110 351
24-bit 21 33 71 89 110 351
Mode 1
1024 x 768 800 x 600 640 x 480 320 x 240 160 x 120
Raw8/Raw16 55 70 87 167 308
Mono8/Mono12
Mono16/YUV422 36 46 57 110 203
24-bit
Mode 2
All Resolutions
92
All formats
(84 for 24-bit at 1024 x 768)
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 59
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
Mode 1
All Resolutions
Raw8, Raw16 69
Mono8, Mono12, Mono16 45
Mode 2
All Resolutions
All formats 70
8.4.6.2 CM3-U3-50S5C
Firmware: 1.10.3.0
Mode 0
2448 x 2048 1600 x 1200 1280 x 720 800 x 600 640 x 480 160 x 120
Raw8 35 59 97 115 142 452
Mono8/Mono12/YUV411 23 39 63 75 93 296
Raw16 19 51 97 115 142 452
Mono16/YUV422 19 39 63 75 93 296
24-bit 13 33 63 75 93 296
Mode 1
1224 x 1024 1024 x 768 800 x 600 640 x 480 320 x 240 160 x 120
Raw8/Raw16 35 47 59 74 142 261
Mono8/Mono12/Mono16,
23 30 39 48 93 171
YUV411/YUV422/ YUV444/RGB8
Mode 2
All Resolutions
All formats 70
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 60
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 61
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
Some advantages of global shutter are more uniform brightness and minimal motion blur.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 62
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
Imaging
GenICam Feature FlyCapture API Sample Code
Parameter
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
Analog Control Setting Gamma Using the FlyCapture API
Table
Image Flip/Mirror Image Format Control
Embedded Image
Chunk Data Control
Information
Bayer Color
Processing (color Image Format Control Accessing Raw Bayer Data using FlyCapture
models only)
Hue (color models
Analog Control Setting Hue Using the FlyCapture API
only)
Saturation (color
Analog Control Setting Saturation Using the FlyCapture API
models only)
Note: The term Continuous is the same as Auto and the term
Once is the same as One Push.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 63
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 64
Solutions Inc. All rights reserved.
8 Chameleon3 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.
n GenICam—Analog Control
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:
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 65
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
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:
n GenICam—Acquisition Control
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 Chameleon3 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.
To adjust gain:
n GenICam—Analog Control
n To access negative Gain values—From Remove Parameter Limits, select Gain and set Remove
Limits to True.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 66
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
State Description
Control of the exposure is achieved via setting both Exposure and Gain. This mode is
Off
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
Manual Exposure
intensity to the Auto Exposure value. This mode is achieved by setting Auto Exposure to
Control
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
Auto Exposure Control 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.
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:
n GenICam—Acquisition Control
8.12 Sharpness
The Chameleon3 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
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 67
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
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:
n GenICam—Analog Control
OUT = 255*(IN/255)^1/gamma
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:
n Camera reinitialization
n Changing the current video mode or current video format
n Changing gamma
The LUT can define 2 banks where each bank contains 1 channel. A channel defines a table with a length of 2Input_
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 68
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
C(0)E(0)
…
…
C(0)E(2Input_Depth-1)
C(1)E(0)
…
…
C(1)E(2Input_Depth-1)
…
…
…
C(Number_of_Channels-1)E(0)
…
…
C(Number_of_Channels-1) E(2Input_Depth-1)
To adjust gamma:
n GenICam—Analog Control
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 69
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
To enable HDR:
n FlyCapture SDK example program—HighDynamicRangeEx
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:
n Timestamp
n Gain
n Exposure
n Brightness
n White Balance
n Frame counter
n Strobe Pattern counter
n GPIO pin state
n 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):
n data[0] = first byte of Timestamp data
n data[4] = first byte of Gain data
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 70
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
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:
n CSRs—FRAME_INFO: 12F8h
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 71
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
The Chameleon3 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 Description
Off 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
On/Manual
the blue pixels of the Bayer tiling.
The following table illustrates the default gain settings for most cameras.
Red Blue
Black and White 32 32
Color 1023 1023
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 term Continuous is the same as Auto and the term
Once is the same as One Push.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 72
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
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:
Users interested in accessing the raw Bayer data to apply their own color conversion algorithm or one of the SDK
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 73
Solutions Inc. All rights reserved.
8 Chameleon3 Attributes
library algorithms should acquire images using a video mode that supports Raw pixel encoding.
The actual physical arrangement of the red, green and blue "pixels" for a given camera is determined by the
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 10141
Writing color processing software and color interpolation algorithms Knowledge Base Article 10144
How is color processing performed on my camera's images? Knowledge Base Article 10318
8.19 Hue
Hue is applicable to color models only.
This provides a mechanism to control the Hue component of the images being produced by the Chameleon3,
given a standard Hue, Saturation, Value (HSV) color space.
To adjust hue use:
n GenICam—Analog Control
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
Chameleon3, given a standard Hue, Saturation, Value (HSV) color space.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 74
Solutions Inc. All rights reserved.
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 email 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.
If you have done all the above and still can’t find an answer to your question, contact our Technical Support team.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 75
Solutions Inc. All rights reserved.
9 Troubleshooting
For information on the LED register, see LED_CTRL: 1A14h on page 108.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 76
Solutions Inc. All rights reserved.
9 Troubleshooting
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 77
Solutions Inc. All rights reserved.
9 Troubleshooting
4. Update the camera firmware to the latest version (available on the Downloads page).
5. Update the SDK to the latest version (available on the Downloads page).
6. Simplify the topology of the system by using shorter cables, or by not chaining cables.
If none of these options helps to remove the link recovery errors, contact support.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 78
Solutions Inc. All rights reserved.
9 Troubleshooting
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 79
Solutions Inc. All rights reserved.
9 Troubleshooting
n Increase the shutter time/lower the frame rate. This increases the amount of time light is collected in the
photosensors relative to the time in the vertical transfer register.
n Turn the light source off before and after exposure by using a mechanical or LCD shutter.
n Use a pulsed or flashed light source. A pulsed light of 1/10,000 duration is sufficient in most cases to allow
an extremely short 100 ns exposure without smear.
n Increase light collimation by using a lens with variable aperture. Note that an effect of closing the iris is a
darker image.
n Use a low smear trigger mode which may reduce the effect of smear. This trigger mode may not be
available on all models.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 80
Solutions Inc. All rights reserved.
A FlyCapture API Code Samples
StrobeControl mStrobe;
mStrobe.source = 1;
mStrobe.onOff = true;
mStrobe.polarity = 1;
mStrobe.delay = 1.0f;
mStrobe.duration = 1.5f
cam.SetStrobe(&mStrobe);
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 81
Solutions Inc. All rights reserved.
A FlyCapture API Code Samples
TriggerMode mTrigger;
mTrigger.mode = 0;
mTrigger.source = 0;
mTrigger.parameter = 0;
mTrigger.onOff = true;
mTrigger.polarity = 1;
cam.SetTriggerMode(&mTrigger);
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 82
Solutions Inc. All rights reserved.
A FlyCapture API Code Samples
prop.onOff = true;
//Ensure auto-adjust mode is off.
prop.autoManualMode = false;
//Ensure the property is set up to use absolute value control.
prop.absControl = true;
//Set the absolute value of shutter to 20 ms.
prop.absValue = 20;
//Set the property.
error = cam.SetProperty( &prop );
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 83
Solutions Inc. All rights reserved.
A FlyCapture API Code Samples
Property prop;
//Define the property to adjust.
prop.type = AUTO_EXPOSURE;
//Ensure the property is on.
prop.onOff = true;
//Ensure auto-adjust mode is off.
prop.autoManualMode = false;
//Ensure the property is set up to use absolute value control.
prop.absControl = true;
//Set the absolute value of auto exposure to -3.5 EV.
prop.absValue = -3.5;
//Set the property.
error = cam.SetProperty( &prop );
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 84
Solutions Inc. All rights reserved.
A FlyCapture API Code Samples
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 85
Solutions Inc. All rights reserved.
A FlyCapture API Code Samples
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 86
Solutions Inc. All rights reserved.
A FlyCapture API Code Samples
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 87
Solutions Inc. All rights reserved.
B FlyCapture SDK Examples
Note: The full example source code can be found in the \src
directory of the FlyCapture2 SDK installation. To access the
examples workspace from the Start menu, select Program
Files>Point Grey FlyCapture2 SDK >Examples
B.1 AsyncTriggerEx
The AsyncTriggerEx example program demonstrates some of the basic asynchronous trigger capabilities of
compatible FLIR machine vision cameras.
This program only works with cameras that can be asynchronously triggered, either using an external hardware
trigger or by using the camera's internal software trigger.
The camera is started and put into trigger mode. The user can then either press a key to software trigger the
camera, or trigger through an external hardware trigger. The example captures a specified number of images and
then exits.
Available for:
n C++
n C#
n VB.NET
B.2 BusEventsEx
The BusEventsEx demonstrates how to Register for Bus Events such as Camera Arrival/Removal and Bus
Resets using the managed API.
Available for:
n VB.NET
B.3 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.
The program creates a context and initializes the first camera on the 1394 bus. It then queries the camera to
determine the custom image modes, resolution sizes, unit sizes and pixel formats the camera supports. The
information returned by QueryFormat7Info() is the same kind of information you would see in FlyCap using the
Format7 tab.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 88
Solutions Inc. All rights reserved.
B FlyCapture SDK Examples
The program then starts the camera in custom image mode using parameters defined at the beginning of the code.
Calling SetFormat7Configuration () with these parameters is essentially the same thing as setting these
parameters in FlyCap and clicking "Apply". A number of images are grabbed in this custom image mode. The final
image is then color-processed and saved in .bmp format to disk.
Available for:
n C++
n C#
n VB.NET
B.4 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. By turning off the FRAME_RATE register 0x83C. This effectively stops the camera from transmitting
images at fixed frame intervals; the frame rate becomes dependent on the shutter time.
The program begins by initializing the first camera on the bus and uses GetProperty() to determine if it implements
the FRAME_RATE register. If it does, it turns the frame rate off. If the camera does not implement this register, the
program then checks to see if the camera implements the EXTENDED_SHUTTER register. If it does, it accesses
this register to put the camera into extended shutter mode. Otherwise, the user is notified that the camera does
not implement extended shutter and the program exits.
Once the camera is in extended shutter mode, it is started in the default mode and frame rate. A series of images
are grabbed, and their timestamps printed as a way of verifying that the extended shutter is working.
B.5 FlyCap2CameraControl
The FlyCap2CameraControl is the source code to our main Control dialog that can be launched through the
Flycapture2GUI API. This source demonstrates all possible controls available in FlyCapture2 SDK.
Available for:
n C#
B.6 FlyCap2_GTKmm
This example allows a user to select a camera to start, and then starts streaming images to screen. It is written
using C++ with the GTKmm graphical framework. There are options to modify camera settings and display a
histogram window. Images can be saved as a single image capture or multiple sequential images of various
formats. Data can be saved by specifying the number of frames to capture, the length of time, or an indefinite
stream where the user selects when to start and stop the camera recording.
A single instance of FlyCap2_GTKmm can only run one camera. However, multiple applications can be run to
view different cameras. Simply select more than one camera when starting FlyCap2_ GTKmm. Note that the
number of active cameras is limited by the bandwidth of the bus.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 89
Solutions Inc. All rights reserved.
B FlyCapture SDK Examples
B.7 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. There are options to modify camera settings and save single images.
While a single instance of FlyCap2MFC can only open one camera, multiple FlyCap2MFC applications can be run
to view more than one camera. Note that the number of active cameras is limited by the bandwidth of the bus.
B.8 FlyCapture2GUI
This example contains the same source code that is used for the Camera Selection and Camera Control dialogs in
FlyCapture2.
As a result, it uses many of the features available in the FlyCapture2 API and is a useful source for discovering
how to perform many common functions, such as camera property manipulation, using the FlyCapture2 API.
Available for:
n C++
n C#
B.9 FlyCapture2SimpleGUI_WPF
The FlyCapture2SimpleGUI_WPFshows how to build the WPF GUI example.
Available for:
n C#
B.10 FlyCapture2Test
The FlyCapture2Test example program is a simple program designed to report information related to all compatible
cameras attached to the host system, capture a series of images from a single camera, record the amount of time
taken to grab these images, then save the last image in the current directory.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 90
Solutions Inc. All rights reserved.
B FlyCapture SDK Examples
Available for:
n C
n C++
n C#
n VB.NET
B.11 GigEGrabEx
The GigEGrabEx example program demonstrates how to use the GigECamera object to set up a GigE Vision
specific Image grabbing loop.
Available for:
n C
n C++
n C#
n VB.NET
B.12 GrabCallbackEx
The GrabCallbackEx example program demonstrates how to set up an asynchronous image callback application
using FlyCapture2 API.
Available for:
n C#
n VB.NET
B.13 HighDynamicRangeEx
The HighDynamicRangeEx example demonstrates the use of the High Dynamic Range (HDR) functionality. This
example can only be used on cameras which support HDR.
When HDR mode is enabled, the shutter and gain settings for each image alternate between four sets of shutter
and gain settings in the HDR register. All 4 registers must be used; the images cycle through registers HDR0 to
HDR3 and then back to HDR0 again. This cycle continues until HDR mode is turned off.
The example initializes the camera, and verifies that HDR is supported. The four HDR registers are then set up
with different, increasing values for shutter and gain.
The next 4 images are then grabbed and saved to disk. The user can look at these images and verify that each
image corresponds to the settings for each HDR register.
Once the images are saved to disk, the program cleans up and exits.
B.14 ImageEventEx
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 91
Solutions Inc. All rights reserved.
B FlyCapture SDK Examples
This example illustrates how users can implement partial image event notification. Partial image event
notification is a mechanism that provides the user with access to image data as it arrives in the PC's memory,
before the entire image is available.
This functionality is achieved by specifying a number of events, which are tied to various locations in the image.
The events are then signalled as the corresponding portion of the image arrives on the PC. This allows the user to
start processing the data immediately without having to wait for image transmission to complete. If you specify
one event, it occurs at the end of the image. If you specify two events, the first occurs near the beginning of the
image, and the second occurs at the end. If you specify more than two events, they are spread evenly among the
remainder of the image.
Partial image event notification is particularly useful in applications requiring extremely low latency, such as
moving the camera and stopping only to take pictures. In this case, setting two events, with the first occurring
near the beginning of the image, is a good method for indicating the end of integration and that it is safe to move
the camera without disrupting image capture.
Partial image event notification is also available in custom image mode; however, there are some additional
considerations when using this mode. Event notifications must be set on packet boundaries, so you must
compute the total image size, including padding, when deciding where to set event sizes. There will be at most
one padded packet transmitted, so the ceiling of the computed image size divided by the packet size returns the
number of packets transmitted per image:
numOfPackets = 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.
Note:
Partial image event notification operates differently between the
Windows and Linux operating systems in the following ways:
n On Windows, if more than one image event is specified, the first
event occurs after the PC receives the first packet. The
remainder of the events are equally distributed along the length
of the image. On Linux, all events are equally distributed along
the image. However, if an image is transmitted in more than one
packet, there are no notifications after the first packet is
transmitted.
n On Linux, synchronizing image transmission on the sy-bit is
disabled when using partial image event notification. As a result,
in certain cases when the CPU is heavily loaded and the image
rendering software is not cycling for a long period, the image
stream may fall out of synch and become corrupted. To re-
synchronize transmission, stop and re-start isochronous image
grabbing and transmission.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 92
Solutions Inc. All rights reserved.
B FlyCapture SDK Examples
B.15 MultipleCameraEx
This example starts multiple cameras using the StartSyncCapture() function. This function synchronizes image
grabbing across all cameras. Additionally, it enables timestamps to be embedded in images, allowing users to
obtain the exact timing of each camera's exposure.
B.16 MultipleCameraWriteToDiskEx
The MultipleCameraWriteToDiskEx shows how to write to disk from multiple cameras.
Available for:
n C++
B.17 MultiSyncEx
This example synchronizes 1394 cameras on same PC and across PCs. Across PC synchronization is achieved
by linking all of the computers to a single 1394 bus dedicated to sharing timing information (the timing bus). This
requires that a 1394 card on each machine be dedicated to the timing bus.
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 93
Solutions Inc. All rights reserved.
B FlyCapture SDK Examples
This example lists detected 1394 cameras on current system and displays current synchronization status and
time duration since sync was established. Cameras connected to other computers in the sync network cannot be
seen from local computer.
Detected cameras are highlighted in following ways to indicate synchronization status:
B.18 SaveImageToAviEx
This example saves a series of images to AVI files. The program starts the first camera attached to the host
system, opens an AVI file, captures a series of images from the camera, and appends the images to the AVI file.
B.19 SaveImageToFlashEx
The SaveImageToFlashEx utility is a basic example which utilizes the data flash on the camera. When an image is
grabbed, it is saved directly to flash instead of sending the data out. Not all cameras support data flash. On
supported cameras, flash size varies by model, so the size of the image that can be stored varies. Consult your
camera's documentation for more information.
Once the image is stored in the camera, the image can be recovered at any time on any PC.
The example uses a FlashMode enumeration to capture the image (-c) or save the stored image to disk (-r).
B.20 SerialPortEx
This example illustrates how users can transmit and receive characters by using the camera's serial buffer
system.
This example creates the camera context and does the following:
n Allocates a GUI handle to be used in all successive calls
n Displays the camera selection dialog
n Initializes the selected camera on the bus and associates it with the given context
n Checks to make sure that the serial port is actually supported
n Creates a thread to receive data and display the data
OnTransmit() is used to transmit data out of the camera's serial port based on user input.
ReceiveLoop() is used to get the connection parameters from the camera, update the dialog, verify the receive
buffer status and determine the amount of data to be read, read the data and display the data in the window.
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 94
Solutions Inc. All rights reserved.
C GenICam Features
C GenICam Features
The following features are included in the XML device description file on the camera to control, monitor, and query
the camera operation. Not all operations can be controlled using the XML file; those not included are controlled via
CSRs.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 95
Solutions Inc. All rights reserved.
C GenICam Features
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 96
Solutions Inc. All rights reserved.
C GenICam Features
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 97
Solutions Inc. All rights reserved.
C GenICam Features
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 98
Solutions Inc. All rights reserved.
C GenICam Features
Display
Name Description Value
Name
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.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 99
Solutions Inc. All rights reserved.
C GenICam Features
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 100
Solutions Inc. All rights reserved.
C GenICam Features
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 101
Solutions Inc. All rights reserved.
C GenICam Features
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 102
Solutions Inc. All rights reserved.
C GenICam Features
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 103
Solutions Inc. All rights reserved.
D Control and Status Registers
A complete list of CSRs can be found in the FLIR Machine Vision Camera Register Reference.
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 104
Solutions Inc. All rights reserved.
D Control and Status Registers
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 105
Solutions Inc. All rights reserved.
D Control and Status Registers
Note:
To calculate the base address for an offset CSR:
1. Query the offset inquiry register.
2. Multiple the value by 4. (The value is a 32-bit offset.)
3. Remove the 0xF prefix from the result. (i.e., F70000h becomes
70000h)
Format:
Offset Name Field Bit Description
Presence_ Presence of this feature
[0]
Inq 0:Not Available, 1: Available
[1-5] Reserved
Read: read a status
1A70h AE_ROI_CTRL Write: ON or OFF for this feature
ON_OFF [6] 0: OFF, 1: ON
If this bit = 0, other fields will be read
only
[7-31] Reserved
1A74h AE_ROI_OFFSET [0-31] 32-bit offset for the AE_ROI CSRs
AE_ROI_UNIT_POSITION_ Hposunit [0-15] Horizontal units for position
Base + 0h
INQ Vposunit [16-31] Vertical units for position
Hunit [0-15] Horizontal units for size
Base + 4h AE_ROI_UNIT_SIZE_INQ
Vunit [16-31] Vertical units for size
Left [0-15] Left position of ROI
Base + 8h AE_ROI_POSITION
Top [16-31] Top position of ROI
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 106
Solutions Inc. All rights reserved.
D Control and Status Registers
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 107
Solutions Inc. All rights reserved.
D Control and Status Registers
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 108
Solutions Inc. All rights reserved.
D Control and Status Registers
1/26/2017 ©2015-2017
FLIR Integrated Imaging Chameleon®3 U3 Technical Reference 109
Solutions Inc. All rights reserved.
The Multi-Shot Trigger mode in machine vision cameras enables capturing a set number of sequential images with a single trigger activation. This mode can acquire up to 255 images per trigger, streaming them to the host system at a predetermined frame rate, dictated by the current settings . It operates under an asynchronous trigger mode, meaning each set of images is captured with a designated shutter speed . A limitation is that adjustments to trigger controls will interrupt the current sequence, and the frame rate is disabled during operation, requiring careful management of shutter time to achieve desired results . Additionally, any changes to video modes while in Multi-Shot Trigger mode will only take effect after a delay following image readout, which can add complexity to on-the-fly adjustments .
The Chameleon3 cameras, with power consumption under 3 W and USB 3.1 interface support, cater to modern industrial imaging needs by providing efficient energy management suited for mobile or energy-sensitive operations and high-speed data transfer, critical for real-time image processing and analysis in manufacturing or inspection tasks .
Partial image modes like pixel binning combine pixels into larger superpixels to increase the camera's sensitivity to light at the cost of resolution, useful in low-light conditions. ROI (Region of Interest) reduces the data processed by focusing only on sections of the image, accelerating processing times and reducing bandwidth needs, beneficial in scenarios like object tracking or inspections where only details in specific areas are relevant .
Compliance certifications such as CE, FCC, KCC, and RoHS are crucial for Chameleon3 cameras in international markets. CE marking is a requisite for products in the European Economic Area, ensuring that the cameras meet EU safety, health, and environmental protection requirements. The FCC certification is necessary for products sold or marketed in the United States to comply with standards that minimize electromagnetic interference, thereby enhancing reliability and compliance in significant markets . KCC certification indicates conformity with Korean safety regulations for electronic products, expanding access to the Korean market. RoHS (Restriction of Hazardous Substances) certification is essential as it restricts the use of certain hazardous materials in electrical and electronic products, which supports environmental sustainability and public health standards . These certifications not only ensure legal compliance across various regions but also enhance customer confidence in product safety and environmental responsibility ."}
The auxiliary output capabilities of the CM3-U3-13S2 significantly enhance its functionality in industrial applications by providing General Purpose Input/Output (GPIO) modes. These modes include input, output, asynchronous trigger, and strobe, which allow the camera to interact with other devices and synchronize with external events . The camera's use of a USB 3.1 interface further ensures efficient and high-speed data transfer, ideal for demanding industrial environments . The camera also supports various video modes, such as 2x2 binning and decimation, which can enhance image brightness and increase frame rates, depending on the model, thus providing flexibility in capturing images under different lighting conditions .
The primary differences between the CM3-U3-13S2 and CM3-U3-13Y3 models of the Chameleon3 camera are their sensor resolution, frame rate, exposure range, and analog-to-digital converter bit depth. The CM3-U3-13S2 has a resolution of 1288 x 964 pixels with a frame rate of 30 FPS and uses a 12-bit ADC . In contrast, the CM3-U3-13Y3 offers a resolution of 1280 x 1024 pixels, a significantly higher frame rate of 150 FPS, and a 10-bit ADC . Furthermore, the exposure range for the CM3-U3-13S2 is from 0.046 ms to 31.9 seconds, whereas for the CM3-U3-13Y3, it is from 0.006 ms to 999.240 ms .
Firmware version impacts Chameleon3 camera behavior by introducing significant bug fixes and feature enhancements, which can affect image acquisition and processing . Updating to the latest firmware can resolve issues such as link recovery errors and improve synchronization of image capture . Firmware updates may also improve pixel defect correction, which affects image quality . Therefore, regularly updating the camera's firmware is recommended to ensure optimal operation and functionality during image acquisition .
The "Standard External Trigger" mode is ideal when precision in timing for the start of exposure is critical, such as in applications requiring synchronization with specific external events where any temporal overlap or delay could compromise the quality of the results, unlike other modes that stress speed over precision .
The Overlapped Exposure Readout trigger mode (Mode 14) improves camera operation by allowing triggering at nearly the full frame rate compared to the Standard External trigger mode (Mode 0), which cannot trigger at full frame rate . Additionally, Mode 14 supports overlapping the trigger with the readout of the image, enabling faster throughput and nearly continuous operation similar to free-running mode . However, while Mode 14 offers higher speed, it may delay the start of exposure to maintain proper exposure times, which can result in less precise control over the exact timing of each exposure start compared to Mode 0 .
Extended exposure to environmental conditions such as bright sunlight, rain, and dusty environments can adversely affect the electronics and optics of Chameleon3 cameras . It is crucial to ensure proper heat dissipation as the camera can become warm due to its compact design, and overheating may harm operational reliability . Using a cooling fan and a heat sink can help maintain an appropriate temperature . Additionally, excessive shaking or mishandling may further compromise camera function . Dust protection is provided by the camera housing, which incorporates an extra layer of glass to keep dust from the sensor, thereby reducing interference with image quality .