Basler acA2040-55 User Manual
  1. Manuals
  2. Brands
  3. Basler Manuals
  4. Digital Camera
  5. acA2040-55
  6. User manual

Basler acA2040-55 User Manual

Basler ace
Hide thumbs
Table of Contents

Advertisement

Quick Links

Basler ace
USER'S MANUAL FOR USB 3.0 CAMERAS
Document Number: AW001234
Version: 09 Language: 000 (English)
Release Date: 18 November 2016
The manual includes information about the following
prototype cameras: acA2040-55, acA2040-120,
acA2440-35, and acA2440-75.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the acA2040-55 and is the answer not in the manual?

Questions and answers

Related Manuals for Basler acA2040-55

Summary of Contents for Basler acA2040-55

  • Page 1 Basler ace USER’S MANUAL FOR USB 3.0 CAMERAS Document Number: AW001234 Version: 09 Language: 000 (English) Release Date: 18 November 2016 The manual includes information about the following prototype cameras: acA2040-55, acA2040-120, acA2440-35, and acA2440-75.
  • 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...
  • Page 3 Operate acA1920-150um/uc (order numbers 106758, 106760) and acA2500-60um/uc (order numbers 106742, 106744) cameras continuously under constant ambient temperature. Read the manual Read the manual carefully before using the camera. All material in this publication is subject to change without notice and is copyright Basler AG.
  • Page 4 Contacting Basler Support Worldwide Europe, Middle East, Africa Basler AG An der Strusbek 60–62 22926 Ahrensburg Germany Tel. +49 4102 463 515 Fax +49 4102 463 599 support.europe@baslerweb.com The Americas Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA 19341 Tel.

  • Page 5: Table Of Contents

    Basler pylon Camera Software Suite ........
  • Page 6 5.13.2 Line Status for Output Lines ........105 Basler ace USB 3.0...
  • Page 7 Sensor Readout Mode........144 Basler ace USB 3.0...
  • Page 8 6.10 Maximum Allowed Frame Rate ......... 178 6.10.1 Using Basler pylon to Check the Maximum Allowed Frame Rate ..180 6.10.2 Increasing the Maximum Allowed Frame Rate .
  • Page 9 7.15.6 Auto Function Profile ......... . . 307 Basler ace USB 3.0...
  • Page 10 Obtaining an RMA Number ..........350 Before Contacting Basler Technical Support ....... 351 Revision History .

  • Page 11: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. Models The current Basler ace USB 3.0 camera models are listed in the top row of the specification tables on the next pages of this manual. The camera models are differentiated by their resolution, their maximum frame rate at full or default resolution, and whether the camera’s sensor is mono or color.

  • Page 12: Specification Notes

    For information about enabling and configuring the DeviceLinkThroughputLimit parameter, see Section 7.19 on page 322. For more information about the maximum allowed frame rate and how to increase it, see Section 6.10 on page 178 and Section 6.10.2 on page 181, respectively. Basler ace USB 3.0...
  • Page 13 ReverseX nor ReverseY are enabled. Different effective alignments apply when ReverseX and/or ReverseY are enabled. For more information about the ReverseX and ReverseY features and related effective Bayer filter alignments, see Section 7.11 on page 260. Basler ace USB 3.0...

  • Page 14: General Specifications

    ≈ 3.0 W (max.) I/O Lines 1 opto-isolated input line, 1 opto-isolated output line, and 2 direct-coupled GPIO lines; power supplies must meet the SELV and LPS requirements Lens Mount C-mount, CS-mount Table 1: General Specifications Basler ace USB 3.0...
  • Page 15 Conformity CE (includes RoHS), UL Listed, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 16 CE (includes RoHS), UL Listed, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Table 2: General Specifications...
  • Page 17 AW00123409000 Specifications, Requirements, and Precautions Specification acA1300-30um/uc acA1600-20um/uc Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM). Table 2: General Specifications Basler ace USB 3.0...

  • Page 18: Cameras With Cmos Sensor

    Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 19 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 20 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 21 Conformity CE (includes RoHS), UL Listed, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 22 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 23 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 24 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 25 Conformity CE (includes RoHS), UL Listed, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 26 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 27 Conformity CE (includes RoHS), UL Listed, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 28 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 29 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 30 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 31 Conformity CE (includes RoHS), UL Listed, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 32 Conformity CE (includes RoHS), UL in preparation, FCC, GenICam V. 2.x (includes PFNC V. 2.x and SFNC V. 2.x), IP30, USB3 Vision, USB-IF in preparation, REACH The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM).
  • Page 33 The EU Declaration of Conformity is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher) Available for Windows (x86, x64) and Linux (x86 32 bit, x86 64 bit, ARM). Table 18: General Specifications Basler ace USB 3.0...

  • Page 34: Accessories

    AW00123409000 Accessories Fig. 1: Basler Accessories Basler’s cooperation with carefully selected suppliers means you get accessories you can trust which makes building a high-performance image processing system hassle-free. Key Reasons for Choosing Lenses, Cables, and Other Accessories from Basler Perfect match for Basler cameras ...

  • Page 35: Spectral Response

    The following graphs show the spectral response for each available monochrome camera model. The spectral response curves exclude lens characteristics and light source characteristics. 1.5.1.1 Cameras with CCD Sensor Wavelength (nm) Fig. 2: acA640-90um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 36 Specifications, Requirements, and Precautions AW00123409000 Wavelength (nm) Fig. 3: acA640-120um Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 4: acA1300-30um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...

  • Page 37: Cameras With Cmos Sensor

    Specifications, Requirements, and Precautions Wavelength (nm) Fig. 5: acA1600-20um Spectral Response (From Sensor Data Sheet) 1.5.1.2 Cameras with CMOS Sensor 1000 1100 Wavelength (nm) Fig. 6: acA640-750um, acA800-510um, acA1300-200um, acA1920-150um, and acA2500-60um, Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 38 Specifications, Requirements, and Precautions AW00123409000 1050 1150 Wavelength (nm) Fig. 7: acA1920-25um Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 8: acA1920-40um and acA1920-155um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 39 50 0 60 0 70 0 8 00 9 00 1 000 Wavelength (nm) Fig. 9: acA2000-165um, acA2040-90um Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 10: acA2000-165umNIR, acA2040-90umNIR Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 40 Specifications, Requirements, and Precautions AW00123409000 Wavelength (nm) Fig. 11: acA2040-55um, acA2040-120um, acA2440-35um, and acA2440-75um (From Sensor Data Sheet) 1050 1150 Wavelength (nm) Fig. 12: acA2500-14um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 41 AW00123409000 Specifications, Requirements, and Precautions 1000 Wavelength (nm) Fig. 13: acA3800-14um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...

  • Page 42: Color Camera Spectral Response

    A suitable IR cut filter is built into the cylindric housing extension in color models of the camera. 1.5.2.1 Cameras with CCD Sensor Blue Green Wavelength (nm) Fig. 14: acA640-90uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 43 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 15: acA640-120uc Spectral Response (From Sensor Data Sheet) Blue Green 4 00 5 00 60 0 Wavelength (nm) Fig. 16: acA1300-30uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...

  • Page 44: Cameras With Cmos Sensor

    Wavelength (nm) Fig. 17: acA1600-20uc Spectral Response (From Sensor Data Sheet) 1.5.2.2 Cameras with CMOS Sensor Blue Green 1000 1100 Wavelength (nm) Fig. 18: acA640-750uc, acA800-510uc, acA1300-200uc, acA1920-150uc, and acA2500-60uc, Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 45 AW00123409000 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 19: acA1920-25uc Spectral Response (From Sensor Data Sheet) Blue Green 1000 Wavelength (nm) Fig. 20: acA1920-40uc and acA1920-155uc (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 46 Specifications, Requirements, and Precautions AW00123409000 Blue Green Wavelength (nm) Fig. 21: acA2000-165uc, acA2040-90uc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 22: acA2040-55uc, acA2040-120uc, acA2440-35uc, and acA2440-75uc (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 47 AW00123409000 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 23: acA2500-14uc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 24: acA3800-14uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 48 Specifications, Requirements, and Precautions AW00123409000 Blue Green Wavelength (nm) Fig. 25: acA4600-10uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...

  • Page 49: Mechanical Specifications

    Note that some camera models are not available with CS-mount. For details, see Section 1.3.2 on page Camera housings are equipped with mounting screw holes on the bottom as shown in the drawings. For mounting instructions, see Section 1.7 on page Basler ace USB 3.0...
  • Page 50 16.5 22 (dimension for M2) Photosensitive surface of the sensor 20.7 17.526 29.3 14.5 41.3 2 x M2; 4 deep Reference Plane Not to Scale Fig. 26: Mechanical Dimensions (in mm) for Cameras with the C-mount Basler ace USB 3.0...
  • Page 51 11.5 22 (dimension for M2) Photosensitive surface 12.526 of the sensor 20.7 29.3 14.5 36.3 2 x M2; 4 deep Reference Plane Not to Scale Fig. 27: Mechanical Dimensions (in mm) for Cameras with the CS-mount Basler ace USB 3.0...

  • Page 52: Maximum Allowed Lens Thread Length

    Note that on color cameras, the filter holder is populated with an IR cut filter. On monochrome cameras, the filter holder is present, but is not populated with an IR cut filter. You can obtain lenses with correct thread lengths from Basler (see www.baslerweb.com). Basler ace USB 3.0...
  • Page 53 Filter Holder (mono and color cameras) (4.6) CS-mount Lens IR Cut Filter (color cameras only) Unthreaded Thread: 4.6 Max 5.8 Max Not to Scale Fig. 29: Maximum Lens Thread Length (Dimensions in mm) for Cameras with the CS-mount Basler ace USB 3.0...

  • Page 54: Mounting Instructions

    1. Tighten the screws for the mounting screw holes (a) in Figure 2. Tighten the screws for the mounting screw holes (b) in Figure Bottom Fig. 30: Designations of the Mounting Screw Holes for the M2 Screws. Basler ace USB 3.0...

  • Page 55: Tightening Sequence When Using The M3 Screws

    1. Tighten the screws for the mounting screw holes (a) in Figure 2. Tighten the screw for mounting screw hole (b) in Figure Bottom Fig. 31: Designations of the Mounting Screw Holes for the M3 Screws. Basler ace USB 3.0...

  • Page 56: Mechanical Stress Test Results

    The mechanical stress tests were performed with a dummy lens connected to a C-mount. The dummy lens was 35 mm long and had a mass of 66 g. Using a heavier or longer lens requires an additional support for the lens. Basler ace USB 3.0...

  • Page 57: 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 ace USB 3.0...

  • Page 58: 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 59: Environmental Requirements

    You must determine the camera housing temperature on a specific measuring spot. Its location on the camera housing is indicated in the figure below. Housing temperature measuring spot Fig. 32: Location of the Housing Temperature Measuring Spot on the Camera Housing Basler ace USB 3.0...

  • Page 60: Heat Dissipation

    To ensure good image quality, we recommend not to operate the camera at elevated temperatures. Basler ace USB 3.0...

  • Page 61: Over Temperature Behavior

    The lifetime is also shortened with increasing number of high- temperature incidents. When the device temperature climbs above 74 °C the following changes occur:  the TemperatureState parameter value changes to Critical and  the Critical Temperature event is sent.  Basler ace USB 3.0...
  • Page 62 Instead, test image 2 is generated (see Section 7.18.1 on  page 319). Note that another Over Temperature event can only be sent after the device temperature has fallen to at least 77 °C (170.6 °F; see Figure 33). Basler ace USB 3.0...
  • Page 63 (177.8 °F) Event 80 °C (176.0 °F) 77 °C (170.6 °F) 75 °C Critical Temperature (167.0 °F) Event 74 °C (165.2 °F) 71 °C (159.8 °F) Fig. 33: Over Temperature Behavior for Heating and Cooling Paths. Basler ace USB 3.0...
  • Page 64 77 °C. After a Critical Temperature event was sent, another Critical Temperature  event can only be sent after the device temperature has fallen to at least 71 °C. Basler ace USB 3.0...

  • Page 65: Monitoring The Internal Temperature

    // Determine the current temperature state TemperatureStateEnums e = camera.TemperatureState.GetValue(); You can also use the Basler pylon Viewer application to easily read the parameter. For more information about the pylon API and the pylon Viewer, see Section 3.1 on page...

  • Page 66: Precautions

    Voltage outside of the specified range can cause damage. You must supply camera power that complies with the Universal Serial Bus 3.0 specification.  The camera’s nominal operating voltage is +5 VDC, effective on the camera’s connector. Basler ace USB 3.0...
  • Page 67 For more specific information about the lens thread length, see Section 1.6.2 on page NOTICE Using a wrong pin assignment can severely damage the camera: Make sure the cable and plug you connect to the 6-pin I/O connector follow the correct pin  assignment. Basler ace USB 3.0...
  • Page 68 Because electrostatic discharge can damage the camera, you must use a cloth that won’t  generate static during cleaning (cotton is a good choice). Do not use solvents or thinners. They can damage the surface finish.  Basler ace USB 3.0...

  • Page 69: Installation

    LPS requirements. The camera is designed to be connected to a USB 3.0 port installed in your computer. When connected to a USB 2.0 port, the Basler ace USB 3.0 camera will be detected but will not operate.
  • Page 70 For more information and recommended powerful chipsets see the Application Note USB 3.0 Host Controllers’ Maximum Bandwidth Measurements (AW001260). You can download the document free of charge from the the Basler website: www.baslerweb.com. Default factory parameter settings for acA2000-165u and acA2040-90u cameras initially prevent them from operating at their maximum specified frame rates.

  • Page 71: Tools For Changing Camera Parameters

    Parameters Basler pylon Camera Software Suite The Basler pylon Camera Software Suite is designed to operate all Basler cameras that have an IEEE 1394a/b interface, a GigE interface or a USB 3.0 interface. The Basler pylon Camera Software Suite will also operate newer Basler camera models with a Camera Link interface.

  • Page 72: Pylon Usb Configurator

    3.1.2 pylon USB Configurator The pylon USB Configurator is included in the Basler pylon Camera Software Suite besides the Basler pylon IP Configurator and the Basler pylon Camera Link Configurator. The pylon USB Configurator is a standalone application. It allows you to obtain information about the architecture of the device tree to which your camera is connected ...

  • Page 73: Camera Functional Description

    Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the USB 3.0 interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
  • Page 74 Frame Trigger Wait Signal or Exposure Active Signal or Buffer Timer 1 Signal Image Image Data Data FPGA Sensor Controller Computer Image and Image Control Data Control Power Data Control: Gain, Black Level Control: ROI Fig. 35: Camera Block Diagram Basler ace USB 3.0...

  • Page 75: Overview For Cameras With Cmos Sensor

    Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the USB 3.0 interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
  • Page 76 Timer 1 Signal *not available for acA3800-14 and aA4600-10 cameras Image Image Data Data Sensor Controller FPGA Computer Image and Image Control Data Control Power Data Control: ROI, Gain, Black Level Fig. 37: Camera Block Diagram Basler ace USB 3.0...

  • Page 77: Physical Interface

    The chapter also includes information abut the required cables connecting to the camera. Note that Basler recommends specific external components - host adapters, cables, hubs - for use with Basler ace USB 3.0 cameras. For recommended external components, see the Basler website: www.baslerweb.com...

  • Page 78: Camera Connector Pin Numbering And Assignments

    Line 1 Opto-isolated I/O IN Line 4 Direct-coupled General Purpose I/O (GPIO) Line 2 Opto-isolated I/O OUT Ground for opto-isolated I/O Ground for direct-coupled GPIO Table 20: Pin Assignments for the 6-pin Connector and Related Designations Basler ace USB 3.0...

  • Page 79: Usb 3.0 Micro-B Port Pin Numbering And Assignments

    The USB 3.0 Micro-B port for the camera’s USB 3.0 connection is a standard Micro-B USB 3.0 connector with screw lock. The recommended mating connector is any standard Micro-B USB 3.0 plug. Suitable cables terminated with screw-lock connectors are available from Basler. Contact your Basler sales representative to order cable assemblies. LED Indicator...

  • Page 80: Camera Cabling Requirements

    5.5.1 USB 3.0 Cable Use a high-quality USB 3.0 cable. If possible only use a cable that was obtained from Basler. To avoid EMI, the cable must be shielded. Close proximity to strong high-frequency electromagnetic fields should be avoided in your installation.

  • Page 81: Camera Power

    The power supply used for supplying camera power must meet the Limited Power Source (LPS) requirements. A suitable power supply is available from Basler. Contact your Basler sales representative to order a power supply. If you use a powered hub as part of the USB 3.0 connection, the powered hub must meet the LPS requirements.

  • Page 82: Opto-Isolated Input (Pin 2/Line 1)

    The power supply used must meet the Safety Extra Low Voltage (SELV) and Limited Power Source (LPS) requirements. A suitable power supply is available from Basler. Contact your Basler sales representative to order a power supply. Basler ace USB 3.0...
  • Page 83 (Section 5.9 on page 77). for the I/O input lines of Basler ace USB 3.0 cameras can differ from the safe operating  voltage ranges for the I/O input lines of other Basler cameras. You must supply power within the safe operating voltage range.

  • Page 84: Opto-Isolated Output (Pin 4/Line 2)

    The opto-isolated output line has the advantage of being distinctly more robust against EMI than a GPIO line used as an output. However, when using the opto- isolated output line, the delays involved are longer than for a GPIO line. Basler ace USB 3.0...

  • Page 85: Electrical Characteristics

    (see Section 5.7.1 on page 72). The safe operating I/O supply voltage range for the I/O output lines of Basler ace USB 3.0  cameras can differ from the safe operating voltage ranges for the I/O output lines of other Basler cameras.
  • Page 86 Ground for Opto-isolated I/O 6-pin Receptacle +3.3 to +24 Camera Voltage Output Signal to You Ground for Opto-isolated I/O Fig. 41: Opto-isolated Output Line Schematic with a Typical Voltage Output Circuit (Simplified) Basler ace USB 3.0...

  • Page 87: Direct-Coupled General Purpose I/O (Gpio; Pin 1/Line 3, Pin 3/Line 4)

    The direct-coupled GPIO lines are compatible with TTL signals. The next sections describe the differences in the GPIO electrical functionality when the lines are set to operate as inputs and when they are set to operate as outputs. Basler ace USB 3.0...
  • Page 88 Risk of Burn or Death. The power supply used must meet the Safety Extra Low Voltage (SELV) and Limited Power Source (LPS) requirements. A suitable power supply is available from Basler. Contact your Basler sales representative to order a power supply. WARNING...

  • Page 89: Setting A Gpio Line For Input Or Output

    You can set the LineSelector and LineMode parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to select a GPIO line and to set the LineMode parameter value. As an example, the code snippet assumes that you...

  • Page 90: Operation As An Input

    3 (Line 4). The figure shows, as an example, the use of a TTL or CMOS logic gate in the external circuit. A different example for an external circuit is shown in Figure 44. Basler ace USB 3.0...
  • Page 91 (Illustration for Pin 1 as an Example; Simplified) For more information about GPIO pin assignments and pin numbering, see Section 5.2.1 on page For more information about setting the GPIO line operation, see Section 5.11 on page 91 Section 5.12 on page Basler ace USB 3.0...

  • Page 92: Operation As An Output

    When the direct-coupled GPIO line is in the "on" state, the residual voltage will typically be  approximately 0.4 V at 50 mA and 25 °C housing temperature. The actual residual voltage, however, depends on camera operating temperature, load current, and production spread. Basler ace USB 3.0...
  • Page 93 Output Circuit (Illustration for Pin 1 as an Example; Simplified) For more information about GPIO pin assignments and pin numbering, see Section 5.2.1 on page For more information about setting the GPIO line operation, see Section 5.11 on page 91 Section 5.12 on page Basler ace USB 3.0...

  • Page 94: Temporal Performance Of I/O Lines

    For each analog signal, the rising edge and the falling edge are associated with different  propagation delays. The edge with the shorter propagation delay (the "fast" edge) is indicated in the figures by an asterisk. For recommendations for use, see Section on page Basler ace USB 3.0...
  • Page 95  signal using the active high state. As a general rule of thumb, an external trigger pulse width of 100 µs should be long enough for most cases. Basler ace USB 3.0...
  • Page 96 #: 3.3 - 24 VDC for opto-isolated input, >2.0 - 5.0 VDC for direct-coupled GPIO IN Fig. 46: Analog External Signal and Associated Internal Line Status with Propagation Delays for Opto-isolated Input and Direct-coupled GPIO Inputs (Line Inverters Disabled) Basler ace USB 3.0...
  • Page 97 = Propagation delay for the high-low line status change Drawing not to scale Opto-isolated OUT Direct-coupled GPIO OUT Time Fig. 47: Internal Line Status and Associated Output Signals with Propagation Delays for Opto-isolated Output and Direct-coupled GPIO Outputs (Line Inverters Disabled) Basler ace USB 3.0...

  • Page 98: Factors Determining I/O Temporal Performance

    Among the insight that can be gained from Table 25 is the fact, that production spread can result in different propagation delays even for cameras that were produced in one batch and that are operated under identical conditions. Basler ace USB 3.0...
  • Page 99 To avoid jitter, make sure the rise and fall times of your trigger signals are short, preferably < 500 ns. The camera’s inherent jitter is less than 100 ns, peak to peak. Basler ace USB 3.0...

  • Page 100: Measured Propagation Delays

    (rising edge) = 170 Ω, U Table 27: Propagation Delays for the Camera Outputs (+25 °C, R = 5 VDC, Transition Threshold = 2.0 V) For the graphical illustration of propagation delays, see Figure 46 Figure Basler ace USB 3.0...

  • Page 101: Configuring Input Lines And Signals

    1 reset and for details about how the counter value chunk feature operates, see  Section 7.23.3.6 on page 344. By default, input line Line 1 is selected as the source signal for the frame start trigger. Basler ace USB 3.0...

  • Page 102: Input Line Debouncers

    The diagram also illustrates how the line debouncer delays a valid signal. Unfiltered arriving signals Debouncer debouncer value Transferred valid signal delay Timing charts are not drawn to scale Fig. 48: Filtering of Input Signals by the Line Debouncer Basler ace USB 3.0...
  • Page 103 You can set the Line Selector and the value of the Line Debouncer Time 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 104: Input Line Inverter

    // Enable the line inverter on the selected line camera.LineInverter.SetValue(true); 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.1 on page 61...

  • Page 105: Configuring Output Lines And Signals

    You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace USB 3.0...

  • Page 106: Line Minimum Output Pulse Width

    Line Minimum Output Pulse Width feature will have no effect. The signal will be sent out of the camera with unmodified signal width. Without signal With signal width increase width increase Output signal Minimum output width (max. 100 µs) Not to Scale Fig. 49: Increasing the Signal Width of an Output Signal Basler ace USB 3.0...
  • Page 107 // Set the parameter value to 10.0 microseconds camera.LineMinimumOutputPulseWidth.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 108: Setting The Status Of An Individual User Settable Output Line

    You can set the OutputSelector and the UserOutputValue parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to designate an output line as user settable, set the status of the output line, and get informed about...

  • Page 109: Setting And Checking The Status Of All User Settable Output Lines

    You can set and check the current status of all output lines with a single operation by using the UserOutputValueAll parameter value. The UserOutputValueAll parameter value is expressed as a hexadecimal number in the Basler pylon Viewer and as a 32-bit word in the Basler pylon API (with 0 as a constant value on bit 0).

  • Page 110: Output Line Inverter

    // Enable the line inverter on output line Line 2 camera.LineSelector.SetValue(LineSelector_Line2); camera.LineInverter.SetValue(true); 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.1 on page...

  • Page 111: Working With The Timer Output Signal

    1. Use the Timer Selector to select Timer 1. 2. Set the value of the TimerTriggerSource parameter to Exposure Start. This will set the selected timer to use the start of exposure to start Timer 1. Basler ace USB 3.0...

  • Page 112: Setting The Timer Delay Time

    2. Set the value of the TimerDelay parameter. You can set the TimerSelector and the TimerDelay 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: camera.TimerSelector.SetValue(TimerSelector_Timer1);...

  • Page 113: Setting The Timer Duration Time

    2. Set the value of the TimerDuration parameter. You can set the TimerSelector and the TimerDuration 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.TimerSelector.SetValue(TimerSelector_Timer1);...
  • Page 114 Voltage Level High True Enabled Input Open or False Connection at z Status Voltage Level Low True Voltage Level High False Table 29: Line Status for Different External Conditions: Line 3, Line 4 (Direct-coupled GPIO Input) Basler ace USB 3.0...

  • Page 115: Line Status For Output Lines

    Make sure the ground for opto-isolated I/O and the ground of the power supply for the opto-isolated output line are connected to the same ground. For applicable pins, see Table 20 on page 68, and for line schematics, see Figure Figure Figure Basler ace USB 3.0...
  • Page 116 False Enabled Disabled False Enabled True High Pull-Up Disabled Disabled True High Disconnected Enabled False Enabled Disabled False Enabled True High Table 31: Line Status for Different External Conditions: Lines 3 and 4 (Direct-coupled GPIO Output) Basler ace USB 3.0...

  • Page 117: Checking I/O Line Status

    GPIO line for input or output. The LineStatusAll parameter value is expressed as a hexadecimal number in the Basler pylon Viewer and as a 32-bit word that you can read using the Basler pylon API. As shown in Figure 53, each bit from bit 0 through 3 is associated with a different I/O line.

  • Page 118: Checking The Status Of An Individual I/O Line

    "false" means the line’s status is currently low. You can set the LineSelector and read the LineStatus 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 read the parameter value: // Select output line Line 2 and read the status camera.LineSelector.SetValue(LineSelector_Line2);...

  • Page 119: Image Acquisition Control

    If the Acquisition Mode parameter is set to Single Frame, you can only acquire one frame after executing an Acquisition Start command. When one frame has been acquired, the Acquisition Start command will expire. Before attempting to acquire another frame, you must execute a new Acquisition Start command. Basler ace USB 3.0...
  • Page 120 A new frame start trigger signal can then be applied to the camera to begin another frame exposure. The Trigger Mode parameter with parameter values off and on has a direct bearing on how the Frame Start Trigger works. Basler ace USB 3.0...
  • Page 121 "waiting for frame start trigger" status Acquisition Burst Frame Count parameter setting = 3 Acquisition Acquisition Start Stop Command Command Executed Executed Frame Burst Start Trigger Signal Frame Start Trigger Signal Time Fig. 54: Frame Burst Start and Frame Start Triggering Basler ace USB 3.0...
  • Page 122 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 frame burst start trigger or the frame start trigger.

  • Page 123: Acquisition Start And Stop Commands And The Acquisition Mode

    The camera will retain the ability to acquire frames until an Acquisition Stop command is executed. Once the Acquisition Stop command is received, the camera will no longer be able to acquire frames. Basler ace USB 3.0...
  • Page 124 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, where Line 1 is taken as an example.

  • Page 125: The Frame Burst Start Trigger

    "waiting for frame burst 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 Basler ace USB 3.0...
  • Page 126 Software Signal 1, Software Signal 2, Software Signal 3 (the latter is not available on  acA1920-155, acA2040-55, acA2040-120, acA2440-35, and acA2440-75 cameras) – Specific software commands, analogous to the Software command. Line 1 – When the source signal is set to Line 1, you apply a frame burst start trigger signal to ...

  • Page 127: Acquisition Burst Frame Count

    You can set the Trigger Mode and Trigger Source parameters for the frame burst start trigger and also set the Acquisition Burst Frame Count parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the Trigger Mode to on, the Trigger...

  • Page 128: Using A Software Frame Burst Start Trigger

    // Set the acquisition burst frame count camera.AcquisitionBurstFrameCount.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.1 on page 6.3.4...

  • Page 129: Setting The Parameters Related To Software Frame Burst Start Triggering And Applying A Software Trigger Signal

    You can set all of the parameters needed to perform software frame burst 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 burst...

  • Page 130: Using A Hardware Frame Burst Start Trigger

    ExFBTrig signal, see Section 6.3.5.2. For more information about the electrical characteristics of Line 1, see Section 5.7.1 on page and of GPIO Line 3 and Line 4, set for input, see Section 5.9.3.1 on page Basler ace USB 3.0...

  • Page 131: Setting The Parameters Related To Hardware Frame Burst Start Triggering And Applying A Hardware Trigger Signal

    You can set all of the parameters needed to perform hardware frame burst 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 frame burst start...

  • Page 132: The Frame Start Trigger

    If the parameter is enabled and is set to a value less than the maximum allowed frame rate  with the current camera settings, the camera will generate frame start trigger signals at the rate specified by the parameter setting. Basler ace USB 3.0...

  • Page 133: Frame Start Trigger Mode = On

    Software Signal 1, Software Signal 2, Software Signal 3 (the latter is not available on  acA1920-155, acA2040-55, acA2040-120, acA2440-35, and acA2440-75 cameras) – Specific software commands, analogous to the Software command. Line 1 – When the source signal is set to Line 1, you apply a frame start trigger signal to the ...

  • Page 134: Setting The Frame Start Trigger Mode And Related Parameters

    Otherwise, the camera might crash. 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 TriggerSource parameter.
  • Page 135 // Start frame capture Camera.AcquisitionStart.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.1 on page Basler ace USB 3.0...

  • Page 136: Using A Software Frame Start Trigger

    Section 6.4.2.2 on page 127 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 6.10 on page 178.

  • Page 137: 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 acquisition mode.

  • Page 138: Using A Hardware Frame Start Trigger

    // a Trigger Software command will apply a software frame 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.1 on page 6.4.3...

  • Page 139: Exposure Modes

    ExFSTrig signal falls. Figure 56 illustrates timed exposure with the camera set for rising edge triggering. ExFSTrig Signal Period ExFSTrig Signal Exposure (duration determined by the ExposureTime parameter) Fig. 56: Timed Exposure with Rising Edge Triggering Basler ace USB 3.0...
  • Page 140 Frame Trigger Wait signal. You should set the ExposureOverlapTimeMax parameter value to represent the shortest exposure time you intend to use. For example, assume that you will be using trigger width exposure mode Basler ace USB 3.0...
  • Page 141 The following cameras provide an exposure time offset: acA640-750, acA800-510, acA1300-200, acA1920-40, acA1920-150, acA1920-155, acA2000-165, acA2040-55, acA2040-90, acA2040-120, acA2440-35, acA2440-75, acA2500-60. Accordingly, when trigger width exposure mode is selected, the exposure time for each frame...
  • Page 142 56.5 acA2500-60 56.5 acA1920-40 acA1920-155 acA2000-165, All allowed values acA2040-90 Table 32: Exposure Time Offset, C , Depending on Pixel Format Bit Depth and Device Link Throughput Basler ace USB 3.0...
  • Page 143 Offset Adjustment Offset-adjusted ExFSTrig Signal Exposure, Controlled by Timing-adjusted Exposure, controlled by ExFSTrig Signal Exposure Time Offset; C Exposure (Total; Wanted) Fig. 60: Trigger Width Exposure with Adjusted Rising Edge Triggering; (Exposure Start Delay Is Omitted) Basler ace USB 3.0...
  • Page 144 ExposureOverlapTimeMax parameter. Its parameter setting is used to operate the Frame Trigger Wait signal. For acA640-750, acA800-510, acA1300-200, acA1920-40, acA1920-150, acA1920-155, acA2040-55, acA2040-120, acA2440-35, acA2440-75, and acA2500-60 cameras, the ExposureOverlapTimeMax parameter is used in the context of exposure overlap time modes. For more information, see the next section.
  • Page 145 Note that the Frame Trigger Wait signal is not available when the Automatic mode is selected. The Automatic mode is the default mode. You can use the Basler pylon API to set the Exposure Overlap Time Modes and the Exposure OverlapTimeMax parameter value from within your application software. The following code snippet...

  • Page 146: 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 acquisition mode with the trigger mode for the frame burst start trigger set to off.
  • Page 147 Camera.TriggerMode.SetValue( TriggerMode_On ); // Set the source for the selected trigger camera.TriggerSource.SetValue ( TriggerSource_Line1 ); // Set the trigger activation mode to rising edge camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); // Set for the trigger width exposure mode camera.ExposureMode.SetValue( ExposureMode_TriggerWidth ); Basler ace USB 3.0...
  • Page 148 // 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 pylon Viewer, see Section 3.1 on page...

  • Page 149: Setting The Exposure Time

    Exposure Auto function is disabled. For more information about auto functions in general, see Section 7.15 on page 294. For more information about the Exposure Auto function in particular, see Section 7.15.5 on page 304. Basler ace USB 3.0...

  • Page 150: Exposure Times For All Models Except The Aca2000-165 And Aca2040-90

    10000000 acA2440-35um/uc 10000000 acA2440-75um/uc 10000000 acA2500-14um/uc 9999990 acA2500-60um/uc 100000 acA3800-14um/uc 1600000 acA4600-10uc 1460000 Table 33: Minimum Allowed Exposure Time Settings for All Pixel Format Bit Depths Unless Indicated Otherwise, Maximum Possible Exposure Time Settings and Increments. Basler ace USB 3.0...

  • Page 151: Exposure Times For The Aca2000-165 And Aca2040-90

    6.5.3 Setting the Parameter Value You can use the Basler pylon API to set the ExposureTime 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 3500 µs camera.ExposureTime.SetValue(3500.0);...

  • Page 152: Electronic Shutter Operation

    The sensor readout time (see Figure 61) is the sum of the line readout times and therefore also depends on ROI height. You can determine the readout time for a frame by checking the value of the camera’s SensorReadoutTime parameter. Basler ace USB 3.0...
  • Page 153 = line exposure = line readout Fig. 61: Global Shutter For more information about the exposure active output signal, see Section 6.8.1 on page 161. For more information about the SensorReadoutTime parameter, see Section 6.9 on page 174. Basler ace USB 3.0...

  • Page 154: Sensor Readout Mode

    // Set and read the sensor readout mode parameter value camera.SensorReadoutMode.SetValue(SensorReadoutMode_SensorReadoutMode_Normal); camera.SensorReadoutMode.SetValue(SensorReadoutMode_SensorReadoutMode_Fast); SensorReadoutModeEnums e = camera.SensorReadoutMode.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameter. For more information about the pylon API and pylon Viewer, see Section 3.1 on page Basler ace USB 3.0...

  • Page 155: Rolling Shutter (Aca1920-25, Aca2500-14, Aca3800-14, Aca4600-10 Only)

    The Sensor Readout Time is the sum of the readout times of all lines. The Total Readout Time equals the Sensor Readout Time plus the Exposure Overhead time C . The Exposure Overhead time is needed to prepare the sensor for the next acquisition. Basler ace USB 3.0...
  • Page 156 525 µs 525 µs acA2500-14uc 525 µs 525 µs 525 µs acA3800-14uc 3561 µs 4101 µs 4461 µs acA4600-10uc 4521 µs 4980 µs 5439 µs Table 37: Exposure Overhead Time for Color Cameras in Rolling Mode Basler ace USB 3.0...
  • Page 157 You can calculate the total readout time using this formula: Total Readout Time = [ tRow x (ROI Height) ] + C µs You can calculate the total runtime using this formula: Total Runtime = ExposureTime Parameter Setting + Total Readout Time Basler ace USB 3.0...

  • Page 158: Global Reset Release Mode

    And so on until the bottom line of pixels is reached. The Sensor Readout Time is the sum of the readout times of all lines. The Total Readout Time equals the Sensor Readout Time plus the Exposure Overhead time C Basler ace USB 3.0...
  • Page 159 Exposure Active signal instead, if available. For more information about the Exposure Active signal, see Section 6.8.1 on page 161. Basler ace USB 3.0...
  • Page 160 For more information about the exposure active output signal, see Section 6.8.1 on page 161. For more information about the ExposureTime parameter, see Section 6.5 on page 139. For more information about the flash window, see Section 6.6.2.3 on page 151. Basler ace USB 3.0...

  • Page 161: The Flash Window

    The cameras have two shutter modes: rolling and global reset release. You can set the shutter mode from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the shutter modes: // Set the shutter mode to rolling camera.ShutterMode.SetValue(ShutterMode_Rolling);...
  • Page 162 Line 10 Line 11 tRow Line N-2 Line N-1 Line N Time to Flash Window Open Flash Window Width = line exposure time = line readout time Fig. 64: Flash Window for Rolling Shutter in Rolling Mode Basler ace USB 3.0...
  • Page 163 To facilitate the use of flash lighting, you can use the flash window output signal (see Section 6.8.2 page 163). The flash window signal goes high when the flash window opens and goes low when the flash window closes. For more information about the ExposureTime parameter, see Section 6.5 on page 139. Basler ace USB 3.0...
  • Page 164 Line 8 Line 9 Line 10 Line 11 Line N-2 Line N-1 Line N Flash Window Width = line exposure time = line readout time Fig. 65: Flash Window for Rolling Shutter in Global Reset Release Mode Basler ace USB 3.0...

  • Page 165: Overlapping Image Acquisitions

    In the overlapped mode of operation, the exposure of a new frame begins while the camera is still reading out the sensor data for the previously acquired frame. This situation is illustrated in Figure 67 with the camera set for the trigger width exposure mode. Basler ace USB 3.0...
  • Page 166 The parameter indicates what the readout time will be in microseconds given the camera’s current settings. You can read the Readout Time 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 d = camera.SensorReadoutTime.GetValue();...
  • Page 167 For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max parameter, see Section 6.8.4.2 on page 168. For more information about trigger width exposure, see Section 6.4.3.2 on page 129. Basler ace USB 3.0...

  • Page 168: Overlapping Image Acquisitions For Aca1920-25, Aca2500-14, Aca3800-14, Aca4600-10

    Fig. 69: Non-overlapped Acquisition In the overlapped mode of operation, the acquisition for a new frame begins while the camera is still completing the acquisition process for the previous frame. This situation is illustrated in Figure 70. Basler ace USB 3.0...
  • Page 169 N (the last line). You can read the Readout Time 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 d = camera.SensorReadoutTime.GetValue();...
  • Page 170 Frame Acquisition N+2 Time = Line Exposure = Line Readout Fig. 71: Acquisition Overlap Guideline You can avoid violating this guideline by using the camera’s Frame Trigger Wait signal to determine when exposure can safely begin. Basler ace USB 3.0...

  • Page 171: Acquisition Monitoring Tools

    Timing charts are not drawn to scale. The times stated are only given as examples. They are only valid for the operating conditions given in Section 5.10.3. Fig. 72: Exposure Active Signal on Cameras with a Global Shutter Basler ace USB 3.0...
  • Page 172  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_Line2);...

  • Page 173: Flash Window Signal

    AW00123409000 Image Acquisition Control 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.1 on page For more information about changing the selection of a camera output signal as the source signal for an output line, see Section 5.12.1 on...
  • Page 174  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_Line2);...

  • Page 175: 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 176: Trigger Wait Signals

    3 and with exposure and readout overlapped on a camera with a global shutter. 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 ace USB 3.0...
  • Page 177 Fig. 75: Frame Burst Trigger Wait Signal The frame burst trigger wait signal will only be available when hardware frame burst start triggering is enabled. For more information about event notification, see Section 7.17 on page 314. Basler ace USB 3.0...

  • Page 178: The 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_Line2);...
  • Page 179 The frame trigger wait signal will only be available when hardware frame start triggering is enabled. For more information about event notification, see Section 7.17 on page 314. For more information about hardware triggering, see Section 6.3.5 on page 120 and Section 6.4.3 page 128. Basler ace USB 3.0...
  • Page 180 Frame Acquisition N+1 Exposure Sensor Readout Exp. Time Setting Frame Acquisition N+2 Sensor Readout Exposure Time = Camera is in a "waiting for frame start trigger" status Fig. 77: Frame Trigger Wait Signal with the Timed Exposure Mode Basler ace USB 3.0...
  • Page 181 This functionality is illustrated in Figure 79. If you are operating a camera with a rolling shutter, you can avoid overtriggering by always making sure that the Frame Trigger Wait signal is high before you trigger the start of frame capture. Basler ace USB 3.0...
  • Page 182 Frame Acquisition N Frame Acquisition N+1 Frame Acquisition N+2 Time = Line Exposure = Line Readout = Camera in a "waiting for frame start trigger" status Fig. 79: Frame Trigger Wait Signal on a Rolling Shutter Camera Basler ace USB 3.0...

  • Page 183: Camera Events And Acquisition Status

     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_Line2);...

  • Page 184: Acquisition Timing Chart

    The transmission start delay can vary between frames and largely depends on when the host computer starts calling for data transmission. Note that a propagation delay of unspecified duration precedes the exposure start delay when applying an ExFSTrig signal. For more information about propagation delays, see Section 5.10 on page Basler ace USB 3.0...
  • Page 185 7855 (also for global reset release mode) Table 40: Exposure Start Delays for all Pixel Format Bit Depths Unless Indicated Otherwise * The shortest delays apply when maximum bandwidth is available. The delays increase as available bandwidth decreases. Basler ace USB 3.0...
  • Page 186 Transmission Start Delay Transmission Start Delay Frame N Transmission to Host Computer Frame Frame N+1 Transmission to Host Computer Transmission Timing charts are not drawn to scale Fig. 80: Exposure Start Controlled with an ExFSTrig Signal Basler ace USB 3.0...
  • Page 187 The parameter indicates what the readout time will be in microseconds given the camera’s current settings. You can read the Sensor Readout Time 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 d = camera.SensorReadoutTime.GetValue();...

  • Page 188: Maximum Allowed Frame Rate

    There are two ways for determining the maximum allowed acquisition frame rate with your current camera settings: You can use the online frame rate calculator found in the Support section of the Basler website  (Support > Tools > Frame Rate Calculator): www.baslerweb.com...
  • Page 189 The factory parameter settings were chosen to avoid problems that might result from insufficient USB 3.0 bandwidth available in your application. You can easily change the parameter settings to operate the cameras at the maximum specified frame rates when sufficient USB 3.0 bandwidth is available. Basler ace USB 3.0...

  • Page 190: Using Basler Pylon To Check The Maximum Allowed Frame Rate

    6.10.1 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 parameter from within your application software using the Basler pylon API. The following code snippet...

  • Page 191: Increasing The Maximum Allowed Frame Rate

    For more information about Image ROI settings, see Section 7.6 on page 208. For more information about the rolling mode, see Section 6.6.2 on page 145. Basler ace USB 3.0...

  • Page 192: 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 parameter, see Section 6.4.1.1 on page 122. Basler ace USB 3.0...
  • Page 193 = frame transmission Acquisition Acquisition Stop Start Command Command Executed Executed Frame Burst Start Trigger Signal Frame Start Trigger Signal Time Fig. 81: Use Case 1 - Frame Burst Start Trigger Off and Frame Start Trigger Off Basler ace USB 3.0...
  • Page 194 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 ace USB 3.0...
  • Page 195 Stop Start Command Command Executed Executed Frame Burst Start Trigger Signal Frame Start Trigger Signal (applied to Line 1) Time Fig. 82: Use Case 2 - Frame Burst Start Trigger Off and Frame Start Trigger On Basler ace USB 3.0...
  • Page 196 (this avoids the need to store images of an empty toll booth area.) For more information about the Acquisition Frame Rate parameter, see Section 6.3.1.1 on page 115. Basler ace USB 3.0...
  • Page 197 Start Stop Command Command Executed Executed Frame Burst Start Trigger Signal (applied to Line 1) Frame Start Trigger Signal Time Fig. 83: Use Case 3 - Frame Burst Start Trigger On and Frame Start Trigger Off Basler ace USB 3.0...
  • Page 198 (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 ace USB 3.0...
  • Page 199 Command Command Executed Executed Frame Burst Start Trigger Software Command Executed Frame Start Trigger Signal (applied to Line 1) Time Fig. 84: Use Case 4 - Frame Burst Start Trigger On and Frame Start Trigger On Basler ace USB 3.0...

  • Page 200: Features

    The feature availability charts below allow you to see at a glance which features are implemented on which camera model. • A solid bullet ( ) indicates that a feature is implemented. A void space indicates that the pertinent feature is not implemented. Basler ace USB 3.0...
  • Page 201 • • • • • • • • • • • • • • • • • • • • • • • • • • acA3800-14um Table 41: Availability of Features in Monochrome Cameras Basler ace USB 3.0...
  • Page 202 • • • • • • acA3800-14uc • • • • • • • • • • • • • • • • • • • • • • • acA4600-10uc Table 42: Availability of Features in Color Cameras Basler ace USB 3.0...

  • Page 203: Gain

    For some camera models, the maximum allowed Gain parameter value decreases when a pixel format with a higher bit depth is selected (see Table 44). Gain control is entirely analog if the maximum allowed Gain parameter value falls below the boundary Gain parameter value. Basler ace USB 3.0...
  • Page 204 Table 43: Mechanisms of Gain Control and Boundary Values (If Applicable) For information about the digital shift feature, see Section 7.5 on page 202. Basler ace USB 3.0...

  • Page 205: Setting The Gain

    Bayer BG 10, Bayer BG 10 p) or of 12 bit (e.g. Mono 12, Mono 12 p, Bayer BG 12, Bayer BG 12 p). Table 44 shows the minimum and maximum settable gain for each camera model. The values indicate regular settings, i.e. the parameter limits are not removed. Basler ace USB 3.0...
  • Page 206 36.0 24.0 acA2000-165um/umNIR/uc 23.5935 23.5935 acA2040-55um/uc acA2040-90um/umNIR/uc 23.5935 23.5935 acA2040-120um/uc acA2440-35um/uc acA2440-75um/uc acA2500-14um/uc 23.79814 23.79814 acA2500-60um/uc 12.0 12.0 acA3800-14um/uc 16.67569 16.67569 acA4600-10uc 17.76052 17.76052 Table 44: Minimum and Maximum Gain Parameter Values (Parameter Limits Not Removed) Basler ace USB 3.0...
  • Page 207 2. Set the Gain parameter to your desired value. You can set the Gain Selector parameter and the Gain 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.GainSelector.SetValue(GainSelector_All);...

  • Page 208: Black Level

    For example, if the black level parameter value is increased by 1 the pixel value for each pixel is increased by 1. If the black level parameter value is decreased by 1 the pixel value for each pixel is decreased by 1. Basler ace USB 3.0...

  • Page 209: Setting The Black Level

    31.9375 511.0 acA2040-90um/umNIR/uc 15.9375 255.0 acA2040-120um/uc 31.9375 511.0 acA2440-35um/uc 31.9375 511.0 acA2440-75um/uc 31.9375 511.0 acA2500-14um/uc 15.9375 255.0 acA2500-60um/uc 63.75 255.0 acA3800-14um/uc 63.9375 1023 acA4600-10uc 63.9375 1023 Table 45: Minimum and Maximum Black Level Settings ([DN]) Basler ace USB 3.0...
  • Page 210 You can set the Black Level Selector and the Black Level 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.BlackLevelSelector.SetValue(BlackLevelSelector_All);...

  • Page 211: Remove Parameter Limits

    The values for any extended limits can be determined by using the Basler pylon Viewer or from within your application via the pylon API.

  • Page 212: Digital Shift

    Shifted Once conditions the reading for the brightest pixel is 100. If you changed the digital shift setting to shift by 1, the reading would increase to 200. Basler ace USB 3.0...
  • Page 213 1. Therefore, you should only use the shift by 3 setting when your pixel readings with a 12 bit pixel format selected and with digital shift disabled are all less than 512. Basler ace USB 3.0...

  • Page 214: Digital Shift With 8 Bit Pixel Formats

    If the pixel values being output by the camera’s sensor are high enough to set bit 11 to 1, we recommend not using shift by 1. If you do nonetheless, all bits output from the camera will Basler ace USB 3.0...
  • Page 215 1. Therefore, you should only use the multiply 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 ace USB 3.0...

  • Page 216: 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 ace USB 3.0...

  • Page 217: Enabling And Setting Digital Shift

    3, or 4, digital shift will be set to shift by 1, shift by 2, shift by 3, or shift by 4 respectively. You can set the Digital Shift 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: // Disable digital shift camera.DigitalShift.SetValue( 0 );...

  • Page 218: Image Region Of Interest (Roi)

    One of the main advantages of the image ROI feature is that decreasing the height of the ROI can increase the camera’s maximum allowed acquisition frame rate. For more information about how changing the ROI height affects the maximum allowed frame rate, see Section 6.10 on page 178. Basler ace USB 3.0...
  • Page 219 Settings with Binning Disabled The minimum settings and minimum increments for OffsetX, OffsetY, Width, and Height are given below, where a distinction is made between mono and color cameras. It is assumed that binning is disabled. Basler ace USB 3.0...
  • Page 220 Minimum Settings and Increments for Image ROI Position and Size in Mono Cameras (without Binning) Basler ace USB 3.0...
  • Page 221 Normally, the OffsetX, OffsetY, Width, and Height parameter settings refer to the physical columns and rows of pixels in the sensor. But if binning is enabled, these parameters are set in terms of "virtual" columns and rows. For more information, see Section 7.8.1 on page 245. Basler ace USB 3.0...
  • Page 222 Table 47: Minimum ROI Height Settings when Vertical Binning is Disabled and Enabled (Mono Cameras, acA1920-25uc, and acA2500-14uc) Basler ace USB 3.0...
  • Page 223 You can set the OffsetX, OffsetY, 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 mximum allowed settings for the Width and Height parameters. They also illustrate setting the Offset X, OffsetY, Width, and Height parameter values: Basler ace USB 3.0...

  • Page 224: Center X And Center Y

    The enabling of CenterY has an analogous effect on OffsetY settings. Enabling ROI Centering You can enable ROI centering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to enable automatic ROI centering: camera.CenterX.SetValue(true);...

  • Page 225: Changing Roi Parameters "On-The-Fly

    Making ROI parameter changes “on-the-fly” means making the parameter changes while the camera is capturing images continuously. On-the-fly changes are only allowed for the parameters that determine the position of the ROI, i.e., the OffsetX and OffsetY parameters. Changes to the ROI size are not allowed on-the-fly. Basler ace USB 3.0...

  • Page 226: Sequencer

     used for image acquisition but not be configured. The sequencer mode must be set to On. The sequencer feature is disabled when the sequencer configuration mode and the sequencer mode are both set to Off. Basler ace USB 3.0...

  • Page 227: The Sequencer And The Active Set

    The parameter values remain in the active set until they are replaced by the parameter values of the next sequencer set. The sequencer parameters can be divided into two types (see Figure 87): Basler ace USB 3.0...

  • Page 228: Camera Parameters

    Each sequencer set controls the parameter values for the following camera parameters. AcquisitionFrameRate DeviceLinkThroughputLimit AcquisitionFrameRateEnable DigitalShift BalanceRatio ExposureTime BinningHorizontal Gain BinningVertical Height BlackLevel LUTEnable CenterX OffsetX CenterY OffsetY ChunkEnable PixelFormat ChunkModeActive ReverseX 1) 2) ColorAdjustmentHue ReverseY 1) 2) ColorAdjustmentSaturation ScalingHorizontal ColorTransformationValue TestImageSelector Basler ace USB 3.0...

  • Page 229: Sequencer Set Related Parameters And Sequencer Set Advance

     For all Basler USB 3.0 ace cameras, the Sequencer Set Start parameter value must always be set to 0. This selects sequencer set 0 as the first sequencer set to be loaded and used for an image acquisition.
  • Page 230 0 and path 1. Each path allows to configure a distinct scheme for advancing from one sequencer set to the next. Basler strongly encourages setting different sequencer trigger sources for path 0 and path 1. Path 0 and path 1 serve different purposes and should be configured accordingly: Path 1 provides the scheme that allows to cycle through the available sequencer sets.
  • Page 231 Frame Start Table 49: Sequencer Trigger Sources by Path and Related Mechanism for Sequencer Set Advance. * Not available on acA1920-155, acA2040-55, acA2040-120, acA2440-35, and acA2440-75 cameras. Sequencer Trigger Sources and Sequencer Set Advance Two different types of trigger sources are available for advancing from one sequencer set to the...
  • Page 232 84 for information about making optimum use of the temporal performance of the GPIO lines. See Section 5.9 on page 77 about the limitations of use of GPIO lines in an environment with significant electromagnetic interference. Basler ace USB 3.0...
  • Page 233 Skipping is possible because sequencer set advance triggered by software signals is asynchronous, i.e. is not tied to frame start triggers (see also Table 52 and use case 3). Basler ace USB 3.0...

  • Page 234: Sequencer Configuration

    For example, if four sequencer sets are to be used, the Sequencer Set Next parameter value for path 1 used with the fourth sequencer set (index number = 3) must be set to 0. This ensures that each sequencer set cycle (according to path 1) resumes with sequencer set 0. Basler ace USB 3.0...

  • Page 235: Carrying Out Configuration

    You can configure the sequencer and sequencer sets from within your application software by using the Basler pylon API. The following code snippet illustrates configuring the parameters for sequencer start and for sequencer set 0, and storing sequencer set 0 using the API to set the parameter values.
  • Page 236 // Save the camera parameter values and the sequencer set-related parameter values for the selected sequencer set camera.SequencerSetSave.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.1 on page...

  • Page 237: Using The Load Command

    // Select sequencer set 1 by its index number camera.SequencerSetSelector.SetValue(1); // Load the sequencer parameter values from the sequencer set into the active set camera.SequencerSetLoad.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace USB 3.0...

  • Page 238: Sequencer Operation

    For more information about propagation delays of the input lines, see Section 5.10 page Note: You may occasionally encounter a transitional "dummy" sequencer set with index number -1. Ignore this set. It occurs for technical reasons only and cannot be used for image acquisition. Basler ace USB 3.0...
  • Page 239 The frame rate will, however, not decrease as long as no new sequencer set is loaded. Using the sequencer feature will affect the frame rates of all cameras if dictated by parameter values that are controlled by sequencer sets (ExposureTime, AcquisitionFrameRate). Basler ace USB 3.0...
  • Page 240 Trigger for path 0 Sequencer set 3 Sequencer set 2 in the active set in the active set Trigger for path 1 Fig. 88: State Diagram for the "Sequencer Mode" (Start and Operation; Four Sequencer Sets as an Example) Basler ace USB 3.0...

  • Page 241: Sequencer Use Case Descriptions And Diagrams

    Trigger activation Level High** Level High** Level High** Level High** Table 50: Settings for Sequencer Operation According to Use Case 1. * Only one trigger source for a path allowed. **Applies Always, Not Only in this Example Basler ace USB 3.0...
  • Page 242 0 in the active set. A frame acquisition is carried out using the parameter values of sequencer set 1. The image data are processed and transmitted out of the camera. Basler ace USB 3.0...
  • Page 243 When the next frame start trigger signal was received the trigger signal assigned to path 1 is  found to be high. As a result, the frame start trigger triggers the loading of the next sequencer Basler ace USB 3.0...
  • Page 244 The previous sequencer parameter values, occurring in the active set before the sequencer fea- ture was enabled, are loaded into the active set again, overwriting the parameter values of se- quencer set 0. Basler ace USB 3.0...
  • Page 245 Line 3 (GPIO) Trigger Source, Path 0 Line 4 (GPIO) Trigger Source, Path 1 Frame Start Trigger Signal Time Fig. 89: Use Case 1 - Synchronous Cycling Through Sequencer Sets According to Path 1, No Reset Basler ace USB 3.0...
  • Page 246 As the receding series of frame acquisitions, before, the new series of frame acquisitions will be subject to Counter 2 counting and the Counter Duration parameter value. Basler ace USB 3.0...
  • Page 247 When the next frame start trigger signal was received sequencer set 3 is loaded into the active  set and is used for the image acquisition. The image data are processed and transmitted out of the camera. Basler ace USB 3.0...
  • Page 248 The image data are processed and transmitted out of the camera. Sequencer set 1 was loaded because the Counter 2 count for sequencer set 0 was found to already have reached its maximum allowed value in the preceding frame acquisition. Basler ace USB 3.0...
  • Page 249 The sequencer parameter values that were the current ones before the sequencer feature was enabled, are loaded into the active set again. The sequencer set 1 parameter values in the active set are overwritten. Basler ace USB 3.0...
  • Page 250 Trigger Source, Path 0 Counter 2 End Trigger Source, Path 1 Frame Start Trigger Signal Time Fig. 90: Use Case 2 - Synchronous Cycling Through Sequencer Sets Based on Counter 2 End (Path 1), One Reset. Basler ace USB 3.0...
  • Page 251 1 (advance). The triggering is asynchronous to the frame start triggers. In addition, delays of arbitrary duration are involved between issuing a trigger and it becoming effective. Accordingly, the resulting sequencer operation is characterized by some degree of chance. Basler ace USB 3.0...
  • Page 252 The image data are processed and transmitted out of the camera. The fifth Software Signal 3 trigger becomes effective after some delay, loading sequencer set 1  into the active set. Basler ace USB 3.0...
  • Page 253 The sequencer parameter values that were the current ones before the sequencer feature was enabled, are loaded into the active set again. The sequencer set 0 parameter values in the active set are overwritten. Basler ace USB 3.0...
  • Page 254 Software Signal 1 Trigger Source, Path 0 Software Signal 3 Trigger Source, Path 1 Frame Start Trigger Signal Time Fig. 91: Use Case 3 - Asynchronous Cycling Through Sequencer Sets According to Path 1, One Reset Basler ace USB 3.0...

  • Page 255: Binning

    Figure 92 illustrates vertical binning. Vertical Binning by 2 Vertical Binning by 3 Vertical Binning by 4 Fig. 92: Vertical Binning on Monochrome Cameras Basler ace USB 3.0...
  • Page 256 The gray values of adjacent pixels from 3 rows are combined. As a consequence, the signal to noise ratio will be decreased while the camera’s response to light will be slightly increased. We recommend using vertical binning by 2 or by 4. Basler ace USB 3.0...
  • Page 257 Particular Implementation Providing Binning Modes For the acA640-750um, acA800-510um, acA1300-200um, acA1920-40um, acA1920-150um, acA1920-155um, acA2040-55um, acA2040-120um, acA2440-35um, acA2440-75um, acA2500-60um you can choose between Summing and Averaging as binning modes. In these modes pixel gray values are added or averaged (arithmetic mean). Basler ace USB 3.0...

  • Page 258: Binning On Color Cameras

    The number of binned pixels depends on the horizontal color binning setting (see example in Figure 95). Example: Horizontal Color Binning by 2 (Shown for 2 Rows) Fig. 95: Horizontal Color Binning by 2 Basler ace USB 3.0...

  • Page 259: Setting Binning

    1 disables horizontal binning. You can set the Binning Vertical or the Binning Horizontal 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 values: // Enable vertical binning by 2 camera.BinningVertical.SetValue( 2 );...
  • Page 260 // Enable averaging for vertical binning camera.BinningVerticalMode.SetValue(BinningVerticalMode_Averaging); BinningVerticalModeEnums e = camera.BinningVerticalMode.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.1 on page...

  • Page 261: Considerations When Using Binning

    In other words, and expressed in therms of the physical sensor: An effective image ROI was formed whose resolution of 657 (H) x 492 (V) was smaller than the resolution of the originally set image ROI. Only the pixels within the effective image ROI were used for binning. And only these pixels Basler ace USB 3.0...
  • Page 262 If you want to preserve the aspect ratios of imaged objects when using binning, you must use vertical and horizontal binning where equal numbers of lines and columns are binned, e.g. vertical binning by 3 combined with horizontal binning by 3. Basler ace USB 3.0...

  • Page 263: Decimation

    (Figure 98). 2 for color cameras: only every second pair of rows  Fig. 97: Decimation Disabled of the acquired frame will be transmitted out of the camera (Figure 99). Basler ace USB 3.0...
  • Page 264 1 disables vertical decimation. You can set the Decimation Vertical 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 values: // Enable Vertical Decimation by 2 camera.DecimationVertical.SetValue(2);...
  • Page 265 1, i.e. you deactivate vertical decimation, the ROI height can be smaller than the maximum possible height (determined by the pixel resolution in vertical direction). In this case you can manually set the ROI height back to the maximum possible height. Basler ace USB 3.0...

  • Page 266: Decimation Horizontal (Aca3800-14 And Aca4600-10 Only)

    1 disables horizontal decimation. You can set the DecimationHorizontal 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: // Enable Horizontal Decimation by 8 Camera.DecimationHorizontal.SetValue(8);...

  • Page 267: Considerations When Using Decimation

    Binning and Vertical Decimation If vertical binning is used, vertical decimation is automatically disabled, and vice versa, i.e. if vertical decimation is used, vertical binning is disabled. Horizontal binning works independently from the decimation feature. Basler ace USB 3.0...

  • Page 268: Scaling

    DSC = 16/x; where x is any natural number ranging from 16 to 128. Accordingly, the scaling factors (DSC) range from 1.0 (no shrinking) to 0.125 (most extreme shrinking). The scaled ROI width calculates as: SRW [pixels] = (ORW × DSC) - 2 Basler ace USB 3.0...

  • Page 269: Considerations When Using Scaling

    You can use the scaling feature by setting the ScalingHorizontal 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. The example illustrates setting the width of the current frame to one...

  • Page 270: Mirror Image

    Figure 101 shows a normal image on the left and an image captured with Reverse X enabled on the right. Normal Image Mirror Image Fig. 101: Reverse X Mirror Imaging Basler ace USB 3.0...
  • Page 271 For color cameras, provisions are made ensuring that the effective color filter alignment remains constant for normal and mirror images, that is, the same alignment applies to normal and mirror images. For more information about auto functions, see Section 7.15 on page 294. Basler ace USB 3.0...
  • Page 272 You can enable or disable the ReverseX feature by setting the ReverseX parameter value. You can set the 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: // Enable reverse X camera.ReverseX.SetValue(true);...

  • Page 273: Reverse Y

    ROI relative to the sensor remains the same regardless of whether or not the Reverse Y feature is enabled (see Figure 104). As a consequence, an image ROI will display different images depending on whether or not the Reverse Y feature is enabled. Auto function ROIs will behave analogously to image ROIs. Basler ace USB 3.0...
  • Page 274 And accordingly, the related pixel formats apply. For example, when you use a camera with BG physical alignment and only Reverse Y enabled, the pixels of the image are based on an effective GR alignment and the Bayer GR pixel formats apply. Basler ace USB 3.0...
  • Page 275 You can enable or disable the Reverse Y feature by setting the ReverseY parameter value. You can set the 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: // Enable reverse Y camera.ReverseY.SetValue(true);...

  • Page 276: 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 Basler ace USB 3.0...
  • Page 277 Fig. 105: 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. 106: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler ace USB 3.0...
  • Page 278 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 279 Features // Enable the lookup table camera.LUTEnable.SetValue(true); 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.1 on page Basler ace USB 3.0...

  • Page 280: Gamma Correction

    If you nonetheless used a Gamma parameter value other than 1 it would be combined with the automatically set sRGB gamma correction value, causing incorrect colors. For more information about light source presets, see Section 7.14.3.3 on page 284. Basler ace USB 3.0...
  • Page 281 You can use the Gamma parameter to set the Gamma correction value. Set the Gamma 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 to 1.2 as an example: // Set the Gamma value to 1.2...

  • Page 282: Color Creation And Enhancement

    7.14.1 Color Creation The sensors in the color versions of the Basler ace USB 3.0 cameras are equipped with an additive color separation filter known as a Bayer filter. The pixel formats available on color cameras for pixel data output are related to the Bayer pattern.

  • Page 283: Bayer Color Filter Alignment

    Bayer filter alignment in the image differs from the physical alignment on the sensor when Reverse X or Reverse Y or enabled. However, these differences are systematic (see Section 7.11 page 260). The PixelColorFilter parameter indicates the effective alignment of the Bayer filter. Basler ace USB 3.0...
  • Page 284 Because the size and position of the region of interest on color cameras with a Bayer filter must be adjusted in increments of 2 or of multiples of 2, the color filter alignment will remain constant regardless of the camera’s region of interest (ROI) settings (see Section 7.6 on page 208). Basler ace USB 3.0...

  • Page 285: Pixel Formats Available On Color Cameras

    * The Bayer filter alignment given refers to the physical Bayer filter alignment with respect to the sensor’s pixels. The identical alignments also apply to the images (effective alignments), provided mirror image features are not enabled. Basler ace USB 3.0...
  • Page 286 0.299 R + 0.587 G + 0.114 B Cb = - 0.16874 R - 0.33126 G + 0.5000 B + 128 Cr = 0.5000 R - 0.41869 G - 0.08131 B + 128 Basler ace USB 3.0...

  • Page 287: Integrated Ir Cut Filter

    If a lens with a very long thread length is used, the filter holder or the lens mount will be damaged or destroyed and the camera will no longer operate. For more information about the location of the IR cut filter in the camera, see Section 1.6.2 on page Basler ace USB 3.0...

  • Page 288: Color Enhancement Features

    RGB color space. White balancing is achieved by adjusting red, green, and blue for each pixel such that white objects in the camera’s field of view appear white in the acquired images. Basler ace USB 3.0...
  • Page 289 For this reason, Basler doesn’t normally recommend setting a balance ratio less than 1 unless you want to correct for the strong predominance of one color.
  • Page 290 You can set the Balance Ratio Selector and the Balance Ratio 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 green as an example: // Select the color for white balancing and set the related BalanceRatio value camera.BalanceRatioSelector.SetValue(BalanceRatioSelector_Green);...

  • Page 291: Pgi Feature Set

    "simple" 2×2 demosaicing used otherwise by the camera. The Basler PGI 5×5 demosaicing can only operate in the context of the Basler PGI feature set and, conversely, the Basler PGI feature set can only operate with 5×5 demosaicing.
  • Page 292 The sharpness enhancement feature allows to increase the sharpness of an image at the user’s visual discretion. The SharpnessEnhancement parameter value can range from 1.0 to 3.98438. Best results will in most cases be obtained at low parameter value settings and when used together with noise reduction. Basler ace USB 3.0...
  • Page 293 4. If desired, use the Sharpness Enhancement feature to reach the visual optimum. You can set the Basler PGI Feature Set from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the parameter values: // Set BaslerPGI (5x5) demosaicing and start Basler PGI image quality optimization camera.DemosaicingMode.SetValue(DemosaicingMode_BaslerPGI);...

  • Page 294: Light Source Presets

    Off - No light source preset is selected. In addition, no gamma correction is automatically  applied (accordingly, the Gamma parameter value is set to 1). Basler recommends setting the Gamma parameter value to 0.45. This parameter value adjusts the pixel values for correct color reproduction on an sRGB monitor without, however, taking account of a specific light source.
  • Page 295 You can use the Light Source Preset parameter value to set the correction for a specific light source or chose no correction. You can set the 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 LightSourcePreset parameter value to "Off"...

  • Page 296: Color Adjustment (All Color Cameras Except Aca2000-165 And Aca2040-90)

    For example, the adjustment of red affects the colors in the image with a predominant red component. Basler recommends to also use color adjustment when using a light source preset. This allows to make better use of the camera’s color enhancement capabilities.
  • Page 297 AW00123409000 Features White Black Fig. 108: RGB Color Cube With YCM Secondary Colors, Black, and White, Projected On a Plane Basler ace USB 3.0...
  • Page 298 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 ace USB 3.0...
  • Page 299 Enabling and Setting Color Adjustment You can set the Color Adjustment Hue and Color Adjustment Saturation parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the parameter values: // Select red as the color to adjust camera.ColorAdjustmentSelector.SetValue(ColorAdjustmentSelector_Red);...

  • Page 300: Color Transformation

    Although the color transformation matrix can be used without using a light source preset, Basler nonetheless strongly recommends to also use the suitable light source preset if available, to make full use of the camera’s color enhancement capabilities.
  • Page 301 You can set the Color Transformation Value Selector and Color Transformation Values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the values in the matrix. Note that the values in this example are just randomly selected numbers and do not represent values that you should actually use.

  • Page 302: A Procedure For Setting The Color Enhancements

    7.14.3.6 A Procedure for Setting the Color Enhancements When setting the color enhancements on the camera, Basler recommends using the procedure outlined below. You can change the camera parameters quickly and easily by using the Basler pylon Viewer software. Note: The procedure aims at producing a color reproduction on a monitor that is optimized for human vision.
  • Page 303 9. If available for your camera model, reduce noise in the image and enhance its sharpness by enabling the PGI Feature Set. If you desire a stronger effect, carry out further adjustments by using the related parameters. For Information about the PGI feature set, see Section 7.14.3.2 on page 281. Basler ace USB 3.0...

  • Page 304: Auto Functions

    You can use an auto function when binning is enabled (monochrome cameras and the acA1920-25uc 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 7.8 on page 245. Basler ace USB 3.0...

  • Page 305: 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 ace USB 3.0...

  • Page 306: Auto Function Rois

    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 Region of Interest Image Region of Interest X Offset Width Fig. 110: Auto Function Region of Interest and Image Region of Interest Basler ace USB 3.0...

  • Page 307: Assignment Of An Auto Function To An Auto Function Roi

    // Select the unused Auto Function ROI 2 // Disable the unused Auto Function ROI camera.AutoFunction Selector.SetValue(AutoFunction Selector_ camera.AutoFunction UseBrightness.SetValue(false); camera.AutoFunction UseWhiteBalance.SetValue(false); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace USB 3.0...

  • Page 308: Positioning Of An Auto Function Roi Relative To The Image Roi

    You can use auto functions when also using the Reverse X feature. For information about the behavior and roles of Auto Function ROI and Image ROI when also using the Reverse X feature, see the "Reverse X" section. Basler ace USB 3.0...
  • Page 309 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 ROI Image ROI Fig. 111: Various Degrees of Overlap Between the Auto Function ROI and the Image ROI Basler ace USB 3.0...

  • Page 310: Setting An Auto Function Roi

    You can select an Auto Function ROI and set the Offset X, Offset X, Width, and Height parameter values for the Auto Function ROI from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to select an Auto Function ROI and to get the maximum allowed settings for the Width and Height parameters.
  • Page 311 ROI- Width.GetMax(); camera.AutoFunction Height.SetValue(964); camera.AutoFunction Height.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.1 on page Basler ace USB 3.0...

  • Page 312: Gain Auto

    0 (black) to 255 (white) when the camera is set for an 8 bit pixel format or from 0 (black) to 4095 (white) when the camera is set for a 12 bit pixel format. To set the gain auto function using Basler pylon: 1. Select the Auto Function ROI, for example ROI1.
  • Page 313 // Set the mode of operation for the 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.1 on page Basler ace USB 3.0...

  • Page 314: Exposure Auto

    0 (black) to 255 (white) when the camera is set for an 8 bit pixel format or from 0 (black) to 4095 (white) when the camera is set for a 12 bit pixel format. Basler ace USB 3.0...
  • Page 315 If the Auto Exposure Time Upper Limit parameter is set to a sufficiently high value the camera’s frame rate can be decreased. To set the exposure auto function using Basler pylon: 1. Select the Auto Function ROI, for example ROI 1.
  • Page 316 // 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.1 on page For general information about auto functions, see Section 7.15 on...

  • Page 317: Auto Function Profile

    If you want to use the gain auto and the exposure auto functions at the same time, 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 involves several steps: To set the auto function profile using Basler pylon: 1.

  • Page 318: Balance White Auto

    For more information about setting the white balance "manually", see Section 7.14.3.1 on page 278. To set the balance white function using Basler pylon: 1. Select the Auto Function ROI, for example, ROI 2. 2. Set the value of the Offset X, Offset Y, Width, and Height parameters for the ROI.

  • Page 319: Pattern Removal Auto

    AW00123409000 Features 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.1 on page For general information about auto functions, see Section 7.15 on page 294.
  • Page 320 Make sure the Sequencer feature and all auto functions except Pattern Removal Auto are disabled when generating new correction coefficient values. Basler strongly recommends to perform Pattern Removal Auto whenever you change the imaging conditions. The Pattern Removal Auto Function and Its Operation The pattern removal auto function differs in some respects from other auto functions: It does not employ any Auto Function Region of Interest (Auto Function ROI).
  • Page 321 AW00123409000 Features Basler recommends not to use the Pattern Removal Auto Function when other auto functions are used unless the automatic changes are very limited and close to the imaging conditions for which the correction values were generated. A similar restriction applies when using the Pattern Removal Auto Function with the Sequencer feature.

  • Page 322: Color Cameras

    Using the Pattern Removal Auto Function is described in Section 7.15.8 on page 309. To use an auto function using Basler pylon: 1. Select an Auto Function ROI. 2. Assign the auto function you want to use to the selected Auto Function ROI.

  • Page 323: Timestamp Latch

    2. Retrieve the TimestampLatchValue parameter value. You can execute the TimestampLatch command and retrieve the TimestampLatchValue parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates the procedure using the API: // execute a command to obtain a timestamp and retrieve the timestamp latch value [ns] camera.TimestampLatch.Execute();...

  • Page 324: Event Notification

    No mechanism is available to monitor the number of event messages lost. Note also that an event message is only useful when its cause still applies at the time when the event is received by the computer. Basler ace USB 3.0...
  • Page 325 While the camera is waiting for an acknowledgement, no new event messages can be transmitted. 3. Event notification involves making some additional software-related steps and settings. For more information, see the "Camera Events" code sample included with the pylon software development kit. Basler ace USB 3.0...
  • Page 326 API. The pylon Camera Software Suite 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 327: Test Images

    Test Image Selector to one of the test images, e.g. to test image 1 (see below), for test image 1, or to "off". You can set the Test Image Selector from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the selector: // Set for no test image camera.TestImageSelector.SetValue(TestImageSelector_Off);...
  • Page 328 // Set test image reset and hold and read the current setting camera.TestImageResetAndHold.SetValue(true); bool b = camera.TestImageResetAndHold.GetValue(); 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.1 on page...

  • Page 329: 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 ace USB 3.0...
  • Page 330 5 and test image 3 is this: if a camera feature that involves digital processing is enabled, test image 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 ace USB 3.0...
  • Page 331 Figure 113, test image six consists of diagonal color gradients (when a Mono pixel format is selected, gray gradients will appear). The image moves by one pixel from right to left whenever you signal the camera to capture a new image. Fig. 113: Test Image Six Basler ace USB 3.0...

  • Page 332: Device Information And Control

    DeviceUserID Used to assign a user-defined name to a camera. The name is displayed in the Basler pylon Viewer and the Basler pylon USB Configurator. The name is also visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.

  • Page 333: Image Format Control Category

    Maximum number of pixels in a column that can create an image, subject to the current settings for (if available) vertical binning, vertical decimation, vertical scaling. Table 59: Parameters Included In the Image Format Control Category Basler ace USB 3.0...
  • Page 334 AW00123409000 You can read the values for all of the device information parameters and set the controls from within your application software by using the Basler pylon API. The following code snippets illustrate using the API: // Read the Device Vendor Name parameter GenICam::gcstring s = camera.DeviceVendorName.GetValue();...
  • Page 335 // Read the HeightMax parameter int64_t i = 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 also use the Basler pylon USB Configurator to read the Device User ID.

  • Page 336: User Defined Values

    ); int64_t i = camera.UserDefinedValue.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.1 on page Basler ace USB 3.0...

  • Page 337: User Sets

    Instructions for loading a saved user set into the active set and for designating which set will be the startup set appear below in Section 7.21.3 on page 331 and Section 7.21.4 on page 332, respectively. Basler ace USB 3.0...
  • Page 338 The startup user set will automatically be loaded into the active set whenever the camera starts up at power on or after a reset. Instructions for designating a user set as the User Set Default appear below. Basler ace USB 3.0...

  • Page 339: Selecting A User Set

    1. Set the User Set Selector to the desired user set (one of the factory setups, User Set 1, User Set 2 or User Set 3). You can set the User Set Selector from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector: If you want to select the Default User Set: camera.UserSetSelector.SetValue(UserSetSelector_Default);...

  • Page 340: Saving A User Set

    To save a User Set from the active set into the non-volatile memory using Basler pylon: 1. Make changes to the camera’s settings until the camera is operating in a manner that you would like to save.

  • Page 341: Loading User Set Into The Active User Set

    If you want to load the High Gain User Set: camera.UserSetSelector.SetValue(UserSetSelector_HighGain); camera.UserSetLoad.Execute( ); If you want to load the Auto Functions User Set: camera.UserSetSelector.SetValue(UserSetSelector_AutoFunctions); camera.UserSetLoad.Execute( ); If you want to load the Color Raw User Set: camera.UserSetSelector.SetValue(UserSetSelector_ColorRaw); camera.UserSetLoad.Execute( ); Basler ace USB 3.0...

  • Page 342: Designating A User Set As The User Set Default

    You can also use the Basler pylon Viewer to easily set the selector. For more information about the Basler pylon API and the pylon Viewer, see Section 3.1 on page 7.21.4 Designating a User Set as the User Set Default...
  • Page 343 If you want to designate the Color Raw User Set as User Set Default: camera.UserSetDefault.SetValue(UserSetDefault_ColorRaw); If you want to designate e.g. User Set 1 as User Set Default: camera.UserSetDefault.SetValue(UserSetDefault_UserSet1); For more information about the Basler pylon API and the pylon Viewer, see Section 3.1 on page Basler ace USB 3.0...

  • Page 344: Line Pitch

    64-byte cache lines as 352 can not be divided by 64 without remainder. Alignment is, however, possible, when the line data are padded with 32 bytes (as zeros) to produce the minimum required line pitch of 384 bytes. Basler ace USB 3.0...
  • Page 345 Chunk data, that may be appended to a frame, must not be considered when calculating the desired line pitch. For more information about the chunk feature, see Section 7.23 on page 338. Basler ace USB 3.0...
  • Page 346 4. Set the LinePitch parameter using the value calculated in step 2 to achieve the required padding. When you enable the LinePitch feature, the feature will automatically provide padding for 4-byte alignment, without the need for setting the LinePitch parameter value. Basler ace USB 3.0...
  • Page 347 AW00123409000 Features You can manually adjust the line pitch from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values. As an example, the settings are consistent with the example given above (32-byte alignment): // Enable the line pitch feature and get informed about the enabling camera.LinePitchEnable.SetValue(true);...

  • Page 348: Chunk Features

    If you want to use more than one chunk feature, you can prepare several chunk features by using Chunk Selector and Chunk Enable before setting the Chunk Mode Active parameter. For more information about the three steps, see below. Basler ace USB 3.0...

  • Page 349: Data Chunks

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon Camera Software Suite. The following code snippet illustrates using the API to activate the chunk mode, select the gain chunk, and enable the gain chunk: // make chunk mode active, select and enable Gain chunk camera.ChunkSelector.SetValue(ChunkSelector_Gain);...

  • Page 350: Line Status All Chunk

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon Camera Software Suite. The following code snippet illustrates using the API to activate the chunk mode, select the line status all chunk, and enable the line status...

  • Page 351: Exposure Time Chunk

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon Camera Software Suite. The following code snippet illustrates using the API to activate the chunk mode, select the exposure time chunk, and enable the exposure...

  • Page 352: Timestamp Chunk

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to activate the chunk mode, and enable the Timestamp chunk: // make chunk mode active and enable Timestamp chunk camera.ChunkSelector.SetValue(ChunkSelector_Timestamp);...

  • Page 353: Sequencer Set Active Chunk

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to activate the chunk mode, and enable the Sequencer Set Active chunk: // make chunk mode active and enable Sequencer Set Active chunk camera.ChunkSelector.SetValue(ChunkSelector_SequencerSetActive);...

  • Page 354: Counter Value Chunk

    You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to activate the chunk mode, and enable the counter value chunk: // make chunk mode active and enable Counter Value chunk camera.ChunkSelector.SetValue(ChunkSelector_CounterValue);...

  • Page 355: Counter Reset

    You can set the 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 356: Crc Checksum Chunk

    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 CRC...

  • Page 357: Chunk Mode Active

    1. 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 358: Retrieving Data Chunks

    32 bit Length 32 bit 32 bit 32 bit 32 bit Chunk 2 Chunk 1 Chunk N Actual payload size of the grab result Fig. 117: Example of a Set of Chunks Related to One Image Acquisition Basler ace USB 3.0...
  • Page 359 If you use code written in C or C# you must run the image data chunk and the appended  chunks through the chunk parser that is included in the C API for Basler pylon software and via the device node map.

  • Page 360: Troubleshooting And Support

    Support and Downloads sections of our website: www.baslerweb.com If you do decide to contact Basler technical support, please take a look at Section 8.3 on page 351 before you call. The section gives information about assembling relevant data that will help the Basler technical support team to help you with your problem.

  • Page 361: Before Contacting Basler Technical Support

    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. Basler technical support contact information is shown in the title section of this manual.
  • Page 362 If known, what’s the cause of the problem? When did the problem occur? After start. While running. After a certain action (e.g., a change of parameters): How often did/does the problem Once. Every time. occur? Regularly when: Occasionally when: Basler ace USB 3.0...
  • Page 363 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 364: Revision History

    First release of this document for series cameras and some prototype cameras. Updated Asian contact information. Updated names throughout the manual related to the release of the Basler pylon 4 Camera Software Suite. Included information throughout the document about the following cameras: acA640-90um/uc, acA1920-25um/uc (series cameras) ...
  • Page 365 Section 8.7.4 on page 249. Highlighted the distinction between "active set" and "active user set" in Section 8.17 on page 290. Added the Line Status All chunk as Section 8.18.3.2 on page 299. Basler ace USB 3.0...
  • Page 366 Added information in Section 7.18 on page 317 about operation with 10 bit output and indicated activation of test image 2 by over temperature mode. AW00123406000 21 Dec 2015 Removed information about the acA645-100um/uc throughout the manual. Basler ace USB 3.0...
  • Page 367 Re-arranged table entries from Table 35 through Table Corrected camera event names in Table 6.8.5 on page 173. Added Mono formats to Table 38 on page 195. Added the "PGI Feature Set" Section 7.3.2 on page 201. Basler ace USB 3.0...
  • Page 368 Section 6.4.3.2 on page 129 Section 7.23.3.3 on page 341. Mentioned fast sensor readout mode, removal of bandwidth limit, and connections of more than one camera to a host inSection 6.10 on page 178. Basler ace USB 3.0...
  • Page 369 Added instruction to perform pattern removal only on the full-size ROI in Section 7.15.8 on page 309. Changed "timestamp value" to "timestamp latch" or "timestamp latch value" in Section 7.16 on page 313. Restructured and expanded Section 7.19 on page 322. Basler ace USB 3.0...

  • Page 370: Index

    251 secondary........ 286 effect on image ROI settings....251 space........270 horizontal ......... 246 RGB .......... 278 image distortion........ 252 temperature ........284 monochrome cameras ..... 245 transformation ......290 response to light.......251 vertical..........245 Basler ace USB 3.0...
  • Page 371 HiDLTL condition ........2 electrostatic discharge......48 housing temperature EMI ............48 during operation......... 49 environmental requirements.....49 during storage........49 ESD ............48 measuring spot ........49 event critical temperature......316 exposure end ........316 frame burst start .......316 frame burst start overtrigger.....316 Basler ace USB 3.0...
  • Page 372 (6-pin connector) .... 68 pin numbering (6-pin connector)....68 pixel format ..........4 mechanical stress tests......46 primary color........286 mirror image ...........260 propagation delays ........84 mode pulse width (minimum)......95 acquisition ........109 binning ..........247 Basler ace USB 3.0...
  • Page 373 ........350 temperature device...........51 housing..........49 internal (core board)......51 storage ..........49 temperature state ......51 test images ..........317 tightening sequence ......44 timed exposure mode.....112 timestamp chunk ........342 timestamp latch ........313 Basler ace USB 3.0...

This manual is also suitable for:

Aca2440-35Aca2040-120Aca2440-75

Table of Contents