Table of Contents

Advertisement

Quick Links

Basler aviator
USER'S MANUAL FOR GigE CAMERAS
Document Number: AW000976
Version: 03
Language: 000 (English)
Release Date: 23 October 2013

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for Basler GigE CAMERAS

  • Page 1 Basler aviator USER’S MANUAL FOR GigE CAMERAS Document Number: AW000976 Version: 03 Language: 000 (English) Release Date: 23 October 2013...
  • Page 2 Basler customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Basler for any damages resulting from such improper use or sale. Warranty Note Do not open the housing of the camera.
  • Page 3 Contacting Basler Support Worldwide Europe: Basler AG An der Strusbek 60 - 62 22926 Ahrensburg Germany Tel.: +49 4102 463 515 Fax.: +49 4102 463 599 support.europe@baslerweb.com Americas: Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA 19341 U.S.A. Tel.: +1 610 280 0171 Fax.: +1 610 280 7608...
  • Page 5: Table Of Contents

    The Basler pylon Camera Software Suite........
  • Page 6 Signal ............72 Basler aviator GigE...
  • Page 7 Maximum Allowed Frame Rate......... . . 98 7.9.1 Using Basler pylon to Check the Maximum Allowed Frame Rate ..99 7.9.2 Increasing the Maximum Allowed Frame Rate .
  • Page 8 10.7.7 Gray Value Adjustment Damping ....... . . 184 Basler aviator GigE...
  • Page 9 11.5 Trigger Input Counter ..........270 Basler aviator GigE...
  • Page 10 12.2 Obtaining an RMA Number ..........279 12.3 Before Contacting Basler Technical Support ....... 279 The Basler Filter Driver.
  • Page 11: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. Models The current Basler aviator GigE camera models are listed in the top row of the specification table on the next pages of this manual. The camera models are differentiated by sensor size and by whether the camera’s sensor is mono or color.
  • Page 12: General Specifications

    40.7 mm x 62.0 mm x 62.0 mm (without lens adapter or connectors) (L x W x H) 56.3 mm x 62.0 mm x 62.0 mm (with lens adapter and connectors) Weight ~ 300 g (typical) Conformity CE, FCC, IP30, RoHS, GenICam, GigE Vision Table 1: General Specifications Basler aviator GigE...
  • Page 13 Specifications, Requirements, and Precautions Specification avA1000-100gm avA1000-100gc avA1600-50gm avA1600-50gc Software / Driver Driver: Basler pylon SDK including filter and performance drivers Operating System: Windows or Linux - 32 bit or 64 bit Conformity GigE Vision, GenICam Table 1: General Specifications Basler aviator GigE...
  • Page 14 ~ 300 g (typical) Conformity CE, FCC, IP30, RoHS, GenICam, GigE Vision Software / Driver Driver: Basler pylon SDK including filter and performance drivers Operating System: Windows or Linux - 32 bit or 64 bit Conformity GigE Vision, GenICam Table 2: General Specifications...
  • Page 15: Spectral Response

    Specifications, Requirements, and Precautions Spectral Response 1.3.1 Monochrome Cameras The following graph shows the spectral response for all monochrome cameras. The spectral response curve excludes lens characteristics and light source characteristics. Wave Length (nm) Fig. 1: Mono Camera Spectral Response Basler aviator GigE...
  • Page 16: Color Cameras

    640 ... 660 nm to 1100 nm. A suitable IR cut filter is included in the standard C-mount lens adapter on color models of the camera. Blue Green Wave Length (nm) Fig. 2: Color Camera Spectral Response Basler aviator GigE...
  • Page 17: Mechanical Specifications

    The camera’s dimensions in millimeters are as shown in the drawings in Figure 3 on page Camera housings are equipped with four mounting holes on the front and two mounting holes on each side as shown in the drawings. Basler aviator GigE...
  • Page 18 Specifications, Requirements, and Precautions AW00097603000 (56.3) 12.4 40.7 Photosensitive surface of the 15.8 sensor 8 x M4; 6.5 deep 17.95 17.5 7.95 ±0.2 = Reference plane ±0.1 4x M4; 6.5 deep Fig. 3: Mechanical Dimensions (in mm) Basler aviator GigE...
  • Page 19: Sensor Positioning Accuracy

    (This is the sensor tilt tolerance. It applies to every point on the photosensitive surface and is relative to the center of the die.) ± 0.025 = Reference plane Photosensitive surface of the sensor 17.5 Fig. 4: Sensor Positioning Accuracy (in mm unless otherwise noted) Basler aviator GigE...
  • Page 20: Maximum Lens Thread Length On Color Cameras

    C-mount color cameras that do not include an internal IR cut filter are available on request. Monochrome cameras are not normally equipped with an internal IR cut filter, however, they can be equipped with an internal filter on request. Basler aviator GigE...
  • Page 21: Software Licensing Information

    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Basler aviator GigE...
  • Page 22: Lz4 Licensing

    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Basler aviator GigE...
  • Page 23: Avoiding Emi And Esd Problems

    Control the humidity in your environment. Low humidity can cause ESD problems.  The Basler application note called Avoiding EMI and ESD in Basler Camera Installations provides much more detail about avoiding EMI and ESD. This application note can be obtained from the Downloads section of our website: www.baslerweb.com...
  • Page 24: Environmental Requirements

    You must provide sufficient heat dissipation to maintain the temperature of the camera housing at 50 °C or less. Since each installation is unique, Basler does not supply a strictly required technique for proper heat dissipation. Instead, we provide the following general guidelines: In all cases, you should monitor the temperature of the camera housing and make sure that the ...
  • Page 25: Precautions

    An incorrect plug can damage the camera’s 12-pin connector. The plug on the cable that you attach to the camera’s 12-pin connector must have 12 female pins. Using a plug designed for a smaller or a larger number of pins can damage the connector. Basler aviator GigE...
  • Page 26 3. The code snippets in this manual are written in C++. Other programming languages can also be used to write code for use with Basler pylon. When writing code, you should use a programming language that is both compatible with pylon and appropriate for your application.
  • Page 27 Do not use solvents or thinners to clean the housing; they can damage the surface finish. Read the manual Read the manual carefully before using the camera! Basler aviator GigE...
  • Page 28 Specifications, Requirements, and Precautions AW00097603000 Basler aviator GigE...
  • Page 29: Installation

    More extensive information about how to perform complicated installations is included in the Installation and Setup Guide for Cameras Used with Basler’s pylon API (AW000611xx000). You can download the Installation and Setup Guide for Cameras Used with Basler’s pylon API from the Downloads section of our website: www.baslerweb.com...
  • Page 30 Installation AW00097603000 Basler aviator GigE...
  • Page 31: Camera Drivers And Tools For Changing Camera Parameters

    The Basler pylon Camera Software Suite The Basler pylon Camera Software Suite is designed to operate all Basler cameras that have an IEEE 1394a interface, an IEEE 1394b interface, a GigE interface, or a USB 3 interface. It will also operate some newer Basler camera models with a Camera Link interface.
  • Page 32: The Basler Pylon Viewer

    The pylon IP Configurator is included in the Basler pylon Camera Software Suite. The pylon IP Configurator is a standalone application that lets you change the IP configuration of the camera via a GUI. The tool will detect all Basler GigE cameras attached to your network and let you make changes to a selected camera.
  • Page 33: Camera Functional Description

    Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
  • Page 34: Four Tap Sensor Digitization Mode

    The image buffer between the sensor and the Ethernet controller allows data to be read out of the sensor at a rate that is independent of the data transmission rate between the camera and the host computer. This ensures that the data transmission rate has no influence on image quality. Basler aviator GigE...
  • Page 35 AW00097603000 Camera Functional Description Tap 1 Tap 2 Sensor Upper Horizontal Shift Register Pixels Vertical Shift Register Lower Horizontal Shift Register Tap 3 Tap 4 Fig. 6: Four Tap Sensor Readout Mode Basler aviator GigE...
  • Page 36 Output Lines Image Image Data Data Sensor Ethernet Ethernet FPGA Controller Network Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 7: Camera Block Diagram - Four Tap Mode Basler aviator GigE...
  • Page 37: One Sensor Tap Digitization Mode

    The image buffer between the sensor and the Ethernet controller allows data to be read out of the sensor at a rate that is independent of the data transmission rate between the camera and the host computer. This ensures that the data transmission rate has no influence on image quality. Basler aviator GigE...
  • Page 38 Camera Functional Description AW00097603000 Tap 1 Sensor Upper Horizontal Shift Register Pixels Vertical Shift Register Fig. 8: One Tap Sensor Readout Mode Basler aviator GigE...
  • Page 39 Output Lines Image Image Data Data Ethernet Ethernet Sensor FPGA Controller Network Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 9: Camera Block Diagram - One Tap Mode Basler aviator GigE...
  • Page 40 Camera Functional Description AW00097603000 Basler aviator GigE...
  • Page 41: Physical Interface

    A 12-pin receptacle used to provide access to the camera’s I/O lines and to provide power to  the camera. Figure 10 shows the location of the two connectors. 12-pin Receptacle 8-pin RJ-45 Jack Green LED Yellow LED Fig. 10: Camera Connectors and LEDs Basler aviator GigE...
  • Page 42: Camera Connector Pin Assignments And Numbering

    1 and 2. 5.2.2 8-Pin RJ-45 Jack The 8-pin RJ-45 jack provides Ethernet access to the camera. Pin assignments adhere to the Ethernet standard. Basler aviator GigE...
  • Page 43: Camera Connector Types

    The 8-pin jack for the camera’s Ethernet connection is a standard RJ-45 connector. The recommended mating connector is any standard 8-pin RJ-45 plug. Cables terminated with screw-lock connectors are available from Basler. Contact your Basler sales representative to order cable assemblies.
  • Page 44: Camera Cabling Requirements

    Close proximity to strong magnetic fields should be avoided. The required 12-pin Hirose plug is available from Basler. Basler also offers a cable assembly that is terminated with a 12-pin Hirose plug on one end and unterminated on the other. Contact your Basler sales representative to order connectors or cables.
  • Page 45 We also recommend that you supply camera power ground through two separate wires between the power supply and the camera as shown in the figure. For more information about applicable voltage levels, see Section 5.7.1 on page Basler aviator GigE...
  • Page 46: Plc Power And I/O Cable

    Close proximity to strong magnetic fields should be avoided. Basler offers PLC power and I/O cables in several lengths. Each cable is terminated with a 12-pin Hirose plug (HR10A-10P-12S) on the end that connects to the camera. The other end is unterminated.
  • Page 47: Camera Power

    Using a plug designed for a smaller or a larger number of pins can damage the connector. Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant. Basler aviator GigE...
  • Page 48: Input Line Description

    Region where the transition threshold occurs; the logical state is not defined in this region. +10.4 VDC > +10.4 VDC The voltage indicates a logical 1. Table 3: Voltage Requirements for the I/O Inputs When Using a PLC I/O Cable Basler aviator GigE...
  • Page 49: Characteristics

    Voltage +0 to 24 I/O In 1 Camera I/O In Gnd Your In 1 Ctrl Fig. 12: Typical Input Circuit (Simplified) For more information about input line pin assignments and pin numbering, see Section 5.2 on page Basler aviator GigE...
  • Page 50: Assigning An Input Line To Receive A Hardware Trigger Signal

    For more information about assigning input line 1 or input line 2 to receive a hardware trigger signal, see Section 6.1 on page Basler aviator GigE...
  • Page 51: Output Line Description

    For example, a logical one on Out 1 Ctrl results in a conducting transiator Q in the Output Line 1 circuit. Figure 13 shows a typical circuit you can use to monitor the output line with a voltage signal. Basler aviator GigE...
  • Page 52 12-Pin Receptacle Your Fig. 14: Typical LED Output Signal (Simplified) For more information about output line pin assignments and pin numbering, see Section 5.2 on page  configuring the output lines, see Section 5.8.4 on page  Basler aviator GigE...
  • Page 53: Response Times

    For more information about assigning a camera output signal to an output line, see Section 6.2 on page Basler aviator GigE...
  • Page 54 Physical Interface AW00097603000 Basler aviator GigE...
  • Page 55: O Control

     feature operates, see Section 11.5 on page 270. For more information about the electrical characteristics of the input lines, see Section 5.7 on page Basler aviator GigE...
  • Page 56: Input Line Debouncers

    Default value: 10 µs Figure 16 illustrates how the debouncer filters out invalid input signals, i.e. signals that are shorter than the debouncer value. The diagram also illustrates how the debouncer delays a valid signal. Basler aviator GigE...
  • Page 57 You can set the Line Selector and the value of the Line Debouncer Abs parameter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: // Select the input line Camera.LineSelector.SetValue( LineSelector_Line1 );...
  • Page 58: Using An Unassigned Input Line To Receive A User Input Signal

    // Enable the inverter on line 1 Camera.LineSelector.SetValue( LineSelector_Line1 ); Camera.LineInverter.SetValue( true ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 59: Configuring Output Lines

     You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: //Set the source signal for output line 1 Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 60 I/O Control AW00097603000 Camera.LineSelector.SetValue( LineSelector_Out3 ); Camera.LineSource.SetValue( LineSource_TimerActive ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page ...
  • Page 61: Setting The State Of A User Settable Output Line

    You can set the Output Selector and the User Output Value parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to designate the output line as user settable and to set the state of the output line: // Set output line 1 to user settable Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 62: Setting An Output Line For Invert

    You can set the Line Selector and the Line Inverter parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: // Enable the inverter on output line 1 Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 63: Working With The Timer Output Signals

    You can set the Trigger Selector and the Timer Trigger Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value for timer 1: Camera.TimerSelector.SetValue( TimerSelector_Timer1 );...
  • Page 64: Setting A Timer Delay Time

    Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDelayRaw.SetValue( 100 ); You can also use the Basler pylon Viewer application to easily set the parameters. Changing the Delay Time Base By default, the Timer Delay Time Base is fixed at 1 µs (minimum value), and the timer delay is normally adjusted by setting the value of the Timer Delay Raw parameter.
  • Page 65 Timer Delay Abs parameter to the nearest achieveable value. You should also be aware that if you change the delay time using the raw settings, the Timer Delay Abs parameter will automatically be updated to reflect the new delay time. Basler aviator GigE...
  • Page 66: Setting The Timer Duration Time

    Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDurationRaw.SetValue( 100 ); You can also use the Basler pylon Viewer application to easily set the parameters. Changing the Duration Time Base By default, the Timer Duration Time Base is fixed at 1 µs, and the timer duration is normally adjusted by setting the value of the Timer Duration Raw parameter.
  • Page 67 Duration Abs parameter will indicate the current duration time setting. You should also be aware that if you change the duration time using the raw settings, the Timer Duration Abs parameter will automatically be updated to reflect the new duration time. Basler aviator GigE...
  • Page 68: Checking The State Of The I/O Lines

    You can set the Line Selector and read the Line Status parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and read the parameter value: // Select output line 1 and read the state Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 69: Image Acquisition Control

    If the Acquisition Mode parameter is set to "continuous frame", an Acquisition Start command does not expire after a single frame is captured. Once an Acquisition Start command has been executed, you can acquire as many frames as you like. The Acquisition Start command will remain in effect Basler aviator GigE...
  • Page 70 If the Trigger Mode parameter for the frame start trigger is set to on, you must trigger frame start by applying frame start trigger signals to the camera. Each time a trigger signal is applied, the camera Basler aviator GigE...
  • Page 71 "waiting for frame start trigger" status Acquisition Frame Count parameter setting = 3 Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 20: Acquisition Start and Frame Start Triggering Basler aviator GigE...
  • Page 72 But in Basler pylon there is a single parameter, the Trigger Mode parameter, that is used to set the mode for both of these triggers. Also, the Trigger Software command mentioned earlier can be executed for either the acquisition start trigger or the frame start trigger.
  • Page 73 You can use the sequencer feature as an alternative to the "trigger width" mode if you require exposure times that are periodically changing from frame to frame. For information on the sequencer feature, see Section 10.10 on page 192. Basler aviator GigE...
  • Page 74: Acquisition Start And Stop Commands And The Acquisition Mode

    "overlapped" exposure. To achieve the maximum possible possible acquisition frame rate, set the camera for the continuous acquisition mode and use "overlapped" exposure. For more information about overlapped exposure, see Section 7.6 on page Basler aviator GigE...
  • Page 75 You can set the Acquisition Mode parameter value and you can execute Acquisition Start or Acquisition Stop commands from within your application software by using the Basler pylon API. The code snippet below illustrates using the API to set the Acquisition Mode parameter value and to execute an Acquisition Start command.
  • Page 76: The Acquisition Start Trigger

    "waiting for acquisition start trigger" acquisition status and enter the "waiting for frame start trigger" acquisition status. The camera can then react to frame start trigger signals and will continue to do so until the number of frame start trigger signals it has received is equal to the current Acquisition Basler aviator GigE...
  • Page 77 Acquisition Mode parameter should be set to continuous. If the Acquisition Mode parameter is set to single frame, only a single frame is acquired regardless of the Acquisition Frame Count parameter setting. For more information about the Acquisition Mode parameter, see Section 7.2 on page Basler aviator GigE...
  • Page 78: Acquisition Frame Count

    "waiting for acquisition start trigger" acquisition status. At that point, you must apply a new acquisition start trigger signal to exit the camera from the "waiting for acquisition start trigger" acquisition status. Basler aviator GigE...
  • Page 79: Setting The Acquisition Start Trigger Mode And Related Parameters

    Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); // Set the acquisition frame count Camera.AcquisitionFrameCount.SetValue( 5 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 80: Using A Software Acquisition Start Trigger Signal

    You can set all of the parameters needed to perform software acquisition start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software acquisition...
  • Page 81 // a Trigger Software command will apply a software acquisition start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 82: Using A Hardware Acquisition Start Trigger

    For more information about setting the camera for hardware acquisition start triggering and selecting the input line to receive the ExASTrig signal, see Section 7.3.5.3. For more information about the electrical requirements for input line 1 and line 2, see Section 5.7 page Basler aviator GigE...
  • Page 83: Acquisition Start Trigger Delay

    You can set all of the parameters needed to perform hardware acquisition start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values required to enable rising edge hardware acquisition start triggering with...
  • Page 84 // trigger, to trigger 5 frame starts, and to retrieve 5 frames here Camera.AcquisitionStop.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 85: The Frame Start Trigger

    For more information about the acquisition start trigger, and about the acquisition status, see Section 7.1 on page 59 and Section 7.3 on page Referring to the use case diagrams that appear in Section 7.6 on page 87 can help you understand the explanations of the frame start trigger. Basler aviator GigE...
  • Page 86: Frame Start Trigger Mode

    When the Trigger Mode parameter for the frame start trigger is set to off, the exposure time for each frame acquisition is determined by the value of the camera’s Exposure Time Abs parameter. For more information about the camera’s Exposure Time Abs parameter, see Section 7.5 on page Basler aviator GigE...
  • Page 87: Frame Start Trigger Mode = On

    Time Abs parameter or it can be controlled by manipulating the hardware trigger signal. For more information about controlling exposure time when using a software trigger, see Section 7.4.2 on page 79  controlling exposure time when using a hardware trigger, see Section 7.4.3 on page  Basler aviator GigE...
  • Page 88: Setting The Frame Start Trigger Mode And Related Parameters

    You can set the Trigger Mode and related parameter values for the frame start trigger from within your application software by using the Basler pylon API. If your settings make it necessary, you can also set the Trigger Source parameter.
  • Page 89: Using A Software Frame Start Trigger Signal

    Section 7.4.2.2 on page 80 includes more detailed information about applying a software frame start trigger signal to the camera using Basler pylon. For more information about determining the maximum allowed frame rate, see Section 7.9 on page Basler aviator GigE...
  • Page 90: Setting The Parameters Related To Software Frame Start Triggering And Applying A Software Trigger Signal

    You can set all of the parameters needed to perform software frame start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software frame start triggering with the camera set for continuous frame acquisition mode.
  • Page 91: Using A Hardware Frame Start Trigger Signal

    ExFSTrig signal, see Section 7.4.3.4 on page the electrical requirements for the input lines, see Section 5.7 on page  over triggering, see Section 7.7.3.2 on page  determining the maximum allowed frame rate, see Section 7.9 on page  Basler aviator GigE...
  • Page 92: Exposure Modes

    Exposure Time Abs parameter) Fig. 23: Overtriggering with Timed Exposure For more information about the Frame Start Overtrigger event, see Section 10.14 on page 242.  the camera’s Exposure Time Abs parameter, see Section 7.5 on page  Basler aviator GigE...
  • Page 93 ExFSTrig signal to vary the exposure time in a range from 3000 μs to 5500 μs. In this case you would set the camera’s Exposure Overlap Time Max Abs parameter to 3000 μs. Basler aviator GigE...
  • Page 94: Frame Start Trigger Delay

    You can set all of the parameters needed to perform hardware frame start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the camera for single frame acquisition mode with the trigger mode for the acquisition start trigger set to off.
  • Page 95 // frame start trigger signal (ExFSTrig signal)goes high // Retrieve the captured frames Camera.AcquisitionStop.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 96: Setting The Exposure Time

    The Exposure Time Abs parameter sets the exposure time in µs. The parameter can be set in increments of 1 µs. You can use the Basler pylon API to set the Exposure Time Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: // Set the exposure time to 3000 µs...
  • Page 97: Overlapping Exposure With Sensor Readout

    ExFSTrig Signal Frame Acquisition N Exposure Readout Frame Acquisition N+1 Exposure Readout Frame Acquisition N+2 Exposure Readout Frame Acquisition N+3 Exposure Readout Time Fig. 26: Overlapped Exposure and Readout Basler aviator GigE...
  • Page 98 You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
  • Page 99 The camera supplies “trigger wait” signals that are specifically designed to let you trigger overlapped exposure safely and efficiently. For more information about the trigger wait signals, see Section 7.7.3 on page Basler aviator GigE...
  • Page 100: Acquisition Monitoring Tools

    3, or output line 4. For more information about changing which camera output signal is assigned to which output line, see Section 6.2 on page For more information about the electrical characteristics of the camera’s output lines, see Section 5.8 on page Basler aviator GigE...
  • Page 101: Acquisition Status Indicator

    If the value is set to "true", the camera is waiting for the trigger signal. You can check the acquisition status from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to check the acquisition status:...
  • Page 102: Trigger Wait Signals

    Figure 28 illustrates the Acquisition Trigger Wait signal with the Acquisition Frame Count parameter set to 3 and with exposure and readout overlapped. The figure assumes that the trigger mode for the frame start trigger is set to off, so the camera is internally generating frame start trigger signals. Basler aviator GigE...
  • Page 103 Frame Acquisition Exp. Readout Time = Camera is in a "waiting for acquisition start trigger" status Fig. 28: Acquisition Trigger Wait Signal The acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled. Basler aviator GigE...
  • Page 104: Frame Trigger Wait Signal

     You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 105  You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 106: Acquisition Timing Chart

    Line Debouncer Time Abs parameter for input line 1 to 15 µs. In this case: Total Start Delay = Start Delay from Table 6 + Debouncer Setting Total Start Delay = 37 µs+ 15 µs Total Start Delay = 52 µs Basler aviator GigE...
  • Page 107 You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
  • Page 108: Maximum Allowed Frame Rate

     website: www.baslerweb.com You can use the Basler pylon API to read the value of the camera’s Resulting Frame Rate Abs  parameter (see the next page). Note that the maximum allowed frame rate decreases if the Image AOI is significantly displaced from the sensor’s center.
  • Page 109: Using Basler Pylon To Check The Maximum Allowed Frame Rate

    Using Basler pylon to Check the Maximum Allowed Frame Rate You can use the Basler pylon API to read the current value of the Resulting Frame Rate Abs parameter from within your application software using the Basler pylon API. The following code...
  • Page 110 Section 7.5 on page  the packet size and inter-packet delay settings and about the settings that determine the  bandwidth assigned to the camera, see Section B.2 on page 302. binning, see Section 10.11 on page 230.  Basler aviator GigE...
  • Page 111: Use Case Descriptions And Diagrams

    The images can then be used for a variety of purposes including vegetation coverage estimates, archaeological site identification, etc. For more information about the Acquisition Frame Rate Abs parameter, see Section 7.3.1.1 on page Basler aviator GigE...
  • Page 112 = frame exposure and readout = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 31: Use Case 1 - Acquisition Start Trigger Off and Frame Start Trigger Off Basler aviator GigE...
  • Page 113 When the electrical signal is received on line 1, it serves as a frame start trigger signal and initiates a frame acquisition. The frame acquired by the camera is forwarded to an image processing system, which will inspect the image and determine if there are any defects in the plywood’s surface. Basler aviator GigE...
  • Page 114 Time Fig. 32: Use Case 2 - Acquisition Start Trigger Off and Frame Start Trigger On Use Case 3 - Acquisition Start Trigger On - Frame Start Trigger Off Use case three is illustrated on page 106. Basler aviator GigE...
  • Page 115 (this avoids the need to store images of an empty toll booth area.) For more information about the Acquisition Frame Rate Abs parameter, see Section 7.3.1.1 on page Basler aviator GigE...
  • Page 116 = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal (applied to line 1) Frame Start Trigger Signal Time Fig. 33: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler aviator GigE...
  • Page 117 (Transmitting images of the "space" between the objects would be a waste of bandwidth and processing them would be a waste of processor resources.) Basler aviator GigE...
  • Page 118 Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Software Command Executed Frame Start Trigger Signal (applied to line 1) Time Fig. 34: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler aviator GigE...
  • Page 119: Color Creation And Enhancement

    "GB" filter alignment). As the figure illustrates, within each square of four pixels, one pixel sees only red light, one sees only blue light, and two pixels see only green light. (This combination mimics the human eye’s sensitivity to color.) Sensor Pixels Fig. 35: Bayer Filter Pattern Basler aviator GigE...
  • Page 120: Bayer Color Filter Alignment

    When a color camera is set for either of these formats, each pixel in the captured image goes through a two step conversion process as it exits the sensor and passes through the camera’s electronics. This process yields Y, U, and V color information for each pixel. Basler aviator GigE...
  • Page 121 Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) For complete details of the Mono 8 format on cameras with a Bayer filter, see Section 9.3.6 on page 147. Basler aviator GigE...
  • Page 122: Integrated Ir Cut Filter (On Color Models)

    If a lens with a very long thread length is used, the IR cut filter will be damaged or destroyed and the camera will no longer operate. Do not use a lens with a thread length greater than 7.5 mm. For more information about the IR cut filter, see Section 1.4.3 on page Basler aviator GigE...
  • Page 123: Color Enhancement Features

    For this reason, we don’t normally recommend setting a balance ratio less than 1 unless you want to correct for the strong predominance of one color. Basler aviator GigE...
  • Page 124 You can set the Balance Ratio Selector and the Balance Ratio Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.BalanceRatioSelector.SetValue( BalanceRatioSelector_Green );...
  • Page 125: Gamma Correction

    You can enable or disable the gamma correction feature by setting the value of the Gamma Enable parameter. You can use the Gamma Selector to select either sRGB or user gamma correction. If you select user gamma correction, you can use the Gamma parameter to set the gamma correction value. Basler aviator GigE...
  • Page 126 You can set the Gamma Enable parameter, use the Gamma Selector, and set Gamma parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values for sRGB type correction: // Enable the Gamma feature Camera.GammaEnable.SetValue( true );...
  • Page 127: Matrix Color Transformation On Color Models

    Tungsten - This setting will automatically populate the matrix with a pre-selected set of values  that will make appropriate corrections for images captured with tungsten lighting that has a color temperature of about 2500K to 3000K. When you select this setting, the camera will also Basler aviator GigE...
  • Page 128 You can set the Processed Raw Enable, Color Transformation Selector and Light Source Selector parameter values from within your application software by using the Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG 8 output, and therefore you must set the Processed Raw Enable parameter value to enabled.
  • Page 129: The Custom Light Source Setting

    ( LightSourceSelector_Daylight6500K ); // Set the matrix correction factor Camera.ColorTransformationMatrixFactor.SetValue( 0.50 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 8.3.3.1...
  • Page 130 // Select a position in the matrix Camera.ColorTransformationValueSelector.SetValue ( ColorTransformationValueSelector_Gain12 ); // Set the value for the selected position as an integer value Camera.ColorTransformationValueRaw.SetValue( 135 ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler aviator GigE...
  • Page 131: Color Adjustment

    122) where the primary colors R, G, B, the secondary colors C, M, Y, and black and white define the corners. All shades of gray are represented by the line connecting the black and the white corner. Basler aviator GigE...
  • Page 132  present. At minimum saturation, no "color" but only some shade of gray (including black and white) is present. White Black Fig. 36: RGB Color Cube With YCM Secondary Colors, Black, and White, Projected On a Plane Basler aviator GigE...
  • Page 133 For example, if saturation for red is increased, the colorfulness of red colors in the image will increase. If red is set to minimum saturation, red will be replaced by gray for "red" colors in the image. Basler aviator GigE...
  • Page 134 Adjustment Saturation Raw parameter values from within your application software by using the Basler pylon API. In this example, we assume that you want to set your camera for Bayer BG8 output, and therefore you must set the Processed Raw Enable parameter value to enabled.
  • Page 135 // Set the cyan saturation as an integer value Camera.ColorAdjustmentSaturationRaw.SetValue( 176 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 136: A Procedure For Setting The Color Enhancements

    Since it makes changing camera parameters quick and easy, we also recommend using the Basler pylon Viewer software when you are making adjustments. 1. Arrange your camera so that it is viewing a scene similar to what it will view during actual oper- ation.
  • Page 137: The "Color" Factory Setup

    For more information about the factory setups and about selecting and loading configuration sets, see Section 10.19 on page 254. Basler aviator GigE...
  • Page 138 Color Creation and Enhancement AW00097603000 Basler aviator GigE...
  • Page 139: Pixel Data Formats

    Table 8: Pixel Formats Available on Color Cameras ( = format available) Details of the monochrome formats are described in Section 9.2 on page 131 and details of the color formats are described in Section 9.3 on page 137. Basler aviator GigE...
  • Page 140 Pixel Data Formats AW00097603000 You can set the Pixel Format parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.PixelFormat.SetValue( PixelFormat_Mono8 ); Camera.PixelFormat.SetValue( PixelFormat_Mono12Packed );...
  • Page 141: Pixel Data Formats For Mono Cameras

    This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE       0x01 0x00 Basler aviator GigE...
  • Page 142: Mono 12 Format

    Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Basler aviator GigE...
  • Page 143 Therefore, the highest data value you will see is 0x0FFF indicating a signal level of 4095. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094       0x0001 0x0000 Basler aviator GigE...
  • Page 144: Mono 12 Packed Format

         bits 11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 bits 11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 Basler aviator GigE...
  • Page 145 “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094       0x0001 0x0000 Basler aviator GigE...
  • Page 146: Yuv 4:2:2 Packed Format

    The order of the pixel data for a received frame in the image buffer in your PC is similar to the order of YUV 4:2:2 (YUYV) Packed output from a color camera. For more information about the YUV 4:2:2 (YUYV) Packed format on color cameras, see Section 9.3.5 on page 145. Basler aviator GigE...
  • Page 147: Pixel Data Output Formats For Color Cameras

    Red value for P Blue value for P Green value for P             Green value for P Red value for P Blue value for P Green value for P Basler aviator GigE...
  • Page 148 The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE       0x01 0x00 Basler aviator GigE...
  • Page 149: Bayer Gb 12 Format

             Low byte of green value for P Low byte of red value for P High byte of green value for P High byte of red value for P Basler aviator GigE...
  • Page 150 Therefore, the highest data value you will see is 0x0FFF indicating a signal level of 4095. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094       0x0001 0x0000 Basler aviator GigE...
  • Page 151: Bayer Gb 12 Packed Format

    Blue value for P bits 11 ... 4 Green value for P bits 11 ... 4 Blue value for P bits 3 ... 0 Green value for P bits 3 ... 0 Blue value for P bits 11 ... 4 Basler aviator GigE...
  • Page 152 “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094       0x0001 0x0000 Basler aviator GigE...
  • Page 153: Yuv 4:2:2 Packed Format

    Y value for P U value for P Y value for P V Value for P Y value for P       U value for P Y value for P V Value for P Basler aviator GigE...
  • Page 154 0x01 -127 0x00 -128 The signal level of a U component or a V component can range from -128 to +127 (decimal). Notice that the data values have been arranged to represent the full signal level range. Basler aviator GigE...
  • Page 155: Yuv 4:2:2 (Yuyv) Packed Format

         Y value for P U value for P Y value for P V value for P Y value for P U value for P Y value for P V value for P Basler aviator GigE...
  • Page 156 0x01 -127 0x00 -128 The signal level of a U component or a V component can range from -128 to +127 (decimal). Notice that the data values have been arranged to represent the full signal level range. Basler aviator GigE...
  • Page 157: Mono 8 Format

    Y value for P Y value for P Y value for P Y value for P       Y value for P Y value for P Y value for P Y value for P Basler aviator GigE...
  • Page 158 This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE       0x01 0x00 Basler aviator GigE...
  • Page 159: Pixel Transmission Sequence

    The columns are numbered 0 through m from the left side to the right side of the sensor The rows are numbered 0 through n from the top to the bottom of the sensor The sequence assumes that the camera is set for full resolution. Basler aviator GigE...
  • Page 160 Pixel Data Formats AW00097603000 Basler aviator GigE...
  • Page 161: Standard Features

    // Set the digitization taps to 1 Camera.SensorDigitizationTaps.SetValue( SensorDigitizationTaps_One ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 162: Gain

    Fig. 38: Gain in dB output by the camera were no higher than 127 (in an 8 bit mode), you could increase the gain to 6 dB (an amplification factor of 2) and thus reach gray values of 254. Basler aviator GigE...
  • Page 163: Gain With Four Tap Sensor Digitization

    Gain on Tap N = ( 0.0359 x Gain All Setting) + (0.0359 x Gain Tap N Setting) Where N is 1, 2, 3, or 4 Basler aviator GigE...
  • Page 164: Setting The Gain

    Gain on Tap 1 = ( 0.0359 x 450) + (0.0359 x 0) = 16.2 dB Setting the Gain When the camera is set to four tap digitization mode, setting the gain with Basler pylon is a several step process: To set the Gain All parameter value: Set the Gain Selector to All.
  • Page 165: Gain With One Tap Sensor Digitization

    Gain All. The minimum, maximum, and adjustment methods for this parameter are similar to those described in the previous section. Basler aviator GigE...
  • Page 166: Black Level

    The sum of the Black Level All plus the Black Level Tap 3 parameter settings must be less than  or equal to 950. The sum of the Black Level All plus the Black Level Tap 4 parameter settings must be less than  or equal to 950. Basler aviator GigE...
  • Page 167: Setting The Black Level

    Setting the Black Level When the camera is set for four tap digitization mode, setting the black level with Basler pylon is a several step process: To set the Black Level All parameter value: Set the Black Level Selector to All.
  • Page 168: Black Level With One Tap Sensor Digitization

    Standard Features AW00097603000 You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 10.3.2 Black Level with One Tap Sensor Digitization As mentioned in the "Camera Functional Description"...
  • Page 169: Remove Parameter Limits

    // Remove the factory limits for the selected parameter (Gain) Camera.RemoveLimits.SetValue( true ); You can also use the Basler pylon Viewer application to easily set the parameters. Note that the remove parameter limits feature will only be available at the "guru" viewing level.
  • Page 170: Digital Shift

    1. If you do nonetheless, all bits output from the camera will automatically be set to 1. Therefore, you should only use the shift by 1 setting when your pixel readings with a 12 bit pixel format selected and with digital shift disabled are all less than 2048. Basler aviator GigE...
  • Page 171 0 from each ADC along with 4 "0" "0" "0" "0" zeros as LSBs. The result of shifting 4 times is that the output of the camera is effectively multiplied by 16. Shifted Four Times Basler aviator GigE...
  • Page 172: Digital Shift With 8 Bit Pixel Formats

    1. If you do nonetheless, all bits output from the camera will automatically be set to 1. Therefore, you should only use the shift by 1 setting when your pixel readings with an 8 bit pixel format selected and with digital shift disabled are all less than 128. Basler aviator GigE...
  • Page 173 1. Therefore, you should only use the shift by 4 setting when your pixel readings with an 8 bit pixel format selected and with digital shift disabled are all less than 16. Basler aviator GigE...
  • Page 174: Precautions When Using Digital Shift

    If all of the readings are below 32, you can safely use the shift by 1, 2, or 3 settings.  If all of the readings are below 16, you can safely use the shift by 1, 2, 3, or 4 settings.  Basler aviator GigE...
  • Page 175: Enabling And Setting Digital Shift

    Camera.DigitalShift.SetValue( 0 ); // Enable digital shift by 2 Camera.DigitalShift.SetValue( 2 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 176: Image Area Of Interest (Aoi)

    The AOI feature also includes Center X and a Center Y capabilities. When Center X is enabled, the camera will automatically center the AOI along the sensor’s X axis (and will disable the Offset X Basler aviator GigE...
  • Page 177: Setting The Image Aoi

    Vertical Binning Vertical Binning Binning by 2 Enabled by 3 Enabled by 4 Enabled avA1000-100gm avA1000-100gc avA1600-50gm avA1600-50gc avA1900-50gm avA1900-50gc avA2300-25gm avA2300-25gc NA = binning is not available on color cameras Table 9: Minimum AOI Height Settings Basler aviator GigE...
  • Page 178 You can set the Offset X, Offset Y, Width, and Height parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to get the maximum allowed settings and the increments for the Width and Height parameters. They also illustrate setting the Offset X, Offset Y, Width, and Height parameter values and enabling automatic AOI centering.
  • Page 179: Prelines

    Using the prelines feature impacts the relationship between the AOI height and the maximum frame rate. When you use a large prelines setting, you will see less of an increase in the maximum allowed frame rate as you make the AOI height smaller. Basler aviator GigE...
  • Page 180 The following code snippet illustrates using the API to set the parameter value: Camera.Prelines.SetValue( 48 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 181: Auto Functions

    Generally, the different auto functions can operate at the same time. For more information, see the following sections describing the individual auto functions. Basler aviator GigE...
  • Page 182 You can use an auto function when binning is enabled (monochrome cameras only). An auto function uses the binned pixel data and controls the image property of the binned image. Basler aviator GigE...
  • Page 183: Auto Function Operating Modes

    If you have set an auto function to "once" or "continuous" operation mode while the camera was continuously capturing images, the auto function will become effective with a short delay and the first few images may not be affected by the auto function. Basler aviator GigE...
  • Page 184: Auto Function Aois

    2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 Offset Auto Function Height Area of Interest Image Area of Interest X Offset Width Fig. 41: Auto Function Area of Interest and Image Area of Interest Basler aviator GigE...
  • Page 185: Assignment Of An Auto Function To An Auto Function Aoi

    // Select the unused Auto Function AOI 2 // Disable the unused Auto Function AOI Camera.AutoFunctionAOISelector.SetValue( AutoFunctionAOISelector_AOI2 ); Camera.AutoFunctionAOIUsageIntensity.SetValue( false ); Camera.AutoFunctionAOIUsageWhiteBalance.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler aviator GigE...
  • Page 186: Positioning Of An Auto Function Aoi Relative To The Image Aoi

    You can use auto functions when also using the reverse X and reverse Y mirroring features. For information about the behavior of Auto Function AOIs when also using the reverse X or reverse Y mirroring feature, see the "Mirror Image" section. Basler aviator GigE...
  • Page 187 Standard Features Auto Function AOI Image AOI Auto Function AOI Image AOI Auto Function AOI Image AOI Auto Function AOI Image AOI Fig. 42: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler aviator GigE...
  • Page 188: Setting An Auto Function Aoi

    API to select Auto Function AOI one and to get the maximum allowed settings for the Width and Height parameters. The snippet also illustrates setting the X Offset, Y Offset, Width, and Height parameter values. Basler aviator GigE...
  • Page 189: Using An Auto Function

    Camera.AutoFunctionAOIOffsetY.SetValue( 0 ); Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() ); Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 10.7.4...
  • Page 190: Gain Auto

    12 bit output, the target gray value can range from 800 to 3280. Setting the gain auto functionality using Basler pylon is a several step process: Select the Auto Function AOI that was related to Gain Auto.
  • Page 191 // Set the mode of operation for gain auto function. Camera.GainAuto.SetValue( GainAuto_Once ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 192: Exposure Auto

    When the camera is set for 12 bit output, the target gray value can range from 800 to 3280. If the Exposure Time Abs Upper Limit Parameter is set to a sufficiently high value, the camera’s maximum allowed frame rate may be decreased. Basler aviator GigE...
  • Page 193 // Set the mode of operation for the exposure auto function Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 194: Gray Value Adjustment Damping

    You can set the gray value adjustment damping from within your application software by using the pylon API. The following code snippets illustrate using the API to set the gray value adjustment damping: Camera.GrayValueAdjustmentDampingRaw.SetValue(600); Camera.GrayValueAdjustmentDampingAbs.SetValue(0.5859); You can also use the Basler pylon Viewer application to easily set the parameters. Basler aviator GigE...
  • Page 195: Auto Function Profile

    If you want to use the gain auto and the exposure auto functions at the same time, you should set both functions for the continuous mode of operation. Setting the camera with Basler pylon to use the gain auto function and the exposure auto function at the same time is a several step process: Set the value of the Auto Function Profile parameter to specify whether gain or exposure time ...
  • Page 196: Balance White Auto

    For more information about setting the white balance "manually", see Section 8.3.1 on page 113. Setting the balance white auto functionality using Basler pylon is a several step process: Select the Auto Function AOI to which the Balance White Auto is assigned. ...
  • Page 197 // Set mode of operation for balance white auto function Camera.BalanceWhiteAuto.SetValue( BalanceWhiteAuto_Once ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 198: Minimum Output Pulse Width

    You can set the Line Selector and the value of the MinOutPulseWidthAbs parameter from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: // Select the input line Basler aviator GigE...
  • Page 199 // Set the parameter value to 10.0 microseconds Camera.MinOutPulseWidthAbs.SetValue(10.0); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 200: Error Codes

    Execute the Clear Last Error Command to clear the last error code from the memory.  Continue reading and clearing the last error until the parameter indicates a No Error code.  Basler aviator GigE...
  • Page 201 // Read the value of the last error code in the memory LastErrorEnums lasterror = Camera.LastError.GetValue(); // Clear the value of the last error code in the memory Camera.ClearLastError.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameter and execute the command. Basler aviator GigE...
  • Page 202: Sequencer

    Three sequence advance modes (auto, controlled and free selection sequence advance modes) provide different schemes for advancing from one sequence set to the next (see below for details). Basler aviator GigE...
  • Page 203 Sequence Parameters, Set by the Current Set Sequence Enable Load / Store Sequence Set 0 Sequence Set 1 Sequence Set 2 Sequence Set N Sequence Sequence Set Advance Mode Index Number Fig. 44: Sequence Feature Block Diagram Basler aviator GigE...
  • Page 204 Viewer. Only those sequence parameter values will be displayed that were active before the sequencer was enabled. You will not be able to "see" the parameter values set by the current set. Make sure the sequencer feature is disabled when configuring sequence sets. Basler aviator GigE...
  • Page 205 Free selection sequence advance mode: Sequence set advance by selecting sequence sets  at will from the available sequence sets. The selection is controlled by the states of the input lines. For more information, see Section 10.10.3 on page 223. Basler aviator GigE...
  • Page 206 If you use the Sequence Set Selector parameter to select a sequence set and then you execute the Sequence Set Load command, the sequence parameter values in the active set will be replaced by the values stored in the selected sequence set. Basler aviator GigE...
  • Page 207 // Select sequence set with index number 0 Camera.SequenceSetIndex.SetValue( 0 ); // Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler aviator GigE...
  • Page 208: Auto Sequence Advance Mode

    0 through 5. The Sequence Set Executions parameter was set to 1 for sequence sets 0, 2, 3, and 4, to 2 for sequence set 5, and to 3 for sequence set 1. The frame start trigger is set for rising edge triggering. Basler aviator GigE...
  • Page 209 When the next frame start trigger is received, the camera checks the current Sequence Set  Executions parameter value. Because the Sequence Set Executions parameter is set to 2 for sequence set 5, this sequence set can not, after two uses, be used again in the current Basler aviator GigE...
  • Page 210 (the sequence set index number is indicated) = frame exposure and readout = frame transmission Sequencer Sequence Set Cycle Sequencer Enabled Starts Again Disabled Frame Start Trigger Signal Time Fig. 45: Sequencer in Auto Sequence Advance Mode Basler aviator GigE...
  • Page 211: Configuration

    Camera.SequenceEnable.SetValue( true ); // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. 10.10.1.2 Configuration Configuring Sequence Sets and Advance Control Use the following procedure for populating sequence sets and making the related settings: 1.
  • Page 212 Standard Features AW00097603000 Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software. The following code snippet gives example settings. It illustrates using the API to set the auto...
  • Page 213 AW00097603000 Standard Features // Store the sequence parameter values from the active set in the selected sequence // set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler aviator GigE...
  • Page 214: Controlled Sequence Advance Mode

    In this use case, the Sequence Set Total Number parameter is set to six. Accordingly, the available sequence set index numbers range from 0 through 5. The frame start trigger is set for rising edge triggering. Basler aviator GigE...
  • Page 215 = frame exposure and readout = frame transmission Sequencer Sequence Set Cycle Sequencer Enabled Starts Again Disabled Frame Start Trigger Signal Time Fig. 46: Sequencer in Controlled Sequence Advance Mode with Always Active as the Sequence Control Source Basler aviator GigE...
  • Page 216 Note also that the camera briefly exits the "waiting for frame start trigger" status while the input line changes its state. This happens when input line 1 changes its state before the fourth frame start trigger is received (see also Figure 47). Basler aviator GigE...
  • Page 217 When the next frame start triggers are received, the camera advances to the next sequence  sets and uses them for image acquisition in accord with the Always Active sequence control source and as described in the previous use case. Basler aviator GigE...
  • Page 218 Sequence Set Cycle Sequence Set Cycle (Restart) Starts Again Starts Again Frame Start Trigger Signal Time Fig. 47: Sequencer in Controlled Sequence Advance Mode with Always Active as the Sequence Control Source and Synchronous Restart Controlled by Line 1 Basler aviator GigE...
  • Page 219: Operation With An Input Line As Sequence Control Source

    Also, maintain the states of the input lines at least for one microsecond after the frame start trigger signal has risen. Basler aviator GigE...
  • Page 220  line 1 is found to be high and therefore the parameter values of the next sequence set are loaded into the active set. The parameter values of sequence set 0 are used for the image acquisition. Basler aviator GigE...
  • Page 221 In the following use case (see also Figure 49), the same settings were made as in the previous use case: The Sequence Set Total Number parameter was set to six. Accordingly, the sequence set index numbers range from 0 through 5. The frame start trigger is set for rising edge triggering. Basler aviator GigE...
  • Page 222 Note also that the camera briefly exits the "waiting for frame start trigger" status while an input line changes its state. This happened, for example, when input line 2 changed its state before the fourth frame start trigger was received (see also Figure 49). Basler aviator GigE...
  • Page 223 1. Input line 2 is found to be low and therefore the sequence cycle is not restarted. Input line 1 is found to be low and therefore no new sequence parameter values are loaded into the active set. The parameter values of sequence set 1 are used for the image acquisition. Basler aviator GigE...
  • Page 224 Sequence Set Cycle Sequence Set Cycle (Advance) Starts Again Starts Again Frame Start Trigger Signal Time Fig. 49: Sequencer in Controlled Sequence Advance Mode with Line 1 as the Sequence Control Source and Synchronous Restart Controlled by Line 2 Basler aviator GigE...
  • Page 225: Operation With The "Disabled" Sequence Control Source

    AsyncRestart command and it becoming effective will allow the acquisition of two more images. When the next frame start trigger is received, the camera checks the active set and uses it for  the image acquisition. The parameter values of sequence set 0 are used. Basler aviator GigE...
  • Page 226 The parameter values of sequence set 0 are loaded into the active set. Note that the camera briefly exits the "waiting for frame start trigger" status while the parameter values of sequence set 1 are loaded into the active set (see also Figure 50). Basler aviator GigE...
  • Page 227 While frame exposure and readout are in progress, the sequencer feature is disabled. The  complete frame is transmitted and the cycling through sequence sets is terminated. The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled. Basler aviator GigE...
  • Page 228 = frame exposure and readout = frame transmission Sequencer Sequencer Enabled Disabled Sequence Set Cycle Starts Again Time Fig. 50: Sequencer in Controlled Sequence Advance Mode with Disabled as the Sequence Control Source and Asynchronous Advance and Restart Basler aviator GigE...
  • Page 229: Configuration

    Camera.SequenceEnable.SetValue( true ); // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. 10.10.2.4 Configuration Configuring Sequence Sets and Advance Control Use the following procedure for populating sequence sets and setting the sources for sequence set advance and sequence cycle restart: Make sure that the sequencer feature is disabled.
  • Page 230 For information about setting the input line for invert, see Section 6.1.4 on page Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software.
  • Page 231 // Set up the second acquisition scenario (lighting, object position, etc.) and // adjust the camera parameters for the best image quality. // Store the sequence parameter values from the active set in the selected // sequence set Camera.SequenceSetStore.Execute( ); Basler aviator GigE...
  • Page 232 // Select sequence set with index number 0 Camera.SequenceSetIndex.SetValue( 0 ); // Load the sequence parameter values from the sequence set into the active set Camera.SequenceSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler aviator GigE...
  • Page 233: Free Selection Sequence Advance Mode

    Note also that the camera briefly exits the "waiting for frame start trigger" status while an input line changes its state. This happens, for example, when input line 1 changes its state before the first frame start trigger is received (see also Figure 51). Basler aviator GigE...
  • Page 234 While frame exposure and readout for the fifth frame start trigger are in progress, the  sequencer feature is disabled. The complete frame is transmitted. The sequencer parameter values in the active set return to the values that existed before the sequencer feature was enabled. Basler aviator GigE...
  • Page 235 Trigger Signal Time Fig. 51: Sequencer in Free Selection Mode Operating the Sequencer Using Basler pylon You can use the pylon API to set the parameters for operating the sequencer in Free Selection sequence advance mode from within your application software.
  • Page 236 // Disable the sequencer feature Camera.SequenceEnable.SetValue( false ); You can also use the Basler pylon Viewer application to easily set the parameters. Selecting Sequence Sets Each sequence set is identified by a sequence set index number, starting from zero. The states of the input lines select between the sequence sets by setting the (big endian) sequence set addresses.
  • Page 237: Configuration

    9. Repeat the above steps for the other sequence sets, starting from step 5. Configuring Sequence Sets and Advance Control Using Basler pylon You can use the pylon API to set the parameters for configuring sequence sets from within your application software and make settings for their selection when images are acquired.
  • Page 238 // adjust the camera parameters for the best image quality. // Store the sequence parameter values from the active set in the selected // sequence set Camera.SequenceSetStore.Execute( ); // Select sequence set with index number 2 Camera.SequenceSetIndex.SetValue( 2 ); Basler aviator GigE...
  • Page 239 // adjust the camera parameters for the best image quality. // Store the sequence parameter values from the active set in the selected // sequence set Camera.SequenceSetStore.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler aviator GigE...
  • Page 240: Binning

    Fig. 52: Vertical Binning With horizontal binning, adjacent pixels from 2 columns, 3 columns, or a maximum of 4 columns are summed and are reported out of the camera as a single pixel. Figure 53 illustrates horizontal bin- ning. Basler aviator GigE...
  • Page 241 // Disable vertical and horizontal binning Camera.BinningVertical.SetValue( 1 ); Camera.BinningHorizontal.SetValue( 1 ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 242: Considerations When Using Binning

    And when you set the Height for the AOI, you will be setting this value in terms of virtual sensor lines. For more information about the area of interest (AOI) feature, see Section 10.17 on page 250. Basler aviator GigE...
  • Page 243 AW00097603000 Standard Features Binning’s Effect on the Maximum Allowed Frame Rate Using vertical binning will increase the camera’s maximum allowed frame rate. For more information about determining the camera maximum allowed frame rate, see Section 7.9 page Basler aviator GigE...
  • Page 244: Mirror Imaging

    Y feature or both are used, the alignment of the color filter to the image remains Bayer GB. The camera includes a mechanism that keeps the filter alignment constant when these features are used. For more information about the color filter, see Section 8.1 on page 109. Basler aviator GigE...
  • Page 245 Auto Auto AOI 1 AOI 2 AOI 1 AOI 2 Fig. 55: Using Reverse X Mirror Imaging with Auto Functions Enabled For more information about auto functions and auto function AOIs, see Section 10.7 on page 171. Basler aviator GigE...
  • Page 246: Reverse Y

    Y feature or both are used, the alignment of the color filter to the image remains Bayer GB. The camera includes a mechanism that keeps the filter alignment constant when these features are used. For more information about the color filter, see Section 8.1 on page 109. Basler aviator GigE...
  • Page 247 Auto Auto AOI 1 AOI 2 AOI 1 AOI 2 Fig. 57: Using Reverse Y Mirror Imaging with Auto Functions Enabled For more information about auto functions and auto function AOIs, see Section 10.7 on page 171. Basler aviator GigE...
  • Page 248: Enabling Reverse X And Reverse Y

    // Enable reverse X Camera.ReverseX.SetValue(true); // Enable reverse Y Camera.ReverseY.SetValue(true); You can also use the Basler pylon Viewer application to easily set the parameter. For more information about the pylon API and the pylon Viewer, see Section 3 on page Basler aviator GigE...
  • Page 249: Luminance Lookup Table

    The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the digitized sensor output moves from 0 through 2048 and increases gradually as the digitized sensor output moves from 2049 through 4096. Basler aviator GigE...
  • Page 250 Fig. 58: Lookup Table with Values Mapped in a Linear Fashion 4095 3072 12 Bit Camera Output 2048 1024 1024 2048 3072 4095 12 Bit Digitized Sensor Reading Fig. 59: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler aviator GigE...
  • Page 251 You can set the LUT Selector, the LUT Index parameter and the LUT Value parameter from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter values: // Select the lookup table Camera.LUTSelector.SetValue( LUTSelector_Luminance );...
  • Page 252: Event Reporting

    If an acknowledgement is still not received, the timeout and resend mechanism will repeat until a specified maximum number of retries is reached. If the maximum number of retries is reached and no acknowledge has been received, the message will be dropped. Basler aviator GigE...
  • Page 253 This is described in the "Camera Events" code sample included with the pylon software development kit. Event reporting must be specifically set up for each type of event using the parameter name of the event and of the supplementary information. The following table lists the relevant parameter names: Basler aviator GigE...
  • Page 254 API. The pylon software development kit includes a "Grab_CameraEvents" code sample that illustrates the entire process. For more detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference.
  • Page 255: User Defined Values

    // Get the value of user defined value 1 Camera.UserDefinedValueSelector.SetValue( UserDefinedValueSelector_Value1 ); int64_t UserValue1 = Camera.UserDefinedValue.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 256: Test Images

    Enabling a Test Image With Basler pylon, the Test Image Selector is used to set the camera to output a test image. You can set the value of the Test Image Selector to enable one of the test images or to "test image off".
  • Page 257: Test Image Descriptions

    The image moves by one pixel from right to left whenever a new image acquisition is initiated. The test pattern uses a counter that increments by one for each new image acquisition. The mathematical expression for this test image is: Gray Value = [column number + row number + counter] MOD 256 Basler aviator GigE...
  • Page 258 5 will show the effects of the feature while test image 3 will not. This makes test image 5 useful for checking the effects of digital features such as the luminance lookup table. Basler aviator GigE...
  • Page 259 Bayer GB 8 format. If the colors in the images from your frame grabber do not exactly match the colors in test image 6 as shown below, then your frame grabber is incorrectly set. Fig. 61: Test Image 6 Basler aviator GigE...
  • Page 260: Device Information Parameters

    Device User ID (read / write) - is used to assign a user defined name to a device. This name  will be displayed in the Basler pylon Viewer and the Basler pylon IP Configurator. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
  • Page 261 // Read the Max Height parameter int64_t maxHeight = Camera.HeightMax.GetValue(); You can also use the Basler pylon Viewer application to easily read the parameters and to read or write the Device User ID. You can use the Basler pylon IP Configurator to read or write the Device User ID.
  • Page 262: Imaging Sensor Temperature Monitoring And Over Temperature Detection

    Reading the Imaging Sensor Temperature You can use the pylon API to read the imaging sensor board temperature in degrees C from within your application software. Reading the temperature using Basler pylon is a two step process: Select the imaging sensor board temperature sensor.
  • Page 263: Imaging Sensor Temperature Conditions

    // Check for an imaging sensor board overtemp condition  bool imgSensorOvertemp = Camera.OverTemperature.GetValue(); You can also use the Basler pylon Viewer application to easily check for an overtemperature condition. For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 264: Configuration Sets

    "startup" set, i.e., the set that will be loaded into the active set whenever the camera is powered on or reset. Instructions for loading the default set into the active set and for designating which set will be the startup set appear later in the Configuration Sets section. Basler aviator GigE...
  • Page 265 You can designate the default set or the user set as the "startup" set. The designated startup set will automatically be loaded into the active set whenever the camera starts up at power on or after a reset. Instructions for designating the startup set appear later in the Configuration Sets section. Basler aviator GigE...
  • Page 266: Selecting A Factory Setup As The Default Set

    To select which factory setup will serve as the default set using Basler pylon: Set the Default Set Selector to the Standard Factory Setup, High Gain Factory Setup, Auto Functions Factory Setup or Color Factory Setup.
  • Page 267: Saving User Sets

    When you save the active set to a user set, any parameter data already in that user set will be overwritten. Using Basler pylon to save the current active set to a user set in the camera’s non-volatile memory is a several step process: Make changes to the camera’s settings until the camera is operating in a manner that you...
  • Page 268: Loading A Saved User Set Or The Default Set Into The Active Set

    Loading a saved user set or the default set from the camera’s non-volatile memory into the active set using Basler pylon is a two step process: Set the User Set Selector to User Set 1, User Set 2, User Set 3, or Default as desired.
  • Page 269: Selecting A "Startup" Set

    With Basler pylon, the User Set Default Selector parameter is used to select User Set 1, User Set 2, User Set 3, or the Default Set as the startup set.
  • Page 270: Camera Feature Set

    The camera description file is included in the camera and describes the camera features in accord with the GenICam specification. The Basler aviator GigE cameras include two camera description files that are used alternatively. The camera description files represent partially different combinations of features (feature sets).
  • Page 271 // Select the camera description file providing all camera features CEnumerationPtr ptrFeatureSet( Camera.GetNodeMap().GetNode("FeatureSet")); ptrFeatureSet->FromString("Full"); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameter.
  • Page 272 Standard Features AW00097603000 Basler aviator GigE...
  • Page 273: Chunk Features

    The features that add chunks to the acquired images are referred to as “chunk” features. Before you can use any of the features that add chunks to the image, you must make the chunk mode active. Making the chunk mode active is described in the next section. Basler aviator GigE...
  • Page 274: Making The "Chunk Mode" Active And Enabling The Extended Data Stamp

    Set the Chunk Mode Active parameter to true. You can set the Chunk Mode Active parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.ChunkModeActive.SetValue( true );...
  • Page 275 = Camera.ChunkStride.GetValue(); For more information about using the chunk parser, see the sample code that is included with the Basler pylon Software Development Kit (SDK). For more information about the pylon API and the pylon Viewer, see Section 3 on...
  • Page 276: Frame Counter

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the frame...
  • Page 277 You can set the frame counter reset parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to configure and set the frame counter reset and to execute a reset via software.
  • Page 278 // Execute reset by software Camera.CounterReset.Execute(); // Disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page ...
  • Page 279: Time Stamp

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the time...
  • Page 280: Trigger Input Counter

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the trigger...
  • Page 281 You can set the trigger input counter reset parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to configure and set the trigger input counter reset and to execute a reset via software.
  • Page 282 // execute reset by software Camera.CounterReset.Execute(); // Disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page ...
  • Page 283: Line Status All

    API to activate the chunk mode, enable the line status all chunk, run the parser, and retrieve the line status all chunk data: // make chunk mode active and enable Line Status All chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_LineStatusAll ); Basler aviator GigE...
  • Page 284 Result.GetPayloadSize() ); int64_t lineStatusAll = Camera.ChunkLineStatusAll.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler aviator GigE...
  • Page 285: Crc Checksum

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the time...
  • Page 286 << "Image corrupted!" << endl; You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the Basler pylon API and the pylon Viewer, see Section 3 on page Basler aviator GigE...
  • Page 287: Sequence Set Index

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. You can also run the parser and retrieve the chunk data. The following code snippets illustrate using the API to activate the chunk mode, enable the time...
  • Page 288 Chunk Features AW00097603000 Basler aviator GigE...
  • Page 289: Technical Support

    If you do decide to contact Basler technical support, please take a look at the form that appears on the last two pages of this section before you call. Filling out this form will help make sure that you have all of the information the Basler technical support team needs to help you with your problem.
  • Page 290 Copy the form that appears on the next two pages, fill it out, and fax the pages to your local dealer or to your nearest Basler support center. Or, you can send an e-mail listing the requested pieces of information and with the requested files attached. Basler technical support contact information is shown in the title section of this manual.
  • Page 291 How often did/does the problem Once. Every time. occur? Regularly when: Occasionally when: How severe is the problem? Camera can still be used. Camera can be used after I take this action: Camera can no longer be used. Basler aviator GigE...
  • Page 292 Parameter set It is very important for Basler technical support to get a copy of the exact camera parameters that you were using when the problem occurred. To make note of the parameters, use the Basler pylon Viewer.
  • Page 293 Two network drivers are available for the network adapter used with your GigE cameras: The Basler filter driver is a basic GigE Vision network driver that is compatible with all  network adapters. The advantage of this driver is its extensive compatibility.
  • Page 294: The Basler Filter Driver

    AW00097603000 The Basler Filter Driver The Basler filter driver is a basic driver GigE Vision network driver. It is designed to be compatible with most network adapter cards. The functionality of the filter driver is relatively simple. For each frame, the driver checks the order of the incoming packets.
  • Page 295: The Basler Performance Driver

    The Basler performance driver uses a "receive window" to check the status of packets. The check for missing packets is made as packets enter the receive window. If a packet arrives from higher in the sequence of packets than expected, the preceding skipped packet or packets are detected as missing.
  • Page 296: General Parameters

    Basler Network Drivers and Parameters AW00097603000 A.2.1 General Parameters Enable Resend - Enables the packet resend mechanisms. If the Enable Resend parameter is set to false, the resend mechanisms are disabled. The performance driver will not check for missing packets and will not send resend requests to the camera.
  • Page 297 AW00097603000 Basler Network Drivers and Parameters Resend Request Threshold - This parameter determines the location of the resend request threshold within the receive window as shown in Figure 65. The parameter value is in per cent of the width of the receive window. In Figure 65 the resend request threshold is set at 33.33% of the width of the receive window.
  • Page 298: Timeout Resend Mechanism Parameters

    Basler Network Drivers and Parameters AW00097603000 A.2.3 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 66 where the following assumptions are made: The frame includes 3000 packets.  Packet 1002 is missing within the stream of packets and has not been recovered.
  • Page 299 AW00097603000 Basler Network Drivers and Parameters Maximum Number Resend Requests - The Maximum Number Resend Requests parameter sets the maximum number of resend requests the performance driver will send to the camera for each missing packet. Resend Timeout - The Resend Timeout parameter defines how long (in milliseconds) the performance driver will wait after detecting that a packet is missing before sending a resend request to the camera.
  • Page 300: Threshold And Timeout Resend Mechanisms Combined

    Basler Network Drivers and Parameters AW00097603000 A.2.4 Threshold and Timeout Resend Mechanisms Combined Figure 67 illustrates the combined action of the threshold and the timeout resend mechanisms where the following assumptions are made: All parameters set to default.  The frame includes 3000 packets.
  • Page 301 (12) Interval defined by the Packet Timeout parameter. You can set the performance driver parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Get the Stream Parameters object Camera_t::StreamGrabber_t StreamGrabber( Camera.GetStreamGrabber(0) );...
  • Page 302: Adapter Properties

    AW00097603000 A.2.5 Adapter Properties When the Basler Performance driver is installed, it adds a set of "advanced" properties to the network adapter. These properties include: Max Packet Latency - A value in microseconds that defines how long the adapter will wait after it receives a packet before it generates a packet received interrupt.
  • Page 303: Transport Layer Parameters

    You can set the driver related transport layer parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Read/Write Timeout Camera_t::TlParams_t TlParams( Camera.GetTLNodeMap() );...
  • Page 304 Basler Network Drivers and Parameters AW00097603000 Basler aviator GigE...
  • Page 305: Network Related Parameters In The Camera

    The packet size parameter sets the size of the packets that the camera will use when it sends the data payload via the selected stream channel. The value is in bytes. The value does not affect the Basler aviator GigE...
  • Page 306 IPD = Inter-packet Delay setting in ticks (with a tick set to the 8 ns standard) When considering this formula, you should know that on a Gigabit network it takes one tick to transmit one byte. Also, be aware that the formula has been simplified for easier understanding. Basler aviator GigE...
  • Page 307 The example also assumes that the camera is operating in a poor environment, so many packets are lost and many resends are required. The numbered text is keyed to the time periods in the chart. Basler aviator GigE...
  • Page 308 15 resends would be required from the accumulator pool, but the pool only has 9 resends. So the 9 resends in the pool are used and 6 resend requests are answered with a "packet unavailable" error code. The accumulator pool is reduced to 0. Basler aviator GigE...
  • Page 309 If software or hardware triggering is being used to control the camera’s frame rate, the maximum frame rate allowed with the current camera settings will be used to calculate the device max throughput. Basler aviator GigE...
  • Page 310 You can read or set the camera’s network related parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter values: // Payload Size int64_t payloadSize = Camera.PayloadSize.GetValue();...
  • Page 311 // Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); You can also use the Basler pylon Viewer application to easily set or view the parameter values. For more information about the pylon API and the pylon Viewer, see Section 3 on page...
  • Page 312: Managing Bandwidth When Multiple Cameras Share A Single Network Path

    If you want to acquire and transmit images from several cameras simultaneously, however, you must determine the total data output rate for all the cameras that will be operating simultaneously and you must make sure that this total does not exceed the bandwidth of the single path (125 MByte/s). Basler aviator GigE...
  • Page 313 After you have adjusted the Inter-packet Delay parameter on each camera, you can check the sum of the Bandwidth Assigned parameter values and see if the sum is now less than 125 MByte/s. Basler aviator GigE...
  • Page 314: A Procedure For Managing Bandwidth

    If you use the Basler filter driver and have already set network parameters for your network adapter during the installation of the Basler pylon software, continue with step two. Otherwise, open the...
  • Page 315 Unless you have already set the packet size for your network adapter during the installation of the Basler pylon software, check the documentation for your adapter to determine the maximum packet size (sometimes called “frame” size) that the adapter can handle. Many adapters can handle what is known as “jumbo packets”...
  • Page 316 To use the formula, you will need to know the current value of the Bandwidth Assigned parameter and the Bandwidth reserve parameter for each camera. 100 Bandwidth Reserved –  ---------------------------------------------------------------------- - Data Bandwidth Assigned Bandwidth Assigned Basler aviator GigE...
  • Page 317 When you lower the data output rate, you increase the amount of time that the camera needs to transmit an acquired frame (image). Increasing the frame transmission time can restrict the camera’s maximum allowed frame rate. Basler aviator GigE...
  • Page 318 AOI settings on the cameras, you should repeat steps 2 through 6. For more information about the camera’s maximum allowed frame transmission rate, see Section 7.9 on page  the AOI, see Section 10.6 on page 166.  Basler aviator GigE...
  • Page 319: Revision History

    Initial release of this document for series production cameras. AW00097603000 Oct 2011 Indicated Basler AG as bearer of the copyright on the back of the front page. Added cable shield and AC In lines and Gnd to the power supply in Fig. 11 in Section 5.4.2 on...
  • Page 320 Added the critical temperature condition in Section 10.18.2 on page 253. Added the chunk Stride parameter in Section 11.2 on page 264. Added the "Sequence Set Index" section on page 277. Added the Save Feature... command on page 282 in Section 12. Basler aviator GigE...
  • Page 321: Index

    ........273 chunk sequence set index parameter ..277 chunk time stamp parameter....269 chunk trigger input counter parameter ...270 balance white auto .........186 chunk width parameter ......265 bandwidth assigned parameter ....296 cleaning the camera and sensor ....17 Basler aviator GigE...
  • Page 322 296 EMI............13 frame transmission time ......96 enable resend parameter ....284, 286 frame trigger wait signal......94 end of exposure event ......242 free run........... 101 environmental requirements ....14 free selection sequence set Basler aviator GigE...
  • Page 323 ....284, 289, 303 multiple cameras on a network....302 inverter input lines ...........48 output line...........52 IP Configurator .........22 network adapter, packet size....305 IP30 ............7 network drivers ........283 IR cut filter ........6, 10, 112 network parameter .........304 network performance......304 Basler aviator GigE...
  • Page 324 ....... 192 pixel readout ........24, 27 sequence parameter ......193 pixel size ..........2, 4 sequence set.......... 192 pixel transmission sequence ....149 address ..........226 PLC power and I/O cable ....34, 36 configuration ....201, 219, 227 Basler aviator GigE...
  • Page 325 AOI ...........166 temperature, housing .......14 write timeout parameter......293 test images ..........246 time delay time base abs parameter ..54 time stamp chunk ........269 timed exposure mode.......82 YUV 422 (YUYV) packed timer delay..........55 pixel format........136, 145 timer delay abs parameter......55 Basler aviator GigE...
  • Page 326 Index AW00097603000 YUV 422 data range ......144 YUV 422 packed pixel format ..136, 143 Basler aviator GigE...

This manual is also suitable for:

Aviator

Table of Contents