Software Interface Control Document - DRS · PDF fileTamarisk®640 17 μm 640x480 Long...

of 81 /81
Tamarisk ® 640 17 μm 640x480 Long Wave Infrared Camera Software Interface Control Document Document No: 1014844 Revision: C

Embed Size (px)

Transcript of Software Interface Control Document - DRS · PDF fileTamarisk®640 17 μm 640x480 Long...

  • Tamarisk640 17 m 640x480 Long Wave Infrared Camera

    Software Interface Control Document

    Document No: 1014844

    Revision: C

  • 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 MANUAL, 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

    B 05/31/2013 Update for V1.2 features.

    C 11/15/2013 Updated ICE Commands and Prepared for Public Release

    Camera Link is a registered trademark of the Automated Imaging Association.

  • Tamarisk640 Software ICD

    i

    T A B L E O F C O N T E N T S Table of Contents ..................................................................................................................... i

    Acronyms and Abbreviations .................................................................................................. ii

    Reference Documentation ..................................................................................................... iii

    Safety Instructions ................................................................................................................. iv Notifications: Caution, Warning and Note .................................................................................. iv

    1 Scope .............................................................................................................................. 5 1.1 Systems Overview ............................................................................................................ 5 1.2 Document Overview ......................................................................................................... 5

    2 Message Format - General ............................................................................................. 6 2.1 Checksum Computation ................................................................................................... 7 2.2 Command Message Format ............................................................................................. 8 2.3 Response Message Format .............................................................................................. 8 2.4 Response Message Timing ............................................................................................ 12 2.5 Command/Response Sequence ..................................................................................... 12 2.6 Camera Memory Data download .................................................................................... 12 2.7 Camera Data Upload ...................................................................................................... 17

    3 Operational Commands ................................................................................................ 22 3.1 System Commands ........................................................................................................ 22 3.2 Field Calibration Commands........................................................................................... 32 3.3 AGC Commands ............................................................................................................ 38 3.4 Zoom Commands ........................................................................................................... 53 3.5 Non-Volatile Parameters Commands .............................................................................. 56 3.6 Pixel Map Commands..................................................................................................... 65 3.7 Troubleshooting Commands ........................................................................................... 72

    4 Command Quick-Reference ......................................................................................... 77

  • Tamarisk640 Software ICD

    ii

    A C R O N Y M S A N D A B B R E V I A T I O N S Abbreviation Description Abbreviation Description C Celsius mm millimeter F Fahrenheit ms milliseconds AGC automatic gain control MSB Most Significant Bit BPR bad pixel replacement MTU Maximum Transfer Unit CCA circuit card assembly MWIR Mid-wave infrared CL center line NETD noise equivalent temperature difference COMM communication NTSC National Television System Committee CSC Computer Software Component NUC non-uniformity correction CSCI Computer Software Configuration Item NVTHERM Night Vision Thermal Analysis Tool CSU Computer Software Unit OEM original equipment manufacturer dB decibels OLA Optical Lens Adapter DSP digital signal processor P probability ESD electrostatic discharge POL polarity E-Zoom electronic zoom psi pound per square inch FOV field of view Rev revision FPA Focal Plane Array ROI region of interest ft feet SC split configuration G gravitational force SWIR Short-wave infrared g gram TBD To Be Determined GUI graphical user interface TCR Temperature coefficient of resistance H height TIM Thermal Imaging Module HFOV horizontal field of view UART Universal Asynchronous Receiver Transmitter I/O input/output UAV unmanned aerial vehicle ICD Interface Control Document UFPA Un-cooled Focal Plane Array ICE Image Contrast Enhancement USB Universal Serial Bus ID identification V Vertical or Voltage IR infrared VDC volts direct current IRS Interface Requirements Specification VGA video graphics array km kilometer VOx Vanadium Oxide LR lower right W width or Watt LWIR long-wave infrared m micron (micrometer)

  • Tamarisk640 Software ICD

    iii

    R E F E R E N C E D O C U M E N T A T I O N The following documents form part of this specification. In the event of a conflict between documents referenced herein and the contents of this specification, the contents of this specification shall be considered a superseding requirement.

    Document No: 1014853 Tamarisk640 User Manual

    Document No: 1014845 Tamarisk640 Electrical Interface Control Document

    Document No: 1014846 Tamarisk640 Camera Control Software User Guide

    Document No: 1010056 Tamarisk640 Mechanical Interface Control Document

  • Tamarisk640 Software ICD

    iv

    S A F E T Y I N S T R U C T I O N S

    NOTIFICATIONS: CAUTION, WARNING AND NOTE Throughout this manual, notifications are used to alert the users 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:

    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 to the product.

    NOTE

    A note is a statement that clarifies or is used to emphasize important information.

    1. Read all instructions 2. Keep these instructions for future reference. 3. Follow all instructions 4. Heed all warnings. 5. Do not submerge this apparatus in liquid of any kind. 6. Clean per recommended instructions using dry non-abrasive cloth. 7. 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

  • Tamarisk640 Software ICD

    5

    1 S C O P E This document describes the serial protocols and command interface for systems employing the Tamarisk640 Software Architecture. The Tamarisk640 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 Tamarisk640 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,