INTERNAL USE ONLY (Set it to white if you do not need it)

Transcription

1 APPLICATION NOTE Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging Common Vision Blox (CVB) Applicable to Vision Interface Standard cameras and Windows operating systems only Document Number: AW Version: 04 Language: 000 (English) Release Date: 25 July 2016 Software Version: CVB 2016 (v12) INTERNAL USE ONLY (Set it to white if you do not need it)

2 Contacting Basler Support Worldwide Europe, Middle East, Africa Basler AG An der Strusbek Ahrensburg Germany Tel Fax The Americas Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA USA Tel Fax Asia-Pacific Basler Asia Pte. Ltd. 35 Marsiling Industrial Estate Road 3 #05 06 Singapore Tel Fax support.asia@baslerweb.com All material in this publication is subject to change without notice and is copyright Basler AG.

3 Table of Contents 1 Introduction Steps to be Carried Out Checking Hardware Requirements Installing Common Vision Blox Configuring Your Network Adapter for GigE Vision Assigning an IP Address to the Camera Assigning a Temporary IP Address Assigning a Persistent IP Address or Enabling DHCP Configuring Your USB3 Vision Camera Opening Your Camera Troubleshooting Firewall Settings Network Interface Controller (NIC) Settings Transport Layer Settings Revision History Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 1

4 1 Introduction This document explains how to interface a Basler GigE Vision or USB3 Vision camera with the Stemmer Imaging Common Vision Blox 2016 software (version 12) using standard USB 3.0 ports or standard Gigabit Ethernet network adapters. The CVB package includes all necessary drivers. No other Basler software is required. 2 Steps to be Carried Out 2.1 Checking Hardware Requirements In addition to the Basler camera and its power supply, an Ethernet cable (Cat 6 or higher) is required. For GigE cameras, your PC must be equipped with a Gigabit Ethernet network adapter card (also called Network Interface Controller or NIC). For USB3 cameras, you need a USB3 port onboard or provided by a USB3 host controller. For all devices, you need a suitable cable. We recommend using a network adapter from the Intel Pro 1000 family or an adapter with a comparable chipset. Due to the characteristics of the chipset, this adapter can be optimized for GigE cameras. This optimization may not be possible with other adapters, and grabbed images may be corrupted. For USB3 please refer to the Setting up a Stable USB 3.0 Camera System document. The document can be downloaded from the Basler website. 2.2 Installing Common Vision Blox Before installing the CVB software package, additional installations packages related to licensing and security are executed by the installer. Figure 1: Additional Requirements Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 2

5 After the packages have been installed, choose the Custom setup type and make sure the GenICam option is selected. Figure 2: Install Options Choosing this installation enables socket-based GigE Vision access. This works for most configurations. However, if you use socket-based access, be aware that the CPU load is higher. To decrease the CPU load caused by the GigE Vision interface, you can install the sifilterip GigE Vision filter driver. To do so, open the Network Connections window, right click the name of your network adapter and select Install. In the Select Network Feature type window, select Service, click Add, and choose the sifilter IP driver: Figure 4: Select Network Filter Type Window Figure 3: LAN Properties Window Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 3

6 Figure 5: Select Network Service Window 2.3 Configuring Your Network Adapter for GigE Vision By default, Basler GigE Vision cameras are configured to obtain their IP address automatically (no static IP address). We recommend that you also configure your network adapter to obtain IP addresses automatically. If there s already another network adapter configured to obtain IP addresses automatically, consider configuring a statically addressed subnet. To do so, open the Network Connections window, right click the name of your network adapter and select Properties from the drop down menu that appears. From the list, select Internet Protocol Version 4 (TCP/IPv4). You may need to scroll down to see the entry. Click the Properties button. A window opens, allowing you to configure automatic IP address allocation (see Figure 6) or manual input of the IP address (see Figure 7). Figure 6: Automatic IP Address Configuration Figure 7: Manual IP Address Configuration Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 4

7 2.3.1 Assigning an IP Address to the Camera To access your GigE Vision camera, start the GenICam Browser of the CVB Software Suite. Figure 8: Camera Devices in the GenICam Browser If your camera doesn t show up, choose from one of the following options in the toolbar: Discover (finds well addressed devices) Ignore Subnet Discover (finds connected devices) Assign IP (configures the IP address) If the camera is found by the Ignore Subnet Discover function but not by the Discover function, you must allocate an appropriate IP address before you open the camera Assigning a Temporary IP Address You can assign a temporary IP address that will be used for the current application session only. To do so, click the Assign IP button in the toolbar and set a proper temporary IP address within your subnet. Figure 9: Assigning a Temporary IP Address Auto Select IP suggests an IP address based on your network configuration. Set assigns the temporary IP address. Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 5

