background image

 

 

 

   

 
 

 

 

 

 

Tamarisk

®640

  

17 μm 

640x480 Long Wave Infrared Camera 

Software Interface Control Document

 

Document No: 1014844 

Revision: C

 

Содержание Tamarisk 640

Страница 1: ...Tamarisk 640 17 m 640x480 Long Wave Infrared Camera Software Interface Control Document Document No 1014844 Revision C...

Страница 2: ...A COURSE OF DEALING USAGE OR TRADE PRACTICE THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPO...

Страница 3: ...t General 6 2 1 Checksum Computation 7 2 2 Command Message Format 8 2 3 Response Message Format 8 2 4 Response Message Timing 12 2 5 Command Response Sequence 12 2 6 Camera Memory Data download 12 2 7...

Страница 4: ...ital signal processor P probability ESD electrostatic discharge POL polarity E Zoom electronic zoom psi pound per square inch FOV field of view Rev revision FPA Focal Plane Array ROI region of interes...

Страница 5: ...d herein and the contents of this specification the contents of this specification shall be considered a superseding requirement Document No 1014853 Tamarisk 640 User Manual Document No 1014845 Tamari...

Страница 6: ...edure practice or condition that if not strictly followed may result in personal injury or damage to the equipment that may impede product performance WARNING A warning is intended to alert the user t...

Страница 7: ...tures of the system are tested by the serial protocol This feature is useful for troubleshooting anomalous TIMs 1 2DOCUMENT OVERVIEW This document describes the commands parameters and responses of th...

Страница 8: ...arameters or other data for the message Generally the content and format of this data will depend on the specific message type However a few general rules apply When parameter bytes contain strings th...

Страница 9: ...1 start character uy_message_checksum uy_message_id uy_message_checksum ul_parameters_size_in_bytes while ul_parameters_size_in_bytes uy_message_checksum pauy_parameters uy_message_checksum 0xFF retur...

Страница 10: ...ent If the TIM finds a message format error or bad checksum the TIM will not send a response If the message format and checksum is correct but the command is not recognized the TIM will send an Error...

Страница 11: ...XT Text response provides feedback in human readable form The TXT message contains an ASCII string of arbitrary length the entire message must be less than the MTU size The connected unit may display...

Страница 12: ...d for some reason The Tamarisk 640 architecture currently does not use the NAK response Table 6 NAK Response Format Byte Value Type Description 1 0x01 Start of message 2 0x03 NAK Response ID 3 0x02 NA...

Страница 13: ...Response Format Byte Value Type Description 1 0x01 Start of message 2 0x45 VALUE Response ID 3 0x02 VALUE responses always have 2 parameter bytes 4 5 Unsigned integer Value 6 checksum Frame check sequ...

Страница 14: ...UENCE Generally every command is followed by an ACK response However there are numerous exceptions 1 Some commands will return a VALUE response or a response having the same message ID as the command...

Страница 15: ...ts and to initiate retries The TIM continues to transmit packets until the entire object is transmitted At any time during the transmission the CU may send a Data Transfer Upload Retry message 0x46 to...

Страница 16: ...sage 2 0x02 ACK response 3 0x02 Parameters length 4 5 0x0073 Data Transfer Download Setup Command ID 6 checksum Frame check sequence 2 6 1 2 Data Transfer Download Packet 0x41 Description Carries payl...

Страница 17: ...te Value Description 1 0x01 Start of message 2 0x46 Data Transfer Download Packet Command ID 3 0x02 Parameters length 4 5 unsigned integer Packet number of expected packet 6 checksum Frame check seque...

Страница 18: ...ame check sequence 2 6 2 Non volatile Camera System Information There is information contained in the non volatile memory that some customers may desire to use for their products such as camera part n...

Страница 19: ...Part Number string data 54 73 Module Serial Number 20 Serial Number string data 74 93 Detector Part Number 20 Part Number string data 94 113 Detector Serial Number 20 Serial Number string data 114 133...

Страница 20: ...an error condition This flow control message includes 2 16 bit parameters The first is a response ID and the second is a packet number When the CU receives the flow control message it should respond...

Страница 21: ...x0E 9 10 Unsigned integer 0x00 0x00 10 11 Unsigned integer 0x00 0x00 12 13 Unsigned integer 0x00 0x00 14 17 Unsigned integer Total size of transfer 18 19 Unsigned integer CRC of entire transfer 6 chec...

Страница 22: ...ill vary but the entire message must be less than the MTU size Table 22 Data Transfer Upload Packet Command Format Byte Value Description 1 0x01 Start of message 2 0x72 Data Transfer Upload Setup Comm...

Страница 23: ...cease data transfer operations 6 Data length error CU should cease data transfer operations 8 Flash sector programming underway CU should stop transmitting packets and wait for follow up messages 9 Fl...

