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...
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...
+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...
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...
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...
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...
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...
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...
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...
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.
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...
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...
The information you will need to install and operate the camera is included in the Installation and Setup Guide for Cameras Used with Basler’s pylon API (AW000611xx000). You can download the Installation and Setup Guide for Cameras Used with Basler’s pylon API from the Basler website: www.baslerweb.com...
The 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.
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 ®...
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.
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.
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.
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() );...
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...
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...
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...
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...
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...
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...
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...
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.
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...
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.
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...
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...
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...
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...
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...
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...
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...
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...
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.
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.
// 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...
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.
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.
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...
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...
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...
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.
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.
"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...
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...
"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...
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...
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...
// 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...
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...
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...
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...
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...
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.
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...
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.
// 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...
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...
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...
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...
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...
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...
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.
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.
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...
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...
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...
// 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.
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.
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...
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.
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...
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...
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 );...
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 );...
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 );...
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...
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...
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.
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 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...
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...
(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...
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...
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...
• • • • • • • • 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...
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...
= 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...
• • • • 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...
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...
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...
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...
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.
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 );...
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...
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...
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...
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 );...
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...
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...
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( );...
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);...
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.
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.
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.
// 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...
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...
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.
"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...
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.
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);...
The standard factory setup is optimized for use in typical situations and will provide good camera performance in most cases. Basler scout light GigE...
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...
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.
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...
Need help?
Do you have a question about the SCOUT LIGHT and is the answer not in the manual?
Questions and answers