Basler pilot User Manual
  1. Manuals
  2. Brands
  3. Basler Manuals
  4. Security Camera
  5. pilot
  6. User manual

Basler pilot User Manual

Gige vision cameras
Hide thumbs Also See for pilot:
Table of Contents

Advertisement

Quick Links

Basler pilot
USER'S MANUAL FOR GigE VISION CAMERAS
Document Number: AW000151
Version: 16
Language: 000 (English)
Release Date: 17 June 2009

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Related Manuals for Basler pilot

Summary of Contents for Basler pilot

  • Page 1 Basler pilot USER’S MANUAL FOR GigE VISION CAMERAS Document Number: AW000151 Version: 16 Language: 000 (English) Release Date: 17 June 2009...
  • 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-500 Fax.: +49-4102-463-599 bc.support.europe@baslerweb.com Americas: Basler, Inc. 855 Springdale Drive, Suite 160 Exton, PA 19341 U.S.A. Tel.: +1-877-934-8472 Fax.: +1-610-280-7608 bc.support.usa@baslerweb.com Asia: Basler Asia Pte. Ltd...

  • Page 5: Table Of Contents

    The pylon API ............30 4 Basler Network Drivers and Parameters ......31 The Basler Filter Driver.
  • Page 6 Exposure Active Signal..........98 Basler pilot...
  • Page 7 11.3 White Balance (on Color Models) ........155 Basler pilot...
  • Page 8 11.21.4 Selecting the Startup Set ........224 Basler pilot...
  • Page 9 12.1 Technical Support Resources......... . . 225 12.2 Before Contacting Basler Technical Support ....... 226 Revision History .
  • Page 10 Table of Contents Basler pilot...

  • Page 11: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. Models The current Basler pilot GigE Vision camera models are listed in the top row of the specification table on the next page of this manual. The camera models are differentiated by their sensor size, their maximum frame rate at full resolution, and whether the camera’s sensor is mono or color.

  • Page 12: General Specifications

    +12 to +24 VDC, (min. +11.3 VDC, absolute max. +30.0 VDC ), < 1% ripple Requirements 4.5 W @ 12 VDC 4.2 W @ 12 VDC 4.8 W @ 12 VDC I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount Basler pilot...
  • Page 13 110 mm x 44 mm x 41.8 mm (with front module and connectors) Weight (standard housing) ~ 220 g (typical) (90° head housing) ~ 240 g (typical) Conformity CE, FCC, GenICam, GigE Vision; IP30 Table 1: General Specifications Basler pilot...
  • Page 14 Programmable via the camera API Camera Power +12 to +24 VDC, (min. +11.3 VDC, absolute max. +30.0 VDC), Requirements < 1% ripple 4.4 W @ 12 VDC I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount Basler pilot...
  • Page 15 Note The sensor characteristics of the piA1900-32gm/gc cameras do not entirely conform to the quality standards generally adhered to by Basler. The sensitivity to light for clusters of up to six contiguous pixels may deviate significantly from the sensitivities of normal pixels.
  • Page 16 +12 to +24 VDC, (min. +11.3 VDC, absolute max. +30.0 VDC ), Requirements < 1% ripple 5.4 W @ 12 VDC 5.9 W @ 12 VDC I/O Ports 2 opto-isolated input ports and 4 opto-isolated output ports Lens Adapter C-mount Basler pilot...
  • Page 17 110 mm x 44 mm x 41.8 mm (with front module and connectors) Weight (standard housing) ~ 220 g (typical) (90° head housing) ~ 240 g (typical) Conformity CE, FCC, GenICam, GigE Vision, IP30 Table 3: General Specifications Basler pilot...

  • Page 18: Spectral Response For Mono Cameras

    Spectral Response for Mono Cameras The following graphs show the spectral response for each available monochrome camera model. Note The spectral response curves exclude lens characteristics and light source characteristics. Wave Length (nm) Fig. 1: piA640-210gm Spectral Response Basler pilot...
  • Page 19 Specifications, Requirements, and Precautions Wave Length (nm) Fig. 2: piA1000-48gm Spectral Response Wave Length (nm) Fig. 3: piA1600-35gm Spectral Response Basler pilot...
  • Page 20 Specifications, Requirements, and Precautions Wave Length (nm) Fig. 4: piA1900-32gm Spectral Response 1000 Wave Length (nm) Wave Length (nm) Fig. 5: piA2400-12gm and piA2400-17gm Spectral Response Basler pilot...

  • Page 21: Spectral Response For Color Cameras

    A suitable IR cut filter is included in the standard C-mount lens adapter on color models of the camera. (An IR cut filter is not included in the optional CS- mount adapter.) Blue Green Wave Length (nm) Fig. 6: piA640-210gc Spectral Response Basler pilot...
  • Page 22 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 7: piA1000-48gc Spectral Response Blue Green Wave Length (nm) Fig. 8: piA1600-35gc Spectral Response Basler pilot...
  • Page 23 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 9: piA1900-32gc Spectral Response Blue Green Wave Length (nm) Wave Length (nm) Fig. 10: piA2400-12gc and piA2400-17gc Spectral Response Basler pilot...

  • Page 24: Mechanical Specifications

    The camera’s dimensions in millimeters are as shown in the drawings below. Camera housings are equipped with four mounting holes on the top and four mounting holes on the bottom as shown in the drawings. Basler pilot...
  • Page 25 2 x M3; 4 deep 2x M2; 4.5 deep 6.45 85.3 13.5 86.7 98.5 17.5 2 x M3; 3.5 deep Photosensitive surface of the sensor Top Side 2 x M3; 4.5 deep 80.2 Fig. 11: Mechanical Dimensions (in mm) Basler pilot...

  • Page 26: Sensor Positioning Accuracy

    Camera Tilt X Tilt Y Camera Tilt X Tilt Y piA640-210gm/gc 0.48 0.63 piA1900-32gm/gc 0.16 0.29 piA1000-48gm/gc 0.31 0.31 piA2400-12gm/gc 0.27 0.32 piA1600-35gm/gc 0.19 0.26 piA2400-17gm/gc 0.27 0.32 Fig. 12: Sensor Positioning Accuracy (in mm Unless Otherwise Noted) Basler pilot...

  • Page 27: 90° Head Housing

    1.5.2.1 Camera Dimensions and Mounting Points In pilot cameras with the 90° head housing the camera’s direction of view is at right angle to the direction of view of standard pilot cameras. The cameras are manufactured with high precision. Planar, parallel, and angular sides guarantee precise mounting with high repeatability.
  • Page 28 104.65 2 x M3; 4.5 deep 85.65 Photosensitive 28.5 surface of the Ø sensor 3.25 99.3 2 x M3; 4.5 deep 2 x M3; 3.5 deep Fig. 13: Mechanical Dimensions (in mm) for Cameras With 90° Head Housing Basler pilot...

  • Page 29: Sensor Positioning Accuracy

    Note that this tolerance and the sensor tilt tolerance (see above) must be combined to obtain the total tolerance for every point on the photosensitive surface.) Fig. 14: Sensor Positioning Accuracy for Cameras With 90° Head Housing (in mm unless otherwise noted) Basler pilot...

  • Page 30: Maximum 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 pilot...

  • Page 31: Mechanical Stress Test Results

    1.5.4 Mechanical Stress Test Results Pilot cameras were submitted to an independent mechanical testing laboratory and subjected to the stress tests listed below. The mechanical stress tests were performed on selected camera models with standard housing. After mechanical testing, the cameras exhibited no detectable physical damage and produced normal images during standard operational testing.

  • Page 32: 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 pilot...

  • Page 33: Avoiding Emi And Esd Problems

    Control the humidity in your environment. Low humidity can cause ESD problems. Note The Basler application note called Avoiding EMI and ESD in Basler Camera Installations provides much more detail about avoiding EMI and ESD. The application note can be downloaded at: www.baslerweb.com/indizes/download_index_en_31412.html...

  • Page 34: 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 temperature does not exceed 50 °C.

  • Page 35: Precautions

    Inappropriate code may cause your camera to function differently than expected and may compromise your application. CAUTION To ensure that the snippets will work properly in your application, you must adjust them to meet your specific needs and must test them thoroughly prior to use. Basler pilot...
  • Page 36 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 pilot...

  • Page 37: Software And Hardware Installation

    The information you will need to install and operate the camera 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 Basler website: www.baslerweb.com/indizes/download_index_en_19627.html.
  • Page 38 Software and Hardware Installation Basler pilot...

  • Page 39: Tools For Changing Camera Parameters

    The Basler IP Configuration Tool 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 40: The Pylon Api

    API. The SDK is included in Basler’s pylon Driver Package. You can download the pylon package from the Basler website: www.baslerweb.com/beitraege/beitrag_en_71708.html. For more information about installing pylon software, see the installation and Setup Guide for Cameras Used with Basler’s pylon API (AW000611xx000).

  • Page 41: Basler Network Drivers And Parameters

    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 42: The Basler Filter Driver

    Basler Network Drivers and Parameters 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 43: 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 44 Basler Network Drivers and Parameters 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 45 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 16. The parameter value is in per cent of the width of the receive window. In Figure 16 the resend request threshold is set at 33.33% of the width of the receive window.
  • Page 46 Basler Network Drivers and Parameters Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 17 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 47 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 48 Basler Network Drivers and Parameters Threshold and Timeout Resend Mechanisms Combined Figure 18 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 49 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. (Note that the performance driver parameters will only appear in the viewer if the performance driver is installed on the adapter to which your camera is connected.)
  • Page 50 Basler Network Drivers and Parameters 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 51: Transport Layer Parameters

    Camera_t::TlParams_t TlParams( Camera.GetTLNodeMap() ); TlParams.HeartbeatTimeout.SetValue(5000); // 5 seconds 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 52 Basler Network Drivers and Parameters Basler pilot...

  • Page 53: Network Related Camera Parameters And Managing Bandwidth

    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 leader and trailer size and the last data packet may be a smaller size. Basler pilot...
  • Page 54 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 pilot...
  • Page 55 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 pilot...
  • Page 56 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 pilot...
  • Page 57 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 pilot...
  • Page 58 // Payload Size int64_t payloadSize = Camera.PayloadSize.GetValue(); // GevStreamChannelSelector Camera.GevStreamChannelSelector.SetValue ( GevStreamChannelSelector_StreamChannel0 ); // PacketSize Camera.GevSCPSPacketSize.SetValue( 1500 ); // Inter-packet Delay Camera.GevSCPD.SetValue( 1000 ); // Frame-transmission Delay Camera.GevSCFTD.SetValue( 1000 ); // Bandwidth Reserve Camera.GevSCBWR.SetValue( 10 ); Basler pilot...
  • Page 59 = Camera.GevSCDCT.GetValue(); // Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); 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 60: Managing Bandwidth When Multiple Cameras Share A Single Network Path

    You can lower the data output rate on a camera by using the Inter-packet Delay parameter. This parameter adds a delay between the transmission of each packet from the camera and thus slows Basler pilot...

  • Page 61: 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 62 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 63 To determine the “data bandwidth assigned,” you must subtract out the reserve. Basler pilot...
  • Page 64 M/Byte/s for a 100 Bit/s network, the bandwidth management is OK. If the sum of the Bandwidth Assigned values is greater than 125 MByte/s for a Give network or 12.5 M/Byte/s for a 100 Bit/s network, the cameras need more bandwidth than is available and you must Basler pilot...
  • Page 65 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 8.9 on page 102. For more information about the AOI, see Section 11.6 on page 163. Basler pilot...
  • Page 66 Network Related Camera Parameters and Managing Bandwidth Basler pilot...

  • Page 67: Camera Functional Description

    Exposure start, exposure time, and charge readout 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 68 Shift Shift Shift Pixels Pixels Pixels Pixels Pixels Pixels Pixels Pixels Reg. Reg. Reg. Reg. Reg. Reg. Reg. Reg. Line Line Line Line Line Line Left Horizontal Shift Register Right Horizontal Shift Register Fig. 20: CCD Sensor Architecture Basler pilot...
  • Page 69 ExTrig 24 MB Image ExpActive Buffer TrigRdy Image Image Data Data Ethernet Ethernet FPGA Sensor Controller Network Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 21: Camera Block Diagram Basler pilot...
  • Page 70 Camera Functional Description Basler pilot...

  • Page 71: Physical Interface

    A 12-pin receptacle used to provide access to the camera’s I/O lines and to provide power to the camera. The drawing below shows the location of the two connectors and the LEDs. 12-pin Receptacle 8-pin RJ-45 Jack Green LED Yellow LED Fig. 22: Camera Connectors and LED Basler pilot...

  • Page 72: Connector Pin Assignments And Numbering

    8 and 9 on the camera. We also recommend that you provide camera power ground through separate wires between your power supply and pins 1 and 2 on the camera. Basler pilot...

  • Page 73: Jack Pin Assignments

    Physical Interface 7.2.2 RJ-45 Jack Pin Assignments The 8-pin RJ-45 jack provides Ethernet access to the camera. Pin assignments adhere to the Ethernet standard. 7.2.3 Pin Numbering Fig. 23: Pin Numbering for the 12-pin Receptacle Basler pilot...

  • Page 74: Connector Types

    7.3.2 12-pin Connector The 12-pin connector on the camera is a Hirose micro receptacle (part number HR10A-10R-12P) or the equivalent. The recommended mating connector is the Hirose micro plug (part number HR10A-10P-12S) or the equivalent. Basler pilot...

  • Page 75: Cabling Requirements

    The maximum length of the standard power and I/O cable is at least 10 meters. The cable must be shielded and must be constructed with twisted pair wire. Use of twisted pair wire is essential to ensure that input signals are correctly received. Close proximity to strong magnetic fields should be avoided. Basler pilot...
  • Page 76 Physical Interface 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 77: Plc Power And I/O Cable

    PLC device, if power for the I/O input is supplied with 24 VDC. Basler offers PLC power and I/O cables with 3 m and 10 m 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 78: Camera Power

    Table 6: Voltage Requirements for the Camera Power VCC For more information about the 12-pin connector and the power and I/O cables see Section 7.2 on page 62, Section 7.3 on page 64, and Section 7.4 on page Basler pilot...

  • Page 79: Ethernet Gige Device Information

    Physical Interface Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant. Basler pilot...

  • Page 80: Input And Output Lines

    > +2.2 VDC The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 7: Voltage Requirements for the I/O Input When Using the Standard Power and I/O Cable Basler pilot...
  • Page 81 > +10.4 VDC The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 8: Voltage Requirements for the I/O Input When Using a PLC Power and I/O Cable Basler pilot...

  • Page 82: Line Schematic

    For more information about input line pin assignments and pin numbering, see Section 7.2 on page For more information about how to use an ExTrig signal to control acquisition start, see Section 8.3 page For more information about configuring the input lines, see Section 10.1 on page 137. Basler pilot...

  • Page 83: Output Lines

    Figure 26 is monitoring output line 1. 220 Ω BC847BS Out_1_Ctrl Your Gnd 270 Ω Voltage I/O_Out_1 BAS16 Output Signal to You I/O_Out_VCC Camera +3.3 to +24 Your Gnd 12-Pin Receptacle Fig. 26: Typical Voltage Output Circuit Basler pilot...
  • Page 84 For more information about the exposure active signal, see Section Section 8.7 on page For more information about the trigger ready signal, see Section Section 8.6 on page For more information about assigning camera output signals to physical output lines, see Section 10.2.1 on page 139. Basler pilot...

  • Page 85: Output Line Response Time

    The response times for the output lines on your camera will typically fall into the ranges specified above. The exact response time for your specific application will depend on the external resistor and the applied voltage you use. Basler pilot...
  • Page 86 Physical Interface Fig. 29: I/O Line Schematic Basler pilot...

  • Page 87: Image Acquisition Control

    Camera.TriggerSelector.SetValue( TriggerSelector_AcquisitionStart ); Camera.TriggerMode.SetValue( TriggerMode_Off ); 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 88: Acquiring One Image At A Time

    Camera.AcquisitionMode.SetValue( AcquisitionMode_SingleFrame ); You can also execute the Acquisition Start command by using the API. 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 89 = Camera.ResultingFrameRateAbs.GetValue(); You can also execute the Acquisition Start and Stop commands by using the API. 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 90: Controlling Image Acquisition With A Software Trigger

    The following code snippet illustrates using the API to set the parameter values: Camera.TriggerSelector.SetValue(TriggerSelector_AcquisitionStart); Camera.TriggerMode.SetValue( TriggerMode_On ); Camera.TriggerSource.SetValue( TriggerSource_Software ); Camera.ExposureMode.SetValue( ExposureMode_Timed ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. Basler pilot...

  • Page 91: Acquiring A Single Image By Applying One Software Trigger

    Camera.AcquisitionStart.Execute( ); Camera.TriggerSoftware.Execute( ); // retrieve the captured image 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 92: Acquiring Images By Applying A Series Of Software Triggers

    Camera.ExposureTimeRaw.SetValue( 200 ); Camera.AcquisitionMode.SetValue( AcquisitionMode_Continuous ); // prepare for image acquisition here Camera.AcquisitionStart.Execute( ); while ( ! finished ) Camera.TriggerSoftware.Execute( ); // retrieve acquired image here Camera.AcquisitionStop.Execute( ); // how to set and test the Acquisition Frame Rate Basler pilot...
  • Page 93 // how to disable the FrameRateAbs parameter Camera.AcquisitionFrameRateEnable.SetValue( false ); 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 94: Controlling Image Acquisition With A Hardware Trigger

    For more information about setting the camera for hardware triggering and selecting the input line to receive the ExTrig signal, see Section 8.3.2 on page For more information about determining the maximum allowed acquisition frame rate, see Section 8.9 on page 102. Basler pilot...

  • Page 95: Exposure Modes

    When you operate the camera in trigger width exposure mode, you must use the camera’s exposure setting to set an exposure time. The exposure time setting will be used by the camera to operate the trigger ready signal. Basler pilot...
  • Page 96 // set for the width exposure mode, set minimum exposure time to 3000 µs Camera.ExposureMode.SetValue( ExposureMode_TriggerWidth ); Camera.ExposureTimeAbs.SetValue( 3000 ); 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 97: Setting The Camera For Hardware Triggering

    Camera.TriggerMode.SetValue( TriggerMode_On ); Camera.TriggerSource.SetValue ( TriggerSource_Line1 ); Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); 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 98: Acquiring A Single Image By Applying One Hardware Trigger Transition

    Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); Camera.AcquisitionMode.SetValue( AcquisitionMode_SingleFrame ); Camera.AcquisitionStart.Execute( ); 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 99: Acquiring Images By Applying A Series Of Hardware Trigger Transitions

    If the Acquisition Frame Rate Abs parameter is set to a value greater than the maximum allowed, you can trigger acquisition at any rate up to the maximum allowed image acquisition rate with the current camera settings. Basler pilot...
  • Page 100 Camera.AcquisitionMode.SetValue( AcquisitionMode_Continuous ); Camera.AcquisitionStart.Execute( ); Camera.AcquisitionStop.Execute( ); 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. For more information about the pylon Viewer, see Section 3.1 on page For more information about the Trigger Ready signal, see Section 8.6 on...

  • Page 101: Exposure Time Parameters

    For more information about auto functions, see Section 11.11.1 on page 196. For more information about the Exposure Auto function, see Section 11.11.3 on page 205. For information on parameter settings for obtaining the maximum possible exposure time, see Section 8.4.1 on page Basler pilot...

  • Page 102: Setting The Exposure Time Using "Raw" Settings

    Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeRaw.SetValue( 100 ); Camera.ExposureTimeBaseAbs.SetValue( 200 ); 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 103: Setting The Exposure Time Using "Absolute" Settings

    Camera.ExposureTimeAbs.SetValue( 124 ); double resultingExpTime = Camera.ExposureTimeAbs.GetValue( ); 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 104: Overlapping Exposure And Sensor Readout

    As you can see, running the camera with readout and exposure overlapped can allow higher acquisition frame rates because the camera is performing two processes at once. Image Acquisition N Exposure Readout Image Acquisition N+1 Exposure Readout Image Acquisition N+2 Exposure Readout Image Acquisition N+3 Exposure Readout Time Fig. 35: Overlapped Exposure Basler pilot...

  • Page 105: Guidelines For Overlapped Operation

    For more detailed guidelines about using an external trigger signal with the trigger width exposure mode and overlapped exposure, refer to the application notes called "Using a Specific External Trigger Signal with Overlapped Exposure" (AW000565xx000). The application notes are available in the downloads section of the Basler website: www.baslerweb.com. Basler pilot...

  • Page 106: Trigger Ready Signal

    N+1 N+1 begins acquisition N+2 N+2 begins TrigRdy Signal Image Acquisition N Exposure Readout Image Acquisition N+1 Exposure Readout Image Acquisition N+2 Exposure Readout Time Fig. 36: Trigger Ready Signal Basler pilot...
  • Page 107 For more information about changing the assignment of camera output signals to physical output lines, see Section 10.2.1 on page 139. For more information about the electrical characteristics of the camera’s output lines, see Section 7.7.2 on page Basler pilot...

  • Page 108: Exposure Active Signal

    For more information about changing the assignment of camera output signals to physical output lines, see Section 10.2.1 on page 139. For more information about the electrical characteristics of the camera’s output lines, see Section 7.7.2 on page Basler pilot...

  • Page 109: Acquisition Timing Chart

    The exposure start delay varies from camera model to camera model. The table below shows the exposure start delay for each camera model: Camera Model Exposure Start Delay piA640-210gm/gc 23.64 µs piA1000-48gm/gc 24.64 µs piA1600-35gm/gc 65.98 µs piA1900-32gm/gc 101.45 µs piA2400-12gm/gc 66.60 µs piA2400-17gm/gc 32.06 µs Table 11: Exposure Start Delays Basler pilot...
  • Page 110 For more information about the averaging feature, see Section 11.9 on page 173. You can calculate an approximate frame transmission time by using this formula: Payload Size Parameter Value ~ Frame Transmission Time ---------------------------------------------------------------------------------------------------------------------- - Device Current Throughput Parameter Value Basler pilot...
  • Page 111 Due to the nature of the Ethernet network, the transmission start delay can vary from frame to frame. The start delay, however, is of very low significance when compared to the transmission time. For more information about the Payload Size and Device Current Throughput parameters, see Section 5.1 on page Basler pilot...

  • Page 112: Maximum Allowed Acquisition Frame Rate

    If you are using normal exposure times and you are using the camera at it’s maximum resolution, your exposure time will not normally be the most restrictive factor on the frame rate. However, if you are using long exposure times or small areas of interest, it is quite possible to Basler pilot...
  • Page 113 13.39 µs 7423.76 µs piA1600-35gm/gc 20.52 µs 3873.2 µs piA1900-32gm/gc* 0 µs 31021.26 µs piA2400-12gm/gc 26.19 µs 26210.09 µs piA2400-17gm/gc 20.94 µs 15413.35 µs * Note: The maximum frame rate of the piA1900-32gm/gc is limited to 32 fps. Basler pilot...
  • Page 114 When the averaging feature is used, the above formula is replaced by the related formula in the "Averaging" section, which may permit a higher maximum acquisition frame rate. For the related formula when the averaging feature is used, see Section 11.9 on page 173. Basler pilot...
  • Page 115 ----------------------------- - 240000 Max Frames/s = 458.3 frames/s Formula one returns the lowest value. So in this case, the limiting factor is the sensor readout time and the maximum allowed acquisition frame rate would be 248.4 frames per second. Basler pilot...
  • Page 116 Image Acquisition Control Basler pilot...

  • Page 117: Pixel Data Formats

    • • • piA1600-35gc • • • • • • piA1900-32gc • • • • • • piA2400-12gc • • • • • • piA2400-17gc • Table 13: Pixel Formats Available on Color Cameras ( = format available) Basler pilot...
  • Page 118 Camera.PixelFormat.SetValue( PixelFormat_YUV422_YUYV_Packed ); Camera.PixelFormat.SetValue( PixelFormat_BayerGB8 ); Camera.PixelFormat.SetValue( PixelFormat_BayerGB16 ); 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 119: Pixel Data Formats For Mono Cameras

    With the camera set for Mono 8, the pixel data output is 8 bit data of the “unsigned char” 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) 0xFF 0xFE • • • • • • 0x01 0x00 Basler pilot...

  • Page 120: Mono 16 Format (Equivalent To Dcam Mono 16)

    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 pilot...
  • Page 121 0x0FFE 4094 • • • • • • 0x0001 0x0000 Note When a camera that is set for Mono 16 has only 12 bits effective, the leader of transmitted frames will indicate Mono 12 as the pixel format. Basler pilot...

  • Page 122: 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 pilot...
  • Page 123 “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 pilot...

  • Page 124: Yuv 4:2:2 Packed Format (Equivalent To Dcam Yuv 4:2:2)

    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.9 on page 132. Basler pilot...

  • Page 125: Pixel Data Output Formats For Color Cameras

    "BG" 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. 39: Bayer Filter Pattern Basler pilot...

  • Page 126: Color Filter Alignment

    You can tell how the current AOI is aligned to the Bayer filter by reading the value of the Pixel Color Filter parameter. For more information about the camera’s AOI feature, see Section 11.6 on page 163. Basler pilot...

  • Page 127: Bayer Gb 8 Format (Equivalent To Dcam Raw 8)

    Blue value for P Green value for P Green value for P 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 pilot...
  • Page 128 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 pilot...

  • Page 129: Bayer Bg 8 Format (Equivalent To Dcam Raw 8)

    Green value for P 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 Green value for P Red value for P Basler pilot...
  • Page 130 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 pilot...

  • Page 131: Bayer Gb 16 Format (Equivalent To Dcam Raw 16)

    • • • • • • • • • • 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 pilot...
  • Page 132 • • • • • • 0x0001 0x0000 Note When a camera that is set for Bayer GB 16 has only 12 bits effective, the leader of transmitted frames will indicate Bayer GB 12 as the pixel format. Basler pilot...

  • Page 133: Bayer Bg 16 Format (Equivalent To Dcam Raw 16)

    High byte of blue value for P High byte of green value for P 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 pilot...
  • Page 134 • • • • • • 0x0001 0x0000 Note When a camera that is set for Bayer BG 16 has only 12 bits effective, the leader of transmitted frames will indicate Bayer BG 12 as the pixel format. Basler pilot...

  • Page 135: 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 pilot...
  • Page 136 “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 pilot...

  • Page 137: Bayer Bg 12 Packed Format

    Green value for P bits 11 ... 4 Blue value for P bits 11 ... 4 Green value for P bits 3 ... 0 Blue value for P bits 3 ... 0 Green value for P bits 11 ... 4 Basler pilot...
  • Page 138 “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 pilot...

  • Page 139: Yuv 4:2:2 Packed Format (Equivalent To Dcam Yuv 4:2:2)

    U values and V values with unsigned integers, 128 is added to each U value and to each V value before the values are transferred from the camera. This process allows the values to be transferred on a scale that ranges from 0 to 255. Basler pilot...
  • Page 140 • • • • • • 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 Y value for P Basler pilot...
  • Page 141 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. Note The interpolation and conversion algorithms are applied to the averaged pixel values when the averaging feature is used. Basler pilot...

  • Page 142: 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 pilot...
  • Page 143 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. Note The interpolation and conversion algorithms are applied to the averaged pixel values when the averaging feature is used. Basler pilot...

  • Page 144: Mono 8 Format (Equivalent To Dcam Mono 8)

    With the camera set for Mono 8, the pixel data output is 8 bit data of the “unsigned char” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. Basler pilot...
  • Page 145 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 pilot...
  • Page 146 Pixel Data Formats Basler pilot...

  • Page 147: O Control

    Note By default, physical input line 1 is assigned to receive the ExTrig signal. You can assign only one line to receive the ExTrig input signal. Basler pilot...

  • Page 148: Using An Unassigned Input Line To Receive A User Input Signal

    The line assigned to receive the ExTrig input signal can’t be used to receive a user-designed input signal. For more information about using the Line Status and Line Status All parameters, see Section 10.3.1 on page 147 and Section 10.3.2 on page 147. Basler pilot...

  • Page 149: Configuring Output Lines

    Camera.LineSource.SetValue( LineSource_ExposureActive ); Camera.LineSelector.SetValue( LineSelector_Out2 ); Camera.LineSource.SetValue( LineSource_TriggerReady ); 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 150: Setting The State Of User Settable Output Lines

    Camera.UserOutputValue.SetValue( true ); bool currentUserOutput3State = Camera.UserOutputValue.GetValue( ); 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 151: Setting An Output Line For Invert

    // Enable the inverter on output line 1 Camera.LineSelector.SetValue( LineSelector_Out1 ); 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 152: Working With Timers

    Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerTriggerSource.SetValue( TimerTriggerSource_ExposureStart ); 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 153: Setting A Timer Delay Time

    Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDelayRaw.SetValue( 100 ); 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 154: Setting A Timer Duration Time

    Duration Time = (Timer Duration Raw Parameter Value) x (Timer Duration Time Base) By default, the Timer Duration Time Base is fixed at 1 µs. Typically, the duration time is adjusted by setting only the Timer Duration Raw parameter value. Basler pilot...
  • Page 155 Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDurationRaw.SetValue( 100 ); 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 156 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 pilot...

  • Page 157: Checking The State Of The I/O Lines

    Camera.LineSelector.SetValue( LineSelector_Out2 ); bool outputLine2State = Camera.LineStatus.GetValue( ); 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 158 Indicates output line 4 state Indicates output line 3 state Indicates output line 2 state Indicates input line 2 state Indicates output line 1 state Indicates input line 1 state Fig. 42: Line Status All Parameter Bits Basler pilot...

  • Page 159: Features

    Gain Raw All value plus the Gain Raw Tap 2 value. For each camera model, the minimum and maximum allowed Gain Raw and Gain Total settings are shown in the tables below: Basler pilot...
  • Page 160 The sum of the Gain Raw All setting plus the Gain Raw Tap 1 setting must be between 0 and 500 (inclusive). The sum of the Gain Raw All setting plus the Gain Raw Tap 2 setting must be between 0 and 500 (inclusive). Basler pilot...
  • Page 161 Gain on the Right Sensor Half = ( 0.0359 x 450) + (0.0359 x 0) Gain on the Right Sensor Half = 16.2 dB Gain on the Left Sensor Half = ( 0.0359 x 450) + (0.0359 x 0) Gain on the Left Sensor Half = 16.2 dB Basler pilot...

  • Page 162: Setting The Gain

    //Set Gain Raw Tap 2 Camera.GainSelector.SetValue( GainSelector_Tap2 ); Camera.GainRaw.SetValue( 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 163: Black Level

    The sum of the Black Level Raw All setting plus the Black Level Raw Tap 1 setting must be less than or equal to 1023. The sum of the Black Level Raw All setting plus the Black Level Raw Tap 2 setting must also be less than or equal to 1023. Basler pilot...
  • Page 164 //Set Black Level Raw Tap 2 Camera.BlackLevelSelector.SetValue ( BlackLevelSelector_Tap2 ); Camera.BlackLevelRaw.SetValue( 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 165: White Balance (On Color Models)

    Camera.BalanceRatioSelector.SetValue( BalanceRatioSelector_Green ); Camera.BalanceRatioAbs.SetValue( 1.20 ); 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 166: 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 pilot...
  • Page 167 7 through bit 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 pilot...

  • Page 168: 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 pilot...
  • Page 169 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 pilot...

  • Page 170: Precautions When Using Digital Shift

    You can set the Digital Shift parameter values from within your application software by using the pylon API. The following code snippet illustrates using the API to set the parameter values: // Disable digital shift Camera.DigitalShift.SetValue( 0 ); // Enable digital shift by 2 Camera.DigitalShift.SetValue( 2 ); Basler pilot...
  • Page 171 Features 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. For more information about the pylon Viewer, see Section 3.1 on...

  • Page 172: Integrated Ir Cut Filter (On Color Models)

    The location of the IR cut filter limits the length of the threads on any lens you use with the camera. 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. CAUTION Basler pilot...

  • Page 173: Area Of Interest (Aoi)

    One of the main advantages of the AOI feature is that decreasing the height of the AOI can increase the camera’s maximum allowed acquisition frame rate. For more information about how changing the AOI height affects the maximum allowed frame rate, see Section 8.9 on page 102. Basler pilot...
  • Page 174 Normally, the X Offset, Y Offset, Width, and Height parameter settings refer to the physical columns and lines in the sensor. But if binning is enabled, these parameters are set in terms of "virtual" columns and lines. For more information, see Section 11.6 on page 163. Basler pilot...

  • Page 175: Changing Aoi Parameters "On-The-Fly

    = Camera.Height.GetInc(); Camera.Height.SetValue( 200 ); Camera.OffsetY.SetValue( 100 ); 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 176: 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 46 illustrates horizontal bin- ning. Horizontal Binning by 2 Horizontal Binning by 3 Horizontal Binning by 4 Fig. 46: Horizontal Binning Basler pilot...
  • Page 177 // Disable vertical and horizontal binning Camera.BinningVertical.SetValue( 1 ); Camera.BinningHorizontal.SetValue( 1 ); 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 178: Considerations When Using Binning

    And when you set the Y Offset and the Height for the AOI, you will be setting these values in terms of virtual sensor lines. For more informtion about the area of interest (AOI) feature, see Section 11.6 on page 163 Basler pilot...
  • Page 179 If binning is enabled, however, you must use the concept of a "virtual" sensor as described above and the height of the AOI that you use in the formulas would be in terms of virtual sensor lines. The affected formulas appear on page 100 and on page 103. Basler pilot...

  • Page 180: Reverse X

    AOI relative to the sensor remains the same regardless of whether or not the reverse X feature is enabled. As a consequence, an AOI will display different images depending on whether or not the reverse X feature is enabled. Basler pilot...
  • Page 181 AOI will display different images and an Auto Function AOI will refer to different image contents. The positions of the AOIs relative to the sensor will not change. For more information about auto functions, see Section 11.12 on page 180 Basler pilot...
  • Page 182 API to set the parameter value: // Enable reverse X Camera.ReverseX.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 parameter.

  • Page 183: Averaging

    We recommend to only change the feature settings while individual images used for averaging are not acquired. Basler pilot...
  • Page 184 When averaging is used, Formula 3 in the "Maximum Allowed Acquisition Frame Rate" section is replaced by the following formula: × Device Current Throughput Parameter Value Number of Averaged Images Max. Frames/s ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ - Payload Size Parameter Basler pilot...
  • Page 185 Camera.AveragingNumberOfFrames.SetValue( 3 ); // Disable averaging Camera.AveragingNumberOfFrames.SetValue( 1 ); 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 186: 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 sensor output moves from 0 through 2048 and increases gradually as the sensor output moves from 2049 through 4096. Basler pilot...
  • Page 187 Fig. 49: Lookup Table with Values Mapped in a Linear Fashion 4095 3072 12 Bit Camera Output 2048 1024 1024 2048 3072 4095 12 Bit Sensor Reading Fig. 50: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler pilot...
  • Page 188 // Enable the lookup table Camera.LUTEnable.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 189: Gamma

    // Set the Gamma value to 1.2 Camera.Gamma.SetValue( 1.2 ); 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 190: Auto Functions

    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. For more information about binning, see Section 11.7 on page 166. Basler pilot...

  • Page 191: Modes Of Operation

    If an auto function is set to "once" operation mode and if the circumstances will not allow reaching a target value for an image property, the auto function will try to reach the target value for a maximum of 30 images and will then be set to "off". Basler pilot...

  • Page 192: Auto Function Aoi

    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. 51: Auto Function Area of Interest and Image Area of Interest Basler pilot...
  • Page 193 You can use auto functions when also using the reverse X feature. For information about the behavior and roles of Auto Function AOI and Image AOI when also using the reverse X feature, see the "Reverse X" section. Basler pilot...
  • Page 194 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 Auto Function AOI Image AOI Fig. 52: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler pilot...
  • Page 195 API to select an Auto Function AOI and to get the maximum allowed settings for the Width and Height parameters. The code snippets also illustrate setting the X Offset, Y Offset, Width, and Height parameter values. As an example, Auto Function AOI1 is selected: Basler pilot...

  • Page 196: Using An Auto Function

    Camera.AutoFunctionAOIOffsetY.SetValue( 0 ); Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() ); Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() ); 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 197: Gain Auto

    Setting the limits for the Auto Gain Raw parameter value. The currently accessible minimum and maximum parameter values are chosen as examples Setting the target average gray value. A medium gray value is chosen as an example Enabling the gain auto function and selecting, for example, the "once" mode of operation Basler pilot...
  • Page 198 // Set mode of operation for gain auto function Camera.GainAuto.SetValue( GainAuto_Once ); 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 199: Exposure Auto

    7. Enable the exposure auto function by setting it to "once" or "continuous". You must choose the "continuous" setting when using the auto function profile. The settable limits for the Exposure Time Abs parameter value are limited by the minimum allowed and maximum possible exposure time of the camera model. Basler pilot...
  • Page 200 // Set mode of operation for exposure auto function Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); 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 201: Auto Function Profile

    Camera.AutoFunctionProfile.SetValue( AutoFunctionProfile_GainMinimum ); Camera.GainAuto.SetValue( GainAuto_Continuous ); Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); 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 202: Balance White Auto

    // Set position and size of the auto function AOI Camera.AutoFunctionAOISelector.SetValue( AutoFunctionAOISelector_AOI2 ); Camera.AutoFunctionAOIOffsetX.SetValue( 0 ); Camera.AutoFunctionAOIOffsetY.SetValue( 0 ); Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() ); Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() ); // Set mode of operation for balance white auto function Camera.BalanceWhiteAuto.SetValue( BalanceWhiteAuto_Once ); Basler pilot...
  • Page 203 Features 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. For general information about auto functions, see Section 11.12 on page 180.

  • Page 204: Disable Parameter Limits

    Typically, the range of the extended limits is dictated by the physical restrictions of the camera’s electronic devices, such as the absolute limits of the camera’s variable gain control. The values for the extended limits can be seen using the Basler pylon Viewer or from within your application via the pylon API.

  • Page 205: Debouncer

    Fig. 53: Filtering of Input Signals by the Debouncer The debouncer value is determined by the value of the Line Debouncer Time Abs parameter value. The parameter is set in microseconds and can be set in a range from 0 to approximately 1 s. Basler pilot...
  • Page 206 // Set the parameter value to 100 microseconds Camera.LineDebouncerTimeAbs.SetValue( 100 ); 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 207: Trigger Delay

    // 1000us == 1ms == 0.001s; Camera.TriggerDelayAbs.SetValue( TriggerDelay_us ); 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 208: Acquisition Status

    IsWaitingForFrameTrigger = Camera.AcquisitionStatus.GetValue(); 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 Acquisition Status Selector. Basler pilot...

  • Page 209: 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 pilot...

  • Page 210: Making The "Chunk Mode" Active And Enabling The Extended Data Stamp

    Also note that when you enable ChunkModeActive, the PayloadType for the camera changes from "Pylon::PayloadType_Image" to "Pylon::PayloadType_ChunkData". 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 211 = Camera.ChunkHeight.GetValue(); int64_t dynamicRangeMin = Camera.ChunkDynamicRangeMin.GetValue(); int64_t dynamicRangeMax = Camera.ChunkDynamicRangeMax.GetValue(); ChunkPixelFormatEnums pixelFormat = Camera.ChunkPixelFormat.GetValue(); For more information about using the chunk parser, see the sample code that is included with the Basler pylon Software Development Kit (SDK). Basler pilot...

  • Page 212: Frame Counter

    // make chunk mode active and enable Frame Counter chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Framecounter ); Camera.ChunkEnable.SetValue( true ); // retrieve date from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Basler pilot...
  • Page 213 Features Result.GetPayloadSize() ); int64_t frameCounter = Camera.ChunkFramecounter.GetValue(); 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. For more information about the pylon Viewer, see Section 3.1 on...
  • Page 214 Camera.CounterReset.Execute(); // disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); 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. Basler pilot...

  • Page 215: Time Stamp

    // retrieve data from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkTimestamp.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. Basler pilot...

  • Page 216: Trigger Input Counter

    Features You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page 11.17.5Trigger Input Counter The Trigger Input Counter feature numbers external image acquisition triggers sequentially as they are received.
  • Page 217 ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t triggerinputCounter = Camera.ChunkTriggerinputcounter.GetValue(); 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 218 Camera.CounterReset.Execute(); // disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); 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. Basler pilot...

  • Page 219: 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 ); Camera.ChunkEnable.SetValue( true ); Basler pilot...
  • Page 220 ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t lineStatusAll = Camera.ChunkLineStatusAll.GetValue(); 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 221: Crc Checksum

    API to activate the chunk mode, enable the time stamp chunk, run the parser, and retrieve the frame counter chunk data: // Make chunk mode active and enable CRC chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_PayloadCRC16 ); Basler pilot...
  • Page 222 ( ChunkParser.HasCRC() && ! ChunkParser.CheckCRC() ) cerr << "Image corrupted!" << endl; 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 223: Event Reporting

    PC in an event message before the next event is placed in queue. If there is an occasional short term delay in event message transmission, the queue can buffer several events and can send them within a single event message as soon as transmission time is available. Basler pilot...
  • Page 224 API. The pylon software development kit includes a "Camera Events" 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 225: Test Images

    // set for the first test image Camera.TestImageSelector.SetValue( TestImageSelector_Testimage1 ); 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 226 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 4096 Basler pilot...
  • Page 227 The image moves by one pixel from right to left whenever you signal the camera to capture a new image. To display this test pattern on a monitor, you must convert the YUV output from the camera to 8 bit RGB. Fig. 57: Test Image Six Basler pilot...

  • Page 228: 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 Configuration Tool. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
  • Page 229 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 read the parameters and to read or write the Device User ID.

  • Page 230: Configuration Sets

    The default configuration set can be loaded into the active set. The default configuration set can also be selected as the camera’s startup set. Instructions for loading the default set into the active set and for selecting the startup set appear below. Basler pilot...

  • Page 231: Saving User Sets

    API. The following code snippet illustrates using the API to set the selector and execute the command: Camera.UserSetSelector.SetValue( UserSetSelector_UserSet1 ); Camera.UserSetSave.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. Basler pilot...

  • Page 232: Selecting A Factory Setup As The Default Set

    Features You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page 11.21.2Selecting a Factory Setup as the Default Set When the camera is delivered, the Standard Factory Setup will be selected as the default configuration set.

  • Page 233: Loading A Saved Set Or The Default Set Into The Active Set

    The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. Basler pilot...

  • Page 234: Selecting The Startup Set

    Set the User Set Default Selector to User Set 1, User Set 2, User Set 3 or Default. You can set the User Set Default Selector from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector: Camera.UserSetDefaultSelector.SetValue( UserSetDefaultSelector_Default ); Basler pilot...

  • Page 235: Troubleshooting And 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 236: Before Contacting Basler Technical Support

    12.2 Before Contacting Basler Technical Support To help you as quickly and efficiently as possible when you have a problem with a Basler camera, it is important that you collect several pieces of information before you contact Basler technical support.
  • Page 237 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 Basler’s pylon Viewer tool.
  • Page 238 Troubleshooting and Support Basler pilot...

  • Page 239: Revision History

    24 May 2007 First release covering production cameras. AW00015104000 8 June 2007 Modified Section 2 for the installation of the Basler pylon software, version 1.0. AW00015105000 19 July 2007 Integrated the Kodak KAI-2093 sensor. Minor corrections throughout the manual. Added information on IP30 in Section 1.2.
  • Page 240 Included the warning related to code snippets in Section 1.9 on page Transferred to following sections to the "Installation and Setup Guide for Cameras Used with Basler’s pylon API": "Software and Hardware Installation", "Network Recommendations", and "Camera and Network Adapter IP Configuration".
  • Page 241 Minor modifications and corrections throughout the manual. AW00015114000 22 Aug 2008 Updated contact addresses and phone numbers. Official release of the averaging feature and of the auto functions. AW00015115000 30 Sep 2008 Added information for the new piA2400-17gm/gc models. Basler pilot...
  • Page 242 Removed the statement that settings for frame transmission delay and inter packet delay are not saved in the user sets in Section 11.21 on page 220. Added Section 12.1 on page 225 describing how to obtain an RMA number. Basler pilot...

  • Page 243: Feedback

    Feedback Feedback Your feedback will help us improve our documentation. Please click the link below to access an online feedback form. Your input is greatly appreciated. http://www.baslerweb.com/umfrage/survey.html Basler pilot...
  • Page 244 Feedback Basler pilot...

  • Page 245: Index

    ....205 ..............45 chunk trigger input counter parameter... 206 bandwidth reserve parameter....45 chunk width parameter ......200 bandwidth, managing .......50 cleaning the camera and sensor....26 Bayer BG 12 packed pixel format...127 code snippets, proper use ....... 25 Basler pilot...
  • Page 246 ......... 149 controlling with an ExTrig signal ..84 setting..........149 overlapped .........94 gain auto..........187 exposure active signal ......98 gain raw all ..........149 exposure auto ........189 gain raw tap 1 ........149 gain raw tap 2 ........149 Basler pilot...
  • Page 247 ....2, 4, 6 lens adapter........2, 4, 6 output frame rate ........174 lens thread length........20 output line level controlled exposure mode....85 voltage requirements ......73 line inverter parameter ......141 line selector ..........139 line source parameter......139 Basler pilot...
  • Page 248 ....68, 70 support........... 226 precautions ..........25 programmable exposure mode with an external trigger signal ....85 protection class ........14, 17 pylon API..........30 target value..........180 pylon Viewer ..........29 technical support ........225 temperature ..........24 test image selector ........ 215 Basler pilot...
  • Page 249 ....85 user configuration set ......221 user output selector........140 user output value parameter ....140 ventilation ..........24 vertical binning ........166 viewer ............29 weight ..........3, 5, 7 white balance explained..........155 setting..........155 white balance auto see balance white auto write timeout parameter......41 Basler pilot...
  • Page 250 Index Basler pilot...

This manual is also suitable for:

Pilot seriesPilot pia640-210gmPilot pia640-210gcPilot pia1000-48gmPilot pia1000-48gcPilot pia1600-35gm ... Show all

Table of Contents