A.6. Bluetooth Serial Port Pro le (SPP) Communication Overview
FLIR Detection
Only one command should be sent before receiving a response. If no response is received after 15
seconds, it can be assumed the command was lost or the FLIR identiFINDER R300 is in an unre-
sponsive state.
The example listings use colored text and other font effects for emphasis. This is not part
of the XML message. Line breaks and indentation are also for ease of reading and are not
required.
The XML messages make extensive use of AttributeName=AttributeValue pairs. Each Attribute-
Name in the de ined messages is ixed and will be shown verbatim in the example listings.
However, there is typically more than one possible value for an AttributeValue. Listings will some-
times show placeholder text for an AttributeValue in blue similar to:
(PlaceholderText)
. In actual
usage, placeholder text will be replaced with the appropriate text or numerical value.
When a literal value is used in an example instead of placeholder text, it will be shown in red text
such as in this attribute pair:
encoding=
”utf-8”
(See Listing
A.1
). However, keep in mind that
the literal value shown may be only one of several possible values for that AttributeValue. In many
cases, other possible values will be enumerated in the description after the listing.
A.6.4 General Command Format
Command messages are sent to the FLIR identiFINDER R300 and will be of the general format
shown in Listing
A.1
:
Listing A.1.
General Command Format
1
< ?
xml v e r s i o n
=
” 1.0 ”
e n c o d i n g =
” utf -8 ”
? >
2
< C o m m a n d n a m e =
”
(CommandName)
”
>
3
< A r g u m e n t n a m e =
”
(ArgName)
”
v a l u e =
”
(ArgValue)
”
/ >
4
…
5
< / C o m m a n d >
\0
Line 1: XML Declaration
The XML declaration is the same for all messages and should be verbatim as shown on Line
1.
Line 2: Command element
A command message will contain one
Command
element as the root element. How a command
message will be parsed and what (if any)
Argument
child elements will be expected and inter-
preted are determined by the
name
attribute of the
Command
element, shown in the example
with the
(CommandName)
placeholder value.
246
identiFINDER
®
R300/en/2014.4(13623)/Feb2015
