background image

BCON Interface

AW00136902000

36

Basler dart BCON

5.2.5

Line Checksum

The Basler BCON interface uses even parity in order to detect transmission errors.

For each image line, a checksum is calculated. The checksum is added to the output data at the 
end of each line. The checksum consists of a number of parity bits depending on the selected pixel 
format. For every bit position of every pixel of the current line, an even parity bit is calculated.

The checksum is transmitted directly after the data of the last pixel in the image line has been 
transmitted (see also Figure 20 on 

page 32

).

Example:

 Assume the camera is set for Mono 8 pixel data and one pixel per clock cycle. To 

demonstrate the principle, also assume that the image ROI width is set to 5 pixels only. This means 
that each image line consists of 5 x 8 bit image data. 

Table 18

 shows sample data for one image 

line under these conditions.

In the example shown above, the line checksum data is 0b10000101.

Data 

Channel 

Bit 

Position

Sample Image Data

Count of 

1-bits

Checksum Bit 

(Even Parity Bit)

Clock Cycle

n

n+1

n+2 

n+3

n+4

Bit  0

1

1

0

1

0

3

1

LSB

Bit  1

1

0

1

0

0

2

0

Bit  2

1

0

0

0

0

1

1

Bit  3

1

1

1

0

1

4

0

Bit  4

1

0

1

0

0

2

0

Bit  5

0

0

0

1

1

2

0

Bit  6

0

0

0

0

0

0

0

Bit  7

1

1

0

0

1

3

1

MSB

Table 18: Line Checksum Data (Example)

Summary of Contents for daA1280-54bc

Page 1: ...USER S MANUAL FOR BCON CAMERAS Document Number AW001369 Version 02 Language 000 English Release Date 01 November 2016 Basler dart ...

Page 2: ...les Life support applications 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 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 sa...

Page 3: ...ove the camera front Prevent contact with foreign substances Do not allow e g liquid flammable or metallic material to get in contact with the board Otherwise the camera may fail or cause a fire Avoid electromagnetic fields Do not operate the camera in the vicinity of strong electromagnetic fields Avoid electrostatic charging Transport in original packaging Transport and store the camera in its or...

Page 4: ...02 463 599 support europe baslerweb com The Americas Basler Inc 855 Springdale Drive Suite 203 Exton PA 19341 USA Tel 1 610 280 0171 Fax 1 610 280 7608 support usa baslerweb com Asia Pacific Basler Asia Pte Ltd 35 Marsiling Industrial Estate Road 3 05 06 Singapore 739257 Tel 65 6367 1355 Fax 65 6367 1255 support asia baslerweb com www baslerweb com ...

Page 5: ... 4 3 Mechanical Stress Test Results 19 3 5 Avoiding EMI and ESD Problems 20 3 6 Environmental Requirements 21 3 6 1 Temperature and Humidity 21 3 6 2 Heat Dissipation 22 4 Physical Interface 23 4 1 General Description of the Camera Connections 23 4 2 FFC Connector 24 4 2 1 Connector Pin Assignments 24 4 3 Voltage Requirements 27 4 3 1 Absolute Maximum Ratings 27 4 3 2 Input Voltages 27 4 3 3 Outpu...

Page 6: ...nput Lines and Signals 50 8 1 1 Using the Input Line for Frame Start Triggering 50 8 1 2 Input Line Debouncers 50 8 1 3 Input Line Inverter 52 8 2 Configuring Output Lines and Signals 53 8 2 1 Selecting a Source Signal for an Output Line 53 8 2 2 Setting the Status of a User Settable Output Line 53 8 2 3 Output Line Inverter 54 8 3 Checking the Status of the I O Lines 55 8 3 1 Checking the Status ...

Page 7: ... on Pixel Formats for Color Cameras 81 11 Features 82 11 1 Feature Sequence 82 11 2 Gain 83 11 3 Black Level 84 11 4 Gamma 85 11 5 Brightness Contrast 86 11 5 1 Brightness 86 11 5 2 Contrast 87 11 5 3 Setting Brightness and Contrast 88 11 6 Color Enhancement Features 89 11 6 1 General Considerations 89 11 6 2 Light Source Preset 90 11 6 3 Balance White 92 11 6 4 Hue Saturation 93 11 6 5 PGI Featur...

Page 8: ... 11 12 Backlight Compensation 121 11 13 Test Patterns 122 11 14 Device Information Parameters 124 11 15 Configuration Sets and User Sets 126 11 15 1 Saving a User Set 127 11 15 2 Loading a User Set or the Factory Set into the Active Set 128 11 15 3 Designating the Startup Set 129 12 Troubleshooting and Support 130 12 1 Tech Support Resources 130 12 2 Obtaining an RMA Number 130 12 3 Before Contact...

Page 9: ...arget Audience The Basler dart BCON User s Manual is aimed at experienced hardware and software engineers proficient in electronics software development and embedded system design The document is written for a target audience that has intermediate to advanced technical skills in the areas mentioned above The document assumes that users have experience in the following areas System on a Chip SoC or...

Page 10: ...el Link Design Guide http www ti com lit ml snla167 snla167 pdf GenICam Pixel Format Names and Values http www emva org wp content uploads GenICamPixelFormatValues pdf The documents are provided by the respective owners and the links might be changed by them Font Element or Symbol Example Arial bold Program interface such as menu commands windows dialog boxes field and button names Press the OK bu...

Page 11: ...ich meet the Limited Power Source LPS requirements NOTICE Dust on the sensor can impair the camera s performance Every time you handle the camera without a lens attached make sure that the camera is pointing down so that no dust can reach the sensor If the camera is not installed store it in its original packaging NOTICE Heat can damage the camera Make sure that you provide sufficient heat dissipa...

Page 12: ...ouch and possibly scratch or break the sensor glass Do not screw in the lens deeper than 11 7 mm especially during focusing For more information see Section 3 4 2 on page 16 NOTICE Voltage outside of the specified range can cause damage You must supply camera power that complies with the individual voltage requirements of the BCON interface lines The nominal voltage for the power supply line VCC i...

Page 13: ...tatic charge during cleaning cotton is a good choice Electrostatic discharge might damage the sensor Cleaning the IR cut filter of dart CS mount color variants the sensor cannot be cleaned Try not to touch the IR cut filter and do not clean the IR cut filter mechanically The glass of the IR cut filter can break if you apply too much pressure Use clean oil free compressed air to clean the IR cut fi...

Page 14: ...uit board only S mount This variant consists of a circuit board with a camera front attached S mount lenses can be attached to the lens mount on the camera front CS mount This variant consists of a circuit board with a camera front attached CS mount lenses can be attached to the lens mount on the camera front Unless otherwise noted the material in this manual applies to all of the camera models li...