Страница 24: ...t Byte Value Description 1 0x01 Start of message 2 0x07 System Version Get Command ID 3 0x00 Parameters length 4 checksum Frame check sequence Response Format The TIM will respond with one or more TXT...

Страница 25: ...length 4 to N 3 Zero terminated text string Length varies Note trailing null is included in parameters length N 4 checksum Frame check sequence Table 27 System Version Get TXT Response Format Multiple...

Страница 26: ...ead Command Format Byte Value Description 1 0x01 Start of message 2 0xCA Customer Non Volatile Read Command ID 3 0x00 Parameters length 6 checksum Frame check sequence Response Format Table 30 Custome...

Страница 27: ...0x01 Start of message 2 0x02 ACK Response 3 0x02 Parameters length 4 5 0x0027 Customer Non Volatile Write Command ID 6 checksum Frame check sequence 3 1 4 Enable Colorization Command 0xCC Description...

Страница 28: ...CC Colorization Enable Command ID 6 checksum Frame check sequence 3 1 5 8 Bit Colorization Selection Command 0xCD Description Allows the user to select the one of 12 different 8 bit colorization selec...

Страница 29: ...possible colorization pallets 0 White Hot 1 Black Hot 2 Red Light 3 Arcus 4 Inferno 5 SoftLight 6 Sunset 7 Memoriam 8 Flamma Arcticus 9 Ocean 10 Rain 11 Factory Default 6 checksum Frame check sequence...

Страница 30: ...ck sequence Response Format Table 38 Video Orientation Select Response Format Byte Value Description 1 0x01 Start of message 2 0x02 ACK Response 3 0x02 Parameters length 4 5 0x00CF Video Orientation S...

Страница 31: ...0x02 Parameters length 4 5 0x00D7 Digital Video Source Select Command ID 6 checksum Frame check sequence 3 1 8 Baud Rate Set 0xF1 Description Set the baud rate for the RS232 serial port The system mu...

Страница 32: ...0 8 76800 1 115200 9 38400 2 57600 10 19200 3 28800 11 9600 4 14400 12 4800 5 7200 13 2400 6 3600 14 1200 7 1800 15 600 3 1 9 System Status Get 0xF2 Description This command requests system status The...

Страница 33: ...ht 6 deprecated Always reads 0x0 deprecated 7 Unsigned integer Deprecated 8 9 Unsigned integer Manual Gain 10 11 Unsigned integer Manual Level 12 13 Unsigned integer Gain Bias 14 15 Unsigned integer L...

Страница 34: ...g this operation and should be open prior to initiation 3 2 1 Field Calibrate 0x27 Description Perform a calibration operation The TIM supports several types of calibrations Use this command to servic...

Страница 35: ...quence Response Format Table 51 Field Calibrate Shutter Disable Set Response Format Byte Value Description 1 0x01 Start of message 2 0x02 ACK Response 3 0x02 Parameters length 4 5 0x0081 Field Calibra...

Страница 36: ...matic Calibration Toggle Response Format Byte Value Description 1 0x01 Start of message 2 0x02 ACK response 3 0x02 Parameters length 4 5 0x00AC Automatic calibration toggle command ID 6 checksum Frame...

Страница 37: ...set command ID 6 checksum Frame check sequence 3 2 5 Automatic Calibration Period Get 0x13 Description This command shall retrieve the period between automatic calibrations autocal period Command Form...

Страница 38: ...ommand shall control whether all automatic calibrations autocal including range changes are enabled or disabled This command does not store calibration activity mode in the NV Param See section 3 5 fo...

Страница 39: ...cking for pending calibration requests is every 5 minutes during normal operation and every one 1 minute for the first ten 10 minutes immediately following power up Command Format Table 62 Automatic C...

Страница 40: ...tap to pre AGC these commands have no effect on the output video stream In addition the system supports an Image Contrast Enhancement ICE mode When enabled the normal AGC operation is disabled and IC...

Страница 41: ...together with compatible CPU Rel version Description Enables and disables Image Contrast Enhancement ICE Mode Command Format Table 67 ICE Mode Enable Command Format Byte Value Description 1 0x01 Star...

Страница 42: ...6 checksum Frame check sequence Response Format Table 70 ICE Mode Strength Response Format 4 5 0x001E ICE Mode Strength Command ID 6 checksum Frame check sequence 3 3 2 ICE Mode High Frequency Thresho...

Страница 43: ...erating mode for Automatic Gain Control NOTE This command has no effect if ICE is enabled Command Format Table 73 AGC Mode Set Command Format Byte Value Description 1 0x01 Start of message 2 0x2A AGC...

