background image

 

64  

 

Appendix A: GenICam Commands  

o

 

A return value of 0 is success. Error codes are listed in the XML. 

 

Read FileSize to get the number of bytes in the file 

 

From FileAccessBuffer.Length you will know that maximum number of bytes that can be read 
through FileAccessBuffer is 988. 

 

For Offset = 0 While ((Offset < FileSize) and (Status = 0)) Do 

o

 

Set FileAccessOffset to Offset 

o

 

Set FileAccessLength to min(FileSize - Offset,  FileAccessBuffer.Length), the number of bytes 
to read 

o

 

Set the FileOperationSelector to Read 

o

 

Read the file by setting FileOperationExecute to 1 and poll until 0 and complete 

o

 

Read FileOperationStatus to confirm the read worked 

o

 

Read FileOperationResult to confirm the number of bytes read 

o

 

Read the bytes from FileAccessBuffer 

o

 

Write bytes read to host file. 

 

Next Offset =  number of bytes read 

 

Set the FileOperationSelector to Close 

 

Close the file by setting FileOperationExecute to 1 and poll until 0 and complete 

 

Read FileOperationStatus to confirm the close worked 

  

Upload File to Camera

 

 

Select the file by setting the FileSelector feature 

 

Set the FileOpenMode to Write 

 

Set the FileOperationSelector to Open 

 

Open the file by setting FileOperationExecute to 1 
This is a read-write feature - poll it every 100 ms until it returns 0 to indicate it has completed 

 

Read FileOperationStatus to confirm that the file opened correctly 
A return value of 0 is success. Error codes are listed in the XML. 

 

Read FileSize to get the maximum number of bytes allowed in the file 

o

 

Abort and jump to Close if this is less the file size on the host 

 

From FileAccessBuffer.Length you will know that maximum number of bytes that can be written 
through FileAccessBuffer is 988. 

 

For Offset = 0 While ((Offset < Host File Size) and (Status = 0)) Do 

o

 

Set FileAccessOffset to Offset 

o

 

Set FileAccessLength to min(Host File Size - Offset,  FileAccessBuffer.Length), the number of 
bytes to write 

o

 

Read next FileAccessLength bytes from host file. 

o

 

Write the bytes to FileAccessBuffer 

o

 

Set the FileOperationSelector to Write 

o

 

Write to the file by setting FileOperationExecute to 1 and poll until 0 and complete 

o

 

Read FileOperationStatus to confirm the write worked 

o

 

Read FileOperationResult to confirm the number of bytes written 

 

Next Offset =  number of bytes written 

 

Set the FileOperationSelector to Close 

 

Close the file by setting FileOperationExecute to 1 and poll until 0 and complete 

Summary of Contents for Linea HS Series

Page 1: ...Linea HS TDI Cameras Monochrome CMOS TDI HL FM 08K30H 00 R and HL HM 16K30H 00 R sensors cameras frame grabbers processors software vision solutions 03 032 20269 00 www teledynedalsa com...

Page 2: ...tures and markets digital imaging products and solutions in addition to providing wafer foundry services Teledyne DALSA offers the widest range of machine vision components in the world From industry...

Page 3: ...WARE 16 Using Sapera CamExpert 16 CamExpert Panes 17 SETTING UP FOR IMAGING 20 Powering the Camera 20 Power and GPIO Connections 21 Establishing Camera Communications 23 Selecting the Data Format 23 E...

Page 4: ...des BIST 47 Camera Power Up Configuration Selection Dialog 48 Camera Power up Configuration 48 User Set Configuration Management 48 Camera Control Category 48 Camera Control Feature Descriptions 49 Di...

Page 5: ...The Linea HS Monochrome Cameras 5 DECLARATION OF CONFORMITY 73 DOCUMENT REVISION HISTORY 74...

Page 6: ...ents LC or CX4 resolution dependent Teledyne DALSA s Linea HS cameras and compatible frame grabbers combine to offer a complete solution for the next generation of automatic optical inspection AOI sys...

Page 7: ...CX4 16K Camera Link HS control data connector Smart lens shading correction High dynamic LUT mode Programmability Multiple areas of interest for data reduction Region of interest for easy calibration...

Page 8: ...amera description file Embedded within camera Sapera LT including CamExpert GUI application and GenICam for Camera Link imaging driver Latest version on the TeledyneDALSA Web site Performance Specific...

