FLIR Knowledge Base
Search for...
Search
        |     
Exclude unwanted words:
Browse KB Articles
Go Back Printable Version Email This Article Bookmark This Article

Using Point Grey USB3/USB2 Cameras with Cognex VisionPro

KB Number: 10788
Last Revision Date: 7/21/2016

Using Point Grey USB3/USB2 Cameras with Cognex VisionPro
Technical Application Note TAN2014019
Revised July 21, 2016

Subject

Technical Application Note (TAN2014019): Using Point Grey USB3/USB2 Cameras with Cognex VisionPro 

10346

Applicable Product(s)

  • All Point Grey USB 3.1 or USB 2.0 cameras 
    • Flea3 USB 3.1
    • Grasshopper3 USB 3.1
    • Blackfly USB 3.1
    • Chameleon2 USB 2.0
    • FireflyMVU USB 2.0

 

Application Note Description

This application note provides information on how to configure and use Point Grey USB3/USB2 cameras with third-party Cognex VisionPro software.

 

This document provides examples using Cognex VisionPro v8.2. For more information, visit the Cognex website.

 

Preparing for Use

Before you use your Point Grey camera, we recommend that you are aware of the following resources available from the Point Grey Downloads page:

  • Getting Started Manual for the camera—provides information on installing components and software needed to run the camera.
  • Technical Reference for the camera—provides information on the camera’s specifications, features and operations, as well as imaging and acquisition controls.
  • Firmware updates—ensure you are using the most up-to-date firmware for the camera to take advantage of improvements and fixes.
  • Tech InsightsSubscribe to Point Grey's monthly email updates containing information on new knowledge base articles, new firmware and software updates, and Product Change Notices (PCN).

Installation and Configuration

Follow these steps to use Cognex VisionPro with Point Grey USB3/USB2 cameras:

  1.  Install Cognex VisionPro.
  2.  Install FlyCapture2 AIK.
  3.  Connect the Camera to the PC.
  4.  Start Cognex VisionPro Software.
  5.  Capture Images

The following sections provide more detail.

Step 1—Install Cognex VisionPro

The examples used in this document are from Cognex VisionPro v8.2. It is available for download from the Cognex website.

Step 2—Install FlyCapture2 AIK

For USB2 or USB3 cameras, FlyCapture2 AIK, available from the Point Grey Downloads page, must also be installed.

Step 3—Connect the Camera to the PC

Connect the camera to the PC. For information, see the camera’s Getting Started Manual

Step 4—Start Cognex VisionPro Software

To start Cognex VisionPro:

  1.       Launch the Cognex VisionPro QuickBuild application.

                Start MenuCognexVisionProVisionPro® QuickBuild

  1.       Double-click on Image Source to launch the Image Source and VisionPro QuickBuild Job Editor.
  2.       In the Image Source window, from the Image Acquisition Device/Frame Grabber drop-down, select your camera.

        

If your camera does not show up in Cognex VisionPro, see the troubleshooting section.

Step 5—Capture Images

To capture images:

  • In the VisionPro QuickBuild Job Editor window, from the Run menu select Job Continuously. Or, click the Run Job Continuously icon.

 

Supported Features

This list is for reference purposes. In order for the feature to be supported in Cognex VisionPro, the camera needs to support the feature. For example, a monochrome camera will not support WhiteBalanceAuto in Cognex because monochrome cameras do not support this feature.

This list is taken from FlyCapture AIK version 2.7.

Iris

IrisEnabled

IrisAuto

Brightness

Read only

Exposure

ExposureEnabled

ExposureAuto

Sharpness

SharpnessEnabled

SharpnessAuto

Hue

HueEnabled

Saturation

SaturationEnabled

SaturationAuto

Gamma

GammaEnabled

GammaAuto

Gain

GainEnabled

GainAuto

White Balance

WhiteBalanceBlue

WhiteBalanceRed

WhiteBalanceEnabled

WhiteBalanceAuto

Shutter

ShutterEnabled

ShutterAuto

Frame Rate

FrameRateEnabled

FrameRateAuto

Focus

FocusEnabled

FocusAuto

Strobe

StrobeEnabled