Page 15: ...ime Control Programmable via the camera API Camera Power Requirements Nominal 5 VDC supplied via the camera s 28 pin FFC connector 1 3 W typical 5 VDC I O Lines 1 input line CC0 and 2 output lines two bits on data lane X0 Lens Mount S mount CS mount without mount bare board Size L x W x H Bare board model 4 8 mm x 27 mm x 27 mm S mount model 17 5 mm x 29 mm x 29 mm CS mount model 16 9 mm x 29 mm x...

Page 16: ...r or free run Exposure Time Control Programmable via the camera API Camera Power Requirements Nominal 5 VDC supplied via the camera s 28 pin FFC connector 1 3 W typical 5 VDC I O Lines 1 input line CC0 and 2 output lines two bits on data lane X0 Lens Mount S mount CS mount without mount bare board Size L x W x H Bare board model 5 9 mm x 27 mm x 27 mm S mount model 17 5 mm x 29 mm x 29 mm CS mount...

Page 17: ...e trigger or programmable via the camera API Camera Power Requirements Nominal 5 VDC supplied via the camera s 28 pin FFC connector 1 4 W typical 5 VDC I O Lines 1 input line CC0 and 2 output lines two bits on data lane X0 Lens Mount S mount CS mount without mount bare board Size L x W x H Bare board model 4 8 mm x 27 mm x 27 mm S mount model 17 5 mm x 29 mm x 29 mm CS mount model 16 9 mm x 29 mm ...

Page 18: ... Mono Camera Spectral Response The following graphs show the spectral response for each available monochrome camera model The spectral response curves exclude lens characteristics and light source characteristics Wavelength nm Quantum Efficiency Fig 2 daA1280 54bm Spectral Response From Sensor Data Sheet ...

Page 19: ...ents Basler dart BCON 11 30 25 20 15 10 5 0 400 500 600 700 800 900 1000 Wavelength nm LSB 10 nJ cm Fig 3 daA1600 60bm Spectral Response From Sensor Data Sheet Wavelength nm Quantum Efficiency Fig 4 daA2500 14bm Spectral Response From Sensor Data Sheet ...

Page 20: ...lter should transmit in a range from 400 nm to 700 720 nm and it should cut off from 700 720 nm to 1100 nm If you are using a dart bare board color camera we recommend installing an IR cut filter or a lens with an integrated IR cut filter when integrating the camera into the system dart S mount color camera we recommend attaching a lens with an integrated IR cut filter to the camera dart CS mount ...

Page 21: ...500 600 700 800 900 1000 Wavelength nm LSB 10 nJ cm Blue Green Red Fig 6 daA1600 60bc Spectral Response From Sensor Data Sheet 350 400 450 500 550 600 650 700 750 0 5 10 15 20 25 30 35 40 45 50 Wavelength nm Quantum Efficiency Blue Green Red Fig 7 daA2500 14bc Spectral Response From Sensor Data Sheet ...

Page 22: ... 10 dart cameras equipped with a CS mount lens adapter are as shown in Figure 11 All dart BCON cameras are equipped with mounting and heat dissipation holes on the bottom as shown in the drawings Bare Board Cameras daA1600 60bm bc Fig 8 Mechanical Dimensions in mm for Bare Board Cameras daA1600 60bm bc Bare Board Cameras Other Models Fig 9 Mechanical Dimensions in mm for Bare Board Cameras Not to ...

Page 23: ... mm for Cameras with CS mount Lens Adapter 29 14 9 Ø 16 6 4 x Ø2 2 max 3 2 deep 22 4 29 22 4 4 x Ø2 08 Recommended screw size Max M2 Bigger screws can damage the camera Not to scale Parts on the board are representational only 29 14 3 Ø 28 3 5 4 4 x Ø2 2 max 3 2 deep 22 4 29 22 4 4 x Ø2 08 Recommended screw size Max M2 Bigger screws can damage the camera Not to scale Parts on the board are represe...

Page 24: ...cer ring The spacer ring optimizes the flange focal distance of these cameras When mounting a lens on the camera attach the spacer ring to the lens The maximum lens dimensions are also shown in Figure 12 on page 17 and Figure 13 on page 18 Camera Model Lens Adapter Type Maximum Allowed Lens Intrusion in mm daA1280 54bm daA2500 14bm S mount 11 7 CS mount 11 daA1280 54bc daA2500 14bc S mount 11 7 CS...

Page 25: ...as make sure that you attach a CS mount adapter ring to the C mount lens before mounting it on a dart CS mount camera Otherwise the lens may reach too far into the camera and damage the IR cut filter color cameras or the sensor mono cameras Not to scale S mount lens M12 x 0 5 Fig 12 Maximum Lens Dimensions in mm for Cameras with S mount Lens Adapter Thread 7 5 daA1600 60bm bc cameras 10 7 mm 11 7 ...

Page 26: ...W00136902000 18 Basler dart BCON Fig 13 Maximum Lens Dimensions in mm for Cameras with CS mount Lens Adapter 7 Not to scale CS mount thread Thread 5 6 21 85 max CS mount lens Filter holder color cameras only 11 daA1600 60bm cameras 10 mm Sensor ...

Page 27: ...uring standard operational testing The mechanical stress tests for S mount cameras were performed with a dummy lens attached The dummy lens had a mass of 30 g The mechanical stress tests for CS mount cameras were performed with a dummy lens attached The dummy lens had a mass of 66 g Using a heavier lens requires an additional support for the lens Test Standard Conditions Vibration sinusoidal each ...

Page 28: ...discharge ESD EMI and ESD can cause problems with your camera such as false triggering or can cause the camera to suddenly stop capturing images EMI and ESD can also have a negative impact on the quality of the image data transmitted by the camera To avoid problems with EMI and ESD you should follow these general guidelines Install the camera as far as possible from devices generating sparks or st...

Page 29: ...C 122 F UL 60950 1 test conditions no lens attached to the camera and without efficient heat dissipation ambient temperature kept at 50 C 122 F Temperature measured at the hottest point on the board This point is significantly hotter than the other parts on the board See Figure 14 Temperature measured at the outside of the camera See Figure 15 Table 6 Temperature and Humidity Requirements Temperat...

Page 30: ...mponents Basler dart S mount and CS mount variants Rivets are placed in the four holes see Figure 16 These rivets can be used to dissipate heat towards connected metallic components Usage of the holes or rivets depends on your system design In all cases make sure that the holes or rivets have contact to metallic components in your system This way the heat can dissipate towards the metallic compone...

Page 31: ...ith both FPGAs and SoCs Systems on a Chip The connector provides connections for LVDS image transfer input and output signals and power supply Furthermore standardized I C lines are integrated which are used for camera configuration via the Basler pylon Camera Software Suite There is also an LED indicator located on the back of the camera Figure 18 shows the location of the connector and the LED i...