8 Assigning a Persistent IP Address or Enabling DHCP To assign a persistent (static) IP address or to enable DHCP, click the Assign IP button in the toolbar and choose between the following three options: Figure 10: PosEnabling DHCP Figure 11: Assigning a Persistent IP address If your camera is configured for Auto IP (LLA) and you click on Auto Select IP, the Assign persistent IP (Static) option will be chosen automatically: Figure 12: Persistent IP Configuration Based on Auto IP (LLA) Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 6

9 2.4 Configuring Your USB3 Vision Camera Basler USB3 Vision cameras can also be accessed by the CVB Software Suite. To enable USB3 support, make sure that the Basler USB device driver and other allocated drivers for the camera are uninstalled. Then, reconnect the camera. The CVB Software Suite will recognize the device and install the Stemmer libusbk driver to access the USB3 Vision device. While the driver is installing, the icon is shown repeatedly in the Windows system tray. Wait until all installations are complete. If incompatible USB3 drivers are installed or if the driver has not been installed correctly, Vision Blox Suite may recognize the USB3 device but fail to list the camera: In this case, start the CVB Management Console and open the U3V Driver Manager. With this tool, you can uninstall the incompatible drivers and install the Stemmer drivers. Make sure the camera device is available (i.e., not used by another application). Then, click Uninstall to start the CVB driver installation. Once the installation is complete, you can click Update device list. The driver type for the device should now be Stemmer Imaging Class Driver. Figure 13: U3V Driver Manager Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 7

10 2.5 Opening Your Camera After the camera has been properly configured, you can open the camera in the GenICam Browser. Figure 14: Camera Operation in GenICam Browser The buttons can be used to control image acquisition. Using the property tree on the right, you can access all camera features. You can also access the camera in the Device Configurator of the Common Vision Blox Management Console: Figure 15: Management Console Displaying Test Image and Camera Properties Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 8

11 3 Troubleshooting 3.1 Firewall Settings Any application that uses the GigE Vision network protocol must be able to accept data from the camera on several different UDP ports. On systems equipped with a firewall, you should disable the firewall at least for the network adapter to which your camera is connected. This especially applies to newer operating systems, as they handle firewall rules more strictly. 3.2 Network Interface Controller (NIC) Settings If image acquisition is unreliable, change, if applicable, the following settings of your network adapter card: Packet size: The maximum size of a data packet transmitted via Ethernet. By default, the packet size is set to 1500 bytes. This will be sufficient for most configurations. However, with more demanding camera models or inadequate hardware, it may be necessary to increase the packet size. This is possible because the GigE Vision stream can handle larger packet sizes than 1500 bytes. Basler recommends a significant increase of the packet size to up to 9014 bytes. This will reduce Ethernet overhead load and thus improve efficiency. Increasing the packet size above 1500 bytes requires enabling the so-called Jumbo Frames support on each involved network device including possible switches. Whenever you increase the packet size for your network controller card, you must also adjust the packet size on the camera side. Ethernet flow control: Basler recommends enabling Ethernet flow control if the network adapter supports it. This may decrease packet loss. If enabled, the streaming packet flow can pause and restart. This prevents the main memory from falling behind the packet processing. Receive buffers: The Ethernet adapter buffers received packets within so-called receive descriptors. If the number of descriptors for storing received camera stream packets is lower than actually required, the overflow will be lost. The number of buffers is essential to ensure high bandwidth stream transmission. The best choice is to increase the number of buffers to the maximum applicable value. Interrupt moderation: Controls how interrupts are received and handled. While normal traffic requires a lower rate of moderation, a typical GigE Vision stream requires more interrupt moderation. However, dealing with interrupt moderation affects the camera-to-network-adapter transmission as well as the CPU load. Try to find the optimum amount of moderation for your network configuration. Usually, the moderation can be set in predefined steps, e.g. Low, High, Extreme or Adaptive. The parameters mentioned above can be found in the Windows Network Connections window. To access the window, right-click on your network adapter, select Properties and click Configure Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 9

12 3.3 Transport Layer Settings Packet Size: Whenever you increase the packet size for your network controller card (see Section 3.2), you must also adjust the packet size on the camera side. Make sure the value for the camera doesn t exceed the values set for other communication partner devices. Otherwise, streaming may fail due to blocked packets. Inter-packet delay: If your Ethernet adapter or other devices can t handle the incoming packet rate, it is useful to increase the delay between packet transmissions. This may reduce the amount of dropped packets. Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 10

13 Revision History Document Number Date Changes AW Jul 2008 Initial release version of this document. AW Jul 2008 Updated contact addresses and phone numbers. AW Jan 2009 Updated the firewall configuration information. AW Jul 2016 Revision of the entire document. Updated to CVB 2016 software whenever applicable. Added Chapter 3 ( Troubleshooting ). Interfacing Basler GigE and USB3 Vision Cameras with Stemmer Imaging CVB 11