SU640CSX
4110-0462, Rev. B
Page 82 of 97
© 2016 UTC Aerospace Systems
Date Printed: 1-Dec-2016
This document does not contain any export controlled technical data.
The camera supports the ability to execute multiple commands with the issuance of a single macro
command. Factory stored macros are used to adjust the TEC setpoint and corresponding operational
settings. These are documented in the separate Appendix B document. The user is not able to specify
custom macros.
5.19.1.
Play Macro Command
Description
Plays a macro that is resident in the camera. Turning
macro_echo
on will cause the individual commands being executed to be
displayed.
Setting Type
Global
Command MACRO:PLAY
macro_echo macro_number
Parameters
macro_echo, macro_number
Return Values
Final OK or ERROR with macro_ echo off , return values of any
query commands contained in the macro with macro_ echo ON and
Final OK or ERROR
Range
macro_echo ON OFF
macro_number 0 – 9
Type
string (macro_echo), unsigned integer (macro_number)
Example
MACRO:PLAY OFF 0
5.20.
Windowing Commands
The CSX camera allows for windowing of an image to a user's region of interest (ROI). Windowing is
typically used to trade image resolution for frame rate. The smaller the window chosen, the shorter the
readout time for the frame and, hence, the higher the frame rate that can be achieved. The display
enhancements should be turned off (ENH:ENABLE OFF, see Section 5.9.1) and the AGC should be
turned off (AGC:ENABLE OFF, see Section 5.9.1) when windowing. This is recommended because
enhancements and AGC use the full frame statistics, not the window statistics.
Note that a 640x512 array includes commands to point 0,0 and thus the maximum ‘logical’ extent is 639,
511. When inputting specific pixel locations to the camera firmware, the logic notation applies and the
array maximum is 639x511. The concept of ‘odd’ and ‘even’ is defined on the logic value of the pixel
notation, so the origin 0 of (0,0) is an even number, and 639 of (639,511) is an odd number, regardless
that these refer to the 1
st
pixel and 640
th
pixel.
The WIN:ROW and WIN:COL commands can be used to define each corner of the window individually.
Alternatively, the WIN:RECT command can be used to define the window with a single command.
Windowing speed advantage applies to rows only (i.e. the number of columns is fixed at 640 [639]).
Selecting the start and stop row addresses sets the size and location for the ROI window. There are two
individual commands that set start and stop addresses for rows. The start row address must be an EVEN
number while the stop row address must be an ODD number. Additionally, the resulting height of the
window must be greater than 2; because of the start or stop needing to be an EVEN or ODD number, a