Page 32: ... cables However standard flexible flat cables without a ground layer can also be inserted They will make good electrical contact but under certain circumstances you will notice a high rate of bit errors The connector order code is Hirose FH41 28S 0 5SH 05 4 2 1 Connector Pin Assignments Pin 1 Position As shown in Figure 19 pin 1 of the FFC connector is indicated by an arrow and pin 28 is indicated...

Page 33: ...istor to 3 3 VDC is required Refer to the I C standard for the appropriate resistor value Note that FFCs can have a significant line capacitance 8 GND 21 Power Supply See note for pin 1 9 I2C_SCL 20 Configuration Interface I C interface clock line A pull up resistor to 3 3 VDC is required Refer to the I C standard for the appropriate resistor value Note that FFCs can have a significant line capaci...

Page 34: ...ential pair 21 X2 8 Serial Data Output 22 GND 7 Power Supply See note for pin 1 23 X1 6 Serial Data Output LVDS output data lane 1 Use differential routing A 100 ohm termination resistor is required across the differential pair 24 X1 5 Serial Data Output 25 GND 4 Power Supply See note for pin 1 26 X0 3 Serial Data Output LVDS output data lane 0 Use differential routing A 100 ohm termination resist...

Page 35: ... 0 3 V 6 5 V CC0 CC0 4 2 V I2C_SCL I2C_SDA I2C_ID 3 6 V Pin Name Minimum Nominal recommended Maximum Notes VCC 4 5 5 0 V 5 5 V CC0 CC0 0 2 V 1 8 V Common mode voltage 0 1 V Differential voltage I2C_SCL I2C_SDA I2C_ID 0 0 V 0 0 V 1 0 V Input Low Voltage 2 4 V 3 3 V 3 5 V Input High Voltage Table 8 Recommended Input Voltages Camera Supply LVDS Inputs I2C ID Data and Clock Lines ...

Page 36: ...e Table 9 Output Voltages LVDS Outputs Data Lanes and Clock Lines Pin Min Max Notes XCLK 20 MHz 84 MHz Selectable via control interface Settable in steps of 8 i e 20 MHz 28 MHz 36 MHz etc X0 X3 140 Mb s 588 Mb s Selectable via control interface I2C_SCL 0 kHz 400 kHz In the I C Bus Specification and User Manual this mode is called fast mode with 400 kbit s Table 10 Timing Characteristics Green LED ...

Page 37: ...ill light up for approximately 1 second For more information about the startup set see Section 11 15 on page 126 The following code snippet illustrates using the API to set the LED indicator mode Turn off the LED indicator LED is turned off permanently camera DeviceIndicatorMode SetValue DeviceIndicatorMode_Inactive Turn on the LED indicator LED is on during camera operation camera DeviceIndicator...

Page 38: ...1 1000 1100 Tavg 5 Table 12 IR Cut Filter Spectral Characteristics If you want to operate a dart S mount color camera with an IR cut filter you must attach a lens with an integrated IR cut filter to the camera NOTICE Using a lens with a too long thread length can damage the IR cut filter or the filter holder Make sure that you do not damage the IR cut filter by using lenses with a too long lens th...

Page 39: ...information about Channel Link see the Channel Link Design Guide The download link is provided in Section 1 3 on page 2 Specification Value Notes Data lanes 4 Clock lines 1 Used for the word clock Control lines 3 I C interface lines clock data ID Input lines 1 Output lines 2 Serialization factor 7 For more information see Section 5 2 2 on page 33 Data bus width 28 bit Bus width reserved for image ...

Page 40: ... transmission BCON output bits Output 0 and Output 1 Two bits that can be used to transmit camera output signals e g Flash Window or Exposure Active Frame information pixel data and line checksums are transmitted on a common 24 bit image data channel Data 5 2 1 Data Flow The BCON interface does not provide data flow control Also in contrast to the CameraLink interface the BCON interface does not p...

Page 41: ... X1 12 bit pixel data 12 bit checksum Bit 0 Bit 11 X0 X1 X2 16 bit pixel data 16 bit checksum Bit 0 Bit 15 X0 X1 X2 24 bit pixel data 24 bit checksum Bit 0 Bit 23 X0 X1 X2 X3 Table 14 Data Channel Usage Bit 2 Bit 1 Bit 0 FVal Output 1 Line 2 LVal Output 0 Line 1 X0 Bit 9 Bit 8 Bit 7 Bit 6 Bit 4 Bit 5 Bit 3 X1 Bit 16 Bit 15 Bit 14 Bit 13 Bit 11 Bit 12 Bit 10 X2 Bit 23 Bit 22 Bit 21 Bit 20 Bit 18 Bi...

Page 42: ...ta Number of pixels per clock cycle Frame information is always transmitted on bits 0 through 7 of the 24 bit data channel If you are only using 8 bit pixel formats e g because you are using a monochrome camera the X2 and X3 data lanes are never active Accordingly if you are only using 8 bit or 12 bit pixel formats X3 is never active Basler recommends however to always connect all BCON data lanes ...

Page 43: ...n Section 1 3 on page 2 32 Mono 8 0x01080001 Mono 12 0x01100005 Bayer GR 8 0x01080008 Bayer RG 8 0x01080009 Bayer GB 8 0x0108000A Bayer BG 8 0x0108000B Bayer GR 12 0x01100010 Bayer RG 12 0x01100011 Bayer GB 12 0x01100012 Bayer BG 12 0x01100013 YCbCr422 0x0210003B RGB 8 0x02180014 The standard Bayer filter alignment for Basler dart cameras is GB If supported other alignments can be set using the Re...

Page 44: ... transmitted see also Figure 20 on page 32 Example Assume the camera is set for Mono 8 pixel data and one pixel per clock cycle To demonstrate the principle also assume that the image ROI width is set to 5 pixels only This means that each image line consists of 5 x 8 bit image data Table 18 shows sample data for one image line under these conditions In the example shown above the line checksum dat...

Page 45: ... The BCON interface provides two bits that can be used to transmit two camera output signals Output 0 and Output 1 Output 0 and Output 1 are transmitted on data lane X0 at position 0 and 1 see Figure 21 on page 33 Depending on the camera model the following output signals can be available Flash Window Exposure Active User Output 1 User Output 2 For more information about configuring output signals...

Page 46: ...ormats Mono 12 Bayer 12 However information about the specific pixel format used for frame acquisition is included in the FrameInfo part of the data stream The FrameInfo part is sent before each frame transmission For more information see Section 5 2 3 on page 34 Pixel Format Available on Bit Depth Mono 8 Mono cameras only 8 Bayer 8 Color cameras only Mono 12 Mono cameras only 12 Bayer 12 Color ca...

Page 47: ...ansmits the data for the second pixel in line one and so on until the line is complete When line one is complete the camera sends a checksum for the line After that transmission of line two begins and proceeds in a similar fashion Data transmission continues line by line until all frame data has been transmitted During pixel data transmission the 24 bits of the data channel will be used as shown i...