Page 9: ...50 of calibration target DSNU FPN 2 DN SEE 0 5 nJ cm 2 670 nm NEE 0 4 pJ cm 2 670 nm Integral non linearity 2 DN digital number Test Conditions unless otherwise specified Values measured using 8 bit 1...

Page 10: ...xel Scan Direction Readout Readout 175 m gap equivalent to 35 lines 163 Line Correction Figure 1 HL FM 08K30H 00 R and HL HM 16K30H 00 R Pixel Structure Camera Processing Chain The diagram below detai...

Page 11: ...s It is used where an industrial digital camera interfaces with a single or multiple frame grabbers and with data rates exceeding those supported by the standard Camera Link The Linea HS cameras come...

Page 12: ...yne DALSA Support for more information on recommended cables Category Fiber Diameter Mode Max Distance OM3 50 m Multimode 280 m OM4 50 m Multimode 300 m CX4 AOC 16K Cameras For the 16K camera the Came...

Page 13: ...The Linea HS Monochrome Cameras 13 Responsivity QE Plots Note values measured using 8 bit 1x gain main array...

Page 14: ...14 The Linea HS Monochrome Cameras Mechanical Drawings Figure 3 HL FM 08K30H 00 R Mechanical Drawing...

Page 15: ...The Linea HS Monochrome Cameras 15 Figure 4 HL HM 16K30H 00 R Mechanical Drawing...

Page 16: ...ed that you power down and disconnect power to the camera before you add or replace system components Electrostatic Discharge and the CMOS Sensor Image sensors and the camera s housing can be suscepti...

Page 17: ...es For context sensitive help click on the button and then click on a camera configuration parameter A short description of the configuration parameter will be shown in a popup Click on the button to...

Page 18: ...with the Sapera installation or saved by the user Parameters pane Allows the viewing or changing of all acquisition parameters supported by the acquisition device CamExpert displays parameters only i...

Page 19: ...a Stretch image to fit set image display to original size or zoom the image to virtually any size and ratio Histogram Profile tool Select to view a histogram or line column profile during live acquisi...

Page 20: ...24 V Incorrect voltages may damage the camera Before connecting power to the camera test all power supplies Protect the camera with a 3 amp slow blow fuse between the power supply and the camera Do no...

Page 21: ...V TTL 5 Input Line 1 Trigger Phase A 0 to 3 3 V TTL 6 Input Line 2 Scan Direction Phase B 0 to 3 3 V TTL 7 Output Line 5 Out 0 to 3 3 V TTL 8 Output Line 6 Out 0 to 3 3 V TTL 9 Power Ground 10 12 V t...

Page 22: ...Characteristics Switching Voltage Input Level Standard Low to high High to low Input Impedance 3 3 V TTL 2 1 V 1 V 10 K External Input Timing Reference Input Level Standard Maximum Input Frequency Min...

Page 23: ...LHS Link has been established and the camera is ready for data transfer to begin When the camera s LED state is steady green open the first instance of CamExpert 1 CamExpert will search for installed...

Page 24: ...using pin 5 and pin 6 of the GPIO connector Use the Trigger Activation feature to select the edge that triggers the camera The options are Rising Edge Falling Edge or Any Edge When using Any Edge be...

Page 25: ...te for all camera models is 300 Hz Scan Direction See the section Camera Control Category in Appendix A for GenICam features associated with this section and how to use them Related Feature sensorScan...

Page 26: ...26 Camera Performance and Features Figure 7 Image with incorrect scan direction...

Page 27: ...cs of the lens the direction of the objects motion is opposite to the image motion direction Some AOI systems require that the scan direction change at regular intervals For example scanning a panel f...

Page 28: ...y when using the camera with the main array only Second Array 64 rows 5 m x 5 m pixel Main Array 128 rows 5 m x 5 m pixel Scan Direction Readout Readout 175 m gap equivalent to 35 lines 163 Line Corre...

Page 29: ...ark and light areas can be imaged at the same time thereby improving the inspection time throughput Note in HDR mode image data is collected from 2 TDI arrays i e the camera outputs two rows that will...

Page 30: ...ferent TDI modes the number of stages in the array is adjusted resulting in different responsivities In TDI mode the main array is configurable to 128 or 64 stages The second array is not used In HDR...

