Using USB3 Vision Cameras with MVTec HALCON in OS X

Preparing for Use

Before you use your camera, we recommend that you are aware of the following resources:

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 Insights—monthly email updates containing information on new knowledge base articles, new firmware and software releases, and Product Change Notices (PCN). Subscribe here.

Recommended System Configuration

Teledyne FLIR has tested and recommends the following configuration.

Component Description
MacBook Pro 15" Model MacBook Pro11,3
CPU Intel Core i7 2.6 GHz
RAM 8 GB of 1600 MHz DDR3 SDRAM
Operating System OS X 10.10.2 Yosemite
Software HALCON 12 with USB3 Vision Rev 6.2 interface
Camera Blackfly BFLY-U3-13S2C firmware 1.6.3.0

System Setup and Configuration

  1. From the HALCON website, download HALCON 12 for OS X and the latest USB3 Vision interface. Note: you need a login account to access HALCON 12 download.
  2. Run HALCON installer.



     

    HALCON 12 comes with USB3 Vision interface revision 6.1. We recommend updating the USB3 Vision interface to the latest version. For this document, we tested revision 6.2 USB3 Vision interface.

  3. To update your USB3 Vision interface for HALCON 12, extract the USB3 Vision interface update downloaded in step 1 above. Then copy and replace the corresponding files to the HALCON framework path.

  4. Connect the USB3 camera to the computer and ensure that the camera is using USB3 Vision firmware.
  5. To check if your camera is using USB3 Vision firmware:
    1. Go to OS X system information → Hardware → USB.
    2. Select your USB3 camera.
    3. Check the camera’s product ID and Vendor ID. The correct numbers for USB3 are:
      • Vendor ID — 0x1e10
      • Product ID — 0x3300

If the camera is not using USB3 Vision firmware, see Troubleshooting for instructions on how to update to the firmware.

 

Firmware cannot be updated using OS X. Use Windows to update to USB3 Vision firmware, then use the camera on the original (OS X) system.

Configuring a USB3 Camera

  1. Open HALCON and start HDevelop.
  2. Click Auto-detect Interfaces. Note: USB3 Vision appears automatically in the Auto detect menu.



  3. In the Connection tab, press Connect to connect the host PC to the camera.



  4. Click the Parameters tab and choose the category of settings that you want to change.

Streaming a USB3 Camera

Go to the Connection tab and press Live to continuously capture images.

Troubleshooting

How do I verify that my camera is running at USB3 speed?

To verify that your camera is running at USB3 speed:

  1. Go to OS X → System information → Hardware → USB.
  2. Select your camera and note the speed indicated.

If your camera is running at USB2 speed, the speed is Up to 480 Mb/sec.

If your camera is running at USB3 speed, the speed is Up to 5 Gb/s.

If your camera is running at USB2 speed, verify that you are using the recommended USB3 cable and host controller card. See this list of recommended USB3 system components for additional details and suggestions.

How do I update my camera's firmware to USB3Vision firmware?

 

Camera firmware that supports USB3 Vision has a “USB3 Vision Firmware” label on the download link.

You can update your USB3 camera firmware in Windows or Linux.

To update:

  1. Download the latest FlyCapture2 SDK from the Point Grey Downloads page.
  2. Download the latest USB3 Vision firmware.
  3. Connect the camera to the PC and ensure the camera has powered up.
  4. Open the UpdatorGUI utility that was installed with FlyCapture2 SDK.
    Start menu → All Programs → Point Grey FlyCapture2 SDK → Utilities → UpdatorGUI

  5. Select the camera from the Camera List.
  6. Click Open to select the firmware file.
  7. Click Update to begin the update process. Do NOT disconnect the camera until the update is complete.