Page 48: ...transmission of line two begins and proceeds in a similar fashion Data transmission continues line by line until all frame data has been transmitted During pixel data transmission the 24 bits of the data channel will be used as shown in Table 21 Setting the Number of Pixels per Clock Cycle You can use the pylon API to set the number of pixels per clock cycle from within your application software T...

Page 49: ...uency fBitClk is not transmitted but can be calculated The bit clock frequency is 7 times faster than the word clock frequency fBitClk fWordClk 7 Setting the Clock Speed You can use the pylon API to set the BCON pixel clock speed from within your application software The following code snippet illustrates using the API to set the clock speed Set the BCON output clock speed to 84 MHz Camera BCONClo...

Page 50: ...dle data transfers at up to 400 kbit s Fast Mode according to I C Fast Mode Fm devices are downward compatible and can communicate with Standard Mode Sm devices in a 0 to 100 kbit s I C bus system However as they are not upward compatible Fast Mode devices should not be integrated in an I C bus system that is configured for a faster mode i e Fast Mode Plus Fm or High Speed Mode Hs Fast Mode device...

Page 51: ... the camera because it does not respond anymore you can activate a reset function via the I2C_ID line The I2C_ID line is set to a certain logical level i e either to 0 low or to 1 high 1 Set the I2C_ID line to the opposite logical level for at least 100 ms 2 Set the I2C_ID line back to its original logical level The switch back will trigger the reset of the microcontroller The FPGA will be loaded ...

Page 52: ...e trace matches the impedance of the differential trace it consumes most of the energy of the wave Therefore both the differential traces and the termination resistors must have an impedance of 100 ohm If they do not match the target impedance the reflected wave can disturb the original signal and cause bit errors Design Recommendations for Data Transmission Printed Circuit Board PCB Design the PC...

Page 53: ...facing down When ordering a custom flexible flat cable specify the FFC connector see next section to ensure that the ground tab is in the correct position and the retaining tabs have the correct shape When using a standard flexible flat cable without a ground layer and retaining tabs keep the cable short and avoid close proximity to other materials Note that the pull out force is reduced when usin...

Page 54: ...face I2C_SDC I2C_SDA I2C_ID Basler dart BCON cameras use the I C interface to exchange configuration data with the controlling processor I C is an open collector bus interface with two signal lines SDA and SCL Connect these signal lines to the appropriate ports of an I C controller Typically an I C controller is part of the microcontroller or the System on a Chip SoC that you will be using to proc...

Page 55: ... I C bus Specification and User Manual 6 4 Power Supply GND VCC The camera needs a single 5 V power supply Bad power quality can deteriorate the camera s image quality However a properly designed switched mode power supply as used to supply a USB port will yield a good result Design Recommendations for the Power Supply The power supply should be able to supply 1 5 W per camera Note that long cable...

Page 56: ... as well as Channel Link deserializer devices For full speed operation the FPGA must support a bit rate of at least 560 Mb s The Channel Link deserializer device must support 28 bits and 84 MHz or more For a list of suitable Channel Link devices see the Channel Link Design Guide The download link is provided in Section 1 3 on page 2 ...

Page 57: ...oating point unit download the hardfloat version file name pylon x x x xxxx armhf tar gz b If your ARM processor doesn t have a floating point unit or if you are unsure download the softfloat version file name pylon x x x xxxx armel tar gz 2 Use an unzip tool of your choice to unpack the TAR archive to your home directory 3 Change to the archive s main directory and open the INSTALL text file 4 Fo...

Page 58: ...ers The Debouncer feature aids in discriminating between valid and invalid input signals and only lets valid signals pass to the camera The debouncer value specifies the minimum time that an input signal must remain high or remain low in order to be considered a valid input signal The debouncer delays a valid signal between its arrival at the camera and its transfer The duration of the delay will ...

Page 59: ... debouncer time in µs You can set the LineSelector and the LineDebouncerTime parameter from within your application software by using the Basler pylon API The following code snippet illustrates using the API to set the selector and the parameter value Select the input line camera LineSelector SetValue LineSelector_CC0 Set the parameter value e g to 10 microseconds camera LineDebouncerTime SetValue...

Page 60: ...true to enable inversion on the selected line or to false to disable inversion You can set the LineSelector and the LineInverter parameter values from within your application software by using the pylon API The following code snippet illustrates using the API to set the selector and the parameter value Select the input line camera LineSelector SetValue LineSelector_CC0 Enable the inverter on the i...

Page 61: ...n your application software by using the Basler pylon API The following code snippet illustrates using the API to set the selector and the parameter value Select the Flash Window signal as the source signal for the BCON output line 1 camera LineSelector SetValue LineSelector_Line1 camera LineSource SetValue LineSource_FlashWindow For more information about the flash window signal see Section 9 6 2...

Page 62: ...table camera LineSelector SetValue LineSelector_Line1 camera LineSource SetValue LineSource_UserOutput1 Set the status of output line 2 camera UserOutputSelector SetValue UserOutputSelector_UserOutput2 camera UserOutputValue SetValue true Get informed about the current user output value setting for output line 2 bool b camera UserOutputValue GetValue 8 2 3 Output Line Inverter You can set the outp...

Page 63: ...f false means the line s status is currently low You can set the LineSelector 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 the selector and read the parameter value Select input line CC0 and read the status camera LineSelector SetValue LineSelector_CC0 bool b camera LineStatus...

Page 64: ...o read the parameter value Read the line status of both I O lines Because the GenICam interface does not support 32 bit words the line status is reported as a 64 bit value int64_t i camera LineStatusAll GetValue LineStatusAll Parameter Value Binary Expression of the LineStatusAll Parameter Value Hexadecimal Number Binary Number Line 1 Output Line Line 2 Output Line Line 3 Input Line 0x0 000 0 0 0 ...

Page 65: ...d continuous The use of AcquisitionStart and AcquisitionStop commands and the camera s AcquisitionMode parameter setting are related If the camera s AcquisitionMode parameter is set for single frame after an AcquisitionStart command has been executed a single frame can be acquired When acquisition of one frame is complete the camera will execute an AcquisitionStop command internally and will no lo...

Page 66: ...ing These parameters are discussed later in this chapter camera AcquisitionMode SetValue AcquisitionMode_SingleFrame camera TriggerMode SetValue TriggerMode_On camera TriggerSource SetValue TriggerSource_CC0 camera TriggerActivation SetValue TriggerActivation_RisingEdge camera ExposureMode SetValue ExposureMode_Timed camera ExposureTime SetValue 3000 0 camera AcquisitionStart Execute When the came...