Page 31: ...ht Source Strobe Relevant Features outputLineSource outputLinePulseDelay outputLinePulseDuration LineInverter Note TDI sensors do not have exposure control built into the sensor The pixels are continu...

Page 32: ...he section Flat Field Category in Appendix A for GenICam features associated with this section and how to use them Related Features Calibrate FPN Calibrate PRNU Calibration Algorithm Calibration Targe...

Page 33: ...operation in order to get the mid DN level for flat field calibration Once complete return the exposure time to its original setting Those areas of the image where high roll off is present will show...

Page 34: ...al lines One way to minimize this effect is to have the white target in motion during the calibration process This has the result of averaging out any dirt or texture present If this is not possible t...

Page 35: ...5 of the adjacent pixels 12 5 75 12 5 Figure 12 1 x 3 kernel The 1 x 5 filter kernel uses 50 of the original pixel and 12 5 of the adjacent two pixels on both sides of the original pixel 12 5 50 12 5...

Page 36: ...hat is 1x2 and 2x1 are twice as bright 2x2 is four times brighter etc Horizontal 2x binning will halve the amount of image data out of the camera This can be used to save processing bandwidth in the h...

Page 37: ...ailable CLHS data lanes The camera XML will enforce these rules truncating entered values where necessary 1 Acquisition must be stopped to change the AOI configuration 2 1 4 AOI s can be selected 3 Mi...

Page 38: ...t can be configured to create a 12 bit in 16 bit out LUT the camera will convert it to the required format 1 Open CamExpert version 8 40 2 Device should be an Xtium2 connected to a Linea camera 3 Unde...

Page 39: ...se the maximum exposure time possible based on the maximum line rate of the inspection system and any margin that may be required to accommodate illumination degradation However it will be necessary t...

Page 40: ...is section and how to use them Related Feature Pixel Format The camera can output video data as 8 bit or 12 bit Use the Mono8 Pixel Format to process image data as one or two separate image planes Not...

Page 41: ...ecomes active when the camera is reset or powered up The relationship between these four settings is illustrated in Figure 16 Relationship between the Camera Settings Figure 16 Relationship between th...

Page 42: ...tores the user set configured as the default set when it powers up To restore a saved user set set the user set selector to the set you want to restore and then select the user set load parameter Fact...

Page 43: ...e the feature was introduced Additionally the Device Version column will indicate which parameter is a member of the DALSA Features Naming Convention using the tag DFNC versus the GenICam Standard Fea...

Page 44: ...ation Panel Camera Information Feature Descriptions Display Name Feature Description Device Version View Model Name DeviceModelName Displays the device model name RO 1 00 Beginner Vendor Name DeviceVe...

Page 45: ...r up Configuration UserSet4 UserSet4 Select the user defined configuration UserSet 4 as the Power up Configuration UserSet5 UserSet5 Select the user defined configuration UserSet 5 as the Power up Con...

Page 46: ...or load from features settings previously saved by the user UserSet6 UserSet6 Select the User defined Configuration space UserSet6 to save to or load from features settings previously saved by the use...

Page 47: ...by the User Set Selector feature The user sets are located on the camera in non volatile memory W 1 00 Beginner Power on Status deviceBISTStatus Determine the status of the device using the Built In S...

Page 48: ...ltSelector The user chooses the factory data set or from one of 16 available user saved states User Set Configuration Management The second drop list allows the user to change the camera configuration...

Page 49: ...pe Displays the sensor color type mode RO 1 00 Beginner TDI Mode TDI TDI HDR TDI HFR TDI Area sensorTDIModeSelection Tdi Tdi2Array TdiHfw TdiArea Select the TDI mode for the sensor Output one row from...

Page 50: ...s the line rate provided to the camera by either internal or external source RO 1 00 Beginner Refresh Measured Line Rate refreshMeasureLineRate Press to update measuredLineRate 1 00 Beginner Acquisiti...

Page 51: ...sents a DC offset applied to the video signal in DN digital number units The value may be positive or negative 1 00 Beginner Line Spatial Correction sensorLineSpatialCorrection Sets the number of rows...

Page 52: ...ry Encoder Direction Counter Clockwise Clockwise rotaryEncoderDirection CounterClockwise Clockwise Specifies the phase which defines the encoder forward direction Inspection goes forward when the rota...