Line

LineMode

LineSelector

Trigger

TriggerMode

TriggerActivation

TriggerSource

Trigger Software

Read only

Pan

PanEnabled

PanAuto

DCAMFormats

Read only

 

Troubleshooting

I cannot detect my USB3/USB2 camera in Cognex VisionPro

To use USB2/USB3 cameras with Cognex VisionPro, FlyCapture2 AIK must also be installed. Contact Point Grey Support (mv-support@flir.com) to request a copy of the FlyCapture2 AIK installer.

  • If the USB2/USB3 camera is not streaming, verify the following:
  • Is the camera detected in FlyCap2.exe (included in the FlyCapture2 SDK)?
  • Is the camera able to stream in FlyCap2?
  • Is the FlyCapture2 AIK installed?
  • Is the AIK server running?
  • Is the Quickbuild application running in Administrator mode?

To verify the FlyCapture2 AIK installation:

  1. Open C:\Windows\regedit.exe.
    1. Go to [HKEY_LOCAL_MACHINE\SOFTWARE\Cognex\AIK\AdapterFlyCapture2].
      1. Verify the DLL pointed by the LibName string exists.

       

      To verify the AIK server is running:

      1. While the camera is connected, start Cognex VisionPro.
      2. In the Windows Task Manager, on the Process tab, a process named “aikserver_x64.exe” (for 64-bit) should be visible. (For 32-bit, the process is “aikserver_x86.exe”.)

                     

      I cannot acquire images from my USB3/USB2 camera in Cognex VisionPro

      Two common reasons for not being able to acquire images are:

      • Camera is in an unknown state and needs to be restored to factory default.
      • Image size exceeds default Cognex VisionPro pool size.

      To restore the camera back to factory default:

      1. Install the latest FlyCapture2 SDK, if not already installed.
      2. Open FlyCap2.exe. The camera should appear in the Camera List.
      3. Click on Configure Selected.
      4. On the Advanced Camera Settings tab, select Default Memory Channel.
      5. Click Save then Click Restore.
      6. Close the camera settings window and click OK to acquire images in FlyCapture2. If you are able to acquire images in FlyCapture2, you should be able to acquire them in Cognex VisionPro.
       

      Contact Point Grey Support if you cannot acquire images using FlyCapture2.

      To increase Cognex VisionPro’s pool size:

           1. Check the current pool size.

                 a.  In the Windows Start menu search, enter “regedit.exe.”

                 b.  Search for the registry key:

               HKEY_LOCAL_MACHINE\SOFTWARE\Cognex\AIK\AdapterFlyCapture2

                 c. Check the current PoolSize value.

               The PoolSize should be at least four times larger than the image size. For example, the default value is 0x04000000 which is 8 MB.

               0x4000000 = 67108864 bits = 8388608 bytes = 8 MB

           2. Change the PoolSize registry value according to your image size requirements. 

      I am missing custom properties

      In some cases, a property must be changed from auto to manual in order to access further settings. For example, to set the exposure time, exposure must be in manual mode.

      VisionPro loads the current properties, either default or user set, into the Image Source window when the camera is selected. Any changes made to the properties, such as changing from auto to manual, must be reloaded to take effect. To reload, close the Image Source window and reopen.

      I am changing to a mode that changes the resolution

      When changing video modes, the user may implement a binning mode which changes the resolution as well. See KB 10085 Understanding Format_7 region of interest and pixel binning for more information.

      To change to a mode that also changes the resolution:

      1. Connect the camera to the PC.
      2. Launch the Cognex Vision Pro QuickBuild Application from Start Menu → Cognex → VisionPro → Quickbuild.
      3. Double-click on Image Source to launch the Image Source and VisionPro QuickBuild Job Editor.
      4. In the Image Source Configuration window, select Custom Properties tab.
      5. Add ImageFormatControl →VideoMode, then switch to the desired mode.
      6. Switch to the Image Properties tab, then change the resolution to the appropriate width/height.
      7. Exit out of the Image Source window, then in the CogJob1 window, select the Run Job Continuously button.

        

       

      Was this article helpful?

      Go Back Printable Version Email This Article Bookmark This Article