Page 67: ...ame acquisition For more information see Section 9 2 2 on page 62 Frame start trigger signals are applied via hardware Each time a proper electrical signal is applied to the input line the camera will begin a frame acquisition For more information see Section 9 2 3 on page 63 9 2 1 Trigger Mode The main parameter associated with the frame start trigger is the TriggerMode parameter The TriggerMode ...

Page 68: ...lowing code snippet illustrates using the API to set the Acquisition Mode to Continuous the Trigger Mode to Off free run and the Acquisition Frame Rate to 60 Set the acquisition mode to Continuous camera AcquisitionMode SetValue AcquisitionMode_Continuous Set the timed exposure mode camera ExposureMode SetValue ExposureMode_Timed Set the exposure time camera ExposureTime SetValue 3000 0 Set the fr...

Page 69: ... are RisingEdge specifies that the rising edge of the electrical signal will act as the frame start trigger FallingEdge specifies that the falling edge of the electrical signal will act as the frame start trigger For more information about using a software trigger see Section 9 2 2 on page 62 using a hardware trigger see Section 9 2 3 on page 63 Do not trigger frame acquisition at a rate that exce...

Page 70: ... by setting the ImmediateTriggerMode parameter to one of the following values On Exposure starts immediately after triggering but changes to image parameters become effective with a short delay i e after one or more images have been acquired This is useful if you want to minimize the exposure start delay i e if you want to start image acquisition as soon as possible and if your imaging conditions ...

Page 71: ...reTime SetValue 3000 0 Execute an AcquisitionStart command to prepare for frame acquisition camera AcquisitionStart Execute while finished Execute a TriggerSoftware command to apply a frame start trigger signal to the camera camera TriggerSoftware Execute Retrieve acquired frame here camera AcquisitionStop Execute 9 2 3 Using a Hardware Frame Start Trigger If the TriggerMode parameter is set to On...

Page 72: ...s determined by the value of the camera s ExposureTime parameter If the camera is set for rising edge triggering the exposure time starts when the ExFSTrig signal rises falling edge triggering the exposure time starts when the ExFSTrig signal falls Figure 25 illustrates timed exposure with the camera set for rising edge triggering When adjusting the settings make sure not to exceed the maximum all...

Page 73: ...e ExFSTrig signal Trigger width exposure is especially useful if you intend to vary the length of the exposure time for each captured frame If the camera is set for rising edge triggering the exposure time begins when the ExFSTrig signal rises and continues until the ExFSTrig signal falls falling edge triggering the exposure time begins when the ExFSTrig signal falls and continues until the ExFSTr...

Page 74: ...frame camera AcquisitionMode SetValue AcquisitionMode_SingleFrame Set the trigger mode to On camera TriggerMode SetValue TriggerMode_On Set the immediate trigger mode to Off camera ImmediateTriggerMode SetValue ImmediateTriggerMode_Off Set the source for the selected trigger camera TriggerSource SetValue TriggerSource_CC0 Set the trigger activation mode to rising edge camera TriggerActivation SetV...

Page 75: ...tValue 40 0 By default the exposure auto function is enabled Manual adjustment of the exposure time will not work Set the ExposureAuto parameter to Off before making any manual adjustments For more information about the exposure auto function see Section 11 11 4 on page 117 Camera Model Minimum Allowed Exposure Time Maximum Possible Exposure Time Increment daA1600 60bm bc 10 µs 850000 µs 1 µs All ...

Page 76: ...ctronic Rolling Shutter ERS Global Reset Release Mode GRR For moving objects For stationary objects not moving objects Lower ambient noise If used for moving objects Use of flash lighting and flash window recommended For stationary objects not moving objects Use of flash lighting and flash window is a must Table 25 Overview of Shutter Modes Camera Model Shutter Type Supported Shutter Modes daA1280...

Page 77: ...ach acquired image and it helps to minimize problems with acquiring images of objects in motion Immediately after the end of exposure pixel data readout begins and proceeds in a linewise fashion until all pixel data is read out of the sensor Camera Model Global Shutter Available daA1280 54bm bc daA1600 60bm bc Yes daA2500 14bm bc No Table 27 Global Shutter Availability Line 1 Line 2 Line 4 Line 3 ...

Page 78: ...next When frame start is triggered the camera resets line one of the ROI and begins exposing line one resets line two a short time later temporal offset and begins exposing line two resets line three a short time later than line two additional temporal offset and begins exposing line three And so on until the bottom line of pixels is reached see Figure 30 Camera Model Rolling Shutter Available daA...

Page 79: ...ure time for line one is determined by the ExposureTime parameter setting for line two will end a short time temporal offset after the exposure ends for line one for line three will end another short time temporal offset after the exposure ends for line two And so on until the bottom line of pixels is reached see Figure 31 The pixel values for each line are read out at the end of exposure time for...

Page 80: ... will vary significantly from top to bottom due to the differences in the exposure times of the lines moving objects the brightness in each acquired image will vary significantly from top to bottom due to the differences in the exposure times of the lines and the images will be distorted due to the temporal shift between the end of exposure for each line You can avoid these problems by using flash...

Page 81: ... with the camera set for the trigger width exposure mode In the overlap mode of operation the exposure of a new frame begins while the camera is still reading out the sensor data for the previously acquired frame This situation is illustrated in Figure 33 with the camera set for the trigger width exposure mode Frame Acquisition N Exposure Sensor Readout Frame Acquisition N 1 Exposure Sensor Readou...

Page 82: ...e 59 To allow overlapping image acquisitions the camera must be in the continuous acquisition mode Overlapping image acquisition can t be performed if the camera s acquisition mode is set to single frame For more information about the acquisition mode see Section 9 1 on page 57 Camera Model Rolling Shutter Mode Trigger Mode Overlapping Image Acquisitions allowed daA1280 54bm bc daA1600 60bm bc Not...

Page 83: ...on overlap mode of operation see Section 9 5 on page 73 The following code snippet illustrates using the pylon API to set the OverlapMode parameter value Set for the overlapping mode of operation camera OverlapMode SetValue OverlapMode_On Set for the non overlapping mode of operation camera OverlapMode SetValue OverlapMode_Off 9 6 Acquisition Monitoring Tools 9 6 1 Exposure Active Signal Cameras w...

Page 84: ...selector and the parameter value camera LineSelector SetValue LineSelector_Line1 camera LineSource SetValue LineSource_ExposureActive For more information about changing the selection of an output signal as the source signal for the output line see Section 8 2 1 on page 53 9 6 2 Flash Window Signal Cameras with a rolling shutter imaging sensor provide a flash window output signal to aid you in the...

Page 85: ...n software by using the Basler pylon API The following code snippet illustrates using the API to set the selector and the parameter value camera LineSelector SetValue LineSelector_Line1 camera LineSource SetValue LineSource_FlashWindow For more information about changing the selection of an output signal as the source signal for the output line see Section 8 2 2 on page 53 The flash window signal ...

