Page 1
Basler racer USER’S MANUAL FOR CAMERA LINK CAMERAS Document Number: AW001185 Version: 08 Language: 000 (English) Release Date: 29 April 2019...
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.
Page 3
Do not operate the camera in the vicinity of strong electromagnetic fields. Avoid electrostatic charging. Transport the camera in its original packaging only. Do not discard the packaging. All material in this publication is subject to change without notice and is copyright Basler AG.
Page 4
Contacting Basler Support Worldwide Europe, Middle East, Africa Basler AG An der Strusbek 60–62 22926 Ahrensburg Germany Tel. +49 4102 463 515 Fax +49 4102 463 599 support.europe@baslerweb.com The Americas Basler, Inc. 855 Springdale Drive, Suite 203 Exton, PA 19341 Tel.
This chapter also includes specific precautions that you should keep in mind when using the cameras. Basler strongly recommends that you read and follow the precautions. Intended Use Basler digital cameras for machine vision are designed exclusively for indoor professional image capture. Temperature and humidity requirements apply as detailed in Section 1.11 on page 21.
Models The current Basler racer Camera Link camera models are in the top row of the specification tables on the next pages of this manual. The camera models are differentiated by their resolution and their maximum line rate at full resolution.
+12 VDC (-10 %) to +24 VDC (+5 %), < 1 % ripple, supplied via the camera’s 6-pin connector. Power Consumption (typical, at 12 VDC) I/O Lines 4 input lines (CC1 to CC4) and 1 output line (via Camera Link spare bit) Table 1: General Specifications - 2k and 4k Mono Cameras Basler racer Camera Link...
Page 12
≈ 240 g (typical) with M58-mount lens adapter and connectors Conformity CE (includes RoHS), FCC, UL Listed, GenICam, Camera Link, IP30, REACH The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher)
Page 13
16 mm), M42x1.0-mount (FBD 45.56 mm), M58x0.75-mount (FBD 20 mm). Lens adapter must be ordered separately as an accessory. See Section 1.7.4 page 17 for information about selecting a suitable lens adapter for your camera. Table 2: General Specifications - 6k and 8k Mono Cameras Basler racer Camera Link...
Page 14
≈ 240 g (typical) with M58-mount lens adapter and connectors Conformity CE (includes RoHS), FCC, UL Listed, GenICam, Camera Link, IP30, REACH The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher)
Page 15
M42x1.0-mount (FBD 45.56 mm), M58x0.75-mount (FBD 20 mm). Lens adapter must be ordered separately as an accessory. See Section 1.7.4 on page 17 for information about selecting a suitable lens adapter for your camera. Table 3: General Specifications - 12k Mono Cameras Basler racer Camera Link...
Page 16
≈ 240 g (typical) with M58-mount lens adapter and connectors Conformity CE (includes RoHS), FCC, UL Listed, GenICam, Camera Link, IP30, REACH The CE Conformity Declaration is available on the Basler website: www.baslerweb.com Software Basler pylon Camera Software Suite (version 4.0 or higher)
Specifications, Requirements, and Precautions Accessories Fig. 1: Basler Accessories Basler’s cooperation with carefully selected suppliers means you get accessories you can trust which makes building a high-performance image processing system hassle-free. Key Reasons for Choosing Lenses, Cables, and Other Accessories from Basler Perfect match for Basler cameras ...
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. 2: Quantum Efficiency of the Monochrome Sensor in 12 Bit Depth Mode (Based on Sensor Vendor Information) Basler racer Camera Link...
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 adapter. Basler racer Camera Link...
Page 20
8 x M4; 6.3 deep (4 x M2; 5.5 deep) 27.11 7.51 21.09 (45°) 32.61 4 x M2.5; 3.3 deep ø (36.79) 4 x M4; 6.3 deep ø (14.82) Reference Plane Not to Scale Fig. 3: Mechanical Dimensions (in mm) Basler racer Camera Link...
Pixel 1 for 4k and 8k Cameras Pixel 1 for 6k and 12k Cameras Marker Hole Sensor Line Not to Scale Fig. 4: Mono Sensor Line Location with Approximate Starting Points (Pixel 1) for Pixel Numbering Basler racer Camera Link...
33.77 ø 17.526 Photosensitive Surface of the ø Sensor 51.2 8.41 Not to Scale Fig. 5: C-mount Adapter on a racer Camera Link Camera; Dimensions in mm 77.57 40.07 33.77 46.5 Photosensitive Surface of the Sensor 37.5 Not to Scale Fig.
Page 23
Surface of the Sensor M42 x 1.0 or M42 x 0.75 Not to Scale Fig. 7: M42 x 1.0 or M42 x 0.75 FBD 16 mm Mount Adapter on a racer Camera Link Camera; Dimensions in mm 76.63 40.07 33.77 ø...
Page 24
Specifications, Requirements, and Precautions 51.07 40.07 33.77 M58x0.75, 5 deep Photosensitive Surface of the Sensor ø Not to Scale Fig. 9: M58 x 0.75 Mount FBD 20 mm Adapter on a racer Camera Link Camera; Dimensions in mm Basler racer Camera Link...
• • • • 1) To ensure coverage of the entire sensor, contact Basler technical support for assistance when choosing a lens. • Table 4: Recommended Lens Adapters Depending on Camera Model ( = recommended, - = not recommended) 1.7.5 Attaching a Lens Adapter Use the four M2.5 setscrews supplied with the lens adapter to lock the lens adapter to the camera.
Specifications, Requirements, and Precautions Mechanical Stress Test Results racer cameras were submitted to an independent mechanical testing laboratory and subjected to the stress tests listed below. The mechanical stress tests were performed on selected camera models with standard housing. After mechanical testing, the cameras exhibited no detectable physical damage and produced normal images during standard operational testing.
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 Camera Link...
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 camera’s Downloads section of our website: www.baslerweb.com...
Overheating can only occur if heat dissipation is unusually restricted. 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 ...
Carry out a camera restart by switching power off and on again or Carry out a camera reset as described in Section 9.1 on page 147. Basler racer Camera Link...
To ensure that the snippets will work properly in your application, you must adjust them to meet your specific needs and must test them thoroughly prior to use. Basler racer Camera Link...
Page 32
You must avoid a voltage drop: If you supply camera power via a long cable a voltage drop can occur. Basler recommends that you provide +12 VDC to +24 VDC separately through the wires connecting to pins 1 and 2 of the receptacle. We also recommend that you provide ground separately to the wires connecting to pins 5 and 6.
The information you will need to install and operate the camera is included in the Installation and Setup Guide for Cameras Used with pylon for Windows (AW000611). You can download the document from the Downloads section of the Basler website: www.baslerweb.com...
The Basler pylon Camera Software Suite is available for Windows and Linux operating systems and is designed to operate all Basler cameras that have an IEEE 1394 interface, a GigE interface or a USB 3.0 interface. It will also operate some newer Basler camera models with a Camera Link interface.
3.1.1 pylon Viewer The pylon Viewer is included in the Basler pylon Camera Software Suite. It is a standalone application that lets you view and change most of the camera’s parameter settings via a GUI. Using the pylon Viewer is a very convenient way to get your camera up and running quickly during your initial camera evaluation or a camera design-in for a new project.
Camera Drivers and Tools for Changing Camera Parameters Basler Binary Protocol Library Basler racer Camera Link cameras have blocks of mapped memory space known as registers. By reading values from the registers, you can determine basic information about the camera and information about the camera’s current settings.
Camera Link tap geometries. The user can also select from several available pixel clock speeds for the Camera Link interface. See Section 8.1 on page 100 for more information about selecting the pixel clock speed. Basler racer Camera Link...
Page 38
Fig. 10: 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 Camera Link...
Page 39
AW00118508000 Camera Functional Description Camera Image Data Camera Digitized Sensor FPGA Link Pixel Image Interface Data Frame Data Grabber Serial Port Control Control Micro- Controller Control Data Fig. 11: Camera Block Diagram Basler racer Camera Link...
Many tasks, however, can be programmed more conveniently with fewer lines of code when employing the Instant Camera classes, provided by the Basler pylon C++ API. For information about the Instant Camera classes, see the C++ Programmer’s Guide and Reference Documentation delivered with the Basler...
Page 41
6-pin Receptacle Functional Earth (Power) Connection 26-pin SDR Connector (Base Camera Link Connection; Power and Data) 26-pin SDR Connector (Medium/Full Camera Link Connection; Data) LED Indicator Fig. 12: Camera Connectors and LED Indicator Basler racer Camera Link...
The camera‘s required operating voltage is +12 VDC (-10 %) to +24 VDC (+5 %), effective on the camera‘s connector. Applying power with the wrong polarity can severely damage the camera. Make sure that the polarity of the power applied to the camera is correct. Basler racer Camera Link...
SDR connector and in Table 8 on page 37 for the medium/full Camera Link SDR connector. A suitable cable is available from Basler. See the Basler website for information about cable characteristics. For voltage requirements of camera power, see Section 5.4 on page...
Page 44
CC4- * Pins 1 and 26 are tied together in the camera. ** Pins 13 and 14 are tied together in the camera. Table 7: Pin Assignments and Numbering for the Base Configuration 26-pin SDR Connector Basler racer Camera Link...
Page 45
ZClk+ * Pins 1 and 26 are tied together in the camera. ** Pins 13 and 14 are tied together in the camera. Table 8: Pin Assignments and Numbering for the Medium/Full Configuration 26-pin SDR Connector Basler racer Camera Link...
Close proximity to strong electromagnetic fields should be avoided. For more information about avoiding EMI and ESD, see Section 1.10 on page Suitable cables are available from Basler. See the Basler website for information about cable characteristics, available Models and how to obtain them. NOTICE An incorrect plug can damage the 6-pin connector.
Generally, Camera Link cables of up to 10 m length can be used for Camera Link cameras. However, when operating cameras at pixel clock speeds of 65 MHz and above, Basler strongly recommends to use shorter cables in accord with Fig.
If you are supplying power to the camera via the Camera Link connection (PoCL), be sure that the power to the camera and to the frame grabber in your computer is switched off before you connect or disconnect the Camera Link cables. Basler racer Camera Link...
The plug for the 6-pin connector is the last plug that you plug into the camera when making connections. The plug for the 6-pin connector is the first plug that you unplug from the camera when breaking connections. Basler racer Camera Link...
5.4.4 LED Indicator The LED indicator on the back of the camera signals whether power is present and also provides some basic error indications for the camera. For more information, see Section 8.10 on page 134. Basler racer Camera Link...
You can also obtain some general information about how these lines are implemented in the Camera Link interface from the Basler document racer Camera Link Information for Frame Grabber Designers (AW001187). You can obtain the document from the Basler website: www.baslerweb.com...
Page 52
2. Set the value of the LineDebouncerTimeAbs parameter. You can set the LineSelector and the LineDebouncerTimeAbs 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: // Select the CC1 line camera.LineSelector.SetValue(LineSelector_CC1);...
// Disable the inverter on the selected line camera.LineInverter.SetValue(false); 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...
For detailed information about selecting an input line as the source signal for the camera’s Line Start Trigger function, see Section 6.1 on page Default Input Line Selection Line CC1 is selected as the source signal for the camera’s Line Start Trigger function. Basler racer Camera Link...
Outputs As specified in the Camera Link standard, a "CL Spare" data bit is included in the Camera Link interface. On racer Camera Link cameras, the CL Spare data bit can be used as a camera output line. You can select any one of the camera’s standard output signals to act as the source signal for the CL Spare output line.
// 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.
You can set the CL Spare output line to invert or not to invert the input signal. Setting the CL Spare Output Line for Invert To set the invert function on the CL Spare output line using Basler pylon: 1. Use the LineSelector parameter to select CL Spare.
Page 58
// Disable the CL Spare output line camera.LineSelector.SetValue(LineSelector_CLSpare); camera.LineSource.SetValue(LineSource_Off); For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide and API Reference. You can also use the Basler pylon Viewer application to easily set the parameters.
= 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. To set the state of a single user output line via direct register access: Set the value of the User Output CL Spare register to 1 (True) or 0 (False) as desired.
You can set the LineSelector parameter and read the LineStatus parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set and read the parameter values: // Select the CC1 line and read the state camera.LineSelector.SetValue(LineSelector_CC1);...
All register. The register holds a 32 bit value that indicates the state of each I/O line. The mapping of the bits in the value to I/O lines is similar to the mapping described above for access via Basler pylon.
The parameter will indicate whether the logic is positive or negative. You can set the LineSelector parameter and read the LineLogic parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set and the parameter values: // Select the CC1 line and read the line logic type camera.LineSelector.SetValue(LineSelector_CC1);...
Many tasks, however, can be programmed more conveniently with fewer lines of code when employing the Instant Camera classes, provided by the Basler pylon C++ API. For information about the Instant Camera classes, see the C++ Programmer's Guide and Reference Documentation delivered with the Basler pylon Camera Software Suite.
Page 64
10000 µs Table 9: Minimum and Maximum Allowed Exposure Times 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.
In all cases, the exposure time for each line must be within the minimum and the maximum stated in Table 11 on page 65. This is true regardless of the method used to control exposure. Basler racer Camera Link...
// the acquisition line rate parameter allows the camera to control the line // rate internally. camera.AcquisitionLineRateEnable.SetValue(true); camera.AcquisitionLineRateAbs.SetValue(60.0); 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 Basler racer Camera Link...
Page 67
The time base on racer cameras is 100 ns. 4. For example, if you set the Exposure Time Raw register to 1000, the exposure time would be 100 µs (1000 x 100 ns = 100 µs).
ExposureMode parameter must be set to Timed. The exposure time for each acquired line will be determined by the value of the camera’s ExposureTimeAbs parameter if you are parameterizing the camera with Basler pylon or by the Exposure Time Raw register if you are parameterizing the camera via direct register access.
Page 69
Installation and Setup Guide for Cameras Used with Basler pylon for Windows (AW000611). Section 6.1.4.2 includes more detailed information about applying a software line start trigger signal to the camera using Basler pylon or via direct register access. Basler racer Camera Link...
You can set all of the parameters needed to perform software line start triggering from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values and execute the commands related to software line start triggering.
Page 71
The time base on racer cameras is 100 ns. For example, if you set the Exposure Time Raw register to 1000, the exposure time would be 100 µs (1000 x 100 ns = 100 µs).
To avoid overtriggering, you should not attempt to acquire lines at a rate that exceeds the maximum allowed with the current camera settings. For more information about determining the maximum allowed line rate with the current camera settings, see Section 6.4 on page Basler racer Camera Link...
10000 µs Table 11: Minimum and Maximum Allowed Exposure Times 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 74
(overtriggering), the trigger signal will be ignored. This situation is illustrated in Fig. 19 for rising edge triggering. This rise in the trigger signal will be ignored due to overtriggering ExLSTrig Signal Exposure (duration determined by the exposure time parameter or register setting) Fig. 19: Overtriggering with Timed Exposure Basler racer Camera Link...
Page 75
2.0 µs Table 12: Minimum Allowed Exposure Times 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. This is an artifact of a rounding error in the GenICam interface architecture.
You can set an ExposureOverlapTimeMaxAbs value in two ways: If you are parameterizing the camera with Basler pylon you must set the ExposureOverlapTimeMaxAbs parameter and if you are parameterizing the camera via direct register access you must set the value of the Exposure Overlap Time Max Raw register.
Page 77
// Line acquisition will start each time the externally generated // line start trigger signal (ExLSTrig signal)goes high You can also use the Basler pylon Viewer application to easily set the parameters. To set the parameters needed to perform hardware line start triggering via direct register access: 1.
Page 78
1.2 µs Table 13: Base Exposure Start and End Delays 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.
In the overlapped mode of operation, the exposure of a new line begins while the camera is still reading out the sensor data for the previously acquired line. This situation is illustrated in Fig. 22 with the camera set for the trigger width exposure mode. Basler racer Camera Link...
Page 80
You can read the ReadoutTimeAbs 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();...
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. 24 on page 74). This would result in the illegal overlap of two readouts (in trigger width exposure mode only). Basler racer Camera Link...
Page 82
N has ended (in trigger width exposure mode; see Fig. 24), the camera will behave as shown in Fig. 25: The camera will extend the exposure and end it when the next valid trigger for ending exposure occurs. Basler racer Camera Link...
As an example, and in the context of overlapped exposure, the use of the line trigger wait signal is described in Section 6.3.3 on page 82 for proper triggering with the line start trigger. Both timed and trigger width exposure mode are considered. Basler racer Camera Link...
Page 84
When you want to operate the camera at the maximum allowed line rate and have set the ExposureOverlapTimeMaxAbs parameter value to the appropriate value (see above) you can vary the exposure time E within the ranges indicated in Table 14 without having to adjust the ExposureOverlapTimeMaxAbs parameter value. Basler racer Camera Link...
Page 85
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 Camera Link...
Page 86
, the maximum possible exposure time is 7 µs. When also considering the above condition number one, it follows that the exposure time can range between 2 µs and 7 µs to be in accord with camera operation at a line rate of 80.6 kHz. Basler racer Camera Link...
Page 87
If you increase exposure times given in Table 14 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 Camera Link...
2. Set the value of the LineSource parameter to the exposure active output signal. You can set the LineSelector and the LineSource 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:...
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:...
For more information about selecting the source signal for the CL spare bit on the camera, see Section 5.5.2 on page Fig. 29 and Fig. 30 illustrate the Line Trigger Wait signal with exposure and readout overlapped. The figures assume raising edge triggering. Basler racer Camera Link...
Page 91
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. 29: Line Trigger Wait Signal with the Timed Exposure Mode Basler racer Camera Link...
Page 92
ExposureOverlapTimeMaxAbs value in order to control the Line Trigger Wait signal. You can do this in either of two ways: If you are parameterizing the camera with Basler pylon you must set the ExposureOverlapTimeMaxAbs parameter and if you are parameterizing the camera via direct register access you must set the value of the Exposure Overlap Time Max Raw register.
Page 93
Selecting the Line Trigger Wait Signal as the Source Signal for the CL Spare Output Line To select the line trigger wait signal as the source signal for the CL Spare line using Basler pylon: 1. Set the LineSelector parameter to the CL Spare output line.
For more information about selecting the source signal for the CL Spare output line on the camera, see Section 5.5.2.3 on page For more information about the minimum output pulse width feature, see Section 5.5.2.1 on page Basler racer Camera Link...
There are several ways that you can determine the maximum allowed acquisition line rate with your current camera settings: You can go to the Support section of the Basler website and use the online frame rate calculator: www.baslerweb.com...
Page 96
Acquisition Control Checking the Maximum Allowed Line Rate You can use the Basler pylon API to read the current value of the ResultingLineRateAbs parameter from within your application software using the Basler pylon API. The following code snippet illustrates using the API to get the parameter value: // Get the resulting line rate double resultingLps = camera.ResultingLineRateAbs.GetValue();...
3.4 µs 3.4 µs (Limit Removed From ExposureOverhead Parameter) For more information about setting the exposure time, see Section 6.1.5.3 on page For information about how to increase the exposure time see Section 6.4.2 on page Basler racer Camera Link...
Page 98
Max Lines/s = 80000 Factor 2 (exposure time): Max Lines/s ---------------------------------------- - 190 µs 5.4 µs Max Lines/s = 5117 Formula 3 (data transmission): × 32500000 4 Max Lines/s ------------------------------------ - × 2048 Max Lines/s = 62620 Basler racer Camera Link...
When the camera is set for the trigger width exposure mode, you can extend the ExLSTrig signal period according to the decrease of the exposure overhead time. To maintain the line rate, increase the ExposureOverlapTimeMaxAbs parameter value by the amount of time that was gained for exposure time. Basler racer Camera Link...
Page 100
// 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. For more information about the pylon API and the pylon Viewer, see Section 3.1 on...
10 Hz to 100 kHz. Basler recommends to only use low values for the pre-divider. The original signal frequency should be changed as little as possible to facilitate frequency adjustment by the multiplier mod- ule.
Page 102
Setting the Frequency Converter You can configure the frequency converter module from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter values: // Values for FrequencyConverterInputSource that might be available // (from _Basler***CameraParams.h where *** == ‘GigE’...
Page 103
3. If you want to perform signal alignment (see above) you can set the value of the Frequency Converter Signal Alignment register. 4. To avoid overtriggering, Basler recommends to set the Frequency Converter Prevent Overtrigger register to 1. 5. Set the desired frequency value of the Frequency Converter Multiplier register.
For a description of tap geometries and complete details regarding the way that pixel data is handled by the camera, refer to the Basler document named racer Camera Link Information for Frame Grabber Designers (AW001187). You can obtain the document from the camera’s Downloads section of the Basler website: www.baslerweb.com...
Page 105
// Set pixel format to Mono 12 camera.PixelFormat.SetValue(PixelFormat_Mono12); You can also use the Basler pylon Viewer application to easily set the parameter. For more information about the pylon API and the pylon Viewer, see Section 3.1 on page To set the sensor pixel format via direct register access: Set the value of the Pixel Format register to Mono 8, Mono 10, or Mono 12 as desired.
Link Connection) Fig. 31: Camera Link Connections For a description of tap geometries refer to the Basler document named racer Camera Link Information for Frame Grabber Designers (AW001187). You can obtain the document from the camera’s Downloads section of the Basler website: www.baslerweb.com...
// Set the tap geometry to 1X10 camera.ClTapGeometry.SetValue(ClTapGeometry_Geometry1X10); 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 To set the Camera Link tap geometry via direct register access: Set the value of the CL Tap Geometry register for 1X, 1X2, 1X4, 1X8 or 1X10 as desired.
Keep in mind that if you set the camera for one of the lower pixel clock speeds, it may limit the camera’s maximum allowed line acquisition rate. Basler racer Camera Link...
Page 109
API to set the clock speed to a value other then these, the camera will automatically round the setting down to the nearest valid speed. 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...
The allowed parameter values are 1 and 4. A parameter value of 1 corresponds to 0 dB and gain will not be modified. A parameter value of 4 corresponds to 12 dB and an amplification factor of 4. To set the analog gain using Basler pylon: 1. Set the GainSelector parameter to AnalogAll.
AW00118508000 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 API and the pylon Viewer, see Section 3.1 on...
For optimum image quality, Basler recommends to set the total amplification as low as possible. If you need an amplification factor larger than Basler recommends to set analog gain to 4 and then digital gain to reach the desired total amplification.
// Set BlackLevelRaw All camera.BlackLevelSelector.SetValue(BlackLevelSelector_All); camera.BlackLevelRaw.SetValue(64); 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 API and the pylon Viewer, see Section 3.1 on...
For example, on the raL2048-80km, the sum of the Offset X setting plus the Width setting must not exceed 2048. Depending on the selected Camera Link tap geometry, the following increments apply to offset X and width if horizontal binning is not enabled: Basler racer Camera Link...
Page 116
You can set the OffsetX and Width parameter values from within your application software by using the Basler pylon API. The following code snippets illustrate using the API to get the maximum allowed settings and the increments for the OffsetX and Width parameters. They also illustrate setting the OffsetX and Width parameter values.
Page 117
= camera.Width.GetMax(); int64_t widthInc = camera.Width.GetInc(); camera.Width.SetValue(24); 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 To set the AOI Offset X and Width parameter values via direct register access: 1.
On racer cameras, two auto functions are available: Gain Auto and Exposure Auto. By specifying a portion of the sensor line and a specific number of consecutive lines to be acquired, you can define an auto function area of interest (auto function AOI).
If you have set an auto function to "once" or "continuous" operation mode while the camera was continuously acquiring lines, the auto function will become effective with a short delay and the first few lines may not be affected by the auto function. Basler racer Camera Link...
For more information about setting the parameters, see Section 8.5.3.2 on page 115. Pixel Auto Function AOI Height Auto Auto Function AOI Function Offset X Image Auto Function AOI Width Fig. 34: Example Auto Function Area of Interest Basler racer Camera Link...
For details, see the sections below, describing the individual auto functions. Basler strongly recommends completely including the auto function AOI within the image AOIs, or, depending on your needs, choosing identical offsetsX and widths for auto function AOI and image AOIs.
Page 122
AW00118508000 Features Auto Function AOI Image AOIs Image AOIs Fig. 35: Various Degrees of Overlap Between the Auto Function AOI and the Image AOIs Basler racer Camera Link...
However, leave the Auto Function AOI 1 selected at all times and do not use the other auto function AOIs. You can set the parameter values for the auto function AOI from within your application software by using the Basler pylon API: // Select Auto Function AOI 1 camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI1);...
AW00118508000 Features camera.AutoFunctionAOIWidth.SetValue(500); camera.AutoFunctionAOIHeight.SetValue(300); 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 8.5.4 Gain Auto Gain Auto is the "automatic" counterpart to manually setting the GainRaw parameter. When the...
// exposure auto control.) camera.AutoTargetValue.SetValue(128); // Set the mode of operation for the gain auto function camera.GainAuto.SetValue(GainAuto_Continuous); You can also use the Basler pylon Viewer application to easily set the parameters. For general information about auto functions, see Section 8.5.1 on page 110.
Page 126
// Set the exposure time limits for exposure auto control camera.AutoExposureTimeAbsLowerLimit.SetValue(1000); camera.AutoExposureTimeAbsUpperLimit.SetValue(5000); // Set the target gray value for the exposure auto function // (If gain auto is enabled, this target is also used for // gain auto control.) Basler racer Camera Link...
// Set the mode of operation for the exposure auto function camera.ExposureAuto.SetValue(ExposureAuto_Continuous); You can also use the Basler pylon Viewer application to easily set the parameters. For information about the pylon API and the pylon Viewer, see Section 3.1 on page 26 ...
// Use Gain Auto and Exposure Auto simultaneously camera.AutoFunctionProfile.SetValue(AutoFunctionProfile_GainMinimum); camera.GainAuto.SetValue(GainAuto_Continuous); camera.ExposureAuto.SetValue(ExposureAuto_Continuous); 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 Basler racer Camera Link...
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 Camera Link...
Page 130
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 Camera Link...
Page 131
- i); // 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.
4 respectively. Setting the parameter’s value to 1 disables horizontal binning. You can set the BinningHorizontal parameter value from within your application software by using the Basler pylon API. The following code snippet illustrates using the API to set the parameter value: // Enable horizontal binning by 4 camera.BinningHorizontal.SetValue(4);...
1.2, for example, the gamma correction factor will be 1.2. You can set the GammaEnable 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 134
2. Set the value of the Gamma Selector register to User. 3. If the Gamma Selector is set to User, set the value in the Gamma register to the desired gamma value. For more information about direct register access, see Section 3.2 on page Basler racer Camera Link...
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 Camera Link...
8.9.3.1 Creating a "Usershading" File To create a "usershading" file and enable it, you must take the steps listed below. Basler strongly recommends that you read through all of the steps and read all of the other information in this section before you attempt to do shading correction.
Page 137
In this case, however, the "usershading" file will only apply to the narrower AOI or to smaller included AOIs. Basler recommends using the entire width of the sensor. 5. If you use Basler pylon, select Offset Shading in the Basler pylon Viewer or via the Basler pylon API.
Page 138
The Create value and the value of the Gain Shading Create register (see below) change to Off when the minimum number of line acquisitions is reached. Hint: To ease acquisition of the required number of lines Basler recommends to set the line start trigger mode to Off for automatic line start triggering.
Page 139
Make corrections as required. 7. If you use Basler pylon, select Gain Shading in the Basler pylon Viewer or via the Basler pylon API. 8. If you use Basler pylon, select "usershading" file in the Basler pylon Viewer or via the Basler pylon API.
Activate error - the selected shading set could not be loaded into the volatile memory. Create error - an error occurred during the attempt of creating a "usershading" file. You can use the functions listed above from within your application software by using the Basler pylon API.
Activate error - the selected shading set could not be loaded into the volatile memory. Create error - an error occurred during the attempt of creating a "usershading" file. For more information about direct register access, see Section 3.2 on page Basler racer Camera Link...
(See Section 8.10.2 on page 135 for more information). Flashing Red Internal error. Contact Basler technical support. Table 20: LED Indications During the camera bootup process, the red and the green LED will simultaneously be lit. Basler racer Camera Link...
code stored in the memory. Execute the ClearLastError command to clear the last error code from the memory. Continue reading and clearing the last error until the parameter indicates a No Error code. Basler racer Camera Link...
Page 144
// Clear the value of the last error code in the memory camera.ClearLastError.Execute(); You can also use the Basler pylon Viewer application to easily set the parameter and execute the command. For more information about the pylon API and the pylon Viewer, see Section 3.1 on...
// set for the first test image camera.TestImageSelector.SetValue(TestImageSelector_Testimage1); 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 Enabling a Test Image Using Direct Register Access To enable a test image via direct register access, set the value of the Test Image Selector register to Test Image 1, 2, 3, 4, or 5 as desired.
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 Camera Link...
DeviceUserID (read / write) - is used to assign a user defined name to a device. This name will be displayed in the Basler pylon Viewer. The name will also be visible in the "friendly name" field of the device information objects returned by pylon’s device enumeration procedure.
Page 148
= 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. For more information about the pylon API and the pylon Viewer, see Section 3.1 on page For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide...
Page 149
Device Scan Type • Sensor Width • Sensor Height • Width Max • Height Max Table 22: Working with Registers Related to Device Information Parameters For more information about direct register access, see Section 3.2 on page Basler racer Camera Link...
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.1 on page To set the user defined values via direct register access: Set the value of the User Defined Value 1 register or the User Defined Value 2 register as ...
The settings for 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 Camera Link...
API to set the parameter and execute the command: 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.
You can also load the default set into the camera’s active set. To load a saved configuration set or the default set from the camera’s non-volatile memory into the active set using Basler pylon: 1. Set the UserSetSelector parameter to UserSet1, UserSet2, UserSet3, or Default.
// Designate the default set as the startup set camera.UserSetDefaultSelector.SetValue(UserSetDefaultSelector_Default); 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...
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.
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.
9.4 Before Contacting Basler Technical Support To help you as quickly and efficiently as possible when you have a problem with a Basler camera, it is important that you collect several pieces of information before you contact Basler technical support.
Page 158
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 the Basler pylon Viewer.
60 °C in Section 1.7.1 on page 19 and Section 1.7.2 on page 19. Added precautions related to SELV and LPS in Section 1.8 on page 21. Updated Section 3.1 on page 25 to reflect software update to Basler pylon Camera Software Suite.
Page 160
AOI) = const. = 1 Creation of user shading files in Section 8.9.3.1 on page 128: Added indication for reaching a sufficient number of acquisitions. Added instructions for disabling auto functions when creating usershading files. Minor changes throughout the manual. Basler racer Camera Link...
..........147 overhead ........73 camera restart ........147 overlapped .........71 CC1, CC2, CC3, and CC4......43 premature end........73 CL spare...........47 exposure active signal......80 C-mount adapter ........14 exposure auto.........117 code snippets, proper use ......23 Basler racer Camera Link...
Page 162
........21 line trigger wait signal.......82 horizontal binning ........124 LUT (luminance lookup table) ....121 humidity ............21 LUT enable parameter ......123 LUT index parameter......123 illegal line acquisition........73 image area of interest.......89 Basler racer Camera Link...
Page 163
3 setscrew ...........17 PoCL ............40 setting parameters power cable ..........38 via register access ......28 power over Camera Link ......40 shading correction ........127 power requirements......3 gain ..........127 power requirements, camera....40 offset ..........127 shading file ..........127 Basler racer Camera Link...
Page 164
....67 troubleshooting with the LED indicator...134 intended ..........1 user authorized ..........2 user defined values ........142 user output value parameter ....51 user settable output lines ....49 user shading set file .......128 ventilation ..........21 weight ..........4 Basler racer Camera Link...
Need help?
Do you have a question about the Racer and is the answer not in the manual?
Questions and answers