Technical Application Note (TAN ): Getting Started with Cognex VisionPro

Transcription

1 Technical Application Note TAN Revised July 21, Subject Technical Application Note (TAN ): 1.2 Applicable Product(s) All Point Grey imaging cameras 1.3 Application Note Description This application note provides information on how to install, configure, and use Point Grey imaging cameras with Cognex VisionPro. This document provides examples using Cognex VisionPro v8.2. For more information, visit the Cognex website. Preparing for Use Installation and Configuration Step 1 Install Cognex VisionPro Step 2 Connect the Camera to the PC Step 3 Verify FireWire Driver (FireWire cameras only) Step 3 Verify IP Address and network adaptor driver (GigE cameras only) Step 4 Start Cognex VisionPro Software Step 5 Capture Images Troubleshooting Tips FireWire Cameras GigE Cameras USB2/USB3 Cameras Point Grey logo, Spinnaker, FlyCapture, Digiclops, Blackfly, Dragonfly, Dragonfly Express, Chameleon, Firefly, Flea, Grasshopper, Ladybug, Scorpion, Zebra and Triclops are trademarks or registered trademarks of Point Grey in Canada and other countries Point Grey. All rights reserved

2 General Troubleshooting Additional Downloads and Support 1.4 Preparing for Use Before you use your Point Grey camera, we recommend that you are aware of the following resources available from our 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 to most up-to-date firmware for the camera to take advantage of improvements and fixes. Tech Insights Subscribe to Point Grey s monthly updates containing information on new knowledge base articles, new firmware and software updates, and Product Change Notices. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 2

3 1.5 Installation and Configuration The steps for installing and setting up the Cognex VisionPro depend which interface your camera uses. FireWire Cameras GigE Cameras USB2/USB3 Cameras If using FireWire cameras: If using GigE cameras: If using USB2/USB3 cameras: 1. Install Cognex VisionPro. 2. Connect the Camera to the PC. 3. Verify FireWire Driver. 4. Start Cognex VisionPro Software. 5. Capture Images. 1. Install Cognex VisionPro. 2. Connect the Camera to the PC. 3. Verify IP Address and network adaptor driver. 4. Start Cognex VisionPro Software 5. Capture Images 1. Install Cognex VisionPro. Install FlyCapture2 AIK. 2. Connect the Camera to the PC. 3. Start Cognex VisionPro Software. 4. 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. The Cognex VisionPro installation supports FireWire and GigE Vision cameras. It includes required drivers and a GigE Configuration Tool (for GigE cameras only). Cognex also offers as a separate download a free utility for FireWire cameras called DCAM Doctor which is a quick camera setup and acquisition tool. For USB2 or USB3 cameras, FlyCapture2 AIK must also be installed. Contact Point Grey Support (support@ptgrey.com) to request a copy of the FlyCapture2 AIK installer Step 2 Connect the Camera to the PC Connect the camera to the PC. For information, see the camera s Getting Started Manual. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 3

4 1.5.3 Step 3 Verify FireWire Driver (FireWire cameras only) For FireWire cameras, verify that the Cognex FireWire driver is installed. To verify the FireWire driver: 1. Open Windows Device Manager. 2. Confirm the camera appears under Cognex Hardware. If the camera does not appear under Cognex Hardware, follow the instructions in the Troubleshooting section to install the driver Step 3 Verify IP Address and network adaptor driver (GigE cameras only) For GigE cameras, verify that the camera and network adaptor have compatible IP address settings and that your network adaptor is using the Cognex VisionPro GigE Vision driver, ebus Universal Pro driver. To verify GigE settings: 1. Open Cognex GigE Vision Configuration Tool. Start MenuCognexVisionProUtilities Cognex GigE Vision Configuration Tool 2. From the Network Connection tree select the network adaptor to view the settings. 3. From the Network Connection tree select the camera to view the settings. When verifying IP addressing, remember that the camera should always be in the same subnet as the network adaptor.. See the Troubleshooting section for details on using the Cognex GigE Vision Configuration Tool. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 4

5 1.5.5 Step 4 Start Cognex VisionPro Software To start Cognex VisionPro: 1. Launch the Cognex VisionPro QuickBuild application. Start MenuCognexVisionProVisionPro QuickBuild 2. Double-click on Image Source to launch the Image Source and VisionPro QuickBuild Job Editor. 3. In the Image Source window, from the Image Acquisition Device/Frame Grabber drop-down, select your camera. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 5

6 1.5.6 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. FireWire cameras can also use the free utility Cognex DCAM Doctor for quick camera setup and image capture. To use Cognex DCAM Doctor: 1 Launch DCAM Doctor from C:\Program Files\Cognex\VisionPro\bin\dcamdoctor.exe. 2 From the DCAM Utilities tree, select Acquire Images then click Open Acquisition Window. 3 In the DCAM Image Acquisition window, click Select Camera. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 6