Page 86: ... overlapping image acquisitions see Section 9 5 on page 73 To determine the maximum allowed acquisition frame rate with your current camera settings use the Basler pylon API to read the value of the camera s ResultingFrameRate parameter For more information see Section 9 7 1 on page 78 9 7 1 Using the Basler pylon API to Check the Maximum Allowed Frame Rate You can use the Basler pylon API to read...

Page 87: ...allowed frame rate increases You may need to compensate for a lower exposure time by using a brighter light source or increasing the opening of your lens aperture If your camera is equipped with a rolling shutter use the electronic rolling shutter ERS mode rather than the global reset release shutter mode The ERS mode allows overlapping frame acquisition while the global reset release mode does no...

Page 88: ...g the Basler pylon API The following code snippet illustrates using the API to set the pixel format to Bayer GB 12 Set the pixel format to Bayer GB 12 camera PixelFormat SetValue PixelFormat_BayerGB12 The standard alignment of the Bayer filter to the pixels in the images acquired by the dart BCON color cameras is GB If you are using dart model daA1600 60bc or daA2500 14bc the alignment will change...

Page 89: ...olor model The conversion algorithm uses the following formulas Y 0 299 R 0 587 G 0 114 B Cb 0 16874 R 0 33126 G 0 5000 B 128 Cr 0 5000 R 0 41869 G 0 08131 B 128 After conversion to the YCbCr color model is complete the pixel data is transmitted out of the camera Bayer Formats All dart BCON color cameras can output color images based on the pixel formats Bayer 8 and Bayer 12 When a color camera is...

Page 90: ...erse X Reverse Y Section 11 9 Binning Section 11 8 Image ROI Section 11 7 Black Level Section 11 3 Gain Section 11 2 On daA1280 54bm uc camera models black level settings are applied after the gain settings Color camera models only Can be used in any sequence Light Source Preset Section 11 6 2 Balance White Section 11 6 3 Gamma Section 11 4 Hue Saturation Section 11 6 4 Brightness Contrast Section...

Page 91: ...he camera were no higher than 127 in an 8 bit mode you could increase the gain to 6 dB an amplification factor of 2 and thus reach gray values of 254 This section describes how gain can be adjusted manually by setting the value of the Gain parameter The camera also has a gain auto function that can automatically adjust the gain The camera s gain is determined by the value of the Gain parameter The...

Page 92: ...be adjusted by changing the value of the BlackLevel parameter The range of the allowed settings for the BlackLevel parameter value in DN varies by pixel format as shown in Table 33 You can set the BlackLevel 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 Set the black level to 1 0 c...

Page 93: ...tion value You can set the BslColorSpaceMode parameter to the following values sRGB The image brightness is optimized for display on an sRGB monitor An additional gamma correction value of approximately 0 4 is applied This is the default setting Note that the sRGB gamma correction is independent from the Gamma parameter and will not be reflected in the Gamma parameter value Example You set the Bsl...

Page 94: ... range from 1 to 1 By default the parameter is set to 0 and no brightness adjustment is performed Adjusting the brightness moves the pivot point of the Brightness Contrast function Figure 38 shows an example for the S curve contrast mode set For more information about contrast and contrast modes see Section 11 5 2 on page 87 If you increase the brightness the pivot point moves towards the upper le...

Page 95: ...n in Figure 41 input values from 0 to approximately 50 are set to completely black and input values from approximately 205 to 255 are set to completely white This means that the overall range of tonal values i e the dynamic range of the image is decreased The darkest and lightest regions of the image will appear completely black or completely white but the other areas will appear more defined Decr...

Page 96: ...ax Ymax the dynamic range of the image is always preserved Setting contrast below 0 in S curve mode results in an inverted S curve with opposite effects 11 5 3 Setting Brightness and Contrast You can set brightness and contrast within your application software by using the pylon API The following code snippet illustrates using the API to set the parameters Set the Brightness parameter value to 0 5...

Page 97: ...r filter used on the camera is as shown in Figure 43 As the figure illustrates within each square of four pixels one pixel sees only red light one sees only blue light and two pixels see only green light This combination mimics the human eye s sensitivity to color Bayer GB alignment for example means that pixel one and pixel two of the first line in each image transmitted will be green and blue re...

Page 98: ... inaccuracies caused by the image sensor The standard alignment of the Bayer filter to the pixels in the images acquired by the dart BCON color cameras is GB If you are using dart model daA1280 54bc this alignment is fixed If you are using dart model daA1600 60bc or daA2500 14bc the alignment will change if you enable image mirroring If you use the Reverse X feature to mirror the image horizontall...

Page 99: ...e balance white auto function is disabled white balance must be reset before changing the preset camera BalanceWhiteAuto SetValue BalanceWhiteAuto_Off camera BalanceRatioSelector SetValue BalanceRatioSelector_Red camera BalanceRatio SetValue 1 camera BalanceRatioSelector SetValue BalanceRatioSelector_Green camera BalanceRatio SetValue 1 camera BalanceRatioSelector SetValue BalanceRatioSelector_Blu...

Page 100: ...anceRatio parameter value can range from 1 to 7 984375 BalanceRatio 1 The intensity of the color is unaffected by the white balance mechanism Balance ratio 1 The intensity of the color is increased relative to the other two colors Balance ratio 1 The intensity of the color is decreased relative to the other two colors The increase or decrease in intensity is proportional For example if the balance...

Page 101: ...ration for example will make colors easier to distinguish You can adjust the saturation by setting the BslSaturation parameter By default the parameter is set to 1 normal saturation Lower parameter values result in more muted colors that are closer to gray Higher parameter values result in more vivid vibrant colors Setting Hue and Saturation You can set hue and saturation within your application s...

Page 102: ...re done automatically and can t be controlled by the user The PGI image optimizations take effect whenever the pixel format is set to YCbCr422 or RGB 8 To disable PGI image optimizations set the pixel format to Bayer 8 or Bayer 12 For more information about pixel formats see Chapter 10 on page 80 the Sharpness Enhancement feature see Section 11 6 6 on page 95 the PGI image optimizations see the wh...

Page 103: ...e pylon API The following code snippet illustrates using the API to set the SharpnessEnhancement parameter value Set the SharpnessEnhancement parameter value to 0 39 camera SharpnessEnhancement SetValue 0 39 The Sharpness Enhancement feature is only available if the pixel format is set to YCbCr422 or RGB 8 For more information about pixel formats see Chapter 10 on page 80 If you use the Gain and t...

Page 104: ...black level and gain so that you are acquiring good quality images It is important to make sure that the images are not overexposed Overexposure can have a significant negative effect on the fidelity of the color in the acquired images Generally the settings for black level and gain should be as low as possible 8 Adjust the white balance Make sure a white or light gray object is imaged while white...

Page 105: ...a height For example suppose that you specify the offset X as 10 the width as 16 the offset Y as 6 and the height as 10 The region of the array that is bounded by these settings is shown in Figure 44 The camera will only transmit pixel data from within the region defined by your settings Information from the pixels outside of the region of interest is discarded One of the main advantages of the Im...

Page 106: ...t Y ROI height Height of camera sensor daA1600 60um Offset Y 351 ROI height 200 Height of camera sensor 1200 351 200 1200 Table 34 Guidelines for Setting the Camera s ROI ROI Parameters Camera Model Parameter Range Example OffsetX OffsetY daA1280 54bm bc daA1600 60bc daA2500 14bm bc Can be set in increments of 2 Must be set to an even number 0 2 4 6 8 etc OffsetX daA1600 60bm Can be set in increme...

Page 107: ...ting the OffsetX OffsetY Width and Height parameter values int64_t i camera WidthMax GetValue int64_t i camera HeightMax GetValue camera Width SetValue 1294 camera Height SetValue 964 camera OffsetY SetValue 0 camera OffsetX SetValue 0 Changing ROI Parameters On the Fly Making ROI parameter changes on the fly means making the parameter changes while the camera is capturing images continuously On t...

Page 108: ... distorted in the image For more information about possible image distortion see Section 11 8 3 on page 104 The number of binned pixels depends on the horizontal binning and the vertical binning settings For more information about the binning settings see Section 11 8 1 on page 101 Binning Modes Two modes can be used to perform binning Sum The values of the affected pixels are summed This increase...

Page 109: ... enable horizontal binning by setting the BinningHorizontal parameter vertical binning by setting the BinningVertical parameter Setting the parameter s value to 2 3 or 4 enables horizontal or vertical binning by 2 by 3 or by 4 respectively Setting the parameter s value to 1 disables horizontal or vertical binning Vertical Binning by 2 Horizontal Binning by 4 Fig 45 Binning on Monochrome Cameras Ve...

Page 110: ...meter first then set the BinningVertical parameter If the BinningHorizontal parameter is not set first some combinations of vertical binning and horizontal binning can t be achieved For a list of allowed combinations see Table 36 Example On daA1600 60bm bc cameras you can t set the BinningVertical parameter to 2 when the BinningHorizontal parameter is set to 1 Set the BinningHorizontal parameter t...

Page 111: ...Sum Determine the vertical binning mode e camera BinningVerticalMode GetValue Always set the BinningHorizontalMode parameter first then set the BinningVerticalMode parameter If the BinningHorizontalMode parameter is not set first some combinations of the binning horizontal mode and the binning vertical mode can t be achieved For a list of allowed combinations see Table 37 Example On daA1600 60bm b...

Page 112: ...n page 100 can greatly increase the camera s response to light When pixel values are summed the acquired images may look overexposed If this is the case you can reduce the lens aperture the intensity of your illumination the camera s exposure time setting or the camera s gain setting Reduced Resolution Using binning effectively reduces the resolution of the camera s imaging sensor For example the ...

Page 113: ...ured image will be swapped end for end about the line s center This means that for each line the value of the first pixel in the line will be swapped with the value of the last pixel the value of the second pixel in the line will be swapped with the value of the next to last pixel and so on Figure 47 shows a normal image on the left and an image captured with reverse X enabled on the right If you ...

Page 114: ...vertical mirror image feature When the Reverse Y feature is enabled the lines in a captured image will be swapped top to bottom This means that the top line in the im age will be swapped with the bottom line the next to top line will be swapped with the next to bot tom line and so on Figure 49 shows a normal image on the left and an image captured with reverse Y enabled on the right If you are usi...

Page 115: ... remains the same regardless of whether or not the Reverse Y feature is enabled As a consequence different regions of the image will be controlled or displayed depending on whether or not the Reverse Y feature is enabled See example in Figure 50 Fig 49 Reverse Y Mirror Imaging Normal Image Reverse Y Mirror Image Fig 50 Using an ROI with Reverse Y Mirror Imaging Normal Image Reverse Y Mirror Image ...

Page 116: ...atures by setting the ReverseX and the ReverseY parameter values You can use the pylon API to set the parameter values from within your application software The following code snippet illustrates using the API to set the parameter values Enable reverse X camera ReverseX SetValue true Enable reverse Y camera ReverseY SetValue true ...

Page 117: ...nly corrects pixels that have a significantly greater intensity value than its neighboring pixels You can specify which corrections should be performed by setting the DefectPixelCorrectionMode parameter On default Static and dynamic pixel corrections are both enabled Off Static and dynamic pixel corrections are both disabled StaticOnly Only the static pixel correction is enabled You can set the De...

Page 118: ...eration is selected the parameter values are automatically adjusted until the related image property reaches the target value After the automatic parameter value adjustment is complete the auto function will automatically be set to Off and the new parameter value will be applied to the following images By default all auto functions exposure auto balance white auto and gain auto are enabled They ar...

Page 119: ...o Off When an auto function is set to Off the parameter value resulting from the latest automatic adjustment will operate unless the parameter is manually adjusted If an auto function is set to the Once operation mode and the circumstances prevent that a target value for an image property is reached the auto function will try to reach that target value for a maximum of 50 or 100 images depending o...

Page 120: ...ttings are always identical for both auto functions This does not imply however that Gain Auto and Exposure Auto must always be used at the same time The pixel data from Auto Function ROI 2 serves as the base for Balance White Auto These presets are fixed and can t be changed The location and size of an Auto Function ROI is defined by declaring an X offset a Y offset a width and a height Auto Func...

Page 121: ... pylon API The following code snippets illustrate using the API to select an Auto Function ROI and set its size and position Select Auto Function ROI 1 camera AutoFunctionROISelector SetValue AutoFunctionROISelector_ROI1 Set position and size for the selected Auto Function ROI camera AutoFunctionROIOffsetX SetValue 10 camera AutoFunctionROIOffsetY SetValue 10 camera AutoFunctionROIWidth SetValue 5...

Page 122: ...e image property If the Image ROI is completely included in the Auto Function ROI see b in Figure 52 only the pixel data from the Image ROI will be used to control the image property If the Image ROI only partially overlaps the Auto Function ROI see c in Figure 52 only the pixel data from the area of partial overlap will be used to control the image property If the Auto Function ROI does not overl...

Page 123: ... 13 14 15 16 17 18 19 0 1 0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Fig 52 Various Degrees of Overlap Between the Auto Function ROI and the Image ROI Image ROI Auto Function ROI a c d Image ROI Image ROI Auto Function ROI Auto Function ROI 0 1 0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 ...

Page 124: ...Gain parameter value will never be lower than 2 and never be higher than 6 Target Value When the gain auto function is enabled it adjusts the gain until a target brightness i e an average gray value is reached You can set the target value using the AutoTargetBrightness parameter The parameter value range refers to the theoretically maximum available range of gray values for the set pixel format Ex...

Page 125: ...ontinuous camera GainAuto SetValue GainAuto_Continuous For more information about auto functions see Section 11 11 on page 110 11 11 4 Exposure Auto Exposure Auto is the automatic counterpart to manually setting the ExposureTime parameter The exposure auto function automatically adjusts the ExposureTime parameter value within set limits until a target brightness value for the pixel data is reached...

Page 126: ...TimeUpperLimit parame ters 2 Set the value of the AutoTargetBrightness parameter 3 Set the value of the ExposureAuto parameter for the Once or the Continuous mode of operation You can set the exposure auto function from within your application software by using the pylon API The following code snippets illustrate using the API to set the exposure auto function Set the lowest possible lower limit a...

Page 127: ...or the Continuous mode of operation You can set the white balance auto functionality from within your application software by using the pylon API The following code snippets illustrate using the API to set the balance auto functionality Set mode of operation for balance white auto function to Once camera BalanceWhiteAuto SetValue BalanceWhiteAuto_Once Set mode of operation for balance white auto f...

Page 128: ... 50 Hz or a 60 Hz rate the flickering lights can cause significant changes in brightness from image to image Enabling the anti flicker profile may reduce the effect of the flickering in the captured images Depending on your local power line frequency e g North America 60 Hz Europe 50 Hz set the auto function profile to AntiFlicker50Hz or to AntiFlicker60Hz 1 Set the value of the AutoFunctionProfil...

Page 129: ...formed by the gain auto function and the exposure auto function see Section 11 11 3 on page 116 and Section 11 11 4 on page 117 For example if you set the parameter value to 0 3 then 30 of the brightest pixels in the image will not be taken into account for the target value calculations This allows the camera to properly expose the darker regions of the image You can set the backlight compensation...

Page 130: ... software by using the Basler pylon API The following code snippets illustrate using the API to set the parameter Set for no test pattern camera TestPattern SetValue TestPattern_Off Set for the first test pattern camera TestPattern SetValue TestPattern_GreyDiagonalSawtooth8 Set for the second test pattern camera TestPattern SetValue TestPattern_ColorDiagonalSawtooth8 Test Pattern 1 Gray Diagonal S...

Page 131: ...er dart BCON 123 Test Pattern 2 Color Diagonal Sawtooth The test pattern Color Diagonal Sawtooth is available on color cameras only As shown in Figure 54 the test pattern consists of diagonal color gradients Fig 54 Test Pattern 2 ...

Page 132: ...ample area scan SensorWidth read only contains the physical width of the sensor in pixels SensorHeight read only contains the physical height of the sensor in pixels MaxWidth read only Indicates the camera s maximum region of interest ROI width setting for the current OffsetX settings MaxHeight read only Indicates the camera s maximum region of interest ROI height setting for the current OffsetY s...

Page 133: ...ue Read the DeviceScanType parameter DeviceScanTypeEnums e camera DeviceScanType GetValue Read the SensorWidth parameter int64_t i camera SensorWidth GetValue Read the SensorHeight parameter int64_t i camera SensorHeight GetValue Read the WidthMax parameter int64_t i camera WidthMax GetValue Read the HeightMax parameter int64_t i camera HeightMax GetValue ...

Page 134: ...ra is reset or if power is switched off Factory Set Default When a camera is manufactured numerous tests are performed on the camera and a factory optimized setup is determined This factory setup is stored in the Default set It is optimized for average conditions and will provide good camera performance in many common applications In the Default set the gain auto exposure auto and white balance au...

Page 135: ...see Section 11 15 3 on page 129 11 15 1 Saving a User Set After setting your camera parameter values you can save most of the settings for further use into User Set 1 User Set 2 or User Set 3 These user sets are not lost when the camera is reset or switched off 1 Make changes to the camera s settings until the camera is operating in a manner that you would like to save 2 Set the UserSetSelector pa...

Page 136: ...ommand from within your application software by using the pylon API The following code snippets illustrate using the API select User Set 2 and execute the load command camera UserSetSelector SetValue UserSetSelector_UserSet2 camera UserSetLoad Execute To load a user set or the factory set into the active set Loading a user set or the factory set into the active set is only allowed when the camera ...

Page 137: ...s not acquiring images continuously or does not have a single image acquisition pending Set the UserSetDefault parameter to UserSet1 UserSet2 UserSet3 or to Default You can set the UserSetDefault parameter from within your application software by using the pylon API The following code snippets illustrate using the API to set the selector camera UserSetDefault SetValue UserSetDefault_UserSet1 To de...

Page 138: ...b com If you do decide to contact Basler technical support please take a look at Section 12 3 on page 131 before you call The section gives information about assembling relevant data that will help the Basler technical support team to help you with your problem 12 2 Obtaining an RMA Number Whenever you want to return material to Basler you must request a Return Material Authorization RMA number be...

Page 139: ...rt use the form given below 1 Copy the form that appears below fill it out and send it with sample images if appropriate attached to your e mail to Basler technical support or fax the completed form with the requested files attached to your local dealer or to Basler technical support To use the form 1 The camera s product ID 2 The camera s serial number 3 Hardware that you use with the camera 4 De...

Page 140: ...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 If you can t access the camera please try to state the following parameter settings Image Size ROI Pixel Format Exposure Time Frame Rate 11 Live image test pattern If you are having an image problem try to generate and save live images that show...

Page 141: ...m 32 36 color anti aliasing 94 color creation 89 color enhancement procedure 96 color filter alignment 80 89 90 105 106 color space mode 81 85 contrast linear 87 S curve 87 D data lanes 33 44 debayering 94 defect pixel correction 109 denoising 94 device information parameters 124 device version parameter 124 dimensions 14 duty cycle 41 E electronic rolling shutter mode 68 70 ERS mode see electroni...

Page 142: ...O offset X 97 offset Y 97 outlier pixels 109 output bits 32 37 output clock 41 overlap mode 73 75 overtriggering 61 66 P PGI feature set 94 physical sensor 104 pixel formats 38 pixels per clock cycle 39 power supply 4 47 LPS 4 SELV 4 precautions 3 R reduced resolution 104 region of interest see image region of interest reverse X 105 reverse Y 106 ROI see image region of interest S saving parameter...

Page 143: ... temperature 21 temperature measurement point 21 test images 122 test patterns 122 typographic conventions 2 U underexposure 121 user ID parameter 124 user output 53 user set saving 127 V vendor name parameter 124 vertical mirror image 106 W white balance see balance white white balance auto see balance white auto word alignment 37 ...

Page 144: ...art BCON Revision History Doc ID Number Date Changes AW00136901000 23 Jun 2016 Initial release of this document AW00136902000 01 Nov 2016 Modifications and corrections related to the development of the camera from prototype to serial production ...

Reviews: