Home

Tamarisk 640 Software Interface Control Document

1. 12 2 6 Camera Memory Data 12 Camera Data Upload 17 3 Operational COMMAS sb Susp d anb auxi aditu 22 System COMMANDS ET 22 3 2 Field Calibration 31 3 39 AGC amp 37 3 4 Zoom COMMING aeeiexeiesststor erani eh an EU E UE 52 3 5 Non Volatle Parameters reb xu Sa Ru OSEE SU ER RP RN UNE 55 3 6 Pixel COMMING Scag ties santo itis diode Rane 64 3 7 Troubleshooting CONYITSIIUS scio pos Sob bi dia eo Sae reni pdis ie ea i ever s MI disi RID 71 4 Command Quick Reference 20 0 2 cccccccccceecceccecccecceecaeececcececeeceeeaeeceeeaeeseeceeeaeeceecteeseeeaees 76 Software ICD Abbreviation Description Celsius Fahrenheit automatic gain control bad pixel replacement circuit card assembly center line communication Computer Software Component Computer Software Configuration Item Computer Software Unit decibels digital signal processor electrostatic discharge electronic zoom field of view Fo
2. Tamarisk 54o Software ICD 7 DRS Technologies Table 141 Serial Echo ACK Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x0006 Serial Echo Command ID checksum Frame check sequence 3 7 2 Tcomp Disable 0x18 Description Disables or enables TIM temperature compensation Tcomp AN CAUTION Disabling temperature compensation should only be used in a debug environment with test patterns Disabling temperature compensation will result in severely degraded performance Command Format Table 142 Tcomp Disable Command Format Value Description 0x01 Start of message 0x18 Tcomp Disable Command ID 0x02 Parameters length 0 enable 1 disable checksum Frame check sequence Disable enable Note value of 1 disables Tcomp Response Format This command results in an ACK message Table 143 Tcomp Disable ACK Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x0018 Tcomp Disable Command ID checksum Frame check sequence 72 Tamarisk 54o Software ICD 7 DRS Technologies 3 7 3 Test Pattern Select 4 Description Enables and selects a video test pattern Selecting test pattern lt 0 0000 gt disables the test pattern generator This test pattern replaces the input video stream from the FPA and facilitates testing of downstream processing blocks
3. Table 32 Customer Non Volatile Write Response Format Value 0x01 0x02 0x02 0x0027 checksum Description Start of message ACK Response Parameters length Customer Non Volatile Write Command ID Frame check sequence 3 1 4 Enable Colorization Command 0xCC Description Enables colorization Command Format Table 33 Enable Colorization Command Format Value 0x01 0xCC 0x02 0x0000 or 0x0001 checksum Response Format Description Start of message Enable Colorization Command ID Parameters length 0 disables colorization 1 enables colorization Frame check sequence Table 34 Enable Colorization Response Format Description Start of message 25 Em Tamarisk 54o Software ICD 7 DRS Technologies 0x02 ACK Response 0x02 Parameters length 0 00 Colorization Enable Command ID checksum Frame check sequence 3 1 5 8 Bit Colorization Selection Command OxCD Description Allows the user to select the one of 12 different 8 bit colorization selections Colorization must be enabled and the output video mode must be set to 8 bit Command Format Table 35 8 Bit Colorization Selection Command Format Description Start of message 8 bit Colorization Command ID Parameters length Selects one of 12 possible colorization pallets White Hot Black Hot Red Light Arcus Inferno SoftLight Sunset Memoriam Flamma Arcticus
4. lt Software ICD Response Format z 77 DRS Technologies Table 146 Test Pattern Select Response Format Value 0x01 0x02 0x02 Ox00F4 checksum Description Start of message ACK Response Parameters length Test Pattern Select Command ID Frame check sequence 3 7 4 RS170 Test Pattern Enable 0xD8 Description Enables RS170 test pattern The test pattern is a full screen of 16 vertical bars that vary from black on the left to white on the right When this test pattern is enabled it does not affect other processing on the TIM The RS170 test pattern overrides normal RS170 output RS170 output must be enabled or test pattern will not be output Command Format Table 147 RS170 Test Pattern Enable Command Format Value 0x01 0xD8 0x02 Unsigned integer checksum Response Format Description Start of message RS170 Test Pattern Enable Command ID Parameters length 0 disables RS170 test pattern non zero enables RS170 test pattern Frame check sequence Table 148 RS170 Test Pattern Enable Response Format Value 0x01 0x02 0x02 0x00D8 checksum Description Start of message ACK Response Parameters length RS170 Test Pattern Enable Command ID Frame check sequence 3 7 5 Verbose Mode Toggle OxFF This command toggles the TIM s verbose mode In verbose mode the TIM generates additional TXT messages during operation as an aid to test
5. Description Sets the gain limit offset for AGC histogram processing The default value is 1 NOTE This command has no effect if ICE is enabled Command Format Table 90 AGC Gain Flatten Offset Set Command Format Value Description 0x01 Start of message OxD2 AGC Gain Flatten Offset Set Command ID 0x02 Parameters length unsigned integer 0 to 65535 gain flatten offset value checksum Frame check sequence Response Format Table 91 AGC Gain Flatten Offset Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x00D2 AGC Gain Flatten Offset Set Command ID checksum Frame check sequence 3 3 12 AGC Region of Interest 0x84 Description Sets or gets the AGC Region of Interest ROI This command also returns the allowable ROI Limit This command also provides ability to burn all of the ROI to flash NV Param NOTE This command has no effect if ICE is enabled 48 Tamarisk s40 Software ICD 7 DRS Technologies Sub Command Format Table 92 AGC Region of Interest Sub Command Table Description Get ROI Additional Parameters Response None Text String ACK Get ROI Limit None Text String ACK Set ROI 4 unsigned integer ACK Burn ROI to NV None ACK Param All other values reserved Command Format sub command 0x0000 Get Value 0x01 0x84 0x02 0x0000 Table 93 AGC ROI Get Command Format Descri
6. 0 disabled non zero enabled 7 DRS Technologies Notes Cannot be larger than OxFFFF NVParam 52 must also be enabled NVParam 52 must also be enabled Cannot be larger than or equal to Ending Column Cannot be larger than or equal to Ending Row Cannot be smaller than or equal to Starting Column Cannot be smaller than or equal to Starting Row Value is applied only at the time of power up Not Valid unless the lens calibration is enabled ICE must be enabled for this parameter to have any effect ICE can be enabled at power up with parameter 47 Camera RTL version 01 00 3532 or newer is required together with compatible CPU Rel version Deprecated please use parameter 79 for ICE strength adjustments 59 Software ICD Zoom Magnification Power on Value Zoom Horizontal Offset Power On Value Zoom Vertical Offset Power On Value ICE Power On Slope Limit Crosshairs Enable Unsigned integer Signed Integer Signed Integer Unsigned Integer Boolean 7 DRS Technologies Default Value O 10 3 50X 11 3 75 12 4 00X Horizontal offset from the center Negative values cente the zoom to the left of FPA center Positive values center the zoom to the right of FPA center Range depends on power on zoom magnification Values out of range will be clipped at maximum Vertical of
7. Ox2A 0x02 0x00 0x01 Ox2E Next the formula indicates that the Ox2E must be inverted Ox2E OxFFF FFFD1 Then 1 must be added OxFFF FFFD1 1 OxFFF FFFD2 Finally a bit wise AND with OxFF needs to be performed 218 Tamarisk 54o Software ICD 7 DRS Technologies OxFFF FFFD2 amp OxFF 0xD2 Note that the bit wise AND operation ensures the checksum length remains 1 byte 2 2 COMMAND MESSAGE FORMAT All commands originate from the connected device and are sent to the thermal imaging module TIM The TIM does not originate commands but it may send occasional text messages commands conform to the general message format The command byte identifies the specific command to be performed Additional data bytes are included in the command as required Refer to command details section for specifics The module will be ready to accept commands within 2 seconds of power on 2 3 RESPONSE MESSAGE FORMAT commands sent to the TIM are expected to receive at least one response message exception changing the baudrate command will not produce a response In general systems communicating with the TIM should wait for the response message prior to subsequent messages being sent 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 ERR response The
8. Table 62 Automatic Calibration Pending Activity Query Command Format Value 0x01 0x25 0x00 checksum Response Format Description Start of message AutoCal Pending Activity Query command ID Parameters length Frame check sequence Table 63 Automatic Calibration Pending Activity Query VALUE Response Format Unsigned int checksum Description Start of message VALUE Response Parameters length Type of Calibration Pending 0 None 1 Periodic Time out 2 Range Change Frame check sequence 36 5 640 Software ICD 7 DRS Technologies Table 64 Automatic Calibration Pending Activity Query ACK Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x0025 AutoCal Pending Activity Query command ID checksum Frame check sequence 3 3 AGC COMMANDS The system supports both conventional AGC operation and Image Contrast Enhancement ICE operation These operating modes are mutually exclusive The AGC module converts 14 bit video data to 8 bit data The AGC has several operating modes that control how this conversion takes place Generally a histogram of the input data is computed upper and lower limits of useful video data are extracted black limit and white limit and a contrast stretch between those levels is performed Two histogram equalization modes are supported AGC freeze and log2 The camera defaul
9. Tamarisk9640o 17 um 640x480 Long Wave Infrared Camera Software Interface Control Document Document No 1014844 Revision C SV inm DRS Technologies A Finmeccanica Company Copyright 2013 DRS TECHNOLOGIES Inc All rights reserved 13532 N Central Expressway Dallas TX 75243 877 377 4783 www drsinfrared com The contents of this document may not be reproduced in whole or in part without the written consent of the copyright owner NOTICE ALL STATEMENTS INFORMATION AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND NOTWITHSTANDING ANY OTHER WARRANTY HEREIN ALL DOCUMENT FILES AND SOFTWARE ARE PROVIDED AS IS WITH ALL FAULTS DRS DISCLAIMS ALL WARRANTIES EXPRESSED OR IMPLIED INCLUDING WITHOUT LIMITATION THOSE OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM 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 INCORPORATED HEREIN BY THIS REFERENCE IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY CONTACT YOUR DRS REPRESENTATIVE FOR A COPY IN NO EVENT SHALL DRS BE LIABLE FOR ANY INDIRECT SPECIAL CONSEQUENTIAL OR INCIDENTAL DAMAGES INCLUDING WITHOUT LIMITATION LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS M
10. 0x01 Software 0x00 OxXOC FPGA 0x00 OxOE 0x00 0x00 0x00 0x00 0x00 0x00 Total size of transfer CRC of entire transfer Frame check sequence Table 20 Data Transfer Upload Setup Response Format Value 0x01 0x74 0x06 0x0000 0x0000 Unsigned Integer checksum Description Start of message Data Transfer Upload Setup Command ID Parameters length Always 0 Always 0 Response ID See table below Frame check sequence Table 21 Data Transfer Upload Setup Response ID Response ID Description Success Setup accepted Upload can proceed Error in Device ID Region ID or Range ID Setup failed 19 lt Software ICD z 77 DRS Technologies Illegal Size Size of upload does not agree with expected size Setup failed 2 7 2 Data Transfer Upload Packet 0x72 This message is used as both a command to the TIM and a response to the CU Description Carries data to be uploaded to the TIM The response provides flow control and error notification to CU Command Format As a command this message carries payload data for a data transfer upload to the TIM from the CU The message contains a 16 bit unsigned zero based packet number followed by payload bytes Following the payload bytes is a 16 bit packet CRC The number of payload bytes will vary but the entire message must be less than the MTU size Table 22 Data Transfer Upload Packet Command Format
11. Value 0x01 0x72 N Unsigned integer any Unsigned Integer checksum Response Format Description Start of message Data Transfer Upload Setup Command ID Parameters length Packet number First packet is 0 Packet payload The number of bytes in this array varies These are a portion of the bytes of the payload object being sent to the TIM Packet CRC Frame check sequence Table 23 Data Transfer Upload Packet Response Format Value 0x01 0x72 0x06 unsigned integer unsigned integer checksum Description Start of message Data Transfer Upload Setup Command ID Parameters length Response ID See table below Packet number First packet is 0 Frame check sequence 20 218 Tamarisk 54o Software ICD 7 DRS Technologies Table 24 Data Transfer Upload Packet Response ID Description CU Response Restart transmission from the packet number included in the message Upload complete Flash operations CU should cease transmission of packets underway until follow up message is received Transfer CRC error CU should cease data transfer operations Data length error CU should cease data transfer operations CU should stop transmitting packets and wait Flash sector programming underway for follow up messages Flash sector programming complete CU should resume transmission of packets Transfer complete CU should cease data transfer operations iThe TIM
12. Value is applied only at the time of power up What happens to the video when a 1 point event happens This has no effect with the Frame Buffer Video Suspend Action Non Volatile is set to Freeze Video This must be enabled in conjunction with the specific NV param for the symbology to show on screen For example NVParam 52 must be set to 1 and NVParam 55 must be set to 1 for the polarity symbology to show If either is set to O then the polarity symbology is not displayed Cannot be larger than OxFFFF NVParam 52 must also be enabled NVParam 52 must also be enabled NVParam 52 must also be enabled 58 Software ICD Name Symbology Start Up Time Duration Symbology Zoom Enable AGC ROI Starting Column AGC ROI Starting Row AGC ROI Ending Column AGC ROI Ending Row Lens Calibration Enable Lens Calibration Table Selection ICE Mode Min Max On Symbology Field Calibration Enable Type Unsigned integer Boolean Unsigned integer Unsigned integer Unsigned integer Unsigned integer Boolean Unsigned integer Boolean Boolean Default Values Value 0 Disabled 0 Enabled duration in seconds 0 Disable 1 Enable 0 639 0 479 0 479 0 Disable 1 Enable Table 1 0x0000 Table 2 0x0001 Table 3 0x0002 Table 4 0x0003 Table 5 0x0004 0 preset value for low strength 1 preset value for high strength
13. ova gt Software ICD 7 DRS Technologies A Finmeccanica Company Digital Video Source Select RS170 Test Pattern Enable Baud Rate Set System Status Get Test Pattern Select Defective Pixel Map Flash Burn Verbose Mode Toggle 78
14. 0x01 0x02 0x02 0x00A4 checksum Description Start of message ACK Response Parameters length Zoom Magnification Set Command ID Frame check sequence 3 4 2 Zoom Pan Set 0 5 Description Selects the origin from within the un zoomed original image for the zoomed image subset The origin is the zero based offset of the center of the zoomed image The offset 0 0 is the center of the un zoomed image 53 lt Software ICD Command Format n 7 DRS Technologies Table 108 Zoom Pan Set Command Format Value 0x01 OxA5 0x04 Signed integer Signed integer checksum Response Format Description Start of message Zoom Pan Set Command ID Parameters length Horizontal offset from the center Negative values center the zoom to the left of FPA center Positive values center the zoom to the right of FPA center Vertical offset from the center Negative values center the zoom above the FPA center Positive values center the zoom below the FPA center Frame check sequence Table 109 Zoom Pan Set Response Format Value 0x01 0x02 0x02 0x00A5 checksum Description Start of message ACK Response Parameters length Zoom Pan Set Command ID Frame check sequence 3 4 3 Zoom Store Current Settings OxA6 Description Permantly stores current zoom settings in Non volatile memory Command Format Table 110 Zoom Store Current
15. 0x01 0x00 Ox1a 0x00 0x00 0x66 Table 18 TIM Manufacturing Information Item Length in bytes Conversion from raw bytes Mfg date information Year int data 0 256 int data 1 Mfg date information Month int data 2 Mfg date information Day int data 3 Mfg date information Year int data 4 256 int data 5 Mfg date information Month int data 6 16 Tamarisk s4o Software ICD Item Mfg date information Mfg date information Mfg date information Mfg date information Mfg calibration information Mfg calibration information Mfg calibration information Mfg software information Mfg software information Module Part Number Module Serial Number Detector Part Number Detector Serial Number Length in bytes 1 2 1 1 6 6 10 10 10 20 20 20 20 z 77 DRS Technologies Conversion from raw bytes Day int data 7 Year int data 8 256 int data 9 Month int data 10 Day int data 11 Chamber string data 12 17 Position string data 18 23 Version string data 24 33 Version string data 34 43 Version string data 44 53 Part Number string data b4 73 Serial Number string data 74 93 Part Number string data 94 1 13 Serial Number string data 114 133 2 7 CAMERA DATA UPLOAD If the Tamarisk 640 camera is integrated in a system there may be occasions an embedded firmware or embedded hardware programs could require an update Customers that desi
16. 9 Ocean 10 Rain 11 Factory Default checksum Frame check sequence 0 0000 to 0x000B NOOA ON Response Format Table 36 8 Bit Colorization Selection Response Format Description Start of message ACK Response Parameters length Em Tamarisk 54o Software ICD 7 DRS Technologies 4 5 0x00CD 8 Bit Colorization Selection Command ID 6 checksum Frame check sequence 3 1 6 Video Orientation Select OxCF Description Selects the video display output mode Command Format Table 37 Video Orientation Select Command Format Description Start of message Digital Video Source Select Command ID Parameters length Video Orientation Selection 0 Normal Orientation 1 Vertical Invert 2 Horizontal Invert 3 Horizontal and Vertical Invert checksum Frame check sequence Response Format Table 38 Video Orientation Select Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length Ox00CF Video Orientation Source Select Command ID Checksum Frame check sequence 3 1 7 Digital Video Source Select 0xD7 Description Control the digital video output multiplexer The camera default is to use the output of the AGC module Command Format Table 39 Digital Video Source Select Command Format Description Start of message 27 AV Tamarisk 54o Software ICD 7 DRS Technologies OxD7 Digital Video Source Select
17. Command ID 0x02 Parameters length Unsigned integer SS below Source ID value checksum Frame check sequence Table 40 Digital Video Source IDs Source ID Description Test Pattern Generator 14 bit data with no invert revert no gray or freeze frame during auto calibrations 14 bit data with 1 frame of latency with invert revert gray or freeze frame support during auto calibrations Output of AGC Module Output of Symbology Module All other values reserved Response Format Table 41 Digital Video Source Select Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x00D7 Digital Video Source Select Command ID checksum Frame check sequence 3 1 8 Baud Rate Set OxF1 Description Set the baud rate for the RS232 serial port The system must be using RS 232 serial for this command to have an effect NOTE Note the baud rate for the USB port is fixed at 921600 Note there is no acknowledge of this command any subsequent commands must be at the new baud rate 28 Tamarisk 54o Software ICD 7 DRS Technologies The factory default setting is 57600 baud There is a non volatile parameter to permanently change this If a different baud rate is desired there must be an initial command to change the baud rate at 57600 baud Or the non volatile parameter 34 must be set to the desired baud rate Note the baud r
18. Parameters length 0x84 AGC ROI Get Limit Command ID checksum Frame check sequence Command Format sub command 0x0002 Set Table 99 AGC ROI Set Command Format Value Description 0x01 Start of message 0x84 AGC ROI Set Command ID Ox0A Parameters length 0x0002 Sub command Set ROI Unsigned integer XSTART within valid limits see Get Limit Unsigned integer YSTART within valid limits see Get Limit Tamarisk s40 Software ICD Unsigned integer Unsigned integer n 7 DRS Technologies XSTOP within valid limits see Get Limit YSTOP within valid limits see Get Limit checksum Response Format Frame check sequence Table 100 AGC ROI Set Command ACK Response Format Value 0x01 0x02 0x02 0x84 checksum Description Start of message ACK Response Parameters length AGC ROI Set Command ID Frame check sequence Command Format sub command 0x0003 Burn to NV Param Table 101 AGC ROI Burn to NV Params Command Format Value 0x01 0x84 0x02 0x0003 checksum Response Format Description Start of message AGC ROI Burn to NV Params Command ID Parameters length Sub command Burn ROI to NV Param Frame check sequence Table 102 AGC ROI Burn to NV Params Command ACK Response Format Value 0x01 0x02 0x02 0x84 checksum Description Start of message ACK Response Parameters length AGC ROI Burn to NV Params Command ID Frame check s
19. Settings Command Format Value 0x01 OxA6 0x00 checksum Description Start of message Zoom Store Current Settings Command ID Parameters length Frame check sequence 54 HE Tamarisk 640 Software ICD 7 DRS Technologies Response Format Table 111 Zoom Store Current Settings Response Format Value Description 0x01 0x02 0x02 0x00A6 checksum Start of message ACK Response Parameters length Zoom Pan Set Command ID Frame check sequence 3 5NON VOLATILE PARAMETERS COMMANDS The following table lists the non volatile commands available to the camera user RS170 Mode Select RS170 Invert Enable RS170 Revert Enable RS170 Output Enable Parallel Digital Video Output Enable Camera Link Output Enable Table 112 Non Volatile Parameter IDs Type Integer Boolean Boolean Boolean Boolean Boolean Values 0 5 1 PAL M 2 PAL N 3 PAL BDGHIN2 O disable non zero enable O disable non zero enable O disable non zero enable O disable non zero enable O disable non zero enable Default Value Used to vertically invert the analog video output Used to horizontally invert the analog video output The Parallel digital output and the the RS170 share pins If both are enabled on power up RS170 will be output If both are enabled during operation the most recent will be used The Parallel digital output and the RS170
20. bit integer value broken up into 2 bytes CMD Returns command code with response data 2 39 4 TXT Response The TXT 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 the ASCII text as it sees fit or may discard the information Table 3 TXT Response Format Value Type Description 0x01 Start of message 0x00 TXT Response ID N Number of text bytes to follow ASCII chars ASCII text Null termination not required checksum Frame check sequence See paragraph 2 1 Table 4 Example TXT Response Value Type Description 0x01 Start of message 0x00 TXT Response ID 0x06 Text message contains 6 characters ASCII text Howdy checksum Frame check sequence See paragraph 2 1 Software ICD 7 DRS Technologies 2 3 2 ACK Response The ACK response is a general purpose acknowledgement that a command has been received Some commands will result in two ACK messages one generated upon receipt of the command and a second generated upon completion of the command The ACK message contains the ID of the command being acknowledged Table 5 ACK Response Format Value Type Description 0x01 Start of message 0x02 ACK Response ID 0x02 ACK responses always have 2 parameter bytes ID of command that is being ACK d Command IDs are 8 bit
21. to provide best initial image Controls the AGC Noise Reduction Gain Factor Set to OxOFFF to disable noise reduction mode Value is applied only at the time of power up Value is applied only at the time of power up Value is applied only at the time of power up Value is applied only at the time of power up Value is applied only at the time of power up Value is applied only at the time of power up 57 Tamarisk 54 Software ICD DRS Technologies Default Values Value 8 Bit Colorization Selection Enable Colorization ICE Mode Enable Frame Buffer Video Suspend Action Video Suspend Gray Value Symbology Enable Symbology 1 point Display Indication Symbology Enable DRS Logo Symbology Polarity Enable Unsigned integer Boolean Boolean Unsigned integer Unsigned integer Boolean Unsigned integer Boolean Boolean White Hot Black Hot Red Light Arcus Inferno SoftLight Sunset Memoriam Flamma Arcticus 9 Ocean 10 Rain 11 Factory Default 0 Disable 1 Enable 0 Disable 1 Enable Oo 0 freeze video 1 output gray value 0 black to 16383 white 0 Disable 1 Enable 0 Disabled 0 Enabled duration in seconds 0 Disable 1 Enable 0 Disable 1 Enable Value is applied only at the time of power up Value is applied only at the time of power up
22. 00 0x0007 ICE Strength value checksum Frame check sequence Response Format Table 70 ICE Mode Strength Response Format 0x001E ICE Mode Strength Command ID checksum Frame check sequence 3 3 2 ICE Mode High Frequency Threshold Command 0x1F Deprecated please use command 0x1E for ICE adjustments Camera RTL Rel version 01 00 4189 or newer is required together with compatible CPU Rel version Description This command is preserved for backward compatibility with previous ICE implementation and maps the 0 1023 input scale to the new ICE strength scale found in cmd 1 Command Format Table 71 ICE Mode High Frequency Threshold Command Format Value Description 0x01 Start of message Ox1F ICE Mode High Frequency Threshold Command ID 0x02 Parameters length 0 to 1023 ICE high frequency threshold value checksum Frame check sequence 39 ________ Software ICD DRS Technologies Response Format Table 72 ICE Mode High Frequency Threshold Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x001F ICE Mode High Frequency Threshold Command ID checksum Frame check sequence 3 3 3 AGC Mode Set 0x2A Description Sets the operating mode for Automatic Gain Control NOTE This command has no effect if ICE is enabled Command Format Table 73 AGC Mode Set Command Format Valu
23. 01 00 3532 or newer Deprecated ICE Mode Enable 01 00 3532 or newer AutoCal Pending Activity Query AutoCal Activity Control Enable Disable Field Calibrate AGC Black Hot Enable AGC White Hot Enable AGC Mode Set AGC Manual Gain Set AGC Manual Level Set Defective Pixel Map Row Add Defective Pixel Map Remove Item Defective Pixel Map Column Add Defective Pixel Map Cursor Value Set Defective Pixel Map Cursor Enable Defective Pixel Map Cursor Position Set Defective Pixel Map Pixel Add 76 Tamarisk 54 Software ICD DRS Technologies RTL Rel version required needs to be paired with compatible CPU Rel version Description Defective Pixel Map Remove All Data Transfer Download Packet Data Transfer Abort Data Transfer Download Retry Data Transfer Download Complete Data Transfer Upload Packet Data Transfer Download Setup Data Transfer Upload Setup Field Calibrate Shutter Disable AGC Gain Bias Set AGC Level Bias Set AGC Region of Interest AGC Options Set Zoom Magnification Set Zoom Pan Set Zoom Store Current Settings 01 00 3532 or newer Automatic Calibration Toggle Non Volatile Parameters Set Non Volatile Parameters Set Default Non Volatile Parameters Get Customer Non Volatile Read Customer Non Volatile Write Enable Colorization 01 00 3532 or newer 8 Bit Colorization Selection 01 00 3532 or newer Video Orientation Select AGC Gain Limit Set AGC Gain Flatten Offset Set 77
24. 4 3 Company Name DRS Technologies 22 lt Software ICD 7 DRS Technologies 4 FPA Name FPA U6160 X1 Core Libraries Version X1 Core Lib Rel 00 01 44 6 RTL Logic Version String This is the version number of the current RTL logic release Example format RTL Rel 01 00 0052 Note This is only an example Some ASCII characters will change according to revision levels in the system The TXT messages shall be followed by an ACK message Table 26 System Version Get TXT Response Format Multiple Responses Value Description 0x01 Start of message 0x00 TXT Response N Parameters length Zero terminated Length varies Note trailing null is included in parameters text string length checksum Frame check sequence Table 27 System Version Get TXT Response Format Multiple Responses Verbose Mode Enabled Export Control 9 Hz Frame Rate Limited Mode Description Start of message TXT Response Parameters length Length varies Note trailing null is included in parameters length Example Response System UC640 17 Rel X1 P3 01 06 06 Zero terminated OHz Enabled text string DRS Technologies 06160 X1 Core Lib Rel 00 00 00 RTL Rel 01 00 0066 checksum Frame check sequence Table 28 System Version Get ACK Response Format Description Start of message 23 Tamarisk 54o Software ICD 7 DRS
25. ALUE Response Description Start of message ERR Response ID Number of text bytes to follow ASCII text string that contains error message Null termination not required Frame check sequence See paragraph 2 1 The VALUE response is generated when a command returns a single 16 bit integer value Table 9 VALUE Response Format Value Type 0x01 0x45 0x02 Unsigned integer checksum Description Start of message VALUE Response ID VALUE responses always have 2 parameter bytes Value Frame check sequence See paragraph 2 1 2 3 6 CMD Response The command response is generated by any command that requires a response that does not fit any of the prior response types The content of the response is dependent on the command and the nature of the response Table 10 CMD Response Format Value Type 0x01 Command ID N varies Checksum Description Start of message ID of corresponding command Number of bytes to follow The contents of this field depend on the command and response type Frame check sequence See paragraph 2 1 11 218 Tamarisk 54o Software ICD 7 DRS Technologies 2 4 RESPONSE MESSAGE TIMING An ACK response will nominally be returned within 1 second of the command being sent However there are exceptions 1 If the command causes flash memory to be erased or programmed the command can take somewhat longer before generating an ACK The time is
26. ANUAL EVEN IF DRS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Rev History Revision Number Release Date Description A 01 26 2013 Initial Draft 05 31 2013 Update for V1 2 features Updated ICE Commands and Prepared for Public Release 06 09 2014 Camera Link is a registered trademark of the Automated Imaging Association 218 Tamarisk 640 Software ICD 7 DRS Technologies TABLE OF CONTENTS i Acronyms and Abbreviations TE ii Reference Documentation iii Safety H iv Notifications Caution Warning and Note eei e iv 1 5 1 1 Systems OVOIVIOW iine neca b Uc b KR lt a UE 5 1 2 DOG UIST OVERVIEW 5 2 Message Format General asus ct sso terio iu utet dar bene beds ae tabu deny expec Damien ende 6 2 1 Checksum Computation ee e ccc 7 2 2 Command Message Format ouai setis dude icu n epis iade 8 2 9 Response Message Onn al usse Ew digo aga rivi edu es Eng Poele Dira RS qus 8 2 4 Response Message Timing 12 2 5 Command Response
27. Description 0x01 Start of message 0x47 Data Transfer Download Complete Command ID 0x00 Parameters length checksum Frame check sequence Response Format 15 640 Software ICD 7 DRS Technologies There is no response to this command Upon receipt of this command the TIM will cease data transfer operations 2 6 1 5 Data Transfer Abort 0x43 Description Abort a data transfer This command can be used to abort both uploads and downloads Command Format Table 16 Data Transfer Abort Command Format Value Description 0x01 Start of message 0x43 Data Transfer Abort command ID 0x00 Parameters length checksum Frame check sequence Response Format Table 17 Data Transfer Abort Response Format Value Description 0x01 Start of message 0x02 ACK response 0x02 Parameters length 0x0043 Data Transfer Abort command ID checksum Frame 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 numbers and serial numbers This information is downloadable and parsable based on the information in Table 18 The Data Transfer Download Setup Command 0x73 is used to download this information To download the data shown in Table 18 the user would write the following serial command to the camera 0x01 0x73 0x0a 0x00 0x00 0x00 0x01 0x00
28. Response Parameters length ICE Mode Min Max Command ID Frame check sequence ICE Mode Enable Command 0x23 Camera RTL Rel version 01 00 3532 or newer is required together with compatible CPU Rel version Description Command Format Enables and disables Image Contrast Enhancement ICE Mode Table 67 ICE Mode Enable Command Format Value 0x01 0x23 0x02 0x0000 or 0x0001 checksum Response Format Description Start of message Enable ICE Command ID Parameters length 0 disables ICE mode 1 enables ICD mode Frame check sequence Table 68 ICE Mode Enable Response Format Value 0x01 0x02 0x02 0x0023 checksum Description Start of message ACK Response Parameters length ICE Enable Command ID Frame check sequence 38 Tamarisk 54o Software ICD 7 DRS Technologies 3 3 1 ICE Mode Strength Command Ox1E Camera RTL Rel version 01 00 4471 or newer is required Description Sets ICE Strength ICE Mode must be enabled before this command will have any effect This command enables the user to select an ICE strength from 0 7 in 1 unit increments The lowest setting is 0 the highest setting is 7 Recommend using lower values when looking at lower contrast scenes and higher values when looking at dynamic scenes Command Format Table 69 ICE Mode Strength Command Format Ox1E ICE Mode Strength Command ID 0x02 Parameters length 0x00
29. Technologies Value Description 0x02 ACK Response 0x02 Parameters length 0x0007 System Version Get Command ID checksum Frame check sequence 3 1 2 Customer Non Volatile Read Command OxCA Description Allows a customer to read up to 252 ASCII characters This information is read out of non volatile memory and can be read back with the Customer Non Volatile Read Command Command Format Table 29 Customer Non Volatile Read Command Format Value Description 0x01 Start of message OxCA Customer Non Volatile Read Command ID 0x00 Parameters length checksum Frame check sequence Response Format Table 30 Customer Non Volatile Read Response Format Description Start of message ACK Response N Parameters length where 10 lt N lt 252 varies Non volatile memory contents checksum Frame check sequence 3 1 3 Customer Non Volatile Write Command 0xCB Description Allows a customer to store up to 252 ASCII characters This information is stored in non volatile memory and can be written with the Customer Non Volatile Write Command 24 lt Software ICD Command Format n 7 DRS Technologies Table 31 Customer Non Volatile Write Command Format N varies checksum Response Format Description Start of message Customer Non Volatile Write Command ID Parameters length where 10 lt N lt 252 Non volatile memory contents Frame check sequence
30. This requires a sequence of commands The current mode of operation can also affect how the test patterns look and the actual pixel values on the digital interfaces Using a pre AGC video tap 14 bit data will allow for pixel data validation Also note if automatic calibration has not been disabled or a range change occurs while a test pattern is selected the test pattern will be corrupted The to avoid these issues command sequence should be as follows 1 0x01 0x18 0x02 0x00 0x01 OxEA to disable Tcomp 2 0x01 OxAC 0x00 0x53 to disable Autocal 3 0x01 OxF4 0x02 0x80 0 0 0x89 to enable horizontal ramp for example test pattern 4 optional 0x01 OxD7 0x02 0x00 0x04 if 14 bit test patterns are desired Otherwise test pattern will be 8 bit When test pattern is no longer used it is best to power cycle the camera to restore to normal operation Command Format Table 144 Test Pattern Select Command Format Value Description 0x01 Start of message OxF4 Test Pattern Select Command ID 0x02 Parameters length unsigned integer See table below Test Pattern ID checksum Frame check sequence Table 145 Test Pattern IDs Test Pattern ID Description i Description Description 0x0000 Off 0x8003 Horizontal Bars 0x8007 Gray 0x8000 Horizontal Ramp 0x8004 Vertical Bars 0x8008 NUC 14 bit 0x8001 Vertical Ramp 0x8005 Black 0x8009 NUC 64 shade 0x8002 Diagonal Ramp 0x8006 White 73
31. UTTE deprecated R Always reads 3 0 1 open deprecated Always reads 0x0 Deprecated Manual Gain Manual Level Gain Bias Level Bias Deprecated always 0 Deprecated always 0 Frame check sequence Bit 2 CAL 122 pt cold 2 2 pt hot 321 pt 4 1 pt no shutter Bit 1 Bito POL O blk 12wht deprec ated deprec ated deprecated Table 46 System Status Get ACK Response Format Value 0x01 0x02 0x02 Ox00F2 Description Start of message ACK response Parameters length System Status Get Command ID 30 E Tamarisk 54o Software ICD 7 DRS Technologies le checksum Frame check sequence Note the gain and level settings in response bytes 8 to 15 may be meaningless depending on the specific AGC mode in use in byte 5 3 2 FIELD CALIBRATION COMMANDS Field calibrations may be performed at any time during camera operations to improve image quality The most common is the 1 point calibration wherein the shutter is closed raw pixel samples are collected and averaged for some number of frames default is 4 new NUC offsets are computed from the averaged samples and the shutter is opened to resume operations The 1 point no shutter field calibration allows the camera to compute NUC offsets that compensate for lens non uniformities When this operation is performed the camera should be pointed at a black body or suitable substitute
32. al Gain Set Command ID checksum Frame check sequence 3 3 7 AGC Manual Level Set 0x33 Description Sets level value used by AGC when configured to Manual Mode NOTE This command has no effect if ICE is enabled Command Format Table 82 AGC Manual Level Set Command Format Value Description 0x01 Start of message 0x33 AGC Manual Level Set Command ID 0x02 Parameters length AGC manual level value 0 minimum level 4095 OxOFFF maximum level unsigned integer 0 to 4095 checksum Frame check sequence The minimum and maximum pixel values and X1 that the AGC will display are centered around the manual level value The separation between and 1 is determined by the manual gain value and X1 are calculated as follows level ceil 4095 gain 2 X1 level ceil 4095 gainy2 1 43 lt Software ICD Response Format n 7 DRS Technologies Table 83 AGC Manual Level Set Response Format Value 0x01 0x02 0x02 0x0033 checksum Description Start of message ACK Response Parameters length AGC Manual Level Set Command ID Frame check sequence 3 3 8 AGC Gain Bias Set 0x82 Description Sets gain bias value Gain bias is similar to a contrast control Command Format Table 84 AGC Gain Bias Set Command Format Value 0x01 0x82 0x02 unsigned integer 0 to 4095 checksum Response Format Desc
33. ate for the USB port is fixed at 921600 Command Format Table 42 Baud Rate Set Command Format Value Description 0x01 Start of message OxF1 Baud Rate Set Command ID 0x02 Parameters length Unsigned integer CRISIS Baud rate ID value checksum Frame check sequence Table 43 Baud Rate ID Values Baud Rate ID Baud Rate Baud Rate ID Baud Rate 230400 8 76800 115200 9 38400 57600 10 19200 28800 11 9600 14400 12 4800 7200 13 2400 3600 14 1200 1800 15 600 3 1 9 System Status Get OxF2 Description This command requests system status The response contains information about a variety of system functions Command Format Table 44 System Status Get Command Format Description Start of message System Status Get Command ID 29 Tamarisk s40 Software ICD DRS Technologies 3 0x00 Parameters length 4 checksum Frame check sequence Response Format Two responses are generated a system status get response and an ACK response Table 45 System Status Get First Response Format Value 0x01 OxF2 0x10 Bit 7 Bit 6 deprecated AGC O off 1 log equal auto 2 manual 3 linear equal Unsigned integer Unsigned integer Unsigned integer Unsigned integer Unsigned integer Unsigned integer Unsigned integer chksm Description Start of message ACK Response Parameters length Bit 5 Bit 4 Bit 3 EXTVID O in 1 out 2 off depre cated SH
34. cal Plane Array feet gravitational force gram graphical user interface height horizontal field of view input output Interface Control Document Image Contrast Enhancement identification infrared Interface Requirements Specification kilometer lower right long wave infrared ACRONYMS AND ABBREVIATIONS Abbreviation mm ms MSB MTU MWIR NETD NTSC NUC NVTHERM OEM OLA P POL psi Rev ROI SC SWIR TBD TCR TIM UART UAV UFPA USB V DRS Technologies Description millimeter milliseconds Most Significant Bit Maximum Transfer Unit Mid wave infrared noise equivalent temperature difference National Television System Committee non uniformity correction Night Vision Thermal Analysis Tool original equipment manufacturer Optical Lens Adapter probability polarity pound per square inch revision region of interest split configuration Short wave infrared To Be Determined Temperature coefficient of resistance Thermal Imaging Module Universal Asynchronous Receiver Transmitter unmanned aerial vehicle Un cooled Focal Plane Array Universal Serial Bus Vertical or Voltage volts direct current video graphics array Vanadium Oxide width or Watt micron micrometer 218 Software ICD 7 DRS Technologies REFERENCE DOCUMENTATION The following documents form part of this specification In the event of a conflict between documents referenced herein and the c
35. d ID checksum Frame check sequence Table 134 Remove Item Operation IDs Value Description Pixel at row index and column index will be removed from the Remove pixel defect map All pixels at row index will be removed from the defect map The column index is ignored for this operation Remove row All pixels at the column index will be removed from the defect The row index is ignored for this operation 3 6 8 Defective Pixel Map Remove All 0x3C Description Remove all pixels from the defective pixel map 69 lt Software ICD Command Format Table 135 Defective Pixel Map Remove All Command Format Value 0x01 0x3C 0x00 checksum Response Format Description Start of message Defective Pixel Map Remove All Command ID Parameters length Frame check sequence Table 136 Defective Pixel Map Remove All Response Format Value 0x01 0x02 0x02 0x003C checksum Description Start of message ACK Response Parameters length Defective Pixel Map Remove All Command ID Frame check sequence 3 6 9 Defective Pixel Map Flash Burn OxFB Description Permantly store all marked dead pixels into Flash Memory Command Format Table 137 Defective Pixel Map Flash Burn Command Format Value 0x01 OxFB 0x04 OxXX 0x00 checksum Response Format Description Start of message Defective Pixel Map Flash Burn Command ID Pa
36. dependent on a number of factors The number of flash sectors being erased or programmed More sectors will require more time The temperature of the flash Colder flash parts require more time to erase and program 2 The response time for non ACK response ERR etc types depends on the type of command 2 5 COMMAND RESPONSE SEQUENCE 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 followed by and ACK 2 Data transfer activities have a unique message sequence that is dependent on whether an upload or download is requested the size of the transfer and any errors that may occur during transfer 2 6 CAMERA MEMORY DATA DOWNLOAD Information in non volatile memory may contain some information that is useful in system development Table 18 shows the data available in non volatile storage A sequence of commands is required to download this information and the information will need to be parsed according to the table Figure 1 shows the command sequence between the connected unit CU and the thermal imaging module TIM 12 218 Tamarisk 54o Software ICD 7 DRS Technologies CU TIM Download Setup ACK Download Packet Complete Figure 1 Download command sequence 2 6 1 Download from Thermal Imaging Module TIM to Connected Unit CU A d
37. e rate A 9 Hz camera can only be set to 9 Hz 56 Software ICD Name Genlock Master Enable Genlock Delay Serial Port Baudrate AutoCal Activity Control Gain Limit Noise Reduction Mode Black Hot Enable at Power Up AGC Auto Mode Gain Bias at Power Up AGC Auto Mode Level Bias at Power Up AGC Manual Mode Gain at Power Up AGC Manual Mode Level at Power Up at Power Up Type Boolean Unsigned integer Unsigned integer Boolean Unsigned fixed point integer Boolean Unsigned integer Unsigned integer Unsigned integer Unsigned integer Unsigned integer Default Values Value 0 slave mode non zero master mode 0 to 255 clocks See Serial Baudrate command in Section 3 1 9 for complete listing of selectable baudrates 0 Disable 1 Enable 0x0010 Enable 1 OxOFFF Disable 0 Disable 1 Enable 0 4096 0 Freeze Off 1 Auto Mode 2 Manual Mode 7 DRS Technologies Notes This value has no effect when GENLOCK is disabled The number of system clocks to delay the generated Genlock signal when enabled and in master mode 0 is no delay This value has no effect when GENLOCK is disabled Default power on serial communication baudrate Controls whether AutoCal activities including range change are allowed after power up Note Power up 1 Pt is always performed
38. e DDR Region 0xFB command 3 6 1 Defective Pixel Map Cursor Enable 0x38 Description Enables or disables the defective pixel cursor 64 Em Software ICD 7 DRS Technologies Command Format Table 120 Defective Pixel Map Cursor Enable Command Format Value Description 0x01 Start of message 0x38 Defective Pixel Map Cursor Enable Command ID 0x00 Parameters length 0 cursor disable unsigned integer 9 9 1 cursor enable checksum Frame check sequence Response Format Table 121 Defective Pixel Map Cursor Enable Response Format Value Description 0x01 Start of message 0x02 ACK response 0x02 Parameters length 0x0038 Defective Pixel Map Cursor Enable Command ID checksum Frame check sequence 3 6 2 Defective Pixel Map Cursor Position Set 0x3A Description Sets the location of the defective pixel cursor Command Format Table 122 Defective Pixel Map Cursor Position Set Command Format Value Description 0x01 Start of message Ox3A Defective Pixel Map Cursor Position Set 0x04 Parameters length unsigned integer 0 to Cursor row index Valid values are 0 to 479 rows 1 unsigned integer 0 to Cursor column index Valid values are 0 to 639 FPA cols 1 checksum Frame check sequence 65 lt Software ICD Response Format n 7 DRS Technologies Table 123 Defective Pixel Map Cursor Position Set Re
39. e Description 0x01 Start of message Ox2A AGC Mode Set Command ID 0x02 Parameters length Unsigned integer Sos AGC Mode ID value checksum Frame check sequence Table 74 AGC Mode ID Values AGC Mode ID AGC Mode AGC Freeze AGC conversion is frozen at current gain and level Log2 Histogram Equalization also called auto Manual Mode All other values reserved 40 lt Software ICD Response Format Table 75 AGC Mode Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x002A AGC Mode Set Command ID z 77 DRS Technologies checksum Frame check sequence 3 3 4 AGC Black Hot Polarity Set 0x28 Description Commands the system to display hotter objects in the image as darker blacker and cooler objects as lighter The default camera setting is white hot Command Format Table 76 AGC Black Hot Polarity Set Command Format Value Description 0x01 Start of message 0x28 Command ID 0x00 Parameters length checksum Frame check sequence Response Format Table 77 AGC Black Hot Polarity Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x0028 AGC Mode Command checksum Frame check sequence 3 3 5 AGC White Hot Polarity Set 0x29 Description Commands the system to display hotter objects in the image as lig
40. eck sequence 3 6 PIXEL MAP COMMANDS The defective pixel map identifies Focal Plane Array FPA pixels that are stuck high stuck low flashing or otherwise defective Pixels identified in the map are replaced with a filtered average of neighboring pixels The Thermal Imaging Module TIM includes a cursor function that facilitates identifying defective pixels When the cursor is enabled a single FPA pixel is replaced with a cursor value 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 improve its visibility on the scene Most of the defective pixel map commands require parameters consisting of a row and column index Row index 0 is the upper row of the FPA The row index must be less than height of the FPA in pixels If the row index is out of range the command will result in an error message Column index 0 is the left most column of the The column index must be less than the width of the FPA If the column index is out of range the command will result in an error message The commands in this section modify the active defective pixel map in DDR memory None of these commands modify the defective pixel map in non volatile memory If the modified pixel map is to be used following a power cycle the map must be burned to non volatile flash with the Flash Region Program From Activ
41. efective Pixel Map Column Add Command Format Value 0x01 0x36 0x02 unsigned integer 0 to FPA cols 1 checksum Response Format Description Start of message Defective Pixel Map Column Add Command ID Parameters length Cursor column index Valid values are 0 to 639 Frame check sequence Table 131 Defective Pixel Map Column Add Response Format Value 0x01 0x02 0x02 0x0036 checksum Description Start of message ACK Response Parameters length Defective Pixel Map Column Add Command ID Frame check sequence 3 6 7 Defective Pixel Map Remove Item 0x35 Description Removes a dead pixel row or column from the defective pixel map 68 Em Software ICD 7 DRS Technologies Command Format Table 132 Defective Pixel Map Remove Item Command Format Value Description 0x01 Start of message Ox3B Defective Pixel Map Remove Item Command ID 0x06 Parameters length unsigned integer GC Remove item operation ID unsigned integer 0 to Cursor row index Valid values are 0 to 479 rows 1 unsigned integer 0 to Cursor column index Valid values are 0 to 639 FPA cols 1 checksum Frame check sequence Response Format Table 133 Defective Pixel Map Remove Item Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x003B Defective Pixel Map Remove Item Comman
42. equence 3 3 13 AGC Options Set OxAO Description Sets AGC LUT limits 51 Tamarisk 54o Software ICD 7 DRS Technologies NOTE This command has no effect if ICE is enabled Command Format Table 103 AGC Options Set Command Format Value Description 0x01 Start of message OxAO AGC Options Set Command ID 0x02 Parameters length 0x000A AGC gain flatten offset value unsigned integer 0 to 65535 unsigned integer 0 to 65535 checksum Frame check sequence Pixel sum upper bound Pixel sum lower bound Response Format Table 104 AGC Options Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x00A0 AGC Options Set Command ID checksum Frame check sequence 3 4 ZOOM COMMANDS 3 4 1 Zoom Magnification Set OxA4 Description Selects zoom magnification 52 lt Software ICD Command Format n 7 DRS Technologies Table 105 Zoom Magnification Set Command Format Value 0x01 4 0x02 Unsigned integer See table below checksum Description Start of message Zoom Magnification Set Command ID Parameters length Zoom magnification ID value Frame check sequence Table 106 Zoom Magnification ID Values Zoom Magnification ID Response Format 2 75 3 00 3 25 3 50 3 75 4 00 Table 107 Zoom Magnification Set Response Format Value
43. er Upload Packet 0x72 message to the CU to control the flow of packets or to indicate 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 as indicated in Table 24 At any time the CU may send a Data Transfer Abort message 0x43 Upon receipt of this message the TIM will reset its internal state machines and await a new setup message Following transmission of the last data packet the TIM will send a flow control message with ID 8 to indicate flash is being programmed followed by a flow control message with ID 10 to indicate that the upload has been successful the flash burn is complete data transfer operations will now cease 18 Tamarisk s40 Software ICD n 7 DRS Technologies 2 7 1 Data Transfer Upload Setup 0x74 This message is used as both a command to the TIM and a response to the CU Description Sets up a transfer from the connected unit to the TIM Command Format Table 19 Data Transfer Upload Setup Command Format Value 0x01 0x74 0x12 Unsigned integer nsigned integer nsigned integer nsigned integer nsigned integer nsigned integer U U U Unsigned integer U U U nsigned integer checksum Response Format Description Start of message Data Transfer Upload Setup Command ID Parameters length 0x00 0x00 0x00
44. error response may include a descriptive string that describes the error If the received message is properly formatted including checksum and the command is recognized the TIM will generate an Acknowledgement ACK response On select commands the module may send other responses The type of response depends on the command that was received Response types are Atext message These are output using the TXT identifier The text message will contain the requested information or other feedback see the individual message detail as null terminated ASCII strings value message These are output using the VALUE identifier The value message includes a 16 bit numerical value The original command The command will contain new parameters that include the response data Table 2 Response Message Types Name Additional data Text message variable of bytes defined in the Text message TXT 0x00 Data Length field E 640 Software ICD 7 DRS Technologies Note to receive a text message the module must have debug message mode ON Data filed includes16 bit command ID of the serial command that is being acknowledged Acknowledgement ACK Data filed includes 16 bit command ID of the serial ij GIO EOS MALS command that is being unacknowledged Data filed include 16 bit command ID of the serial Error ERR command that is in error 16 bit integer return value VALUE 16
45. fset from the center Negative values cente the zoom above the FPA center Positive values center the zoom below the FPA center Range depends on power on zoom magnification Values out of range will be clipped at maximum 1 to 63 where 120 25 2 0 50 Camera RTL Hel version 01 00 3532 or newer is required together with compatible CPU Rel version Deprecated please use parameter 79 for ICE strength adjustments 8 2 00 63 15 75 0 disabled non zero enabled 60 m Tamarisk 54o Software ICD 7 DRS Technologies Default Value Notes Name Type Values Enabling this parameter does nothing unless parameter 72 is also enabled Crosshairs Boolean 0 disabled Border Enable non zero enabled Values outside of allowable 6 to 632 range will be truncated to nearest legal value Crosshairs X Unsigned Location integer Values outside of allowable 6 to 472 range will be truncated to nearest legal value Crosshairs Y Unsigned Location integer YUV Output Camera RTL version Superframe Boolean 0 disabled 01 00 3995 or newer is enable non zero enabled required together with compatible CPU Rel version Camera RTL Rel version 01 00 4189 or newer is required This parameter is preserved for backward ICE High compatibility together with Frequency Unsigned 516 1023 previous ICE implementation Threshold Integer these values are automatically mapped to new ICE Streng
46. gth gain bias value 0 minimum level bias level factor 255 2047 Ox7FF unity level bias gain factor 0 4095 OxOFFF maximum level bias gain factor 255 Frame check sequence 45 AV Tamarisk 54o Software ICD 7 DRS Technologies For level bias lt 2047 level factor 255 level bias 2047 255 For level bias gt 2048 level factor 255 level bias 2047 2048 256 000 192 000 128 000 64 000 0 000 64 000 128 000 192 000 256 000 Figure 5 Level Bias Chart Response Format Table 87 AGC Level Bias Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x0083 AGC Level Bias Set Command ID checksum Frame check sequence 3 3 10 AGC Gain Limit Set OxD1 Description 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 allowable difference between the white limit and black limit for AGC histogram processing A smaller value allows the maximum gain to be higher e g allows a smaller difference between the black limit and the white limit In low contrast scenes this smaller value will 46 Tamarisk 54o Software ICD 7 DRS Technologies allow more sensitivity but will also gain up any system noise A larger value
47. his command 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 for storing in NV Param NOTE Customers disabling automatic field calibrations must use command 0x25 Automatic Calibration Pending Activity Query and allow some calibrations to maintain image and uniformity Command Format Table 60 Automatic Calibration Activity Control Command Format Description Start of message AutoCal Activity Control command ID Parameters length Software ICD 4 5 0x0000 or 0x0001 6 checksum Response Format n 7 DRS Technologies Enable 0x0001 or Disable 0x0000 Frame check sequence Table 61 Automatic Calibration Activity Control ACK Response Format Value 0x01 0x02 0x02 0x0026 checksum Description Start of message ACK Response Parameters length AutoCal Activity Control Command ID Frame check sequence 3 2 7 Automatic Calibration Pending Activity Query 0x25 Description This command queries the camera for pending Automatic Calibration activities and specifies the type of AutoCal that is pending A suggested interval for checking 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
48. hter whiter and cooler objects as darker This is the default 41 Software ICD 7 DRS Technologies Command Format Table 78 AGC White Hot Polarity Set Command Format Value Description 0x01 Start of message 0x29 AGC White Hot Polarity Set Command ID 0x00 Parameters length checksum Frame check sequence Response Format Table 79 AGC White Hot Polarity Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x0029 AGC White Hot Polarity Set Command ID 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 This command has no effect if ICE is enabled Command Format Table 80 AGC Manual Gain Set Command Format Value Description 0x01 Start of message 0x32 AGC Manual Gain Set Command ID 0x02 Parameters length AGC manual gain value gain 256 4096 manual_gain_value 0 minimum gain gain 1 16 0625 3840 4095 255 unity gain gain 1 0 4095 OxOFFF maximum gain gain 256 unsigned integer 0 to 4095 42 248 Tamarisk 54o Software ICD 7 DRS Technologies le checksum Frame check sequence Response Format Table 81 AGC Manual Gain Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x0032 AGC Manu
49. ing 74 Software ICD z 77 DRS Technologies Description Toggles the display of verbose messaging Command Format Table 149 Verbose Mode Toggle Command Format Value 0x01 OxFF 0x00 checksum Description Start of message Verbose Mode Toggle Command ID Parameters length Frame check sequence Table 150 Verbose Mode Toggle Command Format Option 2 Value 0x01 OxFF 0x02 0x0000 0x0001 checksum Response Format Description Start of message Verbose Mode Toggle Command ID Parameters length 0 disables verbose mode 1 enables verbose mode Frame check sequence Table 151 Verbose Mode Toggle Response Format Value 0x01 0x02 0x02 OxOO0FF checksum Description Start of message ACK Response Parameters length Verbose Mode Toggle Command ID Frame check sequence 75 HE Tamarisk 54o Software ICD 7 DRS Technologies 4 COMMAND QUICK REFERENCE In this section a list of commands is provided to aid you in customizing your scripts and camera control Table 152 Message Quick Reference RTL Rel version required needs to be paired with compatible CPU Rel version Description Echo Test System Version Get Automatic Calibration Period Set Automatic Calibration Period Get Tcomp Disable ICE Strength 01 00 4471 or newer ICE High Frequency Threshold Set 01 00 4189 or newer Deprecated ICE Mode Min Max
50. ing anomalous TIMs 1 2DOCUMENT OVERVIEW This document describes the commands parameters and responses of the Tamarisk Software Architecture The Tamarisk Software Architecture is not a product in and of itself it is a component in a system This document describe the commands for this specific component Other individual systems based on the Tamarisk Software Architecture may include additional commands that are specific to that system This document does not describe the physical interface to the system The physical interface will vary for each system Typically the serial protocol is transported over RS 232 links but USB and LVCMOS UART interfaces are supported The Tamarisk 4 Electrical Interface Control Document describes the connectors voltage levels framing and data rates on which this protocol resides See Reference Documents for details E Tamarisk 54o Software ICD 7 DRS Technologies 2 MESSAGE FORMAT GENERAL The serial protocol allows the user to control and monitor status of the thermal imaging module Every message transmitted or received over the serial interface uses the same message format The message contains the following components 1 Start Character this is always 0x01 It identifies the start of a new message Note that the start character is not guaranteed to be unique in the serial data stream Other fields within the message may also contain this value 2 Command B
51. me check sequence 3 5 3 Non Volatile Parameters Set Description Set a non volatile parameter The parameter will effect camera operation immediately it is not necessary to cycle the TIM s power Please note 1 This command causes one or more sectors of flash memory on the TIM to be erased and reprogrammed See general notes on command timing 2 If flash is successfully reprogrammed this command results in an ACK message 3 If flash programming fails this command results in an ERR response containing an informative string Command Format Table 118 Non Volatile Parameters Set Command Format Value 0x01 OxBO 0x04 Unsigned integer Unsigned integer Description Start of message Non volatile parameters set command ID Parameters length Non volatile parameter ID New non volatile parameter value 63 Software ICD 7 DRS Technologies l8 checksum Frame check sequence Parameter Value size and content are dependent on parameter ID Two types are common Boolean 16 bit unsigned integer where e O disabled e enabled Unsigned integer a 16 bit value whose range is parameter specific Response Format Table 119 Non Volatile Parameters Set Response Format Value Description 0x01 Start of message 0x02 ACK response 0x02 Parameters length 0 00 0 Non volatile parameters set command ID checksum Frame ch
52. nsfer Download Complete message 0x47 This message indicates that the entire object has been received intact by the CU and that data transfer operations will cease 2 6 1 1 Data Transfer Download Setup 0x73 Description Setup a download from the TIM to the connected unit Command Format 13 lt Software ICD Table 11 Data Transfer Download Setup Command Format Value 0x01 0x73 unsigned integer unsigned integer unsigned integer unsigned integer checksum Response Format Description Start of message Data Transfer Download Setup Command ID Parameters length Transfer size in bytes 0x0001 0x001A 0x0000 Frame check sequence Table 12 Data Transfer Download Setup Response Format Value 0x01 0x02 0x02 0x0073 checksum Description Start of message ACK response Parameters length Data Transfer Download Setup Command ID Frame check sequence 2 6 1 2 Data Transfer Download Packet 0x41 Description Carries payload bytes for the data transfer download Command Format Table 13 Data Transfer Download Packet Command Format Value 0x01 0x41 N unsigned integer any checksum Response Format Description Start of message Data Transfer Download Packet Command ID Parameters length Packet number The first packet is 0 7 DRS Technologies Packet payload The number of bytes in this array va
53. ontents of this specification the contents of this specification shall be considered a superseding requirement Document No 1014853 Tamarisk g4 User Manual Document No 1014845 Tamarisk 640 Electrical Interface Control Document Document No 1014846 Tamarisk 54 Camera Control Software User Guide Document No 1010056 Tamarisk Mechanical Interface Control Document LO 5 Software ICD 7 DRS Technologies A Finmeccanica Company SAFETY INSTRUCTIONS NOTIFICATIONS CAUTION WARNING AND NOTE Throughout this manual notifications are used to alert the user s to potential risks and to minimize the potential for personal injury and or damage to the product When a notification is present it is important that the user review and understand all statements related to the notification before proceeding If questions arise please contact your authorized dealler or DRS Technologies Notifications are preceeded by a symbol and followed by highlighted text Three types of notifications are used throughout this manual and are defined below AN CAUTION A caution is a procedure 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 to the presence of potentially harmful circumstances and provide precautionary guidance for mitigating risk of personal injury and or damage
54. open or close Command Format Table 50 Field Calibrate Shutter Disable Set Command Format Value 0x01 0x81 0x02 Unsigned integer checksum Response Format Description Start of message Field Calibrate Shutter Disable Set Command ID Parameters length 0 open and enable the shutter 1 close and disable the shutter Frame check sequence Table 51 Field Calibrate Shutter Disable Set Response Format Value 0x01 0x02 0x02 0x0081 checksum Description Start of message ACK Response Parameters length Field Calibrate Shutter Disable Set Command ID Frame check sequence 3 2 3 Automatic Calibration Toggle OXAC Description Toggles the TIM between automatic or manual field calibration modes In automatic mode a field calibration operation will occur at regular intervals 32 lt Software ICD z 7 DRS Technologies In manual mode a field calibration operation will only occur when commanded other than range changes A range change can occur as the camera temperature changes from one region to another There are five temperature ranges each range crossing has hysteresis so actual changes will depend on current range and next range These field calibrations are required to maintain usable video The default is to have automatic calibration turned on Command Format Table 52 Automatic Calibration Toggle Command Format Value 0x01 OxAC 0
55. ownload from the TIM is initiated by the CU with the Data Transfer Download Setup message 0x73 This messages has five 16 bit parameters 10 bytes total The parameters identify the device region range and size of the download see Figure 1 The TIM checks the size and region parameters and if acceptable responds with an ACK 0x02 The TIM then begins sending packets to the CU using Data Transfer Download Packet messages 0x41 Each packet message carries a payload whose size is always an even number of bytes The payload packet contains a packet number 16 bits and packet payload bytes Payload size has historically been 244 bytes The packet number is a zero based integer count packets It is used to detect missing packets 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 indicate an error The retry contains one 16 bit parameter that is the packet number of the last packet received in order Upon receipt of this message the TIM will retransmit all packets following the packet number At any time the CU may send a Data Transfer Abort message 0x43 Upon receipt of this message the TIM will terminate transmission of packets reset its internal state machines and await a new setup message Following receipt of the last data packet the CU will send a Data Tra
56. ption Start of message AGC ROI Get Command ID Parameters length Sub command Get ROI checksum Frame check sequence Response Format Table 94 AGC ROI Command ACK Response Format Value 0x01 0x02 0x02 0x84 Description Start of message ACK Response Parameters length AGC ROI Get Command ID checksum Frame check sequence Value 0x01 0x00 0x39 Table 95 AGC ROI Get Response 1 Format Description Start of message Text message Parameters length Example Zero terminated ROI 1 1 0 0 639 479 string Each coordinate value takes up 3 characters checksum Frame check sequence 49 Em Software ICD 7 DRS Technologies Command Format sub command 0x0001 Get Limit Table 96 AGC ROI Get Limit Command Format Value Description 0x01 Start of message 0x84 AGC ROI Get Limit Command ID 0x02 Parameters length 0x0001 Sub command Get Internal ROI Limit checksum Frame check sequence Response Format Table 97 AGC ROI Get Limit Response 1 Format Value Description 0x01 Start of message 0x00 Text message 0x39 Parameters length Example a ae ROIT 0 639 479 string 9 Each coordinate value takes up 3 characters checksum Frame check sequence Table 98 AGC ROI Get Limit Command ACK Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02
57. rameters length Defective Pixel Map Flash Sector Write Frame check sequence Table 138 Defective Pixel Map Flash Burn Response Format Description 7 DRS Technologies Start of message 70 Tamarisk 54o Software ICD 7 DRS Technologies 0x02 ACK Response 0x02 Parameters length OxOO0FB Defective Pixel Map Remove All Command ID checksum Frame check sequence 3 7 TROUBLESHOOTING COMMANDS The troubleshooting commands are used for troubleshooting hardware and software features of the TIM 3 7 1 Serial Echo 0x06 Description Test communications to and from the TIM The TIM echoes the command message and parameters and generates an ACK message Command Format Table 139 Serial Echo Command Format Value Description 0x01 Start of message 0x06 Serial Echo Command ID N Parameters length Null terminated String to be echoed String length is arbitrary but total string message size must be less than MTU size checksum Frame check sequence Response Format This command results in two response messages The first response message is a TXT message containing the echoed string The second response message is an ACK message Table 140 Serial Echo TXT Response Format Value Description 0x01 Start of message 0x06 Echo command N Parameters length Null terminated string Echoed string checksum Frame check sequence 71
58. re supporting that update through their software or hardware would follow the upload procedure described below An upload to the TIM is initiated by the CU connected with the Data Transfer Upload Setup message 0x74 This messages has 9 16 bit parameters 18 bytes total The parameters identify the device region range size and CRC of the upload see Figure 2 17 218 Tamarisk 54o Software ICD 7 DRS Technologies Figure 2 Upload to TIM Message Sequence Diagram CU TIM Upload Setup ACK Upload Setup Upload Packet Upload Packet Flash Sector Upload Packet iu a ON 0x72 Resume Burning Complete 9 Upload Packet Flash Sector Upload Packet Upload Packet Sector Burning 8 Transfer Complete 10 The TIM checks the size and region parameters and if acceptable responds with an ACK and setup response The setup response message has the same command ID as the setup message 0x74 and has 3 16 bit parameters The CU then begins sending packets to the TIM using Data Transfer Upload Packet messages 0x72 Each packet message carries a payload whose size is always an even number of bytes The payload packet contains a packet number 16 bits and packet payload bytes Payload size has historically been 244 bytes The packet number is a zero based integer count packets It is used to detect missing packets and to initiate retries At any time the TIM may send a Data Transf
59. ries These are a portion of the bytes of the payload object being sent from the TIM Frame check sequence 14 Tamarisk 54o Software ICD 7 DRS Technologies There is no response to this command unless packet is corrupted or is the last packet of the transfer If this packet is corrupted the CU should generate a Data Transfer Download Retry message 0x46 containing the packet number of the expected packet If this packet is the last packet of the transfer the CU should generate a Data Transfer Download Complete message 0x47 that contains success status 2 6 1 3 Data Transfer Download Retry 0x46 Description Setup a download from the TIM to the connected unit Command Format Table 14 Data Transfer Download Retry Command Format Value Description 0x01 Start of message 0x46 Data Transfer Download Packet Command ID 0x02 Parameters length unsigned integer Packet number of expected packet checksum Frame check sequence Response Format There is no response to this command other than to resume packet transmission at the packet number of the expected packet All packets following the expected packet shall be retransmitted 2 6 1 4 Data Transfer Download Complete 0x47 Description Indicates the CU has received all packets of the download and data transfer operations will cease Command Format Table 15 Data Transfer Download Complete Command Format Value
60. ription Start of message AGC Gain Bias Set Command ID Parameters length gain bias value 0 minimum gain bias gain factor 0 25 2047 Ox7FF unity gain bias gain factor 1 0 4095 OxOFFF maximum gain bias gain factor 4 0 Frame check sequence Table 85 AGC Gain Bias Set Response Format Value 0x01 0x02 0x02 0x0082 checksum Description Start of message ACK Response Parameters length AGC Gain Bias Set Command ID Frame check sequence 44 Software ICD E 77 DRS Technologies The gain factor computed for each bias setting is a two piece formula For gain_bias lt 2047 gain factor 0 75 gain_bias 2047 0 25 For gain_bias gt 2048 gain_factor 3 gain_bias 2048 2047 1 4 0000 3 7500 3 5000 3 2500 3 0000 2 7500 2 5000 2 2500 72 0000 281 7500 1 5000 51 2500 94 0000 0 7500 0 5000 0 2500 0 0000 4 olG 4 897 4 201 4 082 I 4 9 621 4 8v0c voez 098 9182 210 4 BEE Ov8 4 960r Gain Bias Parameter Figure 4 Gain Factor Curve 3 3 9 AGO Level Bias Set 0x83 Description Sets level bias value Level bias is similar to a brightness control Command Format Table 86 Value 0x01 0x83 0x02 unsigned integer 0 to 4095 checksum AGC Level Bias Set Command Format Description Start of message AGC Level Bias Set Command ID Parameters len
61. s in commands but are extended to 16 bits in checksum Frame check sequence See paragraph 2 1 2 3 3 Response The NAK response is generated to indicate a command cannot be processed for some reason The Tamarisk architecture currently does not use the NAK response Table 6 Response Format Value Type Description 0x01 Start of message 0x03 NAK Response ID 0x02 NAK responses always have 2 parameter bytes ID of command that is being NAK d Command IDs are 8 bits emen D in commands but are extended to 16 bits in an NAK checksum Frame check sequence See paragraph 2 1 2 3 4 ERR Response The ERR response is generated when a command is not recognized or when an error occurs during the processing of a command There are two formats for the ERR response The first format contains only the ID of the command that generated the error The second format contains an informative text message Table 7 ERR ID Response Format Value Type Description 0x01 Start of message 0x04 ERR Response ID 0x02 ERR responses always have 2 parameter bytes Command ID ID of command that caused ERR Command IDs are 8 bits in 10 Software ICD 7 DRS Technologies commands but are extended to 16 bits in an ERR checksum Frame check sequence See paragraph 2 1 Table 8 ERR String Response Format Value Type 0x01 0x04 N ASCII chars checksum 2 3 5 V
62. shall send this response to the CU any time it detects a gap in the packet number sequence The packet number in the response shall be the packet number of the last packet received in the proper sequence 21 218 Tamarisk 54o Software ICD 7 DRS Technologies 3 OPERATIONAL COMMANDS The operational commands are those used by the TIM during normal operations These commands may also be used during factory calibration and testing 3 1 SYSTEM COMMANDS 3 1 1 System Version Get 0x07 Description This command returns the system version The response to the command is a series of TXT messages followed by an ACK message CU TIM 0x07 0 System Version Get 0x00 varies 0x00 varies d 0x02 2 TE ACK Figure 3 System Version Get Diagram Command Format Table 25 System Version Get Command Format Value Description 0x01 Start of message 0x07 System Version Get Command ID 0x00 Parameters length checksum Frame check sequence Response Format The TIM will respond with one or more TXT messages Each TXT message shall contain a null terminated string of less than 40 characters The number of messages and their contents are system specific As an example below are the version strings for Tamarisk 1 System Name System Tamarisk 640 2 CPU Software Version String This is the version number of the current software release Example format CPU Version X1 P3 01 01 0
63. share pins If both are enabled on power up RS170 will be output If both are enabled during operation the most recent will be used 55 Tamarisk 54 Software ICD DRS Technologies Default Values Value Video Output Mux Select AGC Gain Limit AGC Gain Flatten Offset AGC Upper Lower Bounds Percent Automatic Field Calibration Interval Frame Rate Genlock Enable Unsigned integer Unsigned integer Unsigned integer Unsigned integer Unsigned integer Unsigned integer Boolean 0 Output of Uploaded Test Pattern 6 14 bit data with no invert revert no gray or freeze frame during auto calibrations 7 14 bit data with 1 frame of latency with invert revert gray or freeze frame support during auto calibrations 8 AGC 9 Symbology All other values reserved 0 to 4095 0 to 65535 0 to 100 1 to 65535 minutes All other values reserved 0 disabled non zero enabled The output of the selected processing block will be output to all video output ports RS170 parallel digital video and Camera Link This has no effect unless parameter 36 is maximum value OxOFFF Interval between automatic field calibrations Setting this value to 0 will disable time based automatic calibrations not all calibrations will be disabled This value must be greater than the minimum Autocal interval A 30 Hz camera can be set to any supported lower fram
64. sponse Format Value 0x01 0x02 0x02 0x003A checksum Description Start of message ACK response Parameters length Defective Pixel Map Cursor Position Set Command ID Frame check sequence 3 6 3 Defective Pixel Map Cursor Value Set 0x37 Description Selects the value of the defective pixel cursor Command Format Table 124 Defective Pixel Map Cursor Value Set Command Format Value 0x01 0x37 0x02 Unsigned integer 0 to Ox3FFF checksum Response Format Description Start of message Defective Pixel Map Cursor Value Set Command ID Parameters length Cursor value 0 black cursor Ox3FFF white cursor Cursor values greater than Ox3FFF will result in a white cursor Frame check sequence Table 125 Defective Pixel Map Cursor Value Set Response Format Value 0x01 0x02 0x02 0x0037 checksum Description Start of message ACK response Parameters length Defective Pixel Map Cursor Value Set Command ID Frame check sequence 3 6 4 Defective Pixel Map Pixel Add 0x3B Description Add a single pixel to the defective pixel map 66 lt Software ICD Command Format Table 126 Defective Pixel Map Pixel Add Command Format Value 0x01 Ox3B 0x04 unsigned integer 0 to rows 1 unsigned integer 0 to FPA cols 1 checksum Response Format Description Start of message Non Volatile Parameters Se
65. t Default Command ID Parameters length Cursor row index Valid values are 0 to 479 Cursor column index Valid values are 0 to 639 Frame check sequence Table 127 Defective Pixel Map Pixel Add Response Format Value 0x01 0x02 0x02 0x003B checksum Description Start of message ACK Response Parameters length Non Volatile Parameters Set Default Command ID Frame check sequence 3 6 5 Defective Pixel Map Row Add 0x34 Description This command adds a row to the defect map pixels on the row will be marked as defective Command Format Table 128 Defective Pixel Map Row Add Command Format Value 0x01 0x34 0x02 unsigned integer 0 to rows 1 checksum Description Start of message Defective Pixel Map Row Add Command ID Parameters length Cursor row index Valid values are 0 to 479 Frame check sequence n 7 DRS Technologies 67 lt Software ICD Response Format n 7 DRS Technologies Table 129 Defective Pixel Map Row Add Response Format Value 0x01 0x02 0x02 0x0034 checksum Description Start of message ACK Response Parameters length Defective Pixel Map Row Add Command ID Frame check sequence 3 6 6 Defective Pixel Map Column Add 0x36 Description Add a column to the defect map All pixels in the column will be marked as defective Command Format Table 130 D
66. t is log2 mode If the user has set the video 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 ICE operation takes its place ICE operation also converts 14 bit video data to 8 bit data however it does so in a way that details can be seen in the video that would not otherwise be visible in AGC mode The resulting video is generally superior to that of AGC mode 3 3 4 ICE Mode Min Max Command 0x22 formerly known as ICE Mode Contrast Stabilization Deprecated please use command Ox1E for ICE adjustments Camera RTL Rel version 01 00 3532 or newer is required together with compatible CPU Rel version Description ICE Mode Min Max command provides backward compatability with previous ICE version using Indoor and Outdoor mode and sets the ICE strength to its minimum or maximum level Command Format Table 65 ICE Mode Min Max Command Format Value Description 0x01 Start of message 0x22 ICE Mode Min Max Command ID 0x02 Parameters length 0x0000 or 0x0001 0 preset value for low strength 37 Software ICD n 7 DRS Technologies ln a E 1 preset value for high strength Response Format Table 66 ICE Mode Min Max Response Format Value 0x01 0x02 0x02 0x0022 checksum 3 3 2 Description Start of message ACK
67. th settings 0 7 See Parameter compatible CPU Rel version Deprecated please use parameter 79 for ICE strength adjustments Disabling frame buffer reduces Frame Buffer Boolean 0 disabled system latency by one frame Enable non zero enabled ICE will not function with frame buffer disabled ICE must be enabled for this parameter to have any effect ICE can be enabled at power up with parameter 47 This cmd sets desired ICE strength Camera RTL Rel version 01 00 4471 or newer is required Unsigned ICE Strength Integer All other values reserved 3 5 1 Non Volatile Parameters Default Set 0xB3 Description Load the default non volatile parameters Please note 1 This command causes one or more sectors of flash memory on the TIM to be erased and reprogrammed See general notes on command timing 2 If flash is successfully reprogrammed this command results in an ACK message 61 E Tamarisk 54o Software ICD 7 DRS Technologies 3 If flash programming fails this command results in an ERR response containing an informative string CAUTION This command will reset the camera back to factory defaults any customer non volatile parameter changes will be lost this will not effect customer flash sector or customer dead cell map Command Format Table 113 Non Volatile Parameters Default Set Command Format Value Description 0x01 Start of message 0xB3 Non Volatile Parameters Set Defa
68. that is at uniform temperature The shutter is not operated during 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 service pending calibrations including range change if Automatic Calibration Activity has been disabled Command Format Table 47 Field Calibrate Command Format Value Description 0x01 Start of message 0x27 Field Calibrate Command ID 0x02 Parameters length Unsigned integer Field calibration type ID value Determines the type of field See table below calibration to be performed checksum Frame check sequence Table 48 Field Calibrate Type IDs Description 1 point calibration 1 point calibration with shutter disabled All other values reserved Response Format 31 lt Software ICD z 7 DRS Technologies Table 49 Field Calibrate Response Format Value 0x01 0x02 0x02 0x0027 checksum Description Start of message ACK Response Parameters length Field Calibrate Command ID Frame check sequence 3 2 2 Field Calibrate Shutter Disable Set 0x81 Description Enables or disables the TIM shutter When the shutter is disabled it is forced closed and the shutter will ignore requests to open for field calibrations When the shutter is enabled it will open and respond to requests to
69. to the product NOTE A note is a statement that clarifies or is used to emphasize important information Read all instructions Keep these instructions for future reference Follow all instructions Heed all warnings Do not submerge this apparatus in liquid of any kind Clean per recommended instructions using dry non abrasive cloth oa eS ue qe pj Do not install near any sources of intense heat such as radiators furnaces stoves or other apparatus that regulary produce excessive heat 8 Refer all servicing to qualified service personnel 218 Tamarisk 640 Software ICD 7 DRS Technologies 1 SCOPE This document describes the serial protocols and command interface for systems employing the Tamarisk Software Architecture The Tamarisk 649 Software Architecture is a design for an infrared thermal imaging core that uses an un cooled focal plane array UFPA 1 1 SYSTEMS OVERVIEW A thermal imaging module TIM based on the Tamarisk Software Architecture communicates with a connected device via the serial protocol described herein The connected device is often a personal computer PC running a graphical user interface GUI but may be a controller in an embedded system The connected device uses the serial protocol to configure control and monitor status of the thermal imaging module Additionally specific features of the system are tested by the serial protocol This feature is useful for troubleshoot
70. ult Command ID 0x00 Parameters length checksum Frame check sequence Response Format Table 114 Non Volatile Parameters Default Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x00B3 Non Volatile Parameters Set Default Command ID checksum Frame check sequence 3 5 2 Non Volatile Parameters Get 0xB5 Description Displays the value of the selected Non Volatile Parameter Command Format Table 115 Non Volatile Parameters Get Command Format Value Description 0x01 Start of message OxB5 Non volatile parameters get command ID 0x02 Parameters length Unsigned integer Non volatile parameter ID checksum Frame check sequence 62 lt Software ICD Response Format z 77 DRS Technologies This command generates two response messages The first is a VALUE message that contains the value of the non volatile parameter The second response is an ACK message Table 116 Non Volatile Parameters Get VALUE Response Format Value 0x01 0x45 0x02 Unsigned int checksum Description Start of message VALUE Response Parameters length Non volatile parameter value Frame check sequence Table 117 Non Volatile Parameters Get ACK Response Format Value 0x01 0x02 0x02 0x00B5 checksum Description Start of message ACK Response Parameters length Non volatile parameters get command ID Fra
71. utomatic calibration period in minutes Frame check sequence Table 56 Automatic Calibration Period Set Response Format Value 0x01 0x02 0x02 0x0012 checksum Description Start of message ACK Response Parameters length Automatic calibration period set command ID Frame check sequence 3 2 5 Automatic Calibration Period Get 0x13 Description This command shall retrieve the period between automatic calibrations autocal period Command Format Table 57 Automatic Calibration Period Get Command Format Value 0x01 0x13 0x00 checksum Description Start of message Automatic calibration period get command ID Parameters length Frame check sequence 34 lt Software ICD Response Format E 77 DRS Technologies Table 58 Automatic Calibration Period Get TXT Response Format Zero terminated text string checksum Description Start of message TXT Response Parameters length Message content example Example NITOCALS Imrervyal 300 sec Note trailing null is included in parameters length Frame check sequence Table 59 Automatic Calibration Period Get ACK Response Format Value 0x01 0x02 0x02 0x0013 checksum Description Start of message ACK Response Parameters length AutoCal Period Get Command ID Frame check sequence 3 2 6 Automatic Calibration Activity Control 0x26 Description T
72. will prevent objectionable gaining up of system noise but will reduce sensitivity in low contrast scenes The AGC Gain Limit Noise Reduction Mode which is an NV parameter works to limit the pixel to pixel difference and thus reducing the effects of noise across the entire scene This limit has the effect of smoothing out the image and hence the AGC provides a better overall image It is possible but not recommended to enable both the AGC Gain Limit and the AGC Gain Limit Noise Reduction mode By default the 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 Description Start of message AGC Gain Limit Set Command ID Parameters length gain limit value 0 gain limiting disabled 32 gain limited to gain factor 4 0 d int UD 4095 64 gain limited to gain factor 3 0 128 gain limited to gain factor 2 0 256 gain limited to gain factor 1 0 4095 OxOFFF maximum not recommended checksum Frame check sequence Response Format Table 89 AGC Gain Limit Set Response Format Value Description 0x01 Start of message 0x02 ACK Response 0x02 Parameters length 0x00D1 AGC Gain Limit Set Command ID checksum Frame check sequence 47 AV Tamarisk 640 Software ICD 7 DRS Technologies 3 3 11 AGC Gain Flatten Offset Set 0xD2
73. x00 checksum Description Start of message Automatic calibration toggle command ID Parameters length Frame check sequence Table 53 Automatic Calibration Toggle Command Format Option 2 Value 0x01 OxAC 0x02 0x0000 or 0x0001 checksum Response Format Description Start of message Automatic calibration toggle command ID Parameters length 0 disables Autocal 1 enables Autocal Frame check sequence Table 54 Automatic Calibration Toggle Response Format Value 0x01 0x02 0x02 0x00AC checksum Description Start of message ACK response Parameters length Automatic calibration toggle command ID Frame check sequence 3 2 4 Automatic Calibration Period Set 0x12 Description This command shall set the period between automatic calibrations autocal period This command does not store the autocal period in non volatile storage to be preserved across power cycles setting of zero 0 is will prevent only periodic automatic calibrations not all automatic calibrations 33 Software ICD z 77 DRS Technologies The default for time based automatic calibrations is five minutes Command Format Table 55 Automatic Calibration Period Set Command Format Value 0x01 0x12 0x02 Unsigned integer checksum Response Format Description Start of message Automatic calibration period set command ID Parameters length A
74. ys Start of message Unsigned integer Command ID 0 to 252 Parameters length Message dependent Additional Data 0 to 252 bytes checksum Frame check sequence See paragraph 2 1 218 RM Tamarisk 54o Software ICD 7 DRS Technologies 2 1 CHECKSUM COMPUTATION Every message has an appended 8 bit checksum The checksum is computed using all bytes in the message from the start character to the last data byte N Checksum gt modulo 256 1 1 Note that summing negative byte values must be performed using 2 s complement math which is common on most processors Below is example code that computes the message checksum Uint8 ComputeChecksum Uint8 uy message id Uint8 pauy parameters Uint32 ul parameters size in bytes Uint8 uy message checksum 0 message checksum 0x01 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 amp OxFF return uy message checksum ComputeChecksum Alternatively the checksum may be computed using the equivalent formula that follows Checksum two s complement sum of all message byte 1 amp For example let s say that checksum for 0x01 0x2A 0x02 0x00 0x01 needs to be computed The two s complement sum of all the message bytes would be 0x01
75. yte This byte determines the type of command to be performed For responses this byte identifies the type of response 3 Parameter Length this byte specifies the count of any additional parameter bytes included in the message If the message does not require any additional parameter bytes this value will be zero Note that the overall message length is limited by the MTU size see below 4 Parameters These bytes contain any parameters 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 these are typically null terminated arrays of ASCII codes When data bytes contain integer or floating point values these are sent in big endian order e g the MSB is sent first This statement is true for both 16 and 32 bit values 5 Checksum This is the frame check sequence for the message It includes all bytes in the message from the start character to the last parameter byte It is calculated with the formula in paragraph 2 1 The Maximum Transfer Unit MTU size of the serial stream is 252 bytes The parameter length for most messages is an even number of bytes there are exceptions This is due to the 16 bit legacy architectures for which the protocol was developed The message format is illustrated below Table 1 General Message Format Value Type Description 0x01 alwa

Tamarisk 640 Software Interface Control Document

Contents

Download Pdf Manuals

Related Search

Related Contents