Страница 44: ...camera setting is white hot Command Format Table 76 AGC Black Hot Polarity Set Command Format Byte Value Description 1 0x01 Start of message 2 0x28 Command ID 3 0x00 Parameters length 4 checksum Frame...

Страница 45: ...rs length 4 5 0x0029 AGC White Hot Polarity Set Command ID 6 checksum Frame check sequence 3 3 6 AGC Manual Gain Set 0x32 Description Sets gain value used by AGC when configured to Manual Mode NOTE Th...

Страница 46: ...has no effect if ICE is enabled Command Format Table 82 AGC Manual Level Set Command Format Byte Value Description 1 0x01 Start of message 2 0x33 AGC Manual Level Set Command ID 3 0x02 Parameters len...

Страница 47: ...ble 84 AGC Gain Bias Set Command Format Byte Value Description 1 0x01 Start of message 2 0x82 AGC Gain Bias Set Command ID 3 0x02 Parameters length 4 5 unsigned integer 0 to 4095 AGC gain bias value 0...

Страница 48: ...evel Bias Set Command Format Byte Value Description 1 0x01 Start of message 2 0x83 AGC Level Bias Set Command ID 3 0x02 Parameters length 4 5 unsigned integer 0 to 4095 AGC gain bias value 0 minimum l...

Страница 49: ...The AGC Gain Limit and the AGC Gain Limit Noise Reduction Mode are two independent blocks which control the AGC gain limit The AGC Gain Limit Set command allows the user to configure the minimum allow...

Страница 50: ...e AGC Gain limit is disabled and the AGC Gain Limit Noise Reduction mode is enabled NOTE This command has no effect if ICE is enabled Command Format Table 88 AGC Gain Limit Set Command Format Byte Val...

Страница 51: ...unsigned integer 0 to 65535 AGC gain flatten offset value 6 checksum Frame check sequence Response Format Table 91 AGC Gain Flatten Offset Set Response Format Byte Value Description 1 0x01 Start of me...

Страница 52: ...essage 2 0x84 AGC ROI Get Command ID 3 0x02 Parameters length 4 5 0x0000 Sub command Get ROI 6 checksum Frame check sequence Response Format Table 94 AGC ROI Command ACK Response Format Byte Value Des...

Страница 53: ...d string Example AGC ROI x0 y0 x1 y1 0 0 639 479 Each coordinate value takes up 3 characters 57 checksum Frame check sequence Table 98 AGC ROI Get Limit Command ACK Response Format Byte Value Descript...

Страница 54: ...ce Command Format sub command 0x0003 Burn to NV Param Table 101 AGC ROI Burn to NV Params Command Format Byte Value Description 1 0x01 Start of message 2 0x84 AGC ROI Burn to NV Params Command ID 3 0x...

Страница 55: ...n offset value 6 7 unsigned integer 0 to 65535 Pixel sum upper bound 8 9 unsigned integer 0 to 65535 Pixel sum lower bound 10 checksum Frame check sequence Response Format Table 104 AGC Options Set Re...

Страница 56: ...00 7 2 75 1 1 25 8 3 00 2 1 50 9 3 25 3 1 75 10 3 50 4 2 00 11 3 75 5 2 25 12 4 00 6 2 50 Response Format Table 107 Zoom Magnification Set Response Format Byte Value Description 1 0x01 Start of messa...

Страница 57: ...the FPA center Positive values center the zoom below the FPA center 6 checksum Frame check sequence Response Format Table 109 Zoom Pan Set Response Format Byte Value Description 1 0x01 Start of messag...

Страница 58: ...Boolean 0 disable non zero enable 0 Used to vertically invert the analog video output 3 RS170 Revert Enable Boolean 0 disable non zero enable 0 Used to horizontally invert the analog video output 4 RS...

Страница 59: ...95 0 This has no effect unless parameter 36 is maximum value 0x0FFF 9 AGC Gain Flatten Offset Unsigned integer 0 to 65535 3 11 AGC Upper Lower Bounds Percent Unsigned integer 0 to 100 1 14 Automatic F...

Страница 60: ...Pt is always performed to provide best initial image 36 AGC Gain Limit Noise Reduction Mode Unsigned fixed point integer 0x0010 Enable 0x0FFF Disable 0x0010 Controls the AGC Noise Reduction Gain Fact...

Страница 61: ...pens 49 Video Suspend Gray Value Unsigned integer 0 black to 16383 white 8192 This has no effect with the Frame Buffer Video Suspend Action Non Volatile is set to Freeze Video 52 Symbology Enable Bool...

Страница 62: ...C ROI Ending Row Unsigned integer 0 479 232 Cannot be smaller than or equal to Starting Row 63 Lens Calibration Enable Boolean 0 Disable 1 Enable 0 Value is applied only at the time of power up 64 Len...

Страница 63: ...zoom magnification Values out of range will be clipped at maximum 0 69 Zoom Vertical Offset Power On Value Signed Integer Vertical offset from the center Negative values center the zoom above the FPA...

Страница 64: ...rd compatibility together with previous ICE implementation these values are automatically mapped to new ICE Strength settings 0 7 See Parameter compatible CPU Rel version Deprecated please use paramet...

Страница 65: ...nd ID 3 0x00 Parameters length 4 checksum Frame check sequence Response Format Table 114 Non Volatile Parameters Default Set Response Format Byte Value Description 1 0x01 Start of message 2 0x02 ACK R...

Страница 66: ...mand ID 6 checksum Frame check sequence 3 5 3 Non Volatile Parameters Set 0xB0 Description Set a non volatile parameter The parameter will effect camera operation immediately it is not necessary to cy...

Страница 67: ...e The cursor position may be relocated within the FPA as desired The cursor value may be either maximum hot a white pixel or maximum cold a black pixel The cursor value may be switched as desired to i...

Страница 68: ...0x02 ACK response 3 0x02 Parameters length 4 5 0x0038 Defective Pixel Map Cursor Enable Command ID 6 checksum Frame check sequence 3 6 2 Defective Pixel Map Cursor Position Set 0x3A Description Sets...

Страница 69: ...d Format Byte Value Description 1 0x01 Start of message 2 0x37 Defective Pixel Map Cursor Value Set Command ID 3 0x02 Parameters length 4 5 Unsigned integer 0 to 0x3FFF Cursor value 0 black cursor 0x3...

Страница 70: ...ixel Map Pixel Add Response Format Byte Value Description 1 0x01 Start of message 2 0x02 ACK Response 3 0x02 Parameters length 4 5 0x003B Non Volatile Parameters Set Default Command ID 6 checksum Fram...

Страница 71: ...ve Pixel Map Column Add Command Format Byte Value Description 1 0x01 Start of message 2 0x36 Defective Pixel Map Column Add Command ID 3 0x02 Parameters length 4 5 unsigned integer 0 to FPA cols 1 Cur...

Страница 72: ...ive Pixel Map Remove Item Response Format Byte Value Description 1 0x01 Start of message 2 0x02 ACK Response 3 0x02 Parameters length 4 5 0x003B Defective Pixel Map Remove Item Command ID 6 checksum F...

Страница 73: ...ers length 4 5 0x003C Defective Pixel Map Remove All Command ID 6 checksum Frame check sequence 3 6 9 Defective Pixel Map Flash Burn 0xFB Description Permantly store all marked dead pixels into Flash...

Страница 74: ...Echo Command Format Byte Value Description 1 0x01 Start of message 2 0x06 Serial Echo Command ID 3 N Parameters length 4 to N 3 Null terminated string String to be echoed String length is arbitrary bu...

Страница 75: ...vironment with test patterns Disabling temperature compensation will result in severely degraded performance Command Format Table 142 Tcomp Disable Command Format Byte Value Description 1 0x01 Start o...

Страница 76: ...uld be as follows 1 0x01 0x18 0x02 0x00 0x01 0xE4 to disable Tcomp 2 0x01 0xAC 0x00 0x53 to disable Autocal 3 0x01 0xF4 0x02 0x80 0x0 0x89 to enable horizontal ramp for example test pattern 4 optional...

Страница 77: ...RS170 output must be enabled or test pattern will not be output Command Format Table 147 RS170 Test Pattern Enable Command Format Byte Value Description 1 0x01 Start of message 2 0xD8 RS170 Test Patte...

Страница 78: ...ble 150 Verbose Mode Toggle Command Format Option 2 Byte Value Description 1 0x01 Start of message 2 0xFF Verbose Mode Toggle Command ID 3 0x02 Parameters length 4 5 0x0000 0x0001 0 disables verbose m...

Страница 79: ...4471 or newer 0x1F ICE High Frequency Threshold Set 01 00 4189 or newer Deprecated 0x22 ICE Mode Min Max 01 00 3532 or newer Deprecated 0x23 ICE Mode Enable 01 00 3532 or newer 0x25 AutoCal Pending Ac...

Страница 80: ...rate Shutter Disable 0x82 AGC Gain Bias Set 0x83 AGC Level Bias Set 0x84 AGC Region of Interest 0xA0 AGC Options Set 0xA4 Zoom Magnification Set 0xA5 Zoom Pan Set 0xA6 Zoom Store Current Settings 01 0...

Страница 81: ...ersion required needs to be paired with compatible CPU Rel version 0xD7 Digital Video Source Select 0xD8 RS170 Test Pattern Enable 0xF1 Baud Rate Set 0xF2 System Status Get 0xF4 Test Pattern Select 0x...

Отзывы: