opto engineering ITALA Instruction Manual

opto engineering ITALA Instruction Manual

Gige vision cameras
Table of Contents

Advertisement

Quick Links

INSTRUCTION MANUAL
ITALA
GigE Vision Cameras
v1.12 - eng
CAMERAS

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ITALA and is the answer not in the manual?

Questions and answers

Summary of Contents for opto engineering ITALA

  • Page 1 INSTRUCTION MANUAL ITALA GigE Vision Cameras v1.12 - eng CAMERAS...
  • Page 2: Table Of Contents

    Contents GENERAL INFORMATION Disclaimer ........Intended use .
  • Page 3 Itala SDK ........
  • Page 4 6.1.1 Bandwidth limit ........Image Format Control ........6.2.1 Image ROI .
  • Page 5 7.1.2 Synchronizing an external device with Itala cameras ....114 How to add a delay on the Output Lines of the camera ....116 Streaming bandwidth management .
  • Page 6: General Information

    1 GENERAL INFORMATION 1.1 Disclaimer Always use and store Opto Engineering® products in the prescribed conditions in order to ensure they function properly. Failing to comply with the following conditions may shorten the product lifetime and/or result in malfunctioning, performance degradation or failure.
  • Page 7: Revisions

    Itala | INSTRUCTION MANUAL • This device must not be used in an application where its failure could cause a hazard to human health or damage to other equipment. Keep in mind that if the device is used in a manner not foreseen by the manufacturer, the protection provided by its circuits and by its enclosure may be impaired;...
  • Page 8 - Added references to new camera features 1.1.3 - 1.1.5 - Added SDK installation section - Added Driver installation section - Added Itala View quick start section - Added Itala View wizards sections 10/02/2023 - Added CCM calibration procedure 1.2.0 - 1.2.2...
  • Page 9: Ordering Code

    ITA000-WX-00Y-ZZ The ordering code is explained in Table 2. Refer to Opto Engineering website to check the availability of the desired part number. NOTE: ITA13-GM-10C-SWIR product is subject to statutory export control regulations and may require written information on intended end use and final destination.
  • Page 10 Itala | INSTRUCTION MANUAL Code Description Options Value Series Name Sensor resolution IMX287 - 0.40 Mpixels IMX990 - 1.34 Mpixels IMX273 - 1.58 Mpixels IMX249 - 2.35 Mpixels IMX392 - 2.35 Mpixels IMX265 - 3.19 Mpixels IMX264 - 5.07 Mpixels IMX547 - 5.10 Mpixels...
  • Page 11: Warranty And Certifications

    • Maintenance being performed correctly as described in the device manual; • The intended use of the device as specified in this manual. 2.2 CE Declaration Itala cameras are conformal to the EMC directive 2014/30/EU and therefore comply with the fol- lowing standards: Date of issue...
  • Page 12: Kc Certification

    South Korean market. In particular, the certification checks the requirements for electromagnetic compatibility (EMC). Itala cameras available for the South Korean market are identified by the KC mark and the KC registration number. For more information about the KC identification data, please scan the QR code on the product or its packaging.
  • Page 13 Itala | INSTRUCTION MANUAL • REACH 1907/2006/EC • WEEE 2012/19/EU v1.12 - eng...
  • Page 14: Introduction

    (Mn) - Italy, hereinafter the manufacturer, provides all the necessary information in this installation, use and maintenance manual in a clear and simple way to install, use and service the product Itala. The recipients of this manual are all those who have the knowledge, experience and capability of understanding the standards, prescriptions and safety measures indicated in this manual.
  • Page 15: Storage And Use Conditions

    Itala | INSTRUCTION MANUAL ITA000-AB-00C-DD 123456 MAC: 88-5F-E8-20-00-00 MADE IN ITALY Figure 1: Example of camera label. 3.3 Storage and use conditions 3.3.1 Storage conditions Storage environment between -10°C and 60°C. Avoid thermal shock by not exposing the product to sudden changes in temperature.
  • Page 16: Cleaning And Maintenance

    Itala | INSTRUCTION MANUAL Itala cameras have been tested in climatic chamber in order to prove the temperature capabilities. Case temperature must not be exceed the range -25°C 65°C. NOTE: The case temperature has been measured on the external part of the aluminum case, near the mount of the camera.
  • Page 17: Getting Started

    4 GETTING STARTED 4.1 Overview Itala is an industrial Gigabit Ethernet camera compliant with the GigE Vision and GenICam spec- ifications. This camera is capable of transferring image data at high frame rates and over long distances, up to hundreds of meters.
  • Page 18: Ethernet Cable

    ANSI/TIA-568 standard. A shielded cable can be used to improve the system EMI immunity, especially in harsh industrial environments. Itala cameras come with 2 x M2 threaded holes for use with screw lock RJ45 connectors. For moving applications (e.g. camera mounted on a robotic arm) use screw lock connectors and cable strain reliefs to ensure a reliable connection.
  • Page 19: Liquid Lens

    4.2.5 Liquid lens If the camera comes with the Liquid Lens Controller option, use a specific cable to connect the camera GPIO port to an Opto Engineering® product integrating an electrically tunable lens. There are two possible configurations: • A dedicated point-to-point cable allows for a simple connection of the liquid lens when the camera is powered via PoE.
  • Page 20: System Configuration

    4.3.1 System requirements The Itala SDK can be installed in a system working with one of the following OS: • Microsoft Windows 10 / 11 (64-bit) • Ubuntu 18.04 / 20.04 / 22.04 (64-bit) Proper functioning of the camera has not been tested with other operating systems.
  • Page 21 If you need to re-install the drivers after an unwanted removal, follow this procedure: 1. Go to the Itala SDK installation directory. 2. Open the Filterdriver folder. 3. Launch install_driver_win10.bat in case of Windows 10 OS. Please be careful to choose the...
  • Page 22: Network And Configuration

    Itala | INSTRUCTION MANUAL correct batch depending on the operating system. 4. At the end of the installation, the filter driver will appear in the NIC property window (Fig.2). 4.3.3 Network and configuration The camera is factory configured to automatically obtain an IP address in DHCP / LLA mode. This ensures the highest compatibility with different network configurations.
  • Page 23: Bandwidth Management

    NIC (network interface card) to use Jumbo frames. Jumbo frames are Ethernet frames which are larger than 1500 bytes and allow to increase the connection efficiency, reducing the amount of protocol overhead. Opto Engineering® recommends to use a NIC which supports Jumbo frames of at least 9000 bytes.
  • Page 24: Itala Sdk

    In order to install the Itala SDK correctly, do the following steps: 1. Download the Itala SDK from Opto Engineering website and run the installer. 2. The Itala SDK setup window is displayed: make sure to follow the instructions listed (Fig.6). Figure 6: Itala SDK setup window.
  • Page 25 Itala | INSTRUCTION MANUAL Figure 7: Itala SDK licence agreement window. Figure 8: Itala SDK destination folder window. v1.12 - eng...
  • Page 26 Itala | INSTRUCTION MANUAL Figure 9: Components selection window. Figure 10: .NET runtime installation window. Figure 11: .NET runtime successful installation window. v1.12 - eng...
  • Page 27 Itala | INSTRUCTION MANUAL Figure 12: Itala SDK installation finished successfully. v1.12 - eng...
  • Page 28: Using The Camera With Itala Api

    Itala | INSTRUCTION MANUAL 4.5 Using the camera with Itala API With Itala API it’s easy to integrate Itala devices in custom applications, thanks to an extensive set of examples and complete documentation. For more information about the use of the library, refer to Itala API documentation in the SDK installation folder.
  • Page 29: Tabs And Panels

    Itala | INSTRUCTION MANUAL 4.7.1 Tabs and panels With reference to Fig.14, the main window of Itala View can be divided in different functional areas: 1. Menu bar 2. Device discovery 3. Device information and control 4. Video streaming 5. Image data analysis and logging 6.
  • Page 30: Ip Configurator

    4.7.2 IP configurator From the Tools menu you can access the IP Configurator utility. The IP configurator has been de- signed to efficiently address network configuration issues of Itala cameras, including but not re- stricted to: • Camera and NIC set with persistent IPs but different subnets •...
  • Page 31: Firmware Update

    From the Tools menu you can access to the Firmware Update utility (Fig.16). You can now select a firmware file for each device that has been enumerated. The latest firmware for Itala cameras can be downloaded from Opto Engineering website.
  • Page 32 Itala | INSTRUCTION MANUAL Figure 16: FW updater window. v1.12 - eng...
  • Page 33 Itala | INSTRUCTION MANUAL Figure 17: FW update in progress. v1.12 - eng...
  • Page 34: Lut Wizard

    Itala | INSTRUCTION MANUAL 4.7.4 LUT wizard From the Wizard menu you can access to the LUT wizard. This allows to view and edit the LUT of the selected camera. Click on Import from camera to read the LUT from the camera registers and display it in the Chart tab (Fig.18).
  • Page 35: Defective Pixels Correction Wizard

    6.18. Anyway, there are other environmental factors which can increase the amount of defective pixels during the camera life. For this reason, Itala cameras enable the user to perform a custom pixel correction that takes into account these defects.
  • Page 36 Itala | INSTRUCTION MANUAL Figure 20: Defective pixels correction wizard. 5. Click on the Acquire button in the Dark images panel to acquire a first batch of dark images. 6. Click on the Find button on the same panel to detect the leaky pixels.
  • Page 37: Color Correction Wizard

    Itala | INSTRUCTION MANUAL 4.7.6 Color correction wizard From the Wizard menu you can access the Color correction wizard (Fig.21). With a reference color checker (Fig.22) is possible to calibrate the camera in specific light conditions and obtain an optimal color rendering.
  • Page 38 Itala | INSTRUCTION MANUAL Follow these steps to achieve a correct calibration: 1. Select the desired device. 2. Start the image acquisition. 3. Open the Color Correction Wizard (Wizard > Color correction) (Fig.23). 4. Point the camera to a reference color checker (Macbeth chart) such that its orientation match the one visible in overlay.
  • Page 39 Itala | INSTRUCTION MANUAL Figure 24: For optimal results, make sure to align the wizard color mask to the Macbeth color chart tiles. v1.12 - eng...
  • Page 40: Technical Specifications

    Itala | INSTRUCTION MANUAL 5 TECHNICAL SPECIFICATIONS 5.1 Technical specifications In Table are summarized the main camera features. Further explanations will be given in the following chapters. Features Standard version Liquid Lens Ref. version page IMAGE FEATURES ADC resolution 10/12bit...
  • Page 41 Itala | INSTRUCTION MANUAL PoE (Power over Ethernet) Gigabit ethernet Packet resend option Static IP/DHCP IEEE 1588 (PTP) Opto-isolated inputs p.52 Opto-isolated outputs p.52 Temperature sensor Image sensor, FPGA Image sensor, FPGA User sets Factory + 2 user sets Factory + 2 user sets Remote FW update p.30...
  • Page 42: Electrical Specifications

    Table 7: Electrical specifications In Table are shown the results of the minimum/maximum input delays when Itala camera is trig- gered by an external device: the column Input voltage defines the triggering-signal voltage level, while the columns MIN Input delay and MAX Input delay show the signal propagation time from the digital input, on the connector, to the sensor acquisition trigger, in the case the trigger overlap is disabled.
  • Page 43 Itala | INSTRUCTION MANUAL Table 8: Minimum and Maximum input delays when Itala cameras are triggered by an external device In Table are shown the results of the minimum/maximum output delays when Itala camera trig- gers external devices: the column Supply Voltage refers to the voltage connected to the OPTO REF V+ pin while the columns Load Resistance indicates the load connected to the opto-isolated output port.
  • Page 44: Sensor Optical Response

    4700 36.9 23.8 Table 9: Maximum output delays and electrical measurements for Itala cameras output signals 5.3 Sensor optical response Typically all the 1st generation Sony IMX sensors exhibit the same optical response. The relative transmittance for monochrome and color sensors is shown in Fig.25...
  • Page 45 Itala | INSTRUCTION MANUAL 1 000 Wavelength [nm] Figure 25: 1st gen Sony IMX monochrome sensors. Green Green Blue 1 000 Wavelength [nm] Figure 26: 1st gen Sony IMX color sensors. v1.12 - eng...
  • Page 46 Itala | INSTRUCTION MANUAL 1 000 Wavelength [nm] Figure 27: 2nd gen Sony IMX monochrome sensors. Green Green Blue 1 000 Wavelength [nm] Figure 28: 2nd gen Sony IMX color sensors. v1.12 - eng...
  • Page 47 Itala | INSTRUCTION MANUAL 1 000 Wavelength [nm] Figure 29: 4th gen Sony IMX monochrome sensors. Green Green Blue 1 000 Wavelength [nm] Figure 30: 4th gen Sony IMX color sensors. v1.12 - eng...
  • Page 48: Optical Filters

    Itala | INSTRUCTION MANUAL 900 1 000 1 100 1 200 1 300 1 400 1 500 1 600 1 700 1 800 Wavelength [nm] Figure 31: Sony IMX990 SenSWIR™ monochrome sensor. 5.4 Optical filters The following figures show the transmittance characteristics of the available optical filters for the Itala camera series.
  • Page 49: Mechanical Specifications

    Itala | INSTRUCTION MANUAL IR cut filter transmittance 1 000 1 050 1 100 Wavelength [nm] 5.5 Mechanical specifications 5.5.1 Dimensional drawings Here are shown the dimensional drawings for all the camera models. The TYPE 1 drawings refers to all the cameras up to the 12Mp image sensor. These are equipped with a standard C mount (1 inch diameter, 32 threads per inch), with a flange distance of 17.526...
  • Page 50: Gige Vision Mechanical Requirements

    Itala | INSTRUCTION MANUAL TYPE 2 dimensional drawings 5.5.2 GigE Vision mechanical requirements Itala cameras comply with GigE Vision mechanical requirements. In particular, the standard adopted is the one defined as TYPE090 in the GigE Vision Mechanical Supplement. v1.12 - eng...
  • Page 51: Sensor Centering Data

    Itala | INSTRUCTION MANUAL 5.5.3 Sensor centering data All cameras are tested after assembly to make sure the sensor is correctly centered. Measure- ments are taken in all six degrees of freedom relative to the lens mount to ensure optimal imaging performance.
  • Page 52: Connectors And Pinout

    The pinout is not fixed and depends on the camera model (standard or with liquid lens controller). Refer to Table to see the pinout for both the camera models. NOTE: If a CBGPIO001 cable is used, check Opto Engineering® website to get the "color vs func- tion" association. v1.12 - eng...
  • Page 53: I/O Circuitry

    Opto REF V+ Opto IN 1 Opto IN 1 Opto OUT 1 Lens +3.3V Table 12: Itala pinout for both standard and liquid lens Figure 33: 12 pin circular connec- controller version. tor pinout (camera front view) 5.7 I/O circuitry All input and output pins of the I/O connector are galvanically isolated.
  • Page 54: Opto Isolated Output

    5.8 LED and indicators Itala is equipped with a LED indicator on the back side of the camera, next to the connectors. This indicator shows the current status of the camera. The color codes are listed in Table 13.
  • Page 55 Itala | INSTRUCTION MANUAL Color Camera status White Blue Camera is configuring (after a FW update) Purple Camera in boot mode Cyan Camera is updating flashing Yellow Camera is ready Green Camera is triggered Error Table 13: LED colors vs status of the camera...
  • Page 56: Camera Features

    Itala | INSTRUCTION MANUAL 6 CAMERA FEATURES This chapter provides a summary of the standard and custom features of the Itala camera se- ries. Features are defined following the Standard Feature Naming Convention (SFNC) and GenICam nomenclature. The following sections provide more detailed explanation of each feature.
  • Page 57 Itala | INSTRUCTION MANUAL DeviceLinkThroughputLimitMode Controls if the IEnumeration DeviceLinkThroughputLimit is active DeviceLinkThroughputLimit Limits the maximum bandwidth IInteger of the data that will be streamed out by the device on the selected Link DeviceLinkHeartbeatMode Activate or deactivate the Link’s IEnumeration...
  • Page 58: Bandwidth Limit

    Itala | INSTRUCTION MANUAL 6.1.1 Bandwidth limit The DeviceLinkThroughputLimit feature allows to limit the bandwidth available for the camera data streaming. Delays will be uniformly inserted between transport layer packets in order to con- trol the peak bandwidth. This is equivalent to directly set the inter-packet delay value through the GevSCPD feature in the Transport Layer Control section.
  • Page 59 Itala | INSTRUCTION MANUAL Width Width of the image provided by IInteger the device (in pixels) Height Height of the image provided by IInteger the device (in pixels) OffsetX Horizontal offset from the origin IInteger to the region of interest (in...
  • Page 60: Image Roi

    Itala | INSTRUCTION MANUAL TestPattern Selects the type of test pattern IEnumeration that is generated by the device as image source Table 15: Image control features 6.2.1 Image ROI The Width, Height, OffsetX, OffsetY parameters are used to change the image format and to...
  • Page 61: Decimation

    Itala | INSTRUCTION MANUAL Figure 37: Examples of binning: in the figure above a 2x1 binning is performed, while in the figure below a 2x2 bin- ning is applied. Figure 38: Examples of binning for color sensors: in the fig- ure above a 2x1 binning is performed.
  • Page 62: Readout Direction

    Itala | INSTRUCTION MANUAL Figure 39: Examples of decimation: in the figure above a 2x1 decimation is per- formed, while in the figure below a 4x1 decimation is applied. Figure 40: Examples of decimation for color sensors: in the figure above a 2x1 decimation is performed.
  • Page 63: Test Pattern

    Figure 41: Representation of all the four possible readout modes. 6.2.5 Test pattern Itala cameras support two different test patterns, one monochrome and one color. The two different test patterns are represented in Fig. and 43. Figure 42: Monochrome test pattern...
  • Page 64: Acquisition Control

    Itala | INSTRUCTION MANUAL • a fixed blue gradient pattern, from black to blue; • a fixed color bars pattern (all the possible combinations of R, G and B coordinates). 6.3 Acquisition Control The Acquisition Control section describes all features related to image acquisition, including the trigger and exposure control.
  • Page 65 Itala | INSTRUCTION MANUAL TriggerMode Controls if the selected trigger IEnumeration is active TriggerSoftware Generates an internal trigger ICommand TriggerSource Specifies the internal signal or IEnumeration physical input Line to use as the trigger source TriggerOverlap Specifies the type trigger...
  • Page 66: Trigger Overlap

    Itala | INSTRUCTION MANUAL Table 16: Acquisition Control Features 6.3.1 Trigger overlap Exposure Time and Frame Readout relationship By default, the feature TriggerOverlap is set to OFF: in this case, as shown in Fig.44, the following exposure time period is not allowed until the end of the current frame transfer, i.e. exposure time and frame transfer cannot be overlapped.
  • Page 67: Dual Exposure

    Itala | INSTRUCTION MANUAL Figure 45: When TriggerOverlap is set to Readout, the fol- lowing exposure time can be accepted when the current frame is being transfered to the internal memory, but the latency is affected by a higher uncertainty. From top to bot- tom, the sensor exposure and readout signals are depicted.
  • Page 68 Itala | INSTRUCTION MANUAL Dual Exposure is only available when a valid TriggerSource is set. The trigger starts the process explained below: • The first exposure time EXPOSURE TIME 1 follows ExposureMode settings: its duration can be Timed or TriggerWidth, as explained in subsection 6.3.4.
  • Page 69: Trigger Delay

    In case of bad alignment, not all the light is collected by sensor (see Figure 47), leading to an inefficient illumination. The TriggerDelay feature can be used to shift the exposure time of Itala cameras in order to fully cover the illuminator on-time (see Figure 48).
  • Page 70: Timed Vs Triggerwidth Exposure Mode

    Itala | INSTRUCTION MANUAL Figure 48: Correct alignment between illumination and camera expo- sure time. From top to bottom, the triggering signal, the illumination period and the camera exposure time are depicted. 6.3.4 Timed vs TriggerWidth Exposure Mode Exposure mode can be either Timed or TriggerWidth.
  • Page 71: Analog Control

    Itala | INSTRUCTION MANUAL In general, the exposure offset depends on the image sensor and it’s in the order of units/tens of microseconds. NOTE: When TriggerWidth Exposure is selected, the ExposureTime field acts as the maximum allowed pulse width. Providing a trigger signal with a larger pulse width results in a captured frame with an exposure time clamped to the ExposureTime field.
  • Page 72: Gain

    Itala | INSTRUCTION MANUAL Table 17: Analog Control Features 6.4.1 Gain Gain is a multiplying factor applied to pixel values in order to increase the image brightness also in low-light conditions. Sensor gain, however, affects indiscriminately useful signal and undesired noise: as can be seen in Fig.49, image brightness increases proportionally to the gain, however image quality can decrease...
  • Page 73 (right figure): the three channels are equalized and show the same mean grey level. Itala cameras offer the possibility to automatically balance the three color coordinates: in order to do this, the BalanceWhiteAuto feature must be enabled. The BalanceWhiteAuto algorithms relies on the grey world approximation: the premise behind this assumption is that in a well balanced color image the average of all the color present is a neutral grey.
  • Page 74: Gamma Correction

    Itala | INSTRUCTION MANUAL • The camera is now balanced and ready to be used. An example of auto white balance procedure is shown in Fig.51: on the left side an uncorrected image is displayed; on the right side a white balance corrected picture is shown.
  • Page 75: Black Level

    Itala | INSTRUCTION MANUAL bright features, depending on value. γ Fig.53 is shown an example of application of gamma correction. expands the range of values of dark regions and compresses the bright ones, so it’s useful γ < 1 when looking at features in dark parts of the image. Viceversa, a compresses the range of γ...
  • Page 76: Oe Auto Functions Control

    Itala | INSTRUCTION MANUAL 6.5 OE Auto Functions Control This sections includes all the features related to auto exposure and auto gain control. Feature Description Interface Access oeAutoTargetBrightness Desired brightness level (in %) of IInteger the image used by auto gain and...
  • Page 77 Itala | INSTRUCTION MANUAL grey levels time Figure 55: Evolution of the average grey level value over time when autoexposure is active. In order to avoid the continuously adjustment of the exposure time, a certain threshold can be set with the oeAutoConfidence feature: in this way the algorithm becomes more insensitive to little external light fluctuations and becomes active only in case of a consistent grey level variations (see...
  • Page 78: Lut Control

    Itala | INSTRUCTION MANUAL grey grey levels levels time time Figure 57: In case of low damping factor (figure on the left) the algorithm has a fast re- sponse but oscillations may rise; in case of high damping factor(figure on the right) the algorithm is stable but it can require long time to converge.
  • Page 79: Lut

    Please note that the LUT can’t be used if the Gamma feature is enabled (see section 6.4.3). For more information about the LUT wizard of Itala View refer to section 4.7.4. v1.12 - eng...
  • Page 80: Color Transformation Control

    Itala | INSTRUCTION MANUAL Figure 60: On the left no LUT is applied, on the right a binary thresholding is adopted. 6.7 Color transformation control The Color Transformation section describes all features related to color transformations in the device. Feature...
  • Page 81: How To Perform A Correct Color Calibration

    For the proper adjustment of the CCM coefficients refer to section 4.7.6. 6.7.2 How to perform a correct color calibration In order to perform a correct color calibration with Itala cameras, Itala View can be used and the following steps can be performed: 1.
  • Page 82 Itala | INSTRUCTION MANUAL Figure 61: First steps of the color calibration procedure: setting of a proper ROI (including only the greyscale tiles of the color checker) and displaying the results on the horizontal line profiler. v1.12 - eng...
  • Page 83 Itala | INSTRUCTION MANUAL Figure 62: Second step of the color calibration procedure: Exposure Time and Gamma adjustment so that the green channel matches the value imposed by the color checker. v1.12 - eng...
  • Page 84 Itala | INSTRUCTION MANUAL Figure 63: Third step of the color calibration procedure: using the BalanceRatio feature, adjust the red and blue channels in order to have all the three color curves superimposed in the horizontal line profile tab. v1.12 - eng...
  • Page 85 Itala | INSTRUCTION MANUAL Figure 64: Fourth step of the color calibration procedure: using the Color Cor- rection Wizard of Itala View, perform the color calibration following the tips of the wizard. v1.12 - eng...
  • Page 86 Itala | INSTRUCTION MANUAL Figure 65: Color checker after Color Calibration procedure. v1.12 - eng...
  • Page 87: Digital I/O Control

    Itala | INSTRUCTION MANUAL 6.8 Digital I/O Control The Digital I/O chapter covers the features required to control the general Input and Output signals of the device. These include input and output control signals for triggering timers, counters and also static signals such as user configurable input or output bits.
  • Page 88: I/O Stage

    Itala | INSTRUCTION MANUAL UserOutputValue Sets the value of the bit selected IBoolean by UserOutputSelector UserOutputValueAll Sets the value of all the bits of IInteger the User Output register UserOutputValueAllMask Sets the write mask to apply to IInteger the value specified by...
  • Page 89: Counter And Timer Control

    Itala | INSTRUCTION MANUAL period of oeDebounceAmount must pass before choosing if the input signal is spurious or not. The output synchronization signal can be chosen between an internally generated pulse which as- serts when conditions are met (e.g. TimerEnd, CounterEnd, EncoderOut, ...) and a dedicated pulse generator: the advantage of using the second approach relies in the possibility of choosing the duration of the pulse, while in the first case the generated signals may last only one clock period...
  • Page 90: Encoder Control

    Itala | INSTRUCTION MANUAL TimerReset Does a software reset of the ICommand selected timer and starts it Table 22: Counter and Timer Control Features 6.10 Encoder Control This section lists all features for the control and the monitoring of quadrature encoders.
  • Page 91: Encoder Interface

    Itala | INSTRUCTION MANUAL 6.10.1 Encoder interface Itala can be used to monitor incremental encoders. A-B pins of quadrature encoders can be connected to the opto-isolated input pins of Itala cameras. The electrical specifications are listed in Table and Table 5.1.
  • Page 92: Encodervalue Wrapping Management

    Itala | INSTRUCTION MANUAL • 4-phase mode: encoder counter is updated (incremented or decremented) for every full cycle (i.e. for every sequence 00 - 10 - 11 - 01) Encoder A Encoder B High resolution 3 4 5 6 7...
  • Page 93: Logic Block Control

    Itala | INSTRUCTION MANUAL Moving backward Moving forward Encoder Value 65535 65534 15001 15000 15001 15002 19998 19999 Encoder Output Figure 69: Example of spurious pulse generation: first, reverse motion is applied so that En- coderValue indicator goes lower than EncoderDivider. Then, when forward motion is re- stored, a spurious pulse is generated when EncoderValue equals EncoderDivider 6.11 Logic Block Control...
  • Page 94: Logic Block Module

    Itala | INSTRUCTION MANUAL LogicBlockLUTValueAll Sets the values of all the output IInteger bits of the selected LUT in one access ignoring LogicBlockLUTIndex Table 24: Logic Block Control Features 6.11.1 Logic block module LOGIC BLOCK INPUT A OUTPUT INPUT B Figure 70: Simplified scheme of the logic block cell.
  • Page 95: Action Control

    The Itala camera support one action command, so the user can configure an ActionDeviceKey, an ActionGroupKey and an ActionGroupMask. The camera checks that the command information...
  • Page 96: Scheduled Action Command

    Itala | INSTRUCTION MANUAL matches the configured action command and then generates the trigger. Commands can be sent in unicast or broadcast mode, depending on whether one or more devices should be triggered. To improve the synchronism of the trigger on camera the Scheduled Action Commands must be used (6.12.2).
  • Page 97: Event Control

    Itala | INSTRUCTION MANUAL CAMERA Action Command Control action new scheduled command action filter action time queue Exposure Control Sensor Figure 71: Scheduled Action Command block diagram. 6.13 Event Control This section describes how to control the generation of events to the host application. An Event is a message that is sent to the host application to notify it of the occurrence of an internal event.
  • Page 98 Itala | INSTRUCTION MANUAL EventNotification Activate or deactivate the IEnumeration notification to the host application of the occurrence of the selected Event EventExposureEndData Category which contains all the ICategory attibutes related to the ExposureEnd event EventFrameTriggerMissedData Category which contains all the...
  • Page 99: User Set Control

    Itala | INSTRUCTION MANUAL EventFrameTriggerMissed- Returns the unique Identifier of IInteger FrameID the Frame (or image) that generated the Frame Trigger Missed Event Table 29: Event Frame Trigger Missed Data features Feature Description Interface Access EventLine0RisingEdge Returns the unique Identifier of...
  • Page 100: Chunk Data Control

    Itala | INSTRUCTION MANUAL Feature Description Interface Access UserSetSelector Selects the feature User Set to IInteger load, save or configure UserSetLoad Loads the User Set specified by ICommand UserSetSelector to the device and makes it active UserSetSave Save the User Set specified by...
  • Page 101: Oe Serial Interface Control

    Itala | INSTRUCTION MANUAL ChunkGain Returns the gain used to capture IFloat the image ChunkBlackLevel Returns the black level used to IFloat capture the image included in the payload ChunkTimestamp Returns the Timestamp of the IInteger image included in the payload at...
  • Page 102: Serial Interface

    Itala | INSTRUCTION MANUAL oeSerialASCIIRead Read the serial input buffer ICommand oeSerialModbusSlaveID Modbus Slave ID of target device IInteger oeSerialModbusAddress Slave Register Address for IInteger read/write requests oeSerialModbusWriteValue Value to write in Slave Register IInteger Address oeSerialModbusWrite Send a "Write Single Register"...
  • Page 103 Itala | INSTRUCTION MANUAL RS232 MODE PIN 8 EXTERNAL PIN 9 FPGA DEVICE PIN 1 RS485 MODE PIN 8 PIN 9 EXTERNAL FPGA DEVICE PIN 1 Figure 72: Equivalent circuit of the serial interface in RS232 and RS485 mode of operation.
  • Page 104: Oe Liquid Lens Control

    Table 35: OE Liquid Lens Control Features 6.17.1 Liquid Lens interface The liquid lens interface allows to control an Opto Engineering® product with liquid lens tech- nology directly from the camera device. This ensure maximum integration with the camera SDK and compatibility with third party software thanks to GigE Vision and GenTL standards.
  • Page 105: Oe Defective Pixel Correction Control

    Itala | INSTRUCTION MANUAL This mode is automatically selected when a compatible lens is connected. In manual mode is possible to control a lens without an embedded EEPROM, directly setting the current of the actuation coil. In this case the user is responsible to set the correct values and to not exceed the limits reported in the lens specifications.
  • Page 106 Itala | INSTRUCTION MANUAL table. NOTE: The automatic procedure for the pixels defects detection and correction is explained in section 4.7.5. Here there is the explanation of the single defective pixel correction only. oeDefectivePixelCount is the indicator of the actual defective pixels corrected in camera.
  • Page 107: Test Control

    Itala | INSTRUCTION MANUAL 1 2 3 4 5 6 7 1 2 3 4 5 6 7 Figure 74: (On the left) Presence of a dead pixel at coordinates (4,2). (On the right) Error correction through the nearest neighbor (but with the same chroma info) algorithm.
  • Page 108 Itala | INSTRUCTION MANUAL PtpOffsetFromMaster Returns the latched offset from IInteger the PTP master clock in nanoseconds PtpClockID Returns the latched clock ID of IInteger the PTP device PtpParentClockID Returns the latched parent clock IInteger ID of the PTP device...
  • Page 109 Itala | INSTRUCTION MANUAL GevDiscoveryAckDelay Indicates the maximum IInteger randomized delay the device will wait to acknowledge a discovery command GevMCPHostPort Controls the port to which the IInteger device must send messages GevMCDA Controls the destination IP IInteger address for the message channel...
  • Page 110: Precision Time Protocol (Ptp)

    This protocol is closely described in the IEEE standard document. NOTE: Itala cameras can become only slave (master mode is not implemented). The PTP feature must be enabled if the scheduled action commands are used (6.12.2).
  • Page 111: Sequencer Overview

    Itala | INSTRUCTION MANUAL SequencerSetSelector Selects the sequencer set to IInteger which further feature settings applies SequencerSetSave Saves the current device state to ICommand the sequencer set selected by the SequencerSetSelector SequencerSetLoad Loads the sequencer set selected ICommand by SequencerSetSelector in the...
  • Page 112 A proper ROI must be pre-configured Gain oeLiquidLensCurrent oeLiquidLensMode must be set in CurrentMode oeLiquidLensPower oeLiquidLensMode must be set in PowerMode Table 40: Available features for Sequencer Control operations SequencerTriggerSource values supported by Itala cameras are: Feature Note v1.12 - eng...
  • Page 113 Itala | INSTRUCTION MANUAL Disables the sequencer trigger ExposureEnd Starts with the reception of the ExposureEnd Counter0End Starts with the reception of the Counter0End Timer0End Starts with the reception of the Timer0End Encoder0 Starts with the reception of the Encoder output signal Table 41: Available trigger sources for Sequencer Control operations NOTE: Configured sequencer programs are stored as part of the UserSets like any other feature.
  • Page 114: Use Cases

    Figure 75: Figure above: camera is triggered by an opto-isolated external device. Figure below: camera is triggered by a logic output pin. When Itala camera is triggered by an external opto-isolated device, the input pin of the camera can be directly wired to the source output pin of the triggering device.
  • Page 115: Synchronizing An External Device With Itala Cameras

    30V. When Itala camera is triggered by an external logic pin (e.g. TTL), the output pin can still be wired to the opto-isolated input pin of the camera: in this case the logic output pin must be capable of triggering the opto-isolated input stage, i.e.
  • Page 116 Itala | INSTRUCTION MANUAL CAMERA (OPTO-ISOLATED OUTPUT) EXTERNAL DEVICE pin 10 (OPTO-ISOLATED INPUT) opto_ref_v+ pin 6 opto_out 0 CAMERA EXTERNAL DEVICE (OPTO-ISOLATED OUTPUT) (LOGICAL INPUT) pin 10 opto_ref_v+ pin 6 logic_in opto_out 0 Figure 76: Figure above: camera triggers an opto-isolated external device. Figure below: camera triggers a logic input pin.
  • Page 117: How To Add A Delay On The Output Lines Of The Camera

    7.2 How to add a delay on the Output Lines of the camera In this section is shown how to add a user defined delay for Itala output lines. For example, let’s consider to generate an output pulse on Line2, whose duration is equal to and delayed by , and triggered by the Exposure End feature.
  • Page 118 Itala | INSTRUCTION MANUAL Figure 78: Implementation of an output delayed pulse using Itala View v1.12 - eng...
  • Page 119: Streaming Bandwidth Management

    Itala | INSTRUCTION MANUAL 7.3 Streaming bandwidth management Itala has the possibility to select (and to adjust) the overall acquisition frame rate from the image sensor: in particular, the GenICam custom feature involved in the sensor throughput settings is oeAcquisitionFrameRateLimitMode.
  • Page 120 Fig 81. When this condition is met, a lagging effect can arise during the visualization of the captured frames. This scenario is almost always present when Itala is in free-run acquisition mode and oeAcquisition- FrameRateLimitMode is set to oeSensorThroughput.
  • Page 121 BayerRG12Packed YUV422 RGB8 Table 42: Recap of the Bit per Pixel value for each pixel format supported by Itala cameras The following example will show a rough computation of a maximum burst size estimation without buffer saturation. NOTE: In the following example the worst case scenario is considered, in which the download of the frames to the host application starts after the end of the burst acquisition.
  • Page 122 Itala | INSTRUCTION MANUAL NOTE: In the following example a buffer size equal to 384 Mb is considered (i.e. 3072 Mbit). Actual buffer size can be found in Section 5.1. Considering a 12Mpixel image sensor and a pixel format set to Mono8, the maximum number of...
  • Page 123: Cognex Vision Pro Compatibility

    Itala | INSTRUCTION MANUAL 7.4 Cognex Vision Pro compatibility This is a small technical guide to briefly explain how to setup Cognex Vision Pro with Itala. Please follow these steps: 1. Connect the camera.. 2. Ensure IPv4 configuration and camera IP mode is correct.
  • Page 124 Itala | INSTRUCTION MANUAL 5. Open VisionPro QuickBuild. Figure 84: STEP 5 - VisionPro QuickBuild window. v1.12 - eng...
  • Page 125 Itala | INSTRUCTION MANUAL 6. Double click on Image Source. 7. Two windows will open up. On the Image Source window, click on the Camera button. Figure 85: STEP 7 - Image Source window. v1.12 - eng...
  • Page 126 Itala | INSTRUCTION MANUAL 8. From the combo box select the entry that starts with GigEVision. Figure 86: STEP 8 - Image Source window, Image Acquisition Device selection. v1.12 - eng...
  • Page 127 Itala | INSTRUCTION MANUAL 9. Click on the descending arrow on the Video Formats field and select the desired pixel format. Figure 87: STEP 9 - Image Source window, Video Formats selection. v1.12 - eng...
  • Page 128 Itala | INSTRUCTION MANUAL 10. Click on Initialize Acquisition. Figure 88: STEP 10 - Image Source window, Initialize Acquisition. v1.12 - eng...
  • Page 129 Itala | INSTRUCTION MANUAL 11. For a live preview click on the camera icon on the top left corner of the window. It is possible to set also the exposure time, trigger mode and other settings such as ROIs. Figure 89: STEP 11 - Image Source window, Live Preview.
  • Page 130: Sequencer Control Configuration Example

    Itala | INSTRUCTION MANUAL 7.5 Sequencer Control configuration example In this example, we define an acquisition sequence with four different exposure times on the de- vice, in which the last step is repeated five times. All configuration is done on the device itself, so after configuration is complete and acquisition is started, the device itself will apply the parameter changes if necessary.
  • Page 131 Itala | INSTRUCTION MANUAL Additional settings: • TimerDuration (Timer 0) = 2000000µs • oeLiquidLensMode = Power Mode This will result in the following flow diagram: Figure 91: Sequencer Control paths example flow diagram. v1.12 - eng...
  • Page 132: Troubleshooting

    Itala | INSTRUCTION MANUAL 8 TROUBLESHOOTING 8.1 The camera cannot be found in the available device list When the camera is not detected and it’s not available in the device list, check the following steps: 1. Check that the camera is correctly powered. When the camera is turned on, the status LED becomes yellow after few seconds.
  • Page 133 Itala | INSTRUCTION MANUAL 1. Check the the GigE Vision capture driver is correctly installed. 2. Check the network interface drivers are currently up to date. 3. Check that the jumbo packet option of the network interface card is enabled.
  • Page 134 www.opto-e.com...

Table of Contents