AVT GigE (Bigeye/Pearleye/Goldeye) How to install a GigE camera Bigeye/Pearleye/Goldeye V2.0.
Legal notice Trademarks Microsoft, Windows, Windows 7, Windows Vista, and Windows XP are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Unless stated otherwise, all trademarks appearing in this document of Allied Vision Technologies are brands protected by law. Warranty The information provided by Allied Vision Technologies is supplied without any guarantees or warranty whatsoever, be it specific or implicit.
Contents Contacting Allied Vision Technologies ................................................... 5 Introduction ............................................................................................................ 6 Document history............................................................................................................ 6 Manual overview .............................................................................................................
Using National Instruments software ............................................................................ 32 Performance optimization .............................................................................35 Using AcquireControl ..................................................................................................... 36 Using 3rd party solutions................................................................................................ 36 Adjusting firewall settings ..........
Contacting Allied Vision Technologies Contacting Allied Vision Technologies Info • Technical information: http://www.alliedvisiontec.com • Support: support@alliedvisiontec.com Allied Vision Technologies GmbH (Headquarters) Taschenweg 2a 07646 Stadtroda, Germany Tel.: +49 36428-677-0 Fax.: +49 36428-677-28 e-mail: info@alliedvisiontec.com Allied Vision Technologies Canada Inc.
Introduction Introduction This Manual describes in depth the installation of the AVT GigE cameras (Bigeye/Pearleye/Goldeye). Note Please read through this manual carefully. For more information, see http://www.alliedvisiontec.com/emea/support/downloads/ product-literature.html Document history Version Date Description V2.0.0 03.11.
Introduction • • • Chapter Adjusting firewall settings on page 37 describes how to configure the firewall settings. Chapter Troubleshooting on page 38 helps you when you get in trouble. Chapter Index on page 49 gives you quick access to all relevant data in this manual.
Introduction Before operation We place the highest demands for quality on our cameras. Target group This Technical Manual is the guide to detailed technical information of the camera and is written for experts. Note Caution Please read through this manual carefully before operating the camera. Before operating any AVT camera read the following safety instructions and ESD warnings.
Introduction Cleaning instructions Note Dark spots on the image, especially at nearly closed aperture, are mostly caused by dust on the sensor of the camera. Allied Vision Technologies GmbH cleans the sensors around the lens mount thread with pure air in a clean room class 1000. After a careful test in the clean room a seal is affixed on the lens mount aperture.
IP-based camera access: background IP-based camera access: background In order to access a camera (or any other device) in the network, it is necessary that the camera and also the Network Interface Card (NIC) have a valid IP address. Every device in the network must have a unique IP address. The following graphic illustrates the assembling of such network: Figure 1: Network with IP-based cameras The chosen IP addresses and the way the devices are connected in the illustration above are just an example.
IP-based camera access: background • • • • The NIC (Network Interface Card) of the PC should be Gigabit Ethernet (1000Base-T) compatible. If Windows XP is used as operating system, make sure that the Microsoft Hotfix KB926255 is installed. After the first functional test of the camera you can try to re-enable Firewalls and antivirus solutions step by step: see Chapter Adjusting firewall settings on page 37.
IP settings: preliminary considerations IP settings: preliminary considerations There are several different ways the camera may get its IP address. Please refer to the following subchapters to choose the best solution for your application. Please also refer to Chapter General tips for setting IP addresses on page 16 for additional information how to set an IP address for a NIC (Network Interface Card).
IP settings: preliminary considerations Static IP address The camera can also use a static IP address. This address can be set while connecting to the camera with the external tool AcquireControl. Note The Pleora driver has to be installed to run this application. Figure 2: Select static IP address Example: PC Camera 192.168.1.1 Set by the user once 192.168.1.2 Set by the user manually after every camera power up.
IP settings: preliminary considerations Static Persistent IP for GigE Vision camera To store a persistent IP for a camera with GEV firmware the Pleora software GEVPlayer should be used. Please refer to Chapter Installing GigE driver from Pleora on page 18 regarding installation of this software. 1. Open GEVPlayer, select the camera and set the desired persistent IP Figure 3: GEV Device Selection 2.
IP settings: preliminary considerations Figure 4: GEV Device Control How to install a GigE camera (Bigeye/Pearleye/Goldeye) V2.0.
General tips for setting IP addresses General tips for setting IP addresses 1. While changing Windows IP address settings make sure that no camera application is running. 2. To set the IP address of a PC NIC, open the network connections (Start -> Settings -> Network connections). Then open the properties window of the desired connection. Figure 5: Set IP address 3. It is also possible to add a second (or even more) IP address(es) to the NIC.
General tips for setting IP addresses Figure 6: TCP/IP If the two entries in this example were swapped the camera would work in the 192.168.1.XXX range. To verify which NIC IP address is used by the Pleora IP engine, click on the NIC entry during camera selection process. Figure 7: IP Engine Selection How to install a GigE camera (Bigeye/Pearleye/Goldeye) V2.0.
Installing GigE driver from Pleora Installing GigE driver from Pleora In order to access a camera it is not necessary to install a driver. Note We recommend to use the iPORT/eBUS Filterdriver architecture for the best performance. (Manufacturers drivers usually have a slow performance.) It is not necessary to install any driver if you want to work with National Instruments applications. 3rd party solutions also support GEV compliant cameras.
Hardware connection and first power up Hardware connection and first power up 1. Connect the camera via a CAT5e cable to the PC/notebook. This can be done directly or over a gigabit network switch. 2. Connect the camera to the power supply. 3. Power on the camera and verify the state of the LEDs on the backside of the camera. It can take up to 5 seconds until the LEDs reach their settled state that means that the camera is ready for use.
Display camera live images Display camera live images In order to display live images from the camera several programs can be used. The following subchapters describe how to get a live image using these programs. Please also refer to the detailed manual of the chosen application. Using AcquireControl Most of the following settings are stored by the application, so these configuration steps are necessary only once. Select the grabber Figure 10: Select grabber Now the “IP Engine Selection” dialog pops up.
Display camera live images Select the IP address In dependence of the driver version you use, the appearance of this dialog may differ. If an IP address could not be set automatically it can be set within this dialog manually. Figure 11: Select IP address After closing the “Set IP Engine IP Address” dialog you now can select the eBUS Filter driver entry. How to install a GigE camera (Bigeye/Pearleye/Goldeye) V2.0.
Display camera live images Select the camera Bigeye cameras Goldeye cameras Pearleye cameras Table 3: Select the camera model you want to use Select the image processing chain Figure 12: Select image processing chain How to install a GigE camera (Bigeye/Pearleye/Goldeye) V2.0.
Display camera live images Start the continuous snap Figure 13: AcquireControl: Start continuous snap Now you will get live images from the camera with the default exposure time and default camera settings. You can stop the live image by “Stop snap” at every time. Advanced operations The AcquireControl software was developed for many different cameras, so we will try to introduce you in the basic commands for controlling your camera.
Display camera live images Figure 15: Camera control: Exposure control Bigeye cameras Mode Screenshot Continuous Mode. The camera will use it’s build in exposure signal, which is always constant. IOD Timer Mode. The exposure signal is generated by a timer, which can be adjusted with the dialog. IOD Trigger Mode. The camera will wait for an external exposure signal.
Display camera live images To adjust the exposure time, you always have to process two steps: 1. Adjust the Exposure time or Continuous mode and Gain setting like described in Chapter Bigeye cameras on page 24. 2. Select the corresponding correction data set as follows: Figure 16: Camera Control Terminal Figure 17: Goldeye: Terminal example: V=0 How to install a GigE camera (Bigeye/Pearleye/Goldeye) V2.0.
Display camera live images Figure 18: Goldeye: Terminal example: S=4 Note V and S are upper case letters Pearleye cameras For Pearleye cameras it is not possible the change the exposure time. Pearleye cameras work always in Continuous mode. The internal image correction in the camera should be calibrated from time to time and some minutes after the camera has switched on. How to install a GigE camera (Bigeye/Pearleye/Goldeye) V2.0.
Display camera live images Figure 19: Camera Control Terminal Figure 20: Pearleye: calibration The calibration can be started by the command “k=0”. After some seconds the camera is calibrated. How to install a GigE camera (Bigeye/Pearleye/Goldeye) V2.0.
Display camera live images Note k is a lower case letter Pseudo Color & Contrast Enhancement With the help of the “Pseudo color” dialog you can change the display of an image. Also you have the possibility to change the contrast of the displayed image to see more details of the 12-bit values. Note Note Don’t scramble this with the camera parameters. The contrast slider only changes the displayed values of the 12-bit camera image and not the camera data itself.
Display camera live images Background Correction You can add an additional background correction (see “Image processing” menu) in the AcquireControl to get a better image quality. Therefore you have first record a homogeneous image and than set the average value and switch on this correction. Note The availability of this dialog depends on the chosen image process chain (see Chapter Select the image processing chain on page 22).
Display camera live images Figure 23: Pearleye: Statistics and histogram By clicking on the Options button you can decide to calculate the histogram for the whole image or only for an AOI. Using Pleora Coyote 1. Install the “GigE VDS Camera Integration DLL” available as download from the AVT website. 2. Start Coyote. 3. Select the camera by clicking on “Detect…” and set IP (if necessary). 4. Select the camera type. 5. Click on “Connect”. 6. Go to the “Acquisition” tab and click on “Start”.
Display camera live images If the “GigE VDS Camera Integration DLL” is not installed, the Programmable Logic Controller of the IP Engine and the image format has to be setup manually: 7. After connecting to the camera click on “Configure”. 8. Adjust the settings for I0 … I7 and the Lookup Table as follows: Figure 24: Pleora Coyote: Configuration 9. Click on the “Pixel” tab and select the correct “Color space” and “Pixel depth”. 10.
Display camera live images Using Pleora GEVPlayer The Pleora GEVPlayer is an application which can grab images from a camera with GigE Vision configuration. All Bigeye/Pearleye/Goldeye cameras are GigE Vision V1.2 compliant. Note In order to work with a GigE Vision compatible camera it is necessary to use at least Pleora driver version 2.3.3. 1. Start GEVPlayer. 2. Select the camera by clicking on “Select / Connect” and set IP (if necessary). 3. Click “Play”. 4.
Display camera live images Figure 25: IMAQdx driver 2. Open the “Devices and Interfaces” branch. After a few seconds the camera should appear. 3. Click once on the camera entry. Now every register of the camera is read which can take a few seconds. 4. In the lower pane of the MAX software now several controls appear for accessing the camera parameters. Please also refer to Chapter Appendix on page 40 for more information regarding the registers. Figure 26: MAX: CameraAttributes 5.
Display camera live images all NI applications and delete all files and folders within the following directory: C:\Documents and Settings\All Users\Documents\National Instruments\NIIMAQdx\Data 7. When you want to switch between a GigE Vision application (e.g. NI MAX) and an iPORT application (e.g. Coyote), it is necessary to power cycle the camera. 8. In some situations the MAX software is not able to confirm the used pixel format.
Performance optimization Performance optimization The video data from the camera is (like all other data in the network) transferred in packets. The default value for this packet size is 1440 bytes. In some cases it can be an advantage to increase this packet size because then fewer packets are needed to transfer the image data. This results in less overhead and better performance. But these oversized packets are not standardized so not every network card / device supports it.
Performance optimization Using AcquireControl 1. Close AcquireControl. 2. Go to the installation directory. 3. Open the file UniGrab.ini with a text editor. 4. Find the “GRABBER_” section with the description Gigabit Ethernet (iPORT) 5. Find the value PacketSize and enter the determined Jumbo Frame size – 72 bytes. 6. Save the file and start AcquireControl again. Using 3rd party solutions Using National Instruments software 1. Start MAX. 2. Open the camera. 3.
Adjusting firewall settings Adjusting firewall settings 1. For the first test all firewalls and antivirus solutions should be disabled. Only when the camera can be accessed properly without any firewall one can try to adjust firewall settings step by step. The communication from and to the camera is done in the UDP protocol. 2. A global rule for incoming and outgoing traffic should be created Rule: Pleora outgoing (Allow) • Protocol: UDP • Direction: Outgoing, Packet type: Local • Remote Host: 255.255.
Troubleshooting Troubleshooting • If the camera can be detected but no images can be grabbed, verify the camera operation mode. Basically every AVT camera can work in three modes: – Continuous Mode – The camera generates the images with a constant exposure time independently. This exposure time cannot be adjusted. – Image On Demand (IOD) Trigger mode – The camera produces no image until an external trigger impulse reaches the trigger input pin of the camera.
Troubleshooting • • • “Pleora Technologies Inc” folder of the Start menu. Save the generated output to a file. Make screenshots of the problem and the network connection dialogs of windows. Write down the state of the LED’s on the backside of the GIP-1000 camera module. Mail all the files to the AVT support support@alliedvisiontec.com with a detailed description of the problem including: – Camera model name. – Camera serial number. – Type of Power Supply used (AVT or own).
Appendix Appendix GigE Vision register description Note This chapter describes all GigE Vision features. In dependence of the used camera the availability of certain features may vary. DeviceInformation Feature Description DeviceModeName Name of the attached camera model. DeviceID Unique 32 bit device ID of the AVT camera model. DeviceUserID User ID field. This field can be accessed (R/W) by the user to store an additional device identifier.
Appendix ImageSizeControl Feature Description SensorWidth Maximum width of the sensor in pixels. SensorHeight Maximum height of the sensor in pixels. WidthMax This feature represents the maximum width (in pixels) of the image after horizontal binning, decimation or any other function changing the horizontal dimensions of the image.
Appendix AcquisitionControl Feature Description AcquisitionMode This feature controls the acquisition mode of the software. This feature works independently (!) of the chosen camera mode (Continuous, IOD hardware trigger, IOD hardware timer). It describes how many frames should be acquired. AcquisitionStart Starts the image acquisition of the camera. AcquisitionStop Stops the image acquisition of the camera. TriggerMode Modifies the trigger mode of the camera.
Appendix CameraSpecialFeatures What is a CameraSpecialFeature? This section contains camera depending commands like serial commands (if available). For each command within this branch you will find a description text in your GigE Vision software. The description contains a reference to the serial command which can be found in the base manual of the camera for further information.
Appendix Feature Description CameraTemperatureState Camera temperature state. 0 = The camera temperature is OK. 1 = The camera temperature is outside the optimum range. CameraTemperatureStateReg Camera temperature state register. QueryCameraTemperatureState Query camera temperature state. (T=1 command) Table 11: Camera special feature: Camera temperature Feature Description SensorTemperatureState Camera sensor temperature state. 0 = The sensor temperature is OK.
Appendix CameraSpecialFeatures\TwoPointCorrection Feature Description TPC_OperationMode Operation mode of the two-point correction. (E= command) TPC_CorrectionData_FileNumber File number of the flash file containing the set values for the two-point correction. (N= command) TPC_SetValue_LowRef Define the set value for the low reference image of the two-point correction.
Appendix CameraSpecialFeatures\LUT Feature Description LUT_OperationMode Operation mode of the LUT. (G= command) LUT_CorrectionData_FileNumber File number of the data for the LUT. (D= command) Table 16: Camera special feature: LUT CameraSpecialFeatures\IntegratorAndImageStore Feature Description IIS_OperationMode Operation mode of the integrator and image store. (H= command) While reading this feature the MSB shows the state of the integration process.
Appendix GigE Vision timer calculations The following graphic shows how an exposure signal is generated. Figure 28: GigE Vision timer calculations In order to adjust tExp and tDark of the TREX pulse in each case two parameters are available: • ExposureTime & ExposureTimeGranularity • DarkTime & DarkTimeGranularity The granularities are integer values in the range from 0…65535 which define the minimum and maximum pulse widths. The minimum pulse width is equal to the time granularity.
Appendix Feature mapping This table shows the mapping of the camera features to the corresponding features in the GigE Vision naming convention. AVT camera feature Camera Link CC port GigE Vision feature names TREX CC1 ExposureMode, ExposureTime, DarkTime TREX is an input signal. The LOW time defines the exposure time. The HIGH time defines the dark time. BIN CC2 BinningVertical. If the camera has 2x2 binning implemented, the BinningHorizontal feature is set automatically.
Index Index A T AcquireControl using ................................................ 20 Technical information ................................. 5 timer calculations..................................... 47 Troubleshooting....................................... 38 C camera live images ................................... 20 Conformity .............................................. 10 Contacting ................................................ 5 D declaration of conformity ...........................
