Table of Contents

Advertisement

USER'S MANUAL
Document Number: DA00072103
Release Date: 12 July 2005

Advertisement

Table of Contents
loading

Summary of Contents for Basler L304kc

  • Page 1 USER’S MANUAL Document Number: DA00072103 Release Date: 12 July 2005...
  • Page 2 These products are not designed for use in life support appliances, devices, or systems where malfunction of these products can reasonably be expected to result in personal injury. Basler cus- tomers 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 Contacting Basler Support Worldwide Europe: Basler AG An der Strusbek 60 - 62 22926 Ahrensburg Germany Tel.: +49-4102-463-500 Fax.: +49-4102-463-599 vc.support.europe@baslerweb.com Americas: Basler, Inc. 740 Springdale Drive, Suite 100 Exton, PA 19341 U.S.A. Tel.: +1-877-934-8472 Fax.: +1-877-934-7608 vc.support.usa@baslerweb.com Asia: Basler Asia Pte. Ltd 25 Internat.
  • Page 5: Table Of Contents

    2.2.2 Power Cable ..........2-4 2.3 Camera Link Implementation in the L304kc ......2-5 2.4 Input Signals .
  • Page 6 3.9.1 Enabling Mirror Image ......... 3-40 BASLER L304...
  • Page 7 3.17.5 Downloading a Saved User Set File to Your PC or Uploading a Saved User Set File From Your PC ....3-67 BASLER L304...
  • Page 8 Stamp Mode CSR ........4-27 BASLER L304...
  • Page 9 4.4 Binary Command Sample Code ........4-54 BASLER L304...
  • Page 10 6.2.4 RS-644 Serial Communication ........6-8 6.3 Before Calling Basler Technical Support ....... . 6-9 Revision History .
  • Page 11: Introduction

    To see the camera version ID number: ⇒ ⇒ 1. Double click the CCT+ icon on your desktop or click Start All Programs Basler Vision ⇒ ⇒ Technologies CCT+ CCT+. The CCT+ window will open and the software will connect to your camera.
  • Page 12: Performance Specifications

    (For proper operation, exposure time should not be less then 10% of the line period.) Video Output Type Camera Link LVDS - Base configuration RS-644 LVDS when used with an optional Basler Interface Converter (k-BIC) Video Data 3 taps (three pixels per clock cycle)
  • Page 13: Spectral Response

    Using a filter with a higher cut-off point than 700 ... 720 nm will increase the camera’s response, but keep in mind that the response increase will occur because the camera is reacting to IR light, not visible light. BASLER L304...
  • Page 14: Environmental Requirements

    You must provide sufficient heat dissipation to maintain the temperature of the camera housing at 55° C or less. Since every installation is unique, Basler does not specify a strictly required technique for proper heat dissipation. Instead, we provide the following general guidelines: •...
  • Page 15: Precautions

    Electromagnetic fields Do not operate the camera in the vicinity of strong electromagnetic fields. Avoid electrostatic charging. Transporting Only transport the camera in its original packaging. Do not discard the packaging. BASLER L304...
  • Page 16 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 volatile solvents such as benzine and thinners; they can damage the surface finish. BASLER L304...
  • Page 17: Camera Interface

    • a 6-pin, micro-miniature, push-pull receptacle used to provide power to the camera. A status LED located on the back of the camera is used to indicate power present and to display the camera’s status. Figure 2-1 shows the connectors and the LED. Figure 2-1: Connectors and LED BASLER L304...
  • Page 18: Pin Assignments And Pin Numbering

    Ground DC Ground 5, 6 DC Gnd Pins 1 and 2 are tied together inside of the camera. Pins 5 and 6 are tied together inside of the camera. Table 2-2: Pin Assignments for the 6-pin Micro-miniature Receptacle BASLER L304...
  • Page 19 The camera housing is not grounded and is electrically isolated from the circuit boards inside of the camera. Connector Pin Numbering Figure 2-2 shows the pin numbering for the connectors on the back of the camera. Figure 2-2: Pin Numbering BASLER L304...
  • Page 20: Connector Types

    2.2.1 Camera Link Cable A Camera Link compatible MDR cable assembly is available from Basler as a stock item (part # 1000013041 for a 3 meter cable and part # 1000013042 for a 5 meter cable). As an alternate, you can use the cable assembly manufactured by 3M (part # 14X26-SZLB-XXX-0LC).
  • Page 21: Camera Link Implementation In The L304Kc

    RS-644 camera control input signals and the serial communication input signal defined in the Camera Link specification. A DS90LV011A differential line transmitter is used to transmit the serial communication output signal defined in the specification. Detailed spec sheets for these devices are available at the National Semiconductor web site (www.national.com). BASLER L304...
  • Page 22 Draft Camera Interface Figure 2-3: Camera / Frame Grabber Interface BASLER L304...
  • Page 23: Input Signals

    The period of the ExSync signal determines the camera’s line rate: -------------------------------------------------------- - Line Rate ExSync Signal Period Note that ExSync is edge sensitive and therefore must toggle. Minimum high time for the ExSync signal is 0.1 µs. BASLER L304...
  • Page 24: Output Signals

    Pixel data is only valid when this bit is high. 2.5.3 Data Valid Bit The data valid bit indicates that valid pixel data is being transmitted. Pixel data is only valid when the line valid bit and the data valid bit are both high. BASLER L304...
  • Page 25: Video Data

    Table 2-3: Bit Assignments See pages 2-10 through 2-12 for more detailed information about how pixel data is transmitted in this mode. See pages 2-13 through 2-15 for more detailed information about how pixel data is transmitted in this mode. BASLER L304...
  • Page 26: L304Kc Video Data Output Modes

    Draft Camera Interface 2.5.5 L304kc Video Data Output Modes cameras can operate in 3 tap 8 bit, 2 tap 10 bit and 2 tap 8 bit output modes. (See Section L304 for more information about setting the camera for a particular output mode.)
  • Page 27 The pixel data transmitted out of the camera is affected by the spatial correction settings (see Section 3.5). Timing diagrams are not to scale. Figure 2-4: 3 Tap 8 Bit Output Mode with Edge or Level-controlled Exposure 2-11 BASLER L304...
  • Page 28 3.8). The pixel data transmitted out of the camera is affected by the spatial correction settings (see Section 3.5). Timing diagrams are not to scale. Figure 2-5: 3 Tap 8 Bit Output Mode with Programmable Exposure 2-12 BASLER L304...
  • Page 29 8 bit mode, only 8 bits of data per pixel will be transmitted. When the AOI and Counter Stamp features are used, the number of cycles could be more or less than 8160. See Sections for more information. 2-13 BASLER L304...
  • Page 30 The pixel data transmitted out of the camera is affected by the spatial correction settings (see Section 3.5. Timing diagrams are not to scale. Figure 2-6: 2 Tap 10 Bit or 2 Tap 8 Bit Output Mode with Edge or Level-controlled Exposure 2-14 BASLER L304...
  • Page 31 The pixel data transmitted out of the camera is affected by the spatial correction settings (see Section 3.5). Timing diagrams are not to scale. Figure 2-7: 2 Tap 10 Bit or 2 Tap 8 Bit Output Mode with Programmable Exposure 2-15 BASLER L304...
  • Page 32: Integrate Enabled Signal

    However, a Camera Link cable that allows easy access to this signal is available from Basler as a stock item (part # 100013041 for a 3 meter cable and part # 100013042 for a 5 meter cable).
  • Page 33: Serial Communication

    If you are using the Basler Camera Configuration Tool Plus (CCT+) to configure the camera, the tool will detect the characteristics of the serial port on the frame grabber and will determine the appropriate settings so that the tool can open and use the port.
  • Page 34: Converting Camera Link Output To Rs-644 With A K-Bic

    RS-232 serial communication via the host PC. The output from l304 cameras can be converted to the older style of output by using a Basler Interface Converter for k-series cameras (k-BIC). The k-BIC is a small device that attaches to the l304 with a Camera Link compatible cable.
  • Page 35: Operation And Features

    When the camera is set for 3 tap output, it transmits pixels at 8 bit depth with a clock speed of 30 MHz. When the camera is set for 2 tap output depth, it can output pixels either at 10 bit or at 8 bit depth and with a pixel clock speed of 60 MHz. BASLER L304...
  • Page 36 Draft Operation and Features Figure 3-1: Pixels and Shift Registers Figure 3-2: L304 Block Diagram BASLER L304...
  • Page 37: Video Data Output Modes

    You set the video data output mode by writing a value to the Mode field of the Video Data Output Mode CSR (see page 4-14). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. BASLER L304...
  • Page 38: Exposure Time Control Modes

    ExSync and the next rising edge. The pixels are exposed and charge is accu- mulated only when ExSync is low. The lines are read out and transferred on the rising edge of the ExSync signal (see Figure 3-4). Figure 3-4: ExSync, Level-controlled Mode BASLER L304...
  • Page 39: Selecting An Exsync Exposure Mode & Setting The Exposure Time

    Absolute Exposure Time field or to the Raw Exposure Time field of the Exposure Time CSR (see page 4-15). Section 4.2.2 explains CSRs and the difference between using the “absolute” field and the “raw” field in a CSR. Section 4.3.1 explains using read/write commands. BASLER L304...
  • Page 40: Guidelines When Using An Exsync Signal

    Start Delay = Transfer Gate Time + Setup Time Exposure Mode Transfer Gate Time Setup Time ≤ Level-controlled 0.0 µs 0.4 µs ≤ Programmable 0.0 µs 0.4 µs ≤ Edge-controlled 1.40 µs 0.4 µs Table 3-1: Exposure Start Delay Components BASLER L304...
  • Page 41 If you have the Dark Noise Cancellation feature enabled, the start delay and the end delay will be different from what is shown here. See Section 3.10.2 for more information. The actual start and end of exposure can be monitored by using the Integrate En- abled signal (see Section 3.4). BASLER L304...
  • Page 42: Free Run

    (see Figure 3-6). The line period is determined by the set- ting for the line period parameter. The edge-controlled mode will give you the best performance in terms of signal-to-noise ratio. Figure 3-6: Free-run, Edge-controlled Mode BASLER L304...
  • Page 43: Selecting A Free-Run Exposure Mode, Setting The Line Period

    Absolute Exposure Time field or to the Raw Exposure Time field of the Exposure Time CSR (see page 4-15). Section 4.2.2 explains CSRs and the difference between using the “absolute” field and the “raw” field in a CSR. Section 4.3.1 explains using read/write commands. BASLER L304...
  • Page 44: Guidelines When Using Free-Run

    The signal will go high when each exposure begins and go low when the exposure ends. The characteristics of the signal are described in more detail in Section 2.5.6. 3-10 BASLER L304...
  • Page 45: Spatial Correction

    Figure 3-9. Whenever an exposure is triggered, all three lines in the sensor are exposed simultaneously. This means that for a single exposure, each line in the sensor captures a different area on the object. Figure 3-9: Field of View for Each Line 3-11 BASLER L304...
  • Page 46 The need to combine information from three different exposures to get full color information for a particular point on the object is known as spatial correction. Figure 3-10: A Single Point Captured on Three Different Exposures 3-12 BASLER L304...
  • Page 47 Amount parameter should be set to 9. This setting would tell the camera to combine the data from each green line exposure with the red data from 9 exposures later and the blue data from 18 exposures later. Figure 3-11: Sequence of Exposures for Point A and Point B 3-13 BASLER L304...
  • Page 48: Spatial Correction Parameters

    In this case, the spatial line in the sensor first. In this case, the correction direction must be set to blue. spatial correction direction must be set to green. Figure 3-12: Direction = Blue Figure 3-13: Direction = Green 3-14 BASLER L304...
  • Page 49: Setting The Spatial Correction Parameters

    You set the spatial correction direction by writing a value to the Direction field of the Spatial Correction Direction CSR (see page 4-19). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-15 BASLER L304...
  • Page 50: Camera Operating Requirements For Proper Spatial Correction

    Lack of an IR cut filter can also result in very poor color separation. In some cases, captured images may appear to be almost monochrome because they do not provide enough color information to produce a full color image. 3-16 BASLER L304...
  • Page 51: System Design Requirements For Proper Spatial Correction

    Figure 3-15. This situation will cause haloing that is perpendicular to the transport direction. The halos will vary in size and color. Figure 3-15: Conveyor Travel 3-17 BASLER L304...
  • Page 52 For example, lettering in the captured image may show green colored halos on the left side of each letter and violet colored haloes to the right side of each letter. Figure 3-16: Sensor Perpendicularity 3-18 BASLER L304...
  • Page 53 If your system design will not allow you to achieve sensor-conveyor parallelism, a telecentric lens setup can be used to overcome the problems that this will cause. A telecentric setup usually requires high illumination. Figure 3-17: Sensor Rotated on its Long Axis 3-19 BASLER L304...
  • Page 54 A telecentric setup usually requires high illumination. If the objects strongly differ in height and a telecentric setup is not used, haloing will be seen in the areas where sharp height gradients are present. 3-20 BASLER L304...
  • Page 55: System Design Calculations

    A publication called Optics Recommendation Guide available Basler site (www.baslerweb.com/produkte/produkte_en_230.php). This publication provides general guidance for selecting a lens. If you need more assistance with your lens selection, please contact Basler Technical Support. 3-21 BASLER L304...
  • Page 56 Step 4 - Select an appropriate lens and determine the mounting distance for your camera. You can contact Basler Technical Support if you need help with this procedure. Step 5 - Make sure that the Spatial Correction Direction and the Spatial Correction Amount parameters (see Section 3.5.2) are set correctly.
  • Page 57 90 µm. Therefore, we will need to adjust the magnification so that exactly 90 µm of image movement results. And we must also consider that a change in magnification will result in a change in the amount of conveyor width that is viewed by each sensor line. 3-23 BASLER L304...
  • Page 58 1 : 22.22 and at this magnification, the field of view of each sensor line will be 906.58 mm. Since our conveyor is 850 mm wide and since it is usually more acceptable to have a field of view slightly larger than the conveyor, assume that we choose option 2. 3-24 BASLER L304...
  • Page 59 Step 4 - Select an appropriate lens and determine the mounting distance for your camera. You can contact Basler Technical Support if you need help with this procedure. Step 5 -Make sure that the Spatial Correction Direction and the Spatial Correction Amount parameters (see Section 3.5.2) are set correctly.
  • Page 60: Gain And Offset

    ( 6 / 20 ) Multiplier Multiplier = 2.0 So each digitized pixel value in captured red lines would be multiplied by 2.0 before it is transmitted from the camera. Figure 3-19: Response at Various Gain Settings 3-26 BASLER L304...
  • Page 61: Setting The Red Gain, The Green Gain And The Blue Gain

    You set the blue gain by writing a value to the Absolute Blue Gain field or to the Raw Blue Gain field of the Blue Gain CSR (see page 4-21). Section 4.2.2 explains CSRs and the difference between using the “absolute” field and the “raw” field in a CSR. Section 4.3.1 explains using read/write commands. 3-27 BASLER L304...
  • Page 62: Gain Lock

    You enable the gain lock by writing a value to the Mode field of the Gain Lock CSR (see page 21). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-28 BASLER L304...
  • Page 63: Red Offset, Green Offset And Blue Offset

    You set the blue offset by writing a value to the Absolute Blue Offset field or to the Raw Blue Offset field of the Blue Offset CSR (see page 4-23). Section 4.2.2 explains CSRs and the difference between using the “absolute” field and the “raw” field in a CSR. Section 4.3.1 explains using read/write commands. 3-29 BASLER L304...
  • Page 64: Offset Lock

    You enable the offset lock by writing a value to the Mode field of the Offset Lock CSR (see page 4-24). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-30 BASLER L304...
  • Page 65: Clipping

    Figure 3-21. If the camera is experiencing clipping, a clipping error flag will be set. You can determine whether clipping is present by checking the camera status as described in Section 3.14. Figure 3-21: Low Clipping 3-31 BASLER L304...
  • Page 66: Area Of Interest (Aoi)

    To use all of the pixels, the starting pixel should be set to 1 and the length in pixels to 4080. See Section for information about how the camera will operate if the AOI feature and the stamp feature are both enabled. 3-32 BASLER L304...
  • Page 67: Setting The Aoi

    You set the AOI length by writing a value to the Length field of the AOI Length CSR (see page 26). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-33 BASLER L304...
  • Page 68: Stamp

    When the camera is operating in a 10 bit output mode, the stamp pixels will be 10 bit values but only the 8 MSBs will carry information. The two LSBs will be packed with zeros and should be ignored. Figure 3-24: Stamp Pixel Transmission with 3 Tap Output 3-34 BASLER L304...
  • Page 69 6 and the camera is set for 3 tap 8 bit output mode. Figure 3-27 illustrates what you would see if the camera is set for the same AOI and for 2 tap 8 bit or 2 tap 10 bit output mode. Figure 3-26: Stamp Pixel Transmission with 3 Tap Output and an AOI 3-35 BASLER L304...
  • Page 70 Draft Operation and Features 3-36 BASLER L304...
  • Page 71 The total high pixels indicates the number of pixels in a captured line that are above a parameter called the “High Pixel Threshold.” The total high pixels can range from 0 to 4080. 3-37 BASLER L304...
  • Page 72 Line contrast values are useful when you are adjusting the camera’s focus. Generally, the higher the line contrast value the better the focus. Stamp Pixel S16 Stamp pixel S16 is reserved for future use. Currently, its value will always be 0. 3-38 BASLER L304...
  • Page 73: Enabling And Setting The Stamp

    Stamp Red Low Pixel Limit CSR, the Stamp Green Low Pixel Limit CSR and the Stamp Blue Low Pixel Limit CSR (see pages 4-28 and 4-30). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-39 BASLER L304...
  • Page 74: Mirror Image

    You enable mirror imaging by writing a value to the Mode field of the Mirror Image Mode CSR (see page 4-31). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-40 BASLER L304...
  • Page 75: Image Enhancements

    Basler has added a new set of image enhancement features that give you an even wider range of flexibility to meet your image quality tastes and needs.
  • Page 76 The set of DSNU values for each line is placed in the camera’s volatile memory. These values overwrite any DSNU shading values that are already in the memory. The current set of DSNU values in the volatile memory is used whenever DSNU is enabled. 3-42 BASLER L304...
  • Page 77: Prnu Shading Correction

    4. b) If the values for the darkest pixels are less than 1/2 of the value for the lightest pixels, it usually indicates extreme variations in lighting or poor quality optics. Make corrections as required. 3-43 BASLER L304...
  • Page 78 The time needed to complete the generation process will be equal to 16 times the line period. 3-44 BASLER L304...
  • Page 79: Saving Dsnu And Prnu Shading Correction Values

    Files saved in the non-volatile memory are not lost at reset or power off. You can save one complete set of DSNU and PRNU shading values to a file in the non-volatile memory. 3-45 BASLER L304...
  • Page 80: Activating" Saved Dsnu And Prnu Shading Correction Values

    You activate a saved shading value file by writing values to the bulk data CSR for shading values. Section 4.2.3 explains bulk data CSRs and using the bulk data activate process. Section 4.3.1 explains using read/write commands. 3-46 BASLER L304...
  • Page 81: Dark Noise Cancellation

    * As mentioned above, the dark noise cancellation feature has no effect in edge-controlled mode. If you work in edge-controlled mode and enable the dark noise cancellation feature, you will see no image enhancement but a slight delay in both the start and the end of exposure. 3-47 BASLER L304...
  • Page 82 You enable dark noise cancellation by writing a value to the Mode field of the Dark Noise Cancellation CSR (see page 4-33). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-48 BASLER L304...
  • Page 83: Defective Pixel Correction

    You enable defective pixel correction by writing a value to the Mode field of the Defective Pixel Correction Mode CSR (see page 4-33). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-49 BASLER L304...
  • Page 84: Color Shift Correction

    With the CCT+ (see Section 4.1), you use the Color Shift Correction Mode parameter in the Image Enhancement parameters group to enable color shift correction. You use the Red Color Shift Correction, Green Color Shift Correction and Blue Color Shift Correction parameters to set the amount of correction for each color. 3-50 BASLER L304...
  • Page 85 Correction field or to the Raw Blue Color Shift Correction field of the Blue Color Shift Correction CSR (see page 4-35). Section 4.2.2 explains CSRs and the difference between using the “absolute” field and the “raw” field in a CSR. Section 4.3.1 explains using read/write commands. 3-51 BASLER L304...
  • Page 86: Test Images

    You enable a test image by writing a value to the Mode field of the Test Image Mode CSR (see page 4-36). See Section 4.2.2 for an explanation of CSRs and Section 4.3.1 for an explanation of using read/ write commands. 3-52 BASLER L304...
  • Page 87: Test Image One (Fixed Gray Gradient)

    The description of the pixel values in test image one is only valid when the camera is set for 8 bit output. If the camera is set for 10 bit output, the gradients range from 0 to 1023 and repeat every 1024 pixels. 3-53 BASLER L304...
  • Page 88: Test Image Two (Moving Gray Gradient)

    The description of the pixel values in test image two is only valid when the camera is set for 8 bit output. If the camera is set for 10 bit output, the gradients range from 0 to 1023 and repeat every 1024 pixels 3-54 BASLER L304...
  • Page 89: Test Image Three (Vertical / Horizontal Gray Gradient)

    The description of the pixel values in test image three is only valid when the camera is set for 8 bit output. If the camera is set for 10 bit output, the gradients range from 0 to 1023 and repeat every 1024 pixels 3-55 BASLER L304...
  • Page 90: Test Image Four (Fixed Red Gradient)

    The description of the pixel values in test image five is only valid when the camera is set for 8 bit output. If the camera is set for 10 bit output, the gradients range from 0 to 1023 and repeat every 1024 pixels 3-56 BASLER L304...
  • Page 91: Test Image Six (Fixed Blue Gradient)

    (Normally, shading correction should be disabled when you use any test image. You should only enable PRNU shading correction with test image seven if you want to see the effect that this type of shading correction will have on a uniform image.) Figure 3-36: Test Image Seven 3-57 BASLER L304...
  • Page 92: Test Image Eight (Uniform Black)

    (Normally, shading correction should be disabled when you use any test image. You should only enable DSNU shading correction with test image eight if you want to see the effect that this type of shading correction will have on a uniform image.) Figure 3-37: Test Image Eight 3-58 BASLER L304...
  • Page 93: Test Image Nine (Interleaved Gradient)

    The description of the pixel values in test image 10 is only valid when the camera is set for 8 bit output. If the camera is set for 10 bit output, the gradients range from 0 to 1023 and the pattern repeats every 2048 pixels 3-59 BASLER L304...
  • Page 94: Ccd Temperature Sensor

    Inquiry Registers and Section 4.3.1 for an explanation of using read/write commands. If the temperature of the CCD sensor rises above 75° C, an overtemperature error will be declared. See Section 3.13.2 for more information. 3-60 BASLER L304...
  • Page 95: Error Condition Detection

    Camera Status Inquiry Register will be set to 1 if the camera detects an overvoltage situation. They will remain set to 1 until the condition is corrected, i.e., the input volt- age is in the correct range and a camera reset or a power off/on has been per- formed. 3-61 BASLER L304...
  • Page 96: Overtemperature Condition Detected

    Camera Status Inquiry Register will be set to 1 if the camera detects an over- temperature situation. They will remain set to 1 until the condition is corrected, i.e., the temperature of the sensor falls to 60° C or less and a camera reset or a power off/on has been performed. 3-62 BASLER L304...
  • Page 97: Identical Dark Images Indicate A Parameter Error

    3.15 Status LED The L304 has a status LED on the back of the camera. The LED is used to indicate that power is present and to indicate an error condition if one is detected. See Section for details. 3-63 BASLER L304...
  • Page 98: Resetting The Camera

    Whenever the camera is powered on or when a camera reset is performed, your PC may receive one random character on the serial interface. We recommend clearing the serial input buffers in your PC after a camera power on or reset. 3-64 BASLER L304...
  • Page 99: Configuration Sets

    CSR for configuration sets. The bulk data “save” process is used to save the work set to a file. Section 4.2.3 explains the bulk data CSRs and explains how to use the CSRs to save the work set to a file. Section 4.3.1 explains using read/write commands. 3-65 BASLER L304...
  • Page 100: Activating" A Saved User Set File

    • A link is created between the factory set file and the camera’s volatile memory. The values in the factory set will now be automatically copied into the work set whenever the camera is powered up or reset. 3-66 BASLER L304...
  • Page 101: Which Configuration Set File Will Load At Startup Or At Reset

    With the CCT+ (see Section 4.1), you use the File Name Select parameter and the Download User Set File parameter or the Upload User Set File parameter in the User Set Files parameters group to download or upload files. 3-67 BASLER L304...
  • Page 102 The bulk data “upload” process is used to upload a user set file from your PC to a camera. Section 4.2.3 explains the bulk data CSRs and explains how to use the CSRs to download or upload a saved user set file. Section 4.3.1 explains using read/write commands. 3-68 BASLER L304...
  • Page 103 Draft Operation and Features 3-69 BASLER L304...
  • Page 104 Draft Operation and Features 3-70 BASLER L304...
  • Page 105: Configuring The Camera

    Configuration Tool Plus (CCT+). See Section for instructions on using the configuration tool. You can also change the parameters directly from your application by using binary read/write commands to set values in the camera’s registers (see Section 4.2). BASLER L304...
  • Page 106: Configuring The Camera With The Camera Configuration Tool Plus (Cct+)

    1. Make sure that the properties for the RS-644 serial port on your frame grabber are properly configured and that the camera has power. 2. To start the CCT+, click Start, click All Programs, click Basler Vision Technologies and click CCT+ (default installation).
  • Page 107: Configuration Tool Basics

    CCT+ is displaying the parameter settings. To manually refresh the display, you can use the Refresh button in the top right corner of the tool. BASLER L304...
  • Page 108: Configuration Tool Help

    It also explains how to copy the work set to a saved user set file and how to copy a saved user set file or the factory set file to the work set. To access on-line help, press the F1 key whenever the configuration tool is active. BASLER L304...
  • Page 109: Configuring The Camera By Setting Registers

    Section describes the binary read/write command protocol in detail and also provides information on using the serial link. Sample code that illustrates how to use the read/write commands are available from Basler (see Section 4.4). BASLER L304...
  • Page 110: Inquiry Registers

    Field Name: Model Info Offset: 0x0001 Size: 20 Bytes Type: Read only Description: String containing the camera’s model number. The string is zero terminated if less than 20 bytes are needed and unterminated if all 20 bytes are needed. BASLER L304...
  • Page 111: Product Id Inquiry

    Description: The value in this field indicates the camera’s version information. The bytes in the field are interpreted as follows: Byte 1 = Low byte of the camera version (BCD coded) Byte 2 = High byte of the camera version (BCD coded) Byte 3 = Register layout ID (BCD coded) BASLER L304...
  • Page 112: Microcontroller Firmware Version Inquiry

    The bytes in the field are interpreted as follows: Byte 1 = Low byte of the configuration version (BCD coded) Byte 2 = High byte of the configuration version (BCD coded) Byte 3 = Register layout ID (BCD coded) BASLER L304...
  • Page 113: Camera Status Inquiry

    1/2 of the values for the lightest pixels. This problem is often caused by extremely non-uniform light- ing or by poor quality optics. This bit will clear when you perform a successful shading value generation procedure. BASLER L304...
  • Page 114: Fpga Status Inquiry

    Dark pixel errors are very uncommon but they could be caused by us- ing an extremely bright illumination source or if the camera is not equipped with the recommended IR cut filter (see Section 1.3). Dark pixel errors could also be caused by a defective sensor. Reserved 4-10 BASLER L304...
  • Page 115: Binary Command Protocol Status Inquiry

    Size: 1 Byte Type: Read only Description: The value in this field indicates the temperature of the camera’s CCD sensor. The value is an 8 bit signed binary number (two’s complement method) and indicates the temperature in °C. 4-11 BASLER L304...
  • Page 116: Feature Control And Status Registers

    = 20 x log ( raw setting / 256 ) dB = 20 x log ( 1200 / 256 ) dB = 13.42 So with the raw red gain field set to 1200, the camera would be set for 13.42 dB of red gain. 4-12 BASLER L304...
  • Page 117 Note: This description of setting the red gain assumes that the gain lock feature is disabled. When the gain lock feature is enabled, the range of settings available for the red gain may be restricted (see Section 3.6.2). 4-13 BASLER L304...
  • Page 118: Feature Control And Status Register Details

    Description: Writing an integer value to this field sets the exposure time control mode: 0x00 = Free-run, programmable 0x02 = Free-run, edge-controlled 0x04 = ExSync, level-controlled 0x05 = ExSync, programmable 0x06 = ExSync, edge-controlled See Section 2.5.5 for a description of the video data output modes. 4-14 BASLER L304...
  • Page 119: Exposure Time Csr

    Byte 1 = Low byte of the raw value Byte 2 = Mid byte of the raw value Byte 3 = High byte of the raw value Byte 4 = Always 0x00 (not used) See Section for more information about exposure time. 4-15 BASLER L304...
  • Page 120 The 4 bytes in this field are interpreted as follows: Byte 1 = Low byte of the max value Byte 2 = Mid byte of the max value Byte 3 = High byte of the max value Byte 4 = Always 0x00 (not used) 4-16 BASLER L304...
  • Page 121: Line Period Csr

    Byte 1 = Low byte of the raw value Byte 2 = Mid byte of the raw value Byte 3 = High byte of the raw value Byte 4 = Always 0x00 (not used) See Section for more information about the line period. 4-17 BASLER L304...
  • Page 122 The 4 bytes in this field are interpreted as follows: Byte 1 = Low byte of the max value Byte 2 = Mid byte of the max value Byte 3 = High byte of the max value Byte 4 = Always 0x00 (not used) 4-18 BASLER L304...
  • Page 123: Spatial Correction Direction Csr

    Size: 1 Byte Type: Read only Description: Maximum allowed integer value for the spatial correction setting. Field Name: Increment Offset: 0x0004 Size: 1 Byte Type: Read only Description: An integer value indicating the increment for the spatial correction setting. 4-19 BASLER L304...
  • Page 124: Red Gain Csr

    The 2 bytes in this field are interpreted as follows: Byte 1 = Low byte of the raw value Byte 2 = High byte of the raw value See Section 3.6.2 for more information about red gain. 4-20 BASLER L304...
  • Page 125: Green Gain Csr

    Type: Read / Write Description: Writing an integer value to this field sets the gain lock mode: 0x00 = Gain lock disabled 0x01 = Gain lock enabled See Section 3.6.2 for more information about the gain lock feature. 4-21 BASLER L304...
  • Page 126: Red Offset Csr

    Description: Maximum allowed floating point value for the absolute red offset setting. This field is up- dated to reflect limitations caused by the way any related features are set. The value in this field is a standard IEEE-754 single precision (32 bit) floating point number. 4-22 BASLER L304...
  • Page 127: Green Offset Csr

    The fields and the field descriptions in the green offset CSR are similar to those in the red offset CSR. Blue Offset CSR Register Base Address: 0x0FC0 The fields and the field descriptions in the blue offset CSR are similar to those in the red offset CSR. 4-23 BASLER L304...
  • Page 128: Offset Lock Csr

    Type: Read / Write Description: Writing an integer value to this field sets the offset lock mode: 0x00 = Offset lock disabled 0x01 = Offset lock enabled See Section 3.6.4 for more information about the offset lock feature. 4-24 BASLER L304...
  • Page 129: Area Of Interest Starting Pixel Csr

    Description: An integer value indicating the increment for the starting pixel setting. The 2 bytes in this field are interpreted as follows: Byte 1 = Low byte of the max value Byte 2 = High byte of the max value 4-25 BASLER L304...
  • Page 130: Area Of Interest Length Csr

    Description: An integer value indicating the increment for the length setting. The 2 bytes in this field are interpreted as follows: Byte 1 = Low byte of the max value Byte 2 = High byte of the max value 4-26 BASLER L304...
  • Page 131: Stamp Mode Csr

    Offset: 0x0001 Size: 1 Byte Type: Read / Write Description: Writing an integer value to this field sets the stamp mode: 0x00 = Stamp disabled 0x01 = Stamp enabled See Section for more information about the stamp feature. 4-27 BASLER L304...
  • Page 132: Stamp Red Low Pixel Limit Csr

    Description: An integer value indicating the increment for the red low pixel limit setting. The 2 bytes in this field are interpreted as follows: Byte 1 = Low byte of the max value Byte 2 = High byte of the max value 4-28 BASLER L304...
  • Page 133: Stamp Red High Pixel Threshold Csr

    Description: An integer value indicating the increment for the red high pixel threshold setting. The 2 bytes in this field are interpreted as follows: Byte 1 = Low byte of the max value Byte 2 = High byte of the max value 4-29 BASLER L304...
  • Page 134: Stamp Green Low Pixel Limit Csr

    The fields and the field descriptions in the blue low pixel limit CSR are similar to those in the red low pixel limit CSR. Stamp Blue High Pixel Threshold CSR Register Base Address: 0x2BB0 The fields and the field descriptions in the blue high pixel threshold CSR are similar to those in the red high pixel threshold CSR. 4-30 BASLER L304...
  • Page 135: Mirror Image Mode Csr

    Type: Read / Write Description: Writing an integer value to this field sets the mirror image mode: 0x00 = Mirror image disabled 0x01 = Mirror image enabled See Section for more information about the mirror image feature. 4-31 BASLER L304...
  • Page 136: Shading Mode Csr

    0x01 = Generate DSNU correction values. 0x02 = Generate PRNU correction values and do not use DSNU correction during generation. 0x03 = Generate PRNU correction values and use DSNU correction during generation. See Section 3.10.1 for more information about shading correction. 4-32 BASLER L304...
  • Page 137: Dark Noise Cancellation Mode Csr

    Description: Writing an integer value to this field sets the defective pixel correction mode: 0x00 = Defective pixel correction disabled 0x01 = Defective pixel correction enabled See Section 3.10.3 for more information about the defective pixel correction feature. 4-33 BASLER L304...
  • Page 138: Color Shift Correction Mode Csr

    Description: Maximum allowed floating point value for the absolute red color shift correction setting. This field is updated to reflect any limitations caused by the way any related features are set. The value in this field is a standard IEEE-754 single precision (32 bit) floating point number. 4-34 BASLER L304...
  • Page 139: Green Color Shift Correction Csr

    CSR. Blue Color Shift Correction CSR Register Base Address: 0x4060 The fields and the field descriptions in the blue color shift correction CSR are similar to those in the red color shift correction CSR. 4-35 BASLER L304...
  • Page 140: Test Image Mode Csr

    Field Name: Reset Offset: 0x0001 Size: 1 Byte Type: Read / Write Description: Writing an integer value of 1 (0x01) to this field will initiate a camera reset. The reset be- havior is similar to a power up reset. 4-36 BASLER L304...
  • Page 141: Serial Communication Baud Rate Csr

    9600. If you are using a Camera Link frame grabber, check the grab- ber’s documentation before attempting to change the baud rate. At reset or power off/on, the camera returns to the 9600 bps setting. 4-37 BASLER L304...
  • Page 142: Bulk Data And The Bulk Data Control And Status Registers

    The best way to understand the use of the bulk data CSRs is to read about the different tasks that you can perform with them. Section 4.2.3.2 describes the tasks that are normally performed by manipulating the bulk data CSRs and provides a procedure for performing each task. 4-38 BASLER L304...
  • Page 143: Using Bulk Data Csrs To Work With Bulk Data

    This procedure would create a file called UserSet01 in the non-volatile memory and would copy the current work set settings from the camera’s volatile memory into the new file. Sample code that illustrates how to create a bulk data file are available from Basler (see Section 4.4).
  • Page 144 It would also create a link to the file so that the values in the file would be loaded into volatile memory after a reset or a power up. Sample code that illustrates how to activate a saved bulk data file are available from Basler (see Section 4.4).
  • Page 145 If you wanted to enumerate the existing saved shading value file, you would use a similar procedure but you would write to and read from the shading value bulk data CSR instead. Sample code that illustrates how to enumerate bulk data files are available from Basler (see Section 4.4).
  • Page 146 If you wanted to download an existing shading value bulk data file to the host PC, you would use a similar procedure but you would use the shading value bulk data CSR instead. Sample code that illustrates how to download a bulk data file are available from Basler (see Section 4.4).
  • Page 147 If you wanted to upload a shading value bulk data file from a PC to a camera, you would use a similar procedure but you would use the shading value bulk data CSR instead. Sample code that illustrates how to upload a bulk data file are available from Basler (see Section 4.4).
  • Page 148: Bulk Data Control And Status Register Details

    Description: Byte-sized register that is used to sequentially write to or read from a bulk data file. You can save up to four configuration set files in the non-volatile memory. There is a restriction on naming the files that hold the saved configuration sets. They must be named UserSet01, UserSet02, UserSet03 or UserSet04. 4-44 BASLER L304...
  • Page 149: Shading Value Csr

    Description: Byte-sized register that is used to sequentially write to or read from a bulk data file. You can save up to one shading value file in the non-volatile memory. There is a restriction on naming the file that holds the saved shading values. The file must be named ShadingValues. 4-45 BASLER L304...
  • Page 150: Using Binary Read/Write Commands

    PC after a camera power on or reset. If you are using your camera with an optional Basler Interface Converter (k-BIC), you can use binary commands to configure the camera via the RS-232 serial connection between your PC and the k-BIC.
  • Page 151: The Binary Read/Write Command Protocol

    The bits in the FTF field are assigned as follows: OpCode BCC- AddrLen Code The MSB of the FTF field is on the left (highest bit of the opcode) and the LSB of the field is on the right (lowest bit of the address length). 4-47 BASLER L304...
  • Page 152 CSR address you are writing to is a 16 bit address. In this case, the OpCode bits would be 0b00000, the BCC-Code bit would be 0b1 and the AddrLen bits would be 0b00. This would result in a binary value of 0b00000100, which translates to a hex value of 0x04 for the FTF field. 4-48 BASLER L304...
  • Page 153 Positive frame acknowledge/negative frame acknowledge Size = 1 byte The value for a positive frame acknowledgement (ACK) is 0x06 and for a negative frame acknowledgement (NAK) is 0x15. All values are formatted as little endian (Intel format). 4-49 BASLER L304...
  • Page 154: Error Checking And Responses

    If the data in a write command is not within the allowed range or specified group of allowed val- ues, the camera will not execute the write command. 4-50 BASLER L304...
  • Page 155: Basic Read/Write Command Explanations

    Status field of the Test Image Mode CSR (see page 4-36). The intent of this section is to give you a basic understanding of the elements included in a read command. Sample code that illustrates how to send a read command are available from Basler (see Section 4.4). The hex digits included in the read command are: 0x01, 0x0C, 0x01, 0x00, 0x18, 0x01, 0x03 is the BFS field.
  • Page 156: Write Command

    0x01 to the Mode field of the Test Image Mode CSR (see page 4-36). The intent of this section is to give you a basic understanding of the elements included in a write command. Sample code that illustrates how to send a write command are available from Basler (see Section 4.4).
  • Page 157: Calculating The Block Check Character

    0 0 0 1 = the binary representation of 0x01 (Data) 0 0 0 1 1 1 0 1 = Final XOR sum 0 0 0 1 1 1 0 1 = 0x1D = the block check character 4-53 BASLER L304...
  • Page 158: Binary Command Sample Code

    Configuring the Camera 4.4 Binary Command Sample Code Sample code that illustrates how to use binary commands with L304 cameras is available at the Basler web site. Please look for the documentation downloads on the L300 page at: http://www.basler-vc.com 4-54 BASLER L304...
  • Page 159: Mechanical Considerations

    The camera is shipped with a cap on the lens mount. To avoid collecting dust on the sensor, make sure that at all times either the cap is in place or a lens is mounted on the camera. BASLER L304...
  • Page 160: Camera Dimensions And Mounting Facilities

    Figure 5-1. cameras are equipped with four M4 mounting holes on the front and two M4 mounting L304 holes on each side as indicated in the drawings. Figure 5-1: L304 Mechanical Dimensions (in mm) BASLER L304...
  • Page 161: Sensor Positioning Accuracy

    Draft Mechanical Considerations 5.2 Sensor Positioning Accuracy The sensor positioning accuracy is as shown in Figure 5-2. Figure 5-2: Sensor Positioning Accuracy (in mm or degrees) BASLER L304...
  • Page 162: Sensor Line Location

    Draft Mechanical Considerations 5.3 Sensor Line Location The location of the sensor Lines on the sensor chip is as shown in Figure 5-3. Figure 5-3: Sensor Line Location (in microns) BASLER L304...
  • Page 163: F-Mount Adapter Dimensions

    Draft Mechanical Considerations 5.4 F-Mount Adapter Dimensions Figure 5-4: F-Mount Adapter Dimensions (in mm) BASLER L304...
  • Page 164: Heat Sink Dimensions

    Draft Mechanical Considerations 5.5 Heat Sink Dimensions Figure 5-5: Heat Sink Dimensions (in mm) BASLER L304...
  • Page 165: Troubleshooting

    Continuous fast General error. orange blinking Please contact Basler support. Continuous slow One of the following errors is present: orange blinking • No FPGA firmware is available.
  • Page 166 CCD sensor so that the sensor will be protected. In this situation, you will still be able to communicate with the camera and the camera will still be able to transmit test images, however, no live images can be generated. BASLER L304...
  • Page 167: Troubleshooting Charts

    Before you resume camera use, make sure you are meeting the heat dissipation requirements outlined in Section No. It is Call Basler Technical Support for assistance. (The blinking orange contact numbers appear on the title page of this manual.) continuously.
  • Page 168 The exposure time must be Correct less than the ExSync period. setting. Is the exposure OK? Replace the camera. Go to the Switch on test image one. interfacing troubleshooting Can the test image be seen? chart. Replace the camera. BASLER L304...
  • Page 169: Poor Quality Image

    Use the CCT+ to activate the Factory Set. Once the Factory set is activated, capture several images. Is the problem still present? A parameter error was present. Contact Basler Technical Support. The contact numbers appear on the title A parameter error occurs when a page of this manual.
  • Page 170: Basler L

    Exit this chart. Exit this chart. Contact Basler Technical Support. The contact numbers appear on the title page of this manual. Before you call for support, be sure to make note of the camera settings and the frame grabber settings you are using.
  • Page 171: Interfacing

    DCF files must be used depending on which of the camera’s features you have enabled. Exit this DCF files for many types of frame grabbers are available at the Basler web site: chart. www.basler-vc.com. These files have all been tested with the L304 and we suggest that you use them if one is available for your type of frame grabber.
  • Page 172: Serial Communication

    (without a BIC) Always switch off power to the system before making or breaking any connection. The RS-644 port used by the L304kc is located on the frame grabber. Check the documentation for your frame grabber. Make sure that you have installed...
  • Page 173: Before Calling Basler Technical Support

    Troubleshooting 6.3 Before Calling 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 technical support.
  • Page 174 12 Parameter set It is very important for Basler Technical Support to get a copy of the exact camera parame- ters that you were using when the problem occurred. To make a copy of the parameters, open the parameter set in the CCT+ and save or dump the settings to a file.
  • Page 175: Revision History

    Preliminary release of the L304kc User’s Manual. Applies to prototype cameras only. DA00072102 18 March 2005 Initial release of the L304kc User’s Manual for series production cam- eras. DA00072103 12 July 2005 Added that dark noise cancellation has no effect in edge-controlled mode: •...
  • Page 176 Draft Revision History BASLER L304...
  • Page 177: Feedback

    Draft Feedback Feedback Your feedback will help us improve our documentation. Please click the link below to access an online feedback form. Your input is greatly appreciated. http://www.baslerweb.com/umfrage/survey.html BASLER L304...
  • Page 178 Draft Feedback BASLER L304...
  • Page 179: Index

    ..... 2-1 k-BIC ........2-18 BASLER L304...
  • Page 180 ......2-18 serial connection ..... 2-17 BASLER L304...

Table of Contents