Basler SCOUT LIGHT User Manual

Basler SCOUT LIGHT User Manual

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

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for Basler SCOUT LIGHT

  • Page 1 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...
  • Page 2 Basler customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Basler for any damages resulting from such improper use or sale. Warranty Note Do not open the housing of the camera.
  • Page 3 Contacting Basler Support Worldwide Europe: Basler AG An der Strusbek 60 - 62 22926 Ahrensburg Germany Tel.: +49-4102-463-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 5: Table Of Contents

    The pylon API ............26 4 Basler Network Drivers and Parameters ......27 The Basler Filter Driver.
  • Page 6 (Standard Mode) ..........94 Basler scout light GigE...
  • Page 7 9.9.1 Guidelines for Overlapped Operation....... 134 Basler scout light GigE...
  • Page 8 11.11 Acquisition Status ........... . 195 Basler scout light GigE...
  • Page 9 12.2 Obtaining an RMA Number..........209 12.3 Before Contacting Basler Technical Support ....... 210 Revision History .
  • Page 10 Table of Contents AW00104701000 Basler scout light GigE...
  • Page 11: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. Models The current Basler scout light 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...
  • Page 12: General Specifications

    +12 to +24 VDC, (min. +11.3 VDC, absolute max. +30.0 VDC), < 1% ripple Requirements 3.0 W @ 12 V 3.0 W @ 12 V 3.5 W @ 12 V I/O Ports 1 opto-isolated input port and 1 opto-isolated output port Lens Adapter C-mount Basler scout light GigE...
  • Page 13 73.7 mm x 44 mm x 29 mm (without lens adapter or connectors) 85.5 mm x 44 mm x 29 mm (with lens adapter and connectors) Weight 160 g (typical) Conformity CE, FCC, GenICam, GigE Vision, IP30 Table 1: General Specifications Basler scout light GigE...
  • Page 14 Camera Power +12 to +24 VDC, (min. +11.3 VDC, absolute max. +30.0 VDC), < 1% ripple Requirements 3.5 W @ 12 V I/O Ports 1 opto-isolated input port and 1 opto-isolated output port Lens Adapter C-mount Basler scout light GigE...
  • Page 15 73.7 mm x 44 mm x 29 mm (without lens adapter or connectors) 85.5 mm x 44 mm x 29 mm (with lens adapter and connectors) Weight 170 g (typical) Conformity CE, FCC, GenICam, GigE Vision, IP30 Table 2: General Specifications Basler scout light GigE...
  • Page 16: Spectral Response For Mono Cameras

    Spectral Response for Mono Cameras The following graphs show the spectral response for each available monochrome camera model. The spectral response curves excludes lens characteristics and light source characteristics. Wave Length (nm) Fig. 1: slA640-74gm Spectral Response Basler scout light GigE...
  • Page 17 AW00104701000 Specifications, Requirements, and Precautions Wave Length (nm) Fig. 2: slA780-54gm Spectral Response Wave Length (nm) Fig. 3: slA1390-17gm Spectral Response Basler scout light GigE...
  • Page 18 Specifications, Requirements, and Precautions AW00104701000 Wave Length (nm) Fig. 4: slA1400-17gm Spectral Response Basler scout light GigE...
  • Page 19: Spectral Response For Color Cameras

    700 ... 720 nm, and it should cut off from 700 ... 720 nm to 1100 nm. A suitable IR cut filter is included in the C-mount lens adapter on color models of the camera. Blue Green Wave Length (nm) Fig. 5: slA640-74gc Spectral Response Basler scout light GigE...
  • Page 20 Specifications, Requirements, and Precautions AW00104701000 Blue Green Wave Length (nm) Fig. 6: slA780-54gc Spectral Response Blue Green Wave Length (nm) Fig. 7: slA1390-17gc Spectral Response Basler scout light GigE...
  • Page 21 AW00104701000 Specifications, Requirements, and Precautions Blue Green Wave Length (nm) Fig. 8: slA1400-17gc Spectral Response Basler scout light GigE...
  • Page 22: Mechanical Specifications

    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. Basler scout light GigE...
  • Page 23 2x M3; 4 deep 80.15 2x M2; 4.5 deep 6.45 72.3 13.5 73.7 85.5 17.5 2x M3; 3.5 deep Photosensitive surface of the sensor 2x M3; 4.5 deep 67.2 Fig. 9: Mechanical Dimensions (in mm) for the Cameras Basler scout light GigE...
  • Page 24: Maximum Thread Length On Color Cameras

    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. Not to Scale < 8.0 mm C-mount Lens IR Cut Filter Lens Adapter Fig. 10: Maximum Lens Thread Length on Color Cameras Basler scout light GigE...
  • Page 25: Mechanical Stress Test Results

    The mechanical stress tests were performed with a dummy lens connected. The dummy lens was 35 mm long and had a mass of 66 g. Using a heavier or longer lens requires an additional support for the lens. Basler scout light GigE...
  • Page 26: 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 scout light GigE...
  • Page 27: 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 28: Environmental Requirements

    Allow sufficient air circulation around the camera to prevent internal heat build-up in your system and to keep the camera’s housing temperature below 50 °C. Additional cooling devices such as fans or heat sinks are not normally required, but should be provided if necessary. Basler scout light GigE...
  • Page 29: Precautions

    The plug on the cable that you attach to the camera’s 12-pin connector must have 12 pins. Use of a smaller plug, such as one with 10 pins or 8 pins, can damage the pins in the camera’s 12-pin connector. Basler scout light GigE...
  • Page 30 When writing code, you should use a programming language that is both compatible with pylon and appropriate for your application. For more information about the programming languages that can be used with Basler pylon, see the documentation included with the pylon package.
  • Page 31 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 scout light GigE...
  • Page 32 Specifications, Requirements, and Precautions AW00104701000 Basler scout light GigE...
  • Page 33: 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...
  • Page 34 Installation AW00104701000 Basler scout light GigE...
  • Page 35: 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 36: The Pylon Api

    API. The programmer’s guide and API reference are included in the pylon SDK. The Basler pylon Software Development Kit (SDK) includes a set of sample programs that illustrate how to use the pylon API to parameterize and operate the camera. These samples include ®...
  • Page 37: 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 38: The Basler Filter Driver

    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.
  • Page 39: 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 40 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.
  • Page 41 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.
  • Page 42 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.
  • Page 43 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.
  • Page 44 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.
  • Page 45 (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. The following code snippet illustrates using the API to read and write the parameter values: // Get the Stream Parameters object Camera_t::StreamGrabber_t StreamGrabber( Camera.GetStreamGrabber(0) );...
  • Page 46 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.
  • Page 47: Transport Layer Parameters

    You can set the driver related transport layer parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to read and write the parameter values: // Read/Write Timeout Camera_t::TlParams_t TlParams( Camera.GetTLNodeMap() );...
  • Page 48 Basler Network Drivers and Parameters AW00104701000 Basler scout light GigE...
  • Page 49: Network Related Camera Parameters And Managing Bandwidth

    The value is in bytes. The value does not affect the leader and trailer size, which use a total of 36 bytes, and the last data packet may be a smaller size. The payload size will be packet size minus 36 bytes. Basler scout light GigE...
  • Page 50 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 Bandwidth Assigned parameter. For example, if the Bandwidth Assigned parameter indicates that Basler scout light GigE...
  • Page 51 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 scout light GigE...
  • Page 52 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 scout light GigE...
  • Page 53 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 scout light GigE...
  • Page 54 You can read or set the camera’s network related parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter values: // Payload Size int64_t payloadSize = Camera.PayloadSize.GetValue();...
  • Page 55 = 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 scout light GigE...
  • Page 56: Managing Bandwidth When Multiple Cameras Share A Single Network Path

    If the sum of the bandwidth assigned values is less than 125 MByte/s, the cameras should be able to operate simultaneously without problems. If it is greater, you must lower the data output rate of one or more of the cameras. Basler scout light GigE...
  • Page 57: 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 58 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 59 To determine the “data bandwidth assigned,” you must subtract out the reserve. Basler scout light GigE...
  • Page 60 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 make adjustments. In essence, you must lower the data bandwidth needed by one or more of the Basler scout light GigE...
  • Page 61 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 9.12 on page 144. For more information about the AOI, see Section 11.6 on page 185. Basler scout light GigE...
  • Page 62 Network Related Camera Parameters and Managing Bandwidth AW00104701000 Basler scout light GigE...
  • Page 63: 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 64 Image Buffer e.g. ExpActive, TrigRdy Image Image Data Data Ethernet Ethernet Sensor FPGA Network Controller Image Image Data Data Control Data Control Micro- Controller Control Control: Data AOI, Gain, Black Level Fig. 16: Camera Block Diagram Basler scout light GigE...
  • Page 65: Physical Interface

    A 12-pin receptacle used to provide access to the camera’s I/O lines and to provide power to the camera. The drawing below shows the location of the two connectors and the LEDs. 12-pin Receptacle 8-pin RJ-45 Jack Green LED Yellow LED Fig. 17: Camera Connectors and LED Basler scout light GigE...
  • Page 66: Connector Pin Assignments And Numbering

    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 non- functional pins. Basler scout light GigE...
  • Page 67: Jack Pin Assignments

    Pin numbering for the 12-pin receptacle is as shown in Section 7.2.3 on page 7.2.2 RJ-45 Jack Pin Assignments The 8-pin RJ-45 jack provides Ethernet access to the camera. Pin assignments adhere to the Ethernet standard. 7.2.3 Pin Numbering Fig. 18: Pin Numbering for the 12-pin Receptacle Basler scout light GigE...
  • Page 68: 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 69: Cabling Requirements

    Close proximity to strong magnetic fields should be avoided. The required 12-pin Hirose plug is available from Basler. Basler also offers a cable assembly that is terminated with a 12-pin Hirose plug on one end and unterminated on the other. Contact your Basler sales representative to order connectors or cables.
  • Page 70 Non-functional Power I/O In Gnd Supply I/O Out 1 AC In Non-functional In Pwr VCC In Pwr VCC I/O Out VCC Non-functional Non-functional Shield Standard Power and I/O Cable Fig. 19: Standard Power and I/O Cable Basler scout light GigE...
  • Page 71: Plc Power And I/O Cable

    PLC device, if power for the I/O input is supplied with 24 VDC. Basler offers PLC power and I/O cables with 3 m and 10 m lengths. Each cable is terminated with a 12-pin Hirose plug (HR10A-10P-12S) on the end that connects to the camera. The other end is unterminated.
  • Page 72: Camera Power

    Recommended operating voltage; < 1 % ripple required. Make sure to use a power supply that supplies power in this voltage range. +30.0 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 5: Voltage Requirements for the Camera Power VCC Basler scout light GigE...
  • Page 73: Ethernet Gige Device Information

    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 Ethernet GigE Device Information The camera uses a standard Ethernet GigE transceiver. The transceiver is fully 100/1000 Base-T 802.3 compliant. Basler scout light GigE...
  • Page 74: 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 6: Voltage Requirements for the I/O Input When Using the Standard Power and I/O Cable Basler scout light GigE...
  • Page 75 The voltage indicates a logical 1. +30.0 VDC Absolute maximum; the camera may be damaged when the absolute maximum is exceeded. Table 7: Voltage Requirements for the I/O Input When Using a PLC Power and I/O Cable Basler scout light GigE...
  • Page 76: Line Schematic

    For more information about how to use an ExTrig signal to control image acquisition, see Section 9.4.5 on page 96, Section 9.5.3 on page 104 and Section 9.6.3 on page 115. For more information about configuring the input line, see Section 8.1 on page Basler scout light GigE...
  • Page 77: Output Line

    By default, the camera’s exposure active (ExpAc) signal is assigned to Output Line 1. The exposure active signal indicates when exposure is taking place. The assignment of camera output signals to the physical output line can be changed by the user. Basler scout light GigE...
  • Page 78 For more information about the output line pin assignment and pin numbering, see Section 7.2 on page 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 Basler scout light GigE...
  • Page 79: Output Line Response Time

    As an example, t and t were measured for a specific camera, for load currents of 5 mA and on90 off10 50 mA, and voltages between 3.3 V and 24 V. The results are shown on the figure below. Basler scout light GigE...
  • Page 80 The effects due to different voltages and load currents are more pronounced on t than on off1 on90 Basler scout light GigE...
  • Page 81: O Control

    By default, physical input line 1 is assigned to receive an ExTrig signal to serve as the frame start trigger. Legacy mode: By default, physical input line 1 is assigned to receive the ExTrig signal to serve as the acquisition start trigger. Basler scout light GigE...
  • Page 82: Using An Unassigned Input Line To Receive A User Input Signal

    When the input line is assigned to receive an ExTrig input signal the input line can’t be used to receive a user-designed input signal. For more information about using the Line Status and Line Status All parameters, see Section 8.3.1 page 81 and Section 8.3.2 on page Basler scout light GigE...
  • Page 83: 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 84: Setting The State Of The 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 85: 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.For more information about the pylon Viewer, see Section 3.1 on...
  • Page 86: Working With The Timer

    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 87: Setting A Timer Delay Time

    Camera.TimerSelector.SetValue( TimerSelector_Timer1 ); Camera.TimerDelayRaw.SetValue( 100 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 88: Setting A Timer Duration Time

    Duration Time = (Timer Duration Raw Parameter Value) x (Timer Duration Time Base) By default, the Timer Duration Time Base is fixed at 1 µs. Typically, the duration time is adjusted by setting only the Timer Duration Raw parameter value. Basler scout light GigE...
  • Page 89 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 90 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 scout light GigE...
  • Page 91: 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 92 I/O Control AW00104701000 Basler scout light GigE...
  • Page 93: Image Acquisition Control

    Legacy and Standard Two different image acquisition control modes are available: the legacy mode and the standard mode. Previous Basler scout cameras with firmware version 3.2 and below only operate according to the legacy mode. The legacy mode differs from the standard mode in only two respects: the acquisition start trigger of the standard mode is not available in the legacy mode.
  • Page 94 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 image acquisition control mode. For more information about the pylon Viewer, see Section 3.1 on...
  • Page 95: Means For Controlling Image Acquisition In Standard Mode

    Section 9.8 on page 123. These diagrams present the material related to the acquisition start and stop commands, the acquisition mode, the acquisition start trigger, and the frame start trigger in a graphical format. Basler scout light GigE...
  • Page 96 "waiting for acquisition start trigger" acquisition status and enter a "waiting for frame start trigger" acquisition status. Applying a frame start trigger signal to the camera at this point will exit the camera from the "waiting for frame start trigger" acquisition status and will begin the Basler scout light GigE...
  • Page 97 "waiting for frame start trigger" status Acquisition Frame Count parameter setting = 3 Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 26: Acquisition Start and Frame Start Triggering Basler scout light GigE...
  • Page 98 But in Basler pylon there is a single parameter, the Trigger Mode parameter, that is used to set the mode for both of these triggers. Also, the Trigger Software command mentioned earlier can be executed for either the acquisition start trigger or the frame start trigger.
  • Page 99: Acquisition Start And Stop Commands And The Acquisition Mode (Legacy And Standard Mode)

    You can set the Acquisition Mode parameter value and you can execute Acquisition Start or Acquisition Stop commands from within your application software by using the Basler pylon API. The code snippet below illustrates using the API to set the Acquisition Mode parameter value and to execute an Acquisition Start command.
  • Page 100 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 When the camera's acquisition mode is set to single frame, the maximum possible acquisition frame rate for a given AOI cannot be achieved.
  • Page 101: The Acquisition Start Trigger In Standard Mode

    "waiting for acquisition start trigger" status. Note that this feature only applies when the Trigger Mode parameter for the acquisition start trigger is set to on. This feature is explained in greater detail in the following sections. Basler scout light GigE...
  • Page 102: Acquisition Start Trigger Mode (Standard Mode)

    Rising Edge - specifies that a rising edge of the electrical signal will act as the acquisition start trigger. Falling Edge - specifies that a falling edge of the electrical signal will act as the acquisition start trigger. Basler scout light GigE...
  • Page 103: Acquisition Frame Count (Standard Mode)

    "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. For more information about the pylon Viewer, see Section 3.1 on page Basler scout light GigE...
  • Page 104: Setting The Acquisition Start Trigger Mode And Related Parameters (Standard Mode)

    Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); // Set the acquisition frame count Camera.AcquisitionFrameCount.SetValue( 5 ); 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 Basler scout light GigE...
  • Page 105: Using A Software Acquisition Start Trigger (Standard Mode)

    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. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software acquisition...
  • Page 106: Using A Hardware Acquisition Start Trigger (Standard Mode)

    // Note: as long as the Trigger Selector is set to Acquisition Start, executing // a Trigger Software command will apply a software acquisition start trigger // signal to the camera You can also use the Basler pylon Viewer application to easily set the parameters. 9.4.5 Using a Hardware Acquisition Start Trigger (Standard Mode) 9.4.5.1...
  • Page 107: 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 parameter values required to enable rising edge hardware acquisition start triggering with...
  • Page 108: The Frame Start Trigger In Standard Mode

    For more information about the acquisition start trigger, and about the acquisition status, see Section 9.2 on page 85 and Section 9.4 on page Referring to the use case diagrams that appear in Section 9.8 on page 123 can help you understand the explanations of the frame start trigger. Basler scout light GigE...
  • Page 109: Frame Start Trigger Mode (Standard Mode)

    Keep in mind that the camera will only react to frame start triggers when it is in a "waiting for frame start trigger" acquisition status. For more information about the acquisition status, see Section 9.2 on page 85 and Section 9.4 on page Basler scout light GigE...
  • Page 110: Frame Start Trigger Mode = On

    Keep in mind that the camera will only react to frame start triggers when it is in a "waiting for frame start trigger" acquisition status. For more information about the acquisition status, see Section 9.2 on page 85 and Section 9.4 on page Basler scout light GigE...
  • Page 111: Setting The Frame Start Trigger Mode And Related Parameters

    You can set the Trigger Mode and related parameter values for the frame start trigger from within your application software by using the Basler pylon API. If your settings make it necessary, you can also set the Trigger Source parameter.
  • Page 112: Using A Software Frame Start Trigger (Standard Mode)

    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 9.5.2 Using a Software Frame Start Trigger (Standard Mode) 9.5.2.1...
  • Page 113: Setting The Parameters Related To Software Frame Start Triggering And Applying A Software Trigger Signal

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

    // 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 9.5.3...
  • Page 115: Exposure Modes

    Fig. 28: Timed Exposure with Rising Edge Triggering Note that if you attempt to trigger a new exposure start while the previous exposure is still in progress, the trigger signal will be ignored. Basler scout light GigE...
  • Page 116 3000 µs. For more information about the Trigger Ready signal, see Section 9.10.3 on page 136. For more information about the camera’s exposure time parameters, see Section 9.7 on page 121. Basler scout light GigE...
  • Page 117: Frame Start Trigger Delay

    You can set all of the parameters needed to perform hardware frame start triggering from within your application by using the Basler pylon API. The following code snippet illustrates using the API to set the camera for single frame acquisition mode with the trigger mode for the acquisition start trigger set to off.
  • Page 118 // frame start trigger signal (ExFSTrig signal)goes high // Retrieve the captured frames Camera.AcquisitionStop.Execute( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page...
  • Page 119: The Acquisition Start Trigger In Legacy Mode

    Accordingly, the acquisition start trigger shown in the diagrams is not available in legacy mode and the frame start trigger shown is equivalent to the acquisition start trigger in legacy mode. Basler scout light GigE...
  • Page 120: Acquisition Start Trigger Mode (Legacy Mode)

    When the Trigger Mode parameter for the acquisition start trigger is set to off, the exposure time for each frame acquisition is determined by the camera’s exposure time parameters. For more information about the camera’s exposure time parameters, see Section 9.7 on page 121. Basler scout light GigE...
  • Page 121: Acquisition Start Trigger Mode = On

    For more information about controlling exposure time when using a software trigger, see Section 9.4.4 on page For more information about controlling exposure time when using a hardware trigger, see Section 9.4.5 on page For more information about exposure time parameters, see Section 9.7 on page 121. Basler scout light GigE...
  • Page 122: 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.
  • Page 123: Using A Software Acquisition Start Trigger (Legacy Mode)

    Section 9.5.2.2 on page 103 includes more detailed information about applying a software acquisition start trigger to the camera using Basler pylon. For more information about determining the maximum allowed frame rate, see Section 9.12 on page 144.
  • Page 124: 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. The following code snippet illustrates using the API to set the parameter values and to execute the commands related to software acquisition...
  • Page 125: Using A Hardware Acquisition Start Trigger (Legacy Mode)

    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.6.3.4 on page 119. Basler scout light GigE...
  • Page 126: Exposure Modes

    This situation is illustrated below for rising edge triggering. This rise in the trigger signal will be ignored. ExASTrig Signal Exposure (duration determined by the exposure time parameters) Fig. 33: Overtriggering with Timed Exposure Basler scout light GigE...
  • Page 127 On the second cycle of the ExASTrig signal shown in the figure, the signal rises during previous frame readout, but falls after the readout is complete. This is a normal situation and exposure would be determined by the high time of the ExASTrig signal as you would expect. Basler scout light GigE...
  • Page 128: Acquisition Start Trigger Delay

    // set for the width exposure mode, set minimum exposure time to 3000 µs Camera.ExposureMode.SetValue( ExposureMode_TriggerWidth ); Camera.ExposureTimeAbs.SetValue( 3000 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 129: 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.
  • Page 130 // acquisition start trigger signal (ExASTrig signal)goes high // Retrieve the captured frames 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 131: Exposure Time Parameters

    Settings for Obtaining the Maximum Possible Exposure Time On all camera models, you can obtain the maximum possible exposure time (10000000 µs) by setting the Exposure Time Raw parameter value to 1 and the Exposure Time Base Abs value to 10000000 µs. Basler scout light GigE...
  • Page 132: Setting The Exposure Time Using "Absolute" Settings

    Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeRaw.SetValue( 100 ); Camera.ExposureTimeBaseAbs.SetValue( 186 ); 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 133: Use Case Diagrams

    Camera.ExposureTimeAbs.SetValue( 124 ); double resultingExpTime = Camera.ExposureTimeAbs.GetValue( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 134 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. Basler scout light GigE...
  • Page 135 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 9.5.1.1 on page 99 and for information about setting the parameter, see Section 9.5.1.3 on page 101. Basler scout light GigE...
  • Page 136 = frame exposure and readout = frame transmission Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal Time Fig. 36: Use Case 1 - Acquisition Start Trigger Off and Frame Start Trigger Off Basler scout light GigE...
  • Page 137 When the electrical signal is received on line 1, it serves as a frame start trigger signal and initiates a frame acquisition. The frame acquired by the camera is forwarded to an image processing system, which will inspect the image and determine if there are any defects in the plywood’s surface. Basler scout light GigE...
  • Page 138 Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal Frame Start Trigger Signal (applied to line 1) Time Fig. 37: Use Case 2 - Acquisition Start Trigger Off and Frame Start Trigger On Basler scout light GigE...
  • Page 139 (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 9.5.1.1 on page 99 and for information about setting the parameter, see Section 9.5.1.3 on page 101. Basler scout light GigE...
  • Page 140 Acquisition Acquisition Start Stop Command Command Executed Executed Acquisition Start Trigger Signal (applied to line 1) Frame Start Trigger Signal Time Fig. 38: Use Case 3 - Acquisition Start Trigger On and Frame Start Trigger Off Basler scout light GigE...
  • Page 141 (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 scout light GigE...
  • Page 142 Start Stop Command Command Executed Executed Acquisition Start Trigger Software Command Executed Frame Start Trigger Signal (applied to line 1) Time Fig. 39: Use Case 4 - Acquisition Start Trigger On and Frame Start Trigger On Basler scout light GigE...
  • Page 143: Overlapping Exposure And Sensor Readout

    Image Acquisition N Exposure Readout Image Acquisition N+1 Exposure Readout Image Acquisition N+2 Exposure Readout Image Acquisition N+3 Exposure Readout Time Fig. 41: Overlapped Exposure Basler scout light GigE...
  • Page 144: Guidelines For Overlapped Operation

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

    Set the value of the Line Source Parameter to the exposure active output signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 146: Acquisition Status Indicator

    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 For more information about the electrical characteristics of the camera’s output line, see Section 7.7.2 on...
  • Page 147 The trigger ready signal can be selected to act as the source signal for 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 trigger ready output signal. Basler scout light GigE...
  • Page 148 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 );...
  • Page 149: Acquisition Trigger Wait Signal (Standard Mode Only)

    Figure 44 illustrates the Acquisition Trigger Wait signal with the Acquisition Frame Count parameter set to 3 and with exposure and readout overlapped. The figure assumes that the trigger mode for the frame start trigger is set to off, so the camera is internally generating frame start trigger signals. Basler scout light GigE...
  • Page 150 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. Basler scout light GigE...
  • Page 151 Set the value of the Line Source Parameter to the acquisition trigger wait signal. You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 152: Acquisition Timing Chart

    Also assume that you have selected input line 1 to accept the hardware trigger signal and that you have set the Line Debouncer Time Abs parameter for input line 1 to 5 µs. In this case: Basler scout light GigE...
  • Page 153 Due to the nature of the Ethernet network, the transmission start delay can vary from frame to frame. The transmission start delay, however, is of very low significance when compared to the transmission time. For more information about the Payload Size and Device Current Throughput parameters, see Section 5.1 on page Basler scout light GigE...
  • Page 154: Maximum Allowed Acquisition Frame Rate

    If you are using normal exposure times and you are using the camera at it’s maximum resolution, your exposure time will not normally be the most restrictive factor on the frame rate. However, if you are using long exposure times or small areas of interest, it is quite possible to Basler scout light GigE...
  • Page 155 (AOI Height + 1) C Where: AOI Height = the height of the acquired frames as determined by the AOI Height settings. The constants C and C depend on the camera model as shown in the table below: Basler scout light GigE...
  • Page 156 For more information about setting the exposure time, see Section 9.7 on page 121. Formula 3: Calculates the maximum frame rate based on the frame transmission time: Device Current Throughput Parameter Value Max. Frames/s ------------------------------------------------------------------------------------------------------------------------ Payload Size Parameter Value Basler scout light GigE...
  • Page 157 Max Frames/s = 458.3 frames/s Formula one returns the lowest value. So in this case, the limiting factor is the sensor readout time, and the maximum allowed acquisition frame rate would be 95.0 frames per second. Basler scout light GigE...
  • Page 158 Image Acquisition Control AW00104701000 Basler scout light GigE...
  • Page 159: Pixel Data Formats

    Table 12: Pixel Formats Available on Color Cameras ( = format available) Details of the monochrome formats are described in Section 10.2 on page 151 and details of the color formats are described in Section 10.3 on page 157. Basler scout light GigE...
  • Page 160 Camera.PixelFormat.SetValue( PixelFormat_YUV422_YUYV_Packed ); Camera.PixelFormat.SetValue( PixelFormat_BayerBG8 ); Camera.PixelFormat.SetValue( PixelFormat_BayerBG16 ); 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 161: Pixel Data Formats For Mono Cameras

    This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler scout light GigE...
  • Page 162: Mono 16 Format (Equivalent To Dcam Mono 16)

    Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Low byte of brightness value for P High byte of brightness value for P Basler scout light GigE...
  • Page 163 4094 • • • • • • 0x0001 0x0000 When a camera that is set for Mono 16 has only 12 bits effective, the leader of transmitted frames will indicate Mono 12 as the pixel format. Basler scout light GigE...
  • Page 164: Mono 12 Packed Format

    • • • • bits 11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 bits 11 ... 4 bits 3 ... 0 bits 3 ... 0 bits 11 ... 4 Basler scout light GigE...
  • Page 165 “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler scout light GigE...
  • Page 166: Yuv 4:2:2 Packed Format (Equivalent To Dcam Yuv 4:2:2)

    The order of the pixel data for a received frame in the image buffer in your PC is similar to the order of YUV 4:2:2 (YUYV) Packed output from a color camera. For more information about the YUV 4:2:2 (YUYV) Packed format on color cameras, see Section 10.3.6 on page 168. Basler scout light GigE...
  • Page 167: Pixel Data Output Formats For Color Cameras

    (the figure shows the "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. 46: Bayer Filter Pattern Basler scout light GigE...
  • Page 168: Color Filter Alignment

    You can tell how the current AOI is aligned to the Bayer filter by reading the value of the Pixel Color Filter parameter. For more information about the camera’s AOI feature, see Section 11.6 on page 185. Basler scout light GigE...
  • Page 169: Bayer Bg 8 Format (Equivalent To Dcam Raw 8)

    Red value for P Blue value for P Green value for P Green value for P Red value for P Blue value for P Green value for P Green value for P Red value for P Basler scout light GigE...
  • Page 170 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 scout light GigE...
  • Page 171: Bayer Bg 16 Format (Equivalent To Dcam Raw 16)

    • • • • • • • • 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 scout light GigE...
  • Page 172 • • • • • 0x0001 0x0000 When a camera that is set for Bayer BG 16 has only 12 bits effective, the leader of transmitted frames will indicate Bayer BG 12 as the pixel format. Basler scout light GigE...
  • Page 173: Bayer Bg 12 Packed Format

    11 ... 4 Blue value for P bits 11 ... 4 Green value for P bits 3 ... 0 Blue value for P bits 3 ... 0 Green value for P bits 11 ... 4 Basler scout light GigE...
  • Page 174 “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094 • • • • • • 0x0001 0x0000 Basler scout light GigE...
  • Page 175: Yuv 4:2:2 Packed Format (Equivalent To Dcam Yuv 4:2:2)

    = the last pixel transmitted by the camera = the first byte in the buffer = the last byte in the buffer Byte Data U value for P Y value for P V Value for P Y value for P Basler scout light GigE...
  • Page 176 The pixel data output for the U component or the V component is 8 bit data of the “straight binary” type. The range of data values for a U or a V component and the corresponding indicated signal levels are shown below. Basler scout light GigE...
  • Page 177 -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. Basler scout light GigE...
  • Page 178: 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 scout light GigE...
  • Page 179 -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. Basler scout light GigE...
  • Page 180: Mono 8 Format (Equivalent To Dcam Mono 8)

    Y value for P Y value for P 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 scout light GigE...
  • Page 181 This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE • • • • • • 0x01 0x00 Basler scout light GigE...
  • Page 182: Pixel Transmission Sequence

    The columns are numbered 0 through m from the left side to the right side of the sensor The rows are numbered 0 through n from the top to the bottom of the sensor The sequence assumes that the camera is set for full resolution. Basler scout light GigE...
  • Page 183: Standard Features

    Fig. 47: 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 scout light GigE...
  • Page 184: Setting The Gain

    Camera.GainSelector.SetValue( GainSelector_All ); Camera.GainRaw.SetValue( 400 ); 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 185 Gain at Max Setting dB Gain at Max Setting Min Setting (8 bit depth) (16 bit depth) slA640-74 28.3 10.1 slA780-54 25.9 slA1390-17 25.5 slA1400-17 31.0 12.8 Table 14: Minimum and Maximum dB of Gain Basler scout light GigE...
  • Page 186: 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 187: White Balance (On Color Models)

    You can set the Balance Ratio Selector and the Balance Ratio Abs 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.BalanceRatioSelector.SetValue( BalanceRatioSelector_Green );...
  • Page 188: 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 scout light GigE...
  • Page 189 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 scout light GigE...
  • Page 190: Digital Shift With 8 Bit Pixel Formats

    If the pixel values being output by the camera’s sensor are high enough to set bit 11 to 1, we recommend not using shift by 1. If you do nonetheless, all bits output from the camera will Basler scout light GigE...
  • Page 191 1. Therefore, you should only use the multiply by 4 setting when your pixel readings with an 8 bit pixel format selected and with digital shift disabled are all less than 16. Basler scout light GigE...
  • Page 192: 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 scout light GigE...
  • Page 193: Enabling And Setting Digital Shift

    3, or 4, digital shift will be set to shift by 1, shift by 2, shift by 3, or shift by 4 respectively. You can set the Digital Shift parameter values from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Disable digital shift Camera.DigitalShift.SetValue( 0 );...
  • Page 194: Integrated Ir Cut Filter (On Color Models)

    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. For more information about the location of the IR cut filter, see Section 1.5.2 on page Basler scout light GigE...
  • Page 195: 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 9.12 on page 144. Basler scout light GigE...
  • Page 196 The X Offset, Y Offset, Width, and Height parameters can be set in increments of 2 and they must be set to an even number. For example, the X Offset parameter can be set to 0, 2, 4, 6, 8, etc. Basler scout light GigE...
  • Page 197: Changing Aoi Parameters "On-The-Fly

    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( );...
  • Page 198: 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 scout light GigE...
  • Page 199 You can enable or disable the reverse X feature by setting the ReverseX parameter value. You can set the parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: // Enable reverse X Camera.ReverseX.SetValue(true);...
  • Page 200: Disable Parameter Limits

    Typically, the range of the extended limits is dictated by the physical restrictions of the camera’s electronic devices, such as the absolute limits of the camera’s variable gain control. The values for the extended limits can be seen using the Basler pylon Viewer or from within your application via the pylon API.
  • Page 201: 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. 51: Filtering of Input Signals by the Debouncer Basler scout light GigE...
  • Page 202 // 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 203: Trigger Delay

    API. The following code snippets illustrate using the API to set the parameter values: Standard mode: // Select the acquisition start trigger Camera.TriggerSelector.SetValue( TriggerSelector_Acquisition Start ); // Trigger delay double TriggerDelay_us = 1000.0 // 1000us == 1ms == 0.001s; Camera.TriggerDelayAbs.SetValue( TriggerDelay_us ); // Select the frame start trigger Basler scout light GigE...
  • Page 204 // 1000us == 1ms == 0.001s; Camera.TriggerDelayAbs.SetValue( TriggerDelay_us ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 205: Acquisition Status

    // Set the Acquisition Status Selector Camera.AcquisitionStatusSelector.SetValue( AcquisitionStatusSelector_FrameTriggerWait ); // 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. Basler scout light GigE...
  • Page 206 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 For more information about the standard and legacy image acquisition control modes, see Section 9.1 on...
  • Page 207: Test Images

    Test Image Selector to one of the test images or to "test image off". You can set the Test Image Selector from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to set the selector: // set for no test image Camera.TestImageSelector.SetValue( TestImageSelector_Off );...
  • Page 208 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 scout light GigE...
  • Page 209 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 digital shift feature. Basler scout light GigE...
  • Page 210 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. 53: Test Image Six Basler scout light GigE...
  • Page 211: 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.
  • Page 212 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 213: 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 factory set into the active set and for designating which set will be the startup set appear below. Basler scout light GigE...
  • Page 214: Saving User Sets

    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 215: Selecting A Factory Setup As The Default Set

    Set the Default Set Selector to the Standard Factory Setup or High Gain Factory Setup. You can set the Default Set Selector from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector: If you want to select the Standard Factory Setup: Camera.DefaultSetSelector.SetValue(DefaultSetSelector_Standard);...
  • Page 216: Loading A Saved Set Or The Default Set Into The Active Set

    The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. Basler scout light GigE...
  • Page 217: Selecting The Startup Set

    Set the User Set Default Selector to User Set 1, User Set 2, User Set 3 or Default. You can set the User Set Default Selector from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector: Camera.UserSetDefaultSelector.SetValue( UserSetDefaultSelector_Default ); Basler scout light GigE...
  • Page 218 Standard Features AW00104701000 Basler scout light GigE...
  • Page 219: 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 220: 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 221 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 222 Troubleshooting and Support AW00104701000 Basler scout light GigE...
  • Page 223: Revision History

    AW00104701000 Revision History Revision History Doc. ID Number Date Changes AW00104701000 30 Nov 2011 Initial release. Basler scout light GigE...
  • Page 224 Revision History AW00104701000 Basler scout light GigE...
  • Page 225: Index

    ......201 bit depth ..........2 digital shift ..........178 black level dimensions ........3 explained .........176 disable parameter limits setting ..........176 explained .........190 black level raw parameter .....176 drivers, network ........27 black level selector ........176 block diagram ..........54 Basler scout light GigE...
  • Page 226 99 LEDs ............55 frame transmission delay parameter ..40 lens adapter ..........2 frame transmission time ......142 lens thread length ........14 free run ..........125 line inverter parameter ......75 functional description ......53 line selector .....73 Basler scout light GigE...
  • Page 227 ....44 voltage requirements ......67 return material authorization ....209 over triggering .......105 overlapped exposure ......133 reverse X ..........188 RMA number .........209 packet size camera ..........48 network adapter ........48 network switch ........48 packet size parameter ......39 Basler scout light GigE...
  • Page 228 .79 timer selector ......76 timer trigger source parameter ....76 transition threshold ......64 transmission start delay ......142 trigger delay ..........193 acquisition start (legacy mode) ..118 frame start (standard mode) ...107 trigger ready signal ....106 Basler scout light GigE...

Table of Contents