Basler scout light USER’S MANUAL FOR SCOUT LIGHT GigE VISION CAMERAS Document Number: AW001047 Version: 01 Language: 000 (English) Release Date: 30 November 2011
For customers in the U.S.A. This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications.
Contacting Basler Support Worldwide Europe: Basler AG An der Strusbek 60 - 62 22926 Ahrensburg Germany Tel.: +49-4102-463-515 Fax.: +49-4102-463-599 bc.support.europe@baslerweb.com Americas: Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA 19341 U.S.A. Tel.: +1-610-280-0171 Fax.: +1-610-280-7608 bc.support.usa@baslerweb.com Asia: Basler Asia Pte. Ltd 8 Boon Lay Way # 03 - 03 Tradehub 21 Singapore 609964 Tel.: +65-6425-0472 Fax.: +65-6425-0473 bc.support.asia@baslerweb.com www.baslerweb.
AW00104701000 Table of Contents Table of Contents 1 Specifications, Requirements, and Precautions . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 General Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.3 Spectral Response for Mono Cameras. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents AW00104701000 7.3 Connector Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 7.3.1 8-pin RJ-45 Jack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 7.3.2 12-pin Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 7.4 Cabling Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AW00104701000 9.4.4 9.4.5 Table of Contents Using a Software Acquisition Start Trigger (Standard Mode) . . . . . . . . . . . . . 9.4.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.4.4.2 Setting the Parameters Related to Software Acquisition Start Triggering and Applying a Software Trigger Signal . . . . . . . . . . . . . Using a Hardware Acquisition Start Trigger (Standard Mode) . . . . . . . . . . . . . 9.4.5.1 Introduction . . . . . . . . . . .
Table of Contents AW00104701000 9.10 Acquisition Monitoring Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.10.1 Exposure Active Signal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.10.2 Acquisition Status Indicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.10.3 Trigger Ready Signal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.10.
AW00104701000 Table of Contents 11.12 Test Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 11.13 Device Information Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 11.14 Configuration Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.14.1 Saving User Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents vi AW00104701000 Basler scout light GigE
AW00104701000 Specifications, Requirements, and Precautions 1 Specifications, Requirements, and Precautions This chapter lists the camera models covered by the manual. It provides the general specifications for those models and the basic requirements for using them. This chapter also includes specific precautions that you should keep in mind when using the cameras. We strongly recommend that you read and follow the precautions. 1.
Specifications, Requirements, and Precautions 1.2 AW00104701000 General Specifications Specification slA640-74gm/gc slA780-54gm/gc slA1390-17gm/gc Sensor Size (H x V pixels) gm: 659 x 494 gm: 782 x 582 gm: 1392 x 1040 gc: gc: gc: Sensor Type Sony ICX414 AL/AQ 658 x 492 780 x 580 1390 x 1038 Sony ICX415 AL/AQ Sony ICX267 AL/AK Progressive scan CCD Optical Size 1/2" 1/2" 1/2" Pixel Size 9.9 µm x 9.9 µm 8.3 µm x 8.3 µm 4.65 µm x 4.65 µm Max.
AW00104701000 Specifications, Requirements, and Precautions Specification slA640-74gm/gc slA780-54gm/gc slA1390-17gm/gc Size (L x W x H) 73.7 mm x 44 mm x 29 mm (without lens adapter or connectors) 85.
Specifications, Requirements, and Precautions Specification slA1400-17gm/gc Sensor Size (H x V pixels) gm: 1392 x 1040 Sensor Type Sony ICX285 AL/AQ AW00104701000 gc: 1390 x 1038 Progressive scan CCD Optical Size 2/3" Pixel Size 6.45 µm x 6.45 µm Max.
AW00104701000 Specifications, Requirements, and Precautions Specification slA1400-17gm/gc Size (L x W x H) 73.7 mm x 44 mm x 29 mm (without lens adapter or connectors) 85.
Specifications, Requirements, and Precautions 1.3 AW00104701000 Spectral Response for Mono Cameras The following graphs show the spectral response for each available monochrome camera model. Relative Response The spectral response curves excludes lens characteristics and light source characteristics. Wave Length (nm) Fig.
Specifications, Requirements, and Precautions Relative Response AW00104701000 Wave Length (nm) Relative Response Fig. 2: slA780-54gm Spectral Response Wave Length (nm) Fig.
AW00104701000 Relative Response Specifications, Requirements, and Precautions Wave Length (nm) Fig.
AW00104701000 1.4 Specifications, Requirements, and Precautions Spectral Response for Color Cameras The following graphs show the spectral response for each available color camera model The spectral response curves exclude lens characteristics, light source characteristics, and IR cut filter characteristics. To obtain best performance from color models of the camera, use of a dielectric IR cut filter is recommended. The filter should transmit in a range from 400 nm to 700 ...
Relative Response Specifications, Requirements, and Precautions AW00104701000 Blue Green Red Wave Length (nm) Relative Response Fig. 6: slA780-54gc Spectral Response Blue Green Red Wave Length (nm) Fig.
Specifications, Requirements, and Precautions Relative Response AW00104701000 Blue Green Red Wave Length (nm) Fig.
Specifications, Requirements, and Precautions 1.5 AW00104701000 Mechanical Specifications The camera housing conforms to protection class IP30 assuming that the lens mount is covered by a lens or by the cap that is shipped with the camera. 1.5.1 Camera Dimensions and Mounting Points The cameras are manufactured with high precision. Planar, parallel, and angular sides guarantee precise mounting with high repeatability. The dimensions in millimeters for the cameras are as shown in Figure 9.
AW00104701000 Specifications, Requirements, and Precautions Camera housings are equipped with four mounting holes on the top and four mounting holes on the bottom as shown in the drawings. 2x M3; 4.5 deep Bottom 67.2 9.7 2x M3; 4 deep 80.15 2x M2; 4.5 deep 6.45 72.3 44 13.5 73.7 32 85.5 17.5 Photosensitive surface of the sensor 2x M3; 3.5 deep Top 2x M3; 4.5 deep 67.2 Fig.
Specifications, Requirements, and Precautions 1.5.2 AW00104701000 Maximum Thread Length on Color Cameras The C-mount lens adapter on color models of the camera is equipped with an internal IR cut filter. As shown below, the length of the threads on any lens you use with a color camera must be less than 8.0 mm. If a lens with a longer thread length is used, the IR cut filter will be damaged or destroyed and the camera will no longer operate. < 8.
AW00104701000 1.5.3 Specifications, Requirements, and Precautions Mechanical Stress Test Results Scout cameras were submitted to an independent mechanical testing laboratory and subjected to the stress tests listed below. The mechanical stress tests were performed on selected camera models. After mechanical testing, the cameras exhibited no detectable physical damage and produced normal images during standard operational testing.
Specifications, Requirements, and Precautions 1.6 AW00104701000 Software Licensing Information The software in the camera includes the LWIP TCP/IP implementation. The copyright information for this implementation is as follows: Copyright (c) 2001, 2002 Swedish Institute of Computer Science. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.
AW00104701000 1.7 Specifications, Requirements, and Precautions Avoiding EMI and ESD Problems The cameras are frequently installed in industrial environments. These environments often include devices that generate electromagnetic interference (EMI) and they are prone to electrostatic discharge (ESD). Excessive EMI and ESD can cause problems with your camera such as false triggering or can cause the camera to suddenly stop capturing images.
Specifications, Requirements, and Precautions AW00104701000 1.8 Environmental Requirements 1.8.1 Temperature and Humidity Housing temperature during operation: 0 °C ... +50 °C (+32 °F ... +122 °F) Humidity during operation: 20 % ... 80 %, relative, non-condensing Storage temperature: -20 °C ... +80 °C (-4 °F ... +176 °F) Storage humidity: 20 % ... 80 %, relative, non-condensing 1.8.
AW00104701000 1.9 Specifications, Requirements, and Precautions Precautions NOTICE Avoid Dust on the Sensor. The camera is shipped with a cap on the lens mount. To avoid collecting dust on the camera’s IR cut filter (color cameras) or sensor (mono cameras), make sure that you always put the cap in place when there is no lens mounted on the camera. To further enhance dust protection, the internal space in the camera that contains the imaging sensor is sealed off from the camera’s other internal spaces.
Specifications, Requirements, and Precautions AW00104701000 NOTICE Inappropriate Code May Cause Unexpected Camera Behavior. The code snippets provided in this manual are included as sample code only. Inappropriate code may cause your camera to function differently than expected and may compromise your application. To ensure that the snippets will work properly in your application, you must adjust them to meet your specific needs and must test them thoroughly prior to use.
AW00104701000 Specifications, Requirements, and Precautions Warranty Precautions To ensure that your warranty remains in force: Do not remove the camera’s serial number label If the label is removed and the serial number can’t be read from the camera’s registers, the warranty is void. Do not open the camera housing Do not open the housing. Touching internal components may damage them.
Specifications, Requirements, and Precautions 22 AW00104701000 Basler scout light GigE
AW00104701000 Installation 2 Installation The information you will need to install and operate the camera is included in the Installation and Setup Guide for Cameras Used with Basler’s pylon API (AW000611xx000). You can download the Installation and Setup Guide for Cameras Used with Basler’s pylon API from the Basler website: www.baslerweb.com The guide includes the information you will need to install both hardware and software and to begin capturing images.
Installation 24 AW00104701000 Basler scout light GigE
AW00104701000 Tools for Changing Camera Parameters 3 Tools for Changing Camera Parameters This chapter explains the options available for changing the camera’s parameters. The available options let you change parameters either by using stand-alone tools that access the camera via a GUI or by accessing the camera from within your software application. 3.
Tools for Changing Camera Parameters 3.3 AW00104701000 The pylon API You can access all of the camera’s parameters and can control the camera’s full functionality from within your application software by using Basler’s pylon API. The Basler pylon Programmer’s Guide and API Reference contains an introduction to the API and includes information about all of the methods and objects included in the API. The programmer’s guide and API reference are included in the pylon SDK.
AW00104701000 Basler Network Drivers and Parameters 4 Basler Network Drivers and Parameters This section describes the Basler network drivers available for your camera and provides detailed information about the parameters associated with the drivers. Two network drivers are available for the network adapter used with your GigE cameras: The Basler filter driver is a basic GigE Vision network driver that is compatible with all network adapters.
Basler Network Drivers and Parameters 4.1 AW00104701000 The Basler Filter Driver The Basler filter driver is a basic driver GigE Vision network driver. It is designed to be compatible with most network adapter cards. The functionality of the filter driver is relatively simple. For each frame, the driver checks the order of the incoming packets.
AW00104701000 4.2 Basler Network Drivers and Parameters The Basler Performance Driver The Basler performance driver is a hardware specific GigE Vision network driver compatible with network adapters that use specific Intel chipsets. The main advantage of the performance driver is that it significantly lowers the CPU load needed to service the network traffic between the PC and the camera(s). It also has a more robust packet resend mechanism.
Basler Network Drivers and Parameters AW00104701000 General Parameters Enable Resend - Enables the packet resend mechanisms. If the Enable Resend parameter is set to false, the resend mechanisms are disabled. The performance driver will not check for missing packets and will not send resend requests to the camera. If the Enable Resend parameter is set to true, the resend mechanisms are enabled. The performance driver will check for missing packets.
AW00104701000 Basler Network Drivers and Parameters Resend Request Threshold - This parameter determines the location of the resend request threshold within the receive window as shown in Figure 11. The parameter value is in per cent of the width of the receive window. In Figure 11 the resend request threshold is set at 33.33% of the width of the receive window. A stream of packets advances packet by packet beyond the resend request threshold (i.e.
Basler Network Drivers and Parameters AW00104701000 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 12 where the following assumptions are made: The frame includes 3000 packets. Packet 1002 is missing within the stream of packets and has not been recovered. Packets 2999 and 3000 are missing at the end of the stream of packets (end of the frame). The Maximum Number Resend Requests parameter is set to 3.
AW00104701000 Basler Network Drivers and Parameters Maximum Number Resend Requests - The Maximum Number Resend Requests parameter sets the maximum number of resend requests the performance driver will send to the camera for each missing packet. Resend Timeout - The Resend Timeout parameter defines how long (in milliseconds) the performance driver will wait after detecting that a packet is missing before sending a resend request to the camera.
Basler Network Drivers and Parameters AW00104701000 Threshold and Timeout Resend Mechanisms Combined Figure 13 illustrates the combined action of the threshold and the timeout resend mechanisms where the following assumptions are made: All parameters set to default. The frame includes 3000 packets. Packet 1002 is missing within the stream of packets and has not been recovered. Packets 2999 and 3000 are missing at the end of the stream of packets (end of the frame).
AW00104701000 Basler Network Drivers and Parameters (9) Because the maximum number of resend requests has been sent and the last Resend Response Timeout interval has expired, packet 1002 is now considered as lost. (10) End of the frame. (11) Missing packets at the end of the frame (2999 and 3000). (12) Interval defined by the Packet Timeout parameter. You can set the performance driver parameter values from within your application software by using the Basler pylon API.
Basler Network Drivers and Parameters AW00104701000 Adapter Properties When the Basler Performance driver is installed, it adds a set of "advanced" properties to the network adapter. These properties include: Max Packet Latency - A value in microseconds that defines how long the adapter will wait after it receives a packet before it generates a packet received interrupt. Max Receive Inter-packet Delay - A value in microseconds that defines the maximum amount of time allowed between incoming packets.
AW00104701000 4.3 Basler Network Drivers and Parameters Transport Layer Parameters The transport layer parameters are part of the camera’s basic GigE implementation. These parameters do not normally require adjustment. Read Timeout - If a register read request is sent to the camera via the transport layer, this parameter designates the time out (in milliseconds) within which a response must be received.
Basler Network Drivers and Parameters 38 AW00104701000 Basler scout light GigE
AW00104701000 Network Related Camera Parameters and Managing Bandwidth 5 Network Related Camera Parameters and Managing Bandwidth This section describes the camera parameters that are related to the camera’s performance on the network. It also describes how to use the parameters to manage the available network bandwidth when you are using multiple cameras. 5.
Network Related Camera Parameters and Managing Bandwidth AW00104701000 The packet size parameter should always be set to the maximum size that your network adapter and network switches (if used) can handle. Inter-packet Delay (read/write) Sets the delay in ticks between the packets sent by the camera. Applies to the selected stream channel. Increasing the inter-packet delay will decrease the camera’s effective data transmission rate and will thus decrease the network bandwidth used by the camera.
AW00104701000 Network Related Camera Parameters and Managing Bandwidth 30 MByte/s have been assigned to the camera and the Bandwidth Reserve parameter is set to 5%, then the bandwidth reserve will be 1.5 MByte/s. Bandwidth Reserve Accumulation (read/write) A software device called the bandwidth reserve accumulator is designed to handle unusual situations such as a sudden EMI burst that interrupts an image transmission.
Network Related Camera Parameters and Managing Bandwidth AW00104701000 Time Time Period 1 2 3 4 5 6 FA&T FA&T FA&T FA&T FA&T FA&T Resends available via the bandwidth reserve 5 5 5 5 5 5 Resends needed 0 7 4 10 20 0 -2 +1 -5 15 13 14 9 Effect on the accumulator pool Resends left in the accumulator pool after frame transmission F A & T = Frame Acquired and Transmitted 7 8 9 FA&T FA&T 5 5 5 1 0 0 1 -9 +4 +5 +5 +1 0 4 9 14 15 Not enough resends availa
AW00104701000 Network Related Camera Parameters and Managing Bandwidth (6) You trigger image acquisition and during this time period, the camera acquires and transmits a frame. The bandwidth reserve setting would allow 5 resends during this time period and 1 resend is needed. The 1 resend needed is taken from the resends available via the bandwidth reserve. The other 4 resends available via the bandwidth reserve are not needed, so they are added to the accumulator pool and they bring the pool up to 4.
Network Related Camera Parameters and Managing Bandwidth AW00104701000 Device Current Throughput (read only) Indicates the actual bandwidth (in bytes per second) that the camera will use to transmit image data and chunk data given the current area of interest settings, chunk feature settings, and the pixel format setting. If the Acquisition Frame Rate abs parameter has been used to set the camera’s frame rate, the camera will use this frame rate setting to calculate the device current throughput.
AW00104701000 Network Related Camera Parameters and Managing Bandwidth // Bandwidth Reserve Accumulation Camera.GevSCBWRA.SetValue( 10 ); // Frame Jitter Max int64_t jitterMax = Camera.GevSCFJM.GetValue(); // Device Max Throughput int64_t maxThroughput = Camera.GevSCDMT.GetValue(); // Device Current Throughput int64_t currentThroughput = Camera.GevSCDCT.GetValue(); // Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.
Network Related Camera Parameters and Managing Bandwidth 5.2 AW00104701000 Managing Bandwidth When Multiple Cameras Share a Single Network Path If you are using a single camera on a GigE network, the problem of managing bandwidth is simple. The network can easily handle the bandwidth needs of a single camera and no intervention is required. A more complicated situation arises if you have multiple cameras connected to a single network adapter as shown in Figure 14.
AW00104701000 Network Related Camera Parameters and Managing Bandwidth You can lower the data output rate on a camera by using the Inter-packet Delay parameter. This parameter adds a delay between the transmission of each packet from the camera and thus slows the data transmission rate of the camera. The higher the inter-packet delay parameter is set, the greater the delay between the transmission of each packet will be and the lower the data transmission rate will be.
Network Related Camera Parameters and Managing Bandwidth AW00104701000 CPU interrupts to a low value. If possible, also set the parameter for speed and duplex to auto. Contact Basler technical support if you need further assistance. Step 2 - Set the Packet Size parameter on each camera as large as possible.
AW00104701000 Network Related Camera Parameters and Managing Bandwidth Step 3 - Set the Bandwidth Reserve parameter for each camera. The Bandwidth Reserve parameter setting for a camera determines how much of the bandwidth assigned to that camera will be reserved for lost packet resends and for asynchronous traffic such as commands sent to the camera. If you are operating the camera in a relatively EMI free environment, you may find that a bandwidth reserve of 2% or 3% is adequate.
Network Related Camera Parameters and Managing Bandwidth AW00104701000 You can use the formula below to determine the actual amount of assigned bandwidth that is available for data transmission. To use the formula, you will need to know the current value of the Bandwidth Assigned parameter and the Bandwidth reserve parameter for each camera.
AW00104701000 Network Related Camera Parameters and Managing Bandwidth cameras and then adjust the data bandwidths assigned so that they reflect the lower bandwidth needs. You can lower the data bandwidth needed by a camera either by lowering its frame rate or by decreasing the size of the area of interest (AOI). Once you have adjusted the frame rates and/or AOI settings on the cameras, you should repeat steps 2 through 6.
Network Related Camera Parameters and Managing Bandwidth 52 AW00104701000 Basler scout light GigE
AW00104701000 Camera Functional Description 6 Camera Functional Description This chapter provides an overview of the camera’s functionality from a system perspective. The overview will aid your understanding when you read the more detailed information included in the later chapters of the user’s manual. 6.1 Overview Each camera provides features such as a full frame shutter and electronic exposure time control.
Camera Functional Description AW00104701000 CCD Sensor Vert. Shift Reg. ADC Vert. Shift Reg. Pixels Pixels Vert. Shift Reg. Pixels Vert. Shift Reg. Pixels VGC Horizontal Shift Register Fig. 15: CCD Sensor Architecture 60 MB Image Buffer Image Data Sensor VGC ADC ExTrig I/O e.g. ExpActive, TrigRdy Image Data FPGA Image Data Ethernet Controller Image Data and Control Data Ethernet Network Control Control: AOI, Gain, Black Level MicroController Control Data Fig.
AW00104701000 Physical Interface 7 Physical Interface This chapter provides detailed information, such as pinouts and voltage requirements, for the physical interface on the camera. This information will be especially useful during your initial design-in process. 7.1 General Description of the Connections The camera is interfaced to external circuity via connectors located on the back of the housing: An 8-pin, RJ-45 jack used to provide a 100/1000 Mbit/s Ethernet connection to the camera.
Physical Interface 7.2 Connector Pin Assignments and Numbering 7.2.1 12-pin Receptacle Pin Assignments AW00104701000 The 12 pin receptacle is used to access the physical input line and the physical output line on the camera. It is also used to supply power to the camera. The pin assignments for the receptacle are shown in Table 4.
AW00104701000 Physical Interface * Pins 1 and 2 are tied together inside of the camera. ** Pins 8 and 9 are tied together inside of the camera. To avoid a voltage drop when there are long wires between your power suppy and the camera, we recommend that you provide camera power VCC through separate wires between your power supply and pins 8 and 9 on the camera. We also recommend that you provide camera power ground through separate wires between your power supply and pins 1 and 2 on the camera.
Physical Interface 7.3 Connector Types 7.3.1 8-pin RJ-45 Jack AW00104701000 The 8-pin jack for the camera’s Ethernet connection is a standard RJ-45 connector. The recommended mating connector is any standard 8-pin RJ-45 plug. Cables terminated with screw-lock connectors are available from Basler. Contact your Basler sales representative to order cable assemblies. Suitable cable assemblies are also available from e.g. Components Express, Inc. and from the Intercon 1 division of Nortech Systems, Inc.
AW00104701000 Physical Interface 7.4 Cabling Requirements 7.4.1 Ethernet Cables Use high-quality Ethernet cables. To avoid EMI, the cables must be shielded. Use of category 6 or category 7 cables with S/STP shielding is strongly recommended. As a general rule, applications with longer cables or applications in harsh EMI conditions require higher category cables.
Physical Interface AW00104701000 NOTICE Avoid Applying Voltage to the Non-functional Pins. Applying voltages to the non-functional pins in the 12-pin connector may damage the electronic components in the camera. We recommend that you do not apply signals to any of the nonfunctional pins. NOTICE An Incorrect Plug Can Damage the 12-pin Connector. The plug on the cable that you attach to the camera’s 12-pin connector must have 12 pins.
AW00104701000 Physical Interface To avoid a voltage drop with long power wires, we recommend that you supply camera power VCC through two separate wires between the power supply and the camera as shown in the figure above. We also recommend that you supply camera power ground through two separate wires between the power supply and the camera as shown in the figure. 7.4.
Physical Interface 7.5 AW00104701000 Camera Power Camera power must be supplied to the camera’s 12-pin connector via the standard power and I/O cable or via the PLC power and I/O cable. Power consumption is as shown in the specification tables in Section 1 of this manual. NOTICE Voltage Outside of Specified Range Can Cause Damage. If the voltage of the power to the camera is greater than +30.0 VDC damage to the camera can result. If the voltage is less than +11.
AW00104701000 Physical Interface For more information about the 12-pin connector and the power and I/O cables see Section 7.2 on page 56, Section 7.3 on page 58, and Section 7.4 on page 59. 7.6 Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant.
Physical Interface AW00104701000 7.7 Input and Output Lines 7.7.1 Input Line 7.7.1.1 Voltage Requirements Different voltage levels apply, depending on whether the standard power and I/O cable or a PLC power and I/O cable is used (see below). Voltage Levels When the Standard Power and I/O Cable is Used The following voltage requirements apply to the camera’s I/O input (pin 3 of the 12-pin receptacle): Voltage Significance +0 to +24 VDC Recommended operating voltage. +0 to +1.
AW00104701000 Physical Interface Voltage Levels When a PLC Power and I/O Cable is Used The following voltage requirements apply to the input of the PLC power and I/O cable. The PLC power and I/O cable will adjust the voltages to the levels required at the camera’s I/O input (see Table 4). Voltage Significance +0 to +24 VDC Recommended operating voltage. +0 to +8.4 VDC The voltage indicates a logical 0. > +8.4 to +10.4 VDC > +10.4 VDC +30.
Physical Interface 7.7.1.2 AW00104701000 Line Schematic The camera is equipped with one physical input line designated as Input Line 1. The input line is accessed via the 12-pin receptacle on the back of the camera. As shown in the I/O line schematic, the input line is opto-isolated. See the previous section for input voltages and their significances. The absolute maximum input voltage is +30.0 VDC. The current draw for the input line is between 5 and 15 mA.
AW00104701000 7.7.2 Physical Interface Output Line 7.7.2.1 Voltage Requirements The following voltage requirements apply to the I/O output VCC (pin 10 of the 12-pin receptacle): Voltage < +3.3 VDC +3.3 to +24 VDC +30.0 VDC Significance The I/O output may operate erratically. Recommended operating voltage. Absolute maximum; the camera may be damaged if the absolute maximum is exceeded. Table 8: Voltage Requirements for the I/O Output VCC 7.7.2.
Physical Interface AW00104701000 For more information about the output line pin assignment and pin numbering, see Section 7.2 on page 56. For more information about the exposure active signal, see Section Section 9.10.1 on page 135. For more information about assigning camera output signals to the physical output line, see Section 8.2.1 on page 73.
AW00104701000 7.7.3 Physical Interface Output Line Response Time Response times for the output line on the camera are as defined below. Camera Output Signal 90% Output Line Voltage 10% ton90 toff10 Time Fig. 22: Output Line Response Times ton90: Time (µs) from switching on the signal until the voltage has reached 90 % of its final level. toff10: Time (µs) from switching off the signal until the voltage has dropped to 10 % of its original level.
Physical Interface AW00104701000 40 Time [µs] 50 5 mA toff10 50 mA 30 20 10 ton90 50 mA 5 mA Voltage [V] 0 0 5 10 15 20 25 30 Fig.
AW00104701000 I/O Control 8 I/O Control This section describes how to configure the camera’s physical input line and the physical output line. It also provides information about monitoring the state of the input and output line. For more detailed information about the physical and electrical characteristics of the input and output line, see Section 7.7 on page 64. 8.1 Configuring the Input Line 8.1.
I/O Control 8.1.2 AW00104701000 Using an Unassigned Input Line to Receive a User Input Signal You can use the input line to receive your own, user-generated input signal. The electrical characteristics of your input signal must meet the requirements shown in the Physical Interface section of this manual. You can use the Line Status or Line Status All parameters to monitor the state of the input line that is receiving the user-defined signal.
AW00104701000 I/O Control 8.2 Configuring the Output Line 8.2.1 Assigning a Camera Output Signal to the Physical Output Line You can use the camera’s output signal assignment capability to assign one of the camera’s standard output signals as the source signal for the physical output line.
I/O Control AW00104701000 For more information about the exposure active signal, see Section 9.10.1 on page 135. 8.2.2 Setting the State of the User Settable Output Line As mentioned in the previous section, you can designate the user output line as "user settable". Once you have designated the output line as user settable, you can use camera parameters to set the state of the line.
AW00104701000 8.2.3 I/O Control Setting the Output Line for Invert You can set the output line to invert or not to invert the outgoing signal. To set the invert function on the output line: Use the Line Selector to select output line 1. Set the value of the Line Inverter parameter to true to enable inversion on the selected line and to false to disable inversion. You can set the Line Selector and the Line Inverter parameter value from within your application software by using the pylon API.
I/O Control 8.2.4 AW00104701000 Working with the Timer The camera has a timer output signal available: Timer 1. As shown in Figure 24, the timer works as follows: A trigger source event occurs that starts the timer. A delay period begins to expire. When the delay expires, the timer signal goes high and a duration period begins to expire. When the duration period expires, the timer signal goes low. Duration Delay Trigger source event occurs Fig.
AW00104701000 8.2.4.2 I/O Control Setting a Timer Delay Time There are two ways to set the delay time for the timer: by setting "raw" values or by setting an "absolute value". You can use whichever method you prefer to set the delay time. Setting the Delay with Raw Values When the delay time for the timer is set using "raw" values, the delay time will be determined by a combination of two elements.
I/O Control AW00104701000 Setting the Delay with an Absolute Value You can also set the Timer duration by using an "absolute" value. This is accomplished by setting the Timer Duration Abs parameter. The units for setting this parameter are µs and the value can be set in increments of 1 µs. To set the duration for the timer using an absolute value: Use the Timer Selector to select Timer 1. Set the value of the Timer Duration Abs parameter.
AW00104701000 I/O Control The Timer Duration Raw parameter value can range from 1 to 4095. So if the value is set to 100, for example, the timer duration will be 100 x 1 µs or 100 µs. To set the duration for the timer: Use the Timer Selector to select the timer. Set the value of the Timer Duration Raw parameter. You can set the Timer Selector and the Timer Duration Raw parameter value from within your application software by using the pylon API.
I/O Control AW00104701000 When you use the Timer Duration Abs parameter to set the duration time, the camera accomplishes the setting change by automatically changing the Timer Duration Raw parameter to achieve the value specified by the Timer Duration Abs setting. This leads to a limitation that you must keep in mind if you use Timer Duration Abs parameter to set the duration time.
AW00104701000 I/O Control 8.3 Checking the State of the I/O Lines 8.3.1 Checking the State of the Output Line You can determine the current state of the output line. To check the state of the line: Use the Line Selector parameter to select the output line. Read the value of the Line Status parameter to determine the current state of the selected line. A value of true means the line’s state is currently high and a value of false means the line’s state is currently low.
I/O Control 82 AW00104701000 Basler scout light GigE
AW00104701000 Image Acquisition Control 9 Image Acquisition Control This section provides detailed information about controlling image acquisition. You will find details about choosing between image acquisition control modes, triggering image acquisition, setting the exposure time for each acquired image and about how the camera’s maximum allowed acquisition frame rate can vary depending on the current camera settings. 9.
Image Acquisition Control AW00104701000 When the camera is started for the first time after delivery from the factory the image acquisition control will be in legacy mode. If you want the camera to start in standard mode, set the camera to standard mode (see below), save the current parameter settings as a user set and designate this user set as the startup set. For more information about saving parameter settings as a user set and about working with user sets, see Section 11.14 on page 203.
AW00104701000 9.2 Image Acquisition Control Means for Controlling Image Acquisition in Standard Mode This section assumes that the standard mode is enabled for image acquisition control. In principle, this section also applies if the legacy mode is enabled instead. In this case, however, the following differences must be taken into account: the acquisition start trigger of the standard mode is not available in the legacy mode.
Image Acquisition Control AW00104701000 Acquisition Start and Stop Commands and the Acquisition Mode The Acquisition Start command prepares the camera to acquire frames. The camera cannot acquire frames unless an Acquisition Start command has first been executed. A parameter called the Acquisition Mode has a direct bearing on how the Acquisition Start command operates. If the Acquisition Mode parameter is set to "single frame", you can only acquire one frame after executing an Acquisition Start command.
AW00104701000 Image Acquisition Control process of exposing and reading out a frame (see Figure 26 on page 87). As soon as the camera is ready to accept another frame start trigger signal, it will return to the "waiting for frame start trigger" acquisition status. A new frame start trigger signal can then be applied to the camera to begin another frame exposure. The frame start trigger has two modes: off and on.
Image Acquisition Control AW00104701000 Applying Trigger Signals The paragraphs above mention "applying a trigger signal". There are two ways to apply an acquisition start or a frame start trigger signal to the camera: via software or via hardware. To apply trigger signals via software, you must first select the acquisition start or the frame start trigger and then indicate that software will be used as the source for the selected trigger signal.
AW00104701000 9.3 Image Acquisition Control Acquisition Start and Stop Commands and the Acquisition Mode (Legacy and Standard Mode) Executing an Acquisition Start commmand prepares the camera to acquire frames. You must execute an Acquisition Start command before you can begin acquiring frames. Executing an Acquisition Stop command terminates the camera’s ability to acquire frames.
Image Acquisition Control AW00104701000 Camera.AcquisitionStart.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page 25. When the camera's acquisition mode is set to single frame, the maximum possible acquisition frame rate for a given AOI cannot be achieved.
AW00104701000 9.4 Image Acquisition Control The Acquisition Start Trigger in Standard Mode This section only applies if the standard mode is enabled for image acquisition control. When the camera is started for the first time after delivery from the factory the image acquisition control will not be in standard mode but in legacy mode. Use the legacy mode only if you want to operate the camera together with previous cameras not featuring the standard mode.
Image Acquisition Control 9.4.1 AW00104701000 Acquisition Start Trigger Mode (Standard Mode) The main parameter associated with the acquisition start trigger is the Trigger Mode parameter. The Trigger Mode parameter for the acquisition start trigger has two available settings: off and on. 9.4.1.
AW00104701000 Image Acquisition Control When the Trigger Mode parameter for the acquisition start trigger is set to on, the camera’s Acquisition Mode parameter must be set to continuous. 9.4.2 Acquisition Frame Count (Standard Mode) When the Trigger Mode parameter for the acquisition start trigger is set to on, you must set the value of the camera’s Acquisition Frame Count parameter. The value of the Acquisition Frame Count can range from 1 to 255.
Image Acquisition Control 9.4.3 AW00104701000 Setting the Acquisition Start Trigger Mode and Related Parameters (Standard Mode) You can set the Trigger Mode and Trigger Source parameters for the acquisition start trigger and also set the Acquisition Frame Count parameter value from within your application software by using the Basler pylon API.
AW00104701000 9.4.4 9.4.4.1 Image Acquisition Control Using a Software Acquisition Start Trigger (Standard Mode) Introduction If the camera’s Acquisition Start Trigger Mode parameter is set to on and the Acquisition Start Trigger Source parameter is set to software, you must apply a software acquisition start trigger signal to the camera before you can begin frame acquisition. A software acquisition start trigger signal is applied by: Setting the Trigger Selector parameter to Acquisition Start.
Image Acquisition Control AW00104701000 Camera.AcquisitionFrameCount.SetValue( 5 ); // Execute an acquisition start command to prepare for frame acquisition Camera.AcquisitionStart.Execute( ); while ( ! finished ) { // Execute a trigger software command to apply a software acquisition // start trigger signal to the camera Camera.TriggerSoftware.Execute( ); // Perform the required functions to parameterize the frame start // trigger, to trigger 5 frame starts, and to retrieve 5 frames here } Camera.
AW00104701000 Image Acquisition Control For more information about setting the camera for hardware acquisition start triggering and selecting the input line to receive the ExASTrig signal, see Section 9.4.5.2 on page 97. For more information about the electrical requirements for input line 1, see Section 7.7.1 on page 64. 9.4.5.
Image Acquisition Control 9.5 AW00104701000 The Frame Start Trigger in Standard Mode This section only applies if the standard mode is enabled for image acquisition control. When the camera is started for the first time after delivery from the factory the image acquisition control will not be in standard mode but in legacy mode. Use the legacy mode only if you want to operate the camera together with previous cameras not featuring the standard mode.
AW00104701000 9.5.1 Image Acquisition Control Frame Start Trigger Mode (Standard Mode) The main parameter associated with the frame start trigger is the Trigger Mode parameter. The Trigger Mode parameter for the frame start trigger has two available settings: off and on. 9.5.1.
Image Acquisition Control AW00104701000 Exposure Time Control with the Frame Start Trigger Off When the Trigger Mode parameter for the frame start trigger is set to off, the exposure time for each frame acquisition is determined by the value of the camera’s Exposure Time Abs parameter. For more information about the camera’s Exposure Time Abs parameter, see Section 9.7 on page 121. 9.5.1.
AW00104701000 Image Acquisition Control Exposure Time Control with the Frame Start Trigger On When the Trigger Mode parameter for the frame start trigger is set to on and the Trigger Source parameter is set to software, the exposure time for each frame acquisition is determined by the camera’s exposure time parameters.
Image Acquisition Control AW00104701000 Camera.AcquisitionStart.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page 25. 9.5.2 9.5.2.
AW00104701000 Image Acquisition Control Section 9.5.2.2 on page 103 includes more detailed information about applying a software frame start trigger to the camera using Basler pylon. For more information about exposure time parameters, see Section 9.7 on page 121. For more information about determining the maximum allowed frame rate, see Section 9.12 on page 144. 9.5.2.
Image Acquisition Control AW00104701000 // Note: as long as the Trigger Selector is set to FrameStart, executing // a Trigger Software command will apply a software frame start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page 25. 9.5.3 9.5.3.
AW00104701000 Image Acquisition Control If you are triggering frame acquisition with an ExFSTrig signal and you attempt to acquire frames at too high a rate, some of the frame trigger signals that you apply will be received by the camera when it is not in a "waiting for frame start trigger" acquisition status. The camera will ignore any frame start trigger signals that it receives when it is not "waiting for frame start trigger". This situation is commonly referred to as "over triggering" the camera.
Image Acquisition Control AW00104701000 This situation is illustrated below for rising edge triggering. This rise in the trigger signal will be ignored. ExFSTrig Signal Exposure (duration determined by the exposure time parameters) Fig. 29: Overtriggering with Timed Exposure For more information about the camera’s exposure time parameters, see Section 9.7 on page 121.
AW00104701000 9.5.3.3 Image Acquisition Control Frame Start Trigger Delay The trigger delay feature lets you specify a delay (in microseconds) that will be applied between the receipt of a hardware frame start trigger and when the trigger will become effective. The trigger delay will not operate if the Trigger Mode parameter for frame start is set to off or if you are using a software frame start trigger. For more information about the trigger delay feature and how to use it, see Section 11.
Image Acquisition Control AW00104701000 Camera.AcquisitionStart.Execute( ); // Frame acquisition will start when the externally generated // frame start trigger signal (ExFSTrig signal)goes high The following code snippet illustrates using the API to set the parameter values and execute the commands related to hardware frame start triggering with the camera set for continuous frame acquisition mode and the trigger mode for the acquisition start trigger set to off.
AW00104701000 9.6 Image Acquisition Control The Acquisition Start Trigger in Legacy Mode This section only applies if the legacy mode is enabled for image acquisition control. Use the legacy mode only if you want to operate the camera together with previous cameras not featuring the standard mode. Otherwise, we most strongly recommend enabling the standard mode. When the camera is started for the first time after delivery from the factory the image acquisition control will be in legacy mode.
Image Acquisition Control 9.6.1 AW00104701000 Acquisition Start Trigger Mode (Legacy Mode) The main parameter associated with the acquisition start trigger is the Trigger Mode parameter. The Trigger Mode parameter for the acquisition start trigger has two available settings: off and on. 9.6.1.
AW00104701000 9.6.1.2 Image Acquisition Control Acquisition Start Trigger Mode = On When the Trigger Mode parameter for the acquisition start trigger is set to on, you must apply an acquisition start trigger signal to the camera each time you want to begin a frame acquisition. The Trigger Source parameter specifies the source signal that will act as the acquisition start trigger signal.
Image Acquisition Control 9.6.1.3 AW00104701000 Setting the Acquisition 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.
AW00104701000 9.6.2 Image Acquisition Control Using a Software Acquisition Start Trigger (Legacy Mode) 9.6.2.1 Introduction If the Trigger Mode parameter for the acquisition start trigger is set to on and the Trigger Source parameter is set to software, you must apply a software acquisition start trigger signal to the camera to begin each frame acquisition.
Image Acquisition Control 9.6.2.2 AW00104701000 Setting the Parameters Related to Software Acquisition Start Triggering and Applying a Software Trigger Signal You can set all of the parameters needed to perform software acquisition start triggering from within your application software by using the Basler pylon API.
AW00104701000 9.6.3 9.6.3.1 Image Acquisition Control Using a Hardware Acquisition Start Trigger (Legacy Mode) Introduction If the Trigger Mode parameter for the acquisition start trigger is set to on and the Trigger Source parameter is set to input line 1, an externally generated electrical signal applied to input line 1 on the camera will act as the acquisition start trigger signal for the camera.
Image Acquisition Control AW00104701000 For more information about the electrical requirements for input line 1, see Section 7.7.1 on page 64. For more information about determining the maximum allowed frame rate, see Section 9.12 on page 144. 9.6.3.2 Exposure Modes If you are triggering the start of frame acquisition with an externally generated acquisition start trigger (ExASTrig) signal, two exposure modes are available: timed and trigger width.
AW00104701000 Image Acquisition Control For more information about the camera’s exposure time parameters, see Section 9.7 on page 121. Trigger Width Exposure Mode When trigger width exposure mode is selected, the length of the exposure for each frame acquisition will be directly controlled by the ExASTrig signal. If the camera is set for rising edge triggering, the exposure time begins when the ExASTrig signal rises and continues until the ExASTrig signal falls.
Image Acquisition Control AW00104701000 TrigRdy Signal Exposure Exposure ExASTrig Signal Frame Readout Frame N-1 Frame N Fig. 35: Trigger Width Exposure Mode with Overlapped Exposure You can set the exposure time parameter value and select an exposure mode from within your application software by using the pylon API.
AW00104701000 9.6.3.4 Image Acquisition Control Setting the Parameters Related to Hardware Acquisition Start Triggering and Applying a Hardware Trigger Signal You can set all of the parameters needed to perform hardware acquisition start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the camera for single frame acquisition mode.
Image Acquisition Control AW00104701000 // Set the source for the selected trigger Camera.TriggerSource.SetValue ( TriggerSource_Line1 ); // Set the trigger activation mode to rising edge Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); // Set for the trigger width exposure mode Camera.ExposureMode.SetValue( ExposureMode_TriggerWidth ); // Prepare for frame acquisition here Camera.AcquisitionStart.
AW00104701000 9.7 Image Acquisition Control Exposure Time Parameters Many of the camera’s image acquisition modes require you to specify an exposure time. There are two ways to set exposure time: by setting "raw" values or by setting an "absolute value". The two methods are described below. You can use whichever method you prefer to set the exposure time. The exposure time must not be set below a minimum specified value. The minimum exposure time varies by camera model as shown in Table 9.
Image Acquisition Control AW00104701000 Changing the Exposure Time Base Normally, the exposure time is adjusted by setting the value of the Exposure Time Raw parameter as explained above. However, if you require an exposure time that is longer than what you can achieve by changing the value of the Exposure Time Raw parameter alone, the Exposure Time Base Abs parameter can be used to change the exposure time base.
AW00104701000 Image Acquisition Control Setting the Absolute Exposure Time Parameter You can set the Exposure Time Abs parameter value from within your application software by using the pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.ExposureTimeAbs.SetValue( 124 ); double resultingExpTime = Camera.ExposureTimeAbs.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference.
Image Acquisition Control AW00104701000 In each use case diagram, the black box in the upper left corner indicates how the parameters are set. The use case diagrams are representational. They are not drawn to scale and are not designed to accurately describe precise camera timings.
AW00104701000 Image Acquisition Control Use Case 1 - Acquisition and Frame Start Triggers Both Off (Free Run) Use case one is illustrated on page 126. In this use case, the Acquisition Mode parameter is set to continuous. The Trigger Mode parameter for the acquisition start trigger and the Trigger Mode parameter for the frame start trigger are both set to off. The camera will generate all required acquisition start and frame start trigger signals internally.
Image Acquisition Control AW00104701000 Use Case: "Free Run" (Acquisition Start Trigger Off and Frame Start Trigger Off) The acquisition start trigger is off. The camera will generate acquisition start trigger signals internally with no action by the user. The frame start trigger is off. The camera will generate frame start trigger signals internally with no action by the user.
AW00104701000 Image Acquisition Control Use Case 2 - Acquisition Start Trigger Off - Frame Start Trigger On Use case two is illustrated on page 128. In this use case, the Acquisition Mode parameter is set to continuous. The Trigger Mode parameter for the acquisition start trigger is set to off and the Trigger Mode parameter for the frame start trigger is set to on. Because the acquisition start trigger is set to off, the user does not need to apply acquisition start trigger signals to the camera.
Image Acquisition Control AW00104701000 Use Case: Acquisition Start Trigger Off and Frame Start Trigger On The acquisition start trigger is off. The camera will generate acquisition start trigger signals internally with no action by the user. The frame start trigger is on, and the frame start trigger source is set to input line 1. The user must apply a frame start trigger signal to input line 1 to start each frame exposure.
AW00104701000 Image Acquisition Control Use Case 3 - Acquisition Start Trigger On - Frame Start Trigger Off Use case three is illustrated on page 130. In this use case, the Acquisition Mode parameter is set to continuous. The Trigger Mode parameter for the acquisition start trigger is set to on and the Trigger Mode parameter for the frame start trigger is set to off. Because the acquisition start trigger mode is set to on, the user must apply an acquisition start trigger signal to the camera.
Image Acquisition Control AW00104701000 Use Case: Acquisition Start Trigger On and Frame Start Trigger Off The acquisition start trigger is on, and the acquisition start trigger source is set to input line 1. The user must apply an acquisition start trigger signal to input line 1 to make the camera exit the "waiting for acquisition start trigger" acquisition status.
AW00104701000 Image Acquisition Control Use Case 4 - Acquisition Start and Frame Start Triggers Both On Use case four is illustrated on page 132. In this use case, the Acquisition Mode parameter is set to continuous. The Trigger Mode parameter for the acquisition start trigger is set to on and the Trigger Mode parameter for the frame start trigger is set to on. Because the acquisition start trigger mode is set to on, the user must apply an acquisition start trigger signal to the camera.
Image Acquisition Control AW00104701000 Use Case: Acquisition Start Trigger On and Frame Start Trigger On The acquisition start trigger is on, and the acquisition start trigger source is set to software. The user must execute an acquisition start trigger software command to make the camera exit the "waiting for acquisition start trigger" acquisition status.
AW00104701000 9.9 Image Acquisition Control Overlapping Exposure and Sensor Readout The image acquisition process on the camera includes two distinct parts. The first part is the exposure of the pixels in the imaging sensor. Once exposure is complete, the second part of the process – readout of the pixel values from the sensor – takes place. In regard to this image acquisition process, there are two common ways for the camera to operate: with “non-overlapped” exposure and with “overlapped” exposure.
Image Acquisition Control AW00104701000 Determining whether your camera is operating with overlapped or non-overlapped exposures is not a matter of issuing a command or switching a setting on or off. Rather the way that you operate the camera will determine whether the exposures are overlapped or not overlapped.
AW00104701000 Image Acquisition Control 9.10 Acquisition Monitoring Tools 9.10.1 Exposure Active Signal The camera’s “exposure active” (ExpAc) signal goes high when the exposure time for each image acquisition begins and goes low when the exposure time ends as shown in Figure 42. This signal can be used as a flash trigger and is also useful when you are operating a system where either the camera or the object being imaged is movable.
Image Acquisition Control AW00104701000 You can also use the Basler pylon Viewer application to easily set the parameters. For more information about changing the assignment of camera output signals to the physical output line, see Section 8.2.1 on page 73. For more information about the electrical characteristics of the camera’s output line, see Section 7.7.2 on page 67. 9.10.
AW00104701000 Image Acquisition Control Signal goes high at earliest safe moment to trigger acquisition N+1 Signal goes low when exposure for acquisition N+1 begins Signal goes high at earliest safe moment to trigger acquisition N+2 Signal goes low when exposure for acquisition N+2 begins TrigRdy Signal Image Acquisition N Exposure Readout Image Acquisition N+1 Exposure Readout Image Acquisition N+2 Exposure Readout Time Fig.
Image Acquisition Control AW00104701000 You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 ); Camera.LineSource.SetValue( LineSource_TriggerReady ); You can also use the Basler pylon Viewer application to easily set the parameters.
AW00104701000 Image Acquisition Control 9.10.4 Acquisition Trigger Wait Signal (Standard Mode Only) The acquisition trigger wait signal is only available when the image acquisition control is set to standard mode. For more information about image acquisition control and setting the mode, see Section 9.1 on page 83. As you are acquiring frames, the camera automatically monitors the acquisition start trigger status and supplies a signal that indicates the current status.
Image Acquisition Control AW00104701000 Acq. Trigger Wait Signal ExASTrig Signal Frame Acquisition Exp. Readout Frame Acquisition Exp. Readout Frame Acquisition Exp. Readout Frame Acquisition Exp. Readout Frame Acquisition Exp. Readout Frame Acquisition Exp. Readout Time = Camera is in a "waiting for acquisition start trigger" status Fig. 44: Acquisition Trigger Wait Signal The acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled.
AW00104701000 Image Acquisition Control Selecting the Acquisition Trigger Wait Signal as the Source Signal for the Output Line The acquisition trigger wait signal can be selected to act as the source signal for camera output line 1. Selecting a source signal for the output line is a two step process: Use the Line Selector to select output line 1. Set the value of the Line Source Parameter to the acquisition trigger wait signal.
Image Acquisition Control AW00104701000 9.11 Acquisition Timing Chart Figure 45 shows a timing chart for image acquisition and transmission. The chart assumes that exposure is triggered by an ExTrig signal with rising edge activation and that the camera is set for the timed exposure mode. The ExTrig signal will be an externally triggered frame start trigger signal when using image acquisition control in standard mode.
AW00104701000 Image Acquisition Control Total Start Delay = Start Delay from Table 10 + Debouncer Setting Total Start Delay = 30.05 µs+ 5 µs Total Start Delay = 35.
Image Acquisition Control AW00104701000 9.12 Maximum Allowed Acquisition Frame Rate In general, the maximum allowed acquisition frame rate can be limited by three factors: The amount of time it takes to read an acquired frame out of the imaging sensor and into the camera’s frame buffer. This time varies depending on the height of the frame. Frames with a smaller height take less time to read out of the sensor. The frame height is determined by the camera’s AOI Height settings.
AW00104701000 Image Acquisition Control find that your exposure time is the most restrictive factor on the frame rate. In this case, you should lower your exposure time. (You may need to compensate for a lower exposure time by using a brighter light source or increasing the opening of your lens aperture.) The frame transmission time will not normally be a restricting factor.
Image Acquisition Control AW00104701000 Camera Model C1 C2 Camera Model C1 C2 slA640-74gm/gc 22.66 µs 1433.66 µs slA1390-17gm/gc 46.53 µs 10244.54 µs slA780-54gm/gc 26.94 µs 2308.54 µs slA1400-17gm/gc 46.53 µs 9357.50 µs Formula 2: Calculates the maximum frame rate based on the exposure time for the acquired frames: 1 Max.
AW00104701000 Image Acquisition Control Example Assume that you are using an slA640-74gm camera set for an exposure time of 2000 µs and for 600 x 400 resolution. Also assume that you have checked the value of the Device Current Throughput parameter and the Payload Size parameters and found them to be 110000000 and 240000 respectively. Formula 1: 1 Max Frames/s = -----------------------------------------------------------------------------[ ( 400 + 1 ) × 22.66 ] + 1433.66 Max Frames/s = 95.
Image Acquisition Control 148 AW00104701000 Basler scout light GigE
AW00104701000 Pixel Data Formats 10 Pixel Data Formats By selecting a pixel data format, you determine the format (layout) of the image data transmitted by the camera. This section provides detailed information about the available pixel data formats. 10.1 Setting the Pixel Data Format The setting for the camera’s Pixel Format parameter determines the format of the pixel data that will be output from the camera.
Pixel Data Formats AW00104701000 You can set the Pixel Format parameter value from within your application software by using the pylon API. The following code snippet illustrates using the API to set the parameter value: Camera.PixelFormat.SetValue( PixelFormat_Mono8 ); Camera.PixelFormat.SetValue( PixelFormat_Mono12Packed ); Camera.PixelFormat.SetValue( PixelFormat_Mono16 ); Camera.PixelFormat.SetValue( PixelFormat_YUV422Packed ); Camera.PixelFormat.SetValue( PixelFormat_YUV422_YUYV_Packed ); Camera.
AW00104701000 Pixel Data Formats 10.2 Pixel Data Formats for Mono Cameras 10.2.1 Mono 8 Format (Equivalent to DCAM Mono 8) When a monochrome camera is set for the Mono 8 pixel data format, it outputs 8 bits of brightness data per pixel. The table below describes how the pixel data for a received frame will be ordered in the image buffer in your PC when the camera is set for Mono8 output.
Pixel Data Formats AW00104701000 10.2.2 Mono 16 Format (Equivalent to DCAM Mono 16) When a monochrome camera is set for the Mono16 pixel data format, it outputs 16 bits of brightness data per pixel with 12 bits effective. The 12 bits of effective pixel data fill from the least significant bit. The four unused most significant bits are filled with zeros. The table below describes how the pixel data for a received frame will be ordered in the image buffer in your PC when the camera is set for Mono16 output.
AW00104701000 Pixel Data Formats When the camera is set for Mono 16, the pixel data output is 16 bit data of the “unsigned short (little endian)” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. Note that for 16 bit data, you might expect a value range from 0x0000 to 0xFFFF. However, with the camera set for Mono16 only 12 bits of the 16 bits transmitted are effective.
Pixel Data Formats AW00104701000 10.2.3 Mono 12 Packed Format When a monochrome camera is set for the Mono 12 Packed pixel data format, it outputs 12 bits of brightness data per pixel. Every three bytes transmitted by the camera contain data for two pixels. The table below describes how the pixel data for a received frame will be ordered in the image buffer in your PC when the camera is set for Mono 12 Packed output.
AW00104701000 Pixel Data Formats When a monochrome camera is set for Mono 12 Packed, the pixel data output is 12 bit data of the “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below.
Pixel Data Formats AW00104701000 10.2.4 YUV 4:2:2 Packed Format (Equivalent to DCAM YUV 4:2:2) When a monochrome camera is set for the YUV 4:2:2 Packed pixel data format, the camera transmits Y, U, and V values in a fashion that mimics the output from a color camera set for YUV 4:2:2 Packed. The Y value transmitted for each pixel is an actual 8 bit brightness value similar to the pixel data transmitted when a monochrome camera is set for Mono 8. The U and V values transmitted will always be zero.
AW00104701000 Pixel Data Formats 10.3 Pixel Data Output Formats for Color Cameras 10.3.1 The Bayer Color Filter The sensor used in color models of the camera is equipped with an additive color separation filter known as a Bayer filter. The pixel data output formats available on color cameras are related to the Bayer pattern, so you need a basic knowledge of the Bayer filter to understand the pixel formats.
Pixel Data Formats AW00104701000 10.3.1.1 Color Filter Alignment The alignment of the Bayer filter to the pixels in the images acquired by color cameras is Bayer BG for all camera models. Bayer BG alignment means that pixel one and pixel two of the first line in each image transmitted will be blue and green respectively. And for the second line transmitted, pixel one and pixel two will be green and red respectively.
AW00104701000 Pixel Data Formats 10.3.2 Bayer BG 8 Format (Equivalent to DCAM Raw 8) When a color camera is set for the Bayer BG 8 pixel data format, it outputs 8 bits of data per pixel and the pixel data is not processed or interpolated in any way. So, for each pixel covered with a red lens, you get 8 bits of red data. For each pixel covered with a green lens, you get 8 bits of green data. And for each pixel covered with a blue lens, you get 8 bits of blue data.
Pixel Data Formats AW00104701000 With the camera set for Bayer BG 8, the pixel data output is 8 bit data of the “unsigned char” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below.
AW00104701000 Pixel Data Formats 10.3.3 Bayer BG 16 Format (Equivalent to DCAM Raw 16) When a color camera is set for the Bayer BG 16 pixel data format, it outputs 16 bits of data per pixel with 12 bits effective. The 12 bits of effective pixel data fill from the least significant bit. The four unused most significant bits are filled with zeros. With the Bayer BG 16 the pixel data is not processed or interpolated in any way.
Pixel Data Formats AW00104701000 Bm-5 Low byte of green value for Pn-2 Bm-5 Low byte of red value for Pn-2 Bm-4 High byte of green value for Pn-2 Bm-4 High byte of red value for Pn-2 Bm-3 Low byte of blue value for Pn-1 Bm-3 Low byte of green value for Pn-1 Bm-2 High byte of blue value for Pn-1 Bm-2 High byte of green value for Pn-1 Bm-1 Low byte of green value for Pn Bm-1 Low byte of red value for Pn Bm High byte of green value for Pn Bm High byte of red value for Pn When the came
AW00104701000 Pixel Data Formats 10.3.4 Bayer BG 12 Packed Format When a color camera is set for the Bayer BG 12 Packed pixel data format, it outputs 12 bits of data per pixel. Every three bytes transmitted by the camera contain data for two pixels. With the Bayer BG 12 Packed coding, the pixel data is not processed or interpolated in any way. So, for each pixel covered with a red lens in the sensor’s Bayer filter, you get 12 bits of red data.
Pixel Data Formats AW00104701000 Odd Rows Byte Data B0 Green value for P0 bits 11 ... 4 B1 Red value for P1 bits 3 ... 0 B2 Red value for P1 bits 11 ... 4 B3 Green value for P2 bits 11 ... 4 B4 Red value for P3 bits 3 ... 0 B5 Red value for P3 bits 11 ... 4 B6 Green value for P4 bits 11 ... 4 B7 Red value for P5 bits 3 ... 0 B8 Red value for P5 bits 11 ... 4 • • • • • • • • • • • • Bm-5 Green value for Pn-3 bits 11 ... 4 Bm-4 Red value for Pn-2 bits 3 ...
AW00104701000 Pixel Data Formats 10.3.5 YUV 4:2:2 Packed Format (Equivalent to DCAM YUV 4:2:2) When a color camera is set for the YUV 422 Packed pixel data format, each pixel in the captured image goes through a two step conversion process as it exits the sensor and passes through the camera’s electronics. This process yields Y, U, and V color information for each pixel. In the first step of the process, an interpolation algorithm is performed to get full RGB data for each pixel.
Pixel Data Formats B4 U value for P2 B5 Y value for P2 B6 V Value for P2 B7 Y value for P3 B8 U value for P4 B9 Y value for P4 B10 V Value for P4 B11 Y value for P5 • • • • • • Bm-7 U value for Pn-3 Bm-6 Y value for Pn-3 Bm-5 V Value for Pn-3 Bm-4 Y value for Pn-2 Bm-3 U value for Pn-1 Bm-2 Y value for Pn-1 Bm-1 V Value for Pn-1 Bm Y value for Pn AW00104701000 When the camera is set for YUV 4:2:2 Packed output, the pixel data output for the Y component is 8 bit data o
AW00104701000 Pixel Data Formats This Data Value (Hexadecimal) Indicates This Signal Level (Decimal) 0xFF 127 0xFE 126 • • • • • • 0x81 1 0x80 0 0x7F -1 • • • • • • 0x01 -127 0x00 -128 The signal level of a U component or a V component can range from -128 to +127 (decimal). Notice that the data values have been arranged to represent the full signal level range.
Pixel Data Formats AW00104701000 10.3.6 YUV 4:2:2 (YUYV) Packed Format On color cameras, the YUV 4:2:2 (YUYV) packed pixel data format is similar to the YUV 4:2:2 pixel format described in the previous section. The only difference is the order of the bytes transmitted to the host PC. With the YUV 4:2:2 format, the bytes are ordered as specified in the DCAM standard issued by the 1394 Trade Association.
AW00104701000 Pixel Data Formats When a color camera is set for YUV 4:2:2 (YUYV) output, the pixel data output for the Y component is 8 bit data of the “unsigned char” type. The range of data values for the Y component and the corresponding indicated signal levels are shown below.
Pixel Data Formats AW00104701000 10.3.7 Mono 8 Format (Equivalent to DCAM Mono 8) When a color camera is set for the Mono 8 pixel data format, the pixel values in each captured image are first interpolated and converted to the YUV color model as described for the YUV 4:2:2 Packed format. The camera then transmits the 8 bit Y value for each pixel to the host PC. In the YUV color model, the Y component for each pixel represents a brightness value.
AW00104701000 Pixel Data Formats With the camera set for Mono 8, the pixel data output is 8 bit data of the “unsigned char” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below.
Pixel Data Formats AW00104701000 10.4 Pixel Transmission Sequence For each captured image, pixel data is transmitted from the camera in the following sequence: Row 0 Col 0, Row 0 Col 1, Row 0 Col 2 .. .. Row 0 Col m-2, Row 0 Col m-1, Row 0 Col m Row 1 Col 0, Row 1 Col 1, Row 1 Col 2 .. .. Row 1 Col m-2, Row 1 Col m-1, Row 1 Col m Row 2 Col 0, Row 2 Col 1, Row 2 Col 2 .. ..
AW00104701000 Standard Features 11 Standard Features This chapter provides detailed information about the standard features available on each camera. It also includes an explanation of their operation and the parameters associated with each feature. 11.1 Gain The camera’s gain setting is adjustable. As shown in Figure 47, increasing the gain increases the slope of the response curve for the camera.
Standard Features AW00104701000 Setting the Gain The camera’s gain is determined by the value of the Gain Raw parameter. Gain Raw is adjusted on a decimal scale. The minimum decimal setting varies depending on the camera model (see Table 13).
AW00104701000 Standard Features For gain raw settings from 512 to 1023: Gain dB = (0.0354 × Gain Raw Setting) – G c Where: 658 + Min Gain Raw Setting G c = 20 × log 10 ⎛ -----------------------------------------------------------------------------⎞ ⎝ 658 – Min Gain Raw Setting ⎠ Example: Assume that you are working with a monochrome slA1400-17 camera that has a gain raw setting of 500.
Standard Features AW00104701000 11.2 Black Level Adjusting the camera’s black level will result in an offset to the pixel values output by the camera. Increasing the black level setting will result in a positive offset in the digital values output for the pixels. Decreasing the black level setting will result in a negative offset in the digital values output for the pixels.
AW00104701000 Standard Features 11.3 White Balance (on Color Models) The white balance feature lets you adjust the balance of red, green, and blue such that white objects in the camera’s field of view appear white in the acquired images. Setting the White Balance With the white balancing scheme used on these cameras, the red intensity, green intensity, and blue intensity can be individually adjusted. For each color, a Balance Ratio parameter is used to set the intensity of the color.
Standard Features AW00104701000 11.4 Digital Shift The digital shift feature lets you change the group of bits that is output from the ADC in the camera. Using the digital shift feature will effectively multiply the output of the camera by 2 times, 4 times, 8 times, or 16 times. The next two sections describe how the digital shift feature works when the camera is set for a 12 bit pixel format and when it is set for a 8 bit pixel format.
AW00104701000 Standard Features Shift by 2 When the camera is set to shift by 2, the output from the camera will include bit 9 through bit 0 from the ADC along with 2 zeros as LSBs. ADC bit 11 The result of shifting twice is that the output of the camera is effectively multiplied by 4. bit 10 bit 9 bit 8 bit 7 bit 6 M S B When the camera is set to shift by 2, the 2 least significant bits output from the camera for each pixel value will be 0.
Standard Features AW00104701000 Shift By 4 When the camera is set to shift by 4, the output from the camera will include bit 7 through bit 0 from the ADC along with 4 zeros as LSBs. ADC bit 11 bit 10 bit 9 The result of shifting 4 times is that the output of the camera is effectively multiplied by 16.
AW00104701000 Standard Features automatically be set to 1. Therefore, you should only use the shift by 1 setting when your pixel readings with an 8 bit pixel format selected and with digital shift disabled are all less than 128. Shift by 2 When the camera is set to shift by 2, the output from the camera will include bit 9 through bit 2 from the ADC. The result of shifting twice is that the output of the camera is effectively multiplied by 4.
Standard Features AW00104701000 11.4.3 Precautions When Using Digital Shift There are several checks and precautions that you must follow before using the digital shift feature. The checks and precautions differ depending on whether the camera will be set for a 12 bit pixel format or for an 8 bit pixel format in your application. If you will be using a 12 bit pixel format, make this check: Use the pylon Viewer or the pylon API to set the camera for a 12 bit pixel format and no digital shift.
AW00104701000 Standard Features 11.4.4 Enabling and Setting Digital Shift You can enable or disable the digital shift feature by setting the value of the Digital Shift parameter. When the parameter is set to zero, digital shift will be disabled. When the parameter is set to 1, 2, 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.
Standard Features AW00104701000 11.5 Integrated IR Cut Filter (on Color Models) Color models of the camera are equipped with an IR cut filter. The filter is mounted inside of the Cmount lens adapter. NOTICE Lens Thread Length is Limited. The location of the IR cut filter limits the length of the threads on any lens you use with the camera. If a lens with a very long thread length is used, the IR cut filter will be damaged or destroyed and the camera will no longer operate.
AW00104701000 Standard Features 11.6 Area of Interest (AOI) The area of interest (AOI) feature lets you specify a portion of the sensor array and after each image is acquired, only the pixel information from the specified portion of the array is transmitted to the host PC. The area of interest is referenced to the top left corner of the sensor array. The top left corner is designated as column 0 and row 0 as shown in Figure 48.
Standard Features AW00104701000 Setting the AOI The AOI is set by default to use the full resolution of the camera’s sensor. You can change the size and the position of the AOI by changing the value of the camera’s X Offset, Y Offset, Width, and Height parameters. The value of the X Offset parameter determines the starting column for the area of interest. The value of the Y Offset parameter determines the starting row for the area of interest.
AW00104701000 Standard Features You can set the X Offset, Y Offset, Width, and Height parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to get the maximum allowed settings and the increments for the Width and Height parameters. They also illustrate setting the X Offset, Y Offset, Width, and Height parameter values int64_t widthMax = Camera.Width.GetMax( ); int64_t widhInc = Camera.Width.GetInc(); Camera.Width.
Standard Features AW00104701000 11.7 Reverse X The reverse X feature is a horizontal mirror image feature. When the reverse X feature is enabled, the pixel values for each line in a captured image will be swapped end-for-end about the line’s center. This means that for each line, the value of the first pixel in the line will be swapped with the value of the last pixel, the value of the second pixel in the line will be swapped with the value of the nextto-last pixel, and so on.
AW00104701000 Standard Features Normal Image Mirror Image AOI AOI Fig. 50: Using an AOI with Reverse X Mirror Imaging For color cameras, provisions are made ensuring that the effective color filter alignment will be constant for both, normal and mirror images. Setting Reverse X 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.
Standard Features AW00104701000 11.8 Disable Parameter Limits For each camera parameter, the allowed range of parameter values normally is limited. The factory limits are designed to ensure optimum camera operation and, in particular, good image quality. For special camera uses, however, it may be helpful to set parameter values outside of the factory limits. The disable parameter limits feature lets you disable the factory parameter limits for certain parameters.
AW00104701000 Standard Features 11.9 Debouncer The debouncer feature aids in discriminating between valid and invalid input signals and only lets valid signals pass to the camera. The debouncer value specifies the minimum time that an input signal must remain high or remain low in order to be considered a valid input signal. We recommend setting the debouncer value so that it is slightly greater than the longest expected duration of an invalid signal.
Standard Features AW00104701000 Setting the Debouncer The debouncer value is determined by the value of the Line Debouncer Time Abs parameter value. The parameter is set in microseconds and can be set in a range from 0 to approximately 1 s. To set a debouncer: Use the Line Selector to select the camera input line 1. Set the value of the Line Debouncer Time Abs parameter.
AW00104701000 Standard Features 11.10 Trigger Delay The trigger delay feature lets you specify a delay (in microseconds) that will be applied between the receipt of a hardware trigger and it becoming effective. The trigger delay can be specified in the range from 0 to 10000000 µs (equivalent to 10 s). When the delay is set to 0 µs, no delay will be applied.
Standard Features AW00104701000 Camera.TriggerSelector.SetValue( TriggerSelector_FrameStart ); // Trigger delay double TriggerDelay_us = 1000.0 // 1000us == 1ms == 0.001s; Camera.TriggerDelayAbs.SetValue( TriggerDelay_us ); Legacy mode: // Select the acquisition start trigger Camera.TriggerSelector.SetValue( TriggerSelector_AcquisitionStart ); // Trigger delay double TriggerDelay_us = 1000.0 // 1000us == 1ms == 0.001s; Camera.TriggerDelayAbs.
AW00104701000 Standard Features 11.11 Acquisition Status When controlling image acquisition with a software trigger you can use the acquisition status feature to detemine when the camera is ready to be triggered for an image acquisition. Using this feature, you can avoid triggering the camera at a rate that exceeds the maximum allowed with the current camera settings. For other means of checking the acquisition status, see also the "Acquisition Monitoring Signals" section.
Standard Features AW00104701000 You can also use the Basler pylon Viewer application to easily set the Acquisition Status Selector.For more information about the pylon Viewer, see Section 3.1 on page 25. For more information about the standard and legacy image acquisition control modes, see Section 9.1 on page 83.
AW00104701000 Standard Features 11.12 Test Images All cameras include the ability to generate test images. Test images are used to check the camera’s basic functionality and its ability to transmit an image to the host PC. Test images can be used for service purposes and for failure diagnostics. For test images, the image is generated internally by the camera’s logic and does not use the optics, the imaging sensor, or the ADC. Six test images are available.
Standard Features AW00104701000 Test Image 1 - Fixed Diagonal Gray Gradient (8 bit) The 8 bit fixed diagonal gray gradient test image is best suited for use when the camera is set for monochrome 8 bit output. The test image consists of fixed diagonal gray gradients ranging from 0 to 255. If the camera is set for 8 bit output and is operating at full resolution, test image one will look similar to Figure 52.
AW00104701000 Standard Features Test Image 3 - Moving Diagonal Gray Gradient (12 bit) The 12 bit moving diagonal gray gradient test image is similar to test image 2, but it is a 12 bit pattern. 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.
Standard Features AW00104701000 Test Image 6 - Moving Diagonal Color Gradient The moving diagonal color gradient test image is available on color cameras only and is designed for use when the camera is set for YUV output. As shown in Figure 53, test image six consists of diagonal color gradients. The image moves by one pixel from right to left whenever you signal the camera to capture a new image. To display this test pattern on a monitor, you must convert the YUV output from the camera to 8 bit RGB.
AW00104701000 Standard Features 11.13 Device Information Parameters Each camera includes a set of "device information" parameters. These parameters provide some basic information about the camera. The device information parameters include: Device Vendor Name (read only) - contains the name of the camera’s vendor. For scout light cameras, this string will always indicate Basler as the vendor. Device Model Name (read only) - contains the model name of the camera, for example, slA640-74gm.
Standard Features AW00104701000 // Read the Device ID parameter Pylon::String_t deviceID = Camera.DeviceID.GetValue(); // Write and read the Device User ID Camera.DeviceUserID = "custom name"; Pylon::String_t deviceUserID = Camera.DeviceUserID.GetValue(); // Read the Sensor Width parameter int64_t sensorWidth = Camera.SensorWidth.GetValue(); // Read the Sensor Height parameter int64_t sensorHeight = Camera.SensorHeight.GetValue(); // Read the Max Width parameter int64_t maxWidth = Camera.WidthMax.
AW00104701000 Standard Features 11.14 Configuration Sets A configuration set is a group of values that contains all of the parameter settings needed to control the camera. There are three basic types of configuration sets: the active set, the default factory set, and user sets. The Active Set The active set contains the camera’s current parameter settings and thus determines the camera’s performance, that is, what your image currently looks like.
Standard Features AW00104701000 User Sets As mentioned above, the active configuration set is stored in the camera’s volatile memory and the settings are lost if the camera is reset or if power is switched off. The camera can save most of the settings from the current active set to a reserved area in the camera’s non-volatile memory. A configuration set that has been saved in the non-volatile memory is not lost when the camera is reset or switched off.
AW00104701000 Standard Features 11.14.2 Selecting a Factory Setup as the Default Set When the camera is delivered, the Standard Factory Setup will be selected as the default set. You can, however, select any one of the two factory setups to serve as the default set. To select which factory setup that will serve as the default set: Set the Default Set Selector to the Standard Factory Setup or High Gain Factory Setup.
Standard Features AW00104701000 11.14.3Loading a Saved Set or the Default Set into the Active Set If you have saved a configuration set into the camera’s non-volatile memory, you can load the saved set from the camera’s non-volatile memory into the camera’s active set. When you do this, the loaded set overwrites the parameters in the active set. Since the settings in the active set control the current operation of the camera, the settings from the loaded set will now be controlling the camera.
AW00104701000 Standard Features 11.14.4 Selecting the Startup Set You can select the default configuration set (i.e., whichever was selected as the default configuration set, either the Standard Factory Setup or the High Gain Factory Setup) or one of the user configuration sets stored in the camera’s non-volatile memory to be the "startup set". The configuration set that you designate as the startup set will be loaded into the active set whenever the camera starts up at power on or after a reset.
Standard Features 208 AW00104701000 Basler scout light GigE
AW00104701000 Troubleshooting and Support 12 Troubleshooting and Support This chapter outlines the resources available to you if you need help working with your camera. 12.1 Tech Support Resources If you need advice about your camera or if you need assistance troubleshooting a problem with your camera, you can contact the Basler technical support team for your area. Basler technical support contact information is located in the front pages of this manual.
Troubleshooting and Support AW00104701000 12.3 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. Copy the form that appears on the next two pages, fill it out, and fax the pages to your local dealer or to your nearest Basler support center.
AW00104701000 7 How often did/does the problem occur? Troubleshooting and Support Once. Every time. Regularly when: Occasionally when: 8 How severe is the problem? Camera can still be used. Camera can be used after I take this action: Camera can no longer be used. 9 10 Did your application ever run without problems? Yes No 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.
Troubleshooting and Support 212 AW00104701000 Basler scout light GigE
AW00104701000 Revision History Revision History Doc. ID Number Date Changes AW00104701000 30 Nov 2011 Initial release.
Revision History 214 AW00104701000 Basler scout light GigE
AW00104701000 Index Index A C acquisition frame count parameter ....93, 95 acquisition frame rate abs parameter .......... ........................................ 99, 101, 110, 112 acquisition mode parameter ....................89 acquisition start command ........ 85, 89, 195 acquisition start trigger ............................86 details ................................................91 acquisition start trigger delay (legacy mode) ........................................
Index AW00104701000 E G electromagnetic interference ...................17 electrostatic discharge ............................17 EMI ..........................................................17 enable resend parameter ..................28, 30 environmental requirements ...................18 ESD .........................................................17 exposure overlapped ......................................133 exposure active signal ..........................135 exposure mode timed ................
AW00104701000 line source parameter ..... 73, 135, 137, 141 line status parameter ...............................81 M max frame jitter parameter ......................43 max frame rate ......................................144 max height parameter ...........................201 max number resend request parameter ..33 max width parameter .............................201 maximum lens thread length ...................14 mirror image ..........................................188 missing packet detection ....
Index S saving parameter sets ...................203, 204 sensor architecture .......................................54 optical size ......................................2, 4 pixel size .............................................4 size .............................................1, 2, 4 type .................................................2, 4 sensor height parameter .......................201 sensor width parameter ........................201 serial number ..........................................
