DRS Technologies Tamarisk 640 Software Interface Control Document Download Page 79

Page: 79 / 81

Tamarisk

640

Software ICD

O M M A N D

U I C K

- R

E F E R E N C E

In this section a list of commands is provided to aid you in customizing your scripts and camera
control.

Table 152 – Message Quick Reference

Cmd

(Hex)

Description

RTL Rel version required (needs to be
paired with compatible CPU(Rel) version)

0x06

Echo Test

0x07

System Version Get

0x12

Automatic Calibration Period Set

0x13

Automatic Calibration Period Get

0x18

Tcomp Disable

0x1E

ICE Strength

01.00.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 Activity Query

0x26

AutoCal Activity Control (Enable/Disable)

0x27

Field Calibrate

0x28

AGC Black-Hot Enable

0x29

AGC White-Hot Enable

0x2A

AGC Mode Set

0x32

AGC Manual Gain Set

0x33

AGC Manual Level Set

0x34

Defective Pixel Map Row Add

0x35

Defective Pixel Map Remove Item

0x36

Defective Pixel Map Column Add

0x37

Defective Pixel Map Cursor Value Set

0x38

Defective Pixel Map Cursor Enable

0x3A

Defective Pixel Map Cursor Position Set

0x3B

Defective Pixel Map Pixel Add

Summary of Contents for Tamarisk 640

Page 1: ...Tamarisk 640 17 m 640x480 Long Wave Infrared Camera Software Interface Control Document Document No 1014844 Revision C...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Search results

Summary of Contents for Tamarisk 640

Reviews:

Related manuals for Tamarisk 640

Brands by name

Popular brands

DRS Technologies Tamarisk 640, Software Interface Control Document

Search results

Summary of Contents for Tamarisk 640

Reviews:

Related manuals for Tamarisk 640

Brands by name

Popular brands