1. DL manuals
  2. Basler
  3. Digital Camera
  4. GigE VISION CAMERAS
  5. User Manual

Basler GigE VISION CAMERAS User Manual

Manual is about: GigE VISION CAMERAS

Summary of GigE VISION CAMERAS

  • Page 1

    Basler racer user’s manual for gige vision cameras document number: aw001183 version: 03 language: 000 (english) release date: 13 september 2013 note that the 6k, 8k, and 12k cameras are still in their prototype stage dr af t.

  • Page 2

    For customers in the u.S.A. This equipment has been tested and found to comply with the limits for a class a digital device, pursuant to part 15 of the fcc rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial en...

  • 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 ...

  • Page 5

    Aw00118303000 table of contents basler racer gige i table of contents 1 specifications, requirements, and precautions . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ....

  • Page 6

    Table of contents aw00118303000 ii basler racer gige 7.2 connector pin assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 7.2.1 pin assignments for the 6-pin connector . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 7.2.2 pin assignments...

  • Page 7

    Aw00118303000 table of contents basler racer gige iii 8.2.3.3 setting the frame start trigger parameters . . . . . . . . . . . . . . . . 85 8.2.3.4 frame timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 8.2.4 line start triggering. . . . . . . . . . . . . . . . ...

  • Page 8

    Table of contents aw00118303000 iv basler racer gige 10.3.1 setting the image aoi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 10.3.2 automatic image aoi x centering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 10.4 event reporting . . ....

  • Page 9: And Precautions

    Aw00118303000 specifications, requirements, and precautions basler racer gige 1 1 specifications, requirements, and precautions this chapter lists the camera models covered by the manual. It provides the general specifications for those models and the basic requirements for using them. This chapter ...

  • Page 10: 1.2

    Specifications, requirements, and precautions aw00118303000 2 basler racer gige 1.2 general specifications specification ral2048-48gm ral4096-24gm sensor size (maximum resolution) 2048 pixels 4096 pixels sensor type awaiba dr-2k-7 monochrome linear cmos awaiba dr-4k-7 monochrome linear cmos pixel si...

  • Page 11

    Aw00118303000 specifications, requirements, and precautions basler racer gige 3 weight ~ 240 g (typical) without lens adapter ~ 270 g (typical) with c-mount lens adapter and connectors ~ 330 g (typical) with f-mount lens adapter and connectors ~ 260 g (typical) with m42-mount lens adapter and connec...

  • Page 12

    Specifications, requirements, and precautions aw00118303000 4 basler racer gige specification ral6144-16gm ral8192-12gm sensor size (maximum resolution) 6144 pixels 8192 pixels sensor type awaiba dr-6k-7 monochrome linear cmos awaiba dr-8k-3.5 monochrome linear cmos pixel size 7 µm x 7 µm 3.5 µm x 3...

  • Page 13

    Aw00118303000 specifications, requirements, and precautions basler racer gige 5 specification ral12288-8gm sensor size (maximum resolution) 12288 pixels sensor type awaiba dr-12k-3.5 monochrome linear cmos pixel size 3.5 µm x 3.5 µm max line rate 8 khz min line rate no minimum when an external line ...

  • Page 14: 1.3

    Specifications, requirements, and precautions aw00118303000 6 basler racer gige 1.3 spectral response the following graph shows the quantum efficiency curve for monochrome cameras. Fig. 1: quantum efficiency of the monochrome sensor in 12 bit depth mode (based on sensor vendor information) the quant...

  • Page 15: 1.4

    Aw00118303000 specifications, requirements, and precautions basler racer gige 7 1.4 mechanical specifications 1.4.1 camera dimensions and mounting points the cameras are manufactured with high precision. Planar, parallel, and angular sides guarantee precise mounting with high repeatability. The came...

  • Page 16

    Specifications, requirements, and precautions aw00118303000 8 basler racer gige fig. 2: mechanical dimensions (in mm) 43 14.3 4.3 20 24 .0 2 62 49.5 49 6.5 36.12 42.42 8 x m4; 6.3 deep photosensitive surface of the sensor. 4 x m4; 6.3 deep 43 49 ø 47 35.39 17.69 4 x m2.5; 3.3 deep not to scale ø 53 ...

  • Page 17: 1.4.2

    Aw00118303000 specifications, requirements, and precautions basler racer gige 9 1.4.2 sensor line location the location of the sensor line in the mono cameras is shown in fig. 3 . The sensor lines of different camera models vary in length, depending on maximum resolution and pixel size. As an exampl...

  • Page 18: 1.4.3

    Specifications, requirements, and precautions aw00118303000 10 basler racer gige 1.4.3 lens adapter dimensions fig. 4: c-mount adapter on a racer gige camera; dimensions in mm 17.526 photosensitive surface of the sensor 3 not to scale 50.83 62 56 42.42 36.12 ø 53 ø 51.2 5.5 8.41 ø 30 ± 0. 05.

  • Page 19

    Aw00118303000 specifications, requirements, and precautions basler racer gige 11 fig. 5: f-mount adapter on a racer gige camera; dimensions in mm fig. 6: m42 x 1.0 or m42 x 0.75 mount adapter on a racer gige camera; dimensions in mm photosensitive surface of the sensor 5.5 not to scale 3 36.12 42.42...

  • Page 20: 1.4.4

    Specifications, requirements, and precautions aw00118303000 12 basler racer gige 1.4.4 selecting the optimum lens adapter the camera’s scope of delivery does not include a lens mount adapter. It is needed to attach a lens to a camera. You must order a lens adapter separately as an accessory. The opt...

  • Page 21: 1.5

    Aw00118303000 specifications, requirements, and precautions basler racer gige 13 1.5 software licensing information 1.5.1 lwip tcp/ip licensing the software in the camera includes the lwip tcp/ip implementation. The copyright information for this implementation is as follows: copyright (c) 2001, 200...

  • Page 22: 1.5.2

    Specifications, requirements, and precautions aw00118303000 14 basler racer gige 1.5.2 lz4 licensing the software in the camera includes the lz4 implementation. The copyright information for this implementation is as follows: lz4 - fast lz compression algorithm copyright (c) 2011-2013, yann collet. ...

  • Page 23: 1.6

    Aw00118303000 specifications, requirements, and precautions basler racer gige 15 1.6 avoiding emi and esd problems the cameras are frequently installed in industrial environments. These environments often include devices that generate electromagnetic interference (emi) and they are prone to electros...

  • Page 24: 1.7

    Specifications, requirements, and precautions aw00118303000 16 basler racer gige 1.7 environmental requirements 1.7.1 temperature and humidity housing temperature during operation: 0 °c ... +50 °c (+32 °f ... +122 °f) humidity during operation: 20 % ... 80 %, relative, non-condensing storage tempera...

  • Page 25: 1.8

    Aw00118303000 specifications, requirements, and precautions basler racer gige 17 1.8 precautions notice avoid dust on the sensor. The camera is shipped with a protective plastic seal on the camera front. To avoid collecting dust on the camera’s sensor, make sure that you always put the protective se...

  • Page 26

    Specifications, requirements, and precautions aw00118303000 18 basler racer gige warranty precautions to ensure that your warranty remains in force: do not remove the camera’s serial number label if the label is removed and the serial number can’t be read from the camera’s registers, the warranty is...

  • Page 27

    Aw00118303000 specifications, requirements, and precautions basler racer gige 19 to clean the surface of the camera housing, use a soft, dry cloth. To remove severe stains, use a soft cloth dampened with a small quantity of neutral detergent, then wipe dry. Do not use solvents or thinners to clean t...

  • Page 28

    Specifications, requirements, and precautions aw00118303000 20 basler racer gige.

  • Page 29: 2 Software and Hardware

    Aw00118303000 software and hardware installation basler racer gige 21 2 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 the basler pylon camera software suite (aw000611xx000). You...

  • Page 30

    Software and hardware installation aw00118303000 22 basler racer gige.

  • Page 31: 3 Tools For Changing Camera

    Aw00118303000 tools for changing camera parameters basler racer gige 23 3 tools for changing camera parameters this chapter explains the options available for changing the camera’s parameters. The available options let you change parameters either by using stand-alone tools that access the camera vi...

  • Page 32: 3.3

    Tools for changing camera parameters aw00118303000 24 basler racer gige 3.3 the pylon sdk the pylon sdk is part of the basler pylon camera software suite. The pylon sdk includes the pylon api, a set of sample programs, and documentation: you can access all of the camera’s parameters and control the ...

  • Page 33: Parameters

    Aw00118303000 basler network drivers and parameters basler racer gige 25 4 basler network drivers and parameters this section describes the basler network drivers available for your camera and provides detailed information about the parameters associated with the drivers. Two network drivers are ava...

  • Page 34: 4.1

    Basler network drivers and parameters aw00118303000 26 basler racer gige 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. F...

  • Page 35: 4.2

    Aw00118303000 basler network drivers and parameters basler racer gige 27 4.2 the basler performance driver the basler performance driver is a hardware specific gige vision network driver compatible with network adapters that use specific intel chipsets. The main advantage of the performance driver i...

  • Page 36

    Basler network drivers and parameters aw00118303000 28 basler racer gige 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...

  • Page 37

    Aw00118303000 basler network drivers and parameters basler racer gige 29 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 th...

  • Page 38

    Basler network drivers and parameters aw00118303000 30 basler racer gige 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 no...

  • Page 39

    Aw00118303000 basler network drivers and parameters basler racer gige 31 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 timeou...

  • Page 40

    Basler network drivers and parameters aw00118303000 32 basler racer gige 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 inclu...

  • Page 41

    Aw00118303000 basler network drivers and parameters basler racer gige 33 (10) end of the frame. (11) missing packets at the end of the frame (2999 and 3000). (12) interval defined by the packet timeout parameter. You can set the performance driver parameter values from within your application softwa...

  • Page 42

    Basler network drivers and parameters aw00118303000 34 basler racer gige 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...

  • Page 43: 4.3

    Aw00118303000 basler network drivers and parameters basler racer gige 35 4.3 transport layer parameters the transport layer parameters are part of the camera’s basic gige implementation. These parameters do not normally require adjustment. Read timeout - if a register read request is sent to the cam...

  • Page 44

    Basler network drivers and parameters aw00118303000 36 basler racer gige.

  • Page 45: 5 Network Related Camera

    Aw00118303000 network related camera parameters and managing bandwidth basler racer gige 37 5 network related camera parameters and managing bandwidth this section describes the camera parameters that are related to the camera’s performance on the network. It also describes how to use the parameters...

  • Page 46

    Network related camera parameters and managing bandwidth aw00118303000 38 basler racer gige the packet size parameter should always be set to the maximum size that your network adapter and network switches (if used) can handle. Inter-packet delay (read/write) sets the delay in ticks between the pack...

  • Page 47: 5.2

    Aw00118303000 network related camera parameters and managing bandwidth basler racer gige 39 5.2 managing bandwidth when multiple cameras share a single network path if you are using a single camera on a gige network, the problem of managing bandwidth is simple. The network can easily handle the band...

  • Page 48: 5.2.1

    Network related camera parameters and managing bandwidth aw00118303000 40 basler racer gige transmission rate will be. After you have adjusted the inter-packet delay parameter on each camera, you can check the sum of the bandwidth assigned parameter values and see if the sum is now less than 125 mby...

  • Page 49

    Aw00118303000 network related camera parameters and managing bandwidth basler racer gige 41 step 2 - set the packet size parameter on each camera as large as possible. Using the largest possible packet size has two advantages, it increases the efficiency of network transmissions between the camera a...

  • Page 50

    Network related camera parameters and managing bandwidth aw00118303000 42 basler racer gige step 3 - set the bandwidth reserve parameter for each camera. The bandwidth reserve parameter setting for a camera determines how much of the bandwidth assigned to that camera will be reserved for lost packet...

  • Page 51

    Aw00118303000 network related camera parameters and managing bandwidth basler racer gige 43 step 5 - calculate “data bandwidth assigned” to each camera. For each camera, there is a parameter called bandwidth assigned. This read only parameter indicates the total bandwidth that has been assigned to t...

  • Page 52

    Network related camera parameters and managing bandwidth aw00118303000 44 basler racer gige step 7 - check that the total bandwidth assigned is less than the network capacity. 1. For each camera, determine the current value of the bandwidth assigned parameter. The value is in byte/s. (make sure that...

  • Page 53: 6 Camera Functional

    Aw00118303000 camera functional description basler racer gige 45 6 camera functional description this chapter provides an overview of the camera’s functionality from a system perspective. The overview will aid your understanding when you read the more detailed information included in the later chapt...

  • Page 54

    Camera functional description aw00118303000 46 basler racer gige 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. Cmos sensor analog processing digital processing pix...

  • Page 55

    Aw00118303000 camera functional description basler racer gige 47 fig. 12: camera block diagram sensor i/o pixel data pixel data exastrig, exfstrig, exlstrig expactive, frametrigwait, linetrigwait micro- controller control data frame data and control data ethernet network frame data control frame buf...

  • Page 56

    Camera functional description aw00118303000 48 basler racer gige.

  • Page 57: 7 Physical Interface

    Aw00118303000 physical interface basler racer gige 49 7 physical interface this chapter provides detailed information, such as pinouts and voltage requirements, for the physical interface on the camera. This information will be especially useful during your initial design-in process. 7.1 general des...

  • Page 58: 7.1.1

    Physical interface aw00118303000 50 basler racer gige 7.1.1 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 12 1 6 7 ...

  • Page 59: 7.2

    Aw00118303000 physical interface basler racer gige 51 7.2 connector pin assignments 7.2.1 pin assignments for the 6-pin connector the 6 pin connector is used to supply power to the camera. The pin assignments for the connector are shown in table 5. Pin designation 1 +12 vdc (- 10 %) to +24 vdc (+ 5 ...

  • Page 60: 7.2.2

    Physical interface aw00118303000 52 basler racer gige 7.2.2 pin assignments for the 12-pin connector the 12-pin connector is used to access the three physical input lines and two physical output lines on the camera. The pin assignments for the connector are shown in table 6. 7.2.3 pin assignments fo...

  • Page 61: 7.3

    Aw00118303000 physical interface basler racer gige 53 7.3 connector types 7.3.1 6-pin connector the 6-pin connector on the camera is a hirose micro receptacle (part number hr10a-7r-6pb) or the equivalent. The recommended mating connector is the hirose micro plug (part number hr10a-7p-6s) or the equi...

  • Page 62: 7.4

    Physical interface aw00118303000 54 basler racer gige 7.4 cabling requirements 7.4.1 power cable a single power cable is used to supply power to the camera. Dc ground and the camera housing (along with the shield contacts of all connectors) are connected within the camera (see fig. 15). The end of t...

  • Page 63: 7.4.2

    Aw00118303000 physical interface basler racer gige 55 7.4.2 i/o cable the end of the i/o cable that connects to the camera’s 12-pin connector must be terminated with a hirose micro plug (part number hr10a-10p-12s) or the equivalent. The cable must be wired as shown in fig. 16. The maximum length of ...

  • Page 64: 7.5

    Physical interface aw00118303000 56 basler racer gige 7.5 camera power camera power must be supplied to the 6-pin connector on the camera via a cable from your power supply. The nominal operating voltage of the camera is +12 vdc (± 10 %).The required operating voltage is +12 vdc (- 10 %) to +24 vdc ...

  • Page 65: 7.6

    Aw00118303000 physical interface basler racer gige 57 7.6 input and output lines 7.6.1 input lines the camera is equipped with three physical input lines designated as input line 1, input line 2, and input line 3. The input lines are accessed via the 12-pin connector on the back of the camera. The i...

  • Page 66

    Physical interface aw00118303000 58 basler racer gige the rs-422 standard allows devices to be used with a bus structure to form an interface circuit. So, for example, input line 1 on several different cameras can be connected via an rs-422 bus as shown in fig. 18. Fig. 18: rs-422 interface circuit ...

  • Page 67

    Aw00118303000 physical interface basler racer gige 59 using the inputs with rs-644 lvds the inputs on the camera can accept rs-644 low voltage differential signals (lvds). If you are supplying an rs-644 lvds signal to an input on the camera, the 120 ohm termination resistor on that input must be ena...

  • Page 68

    Physical interface aw00118303000 60 basler racer gige using the inputs with lvttl a camera input line can accept a low voltage ttl signal when the signal is input into the camera as shown in fig. 19. The following voltage requirements apply to the camera’s i/o input (pin 2 of the 12-pin connector): ...

  • Page 69

    Aw00118303000 physical interface basler racer gige 61 enabling and disabling the termination resistor you can select an input line and enable or disable the termination resistor on the line from within your application software by using the pylon api. The following code snippet illustrates using the...

  • Page 70

    Physical interface aw00118303000 62 basler racer gige 7.6.1.3 input line inverters you can set each individual input line to invert or not to invert the incoming electrical signal. To set the invert function on an input line: use the line selector to select an input line. Set the value of the line i...

  • Page 71

    Aw00118303000 physical interface basler racer gige 63 default input line selections by default: input line 1 is selected as the source signal for the camera’s line start trigger function. Input line 1 is also selected as the source signal for shaft encoder module phase a input. Input line 2 is selec...

  • Page 72: 7.6.2

    Physical interface aw00118303000 64 basler racer gige 7.6.2 output lines the camera is equipped with two physical output lines designated as output line 1 and output line 2. The output lines are accessed via the 12-pin connector on the back of the camera. The outputs are designed to transmit rs-422 ...

  • Page 73

    Aw00118303000 physical interface basler racer gige 65 using the outputs with rs-644 lvds you cannot directly use the rs-422 signal from a camera output line as an input to an rs-644 low voltage differential signal (lvds) receiver. However, if a resistor network is placed on the camera’s output as sh...

  • Page 74

    Physical interface aw00118303000 66 basler racer gige using the outputs with lvttl you can use a camera output line as an input to a low voltage ttl receiver, but only if the camera’s output signal is used as shown in fig. 22. In this situation, a low will be indicated by a camera output voltage nea...

  • Page 75

    Aw00118303000 physical interface basler racer gige 67 7.6.2.3 minimum output pulse width you can use the minimum output pulse width feature to ensure that even very narrow camera output signals, e.G. Signals originating from a shaft encoder, will reliably be detected by other devices. The minoutpuls...

  • Page 76

    Physical interface aw00118303000 68 basler racer gige 7.6.2.5 selecting the source signal for an output line to make a physical output line useful, you must select a source signal for the output line. The camera has the following standard output signals available that can be selected as the source s...

  • Page 77

    Aw00118303000 physical interface basler racer gige 69 camera.Lineselector.Setvalue( lineselector_out2 ); camera.Linesource.Setvalue( linesource_linetriggerwait );oookkk // select the shaft encoder module out signal for output line 1 camera.Lineselector.Setvalue( lineselector_out1 ); camera.Linesourc...

  • Page 78

    Physical interface aw00118303000 70 basler racer gige 7.6.2.6 setting the state of user settable output lines as mentioned in the previous section, you can select "user output" as the signal source for an output line. For an output line that has "user output" as the signal source, you can use camera...

  • Page 79: 7.6.3

    Aw00118303000 physical interface basler racer gige 71 fig. 23: user output value all parameter bits to set the state of multiple user output lines: use the user output value all parameter to set the state of multiple user outputs. You can set the user output value all parameter from within your appl...

  • Page 80: 7.6.4

    Physical interface aw00118303000 72 basler racer gige the state of the associated line is currently low. If a bit is 1, it indicates that the state of the associated line is currently high. Fig. 24: line status all parameter bits checking the state of a single output line you can determine the curre...

  • Page 81: 7.6.5

    Aw00118303000 physical interface basler racer gige 73 // 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 parameter...

  • Page 82

    Physical interface aw00118303000 74 basler racer gige.

  • Page 83: 8 Acquisition Control

    Aw00118303000 acquisition control basler racer gige 75 8 acquisition control this section provides detailed information about controlling the acquisition of image information. You will find details about triggering frame and line acquisition, about setting the exposure time for acquired lines, about...

  • Page 84

    Acquisition control aw00118303000 76 basler racer gige the height parameter determines the number of lines that will be included in each frame. For example, assume that the height parameter is set to 100 and that the camera has just started to acquire lines. In this case, the camera will accumulate ...

  • Page 85

    Aw00118303000 acquisition control basler racer gige 77 setting the frame parameters you can set the offset x, width, and height parameter values from within your application software by using the pylon api. The following code snippets illustrate using the api to get the maximum allowed settings and ...

  • Page 86: 8.2

    Acquisition control aw00118303000 78 basler racer gige 8.2 controlling acquisition five major elements are involved in controlling the acquisition of images: acquisition start and acquisition stop commands the acquisition mode parameter acquisition start triggering frame start triggering line start ...

  • Page 87

    Aw00118303000 acquisition control basler racer gige 79 setting the acquisition mode and issuing start/stop commands you can set the acquisition mode parameter value and you can issue acquisition start or acquisition stop commands from within your application software by using the pylon api. The code...

  • Page 88: 8.2.2

    Acquisition control aw00118303000 80 basler racer gige 8.2.2 acquisition start triggering the acquisition start trigger is used in conjunction with the frame start trigger to control the acquisition of frames. In essence, the acquisition start trigger is used as an enabler for the frame start trigge...

  • Page 89

    Aw00118303000 acquisition control basler racer gige 81 software - when the acquisition start trigger source is set to software, the user applies an acquisition start trigger to the camera by issuing an acquisition start triggersoftware command to the camera from the host pc. Line 1, line 2 or line 3...

  • Page 90

    Acquisition control aw00118303000 82 basler racer gige 8.2.2.4 setting the acquisition start trigger mode and related parameters you can set the trigger mode and trigger source parameter values for the acquisition start trigger and the acquisition frame count parameter value from within your applica...

  • Page 91: 8.2.3

    Aw00118303000 acquisition control basler racer gige 83 8.2.3 frame start triggering the frame start trigger is used in conjunction with the line start trigger to control the acquisition of the lines that will be included in each frame. In essence, the frame start trigger is an enabler for the line s...

  • Page 92

    Acquisition control aw00118303000 84 basler racer gige and will remain valid until enough lines have been acquired to constitute a complete frame. The frame start trigger will then become invalid. Line 1 - when the frame start trigger source is set to line 1, the user triggers frame start by applyin...

  • Page 93

    Aw00118303000 acquisition control basler racer gige 85 to see graphical representations of frame start triggering, refer to the use case diagrams in section 8.3 on page 121 . 8.2.3.3 setting the frame start trigger parameters you can set the trigger mode, trigger source, and trigger activation param...

  • Page 94

    Acquisition control aw00118303000 86 basler racer gige 8.2.3.4 frame timeout the frame timeout allows setting a maximum time (in microseconds) that may elapse for each frame acquisition, i.E. The maximum time for the acquisition of the lines for a frame. When the frame timeout is enabled and a time ...

  • Page 95: 8.2.4

    Aw00118303000 acquisition control basler racer gige 87 8.2.4 line start triggering the line start trigger is used to start a line acquisition. Keep in mind that the camera will only react to a line start trigger when the frame start trigger is valid. If the frame start trigger is invalid, line start...

  • Page 96

    Acquisition control aw00118303000 88 basler racer gige 8.2.4.2 line start trigger mode = on when the line start trigger mode parameter is set to on, you must select a source signal for the line start trigger. The line start trigger source parameter specifies the source signal. The available selectio...

  • Page 97

    Aw00118303000 acquisition control basler racer gige 89 exposure time control with line start trigger mode on when the line start trigger mode parameter is set to on, there are three modes available to control the exposure time for each acquired line: trigger width control, timed control, and control...

  • Page 98

    Acquisition control aw00118303000 90 basler racer gige timed exposure control mode when the timed exposure control mode is selected, the exposure time for each line acquisition is determined by the value of the camera’s exposure time parameters. If the camera is set for rising edge triggering, the e...

  • Page 99

    Aw00118303000 acquisition control basler racer gige 91 there is also a second component to the start and end delays. This second component is the debouncer setting for the input line. The debouncer setting for the input line must be added to the base start and end delays shown in table 8 to determin...

  • Page 100: 8.2.5

    Acquisition control aw00118303000 92 basler racer gige 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 vi...

  • Page 101

    Aw00118303000 acquisition control basler racer gige 93 maximum exposure time. Keep in mind, however, that using a very long exposure time can lead to significant degradation of the image quality. 8.2.5.2 exposure time parameters if you are operating the camera in either of the following ways, you mu...

  • Page 102

    Acquisition control aw00118303000 94 basler racer gige you can set the exposure time raw parameter value from within your application software by using the pylon api. The following code snippet illustrates using the api to set the parameter values: camera.Exposuremode.Setvalue( exposuremode_timed );...

  • Page 103: 8.2.6

    Aw00118303000 acquisition control basler racer gige 95 8.2.6 use case descriptions and diagrams the following pages contain a series of use case descriptions and diagrams. The descriptions and diagrams are designed to illustrate how acquisition start triggering, frame start triggering and line start...

  • Page 104

    Acquisition control aw00118303000 96 basler racer gige fig. 28: use case 1 - single frame mode with acquisition start, frame start, and line start triggering set to off time acquisition start command acquisition start command acquisition start trigger signal frame start trigger signal line start tri...

  • Page 105

    Aw00118303000 acquisition control basler racer gige 97 use case 2 - acquisition start, frame start, and line start triggering off (free run), continuous frame mode use case two is illustrated on page 98 . This use case is equivalent to the preceding use case one, except for the fact that the acquisi...

  • Page 106

    Acquisition control aw00118303000 98 basler racer gige fig. 29: use case 2 - continuous frame mode with acquisition start, frame start and line start triggering set to off time acquisition start command acquisition stop command frame start trigger signal line start trigger signal settings: acquisiti...

  • Page 107

    Aw00118303000 acquisition control basler racer gige 99 use case 3 - acquisition start and line start triggering off (free run), frame start triggering on use case three is illustrated on page 100 . In this use case, the acquisition start trigger mode and the line start trigger mode parameters are se...

  • Page 108

    Acquisition control aw00118303000 100 basler racer gige 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 time acquisition start command acquisition stop command frame start trigger signal line start trigger s...

  • Page 109

    Aw00118303000 acquisition control basler racer gige 101 use case 4 - acquisition start triggering off (free run), frame start and line start triggering on use case four is illustrated on page 102 . In this use case, the acquisition start trigger mode parameter is set to off. The camera will internal...

  • Page 110

    Acquisition control aw00118303000 102 basler racer gige 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 time acquisition start command acquisition stop command frame start trigger signal line start trigger s...

  • Page 111

    Aw00118303000 acquisition control basler racer gige 103 use case 5 - acquisition start triggering off (free run), frame start and line start triggering on, frame start trigger level high, partial closing frame false use case five is illustrated on page 104 . In this use case, the acquisition start t...

  • Page 112

    Acquisition control aw00118303000 104 basler racer gige 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 time acquisition start command acquisition stop command frame star...

  • Page 113

    Aw00118303000 acquisition control basler racer gige 105 use case 6 - acquisition start triggering off (free run), frame start and line start triggering on, frame start trigger level high, partial closing frame true use case six is illustrated on page 106 . This use case is equivalent to the precedin...

  • Page 114

    Acquisition control aw00118303000 106 basler racer gige 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 time acquisition start command acquisition stop command frame start...

  • Page 115

    Aw00118303000 acquisition control basler racer gige 107 use case 7 - acquisition start and frame start triggering off (free run), line start triggering on use case seven is illustrated on page 108 . This use case is equivalent to use case two, except for the fact that the line start trigger mode par...

  • Page 116

    Acquisition control aw00118303000 108 basler racer gige 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 time acquisition start command acquisition stop command frame start trigger signal line start trigger s...

  • Page 117

    Aw00118303000 acquisition control basler racer gige 109 use case 8 - acquisition start triggering on, frame start and line start triggering off (free run) use case eight is illustrated on page 110 . In this use case, the acquisition start trigger mode parameter is set to on, requiring that an acquis...

  • Page 118

    Acquisition control aw00118303000 110 basler racer gige 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 time acquisition start command acquisition stop command acquisition start trigger signal frame start tr...

  • Page 119

    Aw00118303000 acquisition control basler racer gige 111 use case 9 - acquisition start and line start triggering on, frame start triggering off (free run) use case nine is illustrated on page 112 . In this use case, the acquisition start trigger mode and the line start trigger mode parameters are se...

  • Page 120

    Acquisition control aw00118303000 112 basler racer gige 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 time settings: acquisition mode = continuous frame acquisition start trigger mode = on acquisition star...

  • Page 121: 8.2.7

    Aw00118303000 acquisition control basler racer gige 113 8.2.7 overlapping exposure with sensor readout the line acquisition process on the camera includes two distinct parts. The first part is the exposure of the pixels in the imaging sensor. Once exposure is complete, the second part of the process...

  • Page 122

    Acquisition control aw00118303000 114 basler racer gige determining whether your camera is operating with overlapped or non-overlapped exposure and readout is not a matter of issuing a command or switching a setting on or off. Rather the way that you operate the camera will determine whether the exp...

  • Page 123

    Aw00118303000 acquisition control basler racer gige 115 the line start trigger goes low to end the exposure for line acquisition n+1 before readout for acquisition n has ended (premature exposure end; see fig. 40 on page 116 ). This would result in the illegal overlap of two readouts (in trigger wid...

  • Page 124

    Acquisition control aw00118303000 116 basler racer gige fig. 40: exposure n+1 illegally ends before readout of the preceding line acquisition n has ended; applies to trigger width exposure mode only when the line start trigger has illegally gone low to end the exposure for line acquisition n+1 befor...

  • Page 125

    Aw00118303000 acquisition control basler racer gige 117 regular line acquisition avoiding overtriggering as mentioned above, you can avoid overtriggering by applying an acquisition-related trigger only when the camera is waiting for it. You can achieve this goal by making use of acquisition monitori...

  • Page 126

    Acquisition control aw00118303000 118 basler racer gige line acquisition while obeying timing limits when strictly obeying the following timing limits you can avoid overtriggering in "overlapped mode" and "non-overlapped mode" without having to monitor the camera’s acquisition status (see also fig. ...

  • Page 127

    Aw00118303000 acquisition control basler racer gige 119 fig. 42: relation of the exlstrig signal period and periods e and f for regular line acquisition in timed exposure mode fig. 43: relation of the exlstrig signal period and periods e and f for regular line acquisition in trigger width exposure m...

  • Page 128

    Acquisition control aw00118303000 120 basler racer gige example assume that you are using an ral2048-48gm camera at full resolution (2048 pixels), assume that you want to use the minimum allowed line acquisition period and the default value for c 1 . Also assume that the other relevant settings are ...

  • Page 129: 8.3

    Aw00118303000 acquisition control basler racer gige 121 8.3 acquisition monitoring tools the camera includes the acquisition status feature and generates four output signals that you can use to monitor the progress of line and frame acquisition by the camera: the exposure active signal, the acquisit...

  • Page 130: 8.3.1

    Acquisition control aw00118303000 122 basler racer gige 8.3.1 exposure active signal the camera’s exposure active output signal will go high when the exposure time for each line acquisition begins and goes low when the exposure time ends. An example of the exposure active signal’s behavior on a came...

  • Page 131: 8.3.2

    Aw00118303000 acquisition control basler racer gige 123 8.3.2 acquisition status indicator if a camera receives a software acquisition start trigger signal when it is not in a "waiting for acquisition start trigger" acquisition status, it will simply ignore the trigger signal and will generate an ac...

  • Page 132: 8.3.3

    Acquisition control aw00118303000 124 basler racer gige // check the line start trigger acquisition status // set the acquisition status selector camera.Acquisitionstatusselector.Setvalue ( acquisitionstatusselector_linetriggerwait ); // read the acquisition status bool iswaitingforlinetrigger = cam...

  • Page 133

    Aw00118303000 acquisition control basler racer gige 125 8.3.3.1 acquisition trigger wait signal as you are acquiring frames, the camera automatically monitors the acquisition start trigger status and supplies a signal that indicates the current status. The acquisition trigger wait signal will go hig...

  • Page 134

    Acquisition control aw00118303000 126 basler racer gige the acquisition trigger wait signal will only be available when hardware acquisition start triggering is enabled. Time = camera is in a "waiting for acquisition start trigger" status acq. Trigger wait signal line acquisition exp. Readout line a...

  • Page 135

    Aw00118303000 acquisition control basler racer gige 127 selecting the acquisition trigger wait signal as the source signal for the output line the acquisition trigger wait signal can be selected to act as the source signal for e.G. Camera output line 1. Selecting a source signal for the output line ...

  • Page 136

    Acquisition control aw00118303000 128 basler racer gige 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. The frame trigger wait signal will only be availa...

  • Page 137

    Aw00118303000 acquisition control basler racer gige 129 selecting the frame trigger wait signal as the source signal for the output line the frame trigger wait signal can be selected to act as the source signal for e.G. Camera output line 1. Selecting a source signal for the output line is a two ste...

  • Page 138

    Acquisition control aw00118303000 130 basler racer gige fig. 46 and fig. 48 illustrate the frame trigger wait signal with exposure and readout overlapped. The figures assume raising edge triggering and that the trigger mode for the acquisition start trigger and for the frame start trigger is set to ...

  • Page 139

    Aw00118303000 acquisition control basler racer gige 131 using the line trigger wait signal with the trigger width exposure mode when the camera is set for the trigger width exposure mode, the rise of the line trigger wait signal is based on the exposure overlap time max abs parameter setting and on ...

  • Page 140

    Acquisition control aw00118303000 132 basler racer gige 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...

  • Page 141: 8.4

    Aw00118303000 acquisition control basler racer gige 133 8.4 frame transmission time as mentioned in earlier sections of this chapter, each time that a complete frame has been accumulated in the camera’s frame memory, the frame will be transmitted from the camera to your host pc via the camera’s ethe...

  • Page 142: 8.5

    Acquisition control aw00118303000 134 basler racer gige 8.5 maximum allowed line acquisition rate in general, the maximum allowed line acquisition rate can be limited by three factors: the amount of time it takes to read an acquired line out of the imaging sensor and into the camera’s frame buffer. ...

  • Page 143

    Aw00118303000 acquisition control basler racer gige 135 factor 2: factor 2 is the exposure time. You can use the formula below to calculate the maximum line rate based on the exposure time for each acquired line: where the constant c 1 depends on the camera model and on whether the parameter limit i...

  • Page 144

    Acquisition control aw00118303000 136 basler racer gige once you have determined which factor is most restrictive on the line rate, you can try to make that factor less restrictive if possible: if you find that the sensor readout time is most restrictive factor, you cannot make any adjustments that ...

  • Page 145: 8.5.1

    Aw00118303000 acquisition control basler racer gige 137 factor 2, the exposure time, is the most restrictive factor. In this case, the exposure time setting is limiting the maximum allowed line rate to 5117 lines per second. If you wanted to operate the camera at a higher line rate, you would need t...

  • Page 146

    Acquisition control aw00118303000 138 basler racer gige removing the parameter limits to remove the limits for the exposureoverhead parameter: 1. Use the parameter selector to select the exposureoverhead parameter. 2. Set the value of the remove limits parameter. You can set the parameter selector a...

  • Page 147: 8.6

    Aw00118303000 acquisition control basler racer gige 139 8.6 the shaft encoder module the camera is equipped with a shaft encoder software module. The module can accept input from a two channel shaft encoder (phase a and phase b). The module outputs a signal that can be used, for example, as a source...

  • Page 148

    Acquisition control aw00118303000 140 basler racer gige note that if this interpretation of direction is not as you desire, you could change it by moving the phase a output from the shaft encoder to input line 2 and the phase b output to input line 1. Shaft encoder module parameters there are severa...

  • Page 149

    Aw00118303000 acquisition control basler racer gige 141 setting the shaft encoder module parameters to use the shaft encoder software module effectively, you should do the following: select a signal source for the phase a and phase b inputs on the module. (by default, input line 1 is selected as the...

  • Page 150

    Acquisition control aw00118303000 142 basler racer gige int64_t encodercountersize = camera.Shaftencodermodulecounter.Getvalue(); // reset the shaft encoder module counter and the shaft encoder module re- verse counter camera.Shaftencodermodulecounterreset.Execute( ); camera.Shaftencodermodulerevers...

  • Page 151

    Aw00118303000 acquisition control basler racer gige 143 case 1 this is the simplest case, i.E., the shaft encoder reverse counter max is set to zero. In this situation, the reverse counter never increments or decrements and it will have no effect on the operation of the encoder software module. When...

  • Page 152

    Acquisition control aw00118303000 144 basler racer gige case 2 in this case, assume that: a shaft encoder is attached to a conveyor belt that normally moves continuously in the forward direction past a camera. The conveyor occasionally "jitters" and when it jitters, it moves in reverse for 4 or 5 ti...

  • Page 153

    Aw00118303000 acquisition control basler racer gige 145 case 3 in this case, assume that: we are working with a small conveyor that moves back and forth in front of a camera. A shaft encoder is attached to the conveyor. The conveyor moves in the forward direction past the camera through its complete...

  • Page 154

    Acquisition control aw00118303000 146 basler racer gige 4 the conveyor reaches the end of its forward travel and it stops. Camera stop 5 the conveyor begins moving in reverse and the shaft encoder starts generating reverse ticks. The reverse counter will increment by 1 for each reverse tick. While t...

  • Page 155

    Aw00118303000 acquisition control basler racer gige 147 there are two main things to notice about this example. First, because the encoder mode is set to any direction, ticks from the shaft encoder will cause the module to output trigger signals regardless of the conveyor direction, as long as the r...

  • Page 156: 8.7

    Acquisition control aw00118303000 148 basler racer gige 8.7 frequency converter the camera is equipped with a frequency converter module that allows triggering the camera at a frequency that differs from the frequency of the input signals received. The module can accept input signals from one of the...

  • Page 157

    Aw00118303000 acquisition control basler racer gige 149 if for example a post-divider of 2 is selected only every other signal received from the multiplier module is passed out from the divider module and, accordingly, the frequency is halved. If a post-divider of 1 is selected every signal received...

  • Page 158

    Acquisition control aw00118303000 150 basler racer gige.

  • Page 159: 9 Pixel Data Formats

    Aw00118303000 pixel data formats basler racer gige 151 9 pixel data formats by selecting a pixel data format, you determine the format (layout) of the image data transmitted by the camera. This section provides detailed information about the available pixel data formats. 9.1 setting the pixel data f...

  • Page 160: 9.2

    Pixel data formats aw00118303000 152 basler racer gige 9.2 pixel data formats 9.2.1 mono 8 format when a monochrome camera is set for the mono 8 pixel data format, it outputs 8 bits of brightness data per pixel. The table below describes how the pixel data for a received frame will be ordered in the...

  • Page 161: 9.2.2

    Aw00118303000 pixel data formats basler racer gige 153 9.2.2 mono 12 format when a monochrome camera is set for the mono 12 pixel data format, it outputs 16 bits of brightness data per pixel with 12 bits effective. The 12 bits of effective pixel data fill from the least significant bit. The four unu...

  • Page 162

    Pixel data formats aw00118303000 154 basler racer gige when the camera is set for mono 12, the pixel data output is 16 bit data of the “unsigned short (little endian)” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. Note that fo...

  • Page 163: 9.2.3

    Aw00118303000 pixel data formats basler racer gige 155 9.2.3 mono 12 packed format when a monochrome camera is set for the mono 12 packed pixel data format, it outputs 12 bits of brightness data per pixel. Every three bytes transmitted by the camera contain data for two pixels. The table below descr...

  • Page 164

    Pixel data formats aw00118303000 156 basler racer gige when a monochrome camera is set for mono 12 packed, the pixel data output is 12 bit data of the “unsigned” type. The available range of data values and the corresponding indicated signal levels are as shown in the table below. This data value (h...

  • Page 165: 9.2.4

    Aw00118303000 pixel data formats basler racer gige 157 9.2.4 yuv 4:2:2 packed format when a monochrome camera is set for the yuv 4:2:2 packed pixel data format, the camera transmits y, u, and v values in a fashion that mimics the output from a color camera set for yuv 4:2:2 packed. The y value trans...

  • Page 166

    Pixel data formats aw00118303000 158 basler racer gige when the camera is set for yuv 4:2:2 packed output, the pixel data output for the y component is 8 bit data of the “unsigned char” type. The range of data values for the y component and the corresponding indicated signal levels are shown below. ...

  • Page 167: 9.2.5

    Aw00118303000 pixel data formats basler racer gige 159 9.2.5 yuv 4:2:2 (yuyv packed) format when a monochrome camera is set for the yuv 4:2:2 (yuyv) packed pixel data format, the camera transmits y, u, and v values in a fashion that mimics the output from a color camera set for yuv 4:2:2 (yuyv) pack...

  • Page 168

    Pixel data formats aw00118303000 160 basler racer gige when the camera is set for yuv 4:2:2 (yuyv) output, the pixel data output for the y component is 8 bit data of the “unsigned char” type. The range of data values for the y component and the corresponding indicated signal levels are shown below. ...

  • Page 169: 9.3

    Aw00118303000 pixel data formats basler racer gige 161 9.3 pixel transmission sequence for each acquired frame, pixel data is transmitted from the camera in the following sequence: where: row 0 col 0 is the upper left corner of the frame. The columns are numbered 0 through m from the left side to th...

  • Page 170

    Pixel data formats aw00118303000 162 basler racer gige.

  • Page 171: 10 Standard Features

    Aw00118303000 standard features basler racer gige 163 10 standard features this chapter provides detailed information about the standard features available on each camera. It also includes an explanation of their operation and the parameters associated with each feature. 10.1 gain and black level 10...

  • Page 172

    Standard features aw00118303000 164 basler racer gige 10.1.1.1 analog gain the camera’s analog gain is determined by the gain parameter with the gain selector set to analog all. All pixels in the sensor are affected by this setting. The allowed parameter values are 1 and 4. A parameter value of 1 co...

  • Page 173

    Aw00118303000 standard features basler racer gige 165 256 corresponds to 0 db and gain will not be modified and a parameter value of 2047 corresponds to 18.058 db and an amplification factor of approximately 7.996. You can use the formula below to calculate the db of gain that will result from the g...

  • Page 174: 10.1.2 Black Level

    Standard features aw00118303000 166 basler racer gige 10.1.1.3 using both analog gain and digital gain you can use analog gain and digital gain at the same time. In this case, the amplification factors will multiply. For example, if you set analog gain to an amplification factor of 4 and use an ampl...

  • Page 175

    Aw00118303000 standard features basler racer gige 167 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, se...

  • Page 176

    Standard features aw00118303000 168 basler racer gige 10.2 remove parameter limits for each camera feature, the allowed range of any associated parameter values is normally limited. The factory limits are designed to ensure optimum camera operation and, in particular, good image quality. For special...

  • Page 177: 10.3 Image Area of Interest

    Aw00118303000 standard features basler racer gige 169 10.3 image area of interest the image area of interest (image aoi) feature (aoi for short) lets you specify a portion of the sensor line. During operation, only the pixel information from the specified portion of the line is transmitted out of th...

  • Page 178: 10.3.2

    Standard features aw00118303000 170 basler racer gige 10.3.2 automatic image aoi x centering the image aoi feature includes center x capabilities. When center x is enabled, the camera will automatically center the image aoi on the sensor. Setting automatic x centering you can set the center x parame...

  • Page 179: 10.4 Event Reporting

    Aw00118303000 standard features basler racer gige 171 10.4 event reporting event reporting is available on the camera. With event reporting, the camera can generate an "event" and after some intermediate steps transmit a related event message to the pc whenever a specific situation has occurred. The...

  • Page 180

    Standard features aw00118303000 172 basler racer gige during the time that the camera is waiting for an acknowledgement, no new event messages can be transmitted. 4. Event reporting involves some further software-related steps and settings to be made. For more information, see the "camera events" co...

  • Page 181

    Aw00118303000 standard features basler racer gige 173 setting your system for event reporting event reporting must be enabled in the camera and some additional software-related settings must be made. This is described in the "camera events" code sample included with the pylon software development ki...

  • Page 182: 10.5 Luminance Lookup Table

    Standard features aw00118303000 174 basler racer gige 10.5 luminance lookup table the type of electronics used on the camera allow the camera’s sensor to acquire pixel values at a 12 bit depth. Normally, when a camera is set for a 12 bit pixel data format, the camera uses the actual 12 bit pixel val...

  • Page 183

    Aw00118303000 standard features basler racer gige 175 fig. 53: lookup table with values mapped in a linear fashion fig. 54: lookup table with values mapped for higher camera output at low sensor readings using the luminance lookup table to get 8 bit output as mentioned above, when the camera is set ...

  • Page 184

    Standard features aw00118303000 176 basler racer gige changing the values in the luminance lookup table and enabling the table you can change the values in the luminance lookup table (lut) and enable the use of the lookup table by doing the following: 1. Use the lut selector to select a lookup table...

  • Page 185: 10.6 Binning

    Aw00118303000 standard features basler racer gige 177 10.6 binning binning increases the camera’s response to light by summing the charges from adjacent pixels into one pixel. With horizontal binning, the charges of 2, 3, or a maximum of 4 adjacent pixels are summed and are reported out of the camer...

  • Page 186: 10.7 Gamma Correction

    Standard features aw00118303000 178 basler racer gige 10.7 gamma correction the gamma correction feature lets you modify the brightness of the pixel values output by the camera’s sensor to account for a non-linearity in the human perception of brightness. To accomplish the correction, a gamma correc...

  • Page 187: 10.8 Shading Correction

    Aw00118303000 standard features basler racer gige 179 10.8 shading correction two types of shading correction are available on the camera, offset shading correction and gain shading correction. You can set the camera to only perform offset shading correction, to only perform gain shading correction,...

  • Page 188: 10.8.3

    Standard features aw00118303000 180 basler racer gige 10.8.3 default shading set file and user shading set file for each type of shading correction, two types of shading set files are available in the camera’s nonvolatile memory: the first type of shading set file is called the "defaultshading" file...

  • Page 189

    Aw00118303000 standard features basler racer gige 181 creating a "usershading" file for offset shading correction to create a "usershading" file for offset shading correction, perform the following steps: 1. Adjust the lighting, optics, line rate, exposure time control mode, exposure time, gain, and...

  • Page 190

    Standard features aw00118303000 182 basler racer gige creating a "usershading" file for gain shading correction to create a "usershading" file for gain shading correction, perform the following steps: 1. Adjust the lighting, optics, line rate, exposure time control mode, exposure time, gain, and cam...

  • Page 191

    Aw00118303000 standard features basler racer gige 183 after 128 line acquisitions are completed the camera creates the "usershading" file automatically. The "usershading" file is stored in the camera’s non-volatile memory and is not lost if the camera power is switched off. 10.8.3.2 working with sha...

  • Page 192: 10.9 Trigger Delay

    Standard features aw00118303000 184 basler racer gige 10.9 trigger delay the trigger delay feature lets you specify a delay that will be applied between the receipt of a hardware acquisition start trigger or frame start trigger and it becoming effective. The trigger delay may be specified as a time ...

  • Page 193: 10.10 Error Codes

    Aw00118303000 standard features basler racer gige 185 10.10 error codes the camera can detect several user correctable errors. If one of these errors is present, the camera will set an error code and will flash both the yellow and green leds in the led indicator.: when the camera detects a user corr...

  • Page 194

    Standard features aw00118303000 186 basler racer gige 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. The following code snippets illustrat...

  • Page 195: 10.11Test Images

    Aw00118303000 standard features basler racer gige 187 10.11test images all cameras include the ability to generate test images. Test images are used to check the camera’s basic functionality and its ability to transmit an image to the host pc. Test images can be used for service purposes and for fai...

  • Page 196: 10.11.1Test Images In Detail

    Standard features aw00118303000 188 basler racer gige 10.11.1test images in detail test image 1 - fixed diagonal gray gradient (8 bit) the 8 bit fixed diagonal gray gradient test image is best suited for use when the camera is set for monochrome 8 bit output. The test image consists of fixed diagona...

  • Page 197

    Aw00118303000 standard features basler racer gige 189 test image 3 - moving diagonal gray gradient (12 bit) the 12 bit moving diagonal gray gradient test image is similar to test image 2, but it is a 12 bit pattern. The image moves by one pixel from right to left whenever a new frame acquisition is ...

  • Page 198

    Standard features aw00118303000 190 basler racer gige 10.12 device information parameters each camera includes a set of "device information" parameters. These parameters provide some basic information about the camera. The device information parameters include: device vendor name (read only) - indic...

  • Page 199

    Aw00118303000 standard features basler racer gige 191 pylon::string_t firmwareversion = camera.Devicefirmwareversion.Getvalue(); // read the device id parameter pylon::string_t deviceid = camera.Deviceid.Getvalue(); // write and read the device user id camera.Deviceuserid = "custom name"; pylon::str...

  • Page 200: 10.13 User Defined Values

    Standard features aw00118303000 192 basler racer gige 10.13 user defined values the camera can store two "user defined values". These two values are 32 bit signed integer values that you can set and read as desired. They simply serve as convenient storage locations for the camera user and have no im...

  • Page 201: 10.14 Configuration Sets

    Aw00118303000 standard features basler racer gige 193 10.14 configuration sets a configuration set is a group of values that contains all of the parameter settings needed to control the camera. There are three basic types of configuration sets: the active configuration set, the default configuration...

  • Page 202

    Standard features aw00118303000 194 basler racer gige default startup set you can select the default configuration set or one of the user configuration sets stored in the camera’s non-volatile memory to be the "default startup set." the configuration set that you designate as the default startup set...

  • Page 203: Set Into The Active Set

    Aw00118303000 standard features basler racer gige 195 10.14.2 loading a saved set or the default set into the active set if you have saved a configuration set into the camera’s non-volatile memory, you can load the saved set from the camera’s non-volatile memory into the camera’s active set. When yo...

  • Page 204

    Standard features aw00118303000 196 basler racer gige.

  • Page 205: 11 Chunk Features

    Aw00118303000 chunk features basler racer gige 197 11 chunk features this section provides detailed information about the chunk features available on each camera. 11.1 what are chunk features? In most cases, enabling a camera feature will simply change the behavior of the camera. The test image feat...

  • Page 206

    Chunk features aw00118303000 198 basler racer gige 11.2 making the "chunk mode" active and enabling the extended data stamp before you can use any of the camera’s "chunk" features, the "chunk mode" must be made active. Making the chunk mode active does two things: it automatically enables the extend...

  • Page 207

    Aw00118303000 chunk features basler racer gige 199 the following code snippet illustrates using the pylon api to run the parser and retrieve the extended image data: // retrieve data from the extended frame data chunk ichunkparser &chunkparser = *camera.Createchunkparser(); grabresult result; stream...

  • Page 208: 11.3 Frame Counter

    Chunk features aw00118303000 200 basler racer gige 11.3 frame counter the frame counter feature numbers frames sequentially as they are acquired. When the feature is enabled, a chunk is added to each completed frame containing the value of the counter. The frame counter is a 32 bit value. The counte...

  • Page 209

    Aw00118303000 chunk features basler racer gige 201 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 appli...

  • Page 210

    Chunk features aw00118303000 202 basler racer gige for detailed information about using the pylon api, refer to the basler pylon programmer’s guide and api reference. You can also use the basler pylon viewer application to easily set the parameters..

  • Page 211: 11.4 Time Stamp

    Aw00118303000 chunk features basler racer gige 203 11.4 time stamp the time stamp feature adds a chunk to each acquired frame. The chunk contains a time stamp that was generated when the frame start trigger for the frame became valid. Note that when the camera is set for continuous acquisition mode ...

  • Page 212

    Chunk features aw00118303000 204 basler racer gige 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...

  • Page 213: 11.5 Trigger Counters

    Aw00118303000 chunk features basler racer gige 205 11.5 trigger counters the camera has the following "trigger counters" available that can help you determine if you are triggering the camera correctly: the line trigger ignored counter the frame trigger ignored counter the line trigger end to end co...

  • Page 214

    Chunk features aw00118303000 206 basler racer gige line trigger end to end counter the line trigger end to end counter counts the number of line triggers received by the camera from the end of the previous frame acquisition to the end of the current frame acquisition. If you subtract the number of l...

  • Page 215

    Aw00118303000 chunk features basler racer gige 207 // enable the trigger counter chunks camera.Chunkselector.Setvalue( chunkselector_linetriggerignoredcounter ); camera.Chunkenable.Setvalue( true ); camera.Chunkselector.Setvalue( chunkselector_frametriggerignoredcounter ); camera.Chunkenable.Setvalu...

  • Page 216: 11.6 Encoder Counter

    Chunk features aw00118303000 208 basler racer gige 11.6 encoder counter the encoder counter chunk indicates the value of the shaft encoder module counter parameter at the time of the occurrence of a frame trigger. When the encoder counter chunk is enabled, a chunk is added to each frame containing t...

  • Page 217

    Aw00118303000 chunk features basler racer gige 209 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

    Chunk features aw00118303000 210 basler racer gige 11.7 input line status at line trigger the input status at line trigger feature samples the status of all of the camera’s input lines each time a line acquisition is triggered. It collects the input line status data for each acquired line in a chunk...

  • Page 219

    Aw00118303000 chunk features basler racer gige 211 to retrieve data from a chunk appended to an image that has been received by your pc, you must first run the image and its appended chunks through the chunk parser included in the pylon api. Once the chunk parser has been used, you can retrieve the ...

  • Page 220: 11.8 Crc Checksum

    Chunk features aw00118303000 212 basler racer gige 11.8 crc checksum the crc (cyclic redundancy check) checksum feature adds a chunk to each acquired frame containing a crc checksum calculated using the x-modem method. As shown in fig. 60 on page 212 , the checksum is calculated using all of the ima...

  • Page 221

    Aw00118303000 chunk features basler racer gige 213 camera.Chunkselector.Setvalue( chunkselector_payloadcrc16 ); camera.Chunkenable.Setvalue( true ); // check the crc checksum of an acquired frame ichunkparser &chunkparser = *camera.Createchunkparser(); grabresult result; streamgrabber.Retrieveresult...

  • Page 222

    Chunk features aw00118303000 214 basler racer gige.

  • Page 223: 12.1 Camera Reset

    Aw00118303000 troubleshooting and support basler racer gige 215 12 troubleshooting and support this chapter explains camera reset and outlines the resources available to you if you need help working with your camera. 12.1 camera reset some situations may require a camera reset. It is executed using ...

  • Page 224: 12.2 Tech Support Resources

    Troubleshooting and support aw00118303000 216 basler racer gige 12.2 tech support resources if you need advice about your camera or if you need assistance troubleshooting a problem with your camera, you can contact the basler technical support team for your area. Basler technical support contact inf...

  • Page 225

    Aw00118303000 troubleshooting and support basler racer gige 217 1 the camera’s product id: 2 the camera’s serial number: 3 network adapter that you use with the camera: 4 describe the problem in as much detail as possible: (if you need more space, use an extra sheet of paper.) 5 if known, what’s the...

  • Page 226

    Troubleshooting and support aw00118303000 218 basler racer gige 9 did your application ever run without problems? Yes no 10 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 ...

  • Page 227

    Aw00118303000 revision history basler racer gige 219 revision history doc. Id number date changes aw00118301000 20 jun 2012 preliminary release of this document. Applies to prototype cameras only. Aw00118302000 9 apr 2013 initial release for series cameras. Aw00118303000 13 sep 2013 updated the cont...

  • Page 228

    Revision history aw00118303000 220 basler racer gige.

  • Page 229

    Aw00118303000 index basler racer gige 221 index a acquisition frame count parameter ...........81 acquisition start overtrigger event ..........171 acquisition start trigger .......................78, 80 acquisition status indicator .....................123 acquisition status parameter ................

  • Page 230

    Index aw00118303000 222 basler racer gige dimensions ..................................... 2, 4, 5, 7 drivers, network........................................ 25 dsnu see offset shading correction dust .......................................................... 17 e earth ...............................

  • Page 231

    Aw00118303000 index basler racer gige 223 electrical characteristics .....................57 inverter ...............................................62 termination resistor.......................58, 61 input status at line trigger chunk.............210 installation hardware ............................

  • Page 232

    Index aw00118303000 224 basler racer gige pin assignments ................................. 51, 52 pin numbering .......................................... 50 pixel data formats................................... 151 mono 12 ........................................... 153 mono 12 packed ...............

  • Page 233

    Aw00118303000 index basler racer gige 225 torque maximum............................................12 transition threshold ...................................60 trigger acquisition start ..................................78 frame start ....................................78, 83 line start.............

  • Page 234

    Index aw00118303000 226 basler racer gige.