User's Manual

CHAPTER 6 READER-HOST PROTOCOL
NANOSCANNER READER USER GUIDE • DOC # 8101029-000 REV A 48
© 2003 Alien Technology™
An example of a multiple line command / response is:
>Get ReaderVersion[CR][LF]
>ReaderVersion = 1.0[CR][LF]
FirmwareVersion = 1.0[CR][LF]
SoftwareVersion = 1.0[CR][LF][0]
Commands are case in
sensitive, i.e., “set readername” is equivalent to “Set
ReaderName.”
Suppressing Command Prompts
By default all commands are set up for interactive use over a serial console or
telnet style interface. Consequently replies are always followed by a command
prompt indicating that user input is required. Often this command prompt is not
required, especially when client software is written that programmatically
communicates with the reader. To account for these applications, all command
prompts can be suppressed by making the first character of any command be an
0x1 character. For example:
I
NTERACTIVE COMMAND FORMAT
Alien> get ReaderName[CR][LF]
ReaderName = Alien Reader[CR][LF][0]
Alien>[CR][LF]
N
ON-INTERACTIVE COMMAND FORMAT
[1]get ReaderName[CR][LF]
ReaderName = Alien Reader[CR][LF][0]
XML Commands
There are a few cases where text-based replies and messages are formatted in
XML format for easier computer parsing. The following messages are sent in
XML format:
• Heartbeat Messages (see Heartbeat command description).
• Notification Messages (if notifyFormat = xml; see Notify command
description).
• The Get TagList commands (if tagListFormat = xml)