Basler ace acA645-100 User Manual

Usb 3.0 cameras
Table of Contents

Advertisement

Basler ace
USER'S MANUAL FOR USB 3.0 CAMERAS
Document Number: AW001234
Version: 04 Language: 000 (English)
Release Date: 17 June 2015
The manual includes information about the following
prototype cameras: acA645-100, acA1920-155.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ace acA645-100 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Basler ace acA645-100

  • Page 1 Basler ace USER’S MANUAL FOR USB 3.0 CAMERAS Document Number: AW001234 Version: 04 Language: 000 (English) Release Date: 17 June 2015 The manual includes information about the following prototype cameras: acA645-100, acA1920-155.
  • Page 2 Basler customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Basler for any damages resulting from such improper use or sale. Warranty Note Do not open the housing of the camera.
  • Page 3 Contacting Basler Support Worldwide Europe, 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

    The Basler pylon 4 Camera Software Suite ....... . .
  • Page 6 5.14.1 Checking the Status of All I/O Lines ....... . 94 5.14.2 Checking the Status of an Individual I/O Line ......95 Basler ace USB 3.0...
  • Page 7 ..........145 Basler ace USB 3.0...
  • Page 8 6.10 Maximum Allowed Frame Rate ......... 165 6.10.1 Using Basler pylon to Check the Maximum Allowed Frame Rate ..166 6.10.2 Increasing the Maximum Allowed Frame Rate .
  • Page 9 8.17.3 Loading User Set into the Active User Set......292 8.17.4 Designating a User Set as the User Set Default ..... . 293 Basler ace USB 3.0...
  • Page 10 Obtaining an RMA Number ..........305 Before Contacting Basler Technical Support ....... 306 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 sensor size, their maximum frame rate at full resolution, and whether the camera’s sensor is mono or color.
  • Page 12: General Specifications

    29.3 mm x 29 mm x 29 mm (without cylindric housing extension or connectors) 48.2 mm x 29 mm x 29 mm (with cylindric housing extension and connectors) Weight < 80 g Table 1: General Specifications Basler ace USB 3.0...
  • Page 13 Conformity CE*, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat).
  • Page 14 Conformity CE, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat).
  • Page 15 Conformity CE, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Table 3: General Specifications Basler ace USB 3.0...
  • Page 16 Specification acA1300-30um/uc acA1600-20um/uc Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat). Table 3: General Specifications Basler ace USB 3.0...
  • Page 17 Conformity CE, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Table 4: General Specifications Basler ace USB 3.0...
  • Page 18 AW00123404000 Specification acA1920-25um/uc Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat). Table 4: General Specifications Basler ace USB 3.0...
  • Page 19 CE, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat).
  • Page 20 Conformity CE, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) * The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat).
  • Page 21 CE, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat).
  • Page 22 CE, UL, FCC, GenICam V. 2.x (including PFNC V. 1.x and SFNC V. 2.x), IP30, RoHS, USB3 Vision, USB-IF (in preparation) * The CE Conformity Declaration (for acA3800-14um/uc) is available on the Basler website: www.baslerweb.com Table 8: General Specifications Basler ace USB 3.0...
  • Page 23 Specification acA3800-14um/uc acA4600-10uc Software Basler pylon 4 Camera Software Suite (version 4.0 or higher) Available for Windows in 32 and 64 bit versions and Linux (x86 32 bit, x86 64 bit, ARM softfloat, ARM hardfloat). Table 8: General Specifications Basler ace USB 3.0...
  • Page 24: Spectral Response

    Mono Camera 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. Wavelength (nm) Fig. 1: acA640-90um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 25 AW00123404000 Specifications, Requirements, and Precautions Wavelength (nm) Fig. 2: acA640-120um Spectral Response (From Sensor Data Sheet) Wavelength (nm) Fig. 3: acA645-100um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 26 Specifications, Requirements, and Precautions AW00123404000 1000 Wavelength (nm) Fig. 4: acA1300-30um Spectral Response (From Sensor Data Sheet) Wavelength (nm) Fig. 5: acA1600-20um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 27 AW00123404000 Specifications, Requirements, and Precautions 1050 1150 Wavelength (nm) Fig. 6: acA1920-25um Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 7: acA1920-155um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 28 50 0 6 00 7 00 80 0 9 00 1 000 Wavelength (nm) Fig. 8: acA2000-165um, acA2040-90um Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 9: acA2000-165umNIR, acA2040-90umNIR Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 29 AW00123404000 Specifications, Requirements, and Precautions 1050 1150 Wavelength (nm) Fig. 10: acA2500-14um Spectral Response (From Sensor Data Sheet) 1000 Wavelength (nm) Fig. 11: acA3800-14um Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 30: Color Camera Spectral Response

    700 ... 720 nm, and it should cut off from 700 ... 720 nm to 1100 nm. A suitable IR cut filter is built into the cylindric housing extension in color models of the camera. Blue Green Wavelength (nm) Fig. 12: acA640-90uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 31 AW00123404000 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 13: acA640-120uc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 14: acA645-100uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 32 Specifications, Requirements, and Precautions AW00123404000 Blue Green 4 00 5 00 60 0 Wavelength (nm) Fig. 15: acA1300-30uc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 16: acA1600-20uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 33 AW00123404000 Specifications, Requirements, and Precautions Blue Green 35 0 Wavelength (nm) Fig. 17: acA1920-25uc Spectral Response (From Sensor Data Sheet) Blue Green 1000 Wavelength (nm) Fig. 18: acA1920-155uc (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 34 Specifications, Requirements, and Precautions AW00123404000 Blue Green Wavelength (nm) Fig. 19: acA2000-165uc, acA2040-90uc Spectral Response (From Sensor Data Sheet) Blue Green 35 0 6 00 65 0 Wavelength (nm) Fig. 20: acA2500-14uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 35 AW00123404000 Specifications, Requirements, and Precautions Blue Green Wavelength (nm) Fig. 21: acA3800-14uc Spectral Response (From Sensor Data Sheet) Blue Green Wavelength (nm) Fig. 22: acA4600-10uc Spectral Response (From Sensor Data Sheet) Basler ace USB 3.0...
  • Page 36: Mechanical Specifications

    CS-mount are as shown in Figure 24 Camera housings are equipped with mounting screw holes on the bottom as shown in the drawings. For mounting instructions, see Section 1.5 on page Basler ace USB 3.0...
  • Page 37 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. 23: Mechanical Dimensions (in mm) for Cameras with the C-mount Basler ace USB 3.0...
  • Page 38 20.7 29.3 14.5 36.3 2 x M2; 4 deep Reference Plane Not to Scale Fig. 24: Mechanical Dimensions (in mm) for Cameras with the CS-mount Note: acA1920-20gm/gc cameras are not available with CS-mount. Basler ace USB 3.0...
  • Page 39: Maximum Allowed Lens Thread Length

    Note that on color cameras, the filter holder will be populated with an IR cut filter. On monochrome cameras, the filter holder will be present, but will not be 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 40 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. 26: Maximum Lens Thread Length (Dimensions in mm) for Cameras with the CS-mount Basler ace USB 3.0...
  • Page 41: Mounting Instructions

    1. Tighten the screws for the mounting screw holes (a) in Figure 27. 2. Tighten the screws for the mounting screw holes (b) in Figure 27. Bottom Fig. 27: Designations of the Mounting Screw Holes for the M2 Screws. Basler ace USB 3.0...
  • Page 42: Tightening Sequence When Using The M3 Screws

    1. Tighten the screws for the mounting screw holes (a) in Figure 28. 2. Tighten the screw for mounting screw hole (b) in Figure 28. Bottom Fig. 28: Designations of the Mounting Screw Holes for the M3 Screws. Basler ace USB 3.0...
  • Page 43: 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 44: 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 45: 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 46: Environmental Requirements

    To ensure good image quality, we recommend not to operate the camera at elevated temperatures. Basler ace USB 3.0...
  • Page 47: 1.10 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 48 The plug on the cable that you attach to the camera’s USB 3.0 Micro-B port must be  designed for use with the USB 3.0 Micro-B port. Trying to use any other type of plug can destroy the port. Basler ace USB 3.0...
  • Page 49 Do not use solvents or thinners to clean the housing; they can damage the surface finish. Read the manual Read the manual carefully before using the camera! Basler ace USB 3.0...
  • Page 50 Specifications, Requirements, and Precautions AW00123404000 Basler ace USB 3.0...
  • Page 51: Installation

    LPS requirements. The camera is designed to be connected to a USB 3.0 port installed in your PC. When connected to a USB 2.0 port, the Basler ace USB 3.0 camera will be detected but will not operate.
  • Page 52 Installation AW00123404000 Note: We highly recommend using components such as host adapters with specific chipsets, cables, and hubs that are offered as Basler accessories. They were extensively tested for optimum performance. For more information about recommended components, see the Recommended Accessories for Basler USB 3.0 Cameras specification (DG001115).
  • Page 53: Camera Drivers And Tools For Changing Camera Parameters

    Basler cameras that have an IEEE 1394 interface, a GigE interface or a USB 3.0 interface. It will also operate some newer Basler camera models with a Camera Link interface. The pylon drivers offer reliable, real-time image data transport into the memory of your PC at a very low CPU load.
  • Page 54: The Pylon Viewer

    3.1.1 The pylon Viewer The pylon Viewer is included in the Basler pylon 4 Camera Software Suite. The pylon Viewer is a standalone application that lets you view and change most of the camera’s parameter settings via a GUI-based interface. All parameters and parameter values displayed by the pylon Viewer are loaded from the camera into the pylon Viewer.
  • Page 55: The Pylon Sdk

    API. The programmer’s guide and API reference are included in the Basler pylon 4 Camera Software Suite. The Basler pylon SDK includes a set of sample programs that illustrate how to use the pylon API to parameterize and operate the camera. These samples include Microsoft® Visual Studio® solution and project files demonstrating how to set up the build environment to build applications based on the API.
  • Page 56 Camera Drivers and Tools for Changing Camera Parameters AW00123404000 Basler ace USB 3.0...
  • Page 57: 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 58 Frame Trigger Wait Signal or Exposure Active Signal or Buffer Timer 1 Signal Image Image Data Data FPGA Sensor Controller Image and Image Control Data Control Power Data Control: Gain, Black Level Control: ROI Fig. 30: Camera Block Diagram Basler ace USB 3.0...
  • Page 59: Overview

    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 60 Flash Window Signal or Timer 1 Signal *not available for acA3800-14 and aA4600-10 cameras Image Image Data Data Sensor FPGA Controller Image and Image Control Data Control Power Data Control: ROI, Gain, Black Level Fig. 32: Camera Block Diagram Basler ace USB 3.0...
  • Page 61: Physical Interface

    Note that Basler recommends specific external components - host adapters, cables, hubs - for use with Basler ace USB 3.0 cameras. Recommended external components are listed in the document named Recommended Components for Basler USB 3.0 Cameras (DG001115). You can download the document from our website: www.baslerweb.com...
  • Page 62: 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 10: Pin Assignments for the 6-pin Connector and Related Designations Basler ace USB 3.0...
  • Page 63: Usb3.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 64: Camera Cabling Requirements

    Use a high-quality USB 3.0 cable. If possible only use a cable that was recommended in document DG001115 and preferably 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 65: 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 66 You must supply camera power in accord with the Universal Serial Bus 3.0 specification and involve a power supply that meets the Safety Extra Low Voltage (SELV) and Limited Power Source (LPS) requirements. Power consumption is as shown in the specification tables in Section 1 of this manual. Basler ace USB 3.0...
  • Page 67: Opto-Isolated Input (Pin 2/Line 1)

    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 68 (Section 5.9 on page 63). 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 69 For more information about how to use an externally generated frame start trigger (ExFSTrig) signal to control acquisition start, see Section 6.4 on page 111. For more information about configuring the input line, see Section 5.11 on page Basler ace USB 3.0...
  • Page 70: Opto-Isolated Output (Pin 4/Line 2)

    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 71 (see Section 5.7.1 on page 57). 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 72 Fig. 37: Opto-isolated Output Line Schematic with a Typical LED Output Signal at +24 VDC for the External Circuit (Simplified) For more information about output line pin assignments and pin numbering, see Section 5.2 on page For more information about the Exposure Active signal, see Figure 6.8.1 on page 148. Basler ace USB 3.0...
  • Page 73: Direct-Coupled General Purpose I/O (Gpio; Pin 1/Line 3, Pin 3/Line 4)

    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 74 Direct-coupled GPIO lines have the advantage of working with very short delays compared to opto-isolated I/O lines. The direct-coupled GPIO lines are, however, distinctly more susceptible to electromagnetic interference. We therefore strongly recommend to only use the direct-coupled GPIO lines when significant electromagnetic interference will not occur. Basler ace USB 3.0...
  • Page 75: 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 39. Basler ace USB 3.0...
  • Page 76 (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 76 Section 5.12 on page Basler ace USB 3.0...
  • Page 77: 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 78 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 76 Section 5.12 on page Basler ace USB 3.0...
  • Page 79: 5.10 Temporal Performance Of I/O Lines

    GPIO lines. In other words, the opto-isolated I/O lines are usually "slower" than the GPIO 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 by an asterisk. Basler ace USB 3.0...
  • Page 80  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 81 #: 3.3 - 24 VDC for opto-isolated input, >2.0 - 5.0 VDC for direct-coupled GPIO IN Fig. 41: 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 82 = Propagation delay for the high-low line status change Drawing not to scale Opto-isolated OUT Direct-coupled GPIO OUT Time Fig. 42: 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 83: Factors Determining I/O Temporal Performance

    • Load current: º Depends on application but must be within specified ranges; see Section 5.7 through Section 5.9. • Table 15: Factors Influencing Camera I/O Propagation Delays ( = major influence, = minor influence) º Basler ace USB 3.0...
  • Page 84: Measured Propagation Delays

    (rising edge) = 170 Ω, U Table 17: 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 41 Figure Basler ace USB 3.0...
  • Page 85: Recommendations For Using Camera I/Os

    To avoid jitter, make sure the slopes 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 86: 5.11 Configuring Input Lines And Signals

    1 reset and for details about how the counter value chunk feature operates, see  Section 8.18.3.5 on page 300. By default, input line Line 1 is selected as the source signal for the frame start trigger. Basler ace USB 3.0...
  • Page 87: Input Line Debouncers

    The diagram also illustrates how the debouncer delays a valid signal. Unfiltered arriving signals Debouncer debouncer value Transferred valid signal delay Timing charts are not drawn to scale Fig. 43: Filtering of Input Signals by the Debouncer Basler ace USB 3.0...
  • Page 88 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 89: 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 43...
  • Page 90: 5.12 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 91 Section 5.12.6 on page 88  setting the status of a user settable output line, see Section 5.12.3 on page  the electrical characteristics of the opto-isolated output line, see Section 5.8 on page  Basler ace USB 3.0...
  • Page 92: 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. 44: Increasing the Signal Width of an Output Signal Basler ace USB 3.0...
  • Page 93 // 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 94: Setting The Status Of An Individual User Settable Output Line

    You can set the Output Selector and the User Output Value parameters from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to designate an output line as user settable, set the status of the output line, and get informed about...
  • Page 95: 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 96 // Reading all user output values with a single operation int64_t i = camera.UserOutputValueAll.GetValue(); Set the value of the User Output Value parameter to true (1) or false (0). This will set the status of the output line. Basler ace USB 3.0...
  • Page 97: 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 98: Working With The Timer Output Signal

    1. Use the Timer Selector to select Timer 1. 2. Set the value of the Timer Trigger Source 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 99: Setting The Timer Delay Time

    2. Set the value of the Timer Delay parameter. You can set the Timer Selector and the Timer Delay 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 100: Setting The Timer Duration Time

    2. Set the value of the Timer Duration parameter. You can set the Timer Selector and the Timer Duration 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 101 Voltage Level High True Enabled Input Open or False Connection at z Status Voltage Level Low True Voltage Level High False Table 19: Line Status for Different External Conditions: Line 3, Line 4 (Direct-coupled GPIO Input) Basler ace USB 3.0...
  • Page 102: 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 10 on page 52, and for line schematics, see Figure Figure Figure Basler ace USB 3.0...
  • Page 103 False Enabled Disabled False Enabled True High Pull-Up Disabled Disabled True High Disconnected Enabled False Enabled Disabled False Enabled True High Table 21: Line Status for Different External Conditions: Lines 3 and 4 (Direct-coupled GPIO Output) Basler ace USB 3.0...
  • Page 104: 5.14 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 48, each bit from bit 0 through 3 is associated with a different I/O line.
  • Page 105: Checking The Status Of An Individual I/O Line

    You can set the Line Selector and read the Line Status parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and read the parameter value: // Select output line Line 2 and read the status camera.LineSelector.SetValue(LineSelector_Line2);...
  • Page 106 Physical Interface AW00123404000 Basler ace USB 3.0...
  • Page 107: 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 108 The rate at which the camera will generate the signals and acquire frames will be determined by the way that you set several frame rate related parameters. Basler ace USB 3.0...
  • Page 109 "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. 49: Frame Burst Start and Frame Start Triggering Basler ace USB 3.0...
  • Page 110 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 111: Acquisition Start And Stop Commands And The Acquisition Mode

    "overlapped" exposure. To achieve the maximum possible acquisition frame rate, set the camera for the continuous acquisition mode and use "overlapped" exposure. For more information about overlapped exposure, see Section 6.9 on page 162. Basler ace USB 3.0...
  • Page 112 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 113: 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 114 Falling Edge - specifies that a falling edge of the electrical signal will act as the frame burst  start trigger. When the Trigger Mode parameter for the frame burst start trigger is set to on, the camera’s Acquisition Mode parameter must be set to continuous. Basler ace USB 3.0...
  • Page 115: Acquisition Burst Frame Count

    "waiting for frame burst start trigger" acquisition status. At that point, you must apply a new frame burst start trigger signal to exit the camera from the "waiting for frame burst start trigger" acquisition status. Basler ace USB 3.0...
  • Page 116: Setting The Frame Burst Start Trigger Mode And Related Parameters

    // 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...
  • Page 117: Using A Software Frame Burst Start Trigger

    "waiting for frame start trigger" acquisition status. (Note that as long as the Trigger Selector parameter is set to Frame Burst Start, a software frame burst start trigger will be applied to the camera each time a Trigger Software command is executed.) Basler ace USB 3.0...
  • Page 118: 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 119: 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.2.1 on page Basler ace USB 3.0...
  • Page 120: 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 121: The Frame Start Trigger

    Section 6.1 on page 97 and Section 6.3 on page 103. Referring to the use case diagrams that appear in Section 6.9 on page 162 can help you understand the explanations of the frame start trigger. Basler ace USB 3.0...
  • Page 122: Frame Start Trigger Mode

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

    Keep in mind that the camera will only react to frame start trigger signals when it is in a "waiting for frame start trigger" acquisition status. For more information about the acquisition status, see Section 6.1 on page 97 and Section 6.3 on page 103. Basler ace USB 3.0...
  • Page 124: Setting The Frame Start Trigger Mode And Related Parameters

    You can set the Trigger Mode and related parameter values for the frame start trigger from within your application software by using the Basler pylon API. If your settings make it necessary, you can also set the Trigger Source parameter.
  • Page 125 Image Acquisition Control // 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 126: Using A Software Frame Start Trigger

    Section 6.4.2.2 on page 117 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 165.
  • Page 127: Setting The Parameters Related To Software Frame Start Triggering And Applying A Software Trigger Signal

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

    ExFSTrig signal, see Section 6.4.3.4 on page 125. For more information about the electrical characteristics of Line 1, see Section 5.7.1 on page For more information about determining the maximum allowed frame rate, see Section 6.10 on page 165. Basler ace USB 3.0...
  • Page 129: Exposure Modes

    ExFSTrig signal falls. Figure 51 illustrates timed exposure with the camera set for rising edge triggering. ExFSTrig Signal Period ExFSTrig Signal Exposure (duration determined by the Exposure Time parameter) Fig. 51: Timed Exposure with Rising Edge Triggering Basler ace USB 3.0...
  • Page 130 When you operate the camera in trigger width exposure mode, you must also set the camera’s Exposure Overlap Time Max parameter. This parameter setting will be used by the camera to operate the Frame Trigger Wait signal. Basler ace USB 3.0...
  • Page 131 5500 µs. In this case you would set the camera’s Exposure Overlap Time Max parameter to 3000 µs. For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max parameter, see Section 6.8.4 on page 153. Basler ace USB 3.0...
  • Page 132 Fig. 54: Trigger Width Exposure with Adjusted Rising Edge Triggering; (Exposure Start Delays Is Omitted) Note that C is identical to the camera’s minimum allowed exposure time. For the camera’s minimum allowed exposure times, see Table 23 on page 127. Basler ace USB 3.0...
  • Page 133 8 bit acA2000-165 and acA2040-90; 12 bit acA1920-155; 8 bit, 12 bit Device Link Throughput [MByte/s] Fig. 55: Exposure Time Offsets Depending on Device Link Throughput; All 8 bit- and 12 bit-Pixel Formats Basler ace USB 3.0...
  • Page 134 To achieve the wanted exposure time of 100 µs, you would therefore keep the ExFSTrig signal high for 68 µs (= 100 µs - 32 µs). Subsequently, the camera would add automatically 32 µs, giving a total of 100 µs exposure time which is the wanted exposure time. Basler ace USB 3.0...
  • Page 135: Frame Start Trigger Delay

    You can set all of the parameters needed to perform hardware frame start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the camera for single frame acquisition mode with the trigger mode for the frame burst start trigger set to off.
  • Page 136 // 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 137: Setting The Exposure Time Parameter

    Maximum Possible Increment acA640-90um/uc 10000000 acA640-120um/uc 10000000 acA645-100um/uc 10000000 acA1300-30um/uc 10000000 acA1600-20um/uc 10000000 acA1920-25um/uc 9999990 acA1920-155um/uc 10000000 acA2500-14um/uc 9999990 acA3800-14um/uc 1600000 acA4600-10uc 1460000 Table 23: Minimum Allowed Exposure Time Settings, Maximum Possible Exposure Time Settings and Increments. Basler ace USB 3.0...
  • Page 138: Exposure Times For The Aca2000-165 And Aca2040-90

    192.112 ≤ >192.112 to 216.000 ≤ >216.000 to 280.000 ≤ >280.000 to 320.040 ≤ >320.040 to 360.000 ≤ >360.000 to 384.224 All allowed values 10000000 Table 24: Minimum Allowed and Maximum Possible Exposure Times With Dependencies Basler ace USB 3.0...
  • Page 139: Setting The Parameter Value

    6.5.3 Setting the Parameter Value You can use the Basler pylon API to set the Exposure Time 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 140: Electronic Shutter Operation

    You can determine the readout time for a frame by checking the value of the camera’s Sensor Readout Time parameter. Basler ace USB 3.0...
  • Page 141 = line readout Fig. 57: Global Shutter For more information about the exposure active output signal, see Section 6.8.1 on page 148. For more information about the Sensor Readout Time parameter, see Section 6.9 on page 162. Basler ace USB 3.0...
  • Page 142: 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 143 525 µs 525 µs 525 µs acA2500-14uc 525 µs 525 µs 525 µs acA3800-14uc 3561 µs 4461 µs 4101 µs acA4600-10uc 4521 µs 5439 µs 4980 µs Table 27: Exposure Overhead Time for Color Cameras Basler ace USB 3.0...
  • Page 144 If the camera is operating with the rolling shutter in ERS mode and you are using the camera to capture images of moving objects, the use of flash lighting is most strongly recommended. The camera supplies a flash window output signal to facilitate the use of flash lighting. Basler ace USB 3.0...
  • Page 145 And so on until the bottom line of pixels is reached (see Figure 59). 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 146 Exposure Active signal instead, if available. For more information about the Exposure Active signal, see Section 6.8.1 on page 148. Basler ace USB 3.0...
  • Page 147 For more information about the exposure active output signal, see Section 6.8.1 on page 148. For more information about the Exposure Time parameter, see Section 6.5 on page 127. For more information about the flash window, see Section 6.6.2.1 on page 138. Basler ace USB 3.0...
  • Page 148: The Flash Window

    When the global reset release mode is set, the shutter will operate in global reset release mode. 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 electronic rolling shutter mode camera.ShutterMode.SetValue(ShutterMode_Rolling);...
  • Page 149 Flash Window Width = line exposure time = line readout time Fig. 60: Flash Window for Rolling Shutter in the ERS Mode For more information about the Exposure Time parameter, see Section 6.5 on page 127. Basler ace USB 3.0...
  • Page 150 Flash Window Width = line exposure time = line readout time Fig. 61: Flash Window for Rolling Shutter in the Global Reset Release Mode For more information about the Exposure Time parameter, see Section 6.5 on page 127. Basler ace USB 3.0...
  • Page 151 The flash window signal will go high when the flash window for each image acquisition opens and will go low when the flash window closes. For more information about the flash window signal, see Section 6.8.2 on page 150. Basler ace USB 3.0...
  • Page 152: 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 63 with the camera set for the trigger width exposure mode. Basler ace USB 3.0...
  • Page 153 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 154 For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max parameter, see Section 6.8.4 on page 153. For more information about trigger width exposure, see Section 6.4.3.2 on page 119. Basler ace USB 3.0...
  • Page 155: Overlapping Image Acquisitions For Aca1920-25, Aca2500-14, Aca3800-14

    Fig. 65: 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 66. Basler ace USB 3.0...
  • Page 156 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 157 Frame Acquisition N+2 Time = Line Exposure = Line Readout Fig. 67: 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 158: Acquisition Monitoring Tools

    When you use the exposure active signal, be aware that there is a delay in the rise and the fall of the signal in relation to the start and the end of exposure. See Figure 68 for details. Basler ace USB 3.0...
  • Page 159  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 160: Flash Window Signal

    Image Acquisition Control AW00123404000 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 161  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 162: 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 163: 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 164 Fig. 71: 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 8.13 on page 277. Basler ace USB 3.0...
  • Page 165: 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 166 The frame trigger wait signal will only be available when hardware frame start triggering is enabled. For more information about event notification, see Section 8.13 on page 277. For more information about hardware triggering, see Section 6.3.5 on page 109 and Section 6.4.3 page 118. Basler ace USB 3.0...
  • Page 167 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. 73: Frame Trigger Wait Signal with the Timed Exposure Mode Basler ace USB 3.0...
  • Page 168 ExFSTrig signal to vary the exposure time in a range from 3000 µs to 5500 µs. In this case you would set the camera’s Exposure Overlap Time Max parameter to 3000 µs. Basler ace USB 3.0...
  • Page 169 AW00123404000 Image Acquisition Control You can use the Basler pylon API to set the Exposure Overlap Time Max parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: camera.ExposureOverlapTimeMax.SetValue( 3000.0 );...
  • Page 170 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. 75: Frame Trigger Wait Signal on a Rolling Shutter Camera Basler ace USB 3.0...
  • Page 171: Camera Events

     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 172: Acquisition Timing Chart

    The transmission start delay can vary between frames and largely depends on when the host PC 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 173 Transmission Start Delay Transmission Start Delay Frame N Transmission to Host PC Frame Frame N+1 Transmission to Host PC Transmission Timing charts are not drawn to scale Fig. 76: Exposure Start Controlled with an ExFSTrig Signal Basler ace USB 3.0...
  • Page 174 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 175: 6.10 Maximum Allowed Frame Rate

     (Support > Tools > Frame Rate Calculator): www.baslerweb.com You can use the Basler pylon API to read the value of the camera’s Resulting Frame Rate  parameter (see the next page). For more information about Image ROI Height settings, see Section 8.5 on page 207.
  • Page 176: 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 177: 6.10.2 Increasing The Maximum Allowed Frame Rate

    For more information about Image ROI settings, see Section 8.5 on page 207. For more information about the ERS mode, see Section 6.6.2 on page 132. Basler ace USB 3.0...
  • Page 178: 6.11 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.3.1.1 on page 103. Basler ace USB 3.0...
  • Page 179 = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Frame Burst Start Trigger Signal Frame Start Trigger Signal Time Fig. 77: Use Case 1 - Frame Burst Start Trigger Off and Frame Start Trigger Off Basler ace USB 3.0...
  • Page 180 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 181 Start Stop Command Command Executed Executed Frame Burst Start Trigger Signal Frame Start Trigger Signal (applied to Line 1) Time Fig. 78: Use Case 2 - Frame Burst Start Trigger Off and Frame Start Trigger On Basler ace USB 3.0...
  • Page 182 (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 103. Basler ace USB 3.0...
  • Page 183 Start Stop Command Command Executed Executed Frame Burst Start Trigger Signal (applied to Line 1) Frame Start Trigger Signal Time Fig. 79: Use Case 3 - Frame Burst Start Trigger On and Frame Start Trigger Off Basler ace USB 3.0...
  • Page 184 (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 185 Command Command Executed Executed Frame Burst Start Trigger Software Command Executed Frame Start Trigger Signal (applied to Line 1) Time Fig. 80: Use Case 4 - Frame Burst Start Trigger On and Frame Start Trigger On Basler ace USB 3.0...
  • Page 186 Image Acquisition Control AW00123404000 Basler ace USB 3.0...
  • Page 187: Color Creation And Enhancement

    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 188: Bayer Color Filter Alignment

    Bayer filter must be adjusted in increments of 2, the color filter alignment will remain as Bayer BG or Bayer GB regardless of the camera’s region of interest (ROI) settings. For more information about the camera’s ROI feature, see Section 8.5 on page 207. Basler ace USB 3.0...
  • Page 189: Pixel Formats Available On Color Cameras

    For each pixel covered with a green portion of the filter, you get 8 or 12 bits of green data. And for each pixel covered with a blue portion of the filter, you get 8 or 12 bits of blue data. (This type of pixel data is sometimes referred to as "raw" output.) Basler ace USB 3.0...
  • Page 190 So in essence, when a color camera is set for Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) Basler ace USB 3.0...
  • Page 191: 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.4.2 on page Basler ace USB 3.0...
  • Page 192: Color Enhancement Features

    If color binning is enabled for the acA1920-25uc, white balancing will be applied after color binning was performed. For more information about color binning, see Section 8.7.2 on page 245. Basler ace USB 3.0...
  • Page 193 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:...
  • Page 194: Light Source Presets

    // Select the color for white balancing and set the related BalanceRatio value camera.BalanceRatioSelector.SetValue(BalanceRatioSelector_Green); camera.BalanceRatio.SetValue(1.25); 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 7.3.2...
  • Page 195 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 196: Color Adjustment (All Color Cameras Except Aca2000-165 And Aca2040-90)

    If color binning is enabled for the acA1920-25uc or acA2500-14uc, color adjustment will be applied after color binning was performed. For more information about color binning, see Section 8.7.2 on page 245. Basler ace USB 3.0...
  • Page 197 Hue specifies the kind of coloration, for example, whether the color is red, yellow, orange etc.  Saturation expresses the colorfulness of a color. At maximum saturation, no shade of gray is  present. At minimum saturation, no "color" but only some shade of gray (including black and white) is present. Basler ace USB 3.0...
  • Page 198 Fig. 82: RGB Color Cube With YCM Secondary Colors, Black, and White, Projected On a Plane Gray Decrease Saturation Adjustment Increase Adjustment Fig. 83: Hue and Saturation Adjustment In the Color Hexagon. Adjustments Are Indicated for Red as an Example Basler ace USB 3.0...
  • Page 199 0.0 to +1.99219. Saturation is not changed when the parameter value is set to 1. The default value after camera reset or power up is close to 1. Basler ace USB 3.0...
  • Page 200 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 201: Color Transformation

    If color binning is enabled for the acA1920-25ucor and acA2500-14, the color transformation matrix will be applied after color binning was performed. For more information about color binning, see Section 8.7.2 on page 245. Basler ace USB 3.0...
  • Page 202 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 203: A Procedure For Setting The Color Enhancements

    Since it makes changing camera parameters quick and easy, we also recommend using the Basler pylon Viewer software when you are making adjustments. Note: The procedure aims at producing a color reproduction on a monitor that is optimized for human vision.
  • Page 204 Certain conditions outside the camera, such as the lighting, the camera lens, filter or the monitor settings are relevant to the reproduction of color in the image. If you change any of these conditions you will have to repeat the above procedure to preserve optimum color reproduction. Basler ace USB 3.0...
  • Page 205: Features

    The analog gain feature is not available for the acA1920-25, acA3800-14, and acA 4600-10 cameras. To obtain an effect similar to adjusting analog gain, use the digital shift feature For more information about the digital shift feature, see Section 8.4 on page 201. Basler ace USB 3.0...
  • Page 206: Setting The Gain

    23.5935 db 23.5935 db acA2500-14um/uc 0.0 db 0.0 db 23.79814 db 23.79814 db acA3800-14um/uc 0.0 db 0.0 db 16.67569 db 16.67569 db acA4600-10uc 0.0 db 17.76052 db 17.76052 db Table 34: Regular Minimum and Maximum Gain Settings Basler ace USB 3.0...
  • Page 207 2. Set the Gain parameter to your desired value. You can set the Gain Selector 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

    15.98438 255.75 acA1600-20um/uc 15.98438 255.75 acA1920-25um/uc 15.9375 255.0 acA1920-155um/uc 31.9375 511.0 acA2000-165um/umNIR/uc 15.9375 255.0 acA2040-90um/umNIR/uc 15.9375 255.0 acA2500-14um/uc 15.9375 255.0 acA3800-14um/uc 63.9375 1023 acA4600-10uc 63.9375 1023 Table 35: Minimum and Maximum Black Level Settings ([DN]) Basler ace USB 3.0...
  • Page 209 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 210: 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 211: Digital Shift

    When the camera is set to shift by 1, the least significant bit output from the camera for each pixel value will be 0. This means that no odd gray values can be output and that the gray value scale will Basler ace USB 3.0...
  • Page 212 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 213: 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 214 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 215: 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 216: 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 217: 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 165. Basler ace USB 3.0...
  • Page 218 Settings with Binning Disabled The minimum settings and minimum increments for Offset X, Offset Y, 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 219 Incre- Incre- Incre- ment ment ment ment acA640-90um acA640-120um acA645-100um acA1300-30um acA1600-20um acA1920-25um acA1920-155um acA2000-165um acA2000-165umNIR acA2040-90um acA2040-90umNIR acA2500-14um acA3800-14um Table 36: Minimum Settings and Increments for Positioning an Image ROI in Mono Cameras (without Binning) Basler ace USB 3.0...
  • Page 220 Incre- Incre- Incre- Incre- ment ment ment ment acA640-90uc acA640-120uc acA645-100uc acA1300-30uc acA1600-20uc acA1920-25uc acA1920-155uc acA2000-165uc acA2040-90uc acA2500-14uc acA3800-14uc acA4600-10uc Table 37: Minimum Settings and Increments for Positioning an Image ROI in Color Cameras (without Binning) Basler ace USB 3.0...
  • Page 221 4 Enabled acA640-90um acA640-120um acA645-100um acA1300-30um acA1600-20um acA1920-25um acA1920-25uc acA1920-155um acA2000-165um acA2000-165umNIR acA2040-90um acA2040-90umNIR acA2500-14um acA2500-14uc acA3800-14um 2748 1374 Table 38: Minimum ROI Height Settings when Vertical Binning is Disabled and Enabled (Mono Cameras, acA1920-25uc, and acA2500-14uc) Basler ace USB 3.0...
  • Page 222 You can set the Offset X, Offset Y, Width, and Height parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to get the maximum allowed settings for the Width and Height parameters. They also illustrate setting the Offset X, Offset Y, Width, and Height parameter values: int64_t i = camera.WidthMax.GetValue();...
  • Page 223: Center X And Center Y

    The Offset Y setting behaves analogously when Center Y is enabled and disabled. 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 224: Sequencer

    The sequencer configuration mode must be set to On and the sequencer mode must be set to Off. In the sequencer mode (also called "sequencer mechanism"), the sequencer sets can be  used for image acquisition but not be configured. The sequencer mode must be set to On. Basler ace USB 3.0...
  • Page 225: The Sequencer And The Active Set

    Sequencer set related parameters for sequencer control. The parameters define the  details of advancing from one sequencer set to the next. This includes the possibility of choosing between different "paths" for advance, thus allowing to choose between different sequencer sets (see Figure 86 Section 8.6.2.2). Basler ace USB 3.0...
  • Page 226: Camera Parameters

    2) 3) BlackLevel ColorAdjustmentSaturation DigitalShift ColorTransformationValue OffsetX ChunkModeActive OffsetY ChunkEnable Width TestImageSelector Parameter is only available for acA2000-165 and acA2040-90 cameras. Parameter is only available for color cameras. Parameter is not available for acA2000-165uc and acA2040-90uc cameras. Basler ace USB 3.0...
  • Page 227: 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 set to be loaded and used for an image acquisition.
  • Page 228 The triggers from the other sequencer trigger sources select and load the next sequencer set.  The mechanisms are presented in greater detail in the following table and sections: Basler ace USB 3.0...
  • Page 229 The sequencer set advance is therefore not tied to frame start triggers and, accordingly, will be asynchronous to the frame start trigger. The sequencer trigger sources for asynchronous triggers are Software Signal 1, Software Signal 2, Software Signal 3 (see also Section 8.6.2.2 on page 217). Basler ace USB 3.0...
  • Page 230 69 for information about making optimum use of the temporal performance of the GPIO lines. See Section 5.9 on page 63 about the limitations of use of GPIO lines in an environment with significant electromagnetic interference. Basler ace USB 3.0...
  • Page 231 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 40 and use case 3). Basler ace USB 3.0...
  • Page 232: 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 233: 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 234 // 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 235: 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 236: 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 237 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 238 Trigger for path 0 Sequencer set 3 Sequencer set 2 in the active set in the active set Trigger for path 1 Fig. 87: State Diagram for the "Sequencer Mode" (Start and Operation; Four Sequencer Sets as an Example) Basler ace USB 3.0...
  • Page 239: Sequencer Use Case Descriptions And Diagrams

    Trigger activation Level High** Level High** Level High** Level High** Table 41: 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 240 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 241 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 242 In this case, the complete frame will be transmitted even after the sequencer feature was disabled. The previous sequencer parameter values, occurring in the active set before the sequencer feature was enabled, are loaded into the active set again, overwriting the parameter values of sequencer set 0. Basler ace USB 3.0...
  • Page 243 Line 3 (GPIO) Trigger Source, Path 0 Line 4 (GPIO) Trigger Source, Path 1 Frame Start Trigger Signal Time Fig. 88: Use Case 1 - Synchronous Cycling Through Sequencer Sets According to Path 1, No Reset Basler ace USB 3.0...
  • Page 244 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 245 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 246 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 247 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 248 Trigger Source, Path 0 Counter 2 End Trigger Source, Path 1 Frame Start Trigger Signal Time Fig. 89: Use Case 2 - Synchronous Cycling Through Sequencer Sets Based on Counter 2 End (Path 1), One Reset. Basler ace USB 3.0...
  • Page 249 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 250 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 251 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 252 Software Signal 1 Trigger Source, Path 0 Software Signal 3 Trigger Source, Path 1 Frame Start Trigger Signal Time Fig. 90: Use Case 3 - Asynchronous Cycling Through Sequencer Sets According to Path 1, One Reset Basler ace USB 3.0...
  • Page 253: Binning

    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 254 For more information about possible image distortion due to combined vertical and horizontal binning, see Section 8.7.4 on page 247. Vertical binning by 3 and horizontal binning by 3 are not available for acA3800-14um cameras. Basler ace USB 3.0...
  • Page 255: Binning On Color Cameras (Aca1920-25Uc And Aca2500-14Uc Only)

    The number of binned pixels depends on the horizontal color binning setting (see example in Figure 94). Example: Horizontal Color Binning by 2 (Shown for 2 Rows) Fig. 94: Horizontal Color Binning by 2 Basler ace USB 3.0...
  • Page 256: 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 257: Considerations When Using Binning

    In other words, and expressed in therms of the physical sensor: An effective image ROI was created 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 258 Binning’s Effect on Decimation If vertical binning is used, vertical decimation (see below) is automatically disabled, and vice versa, i.e. if vertical decimation is used, vertical binning is disabled. Horizontal binning works independently of the decimation vertical feature. Basler ace USB 3.0...
  • Page 259: Decimation Vertical (Aca3800-14 And Aca4600-10 Only)

    You can enable vertical decimation for the acA2000-165 and acA2040-90 cameras by setting the Decimation Vertical parameter. The parameter value can be set to 1, 2, and 4. Setting the parameter value to 1 disables vertical decimation. Basler ace USB 3.0...
  • Page 260: Considerations When Using Decimation

    Features AW00123404000 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 261 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 262: Mirror Image

    ROI relative to the sensor remains the same regardless of whether or not the reverse X feature is enabled (see Figure 101). As a consequence, an ROI will display different images depending on whether or not the reverse X feature is enabled. Basler ace USB 3.0...
  • Page 263 You can enable or disable the reverse X 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 264: Reverse Y (Aca2000-165 And Aca2040-90 Only)

    ROI relative to the sensor remains the same regardless of whether or not the reverse Y feature is enabled (see Figure 103). As a consequence, an image ROI will display different images depending on whether or not the reverse Y feature is enabled. Basler ace USB 3.0...
  • Page 265 You can enable or disable the reverse X 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 266: 8.10 Luminance Lookup Table

    The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the digitized sensor output moves from 0 through 2048 and increases gradually as the digitized sensor output moves from 2049 through 4096. Basler ace USB 3.0...
  • Page 267 Fig. 104: 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. 105: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler ace USB 3.0...
  • Page 268 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 269: 8.11 Gamma Correction

    1 will result in decreased overall brightness. In all cases, black (output pixel brightness equals 0) and white (output pixel brightness equals 255 at 8 bit output and 4095 at 12 bit output) will not be corrected. Basler ace USB 3.0...
  • Page 270 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 271: 8.12 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 8.7 on page 243. Basler ace USB 3.0...
  • Page 272: 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 273: 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. 106: Auto Function Region of Interest and Image Region of Interest Basler ace USB 3.0...
  • Page 274: Assignment Of An Auto Function To An Auto Function Roi

    // Assign auto functions to the selected Auto Function ROI camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI1); camera.AutoFunctionAOIUseBrightness.SetValue(true); camera.AutoFunctionAOIUseWhiteBalance.SetValue(true); // Select the unused Auto Function ROI 2 // Disable the unused Auto Function ROI camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI2); camera.AutoFunctionAOIUseBrightness.SetValue(false); camera.AutoFunctionAOIUseWhiteBalance.SetValue(false); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace USB 3.0...
  • Page 275: 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 276 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. 107: Various Degrees of Overlap Between the Auto Function ROI and the Image ROI Basler ace USB 3.0...
  • Page 277: 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 278 0 ); camera.AutoFunctionAOIWidth.SetValue(1294); camera.AutoFunctionAOIWidth.GetMax(); camera.AutoFunctionAOIHeight.SetValue(964); camera.AutoFunctionAOIHeight.GetMax(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3.1 on page Basler ace USB 3.0...
  • Page 279: 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 280 // 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 281: 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 282 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 283 // 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 8.12 on...
  • Page 284: Auto Function Profile

    If you want to use the gain auto and the exposure auto functions at the same time, you should set both functions for the continuous mode of operation. Setting the camera with Basler pylon to use the gain auto function and the exposure auto function at the same time is a several step process: To set the auto function profile using Basler pylon: 1.
  • Page 285: Balance White Auto

    0 ); camera.AutoFunctionAOIOffsetY.SetValue( 0 ); camera.AutoFunctionAOIWidth.SetValue( camera.AutoFunctionAOIWidth.GetMax() ); camera.AutoFunctionAOIHeight.SetValue( camera.AutoFunctionAOIHeight.GetMax() ); // Set mode of operation for balance white auto function camera.BalanceWhiteAuto.SetValue(BalanceWhiteAuto_Once); You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace USB 3.0...
  • Page 286: Using An Auto Function

    263. 8.12.8 Using an Auto Function 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. 3. Unassign the auto function you want to use from the other Auto Function ROI.
  • Page 287: 8.13 Event Notification

    The unit for the timer is "ticks" where one tick = 1 ns. The timestamp is a 64 bit value.) 2. The event is placed in an internal queue in the camera. Basler ace USB 3.0...
  • Page 288 This is described in the "Camera Events" code sample included with the pylon software development kit. Event notification must be specifically set up for each type of event using the parameter names of event and supplementary information. The following table lists the relevant parameter names: Basler ace USB 3.0...
  • Page 289 API. The pylon 4 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 290: 8.14 Test Images

    Test Image Selector to one of the test images or to "test image 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 291: 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 292 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 293 To display this test pattern on a monitor, you must convert the Y’CbCr output from the camera to 8-bit RGB. Fig. 109: Test Image Six Basler ace USB 3.0...
  • Page 294: 8.15 Device Information Parameters

    Device User ID (read / write) - is used to assign a user defined name to a device. This name  will be displayed in the Basler pylon Viewer and the Basler pylon USB Configurator. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
  • Page 295 // Read the Device SFNC Version Major parameter int64_t i = camera.DeviceSFNCVersionMajor.GetValue(); // Read the Device SFNC Version Minor parameter int64_t i = camera.DeviceSFNCVersionMinor.GetValue(); // Read the Device SFNC Version Sub Minor parameter int64_t i = camera.DeviceSFNCVersionSubMinor.GetValue(); Basler ace USB 3.0...
  • Page 296 // 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 297: 8.16 User Defined Values

    UserDefinedValueSelector_Value1 ); 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 298: 8.17 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 8.17.3 on page 292 and Section 8.17.1 on page 290, respectively. Basler ace USB 3.0...
  • Page 299 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 300: Selecting A User Set

    Functions User Set, 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 301: 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 302: Loading User Set Into The Active User Set

    If you want to load the Default User Set: camera.UserSetSelector.SetValue(UserSetSelector_Default); camera.UserSetLoad.Execute( ); 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( ); Basler ace USB 3.0...
  • Page 303: 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 8.17.4...
  • Page 304 If you want to designate the Auto Functions User Set as User Set Default: camera.UserSetDefault.SetValue(UserSetDefault_AutoFunctions); If you want to designate e.g. User Set 1as 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 305: 8.18 Chunk Features

    PC. Note: Chunk data can only be appended to image data when Chunk Mode Active is enabled. Disabling Chunk Mode Active prevents chunk data from being to be appended to image data. Basler ace USB 3.0...
  • Page 306 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 307: 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 308: 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 line status all chunk, and enable the line status...
  • Page 309: 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 310: 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 311 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 312: 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 313: Retrieving Data Chunks

    32 bit Length 32 bit 32 bit 32 bit 32 bit Chunk 1 Chunk 2 Chunk N Actual payload size of the grab result Fig. 112: Example of a Set of Chunks Related to One Image Acquisition Basler ace USB 3.0...
  • Page 314 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 315: 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 9.3 on page 306 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 316: 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 317 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 318 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 319: 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 320 Section 8.7.4 on page 247. Highlighted the distinction between "active set" and "active user set" in Section 8.17 on page 288. Added the Line Status All chunk as Section 8.18.3.2 on page 297. Basler ace USB 3.0...
  • Page 321: Index

    184 balance white auto .........275 color transformation ....... 191 Bayer filter ..........177 color transformation matrix .... 185 Bayer pixel format ........179 color transformation value ..... 192 binning............243 color cameras........245 horizontal........243 image distortion....244 Basler ace USB 3.0...
  • Page 322 277 global reset release frame start trigger......277 ~ shutter mode ....135 event notification ........277 GPIO exposure see general purpose I/O ExFSTrig-controlled ......122 exposure time offset......122 exposure auto ........271 exposure end event .......277 Basler ace USB 3.0...
  • Page 323 Daylight 5000 K........184 optical format Daylight 6500 K........184 see optical size ........2 Off ............184 optical size ..........2 preset ..........184 output line (direct coupled) Tungsten 2800 K......184 voltage requirements ......67 light source preset ........191 Basler ace USB 3.0...
  • Page 324 ......247 source signal region of interest for input ..........76 auto function ROI ......263 for output ........... 80 see image region of interest sRGB ..........185 remove limits parameter ....200 standard factory setup ... 289 Basler ace USB 3.0...
  • Page 325 USB 3.0 powered hub LPS ........37 SELV ........37 USB3 Micro-B port ........53 user defined values ........287 user output .........80 user set...........288 auto functions factory setup .....289 default for startup ......289 explained..........288 for user configuration .......288 Basler ace USB 3.0...
  • Page 326 Index AW00123404000 Basler ace USB 3.0...

This manual is also suitable for:

Ace aca1920-155

Table of Contents