Page 53: ...Output Line Source Off On outputLineSource off on Selects which features control the output on the selected line Line output level is controlled by the outputLineSoftwareCmd feature Line output level...

Page 54: ...Version View Flat Field Correction Mode flatfieldCorrectionMode 1 00 Off Off FPN and PRNU correction disabled Beginner On On FPN and PRNU correction enabled DFNC Clear Coefficents flatfieldCalibration...

Page 55: ...algorithm Flat Field Calibration Target flatfieldCalibrationTarget Sets the target value for the Calibrate PRNU feature Flat Field Calibration Offset X flatfieldCalibrationROIOffsetX Set the starting...

Page 56: ...bled and linear data is output Gamma Correction Gamma Correction Gamma correction table is used User Defined User Defined LUT download by the user is used Gamma Correction gammaCorrection Sets the out...

Page 57: ...type of color filter used in the camera Read only 1 00 Beginner DFNC Sensor Width WidthMax Indicates the maximum number of pixels available in the long line axis the sensor Read only 1 00 Beginner DFN...

Page 58: ...SA support for an Excel file that can help with this AOI Count multipleROICount Specified the number of AOI s in an acquired image 1 00 Beginner SFNC AOI Selector multipleROISelector Select 1 of up to...

Page 59: ...00 Beginner DFNC XML Minor Version DeviceManifestXMLMinorVersion Together with DeviceManifestXMLMajorVersion specifies the GenICam feature description XML file version RO 1 00 Beginner DFNC Refresh G...

Page 60: ...ediately on power up CLHS transmitters enable after sending Acquisition start 1 00 Guru DFNC Next CLHS Device Configuration 16K One cable five lanes 8K One cable one lane Two cable one lane clhsNext D...

Page 61: ...onStop Stops the acquisition of image data at the end of the current line frame WO 1 00 Beginner DFNC Acquisition Status AcquisitionStatus Indicates whether the camera has been commanded to stop or to...

Page 62: ...tion selected by File Operation Selector on the selected file 1 00 Guru File Open Mode FileOpenMode Selects the access mode used to open a file on the device 1 00 Guru Read Write Read Write Select REA...

Page 63: ...button and then specify the location where the file should be stored 6 Note that firmware changes require that the camera be powered down and then back up Additionally CamExpert should be shut down an...

Page 64: ...ite Set the FileOperationSelector to Open Open the file by setting FileOperationExecute to 1 This is a read write feature poll it every 100 ms until it returns 0 to indicate it has completed Read File...

Page 65: ...poses you may want to download a list of all the parameters and values associated with the camera 1 Go to File Access Control 2 Click on Settings 3 In the Type drop down box select Miscellaneous 4 In...

Page 66: ...ible using normal image data Note gray images are displayed so that any bit error will immediately be apparent as colored pixels in the image There are five test patterns that can be selected via the...

Page 67: ...04000 0000 0000 0000 0000 0100 0000 0000 0000 16 Reserved 0x00008000 0000 0000 0000 0000 1000 0000 0000 0000 17 NO_USER_SETTINGS 0x00010000 0000 0000 0000 0001 0000 0000 0000 0000 18 NO_ADC_COEFFICIEN...

Page 68: ...xternal Trigger Mode 4 From the Frame Grabber CamExpert Advanced tab select the Line Sync Source to be Internal Line Trigger and the Internal Line Trigger frequency to the maximum that will be used 5...

Page 69: ...calibration is performed using a white reference as per the guidelines in the user manual all pixels should achieve the same response However over time dust in the lens extension tube may migrate to t...

Page 70: ...nificant smear and color artifacts in the scan direction Changing the scan direction to the opposite direction should resolve this problem Refer to Camera Orientation in the user manual to determine t...

Page 71: ...will not start to draw current until the input supply is above approximately 10 5 V and 200 msec has elapsed If the power supply stabilizes in less than 200 msec then inrush current will not exceed n...

Page 72: ...airflow around the camera body especially the fins and the lens assembly and camera mount Lowering the ambient temperature will equally lower the camera s temperature If the camera s internal temperat...

Page 73: ...Declaration of Conformity 73 Declaration of Conformity...

Page 74: ...74 Document Revision History Document Revision History Revision Description Date 00 Preliminary draft release 10 April 2019...

Reviews: