Page 1 Basler Area Scan Cameras Ground-breaking price starting at 299 Euro Gigabit Ethernet interface with PoE VGA to five megapixels and up to 100 fps Selected high-quality CCD and CMOS sensors Arrow.com. Downloaded from...
Page 2 • FCC • CE Replacement with a smile Because the Basler ace uses the same 29 x 29 mm footprint that has been standard on analog cameras for many years, replacement of analog cameras is very easy. Some IEEE 1394a and 1394b cameras Arrow.com.
Page 3 < 90 g Conformity CE, FCC, IP30, RoHS, PoE (802.3af), UL (in preparation) Software / Driver Driver Basler pylon SDK including filter and performance driver Operating System Windows, Linux - 32 bit and 64 bit Conformity GigE Vision, GenICam Specifications are subject to change without prior notice.
Page 4 All requires strict RoHS compliance in all measurements done by Basler will be in 100% compliance with the system components. new European Machine Vision Association EMVA 1288 standard. Because it describes a unified way to measure, compute, and...
Page 5 Basler ace USER’S MANUAL Document Number: AW000893 Version: 03 Language: 000 (English) Release Date: 30 July 2010 Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from...
Page 6 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 7 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...
Page 8 Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from...
Page 9: Table Of Contents
Ethernet GigE Device Information ........33 Basler ace Arrow.com.
Page 10 Setting the Exposure Time ..........70 Basler ace Arrow.com.
Page 11 6.12 Maximum Allowed Frame Rate......... . . 98 6.12.1 Using Basler pylon to Check the Maximum Allowed Frame Rate ..98 6.12.2 Increasing the Maximum Allowed Frame Rate .
Page 12 10.13 Test Images ............183 Basler ace Arrow.com.
Page 13 12.2 Obtaining an RMA Number..........211 12.3 Before Contacting Basler Technical Support ....... 212...
Page 14 Table of Contents Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from Downloaded from...
Page 15: Specifications, Requirements, And Precautions
We strongly recommend that you read and follow the precautions. Models The current Basler ace GigE Vision 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 16: General Specifications
ADC Bit Depth 12 bits Synchronization Via external trigger signal, via the Ethernet connection, or free run Exposure Control Via external trigger signal or programmable via the camera API Table 1: General Specifications Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 17 CE, UL (in preparation), FCC, GenICam, GigE Vision, IP30, RoHS, PoE 802.3 af Software Driver Basler’s GigEVision compliant pylon SDK including filter and performance drivers. Available for windows or Linux in 32 and 64 bit versions. Table 1: General Specifications Basler ace Arrow.com.
Page 18 Conformity CE, UL (in preparation), FCC, GenICam, GigE Vision, IP30, RoHS Software Driver Basler’s GigEVision compliant pylon SDK including filter and performance drivers. Available for windows or Linux in 32 and 64 bit versions. Table 2: General Specifications Basler ace Arrow.com.
Page 19: Spectral Response
The following graphs show the spectral response for each available monochrome camera model. Note The spectral response curves exclude lens characteristics and light source characteristics. Wave Length (nm) Fig. 1: acA640-100gm Spectral Response Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 20 Specifications, Requirements, and Precautions Wave Length (nm) Fig. 2: acA750-30gm Spectral Response 1000 Wave Length (nm) Fig. 3: acA1300-30 gm Spectral Response Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 21: Color Camera Spectral Response
400 nm to 700 ... 720 nm, and it should cut off from 700 ... 720 nm to 1100 A suitable IR cut filter is built into the standard C-mount lens adapter on color models of the camera. Blue Green Wave Length (nm) Fig. 4: acA640-100gc Spectral Response Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 22 Specifications, Requirements, and Precautions Blue Green 4 00 5 00 60 0 Wave Length (nm) Fig. 5: acA1300-30gc Spectral Response Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 23: Mechanical Specifications
M3; 3 deep 2x M2; 3 deep 2x M2; 3 deep 2x M3; 3 deep 16.5 22 (dimension for M2) 17.526 Photosensitive surface of the sensor Fig. 6: Mechanical Dimensions (in mm) Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 24: Maximum Thread Length On Color Cameras
(9.6) C-mount Lens C-mount Lens IR-Cut Filter Not to Scale Unthreaded Thread - 9.6 Max 10.8 Max Fig. 7: Maximum Lens Thread Length on Color Cameras (dimensions in mm) Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 25: 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 Arrow.com. Arrow.com. Arrow.com.
Page 26: Avoiding Emi And Esd Problems
Use suitable clothing (cotton) and shoes. 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.
Page 27: Environmental Requirements
You must provide sufficient heat dissipation to maintain the temperature of the camera housing at 50 °C or less. Since each installation is unique, Basler does not supply a strictly required technique for proper heat dissipation. Instead, we provide the following general guidelines: In all cases, you should monitor the temperature of the camera housing and make sure that the temperature does not exceed 50 °C.
Page 28: Precautions
The plug on the cable that you attach to the camera’s 6-pin connector must have 6 female pins. Using a plug designed for a smaller or a larger number of pins can damage the connector. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 29 3. The code snippets in this manual are written in C++. Other programming languages can also be used to write code for use with Basler pylon. When writing code, you should use a programming language that is both compatible with pylon and appropriate for your application.
Page 30 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 Arrow.com. Arrow.com. Arrow.com.
Page 31: Installation
More extensive information about how to perform complicated installations is included in the Installation and Setup Guide for Cameras Used with Basler’s pylon API (AW000611xx000). You can download the Installation and Setup Guide for Cameras Used with Basler’s pylon API from the Downloads section of the Basler website: www.baslerweb.com...
Page 32 Installation Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Downloaded from Downloaded from Downloaded from...
Page 33: Tools For Changing Camera Parameters
The Basler IP Configuration Tool is a standalone application that lets you change the IP configuration of the camera via a GUI. The tool will detect all Basler GigE cameras attached to your network and let you make changes to a selected camera.
Page 34: The Pylon Api
API. The SDK is included in Basler’s pylon Driver Package. You can obtain the pylon package from the Downloads section of the Basler website: www.baslerweb.com...
Page 35: Camera Functional Description
Exposure start and exposure time can be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface. There are also parameters available to set the camera for single frame acquisition or continuous frame acquisition.
Page 36 Shift Shift Reg. Reg. Reg. Reg. = Field 0 Readout = Field 1 Horizontal Readout Shift Register Fig. 9: CCD Sensor Architecture - Interlaced Scan Sensors Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 37 Sensor Network Controller Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 10: Camera Block Diagram Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 38 Camera Functional Description Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 39: Physical Interface
A 6-pin receptacle used to provide access to the camera’s I/O lines and to provide power to the camera (if PoE is not used). The drawing below shows the location of the two connectors. 8-pin RJ-45 Jack 6-pin Receptacle Fig. 11: Camera Connectors Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 40: Connector Pin Assignments And Numbering
I/O Ground DC Camera Power Ground Table 3: Pin Assignments for the 6-pin Receptacle The pin numbering for the 6-pin receptacle is as shown in Figure 12. Fig. 12: Pin Numbering for the 6-pin Receptacle Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 41: Jack Pin Assignments & Numbering
The 8-pin RJ-45 jack provides a Gigabit Ethernet connection to the camera. The jack can also be used to provide Power over Ethernet (IEEE 802.3af compliant) to the camera. Pin assignments and pin numbering adhere to the Ethernet standard and IEEE 802.3af. Basler ace Arrow.com. Arrow.com.
Page 42: Connector Types
The 8-pin jack for the camera’s Ethernet connection is a standard RJ-45 connector. The recommended mating connector is any standard 8-pin RJ-45 plug. Cables terminated with screw-lock connectors are available from Basler. Contact your Basler sales representative to order cable assemblies.
Page 43: Cabling Requirements
The maximum length of the standard power and I/O cable is at least 10 meters. The cable must be shielded and must be constructed with twisted pair wire. Use of twisted pair wire is essential to ensure that input signals are correctly received. Basler ace Arrow.com. Arrow.com.
Page 44 Close proximity to strong magnetic fields should be avoided. The required 6-pin Hirose plug is available from Basler. Basler also offers a cable assembly that is terminated with a 6-pin Hirose plug on one end and unterminated on the other. Contact your Basler sales representative to order connectors or cables.
Page 45: Plc Power And I/O Cable
Close proximity to strong magnetic fields should be avoided. Basler offers a PLC power and I/O cable that is terminated with a 6-pin Hirose plug (HR10A-7P-6S) on the end that connects to the camera. The other end is unterminated. Contact your Basler sales representative to order the cable.
Page 46: Camera Power
Using a plug designed for a smaller or a larger number of pins can damage the connector. For more information about the 6-pin connector and the power and I/O cables see Section 5.2 on page 26, Section 5.3 on page 28, and Section 5.4 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 47: Ethernet Gige Device Information
Physical Interface Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 48: Input And Output Lines
The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 4: Voltage Requirements When Using the Standard Power and I/O Cable Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 49 The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 5: Voltage Requirements When Using a PLC Power and I/O Cable Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 50: Input Line Behavior
Figure 15 shows an example of a typical circuit you can use to input a signal into the camera. Input Line 1 can be used to receive an externally generated frame start trigger (ExFSTrig) signal for controlling the start of image acquisition. Fig. 15: Typical Input Circuit Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 51: Input Line Response Time
Level of Camera’s Internal Input Circuit Fig. 16: Input Line Response Times Time Delay Rise (TDR) = 1.3 µs to 1.6 µs Time Delay Fall (TDF) = 40 µs to 60 µs Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 52: Debouncer
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. 17: Filtering of Input Signals by the Debouncer Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 53 // Set the parameter value to 100 microseconds Camera.LineDebouncerTimeAbs.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 54: Output Line
A logical zero on Out_1_Ctrl results in a non-conducting Q1 transistor in the output circuit. A logical one on Out_1_Ctrl results in a conducting Q1 transistor in the output circuit. Fig. 18: Output Line Schematic Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 55 For more information about the invert function on the output, see Section 9.2.3 on page 132. Figure 19 shows a typical circuit you can use to monitor the output line with a voltage signal. Fig. 19: Typical Voltage Output Circuit Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 56 Output Line 1, see Section 9.2.1 on page 130. 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 Section 6.8 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 57: Output Line Response Time
Fig. 21: Output Line Response Times Time Delay Rise (TDR) = 40 µs Rise Time (RT) = 20 µs to 70 µs Time Delay Fall (TDF) = 0.6 µs Fall Time (FT) = 0.7 µs to 1.4 µs Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 58 Physical Interface Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 59: Image Acquisition Control
If the Acquisition Mode parameter is set to "continuous frame", an Acquisition Start command does not expire after a single frame is captured. Once an Acquisition Start command has been executed, you can acquire as many frames as you like. The Acquisition Start command will remain in effect Basler ace Arrow.com. Arrow.com.
Page 60 When frame start is being triggered in this manner, it is important that you not attempt to trigger frames at a rate that is greater than the maximum allowed. (There is a detailed Basler ace Arrow.com. Arrow.com.
Page 61 1 will be used as the source for the selected trigger. At that point, each time a proper electrical signal is applied to input line 1, the selected trigger signal will be recognized by the camera. Basler ace Arrow.com. Arrow.com.
Page 62 Acquisition Start Trigger has a mode setting and The Frame Start Trigger has a mode setting. 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 applied to either the Acquisition Start Trigger or the Frame Start Trigger.
Page 63: Acquisition Start And Stop Commands And The Acquisition Mode
Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeAbs.SetValue( 3000 ); Camera.AcquisitionStart.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 64: The Acquisition Start Trigger
The camera can then react to frame start trigger signals and will continue to do so until the number of frame start trigger signals it has received is equal to the current Acquisition Frame Count parameter setting. The camera will then return to the "waiting for acquisition start trigger" acquisition Basler ace Arrow.com. Arrow.com.
Page 65: Acquisition Frame Count
"waiting for acquisition start trigger" acquisition status. At that point, you must apply a new acquisition start trigger signal to exit the camera from the "waiting for acquisition start trigger" acquisition status. Basler ace Arrow.com. Arrow.com.
Page 66: Setting The Acquisition Start Trigger Mode And Related Parameters
// Set the acquisition frame count Camera.AcquisitionFrameCount.SetValue( 5 ); 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 67: Using A Software Acquisition Start Trigger
// Set the mode for the selected trigger Camera.TriggerMode.SetValue( TriggerMode_On ); // Set the source for the selected trigger Camera.TriggerSource.SetValue ( TriggerSource_Software ); // Set the acquisition frame count Camera.AcquisitionFrameCount.SetValue( 5 ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 68 // a Trigger Software command will apply an acquisition start software trigger // to the camera 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 69: Using A Hardware Acquisition Start Trigger
// Set the mode for the selected trigger Camera.TriggerMode.SetValue( TriggerMode_On ); // Set the source for the selected trigger Camera.TriggerSource.SetValue ( TriggerSource_Line1 ); // Set the trigger activation mode to rising edge Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 70 // trigger, to trigger 5 frame starts, and to retrieve 5 frames here Camera.AcquisitionStop.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 71: The Frame Start Trigger
If the parameter is enabled and is set to a value less than the maximum allowed frame acquisition rate with the current camera settings, the camera will generate frame start triggers at the rate specified by the parameter setting. Basler ace Arrow.com. Arrow.com.
Page 72: Frame Start Trigger Mode = On
For more information about using a software trigger to control frame acquisition start, see Section 6.4.2 on page For more information about using a hardware trigger to control frame acquisition start, see Section 6.4.3 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 73: Setting The Frame Start Trigger Mode And Related Parameters
Frame Start Trigger Mode to Off, and the Acquisition Frame Rate to 60: // Set the acquisition mode to continuous frame Camera.AcquisitionMode.SetValue( AcquisitionMode_Continuous ); // Select the frame start trigger Camera.TriggerSelector.SetValue( TriggerSelector_FrameStart ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 74: Using A Software Frame Start Trigger
Camera.AcquisitionFrameRateAbs.SetValue( 60.0 ); // Start frame capture Camera.AcquisitionStart.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 75: Acquisition Status
Section 6.4.2.3 on page 62 includes more detailed information about applying a software frame start trigger to the camera using Basler pylon. For more information about determining the maximum allowed frame rate, see Section 6.12 on page 6.4.2.2...
Page 76: Setting The Parameters Related To Software Frame
// a Trigger Software command will apply a frame start software trigger The following code snippet illustrates using the API to check the acquisition status: // Set the acquisition status selector Camera.AcquisitionStatusSelector.SetValue ( AcquisitionStatusSelector_FrameTriggerWait ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 77 // Read the acquisition status bool IsWaitingForFrameTrigger = Camera.AcquisitionStatus.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 78: Using A Hardware Frame Start Trigger
ExFSTrig signal, see Section 6.4.3.4 on page For more information about the electrical requirements for line 1, see Section 5.7.1 on page For more information about determining the maximum allowed frame rate, see Section 6.12 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 79: Exposure Modes
Fig. 25: Overtriggering with Timed Exposure For more information about the Frame Start Overtrigger event, seeSection 10.12 on page 181. For more information about the camera’s Exposure Time Abs parameter, see Section 6.5 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 80 µs to 5500 µs. In this case you would set the camera’s Exposure Overlap Time Max Abs parameter to 3000 µs. For more information about the Frame Trigger Wait signal and the Exposure Overlap Time Max Abs parameter, see Section 6.10 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 81: Frame Start Trigger Delay
Camera.TriggerSource.SetValue ( TriggerSource_Line1 ); // Set the trigger activation mode to rising edge Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); // Set the trigger delay for one millisecond (1000us == 1ms == 0.001s) double TriggerDelay_us = 1000.0; Camera.TriggerDelayAbs.SetValue( TriggerDelay_us ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 82 // Prepare for frame acquisition here Camera.AcquisitionStart.Execute( ); while ( ! finished ) // Frame acquisition will start each time the externally generated // frame start trigger signal (ExFSTrig signal)goes high // Retrieve the captured frames Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 83 Image Acquisition Control Camera.AcquisitionStop.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on...
Page 84: Setting The Exposure Time
16 µs 1000000 µs acA750-30gm/g 30 µs 1000000 µs acA1300-30gm/gc 22 µs 10000000 µs Table 7: Minimum Allowed Exposure Time Setting and Maximum Possible Exposure Time Setting Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 85 The following code snippet illustrates using the API to set the parameter value: Camera.ExposureTimeAbs.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameter.
Page 86: Aca-750 Acquisition Differences
Row 1 Row 2 Row 3 Row 4 Row 5 Row 6 Row 7 Row 8 Row 9 Row 10 Horizontal Shift Registers Fig. 27: Field 0 Readout Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 87 Row 1 Row 2 Row 3 Row 4 Row 5 Row 6 Row 7 Row 8 Row 9 Row 10 Horizontal Shift Registers Fig. 28: Field 1 Readout Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 88: Field Output Modes
Frame Row 1 + Row 2 Row 3 + Row 4 Row 5 + Row 6 Row 7 + Row 8 Row 9 + Row 10 Fig. 30: Field 1 Output Mode Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 89 Row 3 + Row 4 Row 5 + Row 6 Field 1 Pixel Data Row 7 + Row 8 Row 9 + Row 10 Fig. 31: Concatenated New Fields Output Mode Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 90 Row 7 + Row 8 Row 8 + Row 9 Row 9 + Row 10 Field 1 Field 0 Pixel Data Pixel Data Fig. 32: Deinterlaced New Fields Output Mode Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 91: Setting The Field Output Mode
// Set the field output mode to Deinterlaced New Fields Camera.FieldOutputMode.SetValue( DeinterlacedNewFields ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 92: Use Case Diagrams
The images can then be used for a variety of purposes including vegetation coverage estimates, archaeological site identification, etc. For more information about the Acquisition Frame Rate Abs parameter, see Section 6.3.1.1 on page Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 93 Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 33: Use Case 1 - Acquisition Start Trigger Off and Frame Start Trigger Off Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 94 1, it serves as a frame start trigger signal and initiates a frame acquisition. The frame acquired by the camera will be 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 Arrow.com. Arrow.com.
Page 95 Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal (applied to line 1) Time Fig. 34: Use Case 2 - Acquisition Start Trigger Off and Frame Start Trigger On Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 96 (this avoids the need to store images of an empty toll booth area.) For more information about the Acquisition Frame Rate Abs parameter, see Section 6.3.1.1 on page Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 97 Executed Executed Acquisition Start Trigger Signal (applied to line 1) Frame Start Trigger Signal Time Fig. 35: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 98 (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 Arrow.com. Arrow.com.
Page 99 Acquisition Start Trigger Software Command Executed Frame Start Trigger Signal (applied to line 1) Time Fig. 36: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 100: The Exposure Active Signal
Section 9.2.1 on page 130. For more information about the electrical characteristics of the camera’s output line, see Section 5.7.2 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 101: Overlapping Exposure With Sensor Readout
Frame Acquisition N Exposure Readout Frame Acquisition N+1 Exposure Readout Frame Acquisition N+2 Exposure Readout Frame Acquisition N+3 Exposure Readout Time Fig. 39: Overlapped Exposure and Readout Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 102 API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily get the parameter value.
Page 103 For more information about the Frame Trigger Wait output signal and the Exposure Overlap Time Max parameter, see Section 6.10 on page For more information about trigger width exposure, see Section 6.4.3.2 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 104: Using The Frame Trigger Wait Signal To Avoid Overtriggering The Camera
Exposure Readout exposure time parameter) Frame Acquisition N+2 Exposure Readout Frame Acquisition N+3 Exposure Readout Time Fig. 41: Overtriggering in Timed Exposure Mode Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 105 N+1 was still in progress. The will be dropped and a Frame Start frame Overtrigger event will be generated. Frame Acquisition N+3 Exposure Readout Time Fig. 42: Overtriggering in Trigger Width Exposure Mode Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 106: The Frame Trigger Wait Signal
For more information about assigning the Frame Trigger Wait signal to output line 1, see Section 9.2.1 on page 130. For more information about hardware triggering, see Section 6.4.3 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 107: Using The Frame Trigger Wait Signal
Abs parameter setting Frame Acquisition N+1 Exposure Readout Exp. Time Setting Frame Acquisition N+2 Exposure Readout Time Fig. 44: Frame Trigger Wait Signal with the Timed Exposure Mode Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 108 You can use the pylon API to set the Exposure Overlap Time Max Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: Camera.ExposureOverlapTimeMaxAbs.SetValue( 3000 ); Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 109 Image Acquisition Control For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page The frame trigger wait output signal can be assigned to camera output line 1.
Page 110: Acquisition Timing Chart
Line Debouncer Time Abs parameter for input line 1 to 5 µs. In this case: Total Start Delay = Start Delay from Table 8 + Debouncer Setting Total Start Delay = 17.62 µs+ 5 µs Total Start Delay = 22.62 µs Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 111 API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily get the parameter value.
Page 112: Maximum Allowed Frame Rate
You can use the online frame rate calculator found in the Support section of the Basler website: www.baslerweb.com You can use Basler pylon to read the value of the camera’s Resulting Frame Rate Abs parameter (see below). For more information about AOI Height settings, see Section 10.5 on page 152.
Page 113: Increasing The Maximum Allowed Frame Rate
For more information about AOI settings, see Section 10.5 on page 152. For more information about the packet size and inter-packet delay settings and about the settings that determine the bandwidth assigned to the camera, see Section B.2 on page 234. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 114: Disabling The Frame Rate Limit
Read the value of the Resulting Frame rate parameter with the limit disabled. For more information about using the Disable Parameter Limits feature, see Section 10.11 on page 179. For more information about the Resulting Frame Rate parameter, see page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 115: Color Creation And Adjustment
"BG" filter alignment). As the figure illustrates, within each square of four pixels, one pixel sees only red light, one sees only blue light, and two pixels see only green light. (This combination mimics the human eye’s sensitivity to color.) Sensor Pixels Fig. 47: Bayer Filter Pattern Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 116: Bayer Color Filter Alignment
In the first step of the process, an interpolation algorithm is performed to get full RGB data for each pixel. This is required because color cameras with a Bayer filter on the sensor gather only one color of light for each individual pixel. Basler ace Arrow.com. Arrow.com.
Page 117 Mono 8, it outputs an 8 bit monochrome image. (This type of output is sometimes referred to as "Y Mono 8".) For complete details of the Mono 8 format, see Section 8.3 on page 115. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 118: White Balance (Applies To All Color Cameras)
To set the Balance Ratio parameter for a color: Set the Balance Ratio Selector to red, green, or blue. Set the Balance Ratio Abs parameter to the desired value for the selected color. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 119 Camera.BalanceRatioSelector.SetValue( BalanceRatioSelector_Green ); Camera.BalanceRatioAbs.SetValue( 1.20 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 120 Color Creation and Adjustment Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 121: Pixel Data Formats
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_Mono12 ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 122 Camera.PixelFormat.SetValue( PixelFormat_YUV422_YUYV_Packed ); Camera.PixelFormat.SetValue( PixelFormat_BayerBG8 ); Camera.PixelFormat.SetValue( PixelFormat_BayerBG12 ); 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 123: Pixel Data Formats For Mono Cameras
This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 124: Mono 12 Format
High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 125 A camera that is set for Mono 12 has only 12 effective bits out of the 16 bits transmitted for each pixel. The leader of each transmitted frame will indicate Mono 12 as the pixel format. Basler ace Arrow.com. Arrow.com.
Page 126: Mono 12 Packed Format
11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 bits 11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 127 This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 128: Yuv 4:2:2 Packed Format
The order of the pixel data for a received frame in the image buffer in your PC is similar to the order of YUV 4:2:2 (YUYV) Packed output from a color camera. For more information about the YUV 4:2:2 (YUYV) Packed format on color cameras, see Section 8.3.5 on page 124. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 129: Pixel Data Output Formats For Color Cameras
² • • ² ² • • ² ² Blue value for P Green value for P Green value for P Red value for P Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 130 The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 131: Bayer Bg 12 Format
• • • Low byte of blue value for P Low byte of green value for P High byte of blue value for P High byte of green value for P Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 132 A camera that is set for Bayer BG 12 has only 12 effective bits out of the 16 bits transmitted for each pixel. The leader of each transmitted frame will indicate Bayer BG12 as the pixel format. Basler ace Arrow.com. Arrow.com.
Page 133: Bayer Bg 12 Packed Format
Blue value for P bits 11 ... 4 Green value for P bits 3 ... 0 Blue value for P bits 3 ... 0 Green value for P bits 11 ... 4 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 134 This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 135: Yuv 4:2:2 Packed Format
Y value for P V Value for P Y value for P U value for P Y value for P V Value for P Y value for P • • Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 136 This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 137 0x00 -128 The signal level of a U component or a V component can range from -128 to +127 (decimal). Notice that the data values have been arranged to represent the full signal level range. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 138: Yuv 4:2:2 (Yuyv) Packed Format
Y value for P U value for P Y value for P V value for P Y value for P U value for P Y value for P V value for P Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 139 0x00 -128 The signal level of a U component or a V component can range from -128 to +127 (decimal). Notice that the data values have been arranged to represent the full signal level range. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 140: Mono 8 Format
Y value for P Y value for P • • • • • • Y value for P Y value for P Y value for P Y value for P Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 141 This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 142: Pixel Transmission Sequence
The sequence assumes that the camera is set for full resolution. The pixel transmission sequence described above does not adequately describe the behavior of acA750-30 cameras. For more information about how the acA750- 30 differs, see Section 6.6 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 143: O Control
For more information about the electrical characteristics of the input line, see Section 5.7.1 on page Note By default, input line 1 is selected as the source for the frame start trigger. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 144: Configuring The Output Line
Camera.LineSelector.SetValue( LineSelector_Out1 ); Camera.LineSource.SetValue( LineSource_ExposureActive ); 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 145: Setting The State Of A User Settable Output Line
Camera.UserOutputValue.SetValue( true ); bool currentUserOutput1State = Camera.UserOutputValue.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 146: Setting The Output Line For Invert
// Enable the inverter on output line 1 Camera.LineSelector.SetValue( LineSelector_Out1 ); Camera.LineInverter.SetValue( true ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 147: Working With The Timer Signal
Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerTriggerSource.SetValue( TimerTriggerSource_ExposureStart ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 148: Setting The Timer Delay Time
Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDelayRaw.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 149 Timer Delay Abs parameter to the nearest achieveable value. You should also be aware that if you change the delay time using the raw settings, the Timer Delay Abs parameter will automatically be updated to reflect the new delay time. Basler ace Arrow.com. Arrow.com.
Page 150: Setting The Timer Duration Time
Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDurationRaw.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 151 Duration Abs parameter will indicate the current duration time setting. You should also be aware that if you change the duration time using the raw settings, the Timer Duration Abs parameter will automatically be updated to reflect the new duration time. Basler ace Arrow.com. Arrow.com.
Page 152: Checking The State Of The I/O Lines
Camera.LineSelector.SetValue( LineSelector_Out1 ); bool outputLine1State = Camera.LineStatus.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 153 If a bit is 1, it indicates that the state of the associated line is current high. Indicates output line 1 state Indicates input line 1 state Fig. 50: Line Status All Parameter Bits Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 154 I/O Control Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 155: Standard Features
Fig. 51: Gain in dB output by the camera were no higher than 127 (in an 8 bit mode), you could increase the gain to 6 dB (an amplification factor of 2) and thus reach gray values of 254. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 156 You can set the Gain Selector and the Gain Raw parameter value from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.GainSelector.SetValue( GainSelector_All ); Camera.GainRaw.SetValue( 400 ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 157 Standard Features For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on...
Page 158: Black Level
Camera.BlackLevelSelector.SetValue ( BlackLevelSelector_All ); Camera.BlackLevelRaw.SetValue( 32 ); 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 159: Digital Shift
1. Therefore, you should only use the shift by 1 setting when your pixel readings with a 12 bit pixel format selected and with digital shift disabled are all less than 2048. Basler ace Arrow.com. Arrow.com.
Page 160 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 Arrow.com. Arrow.com.
Page 161: Digital Shift With 8 Bit Pixel Formats
Shifted Once conditions the reading for the brightest pixel is 10. If you changed the digital shift setting to shift by 1, the reading would increase to 20. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 162 8, bit 9, bit 10, or bit Shifted Four Times 11 to 1, we recommend not using shift by 4. If you do nonetheless, all bits output from the camera will Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 163: 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 Arrow.com.
Page 164: Enabling And Setting Digital Shift
// Enable digital shift by 2 Camera.DigitalShift.SetValue( 2 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 165: Integrated Ir Cut Filter (On Color Models)
IR-cut filter 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, see Section 1.4.2 on page Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 166: Area Of Interest (Aoi)
One of the main advantages of the AOI feature is that decreasing the height of the AOI can increase the camera’s maximum allowed acquisition frame rate. For more information about how changing the AOI height effects the maximum allowed frame rate, see Section 6.12 on page Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 167 But if binning is enabled, these parameters are set in terms of "virtual" columns and rows. For more information, see Section 10.6.1 on page 157. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 168: Changing Aoi Parameters "On-The-Fly
= Camera.Height.GetInc(); Camera.Height.SetValue( 200 ); Camera.OffsetY.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 169: Binning
With horizontal binning, adjacent pixels from 2 columns, 3 columns, or a maximum of 4 columns are summed and are reported out of the camera as a single pixel. Figure 54 illustrates horizontal bin- ning. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 170 // Disable vertical and horizontal binning Camera.BinningVertical.SetValue( 1 ); Camera.BinningHorizontal.SetValue( 1 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 171: Considerations When Using Binning
And when you set the Y Offset and the Height for the AOI, you will be setting these values in terms of virtual sensor lines. For more information about the area of interest (AOI) feature, see Section 10.5 on page 152. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 172: Reverse X
AOI relative to the sensor remains the same regardless of whether or not the reverse X feature is enabled. As a consequence, an AOI will display different images depending on whether or not the reverse X feature is enabled. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 173 AOI will display different images and an Auto Function AOI will refer to different image contents. The positions of the AOIs relative to the sensor will not change. For more information about auto functions, see Section 10.10 on page 165. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 174 API to set the parameter value: // Enable reverse X Camera.ReverseX.SetValue(true); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameter.
Page 175: Luminance Lookup Table
0 through 2048 and increases gradually as the digitized sensor output moves from 2049 through 4096. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 176 Camera Output 2048 1024 1024 2048 3072 4095 12 Bit Digitized Sensor Reading Fig. 58: Lookup Table with Values Mapped for Higher Camera Output at Low Sensor Readings Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 177 // Enable the lookup table Camera.LUTEnable.SetValue( true ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 178: Gamma Correction
// Set the Gamma value to 1.2 Camera.Gamma.SetValue( 1.2 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 179: Auto Functions
You can use an auto function when binning is enabled (monochrome cameras only). An auto function uses the binned pixel data and controls the image property of the binned image. For more information about binning, see Section 10.6 on page 155. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 180: Modes Of Operation
If an auto function is set to "once" operation mode and if the circumstances will not allow reaching a target value for an image property, the auto function will try to reach the target value for a maximum of 30 images and will then be set to "off". Basler ace Arrow.com. Arrow.com.
Page 181: Auto Function Aoi
Offset Auto Function Height Area of Interest Image Area of Interest X Offset Width Fig. 59: Auto Function Area of Interest and Image Area of Interest Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 182 You can use auto functions when also using the reverse X feature. For information about the behavior and roles of Auto Function AOI and Image AOI when also using the reverse X feature, see the "Reverse X" section. Basler ace Arrow.com. Arrow.com.
Page 183 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 Auto Function AOI Image AOI Fig. 60: Various Degrees of Overlap Between the Auto Function AOI and the Image AOI Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 184 API to select an Auto Function AOI and to get the maximum allowed settings for the Width and Height parameters. The code snippets also illustrate setting the X Offset, Y Offset, Width, and Height parameter values. As an example, Auto Function AOI1 is selected: Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 185: Using An Auto Function
Camera.AutoFunctionAOIOffsetY.SetValue( 0 ); Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() ); Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 186: Gain Auto
Setting the target average gray value. A medium gray value is chosen as an example Enabling the gain auto function and selecting, for example, the "once" mode of operation Basler ace Arrow.com. Arrow.com.
Page 187 // Set the mode of operation for the gain auto function Camera.GainAuto.SetValue( GainAuto_Once ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 188: Exposure Auto
5. Set the target average gray value. 6. If necessary, set the auto function profile. 7. Enable the exposure auto function by setting it to "once" or "continuous". You must choose the "continuous" setting when using the auto function profile. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 189 // Set the mode of operation for the exposure auto function Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 190: Auto Function Profile
Camera.AutoFunctionProfile.SetValue( AutoFunctionProfile_GainMinimum ); Camera.GainAuto.SetValue( GainAuto_Continuous ); Camera.ExposureAuto.SetValue( ExposureAuto_Continuous ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 191: Balance White Auto
// Set position and size of the auto function AOI Camera.AutoFunctionAOISelector.SetValue( AutoFunctionAOISelector_AOI2 ); Camera.AutoFunctionAOIOffsetX.SetValue( 0 ); Camera.AutoFunctionAOIOffsetY.SetValue( 0 ); Camera.AutoFunctionAOIWidth.SetValue( Camera.AutoFunctionAOIWidth.GetMax() ); Camera.AutoFunctionAOIHeight.SetValue( Camera.AutoFunctionAOIHeight.GetMax() ); // Set the mode of operation for balance white auto function Camera.BalanceWhiteAuto.SetValue( BalanceWhiteAuto_Once ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 192 Standard Features For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For general information about auto functions, see Section 10.10 on page 165.
Page 193: Disable 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 194 For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. Note that the disable parameter limits feature will only be available at the "guru" viewing level.
Page 195: Event Reporting
PC in an event message before the next event is placed in queue. If there is an occasional short term delay in event message transmission, the queue can buffer several events and can send them within a single event message as soon as transmission time is available. Basler ace Arrow.com. Arrow.com.
Page 196 API. The pylon software development kit includes a "Camera Events" code sample that illustrates the entire process. For more detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference.
Page 197: Test Images
// set for the first test image Camera.TestImageSelector.SetValue( TestImageSelector_Testimage1 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 198 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 Arrow.com. Arrow.com. Arrow.com.
Page 199 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 Arrow.com. Arrow.com.
Page 200 The image moves by one pixel from right to left whenever you signal the camera to capture a new image. To display this test pattern on a monitor, you must convert the YUV output from the camera to 8 bit RGB. Fig. 62: Test Image Six Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 201: Device Information Parameters
Device User ID (read / write) - is used to assign a user defined name to a device. This name will be displayed in the Basler pylon Viewer and the Basler pylon IP Configuration Tool. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
Page 202 For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily read the parameters and to read or write the Device User ID.
Page 203: Configuration Sets
"startup" set, i.e., the set that will be loaded into the active set whenever the camera is powered on or reset. Instructions for loading the default set into the active set and for designating which set will be the startup set appear later in the Configuration Sets section. Basler ace Arrow.com. Arrow.com.
Page 204 Instructions for designating the startup set appear later in the Configuration Sets section. For more information about auto functions, see Section 10.10 on page 165. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 205: Selecting A Factory Setup As The Default Set
The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 206: Saving A User Set
Camera.UserSetSelector.SetValue( UserSetSelector_UserSet1 ); Camera.UserSetSave.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 207: Loading The User Set Or The Default Set Into The Active Set
The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 208: Selecting The Startup Set
Set the User Set Default Selector to User Set 1 or Default. You can set the User Set Default Selector from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector: Camera.UserSetDefaultSelector.SetValue( UserSetDefaultSelector_Default ); Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 209: Chunk Features
“chunk” features. Before you can use any of the features that add chunks to the image, you must make the chunk mode active. Making the chunk mode active is described in the next section. Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 210: Making The "Chunk Mode" Active And Enabling The Extended Data Stamp
Also note that when you enable ChunkModeActive, the PayloadType for the camera changes from "Pylon::PayloadType_Image" to "Pylon::PayloadType_ChunkData". For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 211 = Camera.ChunkDynamicRangeMin.GetValue(); int64_t dynamicRangeMax = Camera.ChunkDynamicRangeMax.GetValue(); ChunkPixelFormatEnums pixelFormat = Camera.ChunkPixelFormat.GetValue(); For more information about using the chunk parser, see the sample code that is included with the Basler pylon Software Development Kit (SDK). Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 212: Frame Counter
// make chunk mode active and enable Frame Counter chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Framecounter ); Camera.ChunkEnable.SetValue( true ); // retrieve date from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 213 ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t frameCounter = Camera.ChunkFramecounter.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 214 Camera.CounterReset.Execute(); // disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace Arrow.com.
Page 215: Time Stamp
Camera.ChunkSelector.SetValue( ChunkSelector_Timestamp ); Camera.ChunkEnable.SetValue( true ); // retrieve data from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkTimestamp.GetValue(); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 216 Chunk Features For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on...
Page 217: Trigger Input Counter
// make chunk mode active and enable Trigger Input Counter chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Triggerinputcounter ); Camera.ChunkEnable.SetValue( true ); // retrieve data from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 218 ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t triggerinputCounter = Camera.ChunkTriggerinputcounter.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 219 Camera.CounterReset.Execute(); // disable reset Camera.CounterResetSource.SetValue( CounterResetSource_Off ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. Basler ace Arrow.com.
Page 220: Line Status All
API to activate the chunk mode, enable the line status all chunk, run the parser, and retrieve the line status all chunk data: // make chunk mode active and enable Line Status All chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_LineStatusAll ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 221 ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t lineStatusAll = Camera.ChunkLineStatusAll.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 222: Crc Checksum
API to activate the chunk mode, enable the time stamp chunk, run the parser, and retrieve the frame counter chunk data: // Make chunk mode active and enable CRC chunk Camera.ChunkModeActive.SetValue( true ); Basler ace Arrow.com. Arrow.com. Arrow.com.
Page 223 ( ChunkParser.HasCRC() && ! ChunkParser.CheckCRC() ) cerr << "Image corrupted!" << endl; For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 224 Chunk Features Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 225: Troubleshooting And Support
If you do decide to contact Basler technical support, please take a look at the form that appears on the last two pages of this section before you call. Filling out this form will help make sure that you have all of the information the Basler technical support team needs to help you with your problem.
Page 226: Before Contacting Basler Technical Support
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.
Page 227 Parameter set It is very important for Basler technical Support to get a copy of the exact camera parameters that you were using when the problem occurred. To make note of the parameters, use Basler’s pylon Viewer tool.
Page 228 Troubleshooting and Support Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 229: Basler Network Drivers And Parameters
Two network drivers are available for the network adapter used with your GigE cameras: The Basler filter driver is a basic GigE Vision network driver that is compatible with all network adapters. The advantage of this driver is its extensive compatibility.
Page 230: The Basler Filter Driver
Basler Network Drivers and Parameters The Basler Filter Driver The Basler filter driver is a basic driver GigE Vision network driver. It is designed to be compatible with most network adapter cards. The functionality of the filter driver is relatively simple. For each frame, the driver checks the order of the incoming packets.
Page 231: The Basler Performance Driver
The Basler performance driver uses a "receive window" to check the status of packets. The check for missing packets is made as packets enter the receive window. If a packet arrives from higher in the sequence of packets than expected, the preceding skipped packet or packets are detected as missing.
Page 232: General Parameters
Basler Network Drivers and Parameters A.3.1 General Parameters Enable Resend - Enables the packet resend mechanisms. If the Enable Resend parameter is set to false, the resend mechanisms are disabled. The performance driver will not check for missing packets and will not send resend requests to the camera.
Page 233 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 66. The parameter value is in per cent of the width of the receive window. In Figure 66 the resend request threshold is set at 33.33% of the width of the receive window.
Page 234: Timeout Resend Mechanism Parameters
Basler Network Drivers and Parameters A.3.3 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Figure 67 where the following assumptions are made: The frame includes 3000 packets. Packet 1002 is missing within the stream of packets and has not been recovered.
Page 235 Basler Network Drivers and Parameters Maximum Number Resend Requests - The Maximum Number Resend Requests parameter sets the maximum number of resend requests the performance driver will send to the camera for each missing packet. Resend Timeout - The Resend Timeout parameter defines how long (in milliseconds) the performance driver will wait after detecting that a packet is missing before sending a resend request to the camera.
Page 236: Threshold And Timeout Resend Mechanisms Combined
Basler Network Drivers and Parameters A.3.4 Threshold and Timeout Resend Mechanisms Combined Figure 68 illustrates the combined action of the threshold and the timeout resend mechanisms where the following assumptions are made: All parameters set to default. The frame includes 3000 packets.
Page 237 For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. (Note that the performance driver parameters will only appear in the viewer if the performance driver is installed on the adapter to which your camera is connected.)
Page 238: Adapter Properties
Basler Network Drivers and Parameters A.3.5 Adapter Properties When the Basler Performance driver is installed, it adds a set of "advanced" properties to the network adapter. These properties include: Max Packet Latency - A value in microseconds that defines how long the adapter will wait after it receives a packet before it generates a packet received interrupt.
Page 239: Transport Layer Parameters
Camera_t::TlParams_t TlParams( Camera.GetTLNodeMap() ); TlParams.HeartbeatTimeout.SetValue(5000); // 5 seconds For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
Page 240 Basler Network Drivers and Parameters Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 241: Network Related Camera Parameters And Managing Bandwidth
Basler ace Arrow.com. Arrow.com.
Page 242 Bandwidth Reserve (read/write) Used to reserve a portion of the assigned bandwidth for packet resends and for the transmission of control data between the camera and the host PC. The setting is expressed as a percentage of the Basler ace Arrow.com. Arrow.com.
Page 243 The example also assumes that the camera is operating in a poor environment, so many packets are lost and many resends are required. The numbered text is keyed to the time periods in the chart. Basler ace Arrow.com. Arrow.com.
Page 244 15 resends would be required from the accumulator pool, but the pool only has 9 resends. So the 9 resends in the pool are used and 6 resend requests are answered with a "packet unavailable" error code. The accumulator pool is reduced to 0. Basler ace Arrow.com. Arrow.com.
Page 245 If software or hardware triggering is being used to control the camera’s frame rate, the maximum frame rate allowed with the current camera settings will be used to calculate the device max throughput. Basler ace Arrow.com. Arrow.com.
Page 246 // GevStreamChannelSelector Camera.GevStreamChannelSelector.SetValue ( GevStreamChannelSelector_StreamChannel0 ); // PacketSize Camera.GevSCPSPacketSize.SetValue( 1500 ); // Inter-packet Delay Camera.GevSCPD.SetValue( 1000 ); // Frame-transmission Delay Camera.GevSCFTD.SetValue( 1000 ); // Bandwidth Reserve Camera.GevSCBWR.SetValue( 10 ); Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 247 = Camera.GevSCDMT.GetValue(); // Device Current Throughput int64_t currentThroughput = Camera.GevSCDCT.GetValue(); // Resulting Framerate double resultingFps = Camera.ResultingFrameRateAbs.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. Basler ace Arrow.com. Arrow.com.
Page 248: Managing Bandwidth When Multiple Cameras Share A Single Network Path
You can lower the data output rate on a camera by using the Inter-packet Delay parameter. This parameter adds a delay between the transmission of each packet from the camera and thus slows Basler ace Arrow.com. Arrow.com.
Page 249 After you have adjusted the Inter-packet Delay parameter on each camera, you can check the sum of the Bandwidth Assigned parameter values and see if the sum is now less than 125 MByte/s. Basler ace Arrow.com. Arrow.com.
Page 250: A Procedure For Managing Bandwidth
If you use the Basler filter driver and have already set network parameters for your network adapter during the installation of the Basler pylon software, continue with step two. Otherwise, open the...
Page 251 Unless you have already set the packet size for your network adapter during the installation of the Basler pylon software, check the documentation for your adapter to determine the maximum packet size (sometimes called “frame” size) that the adapter can handle. Many adapters can handle what is known as “jumbo packets”...
Page 252 To determine the “data bandwidth assigned,” you must subtract out the reserve. Basler ace Arrow.com. Arrow.com.
Page 253 If the sum of the Bandwidth Assigned values is greater than 125 MByte/s for a GigE network or 12.5 M/Byte/s for a 100 Bit/s network, the cameras need more bandwidth than is available and you must Basler ace Arrow.com. Arrow.com.
Page 254 AOI settings on the cameras, you should repeat steps 2 through 6. For more information about the camera’s maximum allowed frame transmission rate, see Section 6.12 on page For more information about the AOI, see Section 10.5 on page 152. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 255: Revision History
Updated Section 5.7.2.2 on page 40 to describe the current behavior of the output line. Updated the enitre contents of Section 6 on page 45 to more completely describe the acquisition control options. Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 256 Revision History Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 257: Feedback
Feedback Feedback Your feedback will help us improve our documentation. Please click the link below to access an online feedback form. Your input is greatly appreciated. http://www.baslerweb.com/umfrage/survey.html Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 258 Feedback Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 259: Index
AOI settings........157 connector types ........28 image distortion........157 connectors ..........25 reduced resolution......157 CPU interrupts ........236 response to light.......157 CRC checksum chunk ......208 setting..........156 bit depth..........2 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 260 ......189 exposure time horizontal binning ........155 controlling with an external trigger horizontal mirror image......158 signal..........64 humidity ........... 13 maximum possible ......70 minimum allowed .......70 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 261 194 max number resend request payload size parameter ......227 parameter ..........221 performance driver......... 215 max width parameter......187 pin assignments........26 mirror image ...........158 pixel data formats ........107 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 262 ....22 size..........1 type ..........2 use case diagrams ........78 sensor height parameter ......187 user configuration set ......190 sensor width parameter ......187 user output selector ....... 131 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 263 YUV 422 (YUYV) packed pixel format ..........114 YUV 422 data range.......123 YUV 422 packed pixel format..114 Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.
Page 264 Index Basler ace Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com. Arrow.com.

This manual is also suitable for:

Gige vision ace aca750-30gm/gc Gige visionace aca1300-30gm/gc Gige vision ace aca1600-20gm/gc series Gige vision ace aca2500-14gm/gcseries

Basler GIGE VISION ace acA640-100gm/gc Manual

Quick Links

Need help?

Questions and answers

Related Manuals for Basler GIGE VISION ace acA640-100gm/gc

Summary of Contents for Basler GIGE VISION ace acA640-100gm/gc

This manual is also suitable for:

Table of Contents