Basler Racer raL4096-24gm User Manual
  1. Manuals
  2. Brands
  3. Basler Manuals
  4. Digital Camera
  5. Racer raL4096-24gm
  6. User manual

Basler Racer raL4096-24gm User Manual

Gige vision cameras
Hide thumbs Also See for Racer raL4096-24gm:
Table of Contents

Advertisement

Quick Links

Basler racer
USER'S MANUAL FOR GigE VISION CAMERAS
Document Number: AW001183
Version: 02
Language: 000 (English)
Release Date: 26 June 2013
Note that the 6k, 8k, and 12k cameras are still in their prototype
stage

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Racer raL4096-24gm and is the answer not in the manual?

Questions and answers

Related Manuals for Basler Racer raL4096-24gm

Summary of Contents for Basler Racer raL4096-24gm

  • Page 1 Basler racer USER’S MANUAL FOR GigE VISION CAMERAS Document Number: AW001183 Version: 02 Language: 000 (English) Release Date: 26 June 2013 Note that the 6k, 8k, and 12k cameras are still in their prototype stage...
  • 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 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 support.usa@baslerweb.com Asia: Basler Asia Pte. Ltd.

  • Page 5: Table Of Contents

    The pylon SDK ............24 4 Basler Network Drivers and Parameters ......25 The Basler Filter Driver .
  • Page 6 Frame Start Trigger Mode = Off ......83 8.2.3.2 Frame Start Trigger Mode = On ......83 Basler racer GigE...
  • Page 7 10.2 Remove Parameter Limits ..........168 Basler racer GigE...
  • Page 8 12.3 Obtaining an RMA Number ..........216 12.4 Before Contacting Basler Technical Support ....... 216 Revision History .
  • Page 9 ..............223 Basler racer GigE...
  • Page 10 Table of Contents AW00118302000 Basler racer GigE...

  • Page 11: Specifications, Requirements, And Precautions

    We strongly recommend that you read and follow the precautions. 1.1 Models The current Basler racer 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 and their maximum line rate at full resolution.

  • Page 12: General Specifications

    79.9 mm x 56 mm x 62 mm (with F-mount lens adapter and connectors) 49.5 mm x 56 mm x 62 mm (with M42-mount lens adapter and connectors) Table 1: General Specifications - 2k and 4k Mono Cameras Basler racer GigE...
  • Page 13 ~ 330 g (typical) with F-mount lens adapter and connectors ~ 260 g (typical) with M42-mount lens adapter and connectors Conformity CE, RoHS, FCC, UL (in preparation), GenICam, GigE Vision, IP30 Table 1: General Specifications - 2k and 4k Mono Cameras Basler racer GigE...
  • Page 14 ~ 330 g (typical) with F-mount lens adapter and connectors ~ 260 g (typical) with M42-mount lens adapter and connectors Conformity CE, RoHS, FCC, UL (in preparation), GenICam, GigE Vision, IP30 Table 2: General Specifications - 6k and 8k Mono Cameras Basler racer GigE...
  • Page 15 ~ 330 g (typical) with F-mount lens adapter and connectors ~ 260 g (typical) with M42-mount lens adapter and connectors Conformity CE, RoHS, FCC, UL (in preparation), GenICam, GigE Vision, IP30 Table 3: General Specifications - 12k Mono Cameras Basler racer GigE...

  • Page 16: Spectral Response

    The following graph shows the quantum efficiency curve for monochrome cameras. The quantum efficiency curve excludes lens characteristics and light source characteristics. 1000 1100 Wave Length (nm) Fig. 1: Monochrome Camera Quantum Efficiency (From Sensor Data Sheet) Basler racer GigE...

  • Page 17: Mechanical Specifications

    Camera housings are equipped with four mounting holes (4 x M4; 6.3 deep) on the front and two mounting holes (8 x M4; 6.3 deep) on each side as shown in the drawings. Four additional holes (4 x M2.5; 3.3 deep) are present on the camera front for mounting the lens mount adapter. Basler racer GigE...
  • Page 18 8 x M4; 6.3 deep 3.97 1 x M2.5; 5.3 deep 14.3 ø 4 x M2.5; 3.3 deep (36.79) 4 x M4; 6.3 deep (14.82) ø Reference Plane Not to Scale Fig. 2: Mechanical Dimensions (in mm) Basler racer GigE...

  • Page 19: Sensor Line Location

    Pixel 1 for 2k Cameras Pixel 1 for 4k and 8k Cameras Pixel 1 for 6k and 12k Cameras Marker Hole Sensor Line Not to Scale Fig. 3: Mono Sensor Line Location with Approximate Starting Points (Pixel 1) for Pixel Numbering Basler racer GigE...

  • Page 20: Lens Adapter Dimensions

    Specifications, Requirements, and Precautions AW00118302000 1.4.3 Lens Adapter Dimensions 50.83 42.42 36.12 ø 17.41 Photosensitive Surface of the ø Sensor 51.2 Not to Scale 8.41 Fig. 4: C-mount Adapter on a racer GigE Camera; Dimensions in mm Basler racer GigE...
  • Page 21 42.42 36.12 ø Photosensitive Surface of the M42 x 1.0 or Sensor M42 x 0.75 Not to Scale Fig. 6: M42 x 1.0 or M42 x 0.75 Mount Adapter on a racer GigE Camera; Dimensions in mm Basler racer GigE...

  • Page 22: Selecting The Optimum Lens Adapter

     Table 4: Recommended Lens Adapters Depending on Camera Model ( = recommended, - = not recommended. 1) To ensure coverage of the entire sensor, contact Basler technical support for assistance when choosing a lens.) 1.4.5 Attaching a Lens Adapter Use the four M2.5 setscrews supplied with the lens adapter to lock the lens adapter to the camera.

  • Page 23: 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 racer GigE...

  • Page 24: Lz4 Licensing

    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 racer GigE...

  • Page 25: Avoiding Emi And Esd Problems

    The Basler application note called Avoiding EMI and ESD in Basler Camera Installations provides much more detail about avoiding EMI and ESD. This application note can be obtained from the Downloads section of our website: www.baslerweb.com...

  • Page 26: Environmental Requirements

    You must provide sufficient heat dissipation to maintain the temperature of the camera housing at 50 °C or less. Since each installation is unique, Basler does not supply a strictly required technique for proper heat dissipation. Instead, we provide the following general guidelines: In all cases, you should monitor the temperature of the camera housing and make sure that the ...

  • Page 27: Precautions

    Make sure the cable and plug you connect to the 12-pin receptacle follows the correct pin assignment. In particular, do not use a pin assignment that would be correct for Basler area scan cameras. The 12-pin receptacles of Basler line scan and area scan cameras are electrically incompatible.
  • Page 28 3. The code snippets in this manual are written in C++. Other programming languages can also be used to write code for use with Basler pylon. When writing code, you should use a programming language that is both compatible with pylon and appropriate for your application.
  • Page 29 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 racer GigE...
  • Page 30 Specifications, Requirements, and Precautions AW00118302000 Basler racer GigE...

  • Page 31: Software And Hardware 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 32 Software and Hardware Installation AW00118302000 Basler racer GigE...

  • Page 33: Tools For Changing Camera Parameters

    The Basler IP Configurator is a standalone application that lets you change the IP configuration of the camera via a GUI. The tool will detect all Basler GigE cameras attached to your network and let you make changes to a selected camera.

  • Page 34: The Pylon Sdk

    API. The programmer’s guide and API reference are included in the pylon SDK. The Basler pylon SDK includes a set of sample programs that illustrate how to use the pylon API to ® ®...

  • Page 35: 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 36: The Basler Filter Driver

    AW00118302000 4.1 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 37: 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 38 Basler Network Drivers and Parameters AW00118302000 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 39 AW00118302000 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 Fig. 7. The parameter value is in per cent of the width of the receive window. In Fig. 7 the resend request threshold is set at 33.33% of the width of the receive window.
  • Page 40 Basler Network Drivers and Parameters AW00118302000 Timeout Resend Mechanism Parameters The timeout resend mechanism is illustrated in Fig. 8 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 41 AW00118302000 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 42 Basler Network Drivers and Parameters AW00118302000 Threshold and Timeout Resend Mechanisms Combined Fig. 9 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 43 (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 44 AW00118302000 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 45: 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 46 Basler Network Drivers and Parameters AW00118302000 Basler racer GigE...

  • Page 47: Network Related Camera Parameters And Managing Bandwidth

    The value is in bytes. The value does not affect the leader and trailer size using a total of 36 bytes, and the last data packet may be a smaller size. The payload size will be the packet size minus 36 bytes. Basler racer GigE...
  • Page 48 IPD = Inter-packet Delay setting in ticks (with a tick set to the 8 ns standard) When considering this formula, you should know that on a Gigabit network it takes one tick to transmit one byte. Also, be aware that the formula has been simplified for easier understanding. Basler racer GigE...

  • Page 49: Managing Bandwidth When Multiple Cameras Share A Single Network Path

    The higher the inter-packet delay parameter is set, the greater the delay between the transmission of each packet will be and the lower the data Basler racer GigE...

  • Page 50: A Procedure For Managing Bandwidth

    Go on to step two now. If you are using the Basler filter driver and you have already set the network parameters for your adapter during the installation of the Basler pylon software, go on to step two now.
  • Page 51 Viewer will lose the ability to acquire frames. (When you use Continuous Shot, the Viewer’s status bar will indicate that it is acquiring frames, but the frame in the viewing area will appear to be frozen.) Basler racer GigE...
  • Page 52 Packet Overhead + 12 (if chunk mode is active) Trailer Size = Packet Overhead + 8  x  means round up x to the nearest integer  x  means round up x to the nearest multiple of 4 Basler racer GigE...
  • Page 53 When you lower the data output rate, you increase the amount of time that the camera needs to transmit an acquired frame. Increasing the frame transmission time can restrict the camera’s maximum allowed acquisition line rate. Basler racer GigE...
  • Page 54 Once you have adjusted the line rates and/or frame size on the cameras, you should repeat steps 2 through 6. For more information about the camera’s maximum allowed line rate, see Section 8.5 on page 135. For more information about the frame size, see Section 8.1 on page Basler racer GigE...

  • Page 55: Camera Functional Description

    Acquisition start, frame start, and exposure time can also be controlled by parameters transmitted to the camera via the Basler pylon API and the GigE interface. Accumulated charges are read out of the sensor when exposure ends. At readout, accumulated charges are moved from the sensor’s light-sensitive elements (pixels) into the analog processing...
  • Page 56 Fig. 11: CMOS Sensor Architecture. Type A is a 2k Sensor or 2k Sensor Segment with a Pixel Size of 7 µm x 7 µm and Type B is a 4k Sensor Segment with a Pixel Size of 3.5 µm x 3.5 µm. Basler racer GigE...
  • Page 57 Camera Functional Description ExASTrig, ExFSTrig, ExLSTrig Frame Buffer ExpActive, FrameTrigWait, LineTrigWait Pixel Pixel Data Data Ethernet Ethernet Sensor FPGA Controller Network Frame Frame Data Data Control Data Control Control Micro- Controller Control Data Fig. 12: Camera Block Diagram Basler racer GigE...
  • Page 58 Camera Functional Description AW00118302000 Basler racer GigE...

  • Page 59: Physical Interface

    The drawing below shows the location of the three connectors, the LEDs, and the functional earth connection. 12-pin 6-pin Receptacle Receptacle (I/O) (Power) 8-pin RJ-45 Jack (Ethernet) Functional Earth Connection Green LED Yellow LED Fig. 13: Camera Connectors , LEDs, and Functional Earth Connection Basler racer GigE...

  • Page 60: Pin Numbering

    Pin numbering for the camera’s 6-pin and 12-pin receptacles is as shown in Fig. 14. Pin numbering for the 8-pin RJ-45 jack adheres to the Ethernet standard. Fig. 14: Pin Numbering for the 6-pin and 12-pin Receptacles Basler racer GigE...

  • Page 61: Connector Pin Assignments

    +12 VDC through two separate wires between the power supply and pins 1 and 2 in the receptacle. We also recommend that you provide the ground through two separate wires between the power supply and pins 5 and 6. Basler racer GigE...

  • Page 62: Pin Assignments For The 12-Pin Connector

    Make sure the cable and plug you connect to the 12-pin connector follows the correct pin assignment. In particular, do not use a pin assignment that would be correct for Basler area scan cameras. The 12-pin connectors of Basler line scan and area scan cameras are electrically incompatible.

  • Page 63: 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 RJ-45 plug. Cables terminated with screw-lock connectors are available from Basler. Contact your Basler sales representative to order cable assemblies. Suitable cable assemblies are also available from the Intercon 1 division of Nortech Systems, Inc.

  • Page 64: Cabling Requirements

    The plug on the cable that you attach to the camera’s 6-pin connector must have 6 female pins. Hirose HR10A-7P-6S 6-pin Plug Camera +12 VDC to +24 VDC Power Supply +12 VDC to +24 VDC Not Connected Not Connected AC In DC Gnd DC Gnd Shield Power Cable Fig. 15: Power Cable Basler racer GigE...

  • Page 65: I/O Cable

    Use of twisted pair wire is essential to ensure that input signals are correctly received. The required 12-pin Hirose plug is available from Basler. Basler also offers an I/O 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 I/O cables.

  • Page 66: Camera Power

    The plug on the cable that you attach to the camera’s 6-pin connector must have 6 female pins. For more information about the 6-pin connector, see Section 7.2.1 on page 51 and Section 7.3.1 on page For more information about the power cable, see Section 7.4.1 on page Basler racer GigE...

  • Page 67: Input And Output Lines

    I/O In 1 - Input Signal I/O In 1 +  Your Receiver FPGA (control) 3.3 V RS-422 k k Transceiver RS-422 Transceiver = Linear Technology LTC 2855 or the equivalent Fig. 17: Inputting RS-422 or RS-644 Signals Basler racer GigE...
  • Page 68 (as shown in Fig. 18.: R4), the termination resistor on that input should be enabled. You should not use multiple termination resistors on a single bus. Using multiple termination resistors will lower signalling reliability and has the potential for causing damage to the RS-422 devices. Basler racer GigE...
  • Page 69 "multidrop" configuration, we strongly recommend that you do not include any camera input in an RS-644 multidrop. Instead, we strongly recommend that you use a direct, point-to-point connection between your RS-644 transmitter and the camera input. Basler racer GigE...
  • Page 70 Your 0 to +5 VDC TTL Input Signal I/O In 1 +  Your Receiver FPGA (control) 3.3 V k RS-422 k Transceiver RS-422 Transceiver = Linear Technology LTC 2855 or the equivalent Fig. 19: Inputting Low Voltage TTL Signals Basler racer GigE...

  • Page 71: Input Line Debouncers

    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 enable or disable the resistors. For more information about the pylon Viewer, see Section 3.1 on page 7.6.1.2...

  • Page 72: Input Line Inverters

    // Enable the inverter on line 1 Camera.LineSelector.SetValue( LineSelector_Line1 ); Camera.LineInverter.SetValue( true ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 73 Input Line 1 is also selected as the source signal for shaft encoder module Phase A input.  Input Line 2 is selected as the source signal for shaft encoder module Phase B input.  Input Line 3 is selected as the source signal for the camera’s Frame Start Trigger function.  Basler racer GigE...

  • Page 74: Output Lines

    Connector Camera 3.3 V Your To your RS-422 I/O Out 1 - input I/O Out 1 + FPGA (control) Driver RS-422 Transceiver RS-422 Transceiver = Linear Technology LTC 2855 or the equivalent Fig. 20: RS-422 Output Signal Basler racer GigE...
  • Page 75 I/O Out 1 - Input I/O Out 1 + 22 FPGA Driver (control) 47 RS-422 Transceiver RS-422 Transceiver = Linear Technology LTC 2855 or the equivalent Fig. 21: RS-422 Output Signal Modified for Use with an RS-644 Input Basler racer GigE...

  • Page 76: Input Related Signals As Output Signals

    For more information about selecting the source signal for an output line on the camera, see Section 7.6.2.5 on page For more information about the electrical characteristics of the camera’s output lines, see Section 7.6.2.1 on page For more information about the minimum output pulse width feature, see Section 7.6.2.3 on page Basler racer GigE...

  • Page 77: Minimum Output Pulse Width

    // Set the parameter value to 10.0 microseconds Camera.MinOutPulseWidthAbs.SetValue(10.0); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 78: Selecting The Source Signal For An Output Line

    // Select the acquisition trigger wait for output line 2 Camera.LineSelector.SetValue( LineSelector_Out2 ); Camera.LineSource.SetValue( LineSource_AcquisitionTriggerWait ); // Select the frame trigger wait for output line 2 Camera.LineSelector.SetValue( LineSelector_Out2 ); Camera.LineSource.SetValue( LineSource_FrameTriggerWait ); // Select the line trigger wait signal for output line 2 Basler racer GigE...
  • Page 79 // Select output line 1 as a user output Camera.LineSelector.SetValue( LineSelector_Out1 ); Camera.LineSource.SetValue( LineSource_UserOutput ); 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 80: Setting The State Of User Settable Output Lines

    Camera.UserOutputValue.SetValue( true ); bool currentUserOutput2State = 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 81: Checking The State Of The I/O Lines

    The Line Status All parameter is a 32 bit value. As shown in Fig. 24, certain bits in the value are associated with each line and the bits will indicate the state of the lines. If a bit is 0, it indicates that Basler racer GigE...

  • Page 82: Checking The Line Logic

    You can set the Line Selector and read the Line Logic parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and read the parameter value:...

  • Page 83: I/O Line Response Times

    // Select the I/O line and read the line logic type Camera.LineSelector.SetValue( LineSelector_Line1 ); LineLogicEnums lineLogicLine1 = Camera.LineLogic.GetValue( ); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3.1 on page 7.6.5...
  • Page 84 Physical Interface AW00118302000 Basler racer GigE...

  • Page 85: Acquisition Control

    25. With these settings, pixels 10 through 34 would be used for each line acquisition as shown in Fig. 25. Width X Offset = Image area of interest: pixels included in each acquisition Fig. 25: Pixels Used for Each Line Acquisition Basler racer GigE...
  • Page 86 Height parameter. The value that you retrieve with this technique will give you the maximum allowed Height with all the other current parameter settings taken into account. 3. Set the Height parameter to a value that is less than or equal to the allowed maximum. Basler racer GigE...
  • Page 87 = Camera.Height.GetInc( ); Camera.Height.SetValue( 200 ); 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: Controlling Acquisition

    Once the Acquisition Stop command is received, the camera can no longer acquire frames. To see graphical representations of the use of the Acquisition Start and Acquisition Stop commands and the Acquisition Mode parameter, refer to the use case diagrams in Section 8.3 on page 122. Basler racer GigE...
  • Page 89 Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeAbs.SetValue( 55 ); Camera.AcquisitionStart.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 90: Acquisition Start Triggering

    When the Acquisition Start Trigger Mode parameter is set to on, you must select a source signal to serve as the acquisition start trigger. The Acquisition Start Trigger Source parameter specifies the source signal. The available selections for the Acquisition Start Trigger Source parameter are: Basler racer GigE...

  • Page 91: Acquisition Frame Count

    "waiting for acquisition start trigger" acquisition status. At that point, you must apply a new acquisition start trigger signal to exit the camera from the "waiting for acquisition start trigger" acquisition status. Basler racer GigE...

  • Page 92: Setting The Acquisition Start Trigger Mode And

    // Set the activation mode for the selected trigger to rising edge 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. Basler racer GigE...

  • Page 93: Frame Start Triggering

    Software - When the frame start trigger source is set to software, the user triggers frame start  by issuing a TriggerSoftware command to the camera from the host PC. Each time a TriggerSoftware command is received by the camera, the frame start trigger will become valid Basler racer GigE...
  • Page 94 100 ns for the camera to detect a transition from low to high and must be held low for at least 100 ns for the camera to detect a transition from high to low. Basler racer GigE...

  • Page 95: Setting The Frame Start Trigger Parameters

    // Set the activation scheme for the selected trigger Camera.TriggerActivation.SetValue( TriggerActivation_RisingEdge ); 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 96: Frame Timeout

    // In order to capture FrameTimeout events: // Set up an event grabber and register a callback for // the node 'FrameTimeoutEventPort' For more information about event reporting and enabling an event, see Section 10.4 on page 171. Basler racer GigE...

  • Page 97: Line Start Triggering

    When the line start trigger mode is set to off, the exposure time for each line acquisition is determined by the value of the camera’s Exposure Time parameters. For more information about the camera’s exposure time parameters, see Section 8.2.5.2 on page Basler racer GigE...

  • Page 98: Line Start Trigger Mode = On

    100 ns for the camera to detect a transition from low to high and must be held low for at least 100 ns for the camera to detect a transition from high to low. Basler racer GigE...
  • Page 99 Trigger width exposure is especially useful if you intend to vary the length of the exposure time for each acquired line. Source Signal Period Exposure Source Signal Fig. 26: Trigger Width Exposure with Rising Edge Line Start Triggering Basler racer GigE...
  • Page 100 1.5 µs End Delay 1.2 µs 1.2 µs 1.2 µs 1.2 µs 1.2 µs Table 8: Base Exposure Start and End Delays When using the frequency converter, the delay values may slightly differ from those given in Table Basler racer GigE...

  • Page 101: Setting The Line Start Trigger Parameters

    Table 8 to determine the total start delay and end delay. For example, assume that you are using an raL2048-48gm camera and that you have set the line start trigger mode to on. Also assume that you have selected input line 1 as the source signal for the line start trigger and that the debouncer parameter for line 1 is set to 5 µs.

  • Page 102: Exposure Time

    AW00118302000 Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeAbs.SetValue( 60.0 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page 8.2.5...

  • Page 103: Exposure Time Parameters

    If you are using a GenICam compliant tool such as the Basler pylon Viewer and you attempt to set the exposure time to exactly the minimum allowed or to exactly the maximum allowed, you will see unusual error codes.
  • Page 104 API. The following code snippet illustrates using the API to set the parameter values: Camera.ExposureMode.SetValue( ExposureMode_Timed ); Camera.ExposureTimeRaw.SetValue( 2 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 105: Use Case Descriptions And Diagrams

    In this example, each frame is set to include three lines. When the Acquisition Mode is set to Single Frame, an acquisition start command must be issued for the acquisition of each single frame. Basler racer GigE...
  • Page 106 Acquisition start trigger signal Frame start trigger signal Line start trigger signal Time Fig. 28: Use Case 1 - Single Frame Mode with Acquisition Start, Frame Start, and Line Start Triggering Set to Off Basler racer GigE...
  • Page 107 When the Acquisition Mode is set to Continuous Frame, the camera will acquire frames until an acquisition stop command is issued. If an acquisition stop command is issued when not all lines of the current frame are yet acquired, the partial frame will be transmitted. Basler racer GigE...
  • Page 108 = partial frame transmitted Acquisition Acquisition start stop command command Frame start trigger signal Line start trigger signal Time Fig. 29: Use Case 2 - Continuous Frame Mode with Acquisition Start, Frame Start and Line Start Triggering Set to Basler racer GigE...
  • Page 109 In this example, each frame is set to include three lines. When the Acquisition Mode is set to Continuous Frame, the camera will be set to acquire frames until an acquisition stop command is issued. Basler racer GigE...
  • Page 110 Frame start trigger signal Line start trigger signal Time Fig. 30: Use Case 3 - Continuous Frame Mode with Acquisition Start and Line Start Triggering Set to Off and Frame Start Triggering Set to On Basler racer GigE...
  • Page 111 In this example, each frame is set to include three lines. When the Acquisition Mode is set to Continuous Frame, the camera will be set to acquire frames until an acquisition stop command is issued. Basler racer GigE...
  • Page 112 Frame start trigger signal Line start trigger signal Time Fig. 31: Use Case 4 - Continuous Frame Mode with Acquisition Start Triggering Set to Off and Frame Start and Line Start Triggering Set to On Basler racer GigE...
  • Page 113 Closing Frame set to false, the complete closing frame will be acquired and transmitted. When the Acquisition Mode set to Continuous Frame, the camera will be set to acquire frames until an acquisition stop command is issued. Basler racer GigE...
  • Page 114 Line start trigger signal Time Fig. 32: Use Case 5 - Continuous Frame Mode with Acquisition Start Triggering Set to Off, Frame Start and Line Start Triggering Set to On, and Partial Closing Frame set to False Basler racer GigE...
  • Page 115 Frame set to true, only the partial closing frame will be acquired and transmitted. In this example, the partial closing frame includes only one line. When the Acquisition Mode set to Continuous Frame, the camera will be set to acquire frames until an acquisition stop command is issued. Basler racer GigE...
  • Page 116 Line start trigger signal Time Fig. 33: Use Case 6 - Continuous Frame Mode with Acquisition Start Triggering Set to Off, Frame Start and Line Start Triggering Set to On, and Partial Closing Frame set to True Basler racer GigE...
  • Page 117 Acquisition Stop command is issued during readout of the second line acquisition, the  readout will be completed and the partial frame will include the related lines one and two. Basler racer GigE...
  • Page 118 Frame start trigger signal Line start trigger signal Time Fig. 34: Use Case 7 - Continuous Frame Mode with Acquisition Start and Frame Start Triggering Set to Off and Line Start Triggering Set to On Basler racer GigE...
  • Page 119 In this example, each frame is set to include three lines. When the Acquisition Mode is set to Continuous Frame, the camera will be set to acquire frames until an acquisition stop command is issued. Basler racer GigE...
  • Page 120 Frame start trigger signal Line start trigger signal Time Fig. 35: Use Case 8 - Continuous Frame Mode with Acquisition Start Triggering Set to On and Frame Start and Line Start Triggering Set to Off Basler racer GigE...
  • Page 121 In this example, each frame is set to include three lines. When the Acquisition Mode is set to Continuous Frame, the camera will be set to acquire frames until an acquisition stop command is issued. Basler racer GigE...
  • Page 122 Frame start trigger signal Line start trigger signal Time Fig. 36: Use Case 9 - Continuous Frame Mode with Acquisition Start and Line Start Triggering Set to On and Frame Start Triggering Set to Off Basler racer GigE...

  • Page 123: Overlapping Exposure With Sensor Readout

    ExLSTrig Signal Line Acquisition N Exposure Readout Line Acquisition N+1 Exposure Readout Line Acquisition N+2 Exposure Readout Line Acquisition N+3 Exposure Readout Time Fig. 38: Overlapped Exposure and Readout Basler racer GigE...

  • Page 124: Guidelines For Overlapped Operation

    You can read the Readout Time Abs parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: double ReadoutTime = Camera.ReadoutTimeAbs.GetValue( );...
  • Page 125 Readout Exposure Overhead Time Fig. 39: Exposure N+1 Illegally Starts Before the Exposure Overhead for the Preceding Line Acquisition N Has Ended; the Shown Overlap of Readouts is Also Illegal; Timed Exposure Mode Used as an Example Basler racer GigE...
  • Page 126 The exposure is ended with the next valid attempt to end it. Line Acquisition N+1 Readout Exposure Time Fig. 41: Extension of Exposure N+1 After the Illegal Attempt of Ending It Too Early; Applies to Trigger Width Exposure Mode Only Basler racer GigE...
  • Page 127 As an example, and in the context of overlapped exposure, the use of the line trigger wait signal is described in Section 8.3.3.3 on page 130 for proper triggering with the line start trigger. Both timed and trigger width exposure mode are considered. Basler racer GigE...
  • Page 128  ExposureOverlapTimeMax parameter value must be set to the applicable maximum value for E. For example, for a raL2048-48gm camera the parameter value must be set to 15.1 µs. When the parameter limit is removed from the ExposureOverhead parameter the ...
  • Page 129 From the above conditions, one can readily calculate the allowed values for E and F for regularly operating the camera at the maximum allowed line rate. This operation will also involve the maximum possible overlap between consecutive line acquisitions. Basler racer GigE...
  • Page 130 Optimum ExposureOverlapTimeMax Parameter Value Settings Example Assume that you are using an raL2048-48gm camera at full resolution (2048 pixels), assume that you want to use the maximum allowed line acquisition rate (equivalent to the minimum allowed line acquisition period), and the default value for C Also assume that the other relevant settings are in accord with operation at 48.78 kHz.
  • Page 131 If you increase exposure times given in Table 11 beyond their upper limits the related extent of overlap and the acquisition line rate will decrease. When extending exposure time even further, consecutive line acquisitions will eventually not overlap at all. Basler racer GigE...

  • Page 132: Acquisition Monitoring Tools

    If you check the line trigger wait signal before you apply each hardware line start trigger signal, you can avoid applying line start trigger signals to the camera that will be ignored. For more information about the trigger wait signals, see Section 8.3.3 on page 125. Basler racer GigE...

  • Page 133: Exposure Active Signal

    For more information about selecting the source signal for an output line on the camera, see Section 7.6.2.5 on page For more information about the electrical characteristics of the camera’s output lines, see Section 7.6.2.1 on page Basler racer GigE...

  • Page 134: Acquisition Status Indicator

    If the value is set to "true", the camera is waiting for the trigger signal. You can check the acquisition status from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to check the acquisition status:...

  • Page 135: Trigger Wait Signals

    ( AcquisitionStatusSelector_LineTriggerWait ); // Read the acquisition status bool IsWaitingForLineTrigger = Camera.AcquisitionStatus.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon API and the pylon Viewer, see Section 3 on page 8.3.3...

  • Page 136: Acquisition Trigger Wait Signal

    For more information about selecting the source signal for an output line on the camera, see Section 7.6.2.5 on page For more information about the electrical characteristics of the camera’s output lines, see Section 7.6.2.1 on page For more information about event reporting, see Section 10.4 on page 171. Basler racer GigE...
  • Page 137 Line Acquisition Exp. Readout Time = Camera is in a "waiting for acquisition start trigger" status Fig. 45: Acquisition Trigger Wait Signal The acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled. Basler racer GigE...

  • Page 138: Frame Trigger Wait Signal

     You can set the Line Selector and the Line Source parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: Camera.LineSelector.SetValue( LineSelector_Out1 );...
  • Page 139 By default, the frame trigger wait signal is selected as the source signal for output line 2 on the camera. However, the selection of the source signal for a physical output line can be changed. Basler racer GigE...

  • Page 140: Line 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 141 Line Acquisition N+1 Exposure Readout Exp. Time Setting Line Acquisition N+2 Exposure Readout Time = Camera is in a "waiting for line start trigger" status Fig. 47: Line Trigger Wait Signal with the Timed Exposure Mode Basler racer GigE...
  • Page 142 Making sure that your exposure time is always equal to or greater than the setting for the  Exposure Overlap Time Max Abs parameter. Only use the ExLSTrig signal to start exposure when the Line Trigger Wait signal is high.  Basler racer GigE...
  • Page 143 Setting the Exposure Overlap Time Max Abs Parameter You can use the Basler pylon API to set the Exposure Overlap Time Max Abs parameter value from within your application software. The following code snippet illustrates using the API to set the parameter value: // Set the Exposure Overlap Time Max to 4 µs...

  • Page 144: Frame Transmission Time

    For more detailed information about receiving the frames as they arrive in your host PC, refer to the Basler pylon Programmer’s Guide and API Reference. The sample programs included with the pylon software development kit (SDK) also provide more detailed information about handling incoming image data in your host PC.

  • Page 145: Maximum Allowed Line Acquisition Rate

    Factor 1 is the sensor readout time. The readout time for a particular sensor is a fixed value and thus the maximum line acquisition rate as determined by the readout time is also fixed. The table below shows the maximum line rate (in lines per second) based on sensor readout time for each camera model. Basler racer GigE...
  • Page 146 Factor 3 is the frame transmission time. You can use the formula below to calculate the maximum line rate based on the frame transmission time:   Device Current Throughput Parameter Value  ------------------------------------------------------------------------------------------------------------------------ Max Lines/s Frame Height   Payload Size Parameter Value Basler racer GigE...
  • Page 147 Example Assume that you are using an raL2048-48gm camera set for an exposure time of 190 µs and a frame height of 500 lines. Also assume that you use the default value for C , that you have checked the value of the Device Current Throughput parameter and the Payload Size parameters and found them to be 110000000 and 5120000 respectively.

  • Page 148: Removing The Parameter Limits For The Exposureoverhead Parameter

     signal period according to the decrease of the exposure overhead time. To maintain the line rate, increase the Exposure Overlap Time Max Abs parameter value by the amount of time that was gained for exposure time. Basler racer GigE...
  • Page 149 // Remove the limits for the selected parameter. Camera.RemoveLimits.SetValue( true ); You can also use the Basler pylon Viewer application to easily set the parameters. Note that the remove parameter limits feature will only be available at the "guru" viewing level.

  • Page 150: The Shaft Encoder Module

    Tick (Phase B leads Phase A, i.e., Phase A (Phase A leads Phase B, i.e., Phase B low at rising edge of Phase B) low at rising edge of Phase A) Fig. 50: Software Module Direction Sensing Basler racer GigE...
  • Page 151 0 and informs the software module that the current direction of conveyor movement is forward. For more information about this parameter, see the detailed description of the reverse counter that appears later in this section. Basler racer GigE...
  • Page 152 // Set the shaft encoder module mode Camera.ShaftEncoderModuleMode.SetValue( ShaftEncoderModuleMode_AnyDirection ); // Set the shaft encoder module counter max and the shaft encoder module reverse counter max Camera.ShaftEncoderModuleCounterMax.SetValue( 32767 ); Camera.ShaftEncoderModuleReverseCounterMax.SetValue( 15 ); // Get the current value of the shaft encoder module counter Basler racer GigE...
  • Page 153 Camera.ShaftEncoderModuleCounterReset.Execute( ); Camera.ShaftEncoderModuleReverseCounterReset.Execute( ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on page For more information about the line start trigger, see Section 8.2.4 on...
  • Page 154 If the Shaft Encoder Module Mode is set to Any Direction, the software module will output a  trigger signal whenever it receives either a forward tick or a reverse tick from the shaft encoder. Basler racer GigE...
  • Page 155 Note in step two that if the conveyor runs in reverse for a long period and the reverse counter reaches the max setting, the counter simply stops incrementing. If the conveyor continues in reverse, no output triggers will be generated because the Shaft Encoder Mode is set to Forward only. Basler racer GigE...
  • Page 156 When the reverse counter decrements to 0, decrementing stops and suppression of the trigger signals stops. The module will begin outputting a Forward trigger signal for each forward tick received. Basler racer GigE...
  • Page 157 When the reverse counter reaches the max (10 in this case) it stops incrementing and suppression of the trigger signals stops. The module will resume outputting a trigger signal for each reverse tick received. Reverse The reverse counter count is now 10. Basler racer GigE...
  • Page 158 It is important to reset the reverse counter before the first traverse in the forward direction. A reset sets the counter to 0 and synchronizes the counter software with the conveyor direction. (The software assumes that the conveyor will move in the forward direction after a counter reset). Basler racer GigE...

  • Page 159: Frequency Converter

    The post-divider module receives the signals from the multiplier module. The post-divider  module allows employing an integer factor, the post-divider, to generate signals at decreased frequencies and provides these signals to be used as camera trigger signals, e.g. as line start triggers. Basler racer GigE...
  • Page 160 // divider : 1...128 // multiplier: 1...32 CIntegerPtr(Control.GetNode("FrequencyConverterPreDivider"))->SetValue(4); CIntegerPtr(Control.GetNode("FrequencyConverterMultiplier"))->SetValue(17); CIntegerPtr(Control.GetNode("FrequencyConverterPostDivider"))->SetValue(1); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the shaft encoder module see, Section 8.4 on page 145. Basler racer GigE...

  • Page 161: Pixel Data Formats

    Camera.PixelFormat.SetValue( PixelFormat_Mono12Packed ); Camera.PixelFormat.SetValue( PixelFormat_YUV422Packed ); Camera.PixelFormat.SetValue( PixelFormat_YUV422_YUYV_Packed ); 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 162: Pixel Data Formats

    This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0xFF 0xFE       0x01 0x00 Basler racer GigE...

  • Page 163: Mono 12 Format

    11 ... 8 7 ... 0 x x x x 11 ... 8 7 ... 0 x x x x 11 ... 8 7 ... 0 x x x x 11 ... 8 Basler racer GigE...
  • Page 164 Therefore, the highest data value you will see is 0x0FFF indicating a signal level of 4095. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x0FFF 4095 0x0FFE 4094       0x0001 0x0000 Basler racer GigE...

  • Page 165: Mono 12 Packed Format

    3 ... 0 1 ... 4        11 ... 4 3 ... 0 3 ... 0 11 ... 4 11 ... 4 3 ... 0 3 ... 0 11 ... 4 Basler racer GigE...
  • Page 166 “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 racer GigE...

  • Page 167: Yuv 4:2:2 Packed Format

    7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0       7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 Basler racer GigE...
  • Page 168 0x00 The pixel data output for the U component or the V component is 8 bit data of the “straight binary” type and will always be zero. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x00 Basler racer GigE...

  • Page 169: Yuv 4:2:2 (Yuyv Packed) Format

    7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0 7 ... 0       Basler racer GigE...
  • Page 170 0x00 The pixel data output for the U component or the V component is 8 bit data of the “straight binary” type and will always be zero. This Data Value Indicates This Signal Level (Hexadecimal) (Decimal) 0x00 Basler racer GigE...

  • Page 171: Pixel Transmission Sequence

    The columns are numbered 0 through m from the left side to the right side of the frame  The rows are numbered 0 through n from the top to the bottom of the frame, corresponding to  n+1 line acquisitions. Basler racer GigE...
  • Page 172 Pixel Data Formats AW00118302000 Basler racer GigE...

  • Page 173: Standard Features

    127 (in an 8 bit format), you could increase the gain to 6 dB (an amplification factor of 2) and thus reach gray values of 254. You can use the analog gain for coarsely setting gain and the digital gain for finer adjustment. Basler racer GigE...

  • Page 174: Analog Gain

    // Set Gain Analog All Camera.GainSelector.SetValue( GainSelector_AnalogAll ); Camera.GainRaw.SetValue( 4 ); 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 175 // Set Gain Digital All Camera.GainSelector.SetValue( GainSelector_All ); Camera.GainRaw.SetValue( 264 ); 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 176: Using Both Analog Gain And Digital Gain

    You can set the Black Level Selector and the Black Level Raw parameter values from within your application software by using the pylon API. The following code snippet illustrates using the API to set the selector and the parameter value: // Set Black Level Raw All Camera.BlackLevelSelector.SetValue ( BlackLevelSelector_All ); Camera.BlackLevelRaw.SetValue( 64 ); Basler racer GigE...
  • Page 177 AW00118302000 Standard Features For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the pylon Viewer, see Section 3.1 on...

  • Page 178: Remove Parameter Limits

    The values for any extended limits can be determined by using the Basler pylon Viewer or from within your application via the pylon API.

  • Page 179: Image Area Of Interest

    When you are setting the camera’s area of interest, you must follow this guideline: The sum of the Offset X setting plus the Width setting must not exceed the width of the camera’s sensor. For example, on the raL2048-48gm, the sum of the Offset X setting plus the Width setting must not exceed 2048.

  • Page 180: Automatic Image Aoi X Centering

    AOI on the sensor. Setting Automatic X Centering You can set the Center X parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to enable automatic image AOI centering.

  • Page 181: Event Reporting

    If an acknowledgement is still not received, the timeout and resend mechanism will repeat until a specified maximum number of retries is reached. If the maximum number of retries is reached and no acknowledge has been received, the message will be dropped. Basler racer GigE...
  • Page 182 4. As soon as transmission time is available, an event message containing the event overrun event will be transmitted to the PC. The event overrun event is simply a warning that events are being dropped. The notification contains no specific information about how many or which events have been dropped. Basler racer GigE...
  • Page 183 API. The pylon software development kit includes a "Camera Events" code sample that illustrates the entire process. For more detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference.

  • Page 184: Luminance Lookup Table

    The second graph is for a lookup table where the values are arranged so that the camera output increases quickly as the actual sensor output moves from 0 through 2048 and increases gradually as the actual sensor output moves from 2049 through 4096. Basler racer GigE...
  • Page 185 8 bit format (such as Mono 8). In this situation, the camera will first use the values in the table to do a 12 bit to 12 bit substitution. It will then truncate the lowest 4 bits of the substitute value and will transmit the remaining 8 highest bits. Basler racer GigE...
  • Page 186 // Enable the lookup table Camera.LUTEnable.SetValue( true ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 187: Binning

    4 respectively. Setting the parameter’s value to 1 disables horizontal binning. You can set the Binning Vertical or the Binning Horizontal parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Enable horizontal binning by 4 Camera.BinningHorizontal.SetValue( 4 );...

  • Page 188: Gamma Correction

    1.2, for example, the gamma correction factor will be 1.2. You can set the Gamma Enable and Gamma 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: // Enable the Gamma feature Camera.GammaEnable.SetValue( true );...

  • Page 189: Shading Correction

    The multipliers used for correction are included in a "shading file", commonly also referred to as a "shading set". In order to use gain shading correction, the user must enable gain shading correction and activate the related defaultshading file or the previously created usershading file (see below). Basler racer GigE...

  • Page 190: Default Shading Set File And User Shading Set File

    Basler pylon SDK. When you create a "usershading" file you must make sure to create correction values for all of the pixels in the sensor’s line regardless of how you plan to use the camera during normal operation.
  • Page 191 4. Select Offset Shading in the Basler pylon Viewer or via the Basler pylon API. 5. Select "usershading" file in the Basler pylon Viewer or via the Basler pylon API. 6. Go to the Create enumeration in the Basler pylon Viewer and select Once or send a create command via the Basler pylon API.
  • Page 192 6. Select Gain Shading in the Basler pylon Viewer or via the Basler pylon API. 7. Select "usershading" file in the Basler pylon Viewer or via the Basler pylon API. 8. Go to the Create enumeration in the Basler pylon Viewer and select Once or send a create command via the Basler pylon API.

  • Page 193: Working With Shading Sets

    The use of the pylon API functions listed above is illustrated in the shading correction sample code included with the pylon SDK. You can also use the Shading parameters group in the Basler pylon Viewer application to access these functions.

  • Page 194: Trigger Delay

    NumberLineTriggers = 100; Camera.TriggerDelaySource = LineTrigger; Camera.TriggerDelayLineTriggerCount.SetValue( NumberLineTriggers ); 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 195: Error Codes

    Continue reading and clearing the last error until the parameter indicates a No Error code.  Reading and Clearing the Error Codes Using Basler Pylon You can use the pylon API to read the value of the Last Error parameter and to execute a Clear Last Error command from within your application software.
  • Page 196 Standard Features AW00118302000 You can also use the Basler pylon Viewer application to easily set the parameter and execute the command. Basler racer GigE...

  • Page 197: Test Images

    // set for the first test image Camera.TestImageSelector.SetValue( TestImageSelector_Testimage1 ); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 198: Test Images In Detail

    The image moves by one pixel from right to left whenever a new frame acquisition is initiated. The test pattern uses a counter that increments by one for each new frame acquisition. The mathematical expression for this test image is: Gray Value = [column number + row number + counter] MOD 256 Basler racer GigE...
  • Page 199 The difference between test image 5 and test image 3 is this: if a camera feature that involves digital processing is enabled, test image 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. Basler racer GigE...

  • Page 200: Device Information Parameters

    Device User ID (read / write) - is used to assign a user defined name to a device. This name  will be displayed in the Basler pylon Viewer and the Basler pylon IP Configuration Tool. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
  • Page 201 = Camera.TemperatureAbs.GetValue(); You can also use the Basler pylon Viewer application to easily read the parameters and to read or write the Device User ID. You can use the Basler pylon IP Configuration tool to read or write the Device User ID.

  • Page 202: User Defined Values

    Camera.UserDefinedValueSelector.SetValue( UserDefinedValueSelector_Value1 ); int64_t UserValue1 = Camera.UserDefinedValue.GetValue(); You can also use the Basler pylon Viewer application to easily set the parameters. For more information about the Basler pylon API and the pylon Viewer, see Section 3.1 on page Basler racer GigE...

  • Page 203: Configuration Sets

    The settings for frame transmission delay, inter packet delay, and the luminance lookup table are not saved in the user sets and are lost when the camera is reset or switched off. If used, these settings must be set again after each camera reset or restart. Basler racer GigE...

  • Page 204: Saving Configuration 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 205: Loading A Saved Set Or The Default Set Into The Active 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 racer GigE...
  • Page 206 Standard Features AW00118302000 Basler racer GigE...

  • Page 207: Chunk Features

    “chunk” features. Before you can use any of the features that add chunks to the frames, you must make the chunk mode active. Making the chunk mode active is described in the next section. Basler racer GigE...

  • Page 208: Making The "Chunk Mode" Active And Enabling The Extended Data Stamp

    Also note that when you enable ChunkModeActive, the PayloadType for the camera changes from "Pylon::PayloadType_Image" to "Pylon::PayloadType_ChunkData". For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 209 = Camera.ChunkDynamicRangeMax.GetValue(); ChunkPixelFormatEnums pixelFormat = Camera.ChunkPixelFormat.GetValue(); For more information about using the chunk parser, see the sample code that is included with the Basler pylon Software Development Kit (SDK). For more information about the pylon Viewer, see Section 3.1 on page...

  • Page 210: Frame Counter

    // make chunk mode active and enable Frame Counter chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Framecounter ); Camera.ChunkEnable.SetValue( true ); // retrieve date from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Basler racer GigE...
  • Page 211 Chunk Features Result.GetPayloadSize() ); int64_t frameCounter = Camera.ChunkFramecounter.GetValue(); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 212 Chunk Features AW00118302000 For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. Basler racer GigE...

  • Page 213: Time Stamp

    // make chunk mode active and enable Time Stamp chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_Timestamp ); Camera.ChunkEnable.SetValue( true ); // retrieve data from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Basler racer GigE...
  • Page 214 AW00118302000 Result.GetPayloadSize() ); int64_t timeStamp = Camera.ChunkTimestamp.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. For more information about the pylon Viewer, see Section 3.1 on...

  • Page 215: Trigger Counters

    Typically, this will happen if you attempt to trigger the start of a new frame while the camera is currently in the process of acquiring a frame. Basler racer GigE...
  • Page 216 You can set the Chunk Selector and Chunk Enable parameter value from within your application software by using the pylon API. The following code snippet illustrates using the API to activate the chunk mode and enable the trigger counter chunks: // make chunk mode active Camera.ChunkModeActive.SetValue( true ); Basler racer GigE...
  • Page 217 FTCounter = Camera.ChunkFrameTriggerCounter.GetValue(); int64_t FPTCounter = Camera.ChunkFramesPerTriggerCounter.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 218: Encoder Counter

    // make chunk mode active and enable Encoder Counter chunk Camera.ChunkModeActive.SetValue( true ); Camera.ChunkSelector.SetValue( ChunkSelector_ChunkShaftEncoderCounter ); Camera.ChunkEnable.SetValue( true ); // retrieve date from the chunk IChunkParser &ChunkParser = *Camera.CreateChunkParser(); GrabResult Result; StreamGrabber.RetrieveResult( Result ); ChunkParser.AttachBuffer( (unsigned char*) Result.Buffer(), Result.GetPayloadSize() ); int64_t EncoderCounter = Camera.ChunkShaftEncoderCounter.GetValue(); Basler racer GigE...
  • Page 219 AW00118302000 Chunk Features For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters. Basler racer GigE...

  • Page 220: Input Line Status At Line Trigger

    Use the Chunk Enable parameter to set the value of the chunk to true.  Once the input status at line trigger chunk is enabled, the camera will add an input status at line trigger chunk to each acquired frame. Basler racer GigE...
  • Page 221 = int(Camera.ChunkInputStatusAtLineTriggerValue.GetValue()); printf("State of inputs at line %d: %X\n", i, value); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.

  • Page 222: Crc Checksum

    API to activate the chunk mode, enable the CRC checksum chunk, run the parser, and retrieve the frame counter chunk data: // Make chunk mode active and enable CRC chunk Camera.ChunkModeActive.SetValue( true ); Basler racer GigE...
  • Page 223 ( ChunkParser.HasCRC() && ! ChunkParser.CheckCRC() ) cerr << "Image corrupted!" << endl; For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
  • Page 224 Chunk Features AW00118302000 Basler racer GigE...

  • Page 225: Troubleshooting And Support

    During camera reset, camera power stays on. This is in contrast to camera restart where camera power is switched off and on again. From the perspective of the Basler pylon software and the operating system, camera reset and camera restart both appear as a "surprise device removal" and must be handled accordingly.

  • Page 226: Tech Support Resources

    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 227 How often did/does the problem Once. Every time. occur? Regularly when: Occasionally when: How severe is the problem? Camera can still be used. Camera can be used after I take this action: Camera can no longer be used. Basler racer GigE...
  • Page 228 Did your application ever run without problems? 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.

  • Page 229: Revision History

    AW00118302000 Revision History Revision History Doc. ID Number Date Changes AW00118301000 20 Jun 2012 Preliminary release of this document. Applies to prototype cameras only. AW00118302000 26 Jun 2013 First release of this document for series cameras. Basler racer GigE...
  • Page 230 ExposureOverhead parameter in Section 8.5 on page 135. Added the "Removing the Parameter Limits for the ExposureOverhead Basler racer GigE Parameter" section 8.5.1 and related information in Section 8.5 on page 135.
  • Page 231 AW00118302000 Revision History Basler racer GigE...
  • Page 232 Revision History AW00118302000 Basler racer GigE...
  • Page 233 ....190 chunk features, explained ......197 device user ID parameter .......190 chunk frame counter parameter .....200 device vendor name parameter....190 chunk frame trigger counter parameter ..207 device version parameter .......190 digital gain ........164, 168 Basler racer GigE...
  • Page 234 ......198 I/O line response time ......73 filter driver ..........25 image area of interest ......75, 169 F-mount adapter ........11 input lines frame counter ......... 200 checking the state ......71, 210 frame counter chunk debouncer ..........61 reset ..........201 Basler racer GigE...
  • Page 235 LUT index parameter......176 parameter limits, removing .....168 LVTTL............60 parameter sets ........193 parameter sets, saving ......194 parameters loaded at startup ....195 partial closing frame parameter....84 M42-mount adapter ........11 payload size parameter ......37 marker hole ..........9 performance driver ........25 Basler racer GigE...
  • Page 236 ....216 RMA number ..........216 RS-422 .............57 technical support........216 bus .............58 temperature, housing .......16 RS-644 LVDS ..........59 termination resistor ......58, 61 test images..........187 time stamp ..........203 timed exposure time control mode ...90, 131 Basler racer GigE...
  • Page 237 ....68, 70 user shading set file .......180 ventilation ..........16 viewer ............23 voltage requirements LVTTL ..........60 weight ..........3, 4, 5 width parameter........75 write timeout parameter......35 YUV 422 (YUYV) packed pixel data format .............159 YUV 422 packed pixel data format..157 Basler racer GigE...
  • Page 238 Index AW00118302000 Basler racer GigE...

Table of Contents