7 4 From the drop-down list, select any CCF file. Cognex configuration files (CCF) are stored in: C:\Program Files\Cognex\VisionPro\bin\ 5 In the DCAM Image Acquisition window, click on Initialize Acquisition. 6 Click on Continuous to grab images continuously. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 7

8 1.6 Troubleshooting Tips FireWire Cameras Cognex does not support FireWire cameras on 64-bit computers. Cognex VisionPro comes with its own FireWire driver, which needs to be installed for the Point Grey FireWire camera. To install the Cognex driver for the Point Grey FireWire camera, the PC s FireWire host controller must be configured to use the Windows FireWire driver, and not the Point Grey FirePRO driver. Use Windows Device Manager to determine which FireWire driver is in use. A. Shows a FireWire camera with the Cognex driver installed properly. The camera should be detected by Cognex VisionPro software. B. Shows a Point Grey FireWire camera that is not using the Cognex driver. Install the Cognex driver on the camera. C. Shows a FireWire host controller with the Point Grey FirePRO driver installed. Install Microsoft s FireWire driver on the host controller before switching to the Cognex FireWire driver on the camera. D. Shows a FireWire host controller with the Microsoft FireWire driver installed. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 8

9 To install the Microsoft FireWire driver on the host controller: 1. In Windows Device Manager, right-click on the IEEE 1394b host controller. 2. From the shortcut menu, select Properties. 3. On the Drivers tab click Update Driver software. 4. Click Browse my computer for driver software. 5. Click Let me pick from a list of drivers on my computer. 6. Select 1394 OHCI compliant host controller. To install the Cognex FireWire driver on the camera: 1. In Windows Device Manager, right-click on the camera. 2. From the shortcut menu, select Properties. 3. On the Drivers tab click Update Driver software. 4. Click Browse my computer for driver software. 5. Click Let me pick from a list of drivers on my computer. 6. Browse to C:\Program Files\Cognex\Common\Drivers\mvs8100.inf. 7. You may be required to reboot the PC for changes to take effect. 8. Verify that the camera appears as Cognex Hardware. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 9

10 1.6.2 GigE Cameras Cognex provides a GigE Vision configuration tool that allows you to configure your network card and GigE camera s IP address. It also allows you to set jumbo frames for your network card. Jumbo frames is the recommended setting to stream GigE Vision cameras at full bandwidth. Start MenuCognexVisionProUtilities Cognex GigE Vision Configuration Tool When setting IP addresses keep in the mind the following: The GigE camera should have a unique IP address. The GigE camera should always be in the same subnet as the network adaptor. To obtain a quick view of the supported features and their descriptions, select the camera and click the Show Feature Snapshot button. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 10

11 Cognex VisionPro comes with its own GigE Vision driver, ebus Universal Pro driver, which needs to be installed for the network adaptor. To install the Cognex driver: 1. In the Cognex GigE Vision Configuration Tool window, select the Local Area Connection for the camera. 2. Click the ebus Universal Pro Driver checkbox to install the driver. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 11

12 1.6.3 USB2/USB3 Cameras To use USB2/USB3 cameras with Cognex VisionPro, FlyCapture2 AIK must also be installed. Contact Point Grey Support 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. 2. Go to [HKEY_LOCAL_MACHINE\SOFTWARE\Cognex\AIK\AdapterFlyCapture2]. 3. 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.) Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 12

13 1.6.4 General Troubleshooting The following suggestions may help you troubleshoot issues with your camera: 1. Update the driver to the latest version. 2. Update the firmware to the latest version. 3. Update the software to the latest version. 4. Perform a soft reboot and if still necessary a hard reboot of the PC. 5. Disable then enable the driver. 6. Power cycle the camera. 7. Power the camera through GPIO, if wiring harness is available. 8. Use a separate host controller instead of an integrated one, if available. 9. Ensure the card is powered via the 4-pin hard drive connector, if applicable. 10. Use a different cable or host controller or PC. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 13

14 1.7 Additional Downloads and Support Point Grey 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. Creating a Customer Login Account The first step in accessing our technical support resources is to obtain a Customer Login Account. This requires a valid name and address. To apply for a Customer Login Account go to the Downloads page. Knowledge Base Our Knowledge Base contains answers to some of the most common support questions. It is constantly updated, expanded, and refined to ensure that our customers have access to the latest information. Product Downloads Customers with a Customer Login Account can access the latest software and firmware for their cameras from our Downloads page. We encourage our customers to keep their software and firmware up-to-date by downloading and installing the latest versions. Contacting Technical Support Before contacting Technical Support, have you: 1. Read the product documentation and user manual? 2. Searched the Knowledge Base? 3. Downloaded and installed the latest version of software and/or firmware? If you have done all the above and still can t find an answer to your question, contact our Technical Support team. Revised 21-Jul-16 Copyright 2014 Point Grey Research, Inc. All rights reserved. 14