Professional Documents
Culture Documents
FLIR Systems AB: Camera Commands Manual
FLIR Systems AB: Camera Commands Manual
© FLIR Systems AB – January 16, 2002 — Publ. No.: 1 557 501 – Rev.: A
Legal disclaimer
All products manufactured by FLIR Systems AB are warranted against defective materials and workmanship for a period of one (1) year
from the delivery date of the original purchase, provided such products have been under normal storage, use and service, and in accor-
dance with FLIR’s instruction.
All products not manufactured by FLIR included in systems delivered by FLIR to the original purchaser carry the warranty, if any, of the
particular supplier only and FLIR has no responsibility whatsoever for such products.
The warranty extends only to the original purchaser and is not transferable. It is not applicable to any product which has been subjected
to misuse, neglect, accident or abnormal conditions of operation. Expendable parts are excluded from the warranty.
In the case of a defect in a product covered by this warranty the product must not be further used in order to prevent additional damage.
The purchaser shall promptly report any defect to FLIR or this warranty will not apply.
FLIR will, at its option, repair or replace any such defective product free of charge if, upon inspection, it proves to be defective in material
or workmanship and provided that it is returned to FLIR within the said one-year period.
FLIR has no other obligation or liability for defects than those set forth above.
No other warranty is expressed or implied. FLIR specifically disclaims the implied warranties of merchantability and fitness for a particular
purpose.
FLIR shall not be liable for any direct, indirect, special, incidental or consequential loss or damage, whether based on contract, tort or any
other legal theory.
Copyright
© FLIR Systems AB, 1995—2002. All rights reserved worldwide. No parts of the software including source code may be reproduced,
transmitted, transcribed or translated into any language or computer language in any form or by any means, electronic, magnetic, optical,
manual or otherwise, without the prior written permission of FLIR Systems AB, P.O. Box 3, SE-182 11 Danderyd, SWEDEN.
This manual must not, in whole or part, be copied, photocopied, reproduced, translated or transmitted to any electronic medium or ma-
chine readable form without prior consent, in writing, from FLIR Systems AB.
Names and marks appearing on the products herein are either registered trademarks or trademarks of FLIR Systems AB, FLIR Systems,
Inc., and/or its subsidiaries. All other trademarks, trade names or company names referenced herein are used for identification only and
are the property of their respective owners.
Quality Assurance
The Quality Management System under which these products are developed and manufactured has been certified in accordance with
the standard for ISO 9001.
FLIR Systems AB is committed to a policy of continuous development; therefore we reserve the right to make changes and improvements
on any of the products described in this manual without prior notice.
Website http://www.flir.com
2 Communication setup 3
2.1 Hardware setup 3
2.1.1 Necessary hardware parts (depending on system config.) 3
2.2 Software setup 4
3 Command descriptions 6
3.1 Image object parameters 6
3.1.1 Setting a new emissivity 6
3.1.2 Setting a new object distance 7
3.1.3 Setting a new ambient temperature 7
3.1.4 Setting a new atmospheric temperature 8
3.1.5 Setting a new relative humidity 8
3.1.6 Setting a user overide value for tao 9
3.2 Camera temperature sensors 9
3.2.1 Reading the sensor value in degrees Kelvin 9
3.3 Camera temperature compensation & calibration 10
3.3.1 Activating/de-activating the automatic shutter maneuver 10
3.4 Image control 11
3.4.1 Beginning/stopping the automatic zoom 11
3.4.2 Checking for calibrated ranges 11
3.4.3 Setting a new temperature range 12
3.4.4 Moving the built-in filter 12
3.4.5 Starting/stopping the focus motor 13
3.4.6 Moving the focus 13
3.4.7 Setting the focus position 14
3.4.8 Setting a new palette 14
3.4.9 Reading all valid palette names 14
3.4.10 Setting a new level 15
3.4.11 Setting a new span 15
3.4.12 Performing an auto-adjust maneuver 16
3.4.13 Controlling the continuous level/span function 16
3.4.14 Controlling the saturation colors 17
3.4.15 Setting the stripe factor 17
3.5 Measurement functions 18
3.5.1 Activating/de-activating measurement functions 18
3.5.2 Activating a requested area 19
3.5.3 Changing type/size/position of a requested rectangular area 20
3.5.4 Changing type/size/position of a requested circular area 20
3.5.5 Reading the result for a given area (abs pixel) 21
3.5.6 Reading the results for a given area in degrees Kelvin 22
3.5.7 Activating/de-activating the spotmeter 22
3.5.8 Changing the spotmeter position 23
3.5.9 Reading the spotmeter result (abs pixel) 23
3.5.10 Reading the spotmeter result as object signal in Kelvin 23
3.5.11 Activating the isotherm 24
3.5.12 Changing the isotherm mode 24
The camera may also write some debug strings in different situations.
Answer OK only
Function The command sets new emissivity to use for temperature calculations in the cam-
era. The query command reports current value, but optionally sets the new value
too.
Answer OK only
Function The command sets new object distance to use for temperature calculations in
the camera. The query command reports current value, but optionally sets the
new value too.
Answer OK only
Function The command sets new ambient temperature to use for temperature calculations
in the camera. The query command reports current value, but optionally sets the
new value too.
Answer OK only
Function The command sets new atmospheric temperature to use for temperature calcula-
tions in the camera. The query command reports current value, but optionally sets
the new value too.
Answer OK only
Function The command sets new relative humidity to use for temperature calculations in
the camera. The query command reports current value, but optionally sets the
new value too.
Answer OK only
Function The command sets a user override value for tao. Normally, tao is calculated from
dobj and relhum, but if the user has another atmospheric model, it is possible to
set an override value. If taouser = 0 (default) the camera uses its own model for
tao. The query command reports current value, but optionally sets the new value
too.
Function The command reads the time-averaged sensor value in degrees Kelvin. If <sen-
sor ID> is given the answer is given for that particular sensor. If no parameters
are given, the answer is given for all sensors (one sensor per line).
1 N/A
2 Baffle sensor
3 N/A
4 Shutter sensor
5 N/A
6 Optics sensor
7 Power sensor (i.e. the sensor on the power PCB, sensing momentary power con-
sumption)
Command: tcompadj:<on/off>
Answer tcompadj!<on/off>
Function The command activates or deactivates the automatic shutter maneuver normally
controlled by the internal temperature or timer. 570 makes a shutter maneuver
when the internal temperature changes more than 0.5 °C. If If the temperature is
stable, a shutter maneuver is performed every 15th minute. 550 acts on this 15
minute timer only. When off, only active commands or pressing the buttons per-
form the shutter maneuvers.
Answer OK only
Function Begins/stops automatic zooming like when using the joystick on the camera
Function The command checks for calibrated ranges. It gives high and low temperature
limits and corrresponding range/filter selections to use. One row per possible
range.
N.B. Command 3.4.2, 3.4.3 and 3.4.4 to be used in that order. Command 3.4.2 is
used to retrieve information needed for executing commands 3.4.3 and 3.4.4.
Answer OK only
Function The command sets <range no> as the new temperature range. The query com-
mand reports current value, but optionally sets the new value too.
N.B. Command 3.4.2, 3.4.3 and 3.4.4 to be used in that order. Command 3.4.2 is
used to retrieve information needed for executing commands 3.4.3 and 3.4.4.
Command: filter:<on/off>
Answer OK only
Function The command will try moving the built-in filter to the selected position. The com-
mand returns immediately. The filter change will take a maximum of three sec-
onds. To see if filter change works, use ‘filter?’ for polling. The query command
reports current filter status, but optionally sets the new value too.
N.B. Command 3.4.2, 3.4.3 and 3.4.4 to be used in that order. Command 3.4.2 is
used to retrieve information needed for executing commands 3.4.3 and 3.4.4.
Answer OK only
Function Starts/stops the focus motor in the desired direction. Time-out occurs if no ‘fo-
cusmov:up/down’ command has been given before a time limit (6 seconds). A
new ‘focusmov:up/down’ command before the time-out resets the time-out
counter.
Command: focusmov:<up/down/off>
Answer OK only
Function The command sets moves the focus motor ‘up’ or ‘down’ in a number of ‘ticks’.
Command: focuspos:<focusposition>/reset
Answer OK only.
Function The command will only work with cameras with position sensors, i.e. not
ThermaCAM™ SC3000 and ThermoVision™ 570.
Answer OK only
Function The command sets <new palette name> as a new color palette. If an invalid
name is given the GREY palette will be used. The query command reports cur-
rent palette name, but optionally sets the new value too.
Command: palettes?
Function Reads all valid palette names. One row per palette
Answer OK only
Function The command sets <new value> as new level. The query command reports cur-
rent value, but optionally sets the new value too.
Answer OK only
Function The command sets <new value> as new span. The query command reports cur-
rent value, but optionally sets the new value too.
Command: autoadj:<flags>
Answer OK only
Function Adjusts level and span to the ‘best’ values according to flags and current image
pixel contents.
N.B. Bit 0 equals to the auto-adjust function on the camera, which is executed either
by pressing the ’A’ button or by the camera itself when the temperature drift ex-
ceeds ±0.5 degrees or at least every 15 minutes.
Command: contadj:<off/level/span>
Answer OK only
Command: satcolor:<on/off>
Answer OK only
Answer OK only
When a range is set this command should be issued to read which output
speeds the camera has been calibrated for. Values 3,5,15 are possible, but not
all are guaranteed, since this is system-dependent.
Command: measure:<on/off>
Answer OK only
Answer OK only
Function The command activates the requested area. The query command reports current
activation status, but optionally sets the new value too. If no <area no> is given in
the query, there is one answer for all active areas. One line per area.
N.B. This command can not be executed without command 3.5.3 being executed first.
Answer: OK only
Function: The command changes type and/or size and position of the requested area.
Query command reports current value, but optionally sets new values too. If no
<area no> is given in the query, there is no answer for active areas. One line per
area.
Answer: OK only
Function: The command changes type and/or size and position of the requested area.
Query command reports current value, but optionally sets new values too. If no
<area no> is given in the query, there is no answer for active areas. One line per
area.
Legend:
= OK
* Warning
< Below range
> Above range
Function: Reads the calculated results for the given area. If no <area no> is given there is
one answer per defined area function (if any and measure:on)
Reads the calculated results for the given area. If no <area no> is given there is
one answer per defined area function (if any and measure:on)
Command: spot:<off/on/vis>
Answer: OK only
Function: The command activates the spotmeter. The query command reports current acti-
vation status, but optionally sets new value too.
Answer: OK only
Answer: readspot!,<value>,status
Function: Reads the calculated result for the spotmeter as object signal.
Answer: readspotk!,<value>,status
Function: Reads the calculated result in K for the spotmeter as object signal.
Command: iso:<off/on/vis/below/above>
Answer: OK only
Function: The command activates the isotherm as the requested isotherm type. The query
command reports current type/status, but optionally sets new value too.
Command: isopos:<low>,<high>
Answer: OK only
Function: The command changes ‘position’-level of the isotherm. The query command re-
ports current values, but optionally sets new values too.
Command: isocol:<col/black/white>
Answer: OK only
Function: The command changes the isotherm color. The query command reports current
value, but optionally sets new value too.
Command: prof:<on/off/vis>
Answer: OK only
Function: The command activates the profile. The query command reports current activa-
tion status, but optionally sets new value too.
Command: profpos:[,<x>,<y>]<v/h>
Answer: OK only
Function: The command changes orientation and/or optionally the position of the profile.
The query command reports current values, but optionally sets new value too.
3.5.18 Reading the profile marker results as object signal (abs pixel)
Answer: readprof!,<value>status
Function: Reads the calculated results for the profile marker as object signal.
Answer: readprofk!,<value>status
Function: Reads the calculated results for the profile marker as object signal in K.
Answer: OK only
Function: The command sets a new reference temperature to use for difference tempera-
ture result reporting in the camera. The query command reports current value, but
optionally sets new value too.
Display function only – affects how results are displayed in the result table.
Command: diff:<on/off>
Answer: OK only
Function: The command activates or deactivates the difference temperature result report-
ing in the camera (affects user interface appearance only). The query command
reports current value, but optionally sets new value too.
Command: freeze:<on/off>
Answer: OK only
Freeze:off from a recalled image will set image to live. Freeze:on with a recalled
image will not have any effect. The query command reports current freeze/live
status, but optionally sets new freeze level too
N.B. When shutting down the camera, it is necessary to execute this command to
make sure recently changed camera settings are stored, i.e.
freeze: on
freeze: off
Command: recall:<filename>
Answer: OK only
The query command reports current image name but optionally sets new freeze
level too.
Command: storefile:<filename>[,<flags>[,ovwr]]
Answer: OK only
If the directory name is shorter than 5 chars, the complete dir name will be used.
<nn> - number 01—99
If image ‘99’ exists, the ‘-’<nn> is replaced with <nnn> - number 100—999
Example name: INSPE-03.IMG — third stored image in the ‘INSPECT directory’.
Function: Shows existing files in the directory. One line per file.
Function: The command changes and reports current directory. The query command re-
ports current directory.
For the date 96-11-28 <directory name prefix> will be G1128 and the first direc-
tory created on this date will be ‘G1128#01’.
Function: The command deletes a named directory in the current directory. Error is re-
ported if the directory is not empty and ‘full’ is omitted.
If ‘full’ is given all the files and sub directories inside the given directory are also
deleted.
Answer OK only
Answer OK only.
Function: The command copies a file. Absolute and relative file name paths are allowed.
Answer OK only.
Function: Reports version information about the requested part. If no parameter is given in
the query, there is one answer for all possible parts.
Note that Rita uses ‘cooler’ to store system art. no/ser. no when the imager is
mounted in a pan/tilt unit.
Command: echo:<on/off>
Answer OK only.
Command: button:<ent/esc/f1/f2/u/d/l/r/lev/spn/emi/dst>,<p/r>
Answer OK only.
Function: The command simulates button pressed or released on the camera keypad. If no
<p/r> parameter is given, a press/release sequence is generated.
Function: The command changes baudrate for communication line (service port on Rita).
Command: video:<pal/ntsc>
Note that the viewfinder on 550/570 can not adjust itself to a different video sys-
tem than it is made for.
Command: digital:<on/off>
Answer OK only. Error message is digital interface board is not mounted or present.
Function: Enters digital mode if possible (HITI hardware mounted). In digital mode is that-
the freeze/recall states is are not allowed.
N.B. This command needs to be issued before any digital image data from the camera
is output!
Command: date:<year<,<month>,<day>,<hour>,<min>,<sec>
Answer OK only.
Function: Changes date/time in the camera’s real-time clock. The query command reports
current date/time, but optionally sets new values too.
Command: default
Answer OK only.
emissivity: 0.95
tamb: 293 (20 °C)
relhum: 50
filter: off
pan: 0,0
temprange: 0
palette: GREY
measure: off
iso: off
dobj: 2.0
tatm: 293 (20 °C)
tempcomp: on
zoom: 1.0
noise: 6
freeze: off
areas. off
spot: off
temp unit: °C
scale: on
dataview: 1
Command: dataview<numrows>
Answer OK only.
Function: Sets/reads the number of information rows to show at the bottom of the video
overlay.
Command: databack:<on/off>
Answer OK only.
Command: scale:<on/off>
Answer OK only.
Command: logo:<on/off>
Answer OK only.
Function: Sets/reads if the logotype in the upper left corner should be displayed.
Command: tempunit:<C/F>
Answer OK only.
Command: distunit:<metres/feet>
Answer OK only.